CreateStack - 资源编排

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

模板中已定义的参数的名称。 如果未指定参数的名称和取值，ROS将使用模板中指定的默认值。

N最大值为：200。

模板中已定义的参数的取值。

N最大值为：200。

资源栈所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

资源栈名称。

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

资源栈的标签键。

N的取值范围为：1~20。

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

取值：

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

模板主体的结构。长度为1~524,288个字节。如果长度较大，则建议通过HTTP POST+Body Param的方式，将参数放在请求体中进行传递，避免因URL过长而导致请求失败。

包含资源栈策略的文件的位置。 URL必须指向位于Web服务器（HTTP或HTTPS）或阿里云OSS存储桶（例如：oss://ros/stack-policy/demo、oss://ros/stack-policy/demo?RegionId=cn-hangzhou）中的策略，策略文件最大长度为16,384个字节。 如未指定OSS地域，默认与接口参数RegionId相同。

URL最大长度为1350个字节。

创建资源栈的超时时间。

• 默认值：60。
• 单位：分钟。

包含资源栈策略主体的结构，长度为1~16,384个字节。

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

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

更多信息，请参见如何保证幂等性。

包含模板主体的文件的位置。URL必须指向位于HTTP Web服务器（HTTP或HTTPS）或阿里云OSS存储桶中的模板（1~524,288个字节）。OSS存储桶的URL例如oss://ros/template/demo或oss://ros/template/demo?RegionId=cn-hangzhou。如未指定OSS地域，默认与接口参数RegionId相同。

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

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

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

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

是否开启资源栈删除保护。取值：

• Enabled：开启资源栈删除保护。
• Disabled（默认）：关闭资源栈删除保护。此时支持通过控制台或API（DeleteStack）释放资源栈。

用于控制创建资源栈的行为，取值：

• KeepStackOnCreationComplete（默认值）：创建资源栈成功后保留资源栈及资源栈中的资源，占用ROS允许创建的资源栈数量限额。
• AbandonStackOnCreationComplete：创建资源栈成功后删除资源栈，但保留所有资源，不占用ROS允许创建的资源栈数量限额。如果创建资源栈失败，资源栈会保留。
• AbandonStackOnCreationRollbackComplete：创建资源栈回滚成功后删除资源栈，不占用ROS允许创建的资源栈数量限额。其他情况则保留资源栈。

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

模板版本。仅在指定TemplateId时生效。

资源组ID。如果不指定该参数，资源栈将加入默认资源组。

关于资源组的更多信息，请参见什么是资源组。

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

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

资源栈的标签值。

N的取值范围为：1~20。

资源栈ID。

请求ID。