# Criar pontos de acesso com tags
<a name="access-points-create-tag"></a>

Você pode atribuir tags a pontos de acesso ao criá-los. Não há cobrança adicional para usar tags em pontos de acesso 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 como atribuir tags a pontos de acesso, consulte [Usar tags com pontos de acesso para buckets de uso geral do S3](access-points-tagging.md).

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

Para criar um ponto de acesso com tags, você precisa ter as seguintes permissões:
+ `s3:CreateBucket`
+ `s3:TagResource`

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

Se você encontrar um erro ao tentar criar um ponto de acesso com tags, é possível fazer o seguinte: 
+ Verifique se você tem as [Permissões](#access-points-create-tag-permissions) necessárias para criar o ponto de acesso 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 somente com chaves e valores de tag específicos. Para ter mais informações, consulte [Usar tags para controle de acesso por atributo (ABAC)](tagging.md#using-tags-for-abac).

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

Você pode criar um ponto de acesso 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="access-points-create-tag-console"></a>

Para criar um ponto de acesso 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 **Pontos de acesso (buckets de uso geral)**.

1. Escolha **Criar ponto de acesso** para criar um ponto de acesso.

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

1. Insira um nome para o ponto de acesso. Para ter mais informações, consulte [Regras de nomenclatura, restrições e limitações dos pontos de acesso](access-points-restrictions-limitations-naming-rules.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. Depois de concluir a especificação das opções para seu novo ponto de acesso, escolha **Criar ponto de acesso**. 

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

------
#### [ 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)
                .tags(Collections.singletonList(Tag.builder().key("key1").value("value1").build()))
                .build();
 awss3Control.createAccessPoint(createAccessPointRequest);
```

------

## Uso da API REST
<a name="access-points-tag-delete-api"></a>

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

## Como usar o AWS CLI
<a name="access-points-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 ponto de acesso 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.

**Solicitação:**

```
aws s3control create-access-point --name my-access-point \
--bucket amzn-s3-demo-bucket \
--account-id 111122223333 \ --profile personal \
--tags [{Key=key1,Value=value1},{Key=key2,Value=value2}] \
--region region
```