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 S3 Access Grants utilise des API opérations différentes de celles du balisage d'objets. S3 Access Grants utilise le TagResource, UntagResource, et ListTagsForResourceAPIopérations, où une ressource peut être soit une instance S3 Access Grants, soit un emplacement enregistré, soit une autorisation 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 en UTF -16. En UTF -16, les caractères occupent 1 ou 2 positions de caractères.

  • 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 en utilisant le AWS Command Line Interface (AWS CLI), l'Amazon S3 REST API ou le AWS SDKs.

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 Amazon S3 API pour baliser, débaliser ou répertorier les balises pour une instance S3 Access Grants, un emplacement enregistré ou une autorisation d'accès. Pour plus d'informations sur la REST API prise en charge de la gestion des balises S3 Access Grants, consultez les sections suivantes du manuel Amazon Simple Storage Service API Reference :