# Adicionar um conjunto de tags por meio de um ponto de acesso para um bucket de uso geral
<a name="add-tag-set-ap"></a>

Esta seção explica como adicionar um conjunto de tags por meio de um ponto de acesso para um bucket de uso geral usando o Console de gerenciamento da AWS, a AWS Command Line Interface ou a API REST. Para obter mais informações, consulte [Categorizar objetos usando tags](object-tagging.md).

## Usar o console do S3
<a name="add-tag-set-ap-console"></a>

**Como adicionar um conjunto de tags por meio de um ponto de acesso na Conta da AWS**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Na barra de navegação na parte superior da página, escolha o nome da Região da AWS exibida no momento. Em seguida, escolha a região para a qual você deseja listar os pontos de acesso. 

1. No painel de navegação, no lado esquerdo do console, escolha **Pontos de acesso**.

1. (Opcional) Pesquise pontos de acesso pelo nome. Somente os pontos de acesso na Região da AWS selecionada aparecerão aqui.

1. Escolha o nome do ponto de acesso que você deseja gerenciar ou usar.

1. Na guia **Objetos**, selecione o nome do objeto para o qual você deseja adicionar um conjunto de tags.

1. Na guia **Propriedades**, encontre o subcabeçalho **Tags** e escolha **Editar**.

1. Revise os objetos listados e escolha **Adicionar tag**.

1. Cada tag de objeto é um par de chave-valor. Insira uma **Key (Chave)** e um **Value (Valor)**. Para adicionar outra tag, escolha **Add Tag (Adicionar tag)**.

   Você pode digitar até 10 tags para um objeto.

1. Escolha **Salvar alterações**.

## Como usar o AWS CLI
<a name="add-tag-set-ap-cli"></a>

O exemplo de comando `put-object-tagging` a seguir mostra como você pode usar a AWS CLI para adicionar um conjunto de tags por meio de um ponto de acesso.

O comando a seguir adiciona um conjunto de tags ao objeto `puppy.jpg` existente usando o ponto de acesso *my-access-point*.

```
aws s3api put-object-tagging --bucket arn:aws:s3:Região da AWS:111122223333:accesspoint/my-access-point --key puppy.jpg --tagging TagSet=[{Key="animal",Value="true"}]     
```

**nota**  
O S3 gera automaticamente aliases de ponto de acesso para todos os pontos de acesso e esses aliases podem ser usados em qualquer lugar em que um nome de bucket seja usado para realizar operações ao nível do objeto. Para obter mais informações, consulte [Alias de ponto de acesso](access-points-naming.md#access-points-alias).

Para obter mais informações e exemplos, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-tagging.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object-tagging.html) na *Referência de comandos da AWS CLI*.

## Uso da API REST
<a name="add-tag-set-ap-rest"></a>

É possível usar a API REST para adicionar um conjunto de tags a um objeto por meio de um ponto de acesso. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html) na *Referência da API do Amazon Simple Storage Service*.