Agregación de una etiqueta a un bucket - Amazon Simple Storage Service
PermisosSolución de erroresSteps

Agregación de una etiqueta a un bucket

Puede agregar etiquetas a los buckets de Amazon S3 y modificar estas etiquetas. No se aplican cargos adicionales por el uso de etiquetas en buckets más allá de las tarifas estándar de solicitud de API de S3. Para obtener más información, consulte Precios de Amazon S3. Para obtener más información sobre el etiquetado de buckets, consulte Uso de etiquetas con buckets de uso general de S3.

Permisos

Para agregar una etiqueta a un bucket, debe contar con el siguiente permiso:

  • s3:TagResource

Solución de errores

Si se produce un error al intentar agregar una etiqueta a un bucket, puede hacer lo siguiente:

  • Compruebe que dispone de los Permisos necesarios para agregar una etiqueta a un bucket.

  • Si ha intentado agregar una clave de etiqueta que comience con el prefijo reservado de AWS aws:, cámbiela e inténtelo de nuevo.

Steps

Puede agregar etiquetas a buckets mediante la consola de Amazon S3, la interfaz de la línea de comandos (CLI) de AWS (CLI de AWS), la API de REST de Amazon S3 y los AWS SDK.

Para agregar etiquetas a un bucket con la consola de Amazon S3:

  1. Inicie sesión en la consola de Amazon S3 en https://console.aws.amazon.com/s3/.

  2. En el panel de navegación izquierdo, elija Buckets.

  3. Elija el nombre del bucket.

  4. Elija la pestaña Propiedades.

  5. Desplácese hasta la sección Etiquetas y elija Agregar nueva etiqueta.

  6. Esto abre la página Agregar etiquetas. Puede ingresar hasta 50 pares de clave valor de etiquetas.

  7. Si agrega una nueva etiqueta con el mismo nombre de clave que una etiqueta existente, el valor de la nueva etiqueta invalida el valor de la etiqueta existente.

  8. Puede editar también los valores de las etiquetas existentes en esta página.

  9. Una vez que haya agregado las etiquetas, elija Guardar cambios.

SDK for Java 2.x

En este ejemplo se muestra cómo agregar etiquetas a un bucket de uso general mediante AWS SDK for Java 2.x. Para usar el comando, sustituya los marcadores de posición de entrada del usuario con su propia información. 

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;
import software.amazon.awssdk.services.s3control.model.TagResourceResponse;

public class TagResourceExample {
    public static void tagResourceExample() {
        S3ControlClient s3Control = S3ControlClient.builder().region(Region.US_WEST_2).build();

        TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                .resourceArn("arn:aws::s3:::bucket/my-bucket")
                .accountId("111122223333")
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();

        TagResourceResponse response = s3Control.tagResource(tagResourceRequest);
        System.out.println("Status code (should be 204):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}

Para obtener información sobre la compatibilidad con la API de REST de Amazon S3 para agregar etiquetas a un bucket de uso general, consulte la siguiente sección en la Referencia de la API de Amazon Simple Storage Service:

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

En el ejemplo de la CLI siguiente, se muestra cómo agregar etiquetas a un bucket de uso general mediante la AWS CLI. Para usar el comando, sustituya los marcadores de posición de entrada del usuario con su propia información.

Solicitud:

aws s3control tag-resource --resource-arn arn:aws:s3:::amzn-s3-demo-bucket --region us-east-2 --account-id 444455556666 --tags '[{"Key":"mykey","Value":"myvalue"}]'