阿里云资源编排CreateStack

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	CreateStack	系统规定参数。取值：CreateStack。
RegionId	String	是	cn-hangzhou	资源栈所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。
StackName	String	是	MyStack	资源栈名称。资源栈名称可以包含数字、字母（大小写敏感）、连字符、下划线，必须以数字或字母开头，长度不超过255个字符。
Parameters.N.ParameterKey	String	是	Amount	参数的名称。如果未指定特定参数的名称和值，则ROS将使用模板中指定的默认值。N的最大值为200。
Parameters.N.ParameterValue	String	是	12	参数值。N的最大值为200。
TimeoutInMinutes	Long	是	10	创建资源栈的超时时间。单位：分钟。默认值：60。
DisableRollback	Boolean	否	false	当创建资源栈失败时，是否禁用回滚策略。取值： true：禁用回滚，即当创建资源栈失败时不进行回滚。 false：不禁用回滚，即当创建资源栈失败时进行回滚。默认值：false。
TemplateBody	String	否	{ “ROSTemplateFormatVersion”: “2015-09-01” }	模板主体的结构。长度为1~51200个字节。您必须指定TemplateBody或TemplateURL参数，但不能同时指定两者。
StackPolicyURL	String	否	oss://ros-stack-policy/demo	资源栈策略的文件的位置。资源栈策略的文件最大为16384个字节。URL必须指向位于Web服务器（http、https）或阿里云OSS存储空间（例如oss://ros/stack-policy/demo、oss://ros/stack-policy/demo?RegionId=cn-hangzhou。OSS地域如未指定，默认与接口参数RegionId相同。）中的策略。您可以指定StackPolicyBody或StackPolicyURL参数，但不能同时指定两者。URL的最大长度为1350个字节。
StackPolicyBody	String	否	{“Statement”: [{“Action”: “Update:”, “Resource”: “”, “Effect”: “Allow”, “Principal”: “*”}]}	资源栈策略主体的结构。长度为1~16384个字节。您可以指定StackPolicyBody或StackPolicyURL参数，但不能同时指定两者。
NotificationURLs.N	RepeatList	否	http://my-site.com/ros-event	接收资源栈事件的URL回调地址。仅支持HTTP POST。N的最大值为5。每个URL的最大长度为1024个字节。
TemplateURL	String	否	oss://ros-template/demo	模板主体的文件的位置。模板主体的文件最大为524288个字节。URL必须指向位于Web服务器（http、https）或阿里云OSS存储空间（例如oss://ros/template/demo、oss://ros/template/demo?RegionId=cn-hangzhou。OSS地域如未指定，默认与接口参数RegionId相同。）中的模板。您必须指定TemplateBody或TemplateURL参数，但不能同时指定两者。URL的最大长度为1024个字节。
ClientToken	String	否	123e4567-e89b-12d3-a456-426655440000	保证请求的幂等性。此参数值由客户端生成，并且必须是全局唯一的。仅允许ASCII字符，最多可包含64个字符。更多详情，请参见如何保证幂等性。

返回数据


名称	类型	示例值	描述
StackId	String	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	资源栈ID。
RequestId	String	B288A0BE-D927-4888-B0F7-B35EF84B6E6F	请求ID。

示例

请求示例


http(s)://ros.aliyuncs.com/?Action=CreateStack
&RegionId=cn-hangzhou
&StackName=MyStack
&Parameters.1.ParameterKey=Amount
&Parameters.1.ParameterValue=12
&TimeoutInMinutes=10
&<公共请求参数>

正常返回示例

XML 格式

<CreateStackResponse>
      <StackId>4a6c9851-3b0f-4f5f-b4ca-a14bf691****</StackId>
      <RequestId>B288A0BE-D927-4888-B0F7-B35EF84B6E6F</RequestId>
</CreateStackResponse>

JSON 格式

{
	"StackId":"4a6c9851-3b0f-4f5f-b4ca-a14bf691****",
	"RequestId":"B288A0BE-D927-4888-B0F7-B35EF84B6E6F"
}

错误码

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

访问公共错误码查看更多错误码。


错误码	错误信息	HttpCode	描述
400	CircularDependency	Circular Dependency Found: {reason}.	模板包含循环引用。reason为具体原因。
400	InvalidSchema	{reason}.	模板格式不正确。reason为具体原因。
400	InvalidTemplateAttribute	The Referenced Attribute ({resource} {name}) is incorrect.	模板包含不正确的资源属性（输出）引用。resource为资源名，name为属性名。
400	InvalidTemplatePropertyType	The specified value type of ({resource} {section}) is incorrect.	模板资源定义中，字段类型不正确。resource为资源名，section为字段名。
400	InvalidTemplateReference	The specified reference “{name}” (in {referencer}) is incorrect.	模板包含不正确的引用。name为引用名，referencer为引用者。
400	InvalidTemplateSection	The template section is invalid: {section}.	模板包含无效的字段。section为字段名。
400	InvalidTemplateVersion	The template version is invalid: {reason}.	模板版本不正确。reason为具体原因。
400	StackValidationFailed	{reason}.	资源栈校验失败。reason为具体原因。
400	UnknownUserParameter	The Parameter ({name}) was not defined in template.	传递的参数在模板中未定义。name为参数名。
400	UserParameterMissing	The Parameter {name} was not provided.	参数在模板中已定义，但未传递值。name为参数名。
409	ActionInProgress	Stack {name} already has an action ({action}) in progress.	资源栈在变更中。name为资源栈名称或ID，action为具体的变更操作。
409	StackExists	The Stack ({name}) already exists.	同名资源栈已存在。name为资源栈名称。

阿里云资源编排CreateStack

调试

请求参数

返回数据

示例

错误码

相关推荐

发表评论