文档

GetResourceGroup - 查询资源组信息

更新时间:

调用GetResourceGroup查询资源组信息。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ResourceGroupIdstring

资源组 ID。

您可以调用 ListResourceGroups 查询资源组 ID。

rg-9gLOoK****
IncludeTagsboolean

是否返回标签信息。取值:

  • false(默认值):不返回。
  • true:返回。
true

返回参数

名称类型描述示例值
object

返回结果

RequestIdstring

请求 ID。

2D69A58F-345C-4FDE-88E4-BF5189484043
ResourceGroupobject

资源组信息。

DisplayNamestring

资源组显示名称。

my-project
Statusstring

资源组状态。取值:

  • Creating:创建中。
  • OK:创建成功。
  • PendingDelete:等待删除。
OK
RegionStatusesobject []

各个地域的资源组状态。

Statusstring

资源组状态。取值:

  • Creating:创建中。
  • OK:创建成功。
  • PendingDelete:等待删除。
  • Deleting:删除中。
OK
RegionIdstring

地域 ID。

cn-qingdao
AccountIdstring

资源组所属的阿里云账号 ID。

123456789****
Namestring

资源组唯一标识。

my-project
CreateDatestring

资源组创建时间(UTC 时间)。

2015-01-23T12:33:18Z
Idstring

资源组 ID。

rg-9gLOoK****
Tagsobject []

标签列表。

TagKeystring

标签键。

k1
TagValuestring

标签值。

v1

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400InvalidParameter.ResourceGroupIdThe ResourceGroupId is invalid.资源组ID无效。
403NoPermissionYou are not authorized to perform the operation.没有权限进行这个操作。
404EntityNotExists.ResourceGroupThe specified resource group does not exist. You must first create a resource group.资源组不存在,请先创建资源组。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史
  • 本页导读
文档反馈