Criar buckets de uso geral com tags

É 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. Para ter mais informações sobre marcação de buckets, consulte Usar tags com buckets de uso geral do S3.

Permissões

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

Se você encontrar um erro ao tentar criar um bucket com tags, é possível fazer o seguinte:

• Verifique se você tem as Permissões 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).

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.

Etapas

É 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

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

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

3. Escolha Criar bucket para criar um bucket.

4. Crie um bucket de uso geral como você faria normalmente; consulte Criar um bucket de uso geral.

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

6. Insira um nome para o bucket. Para obter mais informações, consulte Regras de nomenclatura de buckets de uso geral.

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

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

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

Usar SDKs da AWS

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

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

Como usar a AWS CLI

Para instalar a AWS CLI, consulte Instalar ou atualizar a versão mais recente da AWS CLI 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://mybuckets3.amazonaws.com/"
}