Appelez l'opération TagResources pour créer des tags et les ajouter à vos instances.
Si vous gérez un grand nombre d'instances, créez plusieurs tags et associez-les à ces instances afin de les filtrer par tag.
Un tag se compose d'une clé et d'une valeur. Chaque clé doit être unique au sein d'une région pour un compte Alibaba Cloud donné. Plusieurs clés différentes peuvent toutefois correspondre à la même valeur.
Si le tag spécifié n'existe pas encore, le système le crée automatiquement et l'ajoute à l'instance concernée.
Si la clé du tag spécifié est identique à celle d'un tag existant, le nouveau tag écrase l'ancien.
Vous pouvez associer jusqu'à 20 tags à une instance.
Chaque appel permet d'ajouter des tags à un maximum de 50 instances.
Débogage
Paramètres de requête
|
Paramètre |
Type |
Obligatoire |
Exemple |
Description |
|
Action |
String |
Oui |
TagResources |
Opération à effectuer. Définissez la valeur sur TagResources. |
|
RegionId |
String |
Oui |
cn-hangzhou |
ID de la région. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes. |
|
ResourceType |
String |
Oui |
INSTANCE |
Type de ressource. Définissez la valeur sur INSTANCE. |
|
ResourceId.N |
String |
Oui |
rm-uf6wjk5xxxxxxx |
ID des instances. Vous pouvez ajouter des tags à N instances en une seule fois. Valeurs possibles pour N : 1 à 50. |
|
Tag.N.Key |
String |
Oui |
testkey1 |
Clé du tag à ajouter à l'instance. Vous pouvez créer N clés de tag en une seule fois. Valeurs possibles pour N : 1 à 20. Ce paramètre ne peut pas être une chaîne vide. |
|
Tag.N.Value |
String |
Non |
testvalue1 |
Valeur associée à la clé de tag spécifiée. Vous pouvez créer N valeurs de tag en une seule fois. Valeurs possibles pour N : 1 à 20. Ce paramètre peut être une chaîne vide. |
Paramètres de réponse
|
Paramètre |
Type |
Exemple |
Description |
|
RequestId |
String |
224DB9F7-3100-4899-AB9C-C938BCCB43E7 |
ID de la requête. |
Exemples
Exemple de requête
http(s)://rds.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceId.1=rm-uf6wjk5xxxxxxx
&Tag.1.Key=testkey1
&Tag.1.Value=testvalue1
&<Common request parameters>Exemple de réponse réussie
Format XML
HTTP/1.1 200 OK
Content-Type:application/xml
<TagResourcesResponse>
<RequestId>224DB9F7-3100-4899-AB9C-C938BCCB43E7</RequestId>
</TagResourcesResponse>Format JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "224DB9F7-3100-4899-AB9C-C938BCCB43E7"
}Codes d'erreur
|
Code d'état HTTP |
Code d'erreur |
Message d'erreur |
Description |
|
400 |
NumberExceed.Tags |
The maximum number of Tags is exceeded. The maximum value is 20. |
Le nombre de tags créés dépasse la limite supérieure. Vous pouvez créer jusqu'à 20 tags pour une instance. |
|
400 |
MissingParameter |
The parameter - Tags should not be null |
Le paramètre Tag.N.Key n'a pas été spécifié. |
|
400 |
InvalidTagKey.Malformed |
The Tag.N.Key parameter is blank |
La valeur du paramètre Tag.N.Key est une chaîne vide. |
|
400 |
InvalidTagValue.Malformed |
The Tag.N.Value parameter is blank |
La valeur du paramètre Tag.N.Value est vide. |
|
400 |
Duplicate.TagKey |
The Tag.N.Key contain duplicate key. |
Le paramètre Tag.N.Key contient une clé en double. |
|
400 |
OperationDenied.QuotaExceed |
The maximum number of Tags is exceeded. |
Le nombre de tags créés dépasse la limite supérieure. |
|
400 |
NumberExceed.ResourceIds |
The maximum number of ResourceIds is exceeded. The maximum value is 50. |
Le nombre d'ID d'instance dépasse la limite supérieure. Vous pouvez spécifier jusqu'à 50 ID d'instance. |
|
400 |
InvalidTagKey.Malformed |
The operator is not permission for the system tag |
Vous n'êtes pas autorisé à effectuer des opérations sur les tags système. |
|
400 |
Request.NotFound |
The requested resource is not available. |
La ressource demandée n'est pas disponible. |
|
400 |
InvalidTagValue.Malformed |
The Tag.N.Value parameter is invalid. |
La valeur du paramètre Tag.N.Value n'est pas valide. |
Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.