GetChangeSet - 查詢更改集資訊 - Resource Orchestration Service

查詢指定更改集資訊，可以選擇是否擷取對應模板詳情。

介面說明

本文將提供一個樣本，為您查詢杭州地區 ID 為4c11658d-bd47-4dd0-ba64-727edc62****的更改集資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ros:GetChangeSet

get

*stack

acs:ros:{#regionId}:{#accountId}:stack/{#stackId}

無

請求參數

名稱	類型	必填	描述	樣本值
ShowTemplate	boolean	否	是否擷取模板，取值： true：擷取模板。 false（預設值）：不擷取模板。	false
RegionId	string	是	更改集所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。	cn-hangzhou
ChangeSetId	string	是	更改集 ID。	4c11658d-bd47-4dd0-ba64-727edc62****

關於公用請求參數的詳情，請參見公用參數。

返回參數

名稱	類型	描述	樣本值
	object	返回參數。
Status	string	更改集狀態。	CREATE_COMPLETE
Changes	array<object>	更改集變更內容列表。
	object	更改集變更內容列表。更多資訊，請參見更改集資料結構。	參見樣本
Description	string	更改集描述。	It is a demo.
Parameters	array<object>	資源棧參數列表。
	object	資源棧參數列表。
ParameterKey	string	參數名稱。	ALIYUN::Region
ParameterValue	string	參數值。	cn-hangzhou
RequestId	string	請求 ID。	3766EE04-76DD-50F9-9C23-3AF136CD5708
StatusReason	string	更改集異常狀態原因。	too many changes.
CreateTime	string	建立時間，按照 ISO8601 標準表示，並需要使用 UTC 時間。格式為：YYYY-MM-DDThh:mm:ss。	2021-12-01T02:20:56
TemplateBody	string	更改集對應的模板。說明當 ShowTemplate 為 true 時該參數有效。	{"ROSTemplateFormatVersion": "2015-09-01"}
ChangeSetName	string	更改集名稱。	ChangeSet_template
ChangeSetId	string	更改集 ID。	4c11658d-bd47-4dd0-ba64-727edc62****
ExecutionStatus	string	更改集執行狀態。	AVAILABLE
ChangeSetType	string	更改集類型。	UPDATE
RegionId	string	地區 ID。	cn-hangzhou
DisableRollback	boolean	資源棧在建立或更新失敗時是否復原。	false
StackName	string	更改集所屬資源棧名。	stack_2021-10-13
TimeoutInMinutes	integer	資源棧建立或更新逾時時間。	60
StackId	string	更改集所屬資源棧 ID。	a486fc19-ebb7-4ce9-a70b-554a7c3d****
Log	object	更改集相關輸出日誌。
TerraformLogs	array<object>	Terraform 輸出日誌。僅 Terraform 類型資源棧的更改集返回該參數。說明建立中的更改集不返回該參數。該參數表示建立更改集的日誌。
	object	輸出日誌。
Command	string	執行的 Terraform 命令名稱。取值： apply plan destroy version 關於命令含義的更多資訊，請參見 Command 。	apply
Stream	string	輸出資料流。取值： stdout：標準輸出。 stderr：標準錯誤。	stdout
Content	string	當前命令在當前輸出資料流中輸出的內容。	Apply complete! Resources: 42 added, 0 changed, 0 destroyed.
Tags	array<object>	更改集的標籤。
	object	更改集的標籤。
Key	string	標籤鍵。	usage
Value	string	標籤值。	test
ResourceGroupId	string	資源群組 ID。關於資源群組的更多資訊，請參見什麼是資源群組。	rg-acfmxazb4ph6aiy****

樣本

正常返回樣本

JSON格式

{
  "Status": "CREATE_COMPLETE",
  "Changes": [
    {
      "test": "test",
      "test2": 1
    }
  ],
  "Description": "It is a demo.",
  "Parameters": [
    {
      "ParameterKey": "ALIYUN::Region",
      "ParameterValue": "cn-hangzhou"
    }
  ],
  "RequestId": "3766EE04-76DD-50F9-9C23-3AF136CD5708",
  "StatusReason": "too many changes.",
  "CreateTime": "2021-12-01T02:20:56",
  "TemplateBody": "{\"ROSTemplateFormatVersion\": \"2015-09-01\"}",
  "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****",
  "Log": {
    "TerraformLogs": [
      {
        "Command": "apply",
        "Stream": "stdout",
        "Content": "Apply complete! Resources: 42 added, 0 changed, 0 destroyed."
      }
    ]
  },
  "Tags": [
    {
      "Key": "usage",
      "Value": "test"
    }
  ],
  "ResourceGroupId": "rg-acfmxazb4ph6aiy****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。