すべてのプロダクト
Search
ドキュメントセンター

:UpdateStackInstances

最終更新日:Dec 19, 2025

指定されたリージョン内の 1 つ以上のアカウントのスタックインスタンスを更新します。

操作説明

このトピックでは、中国 (杭州) リージョンにあり、セルフマネージド権限を使用するスタックグループ MyStackGroup のスタックを更新する方法の例を示します。 スタックは、中国 (杭州) および中国 (北京) リージョンの Alibaba Cloud アカウント 151266687691**** および 141261387191**** に対して更新されます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ros:UpdateStackInstances

update

*StackInstance

acs:ros:{#regionId}:{#accountId}:stackinstance/{#StackGroupName}/{#StackInstanceAccountId}/{#StackInstanceRegionId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

スタックグループが存在するリージョン ID。 DescribeRegions を呼び出して、Alibaba Cloud リージョンの最新リストを取得します。

cn-hangzhou

StackGroupName

string

必須

スタックグループの名前。 名前はリージョン内で一意である必要があります。
名前は最大 255 文字で、先頭には文字または数字を使用する必要があります。 文字、数字、ハイフン (-)、アンダースコア (_) を使用できます。

MyStackGroup

AccountIds

array

任意

セルフマネージド権限でスタックをデプロイする宛先アカウントの ID。 最大 30 個のアカウント ID を指定できます。

説明

セルフマネージド権限でスタックを更新する場合、このパラメーターは必須です。

["151266687691****","141261387191****"]

string

任意

セルフマネージド権限でスタックをデプロイする宛先アカウントの ID。 最大 30 個のアカウント ID を指定できます。

説明

セルフマネージド権限でスタックを更新する場合、このパラメーターは必須です。

["151266687691****","141261387191****"]

RegionIds

array

必須

操作を実行するリージョンのリスト。 最大 20 のリージョンを指定できます。

["cn-hangzhou", "cn-beijing"]

string

任意

操作を実行するリージョンのリスト。 最大 20 のリージョンを指定できます。

["cn-hangzhou","cn-beijing"]

ClientToken

string

任意

リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントトークンはクライアントによって生成され、グローバルに一意である必要があります。
トークンは最大 64 文字で、文字、数字、ハイフン (-)、アンダースコア (_) を使用できます。
詳細については、「べき等性の確保方法」をご参照ください。




123e4567-e89b-12d3-a456-42665544****

OperationDescription

string

任意

更新操作の説明。

説明は 1~256 文字である必要があります。

Update stack instances in hangzhou and beijing

OperationPreferences

object

任意

スタックを更新するための操作設定。

次のパラメーターが含まれます:

  • {"FailureToleranceCount": N}

    1 つのリージョンでスタック操作が失敗してもよいアカウント数。 1 つのリージョンでの失敗数がこの値を超えると、Resource Orchestration Service (ROS) はそのリージョンでの操作を停止します。 あるリージョンで操作が停止された場合、他のリージョンでは続行されません。

    N は 0 から 20 までの整数である必要があります。

    FailureToleranceCount を指定しない場合、デフォルト値は 0 です。

  • {"FailureTolerancePercentage": N}

    1 つのリージョンでスタック操作が失敗してもよいアカウントの割合。 1 つのリージョンでの失敗率がこの値を超えると、ROS はそのリージョンでの操作を停止します。

    N は 0 から 100 までの整数である必要があります。 パーセンテージが整数でない場合、ROS は最も近い整数に切り捨てます。

    FailureTolerancePercentage を指定しない場合、デフォルト値は 0 です。

  • {"MaxConcurrentCount": N}

    1 つのリージョンで同時にスタックをデプロイできるアカウントの最大数。

    N は 1 から 20 までの整数である必要があります。

    MaxConcurrentCount を指定しない場合、デフォルト値は 1 です。

  • {"MaxConcurrentPercentage": N}

    1 つのリージョンで同時にスタックをデプロイできるアカウントの割合。

    値は 1 から 100 までの整数である必要があります。 パーセンテージが整数でない場合、ROS は最も近い整数に切り捨てます。

    MaxConcurrentPercentage を指定しない場合、デフォルト値は 1 です。

  • {"RegionConcurrencyType": N} 異なるリージョンでスタックをデプロイするための同時実行タイプ。 有効な値:

    • SEQUENTIAL (デフォルト):指定されたリージョンにスタックを順番に 1 つずつデプロイします。 任意の時点で、スタックは 1 つのリージョンにのみデプロイされます。

    • PARALLEL:指定されたすべてのリージョンにスタックを並行してデプロイします。

複数のパラメーターはコンマ (,) で区切ります。

説明
  • MaxConcurrentCount と MaxConcurrentPercentage の両方を指定することはできません。

  • FailureToleranceCount と FailureTolerancePercentage の両方を指定することはできません。

{"FailureToleranceCount": 1,"MaxConcurrentCount": 2}

TimeoutInMinutes

integer

任意

更新操作のタイムアウト期間。

  • デフォルト値:60。

  • 単位:分。

10

ParameterOverrides

array<object>

任意

上書きするパラメーターのリスト。

object

任意

ParameterKey

string

必須

上書きするパラメーターの名前。 このパラメーターを指定しない場合、ROS はスタックグループの作成時に指定したパラメーター名を使用します。

N の値は最大 200 です。

説明
  • ParameterOverrides パラメーターはオプションです。

  • ParameterOverrides を指定する場合は、ParameterOverrides.N.ParameterKey と ParameterOverrides.N.ParameterValue の両方を指定する必要があります。

Amount

ParameterValue

string

必須

上書きするパラメーターの値。 パラメーターの名前と値を指定しない場合、ROS はスタックグループの作成時に指定したパラメーターを使用します。

N の値は最大 200 です。

説明
  • ParameterOverrides パラメーターはオプションです。

  • ParameterOverrides を指定する場合は、ParameterOverrides.N.ParameterKey と ParameterOverrides.N.ParameterValue の両方を指定する必要があります。

1

DeploymentTargets

object

任意

サービスマネージドモードでデプロイされるスタックのデプロイターゲット。

説明

サービスマネージドモードでスタックを更新する場合、このパラメーターは必須です。

RdFolderIds

array

任意

リソースディレクトリ内のフォルダの ID。

string

任意

リソースディレクトリ内のフォルダの ID。 最大 20 個のフォルダ ID を指定できます。

RdFolderIds または AccountIds を指定する必要があります。

  • RdFolderIds を指定し、AccountIds を指定しない場合、スタックは指定されたフォルダ内のすべてのメンバーアカウントにデプロイされます。 ルートフォルダを指定した場合、スタックはリソースディレクトリ内のすべてのメンバーアカウントにデプロイされます。

  • AccountIds を指定し、RdFolderIds を指定しない場合、スタックは指定されたメンバーアカウントにデプロイされます。

  • 両方のパラメーターを指定する場合、AccountIds 内のアカウントは RdFolderIds で指定されたフォルダ内にある必要があります。 スタックは指定されたメンバーアカウントにデプロイされます。

説明

Resource Management コンソールの概要ページでフォルダ ID を表示できます。 詳細については、「フォルダの基本情報を表示」をご参照ください。

["fd-4PvlVLOL8v"]

AccountIds

array

任意

リソースディレクトリ内のメンバーアカウントの ID。 最大 50 個のメンバーアカウント ID を指定できます。

説明

Resource Management コンソールの概要ページでメンバーアカウント ID を表示できます。 詳細については、「メンバーの詳細を表示」をご参照ください。

string

任意

リソースディレクトリ内のメンバーアカウントの ID。 最大 50 個のメンバーアカウント ID を指定できます。

説明

Resource Management コンソールの概要ページでメンバーアカウント ID を表示できます。 詳細については、「メンバーの詳細を表示」をご参照ください。

["151266687691****","141261387191****"]

共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

14A07460-EBE7-47CA-9757-12CC4761D47A

OperationId

string

操作 ID。

6da106ca-1784-4a6f-a7e1-e723863d****

成功レスポンス

JSONJSON

{
  "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "OperationId": "6da106ca-1784-4a6f-a7e1-e723863d****"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。