Tous les produits
Search
Centre de documentation

:TagResources

Dernière mise à jour :Aug 10, 2026

Crée des tags et les associe aux ressources Resource Orchestration Service (ROS) spécifiées.

Cette rubrique présente un exemple de création d’un tag et d’ajout de ce tag à une ressource au sein d’une pile. Dans cet exemple, l’ID de la ressource est 7fee80e1-8c48-4c2f-8300-0f6dc40b****, la clé du tag est FinanceDept et la valeur du tag est FinanceJoshua.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de la signature. Pour plus de commodité, nous vous recommandons d’appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l’exemple de code de l’opération pour différents SDK.

Paramètres de requête

ParamètreTypeObligatoireExempleDescription
ActionStringOuiTagResources

Opération à exécuter. Définissez la valeur sur TagResources.

RegionIdStringOuicn-hangzhou

ID de région du tag. Appelez l’opération DescribeRegions pour obtenir la liste des régions les plus récentes.

ResourceTypeStringOuistack

Type de la ressource à laquelle vous souhaitez ajouter le tag. Valeurs possibles :

  • stack : pile
  • stackgroup : groupe de piles
  • template : modèle
  • templatescratch : scénario
ResourceId.NStringOui7fee80e1-8c48-4c2f-8300-0f6dc40b****

ID de la ressource N. Vous pouvez spécifier jusqu’à 50 ID de ressources.

Remarque Si vous définissez le paramètre ResourceType sur stackgroup, utilisez le nom du groupe de piles comme ID de ressource.
Tag.N.KeyStringOuiFinanceDept

Clé du tag N à ajouter à la ressource. Vous pouvez spécifier jusqu’à 20 clés de tag.

La clé du tag peut comporter jusqu’à 128 caractères et ne doit pas contenir http:// ni https://. Elle ne doit pas commencer par aliyun ou acs:.

Tag.N.ValueStringOuiFinanceJoshua

Valeur du tag N à ajouter à la ressource. Vous pouvez spécifier jusqu’à 20 valeurs de tag.

La valeur du tag peut comporter jusqu’à 128 caractères et ne doit pas contenir http:// ni https://. Elle ne doit pas commencer par aliyun ou acs:.

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

Paramètres de réponse

Paramètre Type Exemple Description
RequestId String C46FF5A8-C5F0-4024-8262-B16B639225A0

ID de la requête.

Exemples

Exemples de requêtes

http(s)://ros.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceId.1=7fee80e1-8c48-4c2f-8300-0f6dc40b****
&ResourceType=stack
&Tag.1.Key=FinanceDept
&Tag.1.Value=FinanceJoshua
&<Common request parameters>

Exemples de réponses réussies

Format XML

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

<TagResourcesResponse>
        <RequestId>C46FF5A8-C5F0-4024-8262-B16B639225A0</RequestId>
</TagResourcesResponse>

Format JSON

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

{
  "RequestId" : "C46FF5A8-C5F0-4024-8262-B16B639225A0"
}

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

InvalidParameter

The specified parameter ResourceType is invalid, {reason}.

Le message d’erreur indique que le paramètre ResourceType spécifié n’est pas valide. reason indique la cause de l’erreur.

400

InvalidParameter

The specified parameter ResourceIds is invalid, {reason}.

Le message d’erreur indique que les ID de ressource spécifiés n’existent pas ou n’ont pas pu être validés. reason indique la cause de l’erreur.

400

InvalidParameter

The specified parameter Tags is invalid, {reason}.

Le message d’erreur indique que 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.

Le message d’erreur indique que la clé de tag spécifiée existe déjà. Spécifiez une clé de tag unique.