You need to enable JavaScript to run this app.
文档中心
基础设施管理

基础设施管理

请输入
  • 文档首页
    • 基础设施管理API参考资源栈管理ListStacks - 查询资源栈列表
复制全文
下载 pdf
我的收藏
资源栈管理
ListStacks - 查询资源栈列表
复制全文
下载 pdf
我的收藏
ListStacks - 查询资源栈列表
查询资源栈列表，支持筛选、排序和分页​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值：ListStacks​
要执行的操作，取值：ListStacks。​
​
Version string 必选 示例值：2026-05-01​
API的版本，取值：2026-05-01。​
​
StackID string 可选 示例值：s-01kvsfjgx4bda74jjgm8tc70gx​
资源栈 ID​
​
StackName string 可选 示例值：MyStack​
资源栈名称​
​
Status string[] 可选 示例值：["CreateComplete"]​
资源栈状态​
​
SortBy string 可选 示例值：UpdatedTime​
排序字段，支持：CreatedTime、UpdatedTime，默认 UpdatedTime。​
​
SortOrder string 可选 示例值：Desc​
排序方向，支持：Asc、Desc，默认 Desc。​
​
MaxResults integer 可选 示例值：100​
分页大小，最大 100​
​
NextToken string 可选 示例值：""​
下一页令牌​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
Stacks object[] 示例值：-​
资源栈摘要列表​
StackID string 示例值：s-01kvsfjgx4bda74jjgm8tc70gx​
资源栈 ID​
​
StackName string 示例值：MyStack​
资源栈名称​
​
Description string 示例值：my stack​
资源栈描述​
​
StackStatus string 示例值：CreateComplete​
资源栈状态​
​
StatusReason string 示例值：""​
状态原因​
​
CreatedTime string 示例值：2026-09-09T09:09:09Z​
创建时间​
​
UpdatedTime string 示例值：2026-09-09T09:09:09Z​
更新时间​
​
​
NextToken string 示例值：""​
下一页令牌​
​
TotalCount integer 示例值：1​
总数​
​
​
​
请求示例​
​
POST /?Action=ListStacks&Version=2026-05-01 HTTP/1.1​
Host: inframanager.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260909T120346Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260909/cn-beijing/inframanager/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"MaxResults": 100,​
"NextToken": ""​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20260909200413008014112201646AF8",​
"Action": "ListStacks",​
"Version": "2026-05-01",​
"Service": "inframanager",​
"Region": "cn-beijing"​
},​
"Result": {​
"Stacks": [​
{​
"StackID": "s-01kvsfjgx4bda74jjgm8tc70gx",​
"StackName": "MyStack",​
"Description": "my stack",​
"StackStatus": "CreateComplete",​
"StatusReason": "",​
"CreatedTime": "2026-09-09T09:09:09Z",​
"UpdatedTime": "2026-09-09T09:09:09Z"​
}​
],​
"NextToken": "",​
"TotalCount": 1​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidParameter​
The specified parameter %q is invalid.​
请求参数不合法。​
400​
MissingParameter​
The parameter %q is required.​
缺少必填参数。​
400​
RegionNotSupport​
The service [%v] not support region [%v].​
服务不支持当前地域。​
500​
InternalError​
The request has failed due to an unknown error.​
内部服务错误，请稍后重试。​
​
​
最近更新时间：2026.09.11 17:35:53
这个页面对您有帮助吗？
有用
有用
无用
无用