Uso de etiquetas de AWS con S3 Access Grants

Las etiquetas de Amazon S3 Access Grants tienen características similares a las etiquetas de objetos de Amazon S3. Cada etiqueta es un par clave-valor. Los recursos de S3 Access Grants que puede etiquetar son instancias, ubicaciones y concesiones de S3 Access Grants.

nota

El etiquetado en S3 Access Grants utiliza operaciones de API diferentes a las del etiquetado de objetos. S3 Access Grants utiliza las operaciones de la API TagResource, UntagResource y ListTagsForResource en las que un recurso puede ser una instancia de S3 Access Grants, una ubicación registrada o una concesión de acceso.

Al igual que las etiquetas de objetos, se aplican las siguientes limitaciones:

• Puede añadir etiquetas a los nuevos recursos de S3 Access Grants al crearlos, o puede añadir etiquetas a los recursos existentes.

• Puede asociar hasta 10 etiquetas a un recurso. Si hay varias etiquetas asociadas al mismo recurso, deben tener claves de etiquetas únicas.

• Una clave de etiqueta puede tener una longitud de hasta 128 caracteres Unicode y los valores de etiqueta pueden tener una longitud de hasta 256 caracteres Unicode. Las etiquetas se representan internamente en UTF-16. En UTF-16, los caracteres ocupan 1 o 2 posiciones de caracteres.

• Las claves y los valores distinguen entre mayúsculas y minúsculas.

Para obtener más información sobre las restricciones de las etiquetas, consulte Restricciones de las etiquetas definidas por el usuario en la Guía del usuario de AWS Billing.

Puede etiquetar los recursos en S3 Access Grants mediante la AWS Command Line Interface (AWS CLI), la API de REST de Amazon S3 o los SDK de AWS.

Uso de la AWS CLI

Para instalar AWS CLI, consulte Instalación de AWS CLI en la Guía del usuario de AWS Command Line Interface.

Puede etiquetar un recurso de S3 Access Grants al crearlo o bien después de crearlo. En los siguientes ejemplos se muestra cómo etiquetar o quitar etiquetas de una instancia de S3 Access Grants. Puede realizar operaciones similares para las ubicaciones registradas y las concesiones de acceso.

Para utilizar los comandos de ejemplo siguientes, sustituya user input placeholders con su información.

ejemplo — Crear una instancia de S3 Access Grants con etiquetas

aws s3control create-access-grants-instance \
 --account-id 111122223333 \
 --profile access-grants-profile \
 --region us-east-2 \
 --tags Key=tagKey1,Value=tagValue1

Respuesta:

 {
    "CreatedAt": "2023-10-25T01:09:46.719000+00:00",
    "AccessGrantsInstanceId": "default",
    "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default"
}

ejemplo — Etiquetar una instancia de S3 Access Grants ya creada

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

ejemplo — Enumerar etiquetas de la instancia de 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

Respuesta:

{
    "Tags": [
        {
            "Key": "tagKey1",
            "Value": "tagValue1"
        },
        {
            "Key": "tagKey2",
            "Value": "tagValue2"
        }
    ]
}

ejemplo — Desetiquetar la instancia de 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"

Uso de la API de REST

Puede usar la API de Amazon S3 para etiquetar, desetiquetar o mostrar las etiquetas de una instancia de S3 Access Grants, una ubicación registrada o una concesión de acceso. Para obtener información sobre la compatibilidad con la API de REST para administrar etiquetas de S3 Access Grants, consulte las siguientes secciones en la Referencia de la API de Amazon Simple Storage Service:

• TagResource

• UntagResource

• ListTagsForResource