Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Ajout d’une balise à un point d’accès
<a name="access-points-tag-add"></a>



Vous pouvez ajouter des balises à des points d’accès Amazon S3 et modifier ces balises. L’utilisation de balises sur les points d’accès n’occasionne aucun coût supplémentaire, en dehors des tarifs standard des demandes d’API S3. Pour plus d’informations, consultez [Tarification Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Pour plus d’informations sur le balisage des points d’accès, consultez [Utilisation de balises avec des points d’accès S3 de compartiments à usage général](access-points-tagging.md).

## Permissions
<a name="access-points-tag-add-permissions"></a>

Pour ajouter une balise à un point d’accès, vous devez disposer de l’autorisation suivante :
+ `s3:TagResource`

## Résolution des erreurs
<a name="access-points-tag-add-troubleshooting"></a>

Si vous rencontrez une erreur lorsque vous tentez d’ajouter une balise à un point d’accès : 
+ Vérifiez que vous disposez des [Permissions](#access-points-tag-add-permissions) requises pour ajouter une balise à un point d’accès.
+ Si vous avez essayé d'ajouter une clé de balise commençant par le préfixe AWS réservé`aws:`, modifiez la clé de balise et réessayez. 

## Étapes
<a name="access-points-tag-add-steps"></a>

Vous pouvez ajouter des balises aux points d'accès à l'aide de la console Amazon S3, de l'interface de ligne de AWS commande (AWS CLI), de l'API REST Amazon S3 et AWS SDKs.

## Utilisation de la console S3
<a name="access-points-tag-add-console"></a>

Pour ajouter des balises à un point d’accès à l’aide de la console Amazon S3 :

1. Connectez-vous à la console Amazon S3 à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans le volet de navigation de gauche, choisissez **Points d’accès (compartiments à usage général)**.

1. Choisissez le nom du point d’accès. 

1. Choisissez l’onglet **Propriétés**. 

1. Faites défiler la section **Balises** et choisissez **Ajouter une balise**. 

1. La page **Ajouter des balises** s’ouvre. Vous pouvez saisir jusqu’à 50 paires clé-valeur de balise. 

1. Si vous ajoutez une nouvelle balise portant le même nom de clé qu’une balise existante, la valeur de la nouvelle balise remplace celle de l’ancienne balise.

1. Vous pouvez également modifier les valeurs des clés existantes sur cette page.

1. Après avoir ajouté les balises, choisissez **Enregistrer les modifications**. 

## En utilisant le AWS SDKs
<a name="access-points-tag-add-sdks"></a>

------
#### [ SDK for Java 2.x ]

Cet exemple montre comment ajouter des balises à un point d’accès à l’aide du AWS SDK for Java 2.x. Pour utiliser la commande, remplacez les *user input placeholders* par vos propres informations. 

```
TagResourceRequest tagResourceRequest = TagResourceRequest.builder().resourceArn(arn:aws::s3:region:111122223333:accesspoint/my-access-point/*)
.accountId(111122223333)
.tags(List.of(Tag.builder().key("key1").value("value1").build(),
Tag.builder().key("key2").value("value2").build()))
.build();
awss3Control.tagResource(tagResourceRequest);
```

------

## Utilisation de l'API REST
<a name="access-points-tag-add-api"></a>

Pour plus d’informations sur la prise en charge de l’API REST Amazon S3 pour l’ajout de balises à un point d’accès, consultez la section suivante dans la *Référence des API Amazon Simple Storage Service* :
+ [TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html)

## À l'aide du AWS CLI
<a name="access-points-tag-add-cli"></a>

Pour installer la AWS CLI, reportez-vous à la section [Installation de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) dans le *guide de AWS Command Line Interface l'utilisateur*.

L’exemple d’interface de ligne de commande suivant montre comment ajouter des balises à un point d’accès à l’aide de l’ AWS CLI. Pour utiliser la commande, remplacez les *user input placeholders* par vos propres informations.

**Requête :**

```
aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn arn:aws::s3:region:111122223333:accesspoint/my-access-point/* \
--tags "Key=key1,Value=value1"
```

**Réponse :**

```
{
  "ResponseMetadata": {
      "RequestId": "EXAMPLE123456789",
      "HTTPStatusCode": 200,
      "HTTPHeaders": {
          "date": "Wed, 19 Jun 2025 10:30:00 GMT",
          "content-length": "0"
      },
      "RetryAttempts": 0
  }
}
```