調(diào)用GetResourceGroup查詢資源組信息。

使用說(shuō)明

本文將提供一個(gè)示例，查詢ID為rg-9gLOoK****的資源組信息。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。

請(qǐng)求參數(shù)

名稱(chēng) 類(lèi)型 是否必選 示例值 描述
Action String 是 GetResourceGroup

要執(zhí)行的操作。取值：GetResourceGroup。

ResourceGroupId String 是 rg-9gLOoK****

資源組ID。

您可以調(diào)用ListResourceGroups查詢資源組ID。

IncludeTags Boolean 否 true

是否返回標(biāo)簽信息。取值：

  • false（默認(rèn)值）：不返回。
  • true：返回。

關(guān)于公共請(qǐng)求參數(shù)的詳情，請(qǐng)參見(jiàn)公共參數(shù)。

返回?cái)?shù)據(jù)

名稱(chēng) 類(lèi)型 示例值 描述
RequestId String 2D69A58F-345C-4FDE-88E4-BF5189484043

請(qǐng)求ID。
ResourceGroup Object

資源組信息。
DisplayName String my-project

資源組顯示名稱(chēng)。
Status String OK

資源組狀態(tài)。

  • Creating：創(chuàng)建中。
  • OK：創(chuàng)建成功。
  • PendingDelete：等待刪除。
RegionStatuses Array of RegionStatus

各個(gè)地域的資源組狀態(tài)。
RegionStatus
Status String OK

資源組狀態(tài)。

  • Creating：創(chuàng)建中。
  • OK：創(chuàng)建成功。
  • PendingDelete：等待刪除。
  • Deleting：刪除中。
RegionId String cn-qingdao

地域ID。
AccountId String 123456789****

資源組所屬的阿里云賬號(hào)ID。
Name String my-project

資源組唯一標(biāo)識(shí)。
CreateDate String 2015-01-23T12:33:18Z

資源組創(chuàng)建時(shí)間（UTC時(shí)間）。
Id String rg-9gLOoK****

資源組ID。
Tags Array of Tag

標(biāo)簽列表。
Tag
TagKey String k1

標(biāo)簽鍵。
TagValue String v1

標(biāo)簽值。

示例

請(qǐng)求示例

https://resourcemanager.aliyuncs.com/?Action=GetResourceGroup
&ResourceGroupId=rg-9gLOoK****
&IncludeTags=true
&<公共請(qǐng)求參數(shù)>

正常返回示例

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"
      } ]
    }
  }
}

錯(cuò)誤碼

HttpCode 錯(cuò)誤碼 錯(cuò)誤信息 描述
400 InvalidParameter.ResourceGroupId The ResourceGroupId is invalid. 資源組ID無(wú)效。
403 NoPermission You are not authorized to perform the operation. 沒(méi)有權(quán)限進(jìn)行這個(gè)操作。
404 EntityNotExists.ResourceGroup The specified resource group does not exist. You must first create a resource group. 資源組不存在，請(qǐng)先創(chuàng)建資源組。

訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。