Creación de buckets de directorio con etiquetas - Amazon Simple Storage Service
PermisosSolución de erroresPasos

Creación de buckets de directorio con etiquetas

Puede etiquetar buckets de directorio de Amazon S3 al crearlos. No se aplican cargos adicionales por el uso de etiquetas en buckets de directorio 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 acerca del etiquetado de buckets de directorio, consulte Uso de etiquetas con buckets de directorio de S3.

Permisos

Para crear un bucket de directorio con etiquetas, debe contar con los siguientes permisos:

  • s3express:CreateBucket

  • s3express:TagResource

Solución de errores

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

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

  • Compruebe su política de usuario de IAM para ver si hay alguna condición de control de acceso basado en atributos (ABAC). Es posible que deba etiquetar los buckets del directorio 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).

Pasos

Puede crear un bucket de directorio 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 SDK de AWS.

Creación de un bucket de directorio 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 de directorio.

  3. Elija Crear bucket para crear un nuevo bucket de directorio.

  4. Puede crear dos tipos de buckets de directorio:

    Cree un bucket de directorio en una zona de disponibilidad para una carga de trabajo de alto rendimiento. Para obtener más información, consulte Cargas de trabajo de alto rendimiento.

    Cree un bucket de directorio en una zona local para una carga de trabajo de residencia de datos. Para obtener más información, consulte Cargas de trabajo de residencia de datos.

  5. Para ambos tipos de buckets de directorio, en la página Crear bucket, Etiquetas es una opción al crear un nuevo bucket de directorio.

  6. Ingrese un nombre para el bucket. Para obtener más información, consulte .

  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 de directorio, elija Crear bucket.

SDK for Java 2.x

En este ejemplo se muestra cómo crear un bucket de directorio 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.BucketInfo;
import software.amazon.awssdk.services.s3.model.BucketType;
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.DataRedundancy;
import software.amazon.awssdk.services.s3.model.LocationInfo;
import software.amazon.awssdk.services.s3.model.LocationType;
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()
                .location(LocationInfo.builder()
                        .type(LocationType.AVAILABILITY_ZONE)
                        .name("usw2-az1").build())
                .bucket(BucketInfo.builder()
                        .type(BucketType.DIRECTORY)
                        .dataRedundancy(DataRedundancy.SINGLE_AVAILABILITY_ZONE)
                        .build())
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();

        CreateBucketRequest createBucketRequest = CreateBucketRequest.builder()
                .bucket("amzn-s3-demo-bucket--usw2-az1--x-s3--usw2-az1--x-s3")
                .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 directorio 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.

El ejemplo de la CLI siguiente muestra cómo crear un bucket de directorio 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 de directorio, debe proporcionar los detalles de configuración y utilizar la siguiente convención de nomenclatura: bucket-base-name--zone-id--x-s3

Solicitud:

aws s3api create-bucket \
--bucket bucket-base-name--zone-id--x-s3 \
--create-bucket-configuration "Location={Type=AvailabilityZone,Name=zone-id},Bucket={DataRedundancy=SingleAvailabilityZone,Type=Directory},Tags=[{Key=mykey1,Value=myvalue1}, {Key=mykey2,Value=myvalue2}]"

Respuesta:

{
  "Location": "http://bucket--use1-az4--x-s3.s3express-use1-az4.us-east-1.amazonaws.com/"
}