调用ListChangeSets接口查询更改集列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListChangeSets

要执行的操作，取值：ListChangeSets。
RegionId String 是 cn-hangzhou

更改集所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

StackId String 是 4a6c9851-3b0f-4f5f-b4ca-a14bf691****

资源栈ID。
Status.N RepeatList 否 CREATE_COMPLETE

更改集的状态。N的最大值为5。取值：

  • CREATE_PENDING
  • CREATE_IN_PROGRESS
  • CREATE_COMPLETE
  • CREATE_FAILED
  • DELETE_FAILED
  • DELETE_COMPLETE
ChangeSetName.N RepeatList 否 MyChangeSet

更改集的名称。N的最大值为5。支持使用通配符星号（*）进行模糊搜索。
PageSize Long 否 10

分页查询时设置的每页行数。

取值范围：1~50。

默认值：10。
PageNumber Long 否 1

更改集列表的页码。

起始值：1。

默认值：1。
ExecutionStatus.N RepeatList 否 AVAILABLE

更改集的执行状态。N的最大值为5。取值：

  • UNAVAILABLE
  • AVAILABLE
  • EXECUTE_IN_PROGRESS
  • EXECUTE_COMPLETE
  • EXECUTE_FAILED
  • OBSOLETE
ChangeSetId String 否 1f6521a4-05af-4975-afe9-bc4b45ad****

更改集ID。如果不需要更改集详细信息，可使用此参数代替GetChangeSet接口。

返回数据

名称 类型 示例值 描述
ChangeSets Array

更改集列表。
ChangeSetId String 1f6521a4-05af-4975-afe9-bc4b45ad****

更改集ID。
ChangeSetName String MyChangeSet

更改集名称。
ChangeSetType String UPDATE

更改集类型。
CreateTime String 2019-08-01T05:16:31

创建时间。按照ISO8601标准表示，需使用UTC时间，格式：YYYY-MM-DDThh:mm:ss。
Description String It is a demo.

更改集描述。
ExecutionStatus String AVAILABLE

更改集执行状态。
RegionId String cn-hangzhou

地域ID。
StackId String 4a6c9851-3b0f-4f5f-b4ca-a14bf691****

更改集所属资源栈ID。
StackName String MyStack

更改集所属资源栈名称。
Status String CREATE_COMPLETE

更改集状态。
StatusReason String too many changes

更改集异常状态原因。
PageNumber Integer 1

分页查询的页码。
PageSize Integer 10

分页查询时设置的每页行数。
RequestId String B288A0BE-D927-4888-B0F7-B35EF84B6E6F

请求ID。
TotalCount Integer 1

查询到的总数。

示例

请求示例

http(s)://ros.aliyuncs.com/?Action=ListChangeSets
&StackId=4a6c9851-3b0f-4f5f-b4ca-a14bf691****
&PageNumber=1
&PageSize=10
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式 

<ListChangeSetsResponse> 
    <ChangeSets> 
        <ChangeSet> 
            <ChangeSetId>1f6521a4-05af-4975-afe9-bc4b45ad****</ChangeSetId>  
            <ChangeSetName>MyChangeSet</ChangeSetName>  
            <ChangeSetType>UPDATE</ChangeSetType>  
            <Description>It is a demo.</Description>  
            <CreateTime>2019-08-01T05:16:31</CreateTime>  
            <Status>CREATE_COMPLETE</Status>  
            <ExecutionStatus>AVAILABLE</ExecutionStatus>  
            <StackId>4a6c9851-3b0f-4f5f-b4ca-a14bf691****</StackId>  
            <StackName>MyStack</StackName>  
            <RegionId>cn-hangzhou</RegionId> 
        </ChangeSet> 
    </ChangeSets>  
    <PageNumber>1</PageNumber>  
    <PageSize>10</PageSize>  
    <TotalCount>1</TotalCount>  
    <RequestId>B288A0BE-D927-4888-B0F7-B35EF84B6E6F</RequestId> 
</ListChangeSetsResponse>

JSON 格式 

{
  "ChangeSets": [
    {
      "ChangeSetId": "1f6521a4-05af-4975-afe9-bc4b45ad****",
      "ChangeSetName": "MyChangeSet",
      "ChangeSetType": "UPDATE",
      "Description": "It is a demo.",
      "CreateTime": "2019-08-01T05:16:31",
      "Status": "CREATE_COMPLETE",
      "ExecutionStatus": "AVAILABLE",
      "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****",
      "StackName": "MyStack",
      "RegionId": "cn-hangzhou"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1,
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F"
}

错误码

访问错误中心查看更多错误码。

HttpCode

错误码

错误信息

描述

404

StackNotFound

The Stack ({name}) could not be found.

资源栈不存在。name为资源栈名称或ID。