ListTagResources - - Centre de documentation Alibaba Cloud

Description

Pour cibler la requête, spécifiez le paramètre ResourceId.N ou Tag.N. Le paramètre Tag.N se compose de Tag.N.Key et Tag.N.Value.
Si vous indiquez les paramètres Tag.N et ResourceId.N, le système renvoie uniquement les ressources ROS qui correspondent aux deux critères.

Cette rubrique illustre la liste des tags d'une ressource au sein d'une stack. L'ID de ressource utilisé dans l'exemple est 6bc589b5-9c02-4944-8fc3-f3624234****. La stack est déployée dans la région Chine (Hangzhou).

Débogage

OpenAPI Explorer calcule automatiquement la signature. Nous vous recommandons d'utiliser cet outil pour appeler l'opération. Il génère également des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ListTagResources	Nom de l'opération à effectuer. Définissez la valeur sur ListTagResources.
RegionId	String	Oui	cn-hangzhou	ID de région du tag. Appelez l'opération DescribeRegions pour obtenir la liste des régions disponibles.
ResourceType	String	Oui	stack	Type de ressource. Valeurs possibles : stack : stack stackgroup : groupe de stacks template : modèle templatescratch : scénario
NextToken	String	Non	caeba0bbb2be03f84eb48b699f0*****	Jeton définissant le point de départ de la requête suivante.
ResourceId.N	String	Non	6bc589b5-9c02-4944-8fc3-f3624234****	ID de la ressource N. Vous pouvez indiquer jusqu'à 50 ID de ressources. Remarque Si le paramètre ResourceType est défini sur stackgroup, utilisez le nom du groupe de stacks comme ID de ressource.
Tag.N.Key	String	Non	FinanceDept	Clé du tag N associé à la ressource. Vous pouvez indiquer jusqu'à 20 clés. La clé ne peut pas être vide. La clé peut contenir jusqu'à 128 caractères. Elle ne doit pas inclure `http://` ni `https://`, ni commencer par `aliyun` ou `acs:`.
Tag.N.Value	String	Non	FinanceJoshua	Valeur du tag N associé à la ressource. Vous pouvez indiquer jusqu'à 20 valeurs. La valeur peut être vide. La valeur peut contenir jusqu'à 128 caractères. Elle ne doit pas inclure `http://` ni `https://`, ni commencer par `aliyun` ou `acs:`.

Pour plus d'informations sur les paramètres communs, consultez la section Paramètres communs.

Paramètres de réponse

Paramètre	Type	Exemple	Description
NextToken	String	caeba0bbb2be03f84eb48b699f0*	Jeton permettant d'initier la requête suivante.
RequestId	String	C429473A-5C66-4661-B5F8-4F900CD4330A	ID de la requête.
TagResources	Array of TagResource		Informations sur les tags associés à la ressource.
ResourceType	String	stack	Type de ressource.
TagValue	String	TayValue1	Valeur du tag de la ressource.
ResourceId	String	c754d2a4-28f1-46df-b557-9586173a****	ID de la ressource.
TagKey	String	TagKey1	Clé du tag de la ressource.

Exemples

Exemple de requête

http(s)://ros.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=stack
&ResourceId.N=6bc589b5-9c02-4944-8fc3-f3624234****
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<ListTagResourcesResponse>
	<RequestId>FFBB9725-261D-4321-B627-C98304200065</RequestId>
	<NextToken></NextToken>
	<TagResources>
		<ResourceId>c754d2a4-28f1-46df-b557-9586173a****</ResourceId>
		<TagKey>TagKey1</TagKey>
		<ResourceType>stack</ResourceType>
		<TagValue>TayValue1</TagValue>
	</TagResources>
</ListTagResourcesResponse>

Format JSON

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

{
  "RequestId" : "FFBB9725-261D-4321-B627-C98304200065",
  "NextToken" : "",
  "TagResources" : [ {
    "ResourceId" : "c754d2a4-28f1-46df-b557-9586173a****",
    "TagKey" : "TagKey1",
    "ResourceType" : "stack",
    "TagValue" : "TayValue1"
  } ]
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez la section Codes d'erreur du service.

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	MissingParameter	One of the input parameters ResourceIds,Tags should be specified.	Les paramètres ResourceId.N et Tag.N n'ont pas été spécifiés. Indiquez au moins l'un de ces paramètres.
400	InvalidParameter	The specified parameter ResourceType is invalid, {reason}.	Le paramètre ResourceType spécifié n'est pas valide. reason indique la cause de l'erreur.
400	InvalidParameter	The specified parameter Tags is invalid, {reason}.	Le paramètre Tag.N spécifié n'est pas valide. reason indique la cause de l'erreur.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	La clé de tag spécifiée existe déjà. Utilisez une clé unique.