:UpdateStackGroup

スタックグループが配置されているリージョンの ID。DescribeRegions 操作を呼び出して、Alibaba Cloud リージョンの最新リストを照会できます。

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

スタックグループの説明。

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

テンプレート本文を含む構造。テンプレート本文の長さは 1～524,288 バイトである必要があります。テンプレート本文が長い場合は、HTTP POST および Body Param メソッドを使用してリクエスト本文でパラメーターを渡すことで、URL が長すぎることによるリクエストの失敗を防ぎます。

テンプレート本文を含むファイルの URL。URL は、HTTP または HTTPS Web サーバー、あるいは Alibaba Cloud Object Storage Service (OSS) バケットにあるテンプレートを指す必要があります。テンプレート本文の長さは 1～524,288 バイトである必要があります。たとえば、OSS バケットの URL は oss://ros/template/demo または oss://ros/template/demo?RegionId=cn-hangzhou のようになります。OSS バケットのリージョンを指定しない場合は、`RegionId` パラメーターの値が使用されます。

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

スタックグループを更新する操作の説明。

スタックグループ操作のプリファレンス。

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

• FailureToleranceCount

  各リージョンでスタック操作の失敗が許可されるアカウントの数。リージョンでの失敗した操作の数がこの値を超えると、Resource Orchestration Service (ROS) はそのリージョンでの操作を停止します。あるリージョンで操作が停止されると、他のリージョンでは操作は開始されません。

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

  このパラメーターを指定しない場合、デフォルト値として 0 が使用されます。

• FailureTolerancePercentage

  各リージョンでスタック操作の失敗が許可されるアカウントの割合。リージョンでの失敗した操作の割合がこの値を超えると、ROS はそのリージョンでの操作を停止します。

  値は 0 から 100 までの整数である必要があります。割合が整数でない場合、ROS は最も近い整数に切り捨てます。

  このパラメーターを指定しない場合、デフォルト値として 0 が使用されます。

• MaxConcurrentCount

  各リージョンで同時にスタックがデプロイされるアカウントの最大数。

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

  このパラメーターを指定しない場合、デフォルト値として 1 が使用されます。

• MaxConcurrentPercentage

  各リージョンで同時にスタックがデプロイされるアカウントの最大割合。

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

  このパラメーターを指定しない場合、デフォルト値として 1 が使用されます。

• RegionConcurrencyType デプロイリージョンの同時実行タイプ。有効な値：

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

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

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

ROS によって引き受けられる RAM 管理者ロールの名前。このパラメーターは、セルフマネージド権限を持つスタックグループを作成する場合に必要です。値を指定しない場合、デフォルト値として `AliyunROSStackGroupAdministrationRole` が使用されます。ROS はこのロールを引き受けて、スタックグループ内のスタックに対する操作を実行します。ROS はこのロールの認証情報を使用して、実行ロール (`AliyunROSStackGroupExecutionRole`) を引き受けます。

名前は 1～64 文字で、文字、数字、ハイフン (-) を使用できます。

管理者ロール (`AliyunROSStackGroupAdministrationRole`) によって引き受けられる RAM 実行ロールの名前。このパラメーターは、セルフマネージド権限を持つスタックグループを作成する場合に必要です。値を指定しない場合、デフォルト値として `AliyunROSStackGroupExecutionRole` が使用されます。ROS はこのロールを引き受けて、スタックグループ内のスタックに対する操作を実行します。

名前は 1～64 文字で、文字、数字、ハイフン (-) を使用できます。

テンプレートの ID。このパラメーターは、共有テンプレートとプライベートテンプレートに適用されます。

テンプレートのバージョン。このパラメーターを指定しない場合、最新バージョンが使用されます。

権限モデル。

有効な値：

• SELF_MANAGED (デフォルト)：セルフマネージド権限。この権限モデルを使用する場合、管理者アカウントとメンバーアカウントで RAM ロールを作成して、アカウントを相互に関連付ける必要があります。その後、メンバーアカウントにスタックをデプロイできます。

• SERVICE_MANAGED：サービスマネージド権限。この権限モデルを使用する場合、ROS は管理者アカウントとメンバーアカウントのサービスリンクロールを作成します。管理者アカウントは、サービスリンクロールを使用してメンバーアカウントにスタックをデプロイします。