View a markdown version of this page

Utilice etiquetas en AWS IoT SiteWise - AWS IoT SiteWise

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.

Utilice etiquetas en AWS IoT SiteWise

Usa etiquetas para clasificar tus AWS IoT SiteWise recursos por propósito, propietario, entorno o cualquier otra clasificación para tu 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 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, consulta Cómo empezar a usar el editor de etiquetas en la Guía del usuario de AWS los recursos de etiquetado y del editor de etiquetas.

Etiquete con el AWS IoT SiteWise API

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 en la Referencia general de AWS.

  • Para agregar etiquetas al crear un recurso, deberá definirlas en la propiedad tags del recurso.

  • Para agregar etiquetas a un recurso existente o para actualizar los valores de las etiquetas, utilice la TagResource operación.

  • Para eliminar las etiquetas de un recurso, utilice la UntagResource operación.

  • Para recuperar las etiquetas asociadas a un recurso, utilice la ListTagsForResource operación o describa el recurso e inspeccione su tags propiedad.

En la siguiente tabla se enumeran los recursos que puedes etiquetar con la AWS IoT SiteWise API y sus Describe operaciones Create y operaciones correspondientes.

Etiquetable AWS IoT SiteWise recursos
Recurso Crear operación Describir operación
Modelo de activos o modelo de componentes CreateAssetModel DescribeAssetModel
Activo CreateAsset DescribeAsset
SiteWise Puerta de enlace periférica CreateGateway DescribeGateway
Portal CreatePortal DescribePortal
Proyecto CreateProject DescribeProject
Panel de control CreateDashboard DescribeDashboard
Política de acceso CreateAccessPolicy DescribeAccessPolicy
Serie temporal BatchPutAssetPropertyValue DescribeTimeSeries

AdemásBatchPutAssetPropertyValue, puede configurar sus fuentes de datos para enviar datos industriales AWS IoT SiteWise antes de crear modelos de activos y modelos 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.

Utilice las siguientes operaciones para ver y administrar etiquetas para los recursos que admiten etiquetas:

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.