Visualizar tags de bucket - Amazon Simple Storage Service
PermissõesSolucionar de problemas de errosEtapas

Visualizar tags de bucket

É possível visualizar ou listar tags aplicadas aos buckets do S3. Para obter mais informações sobre tags, consulte Usar tags com buckets de uso geral do S3.

Permissões

Para adicionar as tags aplicadas a um bucket, é necessário ter a seguinte permissão:

  • s3:ListTagsForResource

Solucionar de problemas de erros

Se você encontrar um erro ao tentar listar ou visualizar as tags de um bucket, é possível fazer o seguinte:

  • Verifique se você tem as Permissões necessárias para visualizar ou listar as tags do bucket.

Etapas

É possível visualizar as tags aplicadas a buckets usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 e SDKs da AWS.

Para visualizar as tags aplicadas a um bucket 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 Buckets.

  3. Escolha o nome do bucket.

  4. Escolha a guia Properties (Propriedades).

  5. Role até a seção Tags para visualizar todas as tags aplicadas ao bucket de uso geral.

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

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

SDK for Java 2.x

Este exemplo mostra como visualizar as tags aplicadas a um bucket de uso geral 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::s3:::bucket/my-bucket")
                .accountId("111122223333")
                .build();

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

Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para visualizar as tags aplicadas a um bucket de uso geral, consulte a seguinte seção na Referência de API do Amazon Simple Storage Service:

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 de CLI a seguir mostra como visualizar as tags aplicadas a um bucket. 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::s3: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": []
}