すべてのプロダクト
Search

このプロダクト

    :CreateChangeSet

    ドキュメントセンター

    :CreateChangeSet

    最終更新日:Jul 29, 2025

    スタックの変更セットを作成します。変更セットを実行する前に変更をプレビューできます。

    操作説明

    シナリオ

    変更セットを使用してスタックを作成する

    複数のクラウドリソースを管理し、スタックが作成される前にどのように作成されるかをプレビューする場合は、変更セットを使用してスタックを作成できます。これを行うには、ChangeSetType パラメーターを CREATE に設定し、他の必須パラメーターを設定します。変更セットの詳細については、「変更セット」をご参照ください。

    変更セットを使用してスタックを更新する

    変更を適用する前に、更新がスタックに与える影響をプレビューする場合は、既存のスタックの変更セットを作成できます。これを行うには、ChangeSetType パラメーターを UPDATE に設定し、他の必須パラメーターを設定します。 変更セットの詳細については、「変更セット」をご参照ください。

    既存のリソースからスタックを作成する

    既存のクラウドリソースを集中管理のために新しいスタックにインポートする場合は、変更セットを作成できます。これを行うには、ChangeSetType パラメーターを IMPORT に設定し、他の必須パラメーターを設定します。リソースのインポートの詳細については、「概要」をご参照ください。

    既存のリソースをスタックにインポートする

    既存のリソースを集中管理のために既存のスタックにインポートする場合は、変更セットを作成できます。これを行うには、ChangeSetType パラメーターを IMPORT に設定し、他の必須パラメーターを設定します。リソースのインポートの詳細については、「概要」をご参照ください。

    制限

    • 変更セットを使用して、特定の状態のスタックのみを更新できます。詳細については、「変更セットを使用してスタックを更新する」をご参照ください。

    • スタックは一度に最大 20 個の変更セットを持つことができます。

    • 変更セットには、スタックへの変更のみが表示されます。スタックが正常に更新されるかどうかは示されません。

    • 変更セットは、アカウントクォータの超過、更新できないリソースの更新の試み、リソースを変更するための十分な権限がないなど、潜在的な問題をチェックしません。これらの問題のいずれかが発生すると、スタックの更新が失敗する可能性があります。更新が失敗した場合、ROS はリソースを以前の状態にロールバックしようとします。

    このトピックでは、中国 (杭州) リージョン (cn-hangzhou) に MyChangeSet という名前の変更セットを作成する例を示します。変更セットは、ID が 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** のスタックのテンプレートを {"ROSTemplateFormatVersion":"2015-09-01"} に更新します。

    今すぐお試しください

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

    create

    *Stack

    acs:ros:{#regionId}:{#accountId}:stack/{#StackId}

    Template

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    タイプ

    必須 / 任意

    説明

    例
    StackId

    string

    任意

    変更セットを作成するスタックの ID です。ROS は、変更されたテンプレートや異なるパラメーター値など、送信した情報とスタック情報を比較して、変更セットを生成します。
    ListStacks 操作を呼び出して、スタック ID をクエリできます。

    説明

    このパラメーターは、ChangeSetType が UPDATE または IMPORT に設定されている場合にのみ有効です。

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****
    StackPolicyURL

    string

    任意

    スタックポリシーを含むファイルの URL です。URL は、Web サーバー (HTTP または HTTPS) または Alibaba Cloud OSS バケットにあるポリシーを指している必要があります (例: oss://ros/stack-policy/demo または oss://ros/stack-policy/demo?RegionId=cn-hangzhou)。ポリシーファイルのサイズは最大 16,384 バイトです。

    URL の長さは最大 1,350 バイトです。

    説明

    OSS バケットのリージョンを指定しない場合、RegionId の値が使用されます。

    ChangeSetType が CREATE に設定されている場合、StackPolicyBody と StackPolicyURL パラメーターのいずれか 1 つのみを指定できます。

    ChangeSetType が UPDATE に設定されている場合、次のパラメーターのいずれか 1 つのみを指定できます。

    • StackPolicyBody

    • StackPolicyURL

    • StackPolicyDuringUpdateBody

    • StackPolicyDuringUpdateURL

    oss://ros/stack-policy/demo
    StackPolicyBody

    string

    任意

    スタックポリシーの構造。ポリシー本文の長さは 1 ～ 16,384 バイトである必要があります。

    ChangeSetType が CREATE に設定されている場合、StackPolicyBody と StackPolicyURL パラメーターのいずれか 1 つのみを指定できます。

    ChangeSetType が UPDATE に設定されている場合、次のパラメーターのいずれか 1 つのみを指定できます。

    • StackPolicyBody

    • StackPolicyURL

    • StackPolicyDuringUpdateBody

    • StackPolicyDuringUpdateURL

    {"Statement":[{"Effect":"Allow","Action":"Update:*","Principal":"*","Resource":"*"}]}
    StackName

    string

    任意

    変更セットを作成するスタックの名前です。
    名前の長さは最大 255 文字で、数字、文字、ハイフン (-)、アンダースコア (_) を使用できます。名前は数字または文字で始める必要があります。

    説明

    このパラメーターは、ChangeSetType が CREATE または IMPORT に設定されている場合にのみ有効です。

    MyStack
    UsePreviousParameters

    boolean

    任意

    最後に使用されたパラメーターの値を使用するかどうかを指定します。有効な値:

    • true

    • false (デフォルト)

    説明

    このパラメーターは、ChangeSetType が UPDATE または IMPORT に設定されている場合にのみ有効です。

    true
    ChangeSetType

    string

    任意

    変更セットのタイプ。有効な値:

    • CREATE: 新しいスタックの変更セットを作成します。

    • UPDATE (デフォルト): 既存のスタックの変更セットを作成します。

    • IMPORT: ROS で管理されていないリソースをインポートするために、新しいスタックまたは既存のスタックの変更セットを作成します。

    ChangeSetType の値を CREATE に設定すると、ROS は新しいスタックを作成します。スタックは、変更セットを実行するまで REVIEW_IN_PROGRESS 状態になります。

    説明

    • UPDATE タイプを使用して新しいスタックの変更セットを作成したり、CREATE タイプを使用して既存のスタックの変更セットを作成したりすることはできません。

    • IMPORT タイプの変更セットにスタックポリシーを設定することはできません。スタックポリシーは、スタックの作成時または更新時に設定できます。

    UPDATE
    Description

    string

    任意

    変更セットの説明。説明の長さは最大 1,024 バイトです。

    It is a demo.
    RegionId

    string

    必須

    変更セットのリージョン ID です。

    DescribeRegions 操作を呼び出して、最新のリージョンリストをクエリできます。

    cn-hangzhou
    ClientToken

    string

    任意

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

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

    string

    任意

    テンプレート本文を含むファイルの URL です。URL は、Web サーバー (HTTP または HTTPS) または OSS バケットにあるテンプレートを指している必要があります (例: oss://ros/template/demo または oss://ros/template/demo?RegionId=cn-hangzhou)。テンプレート本文の長さは最大 524,288 バイトです。

    説明

    OSS バケットのリージョンを指定しない場合、RegionId の値が使用されます。

    TemplateBody、TemplateURL、TemplateId パラメーターのいずれか 1 つのみを指定できます。

    URL の長さは最大 1,024 バイトです。

    oss://ros/template/demo
    StackPolicyDuringUpdateURL

    string

    任意

    一時的なオーバーライドスタックポリシーを含むファイルの URL です。URL は、Web サーバー (HTTP または HTTPS) または OSS バケットにあるポリシーを指している必要があります (例: oss://ros/stack-policy/demo または oss://ros/stack-policy/demo?RegionId=cn-hangzhou)。ポリシーファイルのサイズは最大 16,384 バイトです。

    説明

    OSS バケットのリージョンを指定しない場合、RegionId の値が使用されます。

    URL の長さは最大 1,350 バイトです。
    保護されたリソースを更新する場合は、更新中に一時的なオーバーライドスタックポリシーを指定します。スタックポリシーを指定しない場合、スタックに関連付けられている現在のポリシーが使用されます。このパラメーターは、ChangeSetType が UPDATE に設定されている場合にのみ有効です。次のパラメーターのいずれか 1 つのみを指定できます。

    • StackPolicyBody

    • StackPolicyURL

    • StackPolicyDuringUpdateBody

    • StackPolicyDuringUpdateURL

    oss://ros/stack-policy/demo
    TemplateBody

    string

    任意

    テンプレート本文の構造。テンプレート本文の長さは 1 ～ 524,288 バイトである必要があります。テンプレート本文の長さが要件よりも長い場合は、URL が長すぎることによるリクエストの失敗を防ぐために、HTTP POST リクエスト本文にパラメーターを追加することをお勧めします。

    説明

    TemplateBody、TemplateURL、TemplateId パラメーターのいずれか 1 つのみを指定できます。

    {"ROSTemplateFormatVersion":"2015-09-01"}
    TimeoutInMinutes

    integer

    任意

    スタックが CREATE_FAILED または UPDATE_FAILED 状態になるまでに経過できる時間です。
    ChangeSetType が CREATE に設定されている場合、このパラメーターは必須です。ChangeSetType が UPDATE に設定されている場合、このパラメーターはオプションです。

    • 単位: 分。

    • 有効な値: 10 ～ 1440。

    • デフォルト値: 60。

    12
    DisableRollback

    boolean

    任意

    スタックの作成に失敗した場合にロールバックを無効にするかどうかを指定します。
    有効な値:

    • true: スタックの作成に失敗した場合にスタックのロールバックを無効にします。

    • false (デフォルト): スタックの作成に失敗した場合にスタックのロールバックを有効にします。

    説明

    このパラメーターは、ChangeSetType が CREATE または IMPORT に設定されている場合にのみ有効です。

    false
    ChangeSetName

    string

    必須

    変更セットの名前です。
    名前の長さは最大 255 文字で、数字、文字、ハイフン (-)、アンダースコア (_) を使用できます。名前は数字または文字で始める必要があります。

    説明

    変更セットの名前は、スタック内で一意である必要があります。

    MyChangeSet
    StackPolicyDuringUpdateBody

    string

    任意

    一時的なオーバーライドスタックポリシーの構造。ポリシー本文の長さは 1 ～ 16,384 バイトである必要があります。
    保護されたリソースを更新する場合は、更新中に一時的なオーバーライドスタックポリシーを指定します。スタックポリシーを指定しない場合、スタックに関連付けられている現在のポリシーが使用されます。
    このパラメーターは、ChangeSetType が UPDATE に設定されている場合にのみ有効です。次のパラメーターのいずれか 1 つのみを指定できます。




    • StackPolicyBody

    • StackPolicyURL

    • StackPolicyDuringUpdateBody

    • StackPolicyDuringUpdateURL

    {"Statement":[{"Effect":"Allow","Action":"Update:*","Principal":"*","Resource":"*"}]}
    RamRoleName

    string

    任意

    RAM ロールの名前。ROS は RAM ロールをアシュームしてスタックを作成し、ロールの資格情報を使用して Alibaba Cloud サービスの API を呼び出します。
    ROS は、スタックで実行されるすべての操作に常にこのロールを使用します。スタックに対する操作を実行するための権限を持っている必要があります。権限がない場合、ROS は RamRoleName で指定されたロールをアシュームしてスタックに対する操作を実行します。RamRoleName を指定しない場合、ROS はスタックの既存のロールをアシュームします。使用可能なロールがない場合、ROS はアカウントの資格情報から生成された一時的な資格情報を使用します。
    RAM ロールの名前の長さは最大 64 バイトです。




    RAM ロールの詳細については、「スタックロール」をご参照ください。

    test-role
    ReplacementOption

    string

    任意

    リソースプロパティが変更され、変更が変更更新をサポートしていない場合に、置換更新を有効にするかどうかを指定します。置換更新では、リソースを削除し、新しいリソースを作成します。リソースの物理 ID が変更されます。有効な値:

    • Enabled: 置換更新を有効にします。

    • Disabled (デフォルト): 置換更新を無効にします。

    説明

    変更更新が優先的に使用されます。このパラメーターは、ChangeSetType が UPDATE に設定されている場合にのみ有効です。

    Disabled
    TemplateId

    string

    任意

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

    ListTemplates 操作を呼び出して、テンプレート ID をクエリできます。

    説明

    TemplateBody、TemplateURL、TemplateId パラメーターのいずれか 1 つのみを指定できます。

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

    string

    任意

    テンプレートのバージョン。

    説明

    このパラメーターは、TemplateId が指定されている場合にのみ有効です。

    v1
    Parameters

    array<object>

    任意

    テンプレートで定義されているパラメーター。

    object

    任意

    ParameterKey

    string

    必須

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

    説明

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

    Amount
    ParameterValue

    string

    必須

    テンプレートで定義されているパラメーターの値。N の値は最大 200 です。

    説明

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

    12
    NotificationURLs

    array

    任意

    スタックイベント通知を受信するための Webhook アドレスのリスト。

    http://my-site.com/ros-notify

    string

    任意

    スタックイベント通知を受信するための Webhook アドレス。有効な値:

    • HTTP POST URL
      各 URL の長さは最大 1,024 バイトです。

    • eventbridge
      スタックステータスの変更は EventBridge サービスに送信されます。 EventBridge コンソール にログインし、左側のナビゲーションウィンドウで [イベントバス] をクリックすると、イベント情報を表示できます。

    説明

    この機能は、中国 (杭州)、中国 (上海)、中国 (北京)、中国 (香港)、中国 (張家口) リージョンでサポートされています。

    N の値は最大 5 です。スタックのステータスが変更されると、通知が送信されます。スタックでロールバックが有効になっている場合、CREATE_FAILED および UPDATE_FAILED 状態の通知は送信されません。代わりに、CREATE_ROLLBACK および ROLLBACK 状態の通知が送信されます。IN_PROGRESS 状態は報告されません。
    スタックに Outputs パラメーターが定義されているかどうかに関係なく、通知が送信されます。次のコードは通知の例を示しています。

    {
   "Outputs": [
       {
           "Description": "説明なし",
           "OutputKey": "InstanceId",
           "OutputValue": "i-xxx"
       }
   ],
   "StackId": "80bd6b6c-e888-4573-ae3b-93d29113****",
   "StackName": "test-notification-url",
   "Status": "CREATE_COMPLETE"
}

    http://example.com/ros-notify
    ResourcesToImport

    array<object>

    任意

    インポートされるリソースのリスト。

    object

    任意

    ResourceIdentifier

    string

    任意

    文字列間のキーと値のマッピング。値は、インポートするリソースを識別するために使用される JSON 文字列です。
    キーはリソースの識別子プロパティ (例: ALIYUN::ECS::VPC リソースの VpcId) です。値はプロパティの値 (例: vpc-2zevx9ios****) です。

    GetTemplateSummary 操作を呼び出して、リソースの識別子プロパティをクエリできます。

    説明

    このパラメーターは、ChangeSetType が IMPORT に設定されている場合にのみ有効です。ResourcesToImport パラメーターはオプションです。ResourcesToImport を指定する場合は、ResourcesToImport.N.ResourceIdentifier も指定する必要があります。

    {"VpcId": "vpc-2zevx9ios******"}
    LogicalResourceId

    string

    任意

    リソースの論理 ID。論理 ID は、テンプレートで定義されているリソース名です。

    説明

    このパラメーターは、ChangeSetType が IMPORT に設定されている場合にのみ有効です。ResourcesToImport パラメーターはオプションです。ResourcesToImport を指定する場合は、ResourcesToImport.N.LogicalResourceId も指定する必要があります。

    Vpc
    ResourceType

    string

    任意

    リソースのタイプ。リソースタイプは、テンプレートで定義されているリソースタイプと同じである必要があります。

    説明

    このパラメーターは、ChangeSetType が IMPORT に設定されている場合にのみ有効です。ResourcesToImport パラメーターはオプションです。ResourcesToImport を指定する場合は、ResourcesToImport.N.ResourceType も指定する必要があります。

    ALIYUN::ECS::VPC
    TemplateScratchId

    string

    任意

    リソースシナリオ ID。これはリソース管理シナリオ ID です。

    このパラメーターは、ChangeSetType が IMPORT に設定されている場合にのみ有効です。このパラメーターは、リソースのインポートのための新しいスタックの作成のみをサポートします。

    リソース管理シナリオでリソースをインポートする場合は、このパラメーターのみを指定します。テンプレート関連のパラメーターは指定しないでください。

    ListTemplateScratches 操作を呼び出して、リソース管理シナリオ ID をクエリできます。

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****
    Parallelism

    integer

    任意

    リソースに対して同時に実行できる操作の最大数。デフォルト値は空で、値が 0 以上の整数であることを指定します。このパラメーターを設定すると、値はスタックに関連付けられ、スタックに対する後続の操作に影響します。

    このパラメーターは、ChangeSetType が CREATE または UPDATE に設定されている場合にのみ有効です。有効な値:

    • ChangeSetType が CREATE に設定されている場合

      • このパラメーターを 0 より大きい整数に設定すると、その整数が使用されます。

      • このパラメーターを 0 に設定するか、このパラメーターを設定しない場合、ROS スタックには制限が課されません。Terraform スタックの場合、Terraform のデフォルト値 (10) が使用されます。

    • ChangeSetType が UPDATE に設定されている場合

      • このパラメーターを 0 より大きい整数に設定すると、その整数が使用されます。

      • このパラメーターを 0 に設定すると、ROS スタックには制限が課されません。Terraform スタックの場合、Terraform のデフォルト値 (10) が使用されます。

      • このパラメーターを設定しない場合、前の操作で指定した値が使用されます。前の操作でこのパラメーターを設定しなかった場合、ROS スタックには制限が課されません。Terraform スタックの場合、Terraform のデフォルト値 (10) が使用されます。

    1
    Tags

    array<object>

    任意

    変更セットのタグ。

    object

    任意

    変更セットのタグ。

    Key

    string

    任意

    スタックのタグキー。

    N の値は 1 ～ 20 です。

    説明

    • タグパラメーターはオプションです。タグを指定する場合は、Tags.N.Key も指定する必要があります。

    • タグは、タグをサポートする各スタックリソースに伝播されます。詳細については、「タグを伝播する」をご参照ください。

    Value

    string

    任意

    スタックのタグ値。

    N の値は 1 ～ 20 です。

    説明

    タグは、タグをサポートする各スタックリソースに伝播されます。詳細については、「タグを伝播する」をご参照ください。

    ResourceGroupId

    string

    任意

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

    TaintResources

    array

    任意

    ダーティとしてマークされるリソースのリスト。

    string

    任意

    • ROS スタックの場合、値はリソース名 (例: my_vpc) です。

    • Terraform スタックの場合、値はリソースタイプとリソース名 (例: alicloud_vpc.my_vpc) です。

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

    レスポンスパラメーター

    パラメーター

    タイプ

    説明

    例

    object

    ChangeSetId

    string

    変更セットの ID です。

    e85abe0c-6528-43fb-ae93-fdf8de22****
    RequestId

    string

    リクエスト ID。

    B288A0BE-D927-4888-B0F7-B35EF84B6E6F
    StackId

    string

    スタック ID。

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****

    エラーコード

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

    変更履歴

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