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. # Introduzca un estado de alarma externo en AWS IoT SiteWise Las alarmas externas son alarmas que se evalúan fuera de ellas AWS IoT SiteWise. Puede utilizar alarmas externas si tiene un origen de datos que notifique el estado de alarma que desea ingerir a AWS IoT SiteWise. Las propiedades de los estados de alarma requieren un formato específico para los valores de los datos de los estados de alarma. Cada valor de datos debe ser un objeto JSON serializado en una cadena. A continuación, ingiera la cadena serializada como valor de cadena. Para obtener más información, consulte [Propiedades del estado de alarma](industrial-alarms.md#alarm-state-properties). **Example Ejemplo de valor de los datos de estado de alarma (no serializado)** ``` { "stateName": "Active" } ``` **Example Ejemplo de valor de los datos de estado de alarma (serializado)** ``` {\"stateName\":\"Active\"} ``` **nota** Si su origen de datos no puede generar datos en este formato o no puede convertirlos a este formato antes de ingerirlos, puede optar por no utilizar una propiedad de alarma. En su lugar, puede ingerir los datos como una propiedad de medición con el tipo de datos de cadena, por ejemplo. Para obtener más información, consulte [Definición de flujos de datos procedentes del equipo (mediciones)](measurements.md) y [Ingiera datos para AWS IoT SiteWise](industrial-data-ingestion.md). # Mapee los flujos de estados de alarma externos AWS IoT SiteWise Puede definir alias de propiedades para asignar sus flujos de datos a las propiedades de su estado de alarma. Esto le ayuda a identificar fácilmente una propiedad de estado de alarma cuando ingiera o recupera datos. Para obtener más información acerca de los alias de propiedad, consulte [Gestione los flujos de datos para AWS IoT SiteWise](manage-data-streams.md). **Topics** + [Asignación de flujos de estados de alarmas externas (consola)](#connect-alarm-data-stream-console) + [Asignación de flujos de estados de alarmas externas (AWS CLI)](#connect-alarm-data-stream-cli) ## Asignación de flujos de estados de alarmas externas (consola) Puede definir alias de propiedades para asignar sus flujos de datos a las propiedades de su estado de alarma. Esto le ayuda a identificar fácilmente una propiedad de estado de alarma cuando ingiera o recupera datos. Para obtener más información acerca de los alias de propiedad, consulte [Gestione los flujos de datos para AWS IoT SiteWise](manage-data-streams.md). Puede utilizar la AWS IoT SiteWise consola para configurar un alias para una propiedad de estado de alarma. **Para configurar un alias de propiedad para una propiedad de estado de alarma (consola)** 1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. En el panel de navegación, elija **Activos**. 1. Elija el activo para el que desea configurar un alias de propiedad. **sugerencia** Puede elegir el icono de flecha para expandir una jerarquía de activos y encontrar su activo. 1. Elija **Edit (Edición de)**. 1. Desplácese hasta **Alarmas** y expanda la sección. 1. En **Alarmas externas**, introduce el alias en **Alias de propiedad – *opcional***. 1. Seleccione **Save**. ## Asignación de flujos de estados de alarmas externas (AWS CLI) Puede definir alias de propiedades para asignar sus flujos de datos a las propiedades de su estado de alarma. Esto le ayuda a identificar fácilmente una propiedad de estado de alarma cuando ingiera o recupera datos. Para obtener más información acerca de los alias de propiedad, consulte [Gestione los flujos de datos para AWS IoT SiteWise](manage-data-streams.md). Puedes usar el AWS Command Line Interface (AWS CLI) para configurar un alias para una propiedad de estado de alarma. Debe conocer los `assetId` de sus activos y los `propertyId` de las propiedades para completar este procedimiento. También puede utilizar el ID externo. Si has creado un activo y no lo conoces`assetId`, usa la [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API para enumerar todos los activos de un modelo específico. Utilice la [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)operación para ver las propiedades de su activo, incluida la propiedad IDs. **nota** La [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)respuesta incluye la lista de modelos de activos compuestos para el activo. Cada alarma es un modelo compuesto. Para encontrar el `propertyId`, busque el modelo compuesto de la alarma y, a continuación, busque la propiedad de `AWS/ALARM_STATE` en ese modelo compuesto. Para obtener información acerca de cómo establecer el alias de la propiedad, consulte [Actualice el alias de una propiedad de un activo](update-data-streams-method.md). # Ingiera los datos del estado de alarma en AWS IoT SiteWise Las propiedades del estado de alarma esperan que el estado de la alarma sea una cadena JSON serializada. Para transferir el estado de alarma a una alarma externa AWS IoT SiteWise, ingiera esta cadena serializada como un valor de cadena con una marca de tiempo. En el ejemplo siguiente se muestra un valor de datos de estado para una alarma activa. ``` {\"stateName\":\"Active\"} ``` Para identificar una propiedad del estado de alarma, puede especificar uno de los elementos siguientes: + El `assetId` y el `propertyId` de la propiedad de alarma a la que se envían los datos. + El `propertyAlias`, que es un alias de flujo de datos (por ejemplo, `/company/windfarm/3/turbine/7/temperature/high`). Para utilizar esta opción, primero debe establecer el alias de la propiedad de la alarma. Para obtener información sobre cómo configurar los alias de propiedad para las propiedades de los estados de alarma, consulte [Mapee los flujos de estados de alarma externos AWS IoT SiteWise](connect-alarm-data-streams.md). En el siguiente ejemplo de carga útil de la [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)API, se muestra cómo formatear el estado de una alarma externa. Esta alarma externa informa cuando la lectura de rotaciones por minuto (RPM) de una turbina eólica es demasiado alta. **Example Ejemplo de BatchPutAssetPropertyValue carga útil para datos de estado de alarma** ``` { "entries": [ { "entryId": "unique entry ID", "propertyAlias": "/company/windfarm/3/turbine/7/temperature/high", "propertyValues": [ { "value": { "stringValue": "{\"stateName\":\"Active\"}" }, "timestamp": { "timeInSeconds": 1607550262 } } ] } ] } ``` Para obtener más información sobre cómo usar la API `BatchPutAssetPropertyValue` para ingerir datos, consulte [Ingiera datos con AWS IoT SiteWise APIs](ingest-api.md). Para obtener más información acerca de otras formas de ingerir datos, consulte [Ingiera datos para AWS IoT SiteWise](industrial-data-ingestion.md).