You can call this operation to query the list of change sets.
Debugging
Request parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| Action | String | Yes | ListChangeSets |
The operation that you want to perform. Set the value to ListChangeSets. |
| RegionId | String | Yes | cn-hangzhou |
The region ID of the change set. You can call the DescribeRegions operation to query the most recent region list. |
| StackId | String | Yes | 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** |
The ID of the stack. |
| Status.N | RepeatList | No | CREATE_COMPLETE |
The status of change set N. Maximum value of N: 5. Valid values:
|
| ChangeSetName.N | RepeatList | No | MyChangeSet |
The name of change set N. Maximum value of N: 5. Fuzzy search with an asterisk (*) is supported. |
| PageSize | Long | No | 10 |
The number of entries to return on each page. Valid values: 1 to 50. Default value: 10. |
| PageNumber | Long | No | 1 |
The number of the page to return. Pages start from page 1. Default value: 1. |
| ExecutionStatus.N | RepeatList | No | AVAILABLE |
The execution status of change set N. Maximum value of N: 5. Valid values:
|
| ChangeSetId | String | No | 1f6521a4-05af-4975-afe9-bc4b45ad**** |
The ID of the change set. If detailed information about the change set is not required, you can use this parameter to replace the GetChangeSet operation. |
Response parameters
| Parameter | Type | Example | Description |
|---|---|---|---|
| ChangeSets | Array |
The list of change sets. |
|
| ChangeSetId | String | 1f6521a4-05af-4975-afe9-bc4b45ad**** |
The ID of the change set. |
| ChangeSetName | String | MyChangeSet |
The name of the change set. |
| ChangeSetType | String | UPDATE |
The type of the change set. |
| CreateTime | String | 2019-08-01T05:16:31 |
The time when the change set was created. The time follows the ISO 8601 standard in the YYYY-MM-DDThh:mm:ssZ format. The time is displayed in UTC. |
| Description | String | It is a demo. |
The description of the change set. |
| ExecutionStatus | String | AVAILABLE |
The execution status of the change set. |
| RegionId | String | cn-hangzhou |
The region ID. |
| StackId | String | 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** |
The ID of the stack with which the change set is associated. |
| StackName | String | MyStack |
The name of the stack with which the change set is associated. |
| Status | String | CREATE_COMPLETE |
The status of the change set. |
| StatusReason | String | too many changes |
The reason why the change set is in its current status. |
| PageNumber | Integer | 1 |
The page number of the returned page. |
| PageSize | Integer | 10 |
The number of entries returned per page. |
| RequestId | String | B288A0BE-D927-4888-B0F7-B35EF84B6E6F |
The ID of the request. |
| TotalCount | Integer | 1 |
The total number of queried entries. |
Examples
Sample requests
http(s)://ros.aliyuncs.com/? Action=ListChangeSets
&StackId=4a6c9851-3b0f-4f5f-b4ca-a14bf691****
&PageNumber=1
&PageSize=10
&RegionId=cn-hangzhou
&<Common request parameters>Sample success responses
XML format
<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 format
{
"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"
}Error codes
For a list of error codes, visit the API Error Center.
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
|
404 |
StackNotFound |
The Stack ({name}) could not be found. |
The error message returned because the specified stack does not exist. name indicates the name or ID of the stack. |