# Gerenciar tags para o recurso Concessão de Acesso do S3
As etiquetas na funcionalidade Concessões de Acesso do Amazon S3 têm características semelhantes às [etiquetas de objeto](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) no Amazon S3. Cada tag é um par de chave/valor. Os recursos na funcionalidade Concessões de Acesso do S3 que você pode marcar são [instâncias](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-instance.html), [locais](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-location.html) e [concessões](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-grant.html) da funcionalidade Concessões de Acesso do S3.
**nota**
A marcação na funcionalidade Concessões de Acesso do S3 usa operações de API diferentes da marcação de objetos. A funcionalidade Concessão de Acesso do S3 usa as operações de API [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html) e [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html), em que um recurso pode ser uma instância, um local registrado ou uma concessão de acesso da funcionalidade Concessão de Acesso do S3.
Semelhante às [etiquetas de objeto](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html), as seguintes limitações se aplicam:
+ Você pode adicionar etiquetas a novos recursos da funcionalidade Concessões de Acesso do S3 ao criá-los, ou pode adicionar etiquetas a recursos existentes.
+ Você pode associar até 10 etiquetas a um recurso. Se várias etiquetas estiverem associadas ao mesmo recurso, elas deverão ter chaves de etiqueta exclusivas.
+ Um chave de tag pode ter até 128 caracteres Unicode e os valores de tag podem ter até 256 caracteres Unicode. As etiquetas são representadas internamente em UTF-16. Em UTF-16, os caracteres utilizam posições de um ou de dois caracteres.
+ As chaves e os valores diferenciam letras maiúsculas de minúsculas.
Para obter mais informações sobre restrições de etiquetas, consulte [Restrições de tags definidas pelo usuário](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html) no *Guia do usuário do AWS Billing*.
Você pode marcar recursos na funcionalidade Concessões de Acesso do S3 usando a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 ou os AWS SDKs.
## Como usar o AWS CLI
Para instalar a AWS CLI, consulte [Instalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia do usuário da AWS Command Line Interface*.
Você pode marcar um recurso da funcionalidade Concessões de Acesso do S3 durante a criação ou depois de criá-lo. Os exemplos a seguir mostram como marcar ou desmarcar uma instância da funcionalidade Concessões de Acesso do S3. Você pode realizar operações semelhantes para locais registrados e concessões de acesso.
Para usar os comandos a seguir, substitua os `user input placeholders` por suas próprias informações.
**Example : criar uma instância da funcionalidade Concessões de Acesso do S3**
```
aws s3control create-access-grants-instance \
--account-id 111122223333 \
--profile access-grants-profile \
--region us-east-2 \
--tags Key=tagKey1,Value=tagValue1
```
Resposta:
```
{
"CreatedAt": "2023-10-25T01:09:46.719000+00:00",
"AccessGrantsInstanceId": "default",
"AccessGrantsInstanceArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default"
}
```
**Example : marcar uma instância já criada da funcionalidade Concessões de Acesso do S3**
```
aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2 \
--tags Key=tagKey2,Value=tagValue2
```
**Example : listar as etiquetas da instância da funcionalidade Concessões de Acesso do S3**
```
aws s3control list-tags-for-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2
```
Resposta:
```
{
"Tags": [
{
"Key": "tagKey1",
"Value": "tagValue1"
},
{
"Key": "tagKey2",
"Value": "tagValue2"
}
]
}
```
**Example : desmarcar a instância da funcionalidade Concessões de Acesso do S3**
```
aws s3control untag-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2 \
--tag-keys "tagKey2"
```
## Uso da API REST
Você pode usar a API do Amazon S3 para marcar, desmarcar ou listar as etiquetas de uma instância, um local registrado ou uma concessão de acesso da funcionalidade Concessões de Acesso do S3. Para obter informações sobre o suporte à API REST para gerenciar a funcionalidade Concessões de Acesso do S3, consulte as seguintes seções na *Referência da API do Amazon Simple Storage Service*:
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html)