文档中心

基础设施管理

资源栈集管理

ListStackInstances - 查询资源栈集实例列表

查询资源栈集实例列表。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ListStackInstances

要执行的操作，取值：ListStackInstances。

Version string 必选示例值：2026-05-01

API的版本，取值：2026-05-01。

StackSetID string 必选示例值：ss-01arz3ndektsv4rrffq69g5fav

资源栈集 ID。

StackInstanceID string 可选示例值：si-01arz3ndektsv4rrffq69g5fav

按资源栈实例 ID 精确过滤。

TargetAccountID long 可选示例值：20001

按目标账号过滤。

TargetRegion string 可选示例值：cn-beijing

按目标地域过滤。

Status string[] 可选示例值：["Current"]

按实例状态过滤，支持 Pending、Current、Outdated 和 Inoperable。

SortBy string 可选示例值：UpdatedTime

排序字段，支持 CreatedTime 和 UpdatedTime。

SortOrder string 可选示例值：Desc

排序方向，支持 Asc 和 Desc。

MaxResults integer 可选示例值：100

分页大小，取值范围 1-100，默认 100。

NextToken string 可选示例值：""

分页 token，绑定查询条件。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

Instances object[] 示例值：-

资源栈集实例摘要列表。

StackInstanceID string 示例值：si-01arz3ndektsv4rrffq69g5fav

实例 ID。

StackSetID string 示例值：ss-01arz3ndektsv4rrffq69g5fav

资源栈集 ID。

TargetAccountID long 示例值：20001

目标账号 ID。

TargetRegion string 示例值：cn-beijing

目标地域。

TargetStackID string 示例值：s-01arz3ndektsv4rrffq69g5fav

目标资源栈 ID。

Status string 示例值：Current

实例状态：Pending、Current、Outdated 或 Inoperable。

StatusReason string 示例值：""

状态原因。

CreatedTime string 示例值：2026-09-10T08:00:00Z

创建时间。

UpdatedTime string 示例值：2026-09-10T08:00:00Z

更新时间。

NextToken string 示例值：""

下一页分页 token。

TotalCount integer 示例值：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].	服务不支持当前地域。
404	EntityNotFound.StackSet	The stack set %q does not exist in the current region.	资源栈集不存在或管理地域不匹配。
500	InternalError	The request has failed due to an unknown error.	内部服务错误，请稍后重试。

最近更新时间：2026.10.20 19:15:48

这个页面对您有帮助吗？

有用

无用