Tous les produits
Search
Centre de documentation

:UntagResources

Dernière mise à jour :Aug 07, 2026

Supprime les balises des ressources de divers services Alibaba Cloud.

Description de l'opération

Après la suppression d'une balise, celle-ci est automatiquement supprimée dans les 24 heures si elle n'est pas ajoutée à d'autres ressources.

Pour plus d'informations sur les services Alibaba Cloud qui prennent en charge les balises, consultez Services compatibles avec les balises.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

tag:UntagResources

update

*All Resource

*

Aucune
  • *:UntagResources
  • *:UnTagResources
  • vod:UnTagVodResources
  • dcdn:UntagDcdnResources
  • ecs:RemoveTags
  • slb:RemoveTags
  • rds:RemoveTagsFromResource
  • oss:DeleteBucketTagging
  • live:UnTagLiveResources

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

RegionId

string

Oui

L'identifiant de la région.

cn-hangzhou

RegionId

string

Oui

L'identifiant de la région.

cn-hangzhou

ResourceARN

array

Oui

Le nom de ressource Alibaba Cloud (ARN) d'une ressource.

arn:acs:vpc:cn-hangzhou:123456789****:vpc/vpc-bp19dd90tkt6tz7wu****

string

Non

L'ARN d'une ressource.

Valeurs valides de N : 1 à 50.

Format : arn:acs:${ProductCode}:${Region}:${Account}:${ResourceType}/${ResourceId}. Champs :

  • ProductCode : le code du service. Vous pouvez définir ce champ sur une valeur obtenue à partir de la réponse de l'opération ListSupportResourceTypes.

  • Region : l'identifiant de la région de la ressource. Vous pouvez définir ce champ sur un astérisque (*) pour indiquer la région actuelle.

  • Account : l'identifiant du compte Alibaba Cloud auquel la ressource appartient. Vous pouvez définir ce champ sur un astérisque (*) pour indiquer le compte Alibaba Cloud actuel.

  • ResourceType : le type de ressource. Vous pouvez définir ce champ sur une valeur obtenue à partir de la réponse de l'opération ListSupportResourceTypes.

  • ResourceId : l'identifiant de la ressource.

Remarque

Vous pouvez définir ProductCode et ResourceType dans ResourceARN sur des valeurs définies dans Resource Group, ActionTrail ou Resource Center.

arn:acs:vpc:cn-hangzhou:123456789****:vpc/vpc-bp19dd90tkt6tz7wu****

TagKey

array

Oui

La clé de la balise N.

Valeurs valides de N : 1 à 10.

k1

string

Non

La clé de la balise N.

Valeurs valides de N : 1 à 10.

k1

Pour plus d'informations sur les paramètres de requête courants, consultez Paramètres courants.

Éléments de réponse

Élément

Type

Description

Exemple

object

Le résultat renvoyé.

RequestId

string

L'identifiant de la requête.

43D12436-B10F-4469-8136-FD1C5D2B2083

FailedResources

object

FailedResource

array<object>

Les informations sur les ressources dont les balises n'ont pas pu être supprimées.

Remarque
  • Si les balises sont supprimées de toutes les ressources, la valeur de FailedResources est vide.

  • Si les balises n'ont pas pu être supprimées de certaines ou de toutes les ressources, la valeur de FailedResources contient les informations détaillées sur les ressources.

array<object>

Les informations sur les ressources dont les balises n'ont pas pu être supprimées.

ResourceARN

string

The ARN of the resource.

arn:acs:ecs:cn-hangzhou:123456789****:instance/i-xxxxxxxxxx1

Result

object

The information about the error.

Code

string

The error code.

InvalidResourceId.NotFound

Message

string

The error message.

The specified ResourceIds are not found in our records.

Exemples

JSON format

{
  "RequestId": "43D12436-B10F-4469-8136-FD1C5D2B2083",
  "FailedResources": {
    "FailedResource": [
      {
        "ResourceARN": "arn:acs:ecs:cn-hangzhou:123456789****:instance/i-xxxxxxxxxx1",
        "Result": {
          "Code": "InvalidResourceId.NotFound",
          "Message": "The specified ResourceIds are not found in our records."
        }
      }
    ]
  }
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidResourceARN.Account The Account specified in the ResourceARN parameter does not match the actual account, specifically: %s. The Account in the ResourceARN do not match the actual user, namely: %s
400 InvalidResourceARN.FormatError The format of parameter ResourceARN: %s is not valid, for the correct format, you can refer to the Recommend. The ResourceARN format does not conform to the specification. For the correct format, please refer
400 InvalidResourceARN.Region The Region specified in the ResourceARN parameter does not match the RegionId parameter, specifically: %s. The Region in the ResourceARN does not match the parameter RegionId. They are: %s
400 InvalidParameter.ResourceType The parameter resource type: %s in ResourceARN is not valid or not support. ResourceType in ResourceARN: %s is Illegal or unsupported.
400 InvalidParameter.ServiceCode The parameter service code: %s in ResourceARN is not valid or not support. ServiceCode in ResourceARN: %s is Illegal or unsupported.
400 InvalidParameter.TagKey The TagKey parameter is invalid. The following TagKeys are invalid: %s. Illegal tag keys exist in the parameter. Illegal tag keys are as follows: %s
400 InvalidParameter.TagValue The TagValue parameter is invalid. The following TagValues are invalid: %s. The parameter contains illegal tag values. Illegal tag values are as follows: %s
403 Duplicate.TagKey The Tag.N.Key contains duplicate keys. The Tag.N.Key contains duplicate keys.
403 InvalidParameter.Category The specified Category is invalid. Valid values are Custom and System. The specified Category is invalid. Valid values are Custom and System.
403 MissingParameter.Createby You must specify Createby. You must specify Createby.
403 MissingParameter.ResourceIds You must specify ResourceIds. You must specify ResourceIds.
403 NoPermission.Operator The user is not authorized to operate on the specified resource. The user is not authorized to operate on the specified resource.
403 NoPermission.SystemTag The user does not have permission to operate the system tag. The user does not have permission to operate the system tag.
403 NoPermissionKey.Category Some keys cannot be modified because the user does not have permission. Some keys cannot be modified because the user does not have permission.
403 NoPermissionKey.Operator You are not authorized to operate the tag key. You are not authorized to operate the tag key.
403 NumberExceed.ResourceIds The maximum number of ResourceIds is exceeded. The maximum number of ResourceIds is exceeded.
403 NumberExceed.Tags The maximum number of Tags is exceeded. The maximum number of Tags is exceeded.
403 QuotaExceed.TagsPerResource The maximum number of tags for each resource is exceeded. The maximum number of tags for each resource is exceeded.
403 Missing.ServiceCode You must specify ServiceCode. You must specify ServiceCode.
404 Missing.TagKey Tag.N.Value has been specified and you must specify Tag.N.Key. Tag.N.Value has been specified and you must specify Tag.N.Key.
404 MissingParameter.AliUid You must specify AliUid. You must specify AliUid.
404 MissingParameter.Bid You must specify Bid. You must specify Bid.
404 MissingParameter.TagKey You must specify TagKey. You must specify TagKey.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.