调用GetChangeSet接口查询更改集信息。

本文将提供一个示例,为您查询杭州地域ID为4c11658d-bd47-4dd0-ba64-727edc62****的更改集信息。

调试

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

请求参数

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

要执行的操作,取值:GetChangeSet。

ShowTemplate Boolean false

是否获取模板,取值:

  • true:获取模板。
  • 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命令名称。取值:

  • apply
  • plan
  • destroy
  • version

关于命令含义的更多信息,请参见Command

Stream String stdout

输出流。取值:

  • stdout:标准输出。
  • stderr:标准错误。
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。