Interroger les tags des instances ApsaraDB RDS - - Centre de documentation Alibaba Cloud

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ListTagResources	Opération à effectuer. Définissez la valeur sur ListTagResources.
RegionId	String	Yes	cn-hangzhou	ID de la région. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
ResourceType	String	Yes	INSTANCE	Type de ressource. Définissez la valeur sur INSTANCE.
NextToken	String	No	212db86sca4384811e0b5e8707ec21345	Jeton requis pour obtenir davantage de résultats. Ce paramètre est inutile lors de la première requête. Si une requête ne renvoie pas tous les résultats, spécifiez le jeton renvoyé par la requête précédente dans la requête suivante pour obtenir la suite des résultats.
ResourceId.N	String	No	rm-uf6wjk5*******	ID de l'instance. Vous pouvez interroger les tags de N instances simultanément. Valeurs possibles pour N : 1 à 50. Remarque Vous devez spécifier au moins l'un des paramètres ResourceId.N et Tag.N.Key.
Tag.N.Key	String	No	testkey1	Clé du tag. Vous pouvez interroger N clés de tag simultanément. Valeurs possibles pour N : 1 à 20. La valeur de ce paramètre ne peut pas être une chaîne vide. Remarque Vous devez spécifier au moins l'un des paramètres ResourceId.N et Tag.N.Key.
Tag.N.Value	String	No	testvalue1	Valeur de tag associée à la clé de tag spécifiée. Vous pouvez spécifier N valeurs de tag simultanément. Valeurs possibles pour N : 1 à 20. Ce paramètre peut être une chaîne vide.

Paramètres de réponse

Parameter	Type	Example	Description
NextToken	String	212db86sca4384811e0b5e8707ec21345	Jeton requis pour obtenir davantage de résultats. Si une requête ne renvoie pas tous les résultats, fournissez le jeton renvoyé par la requête précédente dans la requête suivante pour obtenir la suite des résultats.
RequestId	String	47A514A1-4B77-4E30-B4C5-2A880650B3FD	ID de la requête.
TagResources	Array of TagResource		Informations relatives aux instances et aux tags renvoyés.
TagResource
TagValue	String	testvalue1	Valeur de tag associée à la clé de tag spécifiée.
ResourceType	String	ALIYUN::RDS::INSTANCE	Type de ressource. La valeur `ALIYUN::RDS::INSTANCE` indique les instances ApsaraDB RDS.
ResourceId	String	rm-uf6wjk5xxxxxxx	ID de l'instance.
TagKey	String	testkey1	Clé du tag.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceId.1=rm-uf6wjk5xxxxxxx
&Tag.1.Key=testkey1
&<Common request parameters>

Exemples de réponses réussies

Format XML

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

<ListTagResourcesResponse>
<TagResources>
    <TagResource>
        <ResourceType>ALIYUN::RDS::INSTANCE</ResourceType>
        <TagValue>testvalue1</TagValue>
        <ResourceId>rm-uf6wjk5xxxxxxx</ResourceId>
        <TagKey>testkey1</TagKey>
    </TagResource>
</TagResources>
<RequestId>47A514A1-4B77-4E30-B4C5-2A880650B3FD</RequestId>
</ListTagResourcesResponse>

Format JSON

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

{
  "TagResources" : {
    "TagResource" : [ {
      "ResourceType" : "ALIYUN::RDS::INSTANCE",
      "TagValue" : "testvalue1",
      "ResourceId" : "rm-uf6wjk5xxxxxxx",
      "TagKey" : "testkey1"
    } ]
  },
  "RequestId" : "47A514A1-4B77-4E30-B4C5-2A880650B3FD"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	BothEmpty.TagsAndResources	The specified Tags and ResourcesIds are not allow to both empty.	Les paramètres Tag.N.Key et ResourceId ne peuvent pas être tous deux vides.
400	InvalidParameter.ResourceType	The parameter ResourceType is invalid.	La valeur du paramètre ResourceType n'est pas valide.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.