895
微信
创建堆栈__堆栈相关接口_API 文档_资源编排-阿里云
创建堆栈
描述：
• 用户指定模板和参数列表创建堆栈
• 模板内容在HTTP消息体中提交
• 堆栈名称由用户指定, 堆栈创建成功后ROS服务返回堆栈ID，后续操作以ID作为唯一标识
• 堆栈会创建在以用户ID为区分的命名空间下，所以同一个用户在同一个region中创建的堆栈名称不能重复
• 堆栈创建成功后，不支持重命名堆栈
• 不支持堆栈过继到另一个用户下
• 需要指定创建的区域(x-acs-region-id)
• 堆栈下所有资源所在区域需要与堆栈所在区域相同
请求参数
| 名称 |
位置 |
类型 |
是否必须 |
描述 |
|---|
| x-acs-region-id |
header |
String |
是 |
要创建stack的区域，参见Region列表ROS区域列表。 |
|---|
| Name |
body |
String |
是 |
堆栈名称，需符合该正则表达式^[a-zA-Z][a-zA-Z0-9_.-]*$，最大不超过255个字符。 |
|---|
| Template |
body |
JSON |
是 |
模板的JSON格式，目前默认最大为512Kb。该配置值可调。 |
|---|
| Parameters |
body |
JSON |
是 |
创建堆栈所需要的参数，key需要在templete中定义。 |
|---|
| DisableRollback |
body |
Boolean |
否 |
当创建stack失败时，是否禁用回滚策略。True表示禁用回滚，即在创建stack失败时不会进行回滚；False表示不禁用回滚，即在创建stack失败时会进行回滚。 |
|---|
| TimeoutMins |
body |
Integer |
是 |
创建堆栈的超时时间,以分钟为单位，默认值60。 |
|---|
返回参数
| 名称 |
参数类型 |
描述 |
|---|
| Id |
String |
stack的Id，全局唯一。 |
|---|
| Name |
String |
stack的名称。 |
|---|
错误码
| 错误代码 |
描述 |
Http状态码 |
语义 |
|---|
| InternalError |
Server error |
500 |
服务器端出现未知异常 |
|---|
| NotSupported |
%(feature)s is not supported |
404 |
参数不支持 |
|---|
| InvalidTemplateVersion |
Template version was not provided. |
400 |
模板版本号不合法 |
|---|
| InvalidTemplateVersion |
Ambiguous versions (%s). |
400 |
模板版本号不合法 |
|---|
| InvalidTemplateSection |
The Parameter (%(key)s) has no attributes. |
400 |
错误的模板属性 |
|---|
| StackValidationFailed |
Each Resource must contain a Type key. |
400 |
资源必须包含Type属性 |
|---|
| StackValidationFailed |
Resources must contain Resource. Found a [%s] instead. |
400 |
Resources必须包含Resource |
|---|
| StackValidationFailed |
Invalid deletion policy "%s". |
400 |
非法的deletion policy |
|---|
| StackValidationFailed |
"%s" deletion policy not supported. |
400 |
非法的deletion policy |
|---|
| StackValidationFailed |
Unknown Property %s. |
400 |
未知的属性 |
|---|
| InvalidSchemaError |
Property %(prop)s: %(ua)s and %(im)s cannot both be True. |
400 |
模板格式错误 |
|---|
示例
请求示例
POST https://ros.aliyuncs.com/stacks HTTP/1.1
x-acs-signature-method: HMAC-SHA1
Authorization: acs <AccessKeyId>:<signature>
Date: Fri, 11 Sep 2015 05:28:47 GMT
Content-MD5: 4eCVDLNDI0GRJMiZ6mLmgw==
x-acs-signature-version: 1.0
Accept: application/octet-stream
Content-Type: application/json;charset=utf-8
x-acs-version: 2015-09-01
Cache-Control: no-cache
Pragma: no-cache
x-acs-region-id:cn-beijing
Host: ros.aliyuncs.com
Connection: keep-alive
Content-Length: 502
{
“Name”: “<stack name>”,
“Parameters”:
{
“key”: “value”
},
“Template”:<template text>,
“DisableRollback”: true,
“TimeoutMins”: 15
}
返回示例
HTTP/1.1 201 Created
Date: Fri, 11 Sep 2015 05:28:48 GMT
Content-Type: application/json
Content-Length: 155
Connection: close
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: POST, GET, OPTIONS
Access-Control-Allow-Headers: X-Requested-With, X-Sequence, _aop_secret, _aop_signature
Access-Control-Max-Age: 172800
X-Acs-Request-Id: 14EB3BE2-B4A8-4F84-BD6E-52F222DDB66C
Server: Jetty(7.2.2.v20101205)
{
"Id":"b44afc3c-46a4-4087-a215-c333a1218316",
"Name":"myStack"
}
最后更新：2016-11-23 17:16:06