# Criar buckets de uso geral com tags
<a name="bucket-create-tag"></a>

É possível marcar buckets de uso geral do Amazon S3 ao criá-los. Não há cobrança adicional para usar tags em buckets além das taxas de solicitação padrão da API do S3. Para obter mais informações, consulte [Preço do Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Para ter mais informações sobre marcação de buckets, consulte [Usar tags com buckets de uso geral do S3](buckets-tagging.md).

## Permissões
<a name="bucket-create-tag-permissions"></a>

Para criar um bucket com tags, é necessário ter as seguintes permissões:
+ `s3:CreateBucket`
+ `s3:TagResource`

Agora o console do Amazon S3 e o CloudFormation usam esse recurso para criar buckets com tags.

## Solucionar de problemas de erros
<a name="bucket-create-tag-troubleshooting"></a>

Se você encontrar um erro ao tentar criar um bucket com tags, é possível fazer o seguinte: 
+ Verifique se você tem as [Permissões](#bucket-create-tag-permissions) necessárias para criar o bucket e adicionar uma tag a ele.
+ Verifique sua política do IAM para `aws:TagKeys` ou as chaves de condição `aws:RequestTag/key-name`. Pode ser necessário rotular os buckets somente com chaves e valores de tag específicos. Para obter mais informações, consulte [Usar tags para controle de acesso por atributo (ABAC)](tagging.md#using-tags-for-abac).

**nota**  
Agora o Amazon S3 e o CloudFormation usam esse recurso para criar buckets com tags. Ao criar um bucket com tags, observe que as condições baseadas em tags para acessar o bucket usando as chaves de condição `aws:ResourceTag` e `s3:BucketTag` são aplicáveis somente após a habilitação do ABAC no bucket. Para saber mais, consulte [Habilitar o ABAC em buckets de uso geral](buckets-tagging-enable-abac.md). 

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

É possível criar um bucket com tags aplicadas usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 e SDKs da AWS.

## Usar o console do S3
<a name="bucket-create-tag-console"></a>

Para criar um bucket com tags usando o console do Amazon S3:

1. Faça login no console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets**.

1. Escolha **Criar bucket** para criar um bucket.

1. Crie um bucket de uso geral como você faria normalmente; consulte [Criar um bucket de uso geral](create-bucket-overview.md).

1. Na página **Criar bucket**, **Tags** é uma opção ao criar um bucket.

1. Insira um nome para o bucket. Para obter mais informações, consulte [Regras de nomenclatura de buckets de uso geral](bucketnamingrules.md). 

1. Escolha **Adicionar nova tag** para abrir o editor de tags e inserir um par de chave-valor de tag. A chave de tag é necessária, mas o valor é opcional. 

1. Para adicionar outra tag, selecione novamente **Adicionar nova tag**. É possível adicionar até cinquenta pares de chave-valor de tag.

1. Ao concluir a especificação das opções para seu novo bucket, escolha **Criar bucket**. 

## Usar SDKs da AWS
<a name="bucket-create-tag-sdks"></a>

------
#### [ SDK for Java 2.x ]

Este exemplo mostra como criar um bucket de uso geral com tags usando o AWS SDK for Java 2.x. Para usar o comando, substitua os {{espaços reservados para entrada do usuário}} por suas próprias informações. 

```
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 da API REST
<a name="bucket-tag-delete-api"></a>

Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para criar um bucket de uso geral com tags, consulte a seguinte seção na *Referência de API do Amazon Simple Storage Service*:
+ [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)

## Como usar a AWS CLI
<a name="bucket-create-tag-cli"></a>

Para instalar a AWS CLI, consulte [Instalar ou atualizar a versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia do usuário da versão 2 da AWS Command Line Interface*.

O exemplo da CLI a seguir mostra como criar um bucket com tags usando a AWS CLI. Para usar o comando, substitua os {{espaços reservados para entrada do usuário}} por suas próprias informações.

Ao criar um bucket, você deve fornecer detalhes de configuração e usar a seguinte convenção de nomenclatura: `{{amzn-s3-demo-bucket}}`.

**Solicitação:**

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

**Resposta:**

```
{
  "Location": "http://{{mybucket}}s3.amazonaws.com/"
}
```