Resource Orchestration Service (ROS) のテンプレートに基づいてスタックグループを作成します。スタックグループでは、複数の Alibaba Cloud アカウントとリージョンにわたってスタックを作成できます。
操作説明
スタックグループは、1 つの単位として管理できる Resource Orchestration Service (ROS) スタックのコレクションです。スタックグループの ROS テンプレートを使用すると、リージョンをまたいで Alibaba Cloud アカウント内にスタックを作成できます。
自己管理権限またはサービス管理権限を持つスタックグループを作成できます。
-
Alibaba Cloud アカウントを使用して自己管理権限のスタックグループを作成する場合、管理者アカウントと実行アカウントは Alibaba Cloud アカウントです。
-
リソースディレクトリを有効にし、リソースディレクトリの管理アカウントまたは委任された管理者アカウントを使用してサービス管理権限のスタックグループを作成する場合、管理者アカウントは管理アカウントまたは委任された管理者アカウントであり、実行アカウントはリソースディレクトリのメンバーアカウントです。
スタックグループの詳細については、概要をご参照ください。
このトピックでは、MyStackGroup という名前のスタックグループが China (Hangzhou) リージョンで作成され、自己管理権限が付与されます。この例では、ID が 5ecd1e10-b0e9-4389-a565-e4c15efc**** のテンプレートが使用されます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ros:CreateStackGroup |
create |
*StackGroup
Template
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
スタックグループが属するリージョン ID。最新のリージョンリストを照会するには、DescribeRegions API を呼び出します。 |
cn-hangzhou |
| StackGroupName |
string |
必須 |
スタックグループの名前。名前は、リージョン内で一意である必要があります。長さは最大 255 文字で、数字、英字、ハイフン (-)、アンダースコア (_) を使用できます。先頭は数字または英字である必要があります。 |
MyStackGroup |
| Description |
string |
任意 |
スタックグループの説明。長さは 1~256 文字である必要があります。 |
StackGroup Description |
| TemplateBody |
string |
任意 |
テンプレートの構造を定義する本文。長さは 1~524,288 バイトである必要があります。テンプレート本文の長さが上限を超える場合は、URL が長すぎることによるリクエストの失敗を防ぐため、HTTP POST リクエストの本文にパラメーターを追加することを推奨します。 説明
|
{"ROSTemplateFormatVersion":"2015-09-01"} |
| TemplateURL |
string |
任意 |
テンプレート本文を含むファイルの URL。URL は、HTTP または HTTPS の Web サーバー、あるいは Alibaba Cloud Object Storage Service (OSS) バケットにあるテンプレートを指す必要があります。テンプレート本文の長さは 1~524,288 バイトである必要があります。例:oss://ros/template/demo、oss://ros/template/demo?RegionId=cn-hangzhou。OSS バケットのリージョン ID を指定しない場合、 説明
|
oss://ros-template/demo |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークン。トークンはクライアント側で生成できますが、リクエストごとに一意である必要があります。トークンは、長さが最大 64 文字で、英字、数字、アンダースコア (_)、ハイフン (-) を使用できます。詳細については、「べき等性の確保」をご参照ください。 |
123e4567-e89b-12d3-a456-42665544**** |
| AdministrationRoleName |
string |
任意 |
セルフマネージド型スタックグループを作成する際に管理者アカウントに指定する RAM ロールの名前。ROS は管理者ロールを引き受けて操作を実行します。このパラメーターを指定しない場合、デフォルト値として 名前の長さは 1~64 文字で、英字、数字、ハイフン (-) を使用できます。 説明
このパラメーターは、 |
AliyunROSStackGroupAdministrationRole |
| ExecutionRoleName |
string |
任意 |
セルフマネージド型スタックグループを作成する際に実行アカウントに指定する RAM ロールの名前。管理者ロール 名前の長さは 1~64 文字で、英字、数字、ハイフン (-) を使用できます。 説明
このパラメーターは、 |
AliyunROSStackGroupExecutionRole |
| TemplateId |
string |
任意 |
テンプレートの ID。このパラメーターは共有テンプレートとプライベートテンプレートに適用されます。 説明
|
5ecd1e10-b0e9-4389-a565-e4c15efc**** |
| TemplateVersion |
string |
任意 |
テンプレートのバージョン。このパラメーターを指定しない場合、最新バージョンが使用されます。 説明
|
v1 |
| Parameters |
array<object> |
任意 |
スタックグループのパラメーター。 |
|
|
object |
任意 |
|||
| ParameterKey |
string |
必須 |
パラメーター N のキー。パラメーターのキーと値を指定しない場合、ROS はテンプレートで定義されているデフォルトの名前と値を使用します。 N の最大値:200。 説明
|
Amount |
| ParameterValue |
string |
必須 |
パラメーター N の値。 N の最大値:200。 説明
|
12 |
| ResourceGroupId |
string |
任意 |
リソースグループの ID。このパラメーターを指定しない場合、スタックグループはデフォルトのリソースグループに追加されます。リソースグループの詳細については、「リソースグループ」をご参照ください。 |
rg-acfmxazb4ph6aiy**** |
| PermissionModel |
string |
任意 |
スタックグループのアクセス許可モデル。 有効な値:
説明
サービスマネージド型アクセス許可モデルを使用してスタックをデプロイするには、アカウントがリソースディレクトリの管理アカウントまたは委任管理者アカウントであり、かつアカウントで信頼されたアクセス機能が有効になっている必要があります。詳細については、「委任管理者アカウントの管理」および「信頼されたアクセスの有効化」をご参照ください。 |
SELF_MANAGED |
| Tags |
array<object> |
任意 |
スタックグループのタグ。 |
|
|
object |
任意 |
スタックグループのタグ。 |
||
| Key |
string |
必須 |
スタックグループのタグキー。 説明
|
usage |
| Value |
string |
任意 |
スタックグループのタグ値。 |
test |
| AutoDeployment |
object |
任意 |
自動デプロイ設定に関する情報。 説明
|
{"Enabled": true, "RetainStacksOnAccountRemoval": true} |
| Enabled |
boolean |
任意 |
自動デプロイが有効かどうかを示します。 有効な値:
|
true |
| RetainStacksOnAccountRemoval |
boolean |
任意 |
フォルダーからメンバーアカウントを削除する際に、メンバーアカウント内のスタックを保持するかどうかを示します。 有効な値:
説明
|
true |
| Capabilities |
array |
任意 |
スタックグループのオプション。最大 1 つのオプションを指定できます。 |
|
|
string |
任意 |
スタックグループのオプション。有効な値: 説明
列挙値:
|
ExpandModules |
|
| StackArn |
string |
任意 |
スタックの ARN (acs:ros:${RegionId}:${AccountId}:stack/${StackId} 形式)。このスタックのテンプレートとパラメーターに基づいてスタックグループが作成されます。 説明
|
acs:ros:cn-hangzhou:175458000000****:stack/4a65f506-c3cc-43b6-af06-3f000000**** |
共通リクエストパラメーターの詳細は、「共通パラメーター」をご参照ください。
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID です。 |
14A07460-EBE7-47CA-9757-12CC4761D47A |
| StackGroupId |
string |
スタックグループ ID です。 |
2c036e78-9e82-428e-afd6-177f5d04**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
"StackGroupId": "2c036e78-9e82-428e-afd6-177f5d04****"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。