GetResourceGroup -

使用說明

本文將提供一個樣本，查詢ID為rg-9gLOoK****的資源群組資訊。

調試

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

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	GetResourceGroup	要執行的操作。取值：GetResourceGroup。
ResourceGroupId	String	是	rg-9gLOoK****	資源群組ID。您可以調用ListResourceGroups查詢資源群組ID。
IncludeTags	Boolean	否	true	是否返回標籤資訊。取值： false（預設值）：不返回。 true：返回。

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

返回資料

名稱	類型	樣本值	描述
RequestId	String	2D69A58F-345C-4FDE-88E4-BF5189484043	請求ID。
ResourceGroup	Object		資源群組資訊。
DisplayName	String	my-project	資源群組顯示名稱。
Status	String	OK	資源群組狀態。 Creating：建立中。 OK：建立成功。 PendingDelete：等待刪除。
RegionStatuses	Array of RegionStatus		各個地區的資源群組狀態。
RegionStatus
Status	String	OK	資源群組狀態。 Creating：建立中。 OK：建立成功。 PendingDelete：等待刪除。 Deleting：刪除中。
RegionId	String	cn-qingdao	地區ID。
AccountId	String	123456789****	資源群組所屬的阿里雲帳號ID。
Name	String	my-project	資源群組唯一標識。
CreateDate	String	2015-01-23T12:33:18Z	資源群組建立時間（UTC時間）。
Id	String	rg-9gLOoK****	資源群組ID。
Tags	Array of Tag		標籤列表。
Tag
TagKey	String	k1	標籤鍵。
TagValue	String	v1	標籤值。

樣本

請求樣本

https://resourcemanager.aliyuncs.com/?Action=GetResourceGroup
&ResourceGroupId=rg-9gLOoK****
&IncludeTags=true
&<公用請求參數>

正常返回樣本

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<GetResourceGroupResponse>
    <RequestId>2D69A58F-345C-4FDE-88E4-BF5189484043</RequestId>
    <ResourceGroup>
        <Id>rg-9gLOoK****</Id>
        <AccountId>123456789****</AccountId>
        <Name>my-project</Name>
        <DisplayName>my-project</DisplayName>
        <Status>OK</Status>
        <RegionStatuses>
            <RegionStatus>
                <RegionId>cn-hangzhou</RegionId>
                <Status>OK</Status>
            </RegionStatus>
            <RegionStatus>
                <RegionId>cn-qingdao</RegionId>
                <Status>OK</Status>
            </RegionStatus>
        </RegionStatuses>
        <CreateDate>2015-01-23T12:33:18Z</CreateDate>
        <Tags>
            <Tag>
                <TagKey>k1</TagKey>
                <TagValue>v1</TagValue>
            </Tag>
        </Tags>
    </ResourceGroup>
</GetResourceGroupResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "2D69A58F-345C-4FDE-88E4-BF5189484043",
  "ResourceGroup" : {
    "Id" : "rg-9gLOoK****",
    "AccountId" : "123456789****",
    "Name" : "my-project",
    "DisplayName" : "my-project",
    "Status" : "OK",
    "RegionStatuses" : {
      "RegionStatus" : [ {
        "RegionId" : "cn-hangzhou",
        "Status" : "OK"
      }, {
        "RegionId" : "cn-qingdao",
        "Status" : "OK"
      } ]
    },
    "CreateDate" : "2015-01-23T12:33:18Z",
    "Tags" : {
      "Tag" : [ {
        "TagKey" : "k1",
        "TagValue" : "v1"
      } ]
    }
  }
}

錯誤碼

HttpCode	錯誤碼	錯誤資訊	描述
400	InvalidParameter.ResourceGroupId	The ResourceGroupId is invalid.	資源群組ID無效。
403	NoPermission	You are not authorized to perform the operation.	沒有許可權進行這個操作。
404	EntityNotExists.ResourceGroup	The specified resource group does not exist. You must first create a resource group.	資源群組不存在，請先建立資源群組。

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