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

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

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

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
<a name="bucket-create-tag-troubleshooting"></a>

Si se produce un error al intentar crear un bucket con etiquetas, puede hacer lo siguiente: 
+ Compruebe que dispone de los [Permisos](#bucket-create-tag-permissions) 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)](tagging.md#using-tags-for-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](buckets-tagging-enable-abac.md). 

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

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.

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

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

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

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

1. Cree un bucket, un bucket de uso general, como lo haría normalmente; consulte [Creación de un bucket de uso general](create-bucket-overview.md).

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

1. Ingrese un nombre para el bucket. Para obtener más información, consulte [Reglas de nomenclatura de buckets de uso general](bucketnamingrules.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, elija **Crear bucket**. 

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

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

------

## Uso de la API de REST
<a name="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 uso general 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="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 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://{{mybucket}}s3.amazonaws.com/"
}
```