Creación de buckets de uso general con etiquetas - Amazon Simple Storage Service
PermisosSolución de erroresSteps

Creación de buckets de uso general con etiquetas

Puede etiquetar buckets de uso general de Amazon S3 al crearlos. 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 crear un bucket con etiquetas, debe contar con los siguientes permisos:

  • s3:CreateBucket

  • s3:TagResource

La consola de Amazon S3 y CloudFormation ahora utilizan esta capacidad para crear buckets con etiquetas.

Solución de errores

Si se produce un error al intentar crear un bucket con etiquetas, puede hacer lo siguiente:

  • Compruebe que dispone de los Permisos necesarios para crear el bucket y agregarle una etiqueta.

  • Consulte la política de IAM para ver las aws:TagKeys o las claves de condición de aws:RequestTag/key-name. Es posible que deba etiquetar los buckets solo con claves y valores de etiqueta específicos. Para obtener más información, consulte Uso de etiquetas para el control de acceso basado en atributos (ABAC).

nota

Amazon S3 y CloudFormation ahora utilizan esta capacidad para crear buckets con etiquetas. Al crear buckets con etiquetas, tenga en cuenta que las condiciones basadas en etiquetas para acceder al bucket mediante las claves de condición aws:ResourceTag y s3:BucketTag solo se aplican después de habilitar ABAC en el bucket. Para obtener más información, consulte Habilitación de ABAC en buckets de uso general.

Steps

Puede crear un bucket con etiquetas aplicadas mediante la consola de Amazon S3, la AWS Command Line Interface (AWS CLI), la API de REST de Amazon S3 y los AWS SDK.

Para crear un bucket con etiquetas mediante 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 Crear bucket para crear un bucket nuevo.

  4. Cree un bucket, un bucket de uso general, como lo haría normalmente; consulte Creación de un bucket de uso general.

  5. En la página Crear bucket, Etiquetas es una opción al crear un nuevo bucket.

  6. Ingrese un nombre para el bucket. Para obtener más información, consulte Reglas de nomenclatura de buckets de uso general.

  7. Elija Agregar nueva etiqueta para abrir el editor de etiquetas e ingresar un par clave-valor de etiqueta. Se requiere la clave de la etiqueta, pero el valor es opcional.

  8. Para agregar otra etiqueta, vuelva a seleccionar Agregar nueva etiqueta. Puede ingresar hasta 50 pares de clave-valor de etiquetas.

  9. Cuando haya terminado de especificar las opciones para el nuevo bucket, elija Crear bucket.

SDK for Java 2.x

En este ejemplo se muestra cómo crear un bucket de uso general con etiquetas 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.s3.S3Client;
import software.amazon.awssdk.services.s3.model.BucketLocationConstraint;
import software.amazon.awssdk.services.s3.model.CreateBucketConfiguration;
import software.amazon.awssdk.services.s3.model.CreateBucketRequest;
import software.amazon.awssdk.services.s3.model.CreateBucketResponse;
import software.amazon.awssdk.services.s3.model.Tag;

public class CreateBucketWithTagsExample {
    public static void createBucketWithTagsExample() {
        S3Client s3 = S3Client.builder().region(Region.US_WEST_2).build();

        CreateBucketConfiguration bucketConfiguration = CreateBucketConfiguration.builder()
                .locationConstraint(BucketLocationConstraint.US_WEST_2)
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();

        CreateBucketRequest createBucketRequest = CreateBucketRequest.builder()
                .bucket("mybucket")
                .createBucketConfiguration(bucketConfiguration)
                .build();

        CreateBucketResponse response = s3.createBucket(createBucketRequest);
        System.out.println("Status code (should be 200):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}

Para obtener información sobre la compatibilidad con la API de REST de Amazon S3 para crear un bucket de uso general con etiquetas, 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 crear un bucket con etiquetas mediante la AWS CLI. Para usar el comando, sustituya los marcadores de posición de entrada del usuario con su propia información.

Al crear un bucket, debe proporcionar los detalles de configuración y utilizar la siguiente convención de nomenclatura: amzn-s3-demo-bucket

Solicitud:

aws s3api create-bucket \
--bucket mybucket \
--create-bucket-configuration 'LocationConstraint=us-west-2,Tags=[{Key=MyTagKey,Value=MyTagValue}]' --region us-west-2"

Response: (Respuesta:

{
  "Location": "http://mybuckets3.amazonaws.com/"
}