Marcando seus Recursos AWS IoT Wireless

Para ajudar no gerenciamento e na organização de seus dispositivos, gateways, destinos e perfis, é possível, opcionalmente, atribuir seus próprios metadados a cada um desses recursos em forma de tags. Esta seção descreve as tags e mostra como criá-las. O AWS IoT Wireless não tem grupos de faturamento e utiliza os mesmos grupos de faturamento usados pelo AWS IoT Core. Para obter mais informações, consulte Billing groups na documentação do AWS IoT Core.

Conceitos Básicos de Tags

Quando você tem vários recursos do AWS IoT Wireless do mesmo tipo, é possível utilizar tags para categorizá-los de diferentes formas (por exemplo, por finalidade, proprietário ou ambiente). Isso ajuda a identificar rapidamente um recurso com base nas tags que você atribuiu a ele.

Cada tag consiste em uma chave e em um valor opcional, ambos definidos por você. Por exemplo, é possível definir um conjunto de tags para um grupo de dispositivos LoRaWAN para os quais o respectivo firmware está sendo atualizado. Para gerenciar seus recursos mais facilmente, recomendamos que você crie um conjunto consistente de chaves de tags que atenda às suas necessidades para cada tipo de recurso.

Você pode pesquisar e filtrar recursos conforme as tags que adicionar ou aplicar. Você também pode utilizar tags para controlar o acesso aos recursos utilizando políticas do IAM e tags do grupo de faturamento para categorizar e monitorar os custos.

Criar e gerenciar tags

É possível criar e gerenciar tags utilizando o Editor de tags no AWS Management Console, no AWS IoT Wireless ou na AWS CLI.

Usar o console

Para facilitar o uso, o Tag Editor no AWS Management Console fornece uma forma central e unificada para criar e gerenciar suas tags. Para obter mais informações, consulte Como trabalhar com o Tag Editor no Como trabalhar com o AWS Management Console.

Como usar a API ou a CLI

Também é possível utilizar a API ou a CLI e associar as tags a dispositivos sem fio, gateways, perfis e destinos ao criá-las utilizando o campo Tags nos seguintes comandos:

Atualizar tags ou listar tags de recursos

Você pode adicionar, modificar ou excluir tags de recursos existentes que oferecem suporte a marcação, usando 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. Caso adicione uma tag com a mesma chave de outra existente no recurso, o novo valor substituirá o antigo. Se você excluir um recurso, todas as tags associadas ao recurso também serão excluídas.

Restrições e limitações de tags

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

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

Para especificar os recursos do IAM que um usuário pode criar, modificar ou utilizar, é possível aplicar permissões em nível de recurso baseadas em tags às políticas do IAM que você utiliza para a maioria das ações de API do AWS IoT Wireless. Para controlar o acesso do usuário (permissões) com base nas tags de um recurso, utilize o elemento Condition (também chamado de bloco Condition) com as chaves de contexto e valores de condição a seguir em uma política do IAM.

Para obter mais informações sobre o uso de tags, consulte Controlar o acesso usando tags no Guia do usuário do AWS Identity and Access Management. 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 do IAM restrito por essa política:

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

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

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