Utilisation de AWS balises avec S3 Access Grants - Amazon Simple Storage Service

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.

Utilisation de AWS balises avec S3 Access Grants

Dans les octrois d’accès Amazon S3, les balises présentent des caractéristiques similaires à celles des balises d’objet dans Amazon S3. Chaque balise est une paire clés-valeurs. Les ressources que vous pouvez baliser dans les octrois d’accès S3 sont les instances, les emplacements et les octrois.

Note

Le balisage dans les octrois d’accès S3 utilise des opérations d’API différentes de celles du balisage d’objets. Les octrois d’accès S3 utilisent les opérations d’API TagResource, UntagResource et ListTagsForResource, où une ressource peut être une instance d’octrois d’accès S3, un emplacement enregistré ou un octroi d’accès.

Comme avec les balises d’objet, les limitations suivantes s’appliquent :

  • Vous pouvez ajouter des balises à de nouvelles ressources d’octrois d’accès S3 lorsque vous les créez, ou vous pouvez ajouter des balises à des ressources existantes.

  • Vous pouvez associer jusqu’à 10 balises à une ressource. Si plusieurs balises sont associées à la même ressource, elles doivent avoir des clés de balise uniques.

  • Une clé d'étiquette peut comporter jusqu'à 128 caractères Unicode et les valeurs d'étiquette peuvent comporter jusqu'à 256 caractères Unicode. Les balises sont représentées en interne au format UTF-16. Dans le format UTF-16, les caractères occupent une ou deux positions de caractère.

  • Les clés et les valeurs sont sensibles à la casse.

Pour plus d’informations sur les restrictions liées aux balises, consultez Restrictions encadrant les balises définies par l’utilisateur dans le Guide de l’utilisateur AWS Billing .

Vous pouvez baliser les ressources dans S3 Access Grants à l'aide de AWS Command Line Interface (AWS CLI), de l'API REST Amazon S3 ou AWS des SDK.

Pour l'installer AWS CLI, reportez-vous à la section Installation du AWS CLI dans le guide de AWS Command Line Interface l'utilisateur.

Vous pouvez baliser une ressource d’octrois d’accès S3 lorsque vous la créez ou après l’avoir créée. Les exemples suivants montrent comment baliser une instance d’octrois d’accès S3 ou en annuler le balisage. Vous pouvez effectuer des opérations similaires pour des emplacements enregistrés et des octrois d’accès.

Pour utiliser les exemples de commandes suivants, remplacez les user input placeholders par vos propres informations.

Exemple : Créer une instance d’octrois d’accès S3 avec des balises
aws s3control create-access-grants-instance \
 --account-id 111122223333 \
 --profile access-grants-profile \
 --region us-east-2 \
 --tags Key=tagKey1,Value=tagValue1

Réponse :

 {
    "CreatedAt": "2023-10-25T01:09:46.719000+00:00",
    "AccessGrantsInstanceId": "default",
    "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default"
}
Exemple : Baliser une instance d’octrois d’accès S3 déjà créée
aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2 \
--tags Key=tagKey2,Value=tagValue2
Exemple : Répertorier les balises pour l’instance d’octrois d’accès S3
aws s3control list-tags-for-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2

Réponse :

{
    "Tags": [
        {
            "Key": "tagKey1",
            "Value": "tagValue1"
        },
        {
            "Key": "tagKey2",
            "Value": "tagValue2"
        }
    ]
}
Exemple : Annuler le balisage de l’instance d’octrois d’accès S3
aws s3control untag-resource \
 --account-id 111122223333 \
 --resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
 --profile access-grants-profile \
 --region us-east-2 \
 --tag-keys "tagKey2"

Vous pouvez utiliser l’API Amazon S3 pour définir des balises, annuler le balisage ou répertorier les balises pour une instance d’octrois d’accès S3, un emplacement enregistré ou un octroi d’accès. Pour en savoir plus sur la prise en charge de l’API REST pour la gestion des balises d’octrois d’accès S3, consultez les sections suivantes dans la Référence d’API Amazon Simple Storage Service :