325
windows
查询堆栈列表__堆栈相关接口_API 文档_资源编排-阿里云
查询堆栈列表
描述：查询用户下面的stack列表
请求参数
| 名称 |
位置 |
类型 |
是否必须 |
描述 |
|---|
| 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 |
|---|
D
| PageNumber |
Query |
Integer |
否 |
堆栈列表的页码，起始值为 1，默认值为 1 |
|---|
| PageSize |
Query |
Integer |
否 |
分页查询时设置的每页行数，最大值 100 行，默认为 10 |
|---|
返回参数
| 名称 |
参数类型 |
描述 |
|---|
| TotalCount |
Integer |
堆栈总个数 |
|---|
| PageNumber |
Integer |
堆栈列表的页码 |
|---|
| PageSize |
Integer |
输入时设置的每页行数 |
|---|
| Stacks |
List |
Stack对象列表，具体属性参见Stack对象定义 |
|---|
Stack
| 名称 |
参数类型 |
描述 |
|---|
| Region |
String |
堆栈所在区域 |
|---|
| Id |
String |
堆栈的Id |
|---|
| Name |
String |
stack的名称 |
|---|
| 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 |
当创建stack失败时，是否禁用回滚策略。True表示禁用回滚，即在创建stack失败时不会进行回滚；False表示不禁用回滚，即在创建stack失败时会进行回滚 |
|---|
| TimeoutMins |
Integer |
创建堆栈的超时时间，以分钟为单位 |
|---|
错误码
| 错误代码 |
描述 |
Http状态码 |
语义 |
|---|
| InternalError |
Server error |
500 |
服务器端出现未知异常 |
|---|
| StackNotFound |
The Stack (%(stack_name)s) could not be found. |
404 |
Stack不存在 |
|---|
示例
请求示例
GET https://ros.aliyuncs.com/stacks HTTP/1.1
x-acs-signature-method: HMAC-SHA1
Authorization: acs ACSTQDkNtSMrZtwL:E9tMDBiLOywWyO1NJubGXV2Dq08=
Date: Fri, 11 Sep 2015 05:28:05 GMT
x-acs-signature-version: 1.0
x-sdk-client: Java/2.0.0
Accept: application/octet-stream
x-acs-version: 2015-09-01
Cache-Control: no-cache
Pragma: no-cache
Host: ros.aliyuncs.com
Connection: keep-alive
返回示例
HTTP/1.1 200 OK
Date: Fri, 11 Sep 2015 05:28:06 GMT
Content-Type: application/json; charset=UTF-8
Content-Length: 945
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: 1DD1048F-0B74-48EB-9364-E509C5072964
{
"TotalCount" : 5,
"PageNumber" : 1,
"Stacks" : [{
"Status" : "CREATE_COMPLETE",
"Updated" : null,
"Description" : "No description",
"Created" : "2015-10-23T07:54:29",
"Region" : "cn-beijing",
"StatusReason" : "Stack CREATE completed successfully",
"DisableRollback" : true,
"TimeoutMins" : 15,
"Id" : "2669808f-c5e1-4777-85b9-5a2a39718cc4",
"Name" : "hope_test_chinese"
}, {
"Status" : "CREATE_COMPLETE",
"Updated" : null,
"Description" : "No description",
"Created" : "2015-10-23T05:17:59",
"Region" : "cn-beijing",
"StatusReason" : "Stack CREATE completed successfully",
"DisableRollback" : true,
"TimeoutMins" : 15,
"Id" : "4cf2a4bd-c09c-4b4e-b2ab-d0e381108f45",
"Name" : "hope_test_ScalingGroup"
}
],
"PageSize" : 2
}
最后更新：2016-11-23 17:16:06