GetResourceGroup - - Centro de documentación de Alibaba Cloud

Llame a la API GetResourceGroup para consultar información de un resource group.

Descripción

Este tema proporciona un ejemplo para consultar la información del resource group con ID rg-9gLOoK****.

Depuración

Puede ejecutar esta API directamente en OpenAPI Explorer sin necesidad de calcular la firma manualmente. Tras una ejecución exitosa, OpenAPI Explorer genera automáticamente ejemplos de código SDK.

Parámetros de solicitud

Nombre	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	GetResourceGroup	Operación que se va a ejecutar. Valor: GetResourceGroup.
ResourceGroupId	String	Sí	rg-9gLOoK****	ID del resource group. Llame a la API ListResourceGroups para consultar el ID del resource group.
IncludeTags	Boolean	No	true	Indica si se devuelve la información de etiquetas. Valores válidos: false (valor predeterminado): no se devuelve. true: se devuelve.

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Datos de respuesta

Nombre	Tipo	Ejemplo	Descripción
RequestId	String	2D69A58F-345C-4FDE-88E4-BF5189484043	ID de la solicitud.
ResourceGroup	Object		Información del resource group.
DisplayName	String	my-project	Nombre para mostrar del resource group.
Status	String	OK	Estado del resource group. Creating: se está Creating. OK: creado correctamente. PendingDelete: pendiente de eliminación.
RegionStatuses	Array of RegionStatus		Estado del resource group en cada región.
RegionStatus
Status	String	OK	Estado del resource group. Creating: se está Creating. OK: creado correctamente. PendingDelete: pendiente de eliminación. Deleting: se está Deleting.
RegionId	String	cn-qingdao	ID de la región.
AccountId	String	123456789****	ID de la cuenta de Alibaba Cloud a la que pertenece el resource group.
Name	String	my-project	Identificador único del resource group.
CreateDate	String	2015-01-23T12:33:18Z	Hora de creación del resource group (hora UTC).
Id	String	rg-9gLOoK****	ID del resource group.
Tags	Array of Tag		Lista de etiquetas.
Tag
TagKey	String	k1	Clave de la etiqueta.
TagValue	String	v1	Valor de la etiqueta.

Ejemplos

Ejemplo de solicitud

https://resourcemanager.aliyuncs.com/?Action=GetResourceGroup
&ResourceGroupId=rg-9gLOoK****
&IncludeTags=true
&<公共请求参数>

Ejemplo de respuesta correcta

Formato 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>

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

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	InvalidParameter.ResourceGroupId	The ResourceGroupId is invalid.	El ID del resource group no es válido.
403	NoPermission	You are not authorized to perform the operation.	No tiene permisos para realizar esta operación.
404	EntityNotExists.ResourceGroup	The specified resource group does not exist. You must first create a resource group.	El resource group especificado no existe. Cree primero un resource group.

Visite el Centro de errores para consultar más códigos de error.