使用ListChangeSets查詢更改集列表-Resource Orchestration Service-阿里雲 - Resource Orchestration Service

查詢已建立的變更集列表詳情。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ros:ListChangeSets

get

*stack

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

無

請求文法

POST /V2/ListChangeSets HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
StackId	string	是	資源堆疊 ID。	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
PageSize	integer	否	分頁查詢時設定的每頁行數。必須為整數。取值範圍：1~50。預設值：10。	10
RegionId	string	是	變更集所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。	cn-hangzhou
PageNumber	integer	否	變更集列表的頁碼。起始值：1。預設值：1。	1
ChangeSetId	string	否	變更集 ID。如果不需要變更集詳細資訊，可使用此參數代替 GetChangeSet 介面。	1f6521a4-05af-4975-afe9-bc4b45ad****
Status	array	否	變更集的狀態。N 的最大值為 5。取值： CREATE_PENDING CREATE_IN_PROGRESS CREATE_COMPLETE CREATE_FAILED DELETE_FAILED DELETE_COMPLETE	CREATE_COMPLETE
	string	否	變更集的狀態。	CREATE_COMPLETE
ChangeSetName	array	否	變更集的名稱。N 的最大值為 5。支援使用萬用字元星號（*）進行模糊搜尋。	MyChangeSet
	string	否	變更集的名稱。	MyChangeSet
ExecutionStatus	array	否	變更集的執行狀態。N 的最大值為 5。取值： UNAVAILABLE AVAILABLE EXECUTE_IN_PROGRESS EXECUTE_COMPLETE EXECUTE_FAILED OBSOLETE	AVAILABLE
	string	否	變更集的執行狀態。	AVAILABLE

返回參數

名稱	類型	描述	樣本值
	object	返回參數。
TotalCount	integer	查詢到的總數。	1
PageSize	integer	分頁查詢時設定的每頁行數。	10
RequestId	string	請求 ID。	B288A0BE-D927-4888-B0F7-B35EF84B6E6F
PageNumber	integer	分頁查詢的頁碼。整數，最小值為 1。	1
ChangeSets	array<object>	變更集列表。
	array<object>
Status	string	變更集狀態。	CREATE_COMPLETE
StackId	string	變更集所屬資源堆疊 ID。	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
ChangeSetName	string	變更集名稱。	MyChangeSet
Description	string	變更集描述。	It is a demo.
ChangeSetType	string	變更集類型。可能的值包括：CREATE, UPDATE, DELETE。	UPDATE
StatusReason	string	變更集異常狀態原因。	too many changes
CreateTime	string	建立時間。按照 ISO8601 標準表示，使用 UTC+0 時間，但缺少 Z 結尾，格式：YYYY-MM-DDThh:mm:ss。	2019-08-01T05:16:31
ChangeSetId	string	變更集 ID。	1f6521a4-05af-4975-afe9-bc4b45ad****
StackName	string	變更集所屬資源堆疊名稱。	MyStack
ExecutionStatus	string	變更集執行狀態。	AVAILABLE
RegionId	string	地區 ID。	cn-hangzhou
ResourceGroupId	string	資源群組 ID。關於資源群組的更多資訊，請參見什麼是資源群組。	rg-acfmxazb4ph6aiy****
Tags	array<object>	變更集的標籤。
	object	變更集的標籤。
Key	string	標籤鍵。	usage
Value	string	標籤值。	test

樣本

正常返回樣本

JSON格式

{
  "TotalCount": 1,
  "PageSize": 10,
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
  "PageNumber": 1,
  "ChangeSets": [
    {
      "Status": "CREATE_COMPLETE",
      "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****",
      "ChangeSetName": "MyChangeSet",
      "Description": "It is a demo.",
      "ChangeSetType": "UPDATE",
      "StatusReason": "too many changes",
      "CreateTime": "2019-08-01T05:16:31",
      "ChangeSetId": "1f6521a4-05af-4975-afe9-bc4b45ad****",
      "StackName": "MyStack",
      "ExecutionStatus": "AVAILABLE",
      "RegionId": "cn-hangzhou",
      "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
      "Tags": [
        {
          "Key": "usage",
          "Value": "test"
        }
      ]
    }
  ]
}

錯誤碼

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

變更歷史

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