全部产品
阿里云办公

查询资源栈列表

更新时间:2018-03-01 10:27:42

通过 GET 方法调用查询资源栈列表相应的 URI (/stacks) 来查询资源栈列表。

请求参数

名称 位置 类型 是否必须 描述
RegionId Query String 资源栈创建时,指定的地域。
StackId Query String 资源栈 ID。
Name Query String 资源栈名称,需符合该正则表达式 ^[a-zA-Z][a-zA-Z0-9_.-]*$。最长度超过 255 个字符。
Status Query String 用于过滤的资源栈状态。可选值为:CREATE_COMPLETE,CREATE_FAILED,CREATE_IN_PROGRESS,DELETE_FAILED,DELETE_IN_PROGRESS,ROLLBACK_COMPLETE,ROLLBACK_FAILED,ROLLBACK_IN_PROGRESS。
PageNumber Query Integer 资源栈列表的页码,起始值为 1,默认值为 1。
PageSize Query Integer 分页查询时设置的每页行数,最大值 100 行,默认为 10。

返回参数

名称 参数类型 描述
TotalCount Integer 资源栈总个数。
PageNumber Integer 资源栈列表的页码。
PageSize Integer 输入时设置的每页行数。
Stacks List 资源栈对象列表。具体属性,请参见以下 资源栈 表格。

资源栈

名称 参数类型 描述
Region String 资源栈所在区域。
Id String 资源栈的 ID。
Name String 资源栈的名称。
Updated String 更新时间。按照 ISO8601 标准表示,并使用 UTC 时间。格式为:YYYY-MM-DDThh:mm:ssZ。
Created String 创建时间。按照 ISO8601 标准表示,并使用 UTC 时间。格式为:YYYY-MM-DDThh:mm:ssZ。
StatusReason String 状态原因。
Status String 资源栈状态。可选值为:CREATE_COMPLETE,CREATE_FAILED,CREATE_IN_PROGRESS,DELETE_FAILED,DELETE_IN_PROGRESS,ROLLBACK_COMPLETE,ROLLBACK_FAILED,ROLLBACK_IN_PROGRESS。
Description String 资源栈描述。
DisableRollback Boolean 当创建资源栈失败时,是否禁用回滚策略。True 表示禁用回滚,即在创建资源栈失败时不会进行回滚;False 表示不禁用回滚,即在创建资源栈失败时会进行回滚。
TimeoutMins Integer 创建资源栈的超时时间,以分钟为单位。

错误码

错误代码 描述 Http 状态码 语义
InternalError Server error. 500 服务器端出现未知异常。
StackNotFound The Stack (%(stack_name)s) could not be found. 404 资源栈不存在。

示例

请求示例

  1. GET http://ros.aliyuncs.com/stacks HTTP/1.1
  2. x-acs-signature-method: HMAC-SHA1
  3. Authorization: acs ACSTQDkNtSMrZtwL:E9tMDBiLOywWyO1NJubGXV2Dq08=
  4. Date: Fri, 11 Sep 2015 05:28:05 GMT
  5. x-acs-signature-version: 1.0
  6. x-sdk-client: Java/2.0.0
  7. Accept: application/octet-stream
  8. x-acs-version: 2015-09-01
  9. Cache-Control: no-cache
  10. Pragma: no-cache
  11. Host: ros.aliyuncs.com
  12. Connection: keep-alive

返回示例

  1. HTTP/1.1 200 OK
  2. Date: Fri, 11 Sep 2015 05:28:06 GMT
  3. Content-Type: application/json; charset=UTF-8
  4. Content-Length: 945
  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: 1DD1048F-0B74-48EB-9364-E509C5072964
  11. {
  12. "TotalCount" : 5,
  13. "PageNumber" : 1,
  14. "Stacks" : [{
  15. "Status" : "CREATE_COMPLETE",
  16. "Updated" : null,
  17. "Description" : "No description",
  18. "Created" : "2015-10-23T07:54:29",
  19. "Region" : "cn-beijing",
  20. "StatusReason" : "Stack CREATE completed successfully",
  21. "DisableRollback" : true,
  22. "TimeoutMins" : 15,
  23. "Id" : "2669808f-c5e1-4777-85b9-5a2a39718cc4",
  24. "Name" : "hope_test_chinese"
  25. }, {
  26. "Status" : "CREATE_COMPLETE",
  27. "Updated" : null,
  28. "Description" : "No description",
  29. "Created" : "2015-10-23T05:17:59",
  30. "Region" : "cn-beijing",
  31. "StatusReason" : "Stack CREATE completed successfully",
  32. "DisableRollback" : true,
  33. "TimeoutMins" : 15,
  34. "Id" : "4cf2a4bd-c09c-4b4e-b2ab-d0e381108f45",
  35. "Name" : "hope_test_ScalingGroup"
  36. }
  37. ],
  38. "PageSize" : 2
  39. }