GetResourceGroup - - Centre de documentation Alibaba Cloud

Présentation

Cette rubrique présente un exemple permettant d'interroger les informations du groupe de ressources dont l'ID est rg-9gLOoK****.

Débogage

Exécutez directement cette API dans OpenAPI Explorer pour éviter de calculer manuellement la signature. Une fois l'exécution réussie, OpenAPI Explorer génère automatiquement des exemples de code SDK.

Paramètres de requête

Nom	Type	Obligatoire	Exemple	Description
Action	String	Oui	GetResourceGroup	Opération à effectuer. Valeur : GetResourceGroup.
ResourceGroupId	String	Oui	rg-9gLOoK****	ID du groupe de ressources. Appelez l'API ListResourceGroups pour obtenir l'ID du groupe de ressources.
IncludeTags	Boolean	Non	true	Indique si les tags doivent être renvoyés. Valeurs : false (par défaut) : ne pas renvoyer les tags. true : renvoyer les tags.

Pour plus d'informations sur les paramètres de requête communs, consultez la page Paramètres communs.

Données de réponse

Nom	Type	Exemple	Description
RequestId	String	2D69A58F-345C-4FDE-88E4-BF5189484043	ID de la requête.
ResourceGroup	Object		Informations sur le groupe de ressources.
DisplayName	String	my-project	Nom d'affichage du groupe de ressources.
Status	String	OK	État du groupe de ressources. Creating : création en cours. OK : créé. PendingDelete : suppression en attente.
RegionStatuses	Array of RegionStatus		État du groupe de ressources par région.
RegionStatus
Status	String	OK	État du groupe de ressources. Creating : création en cours. OK : créé. PendingDelete : suppression en attente. Deleting : suppression en cours.
RegionId	String	cn-qingdao	ID de la région.
AccountId	String	123456789****	ID du compte Alibaba Cloud propriétaire du groupe de ressources.
Name	String	my-project	Identifiant unique du groupe de ressources.
CreateDate	String	2015-01-23T12:33:18Z	Date de création du groupe de ressources (heure UTC).
Id	String	rg-9gLOoK****	ID du groupe de ressources.
Tags	Array of Tag		Liste des tags.
Tag
TagKey	String	k1	Clé du tag.
TagValue	String	v1	Valeur du tag.

Exemples

Exemple de requête

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

Exemple de réponse normale

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

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

Codes d'erreur

HttpCode	Code d'erreur	Message d'erreur	Description
400	InvalidParameter.ResourceGroupId	The ResourceGroupId is invalid.	L'ID du groupe de ressources n'est pas valide.
403	NoPermission	You are not authorized to perform the operation.	Vous n'êtes pas autorisé à effectuer cette opération.
404	EntityNotExists.ResourceGroup	The specified resource group does not exist. You must first create a resource group.	Le groupe de ressources spécifié n'existe pas. Créez d'abord un groupe de ressources.

Consultez le Centre d'erreurs pour afficher davantage de codes d'erreur.