Gestion des balises S3 Access Grants - Amazon Simple Storage Service

Gestion des balises S3 Access Grants

Dans Amazon S3 Access Grants, 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 S3 Access Grants sont les instances, les emplacements et les octrois.

Note

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

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

  • Vous pouvez ajouter des balises à de nouvelles ressources S3 Access Grants 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é de balise peut comporter jusqu’à 128 caractères Unicode et les valeurs de balise 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 l’AWS Command Line Interface (AWS CLI), de l’API REST Amazon S3 ou des kits AWS SDK.

Pour installer la AWS CLI, consultez Installation de la AWS CLI dans le Guide de l’utilisateur AWS Command Line Interface.

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

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

Exemple : Créer une instance S3 Access Grants 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 S3 Access Grants 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 S3 Access Grants
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 S3 Access Grants
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 S3 Access Grants, un emplacement enregistré ou une autorisation d’accès. Pour en savoir plus sur la prise en charge de l’API REST pour la gestion des balises S3 Access Grants, consultez les sections suivantes dans la Référence des API Amazon Simple Storage Service :