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

:CreateStackGroup

最終更新日:Jun 03, 2026

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**** のテンプレートが使用されます。

今すぐお試しください

この 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:CreateStackGroup

create

*StackGroup

acs:ros:{#regionId}:{#accountId}:stackgroup/{#StackGroupName}

Template

acs:ros:{#regionId}:{#accountId}:template/{#TemplateId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

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 リクエストの本文にパラメーターを追加することを推奨します。

説明

TemplateBodyTemplateURLTemplateIdStackArn のうち、いずれか 1 つのみを指定する必要があります。

{"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 を指定しない場合、RegionId の値が使用されます。

説明

TemplateBodyTemplateURLTemplateIdStackArn のうち、いずれか 1 つのみを指定する必要があります。

oss://ros-template/demo

ClientToken

string

任意

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

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

AdministrationRoleName

string

任意

セルフマネージド型スタックグループを作成する際に管理者アカウントに指定する RAM ロールの名前。ROS は管理者ロールを引き受けて操作を実行します。このパラメーターを指定しない場合、デフォルト値として AliyunROSStackGroupAdministrationRole が使用されます。ROS は管理者ロールを使用して実行ロール AliyunROSStackGroupExecutionRole を引き受け、スタックグループ内のスタックに対して操作を実行します。

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

説明

このパラメーターは、PermissionModelSELF_MANAGED に設定されている場合に必要です。

AliyunROSStackGroupAdministrationRole

ExecutionRoleName

string

任意

セルフマネージド型スタックグループを作成する際に実行アカウントに指定する RAM ロールの名前。管理者ロール AliyunROSStackGroupAdministrationRole が実行ロールを引き受けて操作を実行します。このパラメーターを指定しない場合、デフォルト値として AliyunROSStackGroupExecutionRole が使用されます。ROS は実行ロールを引き受けて、スタックグループ内のスタックに対して操作を実行します。

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

説明

このパラメーターは、PermissionModelSELF_MANAGED に設定されている場合に必要です。

AliyunROSStackGroupExecutionRole

TemplateId

string

任意

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

説明

TemplateBodyTemplateURLTemplateIdStackArn のうち、いずれか 1 つのみを指定する必要があります。

5ecd1e10-b0e9-4389-a565-e4c15efc****

TemplateVersion

string

任意

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

説明

TemplateVersion は、TemplateId を指定した場合にのみ有効です。

v1

Parameters

array<object>

任意

スタックグループのパラメーター。

object

任意

ParameterKey

string

必須

パラメーター N のキー。パラメーターのキーと値を指定しない場合、ROS はテンプレートで定義されているデフォルトの名前と値を使用します。

N の最大値:200。

説明

Parameters はオプションです。Parameters を指定する場合は、Parameters.N.ParameterKey も指定する必要があります。

Amount

ParameterValue

string

必須

パラメーター N の値。

N の最大値:200。

説明

Parameters はオプションです。Parameters を指定する場合は、Parameters.N.ParameterValue も指定する必要があります。

12

ResourceGroupId

string

任意

リソースグループの ID。このパラメーターを指定しない場合、スタックグループはデフォルトのリソースグループに追加されます。リソースグループの詳細については、「リソースグループ」をご参照ください。

rg-acfmxazb4ph6aiy****

PermissionModel

string

任意

スタックグループのアクセス許可モデル。

有効な値:

  • SELF_MANAGED (デフォルト):セルフマネージド型アクセス許可モデル。セルフマネージド型スタックグループを作成する場合、管理者アカウントと実行アカウント内に RAM ロールを作成し、アカウント間に信頼関係を確立する必要があります。その後、実行アカウント内にスタックをデプロイできます。

  • SERVICE_MANAGED:サービスマネージド型アクセス許可モデル。サービスマネージド型スタックグループを作成する場合、ROS が管理者アカウントと実行アカウントにサービスにリンクされたロールを作成し、管理者アカウントはそのロールを使用して実行アカウント内にスタックをデプロイします。

説明

サービスマネージド型アクセス許可モデルを使用してスタックをデプロイするには、アカウントがリソースディレクトリの管理アカウントまたは委任管理者アカウントであり、かつアカウントで信頼されたアクセス機能が有効になっている必要があります。詳細については、「委任管理者アカウントの管理」および「信頼されたアクセスの有効化」をご参照ください。

SELF_MANAGED

Tags

array<object>

任意

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

object

任意

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

Key

string

必須

スタックグループのタグキー。

説明

Tags はオプションです。Tags を指定する場合は、Tags.N.Key も指定する必要があります。

usage

Value

string

任意

スタックグループのタグ値。

test

AutoDeployment

object

任意

自動デプロイ設定に関する情報。

説明

PermissionModelSERVICE_MANAGED に設定されている場合は、このパラメーターを指定する必要があります。

{"Enabled": true, "RetainStacksOnAccountRemoval": true}

Enabled

boolean

任意

自動デプロイが有効かどうかを示します。

有効な値:

  • true:自動デプロイは有効です。自動デプロイを有効にした後、スタックグループが属するフォルダーにメンバーアカウントを追加すると、ROS は自動的にそのメンバーアカウントにスタックグループ内のスタックを追加します。フォルダーからメンバーアカウントを削除すると、ROS は自動的にそのメンバーアカウントからスタックを削除します。

  • false:自動デプロイは無効です。自動デプロイを無効にした後、フォルダーにメンバーアカウントを追加、またはフォルダーからメンバーアカウントを削除しても、スタックは変更されません。

true

RetainStacksOnAccountRemoval

boolean

任意

フォルダーからメンバーアカウントを削除する際に、メンバーアカウント内のスタックを保持するかどうかを示します。

有効な値:

  • true

  • false

説明

Enabled が true に設定されている場合は、RetainStacksOnAccountRemoval を指定する必要があります。

true

Capabilities

array

任意

スタックグループのオプション。最大 1 つのオプションを指定できます。

string

任意

スタックグループのオプション。有効な値:ExpandModulesExpandModules は、現在のアカウント内でモジュールを展開することを指定します。

説明
  • このパラメーターは、テンプレートでモジュールが使用されている場合にのみ有効です。

  • デフォルトでは、現在のアカウント内でモジュールは展開されません。そのため、スタックグループをデプロイするすべての実行アカウント内にモジュールが存在する必要があります。現在のアカウント内でモジュールを展開する場合は、現在のアカウント内にモジュールが存在する必要があります。

列挙値:

  • ExpandModules :

    ExpandModules

ExpandModules

StackArn

string

任意

スタックの ARN (acs:ros:${RegionId}:${AccountId}:stack/${StackId} 形式)。このスタックのテンプレートとパラメーターに基づいてスタックグループが作成されます。

説明
  • セルフマネージド型アクセス許可モデルでのみサポートされます。

  • StackArn を指定した場合、Parameters は指定できません。

  • TemplateBodyTemplateURLTemplateIdStackArn のうち、いずれか 1 つのみを指定する必要があります。

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****"
}

エラーコード

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

変更履歴

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