# Usar tags com buckets de diretório do S3 Uma tag da AWS é um par de chave-valor que contém metadados sobre recursos, neste caso buckets de diretório do Amazon S3. Você pode marcar buckets de diretório do S3 ao criá-los ou gerenciar tags em buckets de diretório existentes. Para ter informações gerais sobre tags, consulte [Atribuir tags para alocação de custos ou controle de acesso por atributo (ABAC)](tagging.md). **nota** Não há cobrança adicional para usar tags em buckets de diretório 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://aws.amazon.com/s3/pricing/). ## Maneiras comuns de usar tags com buckets de diretório Use tags em buckets de diretório do S3 para: 1. **Alocação de custos**: acompanhe os custos de armazenamento por tag de bucket no Gerenciamento de Faturamento e Custos da AWS. Para ter mais informações, consulte [Usar tags para alocação de custos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/tagging.html#using-tags-for-cost-allocation). 1. **Controle de acesso por atributo (ABAC)**: amplie as permissões de acesso e conceda acesso aos buckets de diretório do S3 com base nas respectivas tags. Para ter mais informações, consulte [Using tags for ABAC](https://docs.aws.amazon.com/AmazonS3/latest/userguide/tagging.html#using-tags-for-abac). **nota** Você pode usar as mesmas tags para alocação de custos e controle de acesso. ### ABAC para buckets de diretório do S3 Os buckets de diretório do Amazon S3 permitem o controle de acesso por atributo (ABAC) por meio de tags. Use chaves de condição baseadas em tags em políticas de bucket de diretório do S3, de suas organizações na AWS e do IAM. Para empresas, o ABAC no Amazon S3 permite a autorização em várias contas da AWS. Nas suas políticas do IAM, você pode controlar o acesso aos buckets de diretório do S3 com base nas tags do bucket usando as seguintes [chaves de condição globais](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-tagkeys): + `aws:ResourceTag/key-name` + Use essa chave para comparar o par chave-valor da etiqueta especificado na política com o par chave-valor anexado ao recurso. Por exemplo, é possível exigir que o acesso a um recurso seja permitido somente se o recurso tiver a chave de tag `Dept` anexada com o valor `Marketing`. Para obter mais informações, consulte [Controle de acesso aos recursos do AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources). + `aws:RequestTag/key-name` + Use essa chave para comparar o par de chave/valor da tag que foi passado na solicitação com o par de tags especificado na política. Por exemplo, é possível verificar se a solicitação inclui a chave de tag `Dept` e se ela tem o valor `Accounting`. Para ter mais informações, consulte [Controlar o acesso durante solicitações da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-requests). Você pode usar essa chave de condição para restringir quais pares de chave-valor de tag podem ser transmitidos durante as operações de API `TagResource` e `CreateBucket`. + `aws:TagKeys` + Use essa chave para comparar as chaves de tag em uma solicitação com as chaves especificadas na política. Ao usar políticas para controlar o acesso usando etiquetas, recomendamos o uso da chave de condição `aws:TagKeys` para definir quais chaves de etiquetas serão permitidas. Para ver exemplos de política e ter mais informações, consulte [Controlar o acesso com base em chaves de tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys). Você pode criar um bucket de diretório do S3 com tags. Para permitir a marcação durante a operação de API `CreateBucket`, você deve criar uma política que inclua as ações `s3express:TagResource` e `s3express:CreateBucket`. Em seguida, você pode usar a chave de condição `aws:TagKeys` para impor o uso de tags específicas na solicitação `CreateBucket`. + `s3express:BucketTag/tag-key` + Use essa chave de condição para conceder permissões a dados específicos em buckets de diretório por meio de tags. Quando se usa um ponto de acesso para acessar um bucket de diretório, essa chave de condição faz referência às tags no bucket de diretório ao conceder permissões referentes ao ponto de acesso e ao bucket de diretório, enquanto `aws:ResourceTag/tag-key` faz referência apenas às tags do recurso ao qual está sendo concedida uma permissão. ### Exemplos de política de ABAC para buckets de diretório Veja os exemplos de política de ABAC a seguir para buckets de diretório do Amazon S3. #### 1.1 Política do IAM para criar ou modificar buckets com tags específicas Nessa política do IAM, usuários ou perfis com essa política só podem criar buckets de diretório do S3 se marcarem o bucket com a chave de tag `project` e o valor de tag `Trinity` na solicitação de criação do bucket. Eles também podem adicionar ou modificar tags em buckets de diretório existentes do S3, desde que a solicitação `TagResource` inclua o par de chave-valor de tag `project:Trinity`. Essa política não concede permissões de leitura, gravação ou exclusão nos buckets ou nos respectivos objetos. ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "CreateBucketWithTags", "Effect": "Allow", "Action": [ "s3express:CreateBucket", "s3express:TagResource" ], "Resource": "*", "Condition": { "StringEquals": { "aws:RequestTag/project": [ "Trinity" ] } } } ] } ``` #### 1.2 Política de bucket para restringir operações no bucket por meio de tags Nessa política de bucket, as entidades principais do IAM (usuários e perfis) podem executar operações usando a ação `CreateSession` no bucket somente se o valor da tag `project` do bucket corresponder ao valor da tag `project` da entidade principal. ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowObjectOperations", "Effect": "Allow", "Principal": { "AWS": "111122223333" }, "Action": "s3express:CreateSession", "Resource": "arn:aws::s3express:us-west-2:111122223333:bucket/amzn-s3-demo-bucket--usw2-az1--x-s3", "Condition": { "StringEquals": { "aws:ResourceTag/project": "${aws:PrincipalTag/project}" } } } ] } ``` #### 1.3 Política do IAM para modificar tags em recursos existentes, mantendo a governança de marcação Nessa política do IAM, as entidades principais do IAM (usuários e perfis) podem modificar tags em um bucket somente se o valor da tag `project` do bucket corresponder ao valor da tag `project` da entidade principal. Somente as quatro tags (`project`, `environment`, `owner` e `cost-center`) especificadas nas chaves de condição `aws:TagKeys` são permitidas para esses buckets de diretório. Isso ajuda a impor a governança de tags, evita modificações não autorizadas nas tags e mantém o esquema de marcação consistente em todos os seus buckets. ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "EnforceTaggingRulesOnModification", "Effect": "Allow", "Action": [ "s3express:TagResource" ], "Resource": "arn:aws::s3express:us-west-2:111122223333:bucket/*", "Condition": { "StringEquals": { "aws:ResourceTag/project": "${aws:PrincipalTag/project}" }, "ForAllValues:StringEquals": { "aws:TagKeys": [ "project", "environment", "owner", "cost-center" ] } } } ] } ``` #### 1.4 Uso da chave de condição s3express:BucketTag Nesta política do IAM, a instrução de condição permitirá acesso aos dados do bucket somente se o bucket tiver a chave de tag `Environment` e o valor de tag `Production`. ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowAccessToSpecificAccessPoint", "Effect": "Allow", "Action": "*", "Resource": "arn:aws::s3express:us-west-2:111122223333:accesspoint/*", "Condition": { "StringEquals": { "s3express:BucketTag/Environment": "Production" } } } ] } ``` ## Gerenciar tags para buckets de diretório Você pode adicionar ou gerenciar tags para buckets de diretório do S3 usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI) e os SDKs da AWS ou as APIs [TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html), [UntagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html) e [ListTagsForResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html) do S3. Para obter mais informações, consulte: **Topics** + [Maneiras comuns de usar tags com buckets de diretório](#common-ways-to-use-tags-directory-bucket) + [Gerenciar tags para buckets de diretório](#working-with-tags) + [Criar buckets de diretórios com tags](directory-bucket-create-tag.md) + [Adicionar uma tag a um bucket de diretório](directory-bucket-tag-add.md) + [Visualizar tags de buckets de diretório](directory-bucket-tag-view.md) + [Excluir uma tag de um bucket de diretório](directory-bucket-tag-delete.md) # Criar buckets de diretórios com tags Você pode marcar buckets de diretório do Amazon S3 ao criá-los. Não há cobrança adicional para usar tags em buckets de diretório 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 marcação de buckets de diretório, consulte [Usar tags com buckets de diretório do S3](directory-buckets-tagging.md). ## Permissões Para criar um bucket de diretório com tags, você precisa ter as seguintes permissões: + `s3express:CreateBucket` + `s3express:TagResource` ## Solucionar de problemas de erros Se você encontrar um erro ao tentar criar um bucket de diretório com tags, é possível fazer o seguinte: + Verifique se você tem as [Permissões](#create-tag-permissions) necessárias para criar o bucket de diretório 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 seus buckets de diretório somente com chaves e valores de tag específicos. Para obter mais informações, consulte [Usar tags para controle de acesso por atributo (ABAC)](tagging.md#using-tags-for-abac). ## Etapas Você pode criar um bucket de diretório 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 Para criar um bucket de diretório 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 **Buckets de diretório**. 1. Escolha **Criar bucket** para criar um bucket de diretório. 1. É possível criar dois tipos de bucket de diretório: Criar um bucket de diretório em uma zona de disponibilidade para uma workload de alto desempenho. Para obter mais informações, consulte [Workloads de alto desempenho](directory-bucket-high-performance.md). Criar um bucket de diretório em uma zona local para uma workload de residência de dados. Para obter mais informações, consulte [Workloads de residência de dados](directory-bucket-data-residency.md). 1. Para ambos os tipos de bucket de diretório, a opção **Tags** está presente na página **Criar bucket** ao criar um bucket de diretório. 1. Insira um nome para o bucket. Para obter mais informações, consulte [Regras de nomenclatura de buckets de diretório](directory-bucket-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. Ao concluir a especificação das opções para seu novo bucket de diretório, escolha **Criar bucket**. ## Usar SDKs da AWS ------ #### [ SDK for Java 2.x ] Este exemplo mostra como criar um bucket de diretório 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. ``` import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3.S3Client; import software.amazon.awssdk.services.s3.model.BucketInfo; import software.amazon.awssdk.services.s3.model.BucketType; import software.amazon.awssdk.services.s3.model.CreateBucketConfiguration; import software.amazon.awssdk.services.s3.model.CreateBucketRequest; import software.amazon.awssdk.services.s3.model.CreateBucketResponse; import software.amazon.awssdk.services.s3.model.DataRedundancy; import software.amazon.awssdk.services.s3.model.LocationInfo; import software.amazon.awssdk.services.s3.model.LocationType; import software.amazon.awssdk.services.s3.model.Tag; public class CreateBucketWithTagsExample { public static void createBucketWithTagsExample() { S3Client s3 = S3Client.builder().region(Region.US_WEST_2).build(); CreateBucketConfiguration bucketConfiguration = CreateBucketConfiguration.builder() .location(LocationInfo.builder() .type(LocationType.AVAILABILITY_ZONE) .name("usw2-az1").build()) .bucket(BucketInfo.builder() .type(BucketType.DIRECTORY) .dataRedundancy(DataRedundancy.SINGLE_AVAILABILITY_ZONE) .build()) .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build()) .build(); CreateBucketRequest createBucketRequest = CreateBucketRequest.builder() .bucket("amzn-s3-demo-bucket--usw2-az1--x-s3--usw2-az1--x-s3") .createBucketConfiguration(bucketConfiguration) .build(); CreateBucketResponse response = s3.createBucket(createBucketRequest); System.out.println("Status code (should be 200):"); System.out.println(response.sdkHttpResponse().statusCode()); } } ``` ------ ## Uso da API REST Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para criar um bucket de diretório com tags, consulte a seguinte seção na *Referência de API do Amazon Simple Storage Service*: + [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) ## Como usar a 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 da CLI a seguir mostra como criar um bucket de diretório 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. Ao criar um bucket de diretório, você deve fornecer detalhes de configuração e usar a seguinte convenção de nomenclatura: .: `bucket-base-name--zone-id--x-s3` **Solicitação:** ``` aws s3api create-bucket \ --bucket bucket-base-name--zone-id--x-s3 \ --create-bucket-configuration "Location={Type=AvailabilityZone,Name=zone-id},Bucket={DataRedundancy=SingleAvailabilityZone,Type=Directory},Tags=[{Key=mykey1,Value=myvalue1}, {Key=mykey2,Value=myvalue2}]" ``` **Resposta:** ``` { "Location": "http://bucket--use1-az4--x-s3.s3express-use1-az4.us-east-1.amazonaws.com/" } ``` # Adicionar uma tag a um bucket de diretório É possível adicionar tags aos buckets de diretório do Amazon S3 e modificá-las. Não há cobrança adicional para usar tags em buckets de diretório 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 marcação de buckets de diretório, consulte [Usar tags com buckets de diretório do S3](directory-buckets-tagging.md). ## Permissões Para adicionar uma tag a um bucket de diretório, você precisa ter a seguinte permissão: + `s3express:TagResource` ## Solucionar de problemas de erros Se você encontrar um erro ao tentar adicionar uma tag a um bucket de diretório, você pode fazer o seguinte: + Verifique se você tem as [Permissões](#tag-add-permissions) necessárias para adicionar uma tag a um bucket de diretório. + Se você tentou adicionar uma chave de tag que começa com o prefixo reservado `aws:` da AWS, altere-a e tente novamente. ## Etapas É possível adicionar tags 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 SDKs da AWS. ## Usar o console do S3 Para adicionar tags 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** e escolha **Adicionar nova tag**. 1. Isso abre a página **Adicionar tags**. É possível adicionar até cinquenta pares de chave-valor de tag. 1. Se você adicionar uma nova tag com a mesma chave de uma tag existente, o valor da nova sobrescreverá o valor da tag existente. 1. Nessa página, também é possível editar os valor das tags existentes. 1. Depois de adicionar as tags, escolha **Salvar alterações**. ## Usar SDKs da AWS ------ #### [ SDK for Java 2.x ] Este exemplo mostra como adicionar tags a um bucket de diretório 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. ``` import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.Tag; import software.amazon.awssdk.services.s3control.model.TagResourceRequest; import software.amazon.awssdk.services.s3control.model.TagResourceResponse; public class TagResourceExample { public static void tagResourceExample() { S3ControlClient s3Control = S3ControlClient.builder().region(Region.US_WEST_2).build(); TagResourceRequest tagResourceRequest = TagResourceRequest.builder() .resourceArn("arn:aws::s3express:us-west-2:111122223333:bucket/my-directory-bucket--usw2-az1--x-s3") .accountId("111122223333") .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build()) .build(); TagResourceResponse response = s3Control.tagResource(tagResourceRequest); System.out.println("Status code (should be 204):"); System.out.println(response.sdkHttpResponse().statusCode()); } } ``` ------ ## Uso da API REST Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para adicionar tags a um bucket de diretório, consulte a seguinte seção na *Referência de API do Amazon Simple Storage Service*: + [TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.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 da CLI a seguir mostra como adicionar tags a um bucket de diretório 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 tag-resource \ --account-id 111122223333 \ --resource-arn arn:aws::s3express:us-east-1:444455556666:bucket/prefix--use1-az4--x-s3 \ --tags "Key=mykey,Value=myvalue" ``` **Resposta:** ``` { "ResponseMetadata": { "RequestId": "EXAMPLE123456789", "HTTPStatusCode": 200, "HTTPHeaders": { "date": "Wed, 19 Jun 2025 10:30:00 GMT", "content-length": "0" }, "RetryAttempts": 0 } } ``` # 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": [] } ``` # Excluir uma tag de um bucket de diretório É possível remover tags dos buckets de diretório do S3. Uma tag da AWS é um par de chave-valor que contém metadados sobre recursos, neste caso buckets de diretório do Amazon S3. Para obter mais informações sobre tags, consulte [Usar tags com buckets de diretório do S3](directory-buckets-tagging.md). **nota** Se você excluir uma tag e depois descobrir que ela estava sendo usada para rastrear custos ou controlar o acesso, poderá adicionar a tag novamente ao bucket de diretório. ## Permissões Para excluir uma tag de um bucket de diretório, você precisa ter a seguinte permissão: + `s3express:UntagResource` ## Solucionar de problemas de erros Se você encontrar um erro ao tentar excluir uma tag de um bucket de diretório, é possível fazer o seguinte: + Verifique se você tem as [Permissões](#tag-delete-permissions) necessárias para adicionar uma tag a um bucket de diretório. ## Etapas Você pode excluir tags de 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 excluir tags de 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** e marque a caixa de seleção ao lado das tags que você gostaria de excluir. 1. Escolha **Excluir**. 1. O pop-up **Excluir etiquetas definidas pelo usuário** é exibido e solicita que você confirme a exclusão das tags selecionadas. 1. Escolha **Delete** para confirmar. ## Usar SDKs da AWS ------ #### [ SDK for Java 2.x ] Este exemplo mostra como excluir tags de um bucket de diretório 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. ``` import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.UntagResourceRequest; import software.amazon.awssdk.services.s3control.model.UntagResourceResponse; public class UntagResourceExample { public static void untagResourceExample() { S3ControlClient s3Control = S3ControlClient.builder().region(Region.US_WEST_2).build(); UntagResourceRequest untagResourceRequest = UntagResourceRequest.builder() .resourceArn("arn:aws::s3express:us-west-2:111122223333:bucket/my-directory-bucket--usw2-az1--x-s3") .accountId("111122223333") .tagKeys("myTagKey") .build(); UntagResourceResponse response = s3Control.untagResource(untagResourceRequest); System.out.println("Status code (should be 204):"); System.out.println(response.sdkHttpResponse().statusCode()); } } ``` ------ ## Uso da API REST Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para excluir tags de um bucket de diretório, consulte a seguinte seção na *Referência de API do Amazon Simple Storage Service*: + [UnTagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.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 da CLI a seguir mostra como excluir tags de um bucket de diretório 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 untag-resource \ --account-id 111122223333 \ --resource-arn arn:aws::s3express:us-east-1:444455556666:bucket/prefix--use1-az4--x-s3 \ --tag-keys "tagkey1" "tagkey2" ``` **Resposta:** ``` { "ResponseMetadata": { "RequestId": "EXAMPLE123456789", "HTTPStatusCode": 204, "HTTPHeaders": { "date": "Wed, 19 Jun 2025 10:30:00 GMT", "content-length": "0" }, "RetryAttempts": 0 } } ```