Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Etiquete sus AWS IoT SiteWise recursos
Etiquetar AWS IoT SiteWise los recursos proporciona una forma eficaz de clasificar, gestionar y recuperar los activos de la organización de forma eficiente. Al asignar etiquetas, que consisten en pares clave-valor, puede asociar metadatos descriptivos a sus recursos. Los metadatos de las etiquetas se pueden utilizar para agilizar las operaciones. Por ejemplo, en el escenario de un parque eólico, las etiquetas permiten etiquetar turbinas con atributos específicos, como ubicación, capacidad y estado operativo, lo que permite identificarlas y administrarlas rápidamente en AWS IoT SiteWise.
La integración de las etiquetas con las políticas AWS Identity and Access Management (IAM) mejora la seguridad y el control operativo mediante la definición de reglas de acceso condicional. Esto significa que puede especificar que solo los usuarios tengan determinadas etiquetas. Por ejemplo, solo las personas etiquetadas con un determinado rol o departamento pueden acceder a determinados recursos o modificarlos.
# Utilice etiquetas en AWS IoT SiteWise
Use etiquetas para clasificar sus AWS IoT SiteWise recursos por propósito, propietario, entorno o cualquier otra clasificación para su caso de uso. Cuando tenga muchos recursos del mismo tipo, podrá identificar rápidamente un recurso específico en función de las etiquetas.
Cada etiqueta consta de una clave y un valor opcional que usted especifica. Por ejemplo, puede establecer una serie de etiquetas para sus modelos de activos a fin de hacer su seguimiento de acuerdo con los procesos industriales a los que dan soporte. Se recomienda desarrollar un conjunto personalizado de claves de etiquetas para cada tipo de recurso que administre. El uso de un conjunto coherente de claves de etiquetas facilita la administración de los recursos.
## Etiquete con la Consola de administración de AWS
El **editor de etiquetas** del Consola de administración de AWS proporciona una forma centralizada y unificada de crear y administrar las etiquetas para los recursos de todos los AWS servicios. Para obtener más información, consulte [Introducción al editor de etiquetas](https://docs.aws.amazon.com/tag-editor/latest/userguide/gettingstarted.html) en los * AWS recursos de etiquetado y en la Guía del usuario del editor de etiquetas*.
## Etiquete con la API AWS IoT SiteWise
La AWS IoT SiteWise API también usa etiquetas. Antes de crear etiquetas, tenga en cuenta las restricciones de etiquetado. Para obtener más información, consulte este artículo sobre las [convenciones de nomenclatura y el uso de etiquetas](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions) en la *Referencia general de AWS*.
+ Para agregar etiquetas al crear un recurso, deberá definirlas en la propiedad `tags` del recurso.
+ Para añadir etiquetas a un recurso existente o para actualizar los valores de las etiquetas, utilice la [TagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TagResource.html)operación.
+ Para eliminar etiquetas de un recurso, utilice la [UntagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UntagResource.html)operación.
+ Para recuperar las etiquetas asociadas a un recurso, utilice la [ListTagsForResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListTagsForResource.html)operación o describa el recurso e inspeccione su `tags` propiedad.
En la siguiente tabla, se enumeran los recursos que puedes etiquetar mediante la AWS IoT SiteWise API `Create` y sus `Describe` operaciones correspondientes.
**Recursos etiquetables AWS IoT SiteWise**
| Recurso | Crear operación | Describir operación |
| --- | --- | --- |
| Modelo de activos o modelo de componentes | [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) |
| Activo | [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 Puerta de enlace 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) |
| Proyecto | [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) |
| Panel de control | [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 acceso | [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) |
| Serie temporal | [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) |
Por `[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)` ejemplo, puede configurar sus fuentes de datos para enviar datos industriales AWS IoT SiteWise antes de crear modelos y activos de activos. AWS IoT SiteWise crea automáticamente flujos de datos para recibir flujos de datos sin procesar de su equipo. Para obtener más información, consulte [Administración de la ingesta de datos](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/data-streams.html).
Utilice las siguientes operaciones para ver y administrar etiquetas para los recursos que admiten etiquetas:
+ [TagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TagResource.html)— Añade etiquetas a un recurso o actualiza el valor de una etiqueta existente.
+ [ListTagsForResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListTagsForResource.html)— Muestra las etiquetas de un recurso.
+ [UntagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UntagResource.html)— Elimina las etiquetas de un recurso.
Agregue o quite etiquetas de un recurso en cualquier momento. Para actualizar el valor de una clave de etiqueta existente, añada al recurso una nueva etiqueta con la misma clave y el nuevo valor deseado. Esta acción sustituye el valor anterior por el nuevo. Si bien es posible asignar una cadena vacía como valor de etiqueta, no se puede asignar un valor nulo.
Al eliminar un recurso, también se eliminan todas las etiquetas vinculadas a él.
# Uso de etiquetas con políticas de IAM
Utilice etiquetas de recursos en sus políticas de IAM para controlar los permisos y el acceso de usuarios. Por ejemplo, las políticas pueden permitir a los usuarios crear solo aquellos recursos que tengan una etiqueta específica asociada. Las políticas también puede limitar la creación o modificación de recursos que tengan determinadas etiquetas por parte de los usuarios.
**nota**
Si utiliza etiquetas para permitir o denegar el acceso de los usuarios a los recursos, debe denegar a los usuarios la capacidad de agregar o eliminar esas etiquetas para los mismos recursos. De lo contrario, un usuario podría eludir sus restricciones y obtener acceso a un recurso modificando sus etiquetas.
Puede utilizar los siguientes valores y claves de contexto de condición en el elemento `Condition` (también llamado bloque `Condition`) de una instrucción de política.
`aws:ResourceTag/tag-key: tag-value`
Permitir o denegar acciones en recursos con etiquetas específicas.
`aws:RequestTag/tag-key: tag-value`
Exigir que se utilice (o no se utilice) una etiqueta específica al crear o modificar un recurso etiquetable.
`aws:TagKeys: [tag-key, ...]`
Exigir que se utilice (o no se utilice) un conjunto específico de claves de etiqueta al crear o modificar un recurso etiquetable.
**nota**
Las claves y valores de contexto de condición en una política de IAM se aplican solo a las acciones que tienen un recurso etiquetable como parámetro requerido. Por ejemplo, puede configurar el acceso condicional basado en etiquetas para. [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html) No puedes activar el acceso condicional basado en etiquetas [PutLoggingOptions](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutLoggingOptions.html)porque en la solicitud no se hace referencia a ningún recurso etiquetable.
Para obtener más información, consulte [Controlar el acceso a AWS los recursos mediante etiquetas de recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) y la [referencia a la política JSON de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html) en la Guía del usuario de *IAM*.
**Ejemplo de políticas de IAM que utilizan etiquetas**
+ [Vea AWS IoT SiteWise los activos en función de las etiquetas](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-asset-tags)