全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 智能硬件
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 更多
资源编排

更新资源栈

更新时间:2018-02-28 10:57:20

通过 PUT 方法调用 /stacks/{StackName}/{StackId} 更新某个资源栈。

说明

  • 用户需指定资源栈名称,资源栈 ID 和新的模板以及参数列表来更新资源栈。

  • 模板内容在 HTTP 消息体中提交。

  • 系统根据资源栈名称和资源栈 ID 找到确认需要更新的资源栈,比较新模板和原有模板的不同,对两个模板中的每个资源做相应的操作。如果新模板添加了原有模板中没有的资源,更新操作会添加新资源到资源栈中;如果新模板删除了原有模板中的某个资源,更新操作会从资源栈中删除该资源;如果新模板中修改了原有模板中的资源属性,则针对该资源属性做更新操作。

  • 只更新资源中支持更新的属性,否则报错。

  • 不支持更新资源栈名称。

  • 如果选择了更新失败回滚,则更新失败后,资源栈恢复到原有状态。

  • 需要指定创建资源栈的地域 (x-acs-region-id)。

请求参数

名称 位置 类型 是否必须 描述
x-acs-region-id header String 资源栈所在的地域。
StackName URI String 资源栈名称,需符合该正则表达式^[a-zA-Z][a-zA-Z0-9_.-]*$,长度不超过255个字符。
StackId URI String 资源栈 ID。
Template body JSON 模板的 JSON 格式,目前默认最大为 512KB。该配置值可调。
Parameters body JSON 更新资源栈所需要的参数,key 需要在模板中定义。
DisableRollback body Boolean 当更新资源栈失败时,是否禁用回滚策略。True 表示禁用回滚,即在更新资源栈失败时不会进行回滚;False 表示不禁用回滚,即在更新资源栈失败时会进行回滚。
TimeoutMins body Integer 更新资源栈的超时时间,以分钟为单位。默认值为 60。

返回参数

名称 参数类型 描述
Id String 资源栈的 ID,全局唯一。
Name String 资源栈的名称。

错误码

错误代码 描述 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 非法的删除策略。
StackValidationFailed “%s” deletion policy not supported. 400 非法的删除策略。
StackValidationFailed Unknown Property %s. 400 未知的属性。
InvalidSchemaError Property %(prop)s: %(ua)s and %(im)s cannot both be True. 400 模板格式错误。

示例

请求示例

  1. PUT http://ros.aliyuncs.com/stacks/myStack/28087440-3701-40ef-bbe8-6e80787d307f HTTP/1.1
  2. x-acs-signature-method: HMAC-SHA1
  3. Authorization: acs <AccessKeyId>:<signature>
  4. Date: Fri, 11 Sep 2015 05:28:47 GMT
  5. Content-MD5: 4eCVDLNDI0GRJMiZ6mLmgw==
  6. x-acs-signature-version: 1.0
  7. Accept: application/octet-stream
  8. Content-Type: application/json;charset=utf-8
  9. x-acs-version: 2015-09-01
  10. Cache-Control: no-cache
  11. Pragma: no-cache
  12. x-acs-region-id:cn-beijing
  13. Host: ros.aliyuncs.com
  14. Connection: keep-alive
  15. Content-Length: 502
  16. {
  17. Parameters”:
  18. {
  19. key”: value
  20. },
  21. Template”:<template text>,
  22. DisableRollback”: true,
  23. TimeoutMins”: 15
  24. }

返回示例

  1. HTTP/1.1 200 OK
  2. Date: Wed, 04 Jan 2017 08:13:24 GMT
  3. Content-Type: application/json
  4. Content-Length: 155
  5. Connection: close
  6. Access-Control-Allow-Origin: *
  7. Access-Control-Allow-Methods: POST, GET, OPTIONS
  8. Access-Control-Allow-Headers: X-Requested-With, X-Sequence, _aop_secret, _aop_signature
  9. Access-Control-Max-Age: 172800
  10. X-Acs-Request-Id: 14EB3BE2-B4A8-4F84-BD6E-52F222DDB66C
  11. Server: Jetty(7.2.2.v20101205)
  12. {
  13. "Id":"b44afc3c-46a4-4087-a215-c333a1218316",
  14. "Name":"myStack"
  15. }
本文导读目录