TagResources - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Les tags servent à classer les instances. Chaque tag est constitué d'une paire clé-valeur. Avant d'utiliser les tags, prenez connaissance des limites suivantes :

Chaque clé de tag ajoutée à une instance doit être unique.
Ne créez pas de tags sans les ajouter à des instances. Tous les tags doivent être ajoutés à des instances.
Les informations de tag ne sont pas partagées entre les régions.

Par exemple, consultez les tags créés dans la région Chine (Hangzhou) depuis la région Chine (Shanghai) : cela est impossible.
Les clouds privés virtuels (VPC), les tables de routage, les vSwitches et les adresses IP élastiques (EIP) appartenant au même compte Alibaba Cloud et déployés dans la même région partagent les informations de tag.

Par exemple, si vous avez ajouté un tag à un VPC, ce tag est disponible pour les vSwitches, les tables de routage et les EIP appartenant au même compte et déployés dans la même région que le VPC. Sélectionnez ce tag depuis la page d'édition et ne le saisissez pas à nouveau. Modifiez la clé et la valeur d'un tag, ou supprimez un tag d'une instance. Lorsque vous supprimez une instance, tous les tags ajoutés à celle-ci sont supprimés.
Vous pouvez ajouter jusqu'à 20 tags à chaque instance. Avant d'ajouter un tag à une instance, le système vérifie automatiquement le nombre de tags existants. Si le nombre maximal de tags est atteint, le système renvoie un message d'erreur.

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 le code d'exemple de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
ResourceType	String	Oui	VPC	Le type de ressource. Valeurs valides : VPC : cloud privé virtuel (VPC) VSWITCH : vSwitch ROUTETABLE : table de routage EIP : adresse IP élastique (EIP) VPNGATEWAY : passerelle VPN NATGATEWAY : passerelle NAT COMMONBANDWIDTHPACKAGE : plan de bande passante EIP PREFIXLIST : liste de préfixes PUBLICIPADDRESSPOOL : pool d'adresses IP IPV4GATEWAY : passerelle IPv4 IPV6GATEWAY : passerelle IPv6 NETWORKACL : ACL réseau TRAFFICMIRRORFILTER : filtre de miroir de trafic TRAFFICMIRRORSESSION : session de miroir de trafic FLOWLOG : journal de flux HAVIP : adresse IP virtuelle à haute disponibilité (HAVIP) DHCPOPTIONSSET : jeu d'options DHCP GATEWAYENDPOINT : endpoint de passerelle Remarque Les valeurs ne sont pas sensibles à la casse.
ResourceId.N	String	Non	vpc-bp16qjewdsunr41m1****	L'ID de la ressource. Saisissez jusqu'à 50 ID maximum. Remarque Lors de l'appel de cette opération, spécifiez ResourceId.N.
RegionId	String	Oui	cn-hangzhou	L'ID de région de la ressource. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
Tag.N.Key	String	Non	FinanceDept	La clé du tag N à ajouter à la ressource. Saisissez au moins une clé de tag et au plus 20 clés de tag. Une clé de tag peut comporter jusqu'à 128 caractères. Elle ne peut pas commencer par `aliyun` ou `acs:`, et ne peut pas contenir `http://` ou `https://`. Remarque Lors de l'appel de cette opération, spécifiez Tag.N.Key ; une chaîne vide n'est pas autorisée.
Tag.N.Value	String	Non	FinanceJoshua	La valeur du tag N à ajouter à la ressource. Saisissez au moins une valeur de tag et au plus 20 valeurs de tag. Une valeur de tag peut comporter jusqu'à 128 caractères. Elle ne peut pas commencer par `aliyun` ou `acs:`, et ne peut pas contenir `http://` ou `https://`. Remarque Lors de l'appel de cette opération, spécifiez Tag.N.Value ; une chaîne vide est autorisée.
Action	String	Oui	TagResources	L'opération à effectuer. Définissez la valeur sur TagResources.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	C46FF5A8-C5F0-4024-8262-B16B639225A0	L'ID de requête.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?ResourceType=VPC
&ResourceId=["vpc-bp16qjewdsunr41m1****"]
&RegionId=cn-hangzhou
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&Action=TagResources
&Common request parameters

Exemples de réponses réussies

XML format

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

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

JSON format

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

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

Codes d'erreur

HttpCode	Code d'erreur	Message d'erreur	Description
400	InvalidTagKey	The tag keys are not valid.	L'index du tag est invalide.
400	InvalidTagValue	The tag values are not valid.	La valeur du tag est invalide.
400	InvalidInstanceType.NotFound	The instance type is not found	Le type d'instance est introuvable.
400	InvalidInstanceIds.NotFound	The instanceIds are not found	L'ID d'instance est introuvable.
400	Forbidden.TagKeys	The request do not allow to operate the tag keys	Vous ne disposez pas des permissions nécessaires à la spécification de TagKeys.
400	QuotaExceeded.TagNum	Custom Tags quota exceeded	La limite supérieure est atteinte.
400	InvalidTagScope.NotFound	The tag scope is not found	La portée de la ressource est invalide.
400	Forbidden.NotAllowedCategary	The System tag is not valid	Le tag système est invalide.
400	Forbidden.TagKeys	The request does not allow operate this tagkeys	La gestion de la clé de tag via cette opération n'est pas possible.
400	Forbidden.TagKey.Duplicated	The specified tag key already exists.	Les ressources de tag sont en double.
400	SizeLimitExceeded.TagNum	The maximum number of tags is exceeded.	Le nombre de tags a atteint la limite supérieure.
400	SizeLimitExceeded.ResourceId	The maximum number of resource IDs is exceeded.	Le nombre d'ID de groupe de ressources a atteint la limite supérieure.
400	MissingParameter.TagValue	The input parameter TagValue that is mandatory for processing this request is not supplied.	TagValue n'est pas spécifié.
400	MissingParameter.TagKey	The input parameter TagKey that is mandatory for processing this request is not supplied.	TagKey n'est pas spécifié.
400	MissingParam.Tags	You must specify the Tags parameter.	Spécifiez Tags.
403	Forbidden	User not authorized to operate on the specified resource.	Vous n'êtes pas autorisé à effectuer cette opération sur la ressource spécifiée. Obtenez les permissions requises et réessayez.

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