Criar buckets de diretórios com tags - Amazon Simple Storage Service
PermissõesSolucionar de problemas de errosEtapas

Criar buckets de diretórios com tags

Você pode marcar buckets de diretório do Amazon S3 ao criá-los. Não há cobrança adicional para usar tags em buckets de diretório 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 de diretório, consulte Usar tags com buckets de diretório do S3.

Permissões

Para criar um bucket de diretório com tags, você precisa ter as seguintes permissões:

  • s3express:CreateBucket

  • s3express:TagResource

Solucionar de problemas de erros

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

  • Verifique se você tem as Permissões necessárias para criar o bucket de diretório e adicionar uma tag a ele.

  • Confira sua política de usuário do IAM para ver se existe alguma condição de controle de acesso por atributo (ABAC). Pode ser necessário rotular seus buckets de diretório somente com chaves e valores de tag específicos. Para obter mais informações, consulte Usar tags para controle de acesso por atributo (ABAC).

Etapas

Você pode criar um bucket de diretório 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.

Para criar um bucket de diretório 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 de diretório.

  3. Escolha Criar bucket para criar um bucket de diretório.

  4. É possível criar dois tipos de bucket de diretório:

    Criar um bucket de diretório em uma zona de disponibilidade para uma workload de alto desempenho. Para obter mais informações, consulte Workloads de alto desempenho.

    Criar um bucket de diretório em uma zona local para uma workload de residência de dados. Para obter mais informações, consulte Workloads de residência de dados.

  5. Para ambos os tipos de bucket de diretório, a opção Tags está presente na página Criar bucket ao criar um bucket de diretório.

  6. Insira um nome para o bucket. Para obter mais informações, consulte .

  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 de diretório, escolha Criar bucket.

SDK for Java 2.x

Este exemplo mostra como criar um bucket de diretório 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.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 ter informações sobre a compatibilidade da API REST do Amazon S3 para criar um bucket de diretório com tags, consulte a seguinte seção na “Referência de API do Amazon Simple Storage Service”:

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 de diretório com tags usando o 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 de diretório, você deve fornecer detalhes de configuração e usar a seguinte convenção de nomenclatura: bucket-base-name--zone-id--x-s3.

Solicitação:

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}]"

Resposta:

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