Configurar etiquetas de tópicos do Amazon SNS - Amazon Simple Notification Service

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurar etiquetas de tópicos do Amazon SNS

Esta página mostra como você pode usar o AWS Management Console, um AWS SDK e a AWS CLI para configurar tags para um tópico do Amazon SNS.

Importante

Não adicione informações de identificação pessoal (PII) nem outras informações confidenciais ou sigilosas em tags. As etiquetas são acessíveis a outros Amazon Web Services, incluindo o faturamento. As tags não devem ser usadas para dados privados ou confidenciais.

Listar, adicionar e remover tags para um tópico do Amazon SNS usando o AWS Management Console

  1. Faça login no console do Amazon SNS.

  2. No painel de navegação, escolha Topics (Tópicos).

  3. Na página Topics (Tópicos), escolha um tópico e selecione Edit (Editar).

  4. Expanda a seção Tags.

    As tags adicionadas ao tópico serão listadas.

  5. Modifique as tags do tópico:

    • Para adicionar uma etiqueta, escolha Add tag (Adicionar etiqueta) e insira uma Key (Chave) e um Value (Valor) (opcional).

    • Para remover uma tag, escolha Remove tag (Remover tag) ao lado de um par chave/valor.

  6. Escolha Salvar alterações.

Adicionar etiquetas a um tópico usando um AWS SDK

Para usar um AWS SDK, você deve configurá-lo com suas credenciais. Para obter mais informações, consulte The shared config and credentials files (“Os arquivos compartilhados de configuração e de credenciais”) no Guia de referência de AWS SDKs e ferramentas.

Os exemplos de código a seguir mostram como usarTagResource.

CLI
AWS CLI

Para adicionar uma tag a um tópico

O exemplo tag-resource a seguir adiciona uma tag de metadados ao tópico do Amazon SNS especificado.

aws sns tag-resource \ --resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \ --tags Key=Team,Value=Alpha

Este comando não produz saída.

  • Para obter detalhes da API, consulte TagResourcena Referência de AWS CLI Comandos.

Java
SDK para Java 2.x
nota

Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no AWS Code Examples Repository.

import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.sns.SnsClient; import software.amazon.awssdk.services.sns.model.SnsException; import software.amazon.awssdk.services.sns.model.Tag; import software.amazon.awssdk.services.sns.model.TagResourceRequest; import java.util.ArrayList; import java.util.List; /** * Before running this Java V2 code example, set up your development * environment, including your credentials. * * For more information, see the following documentation topic: * * https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html */ public class AddTags { public static void main(String[] args) { final String usage = """ Usage: <topicArn> Where: topicArn - The ARN of the topic to which tags are added. """; if (args.length != 1) { System.out.println(usage); System.exit(1); } String topicArn = args[0]; SnsClient snsClient = SnsClient.builder() .region(Region.US_EAST_1) .build(); addTopicTags(snsClient, topicArn); snsClient.close(); } public static void addTopicTags(SnsClient snsClient, String topicArn) { try { Tag tag = Tag.builder() .key("Team") .value("Development") .build(); Tag tag2 = Tag.builder() .key("Environment") .value("Gamma") .build(); List<Tag> tagList = new ArrayList<>(); tagList.add(tag); tagList.add(tag2); TagResourceRequest tagResourceRequest = TagResourceRequest.builder() .resourceArn(topicArn) .tags(tagList) .build(); snsClient.tagResource(tagResourceRequest); System.out.println("Tags have been added to " + topicArn); } catch (SnsException e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } } }
  • Para obter detalhes da API, consulte TagResourcea Referência AWS SDK for Java 2.x da API.

Kotlin
SDK for Kotlin
nota

Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no AWS Code Examples Repository.

suspend fun addTopicTags(topicArn: String) { val tag = Tag { key = "Team" value = "Development" } val tag2 = Tag { key = "Environment" value = "Gamma" } val tagList = mutableListOf<Tag>() tagList.add(tag) tagList.add(tag2) val request = TagResourceRequest { resourceArn = topicArn tags = tagList } SnsClient { region = "us-east-1" }.use { snsClient -> snsClient.tagResource(request) println("Tags have been added to $topicArn") } }
  • Para obter detalhes da API, consulte a TagResourcereferência da API AWS SDK for Kotlin.

Gerenciar etiquetas com ações de API do Amazon SNS

Para gerenciar etiquetas usando a API do Amazon SNS, use as seguintes ações de API:

Ações de API com suporte para o ABAC

A lista a seguir inclui as ações de API que oferecem suporte ao controle de acesso baseado em atributos (ABAC). Para obter mais detalhes sobre o ABAC, consulte Para que serve o ABAC? AWS no Guia do usuário do IAM.