调用CreateStackGroup接口创建资源栈组。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateStackGroup

系统规定参数。取值:CreateStackGroup。

Parameters.N.ParameterKey String Amount

参数的名称。 如果未指定特定参数的名称和值,则ROS将使用模板中指定的默认值。

N最大值为200。

Parameters.N.ParameterValue String 12

参数的值。

N最大值为200。

RegionId String cn-hangzhou

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

StackGroupName String MyStackGroup

资源栈组名称。名称在单个Region内唯一,可以包含数字、英文字母(区分大小写)、连字符、下划线。必须以数字或英文字母开头,且长度不超过255个字符。

Description String StackGroup Description

资源栈组描述。长度限制:1~256个字符。

TemplateBody String {"ROSTemplateFormatVersion":"2015-09-01"}

模板的结构。长度为1~51200个字节。您必须指定TemplateBody或TemplateURL参数,但不能同时指定两者。

TemplateURL String oss://ros-template/demo

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

您必须指定TemplateBody或TemplateURL参数,但不能同时指定两者。

ClientToken String 123e4567-e89b-12d3-a456-426655440000

保证请求的幂等性。 该值由客户端生成,并且必须是全局唯一的。 仅允许使用英文字母(区分大小写)、数字、字符、连字符和下划线。它最多可包含64个字符。更多详情,请参见如何保证幂等性

AdministrationRoleName String AliyunROSStackGroupAdministrationRole

用来供ROS服务扮演的RAM管理员角色名称。ROS会以该角色身份进一步扮演执行角色来操作资源栈组中资源栈实例所对应的资源栈。

仅在使用自定义管理员角色来控制哪些用户或组可以管理同一管理员账号中的特定资源栈组时,才指定RAM角色。若不指定,则使用AliyunROSStackGroupAdministrationRole作为默认值。

长度限制:1~64个字符。允许英文字母(区分大小写)、数字或连字符。

ExecutionRoleName String AliyunROSStackGroupExecutionRole

用来供管理员角色扮演的RAM执行角色名称。ROS以该角色身份来操作资源栈组中资源栈实例所对应的资源栈。

若不指定,则使用AliyunROSStackGroupExecutionRole作为默认值。

长度限制:1~64个字符。允许英文字母(区分大小写)、数字或连字符。

返回数据

名称 类型 示例值 描述
RequestId String 14A07460-EBE7-47CA-9757-12CC4761D47A

请求ID。

StackGroupId String 2c036e78-9e82-428e-afd6-177f5d04db9d

资源栈组ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateStackGroup
&Parameters.1.ParameterKey=Amount
&Parameters.1.ParameterValue=12
&RegionId=cn-hangzhou
&StackGroupName=MyStackGroup
&<公共请求参数>

正常返回示例

XML 格式

<StackGroupId>fd0ddef9-9540-4b42-a464-94f7783501d0</StackGroupId>
<RequestId>FEA9B039-1062-4C7F-8659-CB02B9C68017</RequestId>

JSON 格式

{
	"StackGroupId": "fd0ddef9-9540-4b42-a464-94f7783501d0",
	"RequestId": "FEA9B039-1062-4C7F-8659-CB02B9C68017"
}

错误码

访问错误中心查看更多错误码。