# Visualizar tags de buckets de diretório


É possível visualizar ou listar tags aplicadas aos buckets de diretório do S3. Para obter mais informações sobre tags, consulte [Usar tags com buckets de diretório do S3](directory-buckets-tagging.md).

## Permissões


Para adicionar as tags aplicadas a um bucket de diretório, você precisa ter a seguinte permissão: 
+ `s3express:ListTagsForResource`

## Solucionar de problemas de erros


Se você encontrar um erro ao tentar listar ou visualizar as tags de um bucket de diretório, é possível fazer o seguinte: 
+ Verifique se você tem as [Permissões](#tag-view-permissions) necessárias para visualizar ou listar as tags do bucket de diretório.

## Etapas


Você pode visualizar tags aplicadas a buckets de diretório usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 e os SDKs da AWS.

## Usar o console do S3


Para visualizar as tags aplicadas a um bucket de diretório 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 **Buckets de diretório**.

1. Escolha o nome do bucket. 

1. Escolha a guia **Properties (Propriedades)**. 

1. Role até a seção **Tags** para visualizar todas as tags aplicadas ao bucket de diretório. 

1. Por padrão, a seção **Tags** mostra as **tags definidas elo usuário**. Você pode selecionar a guia **Tags geradas pela AWS** para visualizar as tags aplicadas pelos serviços da AWS ao seu bucket de diretório.

## Usar SDKs da AWS


Esta seção oferece um exemplo de como visualizar tags aplicadas a um bucket de diretório usando os SDKs da AWS.

------
#### [ SDK for Java 2.x ]

Este exemplo mostra como visualizar as tags aplicadas a um bucket de diretório usando o AWS SDK for Java 2.x. 

```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceRequest;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceResponse;

public class ListTagsForResourceExample {
    public static void listTagsForResourceExample() {
        S3ControlClient s3Control = S3ControlClient.builder().region(Region.US_WEST_2).build();

        ListTagsForResourceRequest listTagsForResourceRequest = ListTagsForResourceRequest.builder()
                .resourceArn("arn:aws::s3express:us-west-2:111122223333:bucket/my-directory-bucket--usw2-az1--x-s3")
                .accountId("111122223333")
                .build();

        ListTagsForResourceResponse response = s3Control.listTagsForResource(listTagsForResourceRequest);
        System.out.println("Tags on my resource:");
        System.out.println(response.toString());
    }
}
```

------

## Uso da API REST


Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para visualizar as tags aplicadas a um bucket de diretório, consulte a seguinte seção na *Referência de API do Amazon Simple Storage Service*:
+ [ListTagsforResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html)

## Como usar o AWS CLI


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 de CLI a seguir mostra como visualizar as tags aplicadas a um bucket de diretório. Para usar o comando, substitua os *espaços reservados para entrada do usuário* por suas próprias informações.

**Solicitação:**

```
aws s3control list-tags-for-resource \
--account-id 111122223333 \
--resource-arn arn:aws::s3express:us-east-1:444455556666:bucket/prefix--use1-az4--x-s3 \
```

**Resposta: tags presentes:**

```
{
  "Tags": [
      {
          "Key": "MyKey1",
          "Value": "MyValue1"
      },
      {
          "Key": "MyKey2",
          "Value": "MyValue2"
      },
      {
          "Key": "MyKey3",
          "Value": "MyValue3"
      }
  ]
}
```

**Resposta: nenhuma tag presente:**

```
{
  "Tags": []
}
```