# Creación de buckets de directorio con etiquetas
<a name="directory-bucket-create-tag"></a>

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](https://docs.aws.amazon.com/s3/pricing/). Para obtener más información acerca del etiquetado de buckets de directorio, consulte [Uso de etiquetas con buckets de directorio de S3](directory-buckets-tagging.md).

## Permisos
<a name="create-tag-permissions"></a>

Para crear un bucket de directorio con etiquetas, debe contar con los siguientes permisos:
+ `s3express:CreateBucket`
+ `s3express:TagResource`

## Solución de errores
<a name="create-tag-troubleshooting"></a>

Si se produce un error al intentar crear un bucket de directorio con etiquetas, puede hacer lo siguiente: 
+ Compruebe que dispone de los [Permisos](#create-tag-permissions) necesarios para crear el bucket de directorio y agregarle una etiqueta.
+ Compruebe la política de usuario de IAM para ver si hay condiciones 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)](tagging.md#using-tags-for-abac).

## Steps
<a name="create-tag-steps"></a>

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.

## Uso de la consola de S3
<a name="directory-bucket-create-tag-console"></a>

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/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Buckets de directorio**.

1. Elija **Crear bucket** para crear un nuevo bucket de directorio.

1. 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](directory-bucket-high-performance.md). 

   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](directory-bucket-data-residency.md).

1. 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.

1. Ingrese un nombre para el bucket. Para obtener más información, consulte [Reglas de nomenclatura de buckets de directorio](directory-bucket-naming-rules.md). 

1. 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. 

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

1. Cuando haya terminado de especificar las opciones para el nuevo bucket de directorio, elija **Crear bucket**. 

## Uso de los AWS SDK
<a name="directory-bucket-create-tag-sdks"></a>

------
#### [ 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());
    }
}
```

------

## Uso de la API de REST
<a name="directory-bucket-tag-delete-api"></a>

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*:
+ [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)

## Uso de AWS CLI
<a name="directory-bucket-create-tag-cli"></a>

Para instalar la CLI de AWS, consulte [Instalación de la CLI de AWS](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) en la *Guía del usuario de AWS Command Line Interface*.

En el siguiente ejemplo de la CLI se 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}]"
```

**Response: (Respuesta:**

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