全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 阿里云办公 培训与认证 物联网
资源编排

预览堆栈

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

描述:

预览指定模板的堆栈信息

请求参数

名称 位置 类型 是否必须 描述
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。

返回参数

名称 参数类型 描述
Description String 堆栈描述
Updated String 更新时间,按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ
Parameters JSON 堆栈参数,是参数集合的一个JSON格式
Created String 创建时间,按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ
Region String 堆栈所在区域
TemplateDescription String 模板描述
Webhook String 自定义回调函数
Id String stack ID
Resources JSON 堆栈资源的详细信息,是资源集合的一个JSON格式
Name String stack的名称
DisableRollback Boolean 当创建stack失败时,是否禁用回滚策略。True表示禁用回滚,即在创建stack失败时不会进行回滚;False表示不禁用回滚,即在创建stack失败时会进行回滚
TimeoutMins Integer 创建堆栈的超时时间,以分钟为单位

错误码

错误代码 描述 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 模板格式错误

示例

请求示例

  1. POST http://ros.aliyuncs.com/stacks/preview 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. Name”: “<stack name>”,
  18. Parameters”:
  19. {
  20. key”: value
  21. },
  22. Template”:<template text>,
  23. DisableRollback”: true,
  24. TimeoutMins”: 15
  25. }

返回示例

  1. HTTP/1.1 201 Created
  2. Date: Fri, 11 Sep 2015 05:28:48 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. "Updated":null,
  14. "Description":"No description",
  15. "Parameters":{
  16. "ALIYUN::StackId":"None",
  17. "ALIYUN::StackName":"update_test_0040",
  18. "ALIYUN::Region":"cn-beijing"
  19. },
  20. "Created":"2017-01-17T07:01:10.437639",
  21. "Region":"cn-beijing",
  22. "TemplateDescription":"No description",
  23. "Webhook":null,
  24. "Id":"None",
  25. "DisableRollback":false,
  26. "TimeoutMins":120,
  27. "Resources":[
  28. {
  29. "UpdatedTime":null,
  30. "StackIdentity":{
  31. "StackName":"update_test_0040",
  32. "StackId":"None",
  33. "Region":"cn-beijing",
  34. "Tenant":"1754580903499898",
  35. "Path":""
  36. },
  37. "ResourceStatus":"COMPLETE",
  38. "Description":"",
  39. "ResourceData":null,
  40. "ResourceStatusReason":"",
  41. "ResourceAction":"INIT",
  42. "PhysicalResourceId":"",
  43. "DeletedTime":null,
  44. "StackName":"update_test_0040",
  45. "ResourceType":"ALIYUN::ECS::InstanceGroupClone",
  46. "RequiredBy":[
  47. ],
  48. "Attributes":{
  49. "OrderId":null,
  50. "InnerIps":null,
  51. "PrivateIps":null,
  52. "ZoneIds":null,
  53. "PublicIps":null,
  54. "InstanceIds":null
  55. },
  56. "CreatedTime":null,
  57. "ResourceName":"WebServer",
  58. "ResourceIdentity":{
  59. "StackName":"update_test_0040",
  60. "StackId":"None",
  61. "Region":"cn-beijing",
  62. "Tenant":"1754580903499898",
  63. "Path":"/resources/WebServer"
  64. },
  65. "Properties":{
  66. "AutoReleaseTime":null,
  67. "DiskMappings":null,
  68. "LoadBalancerIdToAttach":null,
  69. "Description":null,
  70. "BackendServerWeight":100,
  71. "Tags":null,
  72. "MinAmount":1,
  73. "SecurityGroupId":null,
  74. "ZoneId":null,
  75. "InternetMaxBandwidthOut":null,
  76. "ImageId":null,
  77. "SourceInstanceId":"i-2ze5q7nkum5974w67jhr",
  78. "Password":"Test1234",
  79. "InstanceName":null,
  80. "MaxAmount":1
  81. },
  82. "Metadata":{
  83. }
  84. }
  85. ],
  86. "Name":"update_test_0040"
  87. }
本文导读目录