TagResources - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Avant d'ajouter des tags à une ressource, Alibaba Cloud vérifie le nombre de tags existants sur cette ressource. Si le nombre maximal de tags est atteint, un message d'erreur s'affiche. Pour plus d'informations, consultez la section « Limites des tags » dans Limites.

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	TagResources	Opération à effectuer. Définissez la valeur sur TagResources.
RegionId	String	Yes	cn-hangzhou	ID de région de la ressource. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes.
ResourceType	String	Yes	instance	Type de ressource. Valeurs possibles : instance : instance ECS disk : disque snapshot : snapshot image : image securitygroup : groupe de sécurité volume : volume de stockage eni : interface réseau élastique (ENI) ddh : hôte dédié ddhcluster : cluster d'hôtes dédiés keypair : paire de clés SSH launchtemplate : modèle de lancement reservedinstance : instance réservée snapshotpolicy : politique de snapshot automatique elasticityassurance : assurance d'élasticité capacityreservation : réservation de capacité command : commande Cloud Assistant invocation : résultat d'exécution de la commande Cloud Assistant ou résultat de livraison de fichier activation : code d'activation pour l'instance gérée par Cloud Assistant managedinstance : instance gérée par Cloud Assistant
ResourceId.N	String	Yes	r-XXX	ID de la ressource N. Valeurs possibles pour N : 1 à 50.
Tag.N.Key	String	Yes	TestKey	Clé du tag N à ajouter à la ressource. Valeurs possibles pour N : 1 à 20. La clé de tag ne peut pas être une chaîne vide. Elle peut comporter jusqu'à 128 caractères et ne doit pas contenir `http://` ni `https://`. Elle ne doit pas commencer par `acs:` ou `aliyun`.
Tag.N.Value	String	Yes	TestValue	Valeur du tag N à ajouter à la ressource. Valeurs possibles pour N : 1 à 20. La valeur de tag peut être une chaîne vide. Elle peut comporter jusqu'à 128 caractères et ne doit pas contenir `http://` ni `https://`. Elle ne doit pas commencer par `acs:`.

Paramètres de réponse

Parameter

Type

Example

Description

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID de la requête.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceId.1=i-bp1j6qtvdm8w0z1o0****
&ResourceId.2=i-bp1j6qtvdm8w0z1oP****
&ResourceType=instance
&Tag.1.Key=TestKey
&<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

HTTP status code	Error code	Error message	Description
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	La clé de tag existe déjà. Les clés de tag doivent être uniques.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valeur Tag.N.Key non valide.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valeur Tag.N.Value non valide.
400	OperationDenied.QuotaExceed	The quota of tags on resource is beyond permitted range.	Le nombre maximal de tags est dépassé.
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.	Les paramètres Tag.N.Key et Tag.N.Value spécifiés ne correspondent pas.
400	InvalidTagCount	The specified tags are beyond the permitted range.	Le nombre maximal de tags est dépassé.
400	Invalid.Scope	The specified scope is invalid.	Valeur Scope non valide.
403	PermissionDenied.TagOwnerUid	The specified operator not have permission to set TagOwnerUid value.	Vous n'êtes pas autorisé à spécifier le paramètre TagOwnerUid.
403	PermissionDenied.Scope	The specified operator not have permission to set Scope value.	Vous n'êtes pas autorisé à spécifier le paramètre Scope.
403	InvalidResourceId.NotSupported	The specified ResourceId does not support tagging.	La ressource spécifiée ne prend pas en charge le tagging.
403	NoPermission.Tag	The operator is not permission for the tag.	Vous n'êtes pas autorisé à gérer le tag.
403	QuotaExceed.Tags	%s	Le nombre maximal de tags est dépassé. %s est une variable. Un message d'erreur est renvoyé dynamiquement en fonction des conditions d'appel.
404	InvalidRegionId.NotFound	%s	L'ID de région spécifié n'existe pas.
404	MissingParameter.ResourceType	The parameter - ResourceType should not be null.	ResourceType est requis.
404	InvalidResourceId.NotFound	The specified ResourceIds are not found in our records.	La ressource spécifiée n'existe pas. Vérifiez si le paramètre ResourceId est correct.
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.	Le type de ressource spécifié est introuvable.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	L'ID de région spécifié n'existe pas.
500	ServiceUnavailable	The service is unavailable, please try again later.	Le service est temporairement indisponible. Réessayez ultérieurement.

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