全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
资源编排

创建堆栈

更新时间:2017-06-07 13:26:11

创建堆栈

描述:

•    用户指定模板和参数列表创建堆栈
•    模板内容在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 http://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"
}
本文导读目录