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

调试

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

请求参数

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

系统规定参数。取值:ListChangeSets。

RegionId String cn-hangzhou

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

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

资源栈ID。

ChangeSetName.N RepeatList MyChangeSet

更改集的名称。N的最大值为5。支持使用通配符*进行模糊搜索。

Status.N RepeatList CREATE_COMPLETE

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

  • CREATE_PENDING
  • CREATE_IN_PROGRESS
  • CREATE_COMPLETE
  • CREATE_FAILED
  • DELETE_FAILED
  • DELETE_COMPLETE
ExecutionStatus.N RepeatList AVAILABLE

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

  • UNAVAILABLE
  • AVAILABLE
  • EXECUTE_IN_PROGRESS
  • EXECUTE_COMPLETE
  • EXECUTE_FAILED
  • OBSOLETE
PageNumber Long 1

更改集列表的页码。起始值:1。默认值:1。

PageSize Long 10

分页查询时设置的每页行数。取值:1~50。默认值:10。

ChangeSetId String 1f6521a4-05af-4975-afe9-bc4b45ad****

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

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

分页查询的页码。

PageSize Integer 10

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

RequestId String B288A0BE-D927-4888-B0F7-B35EF84B6E6F

请求ID。

TotalCount Integer 1

查询到的总数。

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

更改集状态。

示例

请求示例

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。