Criar pontos de acesso para buckets de diretório com tags

Você pode atribuir tags a pontos de acesso para buckets de diretório do Amazon S3 ao criá-los. Para ter informações adicionais, consulte Usar tags com o recurso Pontos de Acesso S3 para buckets de diretório.

Permissões

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

• s3express:CreateAccessPoint

• s3express:TagResource

Solucionar erros

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

• Verifique se você tem as Permissões necessárias para criar o ponto de acesso para buckets 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 os pontos de acesso para 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 ponto de acesso para buckets 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.

Uso do console do S3

Para criar um ponto de acesso para buckets 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 Pontos de acesso (buckets de diretório).

3. Escolha Criar ponto de acesso para criar um ponto de acesso.

4. Insira um nome para o ponto de acesso. Para obter mais informações, consulte Regras de nomenclatura, restrições e limitações dos pontos de acesso para buckets de diretório.

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

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

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

8. Depois de concluir a especificação das opções para seu novo ponto de acesso, escolha Criar ponto de acesso.

Uso da SDKs AWS

SDK for Java 2.x

Este exemplo mostra como criar um ponto de acesso 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.

CreateAccessPointRequest createAccessPointRequest = CreateAccessPointRequest.builder()
                .accountId(111122223333)
                .name(my-access-point)
                .bucket(amzn-s3-demo-bucket--zone-id--x-s3)
                .tags(Collections.singletonList(Tag.builder().key("key1").value("value1").build()))
                .build();
 awss3Control.createAccessPoint(createAccessPointRequest);

Uso dos REST API

Para ter informações sobre a compatibilidade oferecida pela 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:

• 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 ponto de acesso para buckets de diretório 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 ponto de acesso para buckets de diretório, você deve fornecer detalhes de configuração e usar a seguinte convenção de nomenclatura: my-access-point.

Solicitação:

aws s3control create-access-point \
--account-id 111122223333 \ 
--name my-access-point \
--bucket amzn-s3-demo-bucket--zone-id--x-s3 \
--profile personal \
--tags Key=key1,Value=value1 Key=MyKey2,Value=value2 \
--region region