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á.
# Marque seus AWS IoT SiteWise recursos
Marcar seus AWS IoT SiteWise recursos fornece uma maneira poderosa de categorizar, gerenciar e recuperar ativos organizacionais com eficiência. Ao atribuir etiquetas, que consistem em pares de chave/valor, você pode anexar metadados descritivos aos recursos. Os metadados das etiquetas podem ser usados para simplificar as operações. Por exemplo, em um cenário de parque eólico, as etiquetas permitem identificar turbinas com atributos específicos, como localização, capacidade e status operacional, permitindo rápida identificação e gerenciamento dentro do AWS IoT SiteWise.
A integração de tags com políticas AWS Identity and Access Management (IAM) aprimora a segurança e o controle operacional ao definir regras de acesso condicional. Isso significa que você pode especificar somente usuários com determinadas etiquetas. Por exemplo, somente aqueles que estiverem marcados com determinado perfil ou departamento poderão acessar ou modificar recursos específicos.
# 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.
# Usar etiquetas com políticas do IAM
Use etiquetas de recurso nas políticas do IAM para controlar o acesso e as permissões dos usuários. Por exemplo, as políticas podem permitir que os usuários criem somente os recursos que tenham uma etiqueta específica. As políticas também podem restringir os usuários de criar ou modificar recursos que tenham determinadas tags.
**nota**
Se você usar tags para permitir ou negar o acesso de usuários a recursos, negue aos usuários a capacidade de adicionar ou remover essas tags para os mesmos recursos. Caso contrário, um usuário poderá ignorar as restrições e obter acesso a um recurso ao modificar as etiquetas.
Você pode usar as chaves de contexto de condição e os valores a seguir no elemento `Condition` (também chamado de bloco `Condition`) de uma declaração de política.
`aws:ResourceTag/tag-key: tag-value`
Permitir ou negar ações em recursos com tags específicas.
`aws:RequestTag/tag-key: tag-value`
Exigir que uma tag específica seja usada (ou não) ao criar ou modificar um recurso marcável.
`aws:TagKeys: [tag-key, ...]`
Exigir que um conjunto específico de chaves de tag seja usado (ou não usado) ao criar ou modificar um recurso marcável.
**nota**
As chaves e valores de contexto de condição em uma política do IAM se aplicam somente a ações que têm um recurso marcável como um parâmetro obrigatório. Por exemplo, você pode definir o acesso condicional baseado em tags para. [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html) Você não pode ativar o acesso condicional baseado em tags [PutLoggingOptions](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutLoggingOptions.html)porque nenhum recurso marcável é referenciado na solicitação.
Para obter mais informações, consulte [Controle do acesso aos AWS recursos usando tags de recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) e a [referência da política JSON do](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html) IAM no *Guia do usuário do IAM*.
**Exemplo de políticas do IAM usando tags**
+ [Visualize AWS IoT SiteWise ativos com base em tags](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-asset-tags)