CreateChangeSet - 资源编排

要执行的操作，取值：CreateChangeSet。

更改集的名称。

长度不超过255个字符。必须以数字或英文字母开头，可包含数字、英文字母、短划线（-）和下划线（_）。

模板中已定义的参数的名称。如果未指定特定参数的名称和取值，则ROS将使用模板中指定的默认值。N的最大值为200。

模板中已定义的参数的取值。N的最大值为200。

更改集所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

资源逻辑ID，即模板中资源的名称。

字符串到字符串的键值映射。取值是JSON格式的字符串，用来标识要导入的资源。

键是资源的标识符属性（例如：ALIYUN::ECS::VPC资源的VpcId），值是属性的取值（例如：vpc-2zevx9ios）。资源的键可以通过GetTemplateSummary接口获取。

资源的类型，需要与模板中定义的类型一致。

创建更改集的资源栈的ID。ROS通过将此资源栈的信息与您提交的信息（例如修改后的模板或不同的参数输入值）进行比较来生成更改集。

包含资源栈策略的文件的位置。 URL必须指向位于Web服务器（HTTP或HTTPS）或阿里云OSS存储桶（例如：oss://ros/stack-policy/demo、oss://ros/stack-policy/demo?RegionId=cn-hangzhou）的策略，策略文件长为16384个字节。

您仅能指定StackPolicyBody或StackPolicyURL其中一个参数。

URL的最大长度为1350个字节。

当更改集类型为CREATE时，您可以指定StackPolicyBody或StackPolicyURL参数，但不能同时指定。当更改集类型为UPDATE时，您仅能指定以下参数之一：

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

资源栈策略的结构，长度为1~16,384个字节。当更改集类型为CREATE时，您仅能指定StackPolicyBody或StackPolicyURL其中一个参数。 当更改集类型为UPDATE时，您仅能指定以下参数之一：

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

创建更改集的资源栈的名称。

长度不超过255个字符。必须以数字或英文字母开头，可包含数字、英文字母、短划线（-）和下划线（_）。

对于未传递的参数，是否使用上次传递的值。取值：

• true
• false（默认值）

更改集的类型。取值：

• CREATE：为新资源栈创建更改集。
• UPDATE（默认值）：为现有资源栈创建更改集。
• IMPORT：为新资源栈或现有资源栈创建更改集导入非ROS托管资源。

当为新资源栈创建更改集时，ROS会创建具有唯一资源栈ID的资源栈，资源栈将处于REVIEW_IN_PROGRESS状态，直到您执行更改集。

禁止使用UPDATE类型为新资源栈创建更改集，或使用CREATE类型为现有资源栈创建更改集。

更改集的描述。最大长度为1024个字节。

保证请求的幂等性。该参数值由客户端生成，并且必须全局唯一。

长度不超过64个字符。可包含英文字母、数字、短划线（-）和下划线（_）。

更多详情，请参见如何保证幂等性。

包含模板主体的文件的位置。 URL必须指向位于Web服务器（HTTP或HTTPS）或阿里云OSS存储桶（例如：oss://ros/template/demo、oss://ros/template/demo?RegionId=cn-hangzhou）中的模板，模板最大值为524,288个字节。

您仅能指定TemplateBody、TemplateURL或TemplateId其中一个参数。

URL最大长度为1024个字节。

更新资源栈策略的文件的位置。URL必须指向位于Web服务器（HTTP或HTTPS）或阿里云OSS存储空间（例如：oss://ros/stack-policy/demo、oss://ros/stack-policy/demo?RegionId=cn-hangzhou）中的策略，策略文件最长为16,384个字节。

URL最大长度为1350个字节。

如果要更新受保护的资源，请在更新期间指定临时覆盖资源栈策略。如果未指定资源栈策略，则将使用与资源栈关联的当前策略。该参数仅在更改集类型为UPDATE时生效。您仅能指定以下参数之一：

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

模板主体的结构。长度为1~524,288个字节。

如果长度较大，建议通过HTTP POST+Body Param的方式，将参数放在请求体中进行传递，避免URL过长而导致请求失败。

您仅能指定TemplateBody、TemplateURL或TemplateId其中一个参数。

资源栈状态变为CREATE_FAILED或UPDATE_FAILED之前可以经过的时间量。

当更改集类型为CREATE时，该参数为必选参数；当更改集类型为UPDATE时，该参数为可选参数。

• 单位：分钟。
• 取值范围：10~1440。
• 默认值：60。

当创建资源栈失败时，是否禁用回滚策略。

取值：

• true：禁用回滚，即在创建资源栈失败时不进行回滚。
• false（默认值）：不禁用回滚，即在创建资源栈失败时进行回滚。

临时覆盖资源栈策略的结构。长度为1~16,384个字节。

如果要更新受保护资源，请在此更新期间指定临时覆盖资源栈策略，如未指定，则将使用与资源栈关联的当前策略。

该参数仅在更改集类型为UPDATE时生效，您仅能指定以下参数之一：

• StackPolicyBody
• StackPolicyURL
• StackPolicyDuringUpdateBody
• StackPolicyDuringUpdateURL

接收资源栈事件的回调地址。取值：

• HTTP POST URL

  每个URL最大长度为1024个字节。

• eventbridge

  资源栈状态变更会通知到事件总线（EventBridge）服务。您可以登录事件总线控制台 ，选择云服务专用总线 > 事件查询，查看事件信息。

  说明 当前支持华东1（杭州）、华东2（上海）、华北2（北京）、中国（香港）、华北3（张家口）五个地域。

N最大值为5。资源栈的状态发生变化时，会进行通知。当资源栈启用回滚时，CREATE_FAILED（创建失败）和UPDATE_FAILED（更新失败）不会通知，而CREATE_ROLLBACK（创建失败回滚）和ROLLBACK（更新失败回滚）会进行通知。IN_PROGRESS状态不会通知。

无论资源栈是否定义了Outputs都会进行通知。通知内容示例如下：

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

RAM角色名称。ROS会扮演该角色创建资源栈，使用角色的凭证代表用户进行接口调用。

ROS始终将此角色用于资源栈上将进行的操作。只要用户有权在资源栈上进行操作，即使用户无权使用角色，ROS也会使用此角色，确保角色授予最少的权限。

如果用户未指定该值，ROS将使用以前与资源栈关联的角色。如果没有可用角色，ROS将使用从您的用户凭证中生成的临时凭证。

RAM角色名称最大长度为64个字节。

如果资源的属性发生了变化，且变化的属性不支持修改更新（资源物理ID不变），是否使用替换更新（删除资源，重新创建，资源物理ID会发生变化）。取值：

• Enabled：允许替换更新。
• Disabled（默认）：不允许替换更新。

模板ID。支持共享模板和私有模板。

您仅能指定TemplateBody、TemplateURL或TemplateId其中一个参数。

模板版本。

更改集ID。

资源栈ID。

请求ID。