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á.
# Use tags em AWS IoT SiteWise
Use tags para categorizar seus AWS IoT SiteWise recursos por finalidade, proprietário, ambiente ou qualquer outra classificação para seu caso de uso. Quando você tem muitos recursos do mesmo tipo, é possível identificar rapidamente um recurso específico com base em suas tags.
Cada etiqueta consiste em uma chave e um valor opcional definidos por você. Por exemplo, você pode estabelecer uma série de etiquetas para os modelos de ativo a fim de rastreá-los de acordo com os processos industriais aos quais oferecem suporte. É recomendável desenvolver um conjunto personalizado de chaves de etiqueta para cada tipo de recurso que você gerencia. Usar um conjunto consistente de chaves de etiqueta facilita o gerenciamento dos recursos.
## Marque com o Console de gerenciamento da AWS
O **Editor de tags** no Console de gerenciamento da AWS fornece uma maneira central e unificada de criar e gerenciar suas tags para recursos de todos os AWS serviços. Para obter mais informações, consulte [Introdução ao Editor de tags](https://docs.aws.amazon.com/tag-editor/latest/userguide/gettingstarted.html) no *Guia do usuário dos AWS Recursos de marcação e do editor de tags*.
## Marque com a AWS IoT SiteWise API
A AWS IoT SiteWise API também usa tags. Antes de criar tags, esteja ciente dessas restrições de marcação. Para obter mais informações, consulte [Convenções de nomenclatura e uso de tags](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions) na *Referência geral da AWS*.
+ Para adicionar tags ao criar um recurso, defina-as na propriedade `tags` do recurso.
+ Para adicionar tags a um recurso existente ou atualizar os valores das tags, use a [TagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TagResource.html)operação.
+ Para remover tags de um recurso, use a [UntagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UntagResource.html)operação.
+ Para recuperar as tags associadas a um recurso, use a [ListTagsForResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListTagsForResource.html)operação ou descreva o recurso e inspecione sua `tags` propriedade.
A tabela a seguir lista os recursos que você pode marcar usando a AWS IoT SiteWise API e suas `Describe` operações correspondentes`Create`.
**Recursos etiquetáveis AWS IoT SiteWise**
| Recurso | Criar operação | Descrever operação |
| --- | --- | --- |
| Modelo de ativo ou modelo de componente | [CreateAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModel.html) | [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html) |
| Ativo | [CreateAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAsset.html) | [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) |
| SiteWise Gateway Edge | [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) | [DescribeGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeGateway.html) |
| Portal | [CreatePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreatePortal.html) | [DescribePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribePortal.html) |
| Projeto | [CreateProject](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateProject.html) | [DescribeProject](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeProject.html) |
| Painel | [CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html) | [DescribeDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeDashboard.html) |
| Política de acesso | [CreateAccessPolicy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAccessPolicy.html) | [DescribeAccessPolicy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAccessPolicy.html) |
| Séries temporais | [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) | [DescribeTimeSeries](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeTimeSeries.html) |
Pois`[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)`, você pode configurar suas fontes de dados para enviar dados industriais AWS IoT SiteWise antes de criar modelos e ativos de ativos. AWS IoT SiteWise cria automaticamente fluxos de dados para receber fluxos de dados brutos do seu equipamento. Para obter mais informações, consulte [Managing data ingestion](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/data-streams.html).
Use as operações a seguir para visualizar e gerenciar as tags de recursos que são compatíveis com a marcação:
+ [TagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TagResource.html)— Adiciona tags a um recurso ou atualiza o valor de uma tag existente.
+ [ListTagsForResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListTagsForResource.html)— Lista as tags de um recurso.
+ [UntagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UntagResource.html)— Remove as tags de um recurso.
Adicione ou remova etiquetas de um recurso a qualquer momento. Para atualizar o valor de uma chave de etiqueta existente, adicione uma nova etiqueta com a mesma chave e o novo valor desejado ao recurso. Essa ação substitui o valor anterior pelo novo. Embora seja possível atribuir uma string vazia como valor de etiqueta, você não pode atribuir um valor nulo.
A exclusão de um recurso também remove todas as etiquetas vinculadas a ele.