Aviso de fim do suporte: em 15 de dezembro de 2025, AWS encerrará o suporte para AWS IoT Analytics. Depois de 15 de dezembro de 2025, você não poderá mais acessar o AWS IoT Analytics console ou os AWS IoT Analytics recursos. Para obter mais informações, consulte AWS IoT Analytics Fim do suporte.

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

Marcando seus recursos AWS IoT Analytics

Para ajudar a gerenciar seus canais, conjuntos de dados, datastores e pipelines, você pode atribuir seus próprios metadados a cada um desses recursos na forma de tags. Este capítulo descreve as tags e mostra como criá-las.

Conceitos Básicos de Tags

As tags permitem que você categorize seus AWS IoT Analytics recursos de maneiras diferentes, por exemplo, por finalidade, proprietário ou ambiente. Isso é útil quando há muitos recursos do mesmo tipo — você pode identificar rapidamente um recurso específico com base nas tags que atribuiu a ele. Cada tag consiste em uma chave e em um valor opcional, ambos definidos por você. Por exemplo, você pode definir um conjunto de tags para os canais que ajude a rastrear o tipo de dispositivo responsável por cada origem de mensagem do canal. Recomendamos que você desenvolva um conjunto de chave de tags que atenda suas necessidades para cada tipo de recurso. Usar um conjunto consistente de chaves de tags facilita para você gerenciar seus recursos. É possível pesquisar e filtrar os recursos de acordo com as tags que adicionar.

Você também pode usar tags para categorizar e rastrear seus custos. Quando você aplica tags a canais, conjuntos de dados, datastores ou pipelines, a AWS gera um relatório de alocação de custos como um arquivo CSV (valores separados por vírgula) com o uso e os custos agregados por suas tags. É possível aplicar tags que representem categorias de negócios (como centros de custos, nomes de aplicativos ou proprietários) para organizar seus custos de vários serviços. Para obter mais informações sobre como usar tags para alocação de custos, consulte Usar tags de alocação de custos no Guia do usuário do AWS Billing.

Para facilitar o uso, use o Editor de tags no Gerenciamento de Faturamento e Custos da AWS console, que fornece uma forma central e unificada de criar e gerenciar suas tags. Para obter mais informações, consulte Como trabalhar com o Tag Editor em Conceitos básicos do AWS Management Console.

Você também pode trabalhar com tags usando a AWS CLI e a AWS IoT Analytics API. Você pode associar tags a canais, conjuntos de dados, datastores e pipelines ao criá-los. Use o campo Tags nos seguintes comandos:

É possível adicionar, modificar ou excluir tags de recursos existentes que oferecem suporte a marcação. Use os seguintes comandos:

É possível editar chaves de tags e valores, e é possível remover as tags de um recurso a qualquer momento. É possível definir o valor de uma tag a uma string vazia, mas não pode configurar o valor de um tag como nula. Se você adicionar uma tag que tenha a mesma chave de uma tag existente nesse recurso, o novo valor substituirá o antigo. Se você excluir um recurso, todas as tags associadas ao recurso também serão excluídas.

Utilização de tags com políticas do IAM

É possível usar o elemento Condition (também chamado bloco Condition) com os seguintes valores e chaves de contexto de condição em uma política do IAM para controlar o acesso do usuário (permissões) com base nas tags de um recurso:

Para mais informações, consulte Controlar o acesso usando etiquetas no Guia do usuário do IAM. A seção Referência de política JSON do IAM desse guia detalhou a sintaxe, as descrições e os exemplos dos elementos, variáveis e lógica de avaliação das políticas JSON no IAM.

A política de exemplo a seguir aplica duas restrições com base em tag. Um usuário restrito por essa política:

{
  "Version" : "2012-10-17",
  "Statement" :
  [
    {
      "Effect" : "Deny",
      "Action" : "iotanalytics:*",
      "Resource" : "*",
      "Condition" : {
        "StringEquals" : {
          "aws:RequestTag/env" : "prod"
        }
      }
    },
    {
      "Effect" : "Deny",
      "Action" : "iotanalytics:*",
      "Resource" : "*",
      "Condition" : {
        "StringEquals" : {
          "iotanalytics:ResourceTag/env" : "prod"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "iotanalytics:*"
      ],
      "Resource": "*"
    }
  ]
}

Você também pode especificar vários valores de tag para uma determinada chave de tag, colocando-as em uma lista como o exemplo a seguir:

"StringEquals" : {
  "iotanalytics:ResourceTag/env" : ["dev", "test"]
}

Restrições de tags

As restrições básicas a seguir se aplicam a tags: