ListTagResources - - Centre de documentation Alibaba Cloud

Interroge les tags ajoutés à une ou plusieurs ressources Global Accelerator (GA).

Notes d'utilisation

Spécifiez ResourceId.N ou Tag.N (composé de Tag.N.Key et Tag.N.Value) dans la requête pour désigner l'objet à interroger.
Tag.N représente un tag de ressource sous forme de paire clé-valeur. Si vous indiquez uniquement Tag.N.Key, toutes les valeurs de tag associées à cette clé sont renvoyées. En revanche, si vous ne spécifiez que Tag.N.Value, un message d'erreur s'affiche.
Lorsque vous utilisez conjointement Tag.N et ResourceId.N pour filtrer les tags, les identifiants ResourceId.N doivent correspondre à toutes les paires clé-valeur spécifiées.
Si plusieurs paires clé-valeur sont indiquées, seules les ressources contenant l'intégralité de ces paires sont retournées.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. Celui-ci génère dynamiquement l'exemple de code de l'opération 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 où l'instance GA est déployée. Définissez la valeur sur cn-hangzhou.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	Jeton client utilisé pour garantir l'idempotence de la requête. Générez cette valeur via le client, mais assurez-vous qu'elle reste unique pour chaque requête. Le jeton ne doit contenir que des caractères ASCII. Remarque Si ce paramètre n'est pas défini, le système attribue à ClientToken la valeur de RequestId. La valeur de RequestId peut varier selon les appels API.
NextToken	String	No	FFmyTO70tTpLG6I3FmYAXGKPd****	Jeton utilisé pour la requête suivante. Valeurs valides : S'il s'agit de votre première et unique requête, ignorez ce paramètre. Pour effectuer une requête suivante, définissez la valeur sur le NextToken renvoyé lors du dernier appel à l'opération ListTagResources.
ResourceType	String	Yes	accelerator	Type de ressource dont vous souhaitez interroger les informations de tag. Valeurs valides : accelerator : instance GA standard. basicaccelerator : instance GA basique. bandwidthpackage : plan de bande passante. acl : liste de contrôle d'accès (ACL).
ResourceId.N	String	No	ga-bp149u6o36qt1as9b****	ID de la ressource dont vous souhaitez interroger les informations de tag. Si ResourceType est défini sur accelerator, définissez ResourceId sur l'ID d'une instance GA standard. Si ResourceType est défini sur basicaccelerator, définissez ResourceId sur l'ID d'une instance GA basique. Si ResourceType est défini sur bandwidthpackage, définissez ResourceId sur l'ID d'un plan de bande passante. Si ResourceType est défini sur acl, définissez ResourceId sur l'ID d'une ACL. Saisissez jusqu'à 50 ID de ressource.
Tag.N.Key	String	No	KeyTest	Clé de tag de la ressource. Elle ne peut pas être vide. Longueur maximale de 64 caractères ; elle ne doit pas contenir `http://` ni `https://`. Elle ne peut pas commencer par `aliyun` ou `acs:`. Spécifiez jusqu'à 20 clés de tag.
Tag.N.Value	String	No	valueTest	Valeur de tag de la ressource. Elle peut être vide. Longueur maximale de 128 caractères ; elle ne peut pas commencer par `acs:` ou `aliyun`. Elle ne doit pas contenir `http://` ni `https://`. Spécifiez jusqu'à 20 valeurs de tag.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	ID de la requête.
TotalCount	Integer	1	Nombre d'entrées renvoyées.
NextToken	String	FFmyTO70tTpLG6I3FmYAXGKPd****	Jeton utilisé pour la requête suivante. Valeurs valides : Si NextToken n'est pas renvoyé, cela signifie qu'il n'y a pas de résultats supplémentaires. Si NextToken est renvoyé, sa valeur constitue le jeton à utiliser pour la requête suivante.
TagResources	Array of TagResource		Informations relatives aux ressources auxquelles des tags sont ajoutés.
TagResource
ResourceType	String	accelerator	Type de ressource. accelerator : instance GA standard. basicaccelerator : instance GA basique. bandwidthpackage : plan de bande passante. acl : ACL.
TagValue	String	KeyTest	Valeur du tag.
ResourceId	String	ga-bp149u6o36qt1as9b****	ID de la ressource.
TagKey	String	valueTest	Clé du tag.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=ListTagResources
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&ResourceType=accelerator
&ResourceId=["ga-bp149u6o36qt1as9b****"]
&Tag=[{"Key":"KeyTest","Value":"valueTest"}]
&Common request parameters

Exemples de réponses réussies

XML format

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

<ListTagResourcesResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <TotalCount>1</TotalCount>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <TagResources>
        <ResourceType>accelerator</ResourceType>
        <TagValue>KeyTest</TagValue>
        <ResourceId>ga-bp149u6o36qt1as9b****</ResourceId>
        <TagKey>valueTest</TagKey>
    </TagResources>
</ListTagResourcesResponse>

JSON format

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

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "TotalCount" : 1,
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "TagResources" : [ {
    "ResourceType" : "accelerator",
    "TagValue" : "KeyTest",
    "ResourceId" : "ga-bp149u6o36qt1as9b****",
    "TagKey" : "valueTest"
  } ]
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.