调用GetChangeSet接口查询更改集信息。
本文将提供一个示例,为您查询杭州地域ID为4c11658d-bd47-4dd0-ba64-727edc62****
的更改集信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetChangeSet |
要执行的操作,取值:GetChangeSet。 |
ShowTemplate | Boolean | 否 | false |
是否获取模板,取值:
|
RegionId | String | 是 | cn-hangzhou |
更改集所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
ChangeSetId | String | 是 | 4c11658d-bd47-4dd0-ba64-727edc62**** |
更改集ID。 |
关于公共请求参数的详情,请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Status | String | CREATE_COMPLETE |
更改集状态。 |
Changes | Array of Object | 参见示例 |
更改集变更内容列表。 更多信息,请参见更改集数据结构。 |
Description | String | It is a demo. |
更改集描述。 |
Parameters | Array of Parameter |
资源栈参数列表。 |
|
ParameterKey | String | ALIYUN::Region |
参数名称。 |
ParameterValue | String | cn-hangzhou |
参数值。 |
RequestId | String | 3766EE04-76DD-50F9-9C23-3AF136CD5708 |
请求ID。 |
StatusReason | String | too many changes. |
更改集异常状态原因。 |
CreateTime | String | 2021-12-01T02:20:56 |
创建时间,按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mm:ss。 |
TemplateBody | String | {"ROSTemplateFormatVersion": "2015-09-01"} |
更改集对应的模板。 说明 当ShowTemplate为true时该参数有效。
|
ChangeSetName | String | ChangeSet_template |
更改集名称。 |
ChangeSetId | String | 4c11658d-bd47-4dd0-ba64-727edc62**** |
更改集ID。 |
ExecutionStatus | String | AVAILABLE |
更改集执行状态。 |
ChangeSetType | String | UPDATE |
更改集类型。 |
RegionId | String | cn-hangzhou |
地域ID。 |
DisableRollback | Boolean | false |
资源栈在创建或更新失败时是否回滚。 |
StackName | String | stack_2021-10-13 |
更改集所属资源栈名。 |
TimeoutInMinutes | Integer | 60 |
资源栈创建或更新超时时间。 |
StackId | String | a486fc19-ebb7-4ce9-a70b-554a7c3d**** |
更改集所属资源栈ID。 |
Log | Object |
更改集相关输出日志。 |
|
TerraformLogs | Array of TerraformLog |
Terraform输出日志。仅Terraform类型资源栈的更改集返回该参数。 说明 创建中的更改集不返回该参数。该参数表示创建更改集的日志。
|
|
Command | String | apply |
执行的Terraform命令名称。取值:
关于命令含义的更多信息,请参见Command。 |
Stream | String | stdout |
输出流。取值:
|
Content | String | Apply complete! Resources: 42 added, 0 changed, 0 destroyed. |
当前命令在当前输出流中输出的内容。 |
示例
请求示例
http(s)://ros.aliyuncs.com/?Action=GetChangeSet
&ShowTemplate=false
&RegionId=cn-hangzhou
&ChangeSetId=4c11658d-bd47-4dd0-ba64-727edc62****
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<GetChangeSetResponse>
<Status>CREATE_COMPLETE</Status>
<Changes>
<Type>Resource</Type>
<ResourceChange>
<Action>Remove</Action>
<LogicalResourceId>WaitCondition</LogicalResourceId>
<PhysicalResourceId>WaitCondition</PhysicalResourceId>
<ResourceType>ALIYUN::ROS::WaitCondition</ResourceType>
</ResourceChange>
</Changes>
<Changes>
<Type>Resource</Type>
<ResourceChange>
<Action>Remove</Action>
<LogicalResourceId>WaitConHandle</LogicalResourceId>
<PhysicalResourceId>WaitConHandle</PhysicalResourceId>
<ResourceType>ALIYUN::ROS::WaitConditionHandle</ResourceType>
</ResourceChange>
</Changes>
<Parameters>
<ParameterValue>151266687691****</ParameterValue>
<ParameterKey>ALIYUN::AccountId</ParameterKey>
</Parameters>
<Parameters>
<ParameterValue>None</ParameterValue>
<ParameterKey>ALIYUN::NoValue</ParameterKey>
</Parameters>
<Parameters>
<ParameterValue>cn-hangzhou</ParameterValue>
<ParameterKey>ALIYUN::Region</ParameterKey>
</Parameters>
<Parameters>
<ParameterValue>a486fc19-ebb7-4ce9-a70b-554a7c3d****</ParameterValue>
<ParameterKey>ALIYUN::StackId</ParameterKey>
</Parameters>
<Parameters>
<ParameterValue>stack_2021-10-13</ParameterValue>
<ParameterKey>ALIYUN::StackName</ParameterKey>
</Parameters>
<Parameters>
<ParameterValue>151266687691****</ParameterValue>
<ParameterKey>ALIYUN::TenantId</ParameterKey>
</Parameters>
<RequestId>3766EE04-76DD-50F9-9C23-3AF136CD5708</RequestId>
<CreateTime>2021-12-01T02:20:56</CreateTime>
<ChangeSetName>ChangeSet_template</ChangeSetName>
<ChangeSetId>4c11658d-bd47-4dd0-ba64-727edc62****</ChangeSetId>
<ExecutionStatus>AVAILABLE</ExecutionStatus>
<ChangeSetType>UPDATE</ChangeSetType>
<RegionId>cn-hangzhou</RegionId>
<DisableRollback>false</DisableRollback>
<StackName>stack_2021-10-13</StackName>
<TimeoutInMinutes>60</TimeoutInMinutes>
<StackId>a486fc19-ebb7-4ce9-a70b-554a7c3d****</StackId>
</GetChangeSetResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Status" : "CREATE_COMPLETE",
"Changes" : [ {
"Type" : "Resource",
"ResourceChange" : {
"Action" : "Remove",
"LogicalResourceId" : "WaitCondition",
"Details" : [ ],
"Scope" : [ ],
"PhysicalResourceId" : "WaitCondition",
"ResourceType" : "ALIYUN::ROS::WaitCondition"
}
}, {
"Type" : "Resource",
"ResourceChange" : {
"Action" : "Remove",
"LogicalResourceId" : "WaitConHandle",
"Details" : [ ],
"Scope" : [ ],
"PhysicalResourceId" : "WaitConHandle",
"ResourceType" : "ALIYUN::ROS::WaitConditionHandle"
}
} ],
"Parameters" : [ {
"ParameterValue" : "151266687691****",
"ParameterKey" : "ALIYUN::AccountId"
}, {
"ParameterValue" : "None",
"ParameterKey" : "ALIYUN::NoValue"
}, {
"ParameterValue" : "cn-hangzhou",
"ParameterKey" : "ALIYUN::Region"
}, {
"ParameterValue" : "a486fc19-ebb7-4ce9-a70b-554a7c3d****",
"ParameterKey" : "ALIYUN::StackId"
}, {
"ParameterValue" : "stack_2021-10-13",
"ParameterKey" : "ALIYUN::StackName"
}, {
"ParameterValue" : "151266687691****",
"ParameterKey" : "ALIYUN::TenantId"
} ],
"RequestId" : "3766EE04-76DD-50F9-9C23-3AF136CD5708",
"CreateTime" : "2021-12-01T02:20:56",
"ChangeSetName" : "ChangeSet_template",
"ChangeSetId" : "4c11658d-bd47-4dd0-ba64-727edc62****",
"ExecutionStatus" : "AVAILABLE",
"ChangeSetType" : "UPDATE",
"RegionId" : "cn-hangzhou",
"DisableRollback" : false,
"StackName" : "stack_2021-10-13",
"TimeoutInMinutes" : 60,
"StackId" : "a486fc19-ebb7-4ce9-a70b-554a7c3d****"
}
错误码
访问错误中心查看更多错误码。
错误代码 |
错误信息 |
HTTP状态码 |
描述 |
---|---|---|---|
ChangeSetNotFound |
The ChangeSet ({name}) of Stack ({stack}) could not be found. |
404 |
更改集不存在,name为更改集名称或ID,stack为资源栈名称或ID。 |
ChangeSetNotFound |
The ChangeSet {ID} could not be found. |
404 |
更改集不存在,ID为更改集ID。 |
StackNotFound |
The Stack ({name}) could not be found. |
404 |
资源栈不存在,name为资源栈名称或ID。 |