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á. # Ingerir um estado de alarme externo em AWS IoT SiteWise Alarmes externos são alarmes que você avalia externamente. AWS IoT SiteWise Você pode usar alarmes externos quando você tem uma fonte de dados que relata o estado do alarme que você deseja ingerir em AWS IoT SiteWise. As propriedades do estado do alarme exigem um formato específico para os valores dos dados do estado do alarme. Cada valor de dados deve ser um objeto JSON serializado em uma string. Então, você ingere a string serializada como um valor de string. Para obter mais informações, consulte [Propriedades do estado do alarme](industrial-alarms.md#alarm-state-properties). **Example Exemplo de valor de dados do estado do alarme (não serializado)** ``` { "stateName": "Active" } ``` **Example Exemplo de valor de dados do estado do alarme (serializado)** ``` {\"stateName\":\"Active\"} ``` **nota** Se sua fonte de dados não puder relatar dados nesse formato ou você não puder converter seus dados nesse formato antes de ingeri-los, você pode optar por não usar uma propriedade de alarme. Em vez disso, você pode ingerir os dados como uma propriedade de medição com o tipo de dados de string, por exemplo. Para obter mais informações, consulte [Definir fluxos de dados de equipamentos (medições)](measurements.md) e [Ingerir dados para AWS IoT SiteWise](industrial-data-ingestion.md). # Mapeie fluxos externos de estado de alarme em AWS IoT SiteWise Você pode definir aliases de propriedades para mapear seus fluxos de dados para suas propriedades de estado de alarme. Isso ajuda você a identificar facilmente uma propriedade do estado de alarme ao ingerir ou recuperar dados. Para obter mais informações sobre propriedade de aliases, consulte [Gerencie fluxos de dados para AWS IoT SiteWise](manage-data-streams.md). **Topics** + [Mapear fluxos de estado de alarme externo (console)](#connect-alarm-data-stream-console) + [Mapear fluxos de estado de alarme externo (AWS CLI)](#connect-alarm-data-stream-cli) ## Mapear fluxos de estado de alarme externo (console) Você pode definir aliases de propriedades para mapear seus fluxos de dados para suas propriedades de estado de alarme. Isso ajuda você a identificar facilmente uma propriedade do estado de alarme ao ingerir ou recuperar dados. Para obter mais informações sobre propriedade de aliases, consulte [Gerencie fluxos de dados para AWS IoT SiteWise](manage-data-streams.md). Você pode usar o AWS IoT SiteWise console para definir um alias para uma propriedade de estado de alarme. **Para definir um alias de propriedade para uma propriedade de estado de alarme (console)** 1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. No painel de navegação, selecione **Ativos**. 1. Escolha o ativo para o qual deseja definir um apelido de propriedade. **dica** Você pode escolher o ícone de seta para expandir uma hierarquia de ativos para localizar seu ativo. 1. Escolha **Editar**. 1. Role a tela até **Alarmes** e expanda a seção. 1. Em **Alarmes externos**, insira o alias em **Alias de propriedade – *opcional***. 1. Escolha **Salvar**. ## Mapear fluxos de estado de alarme externo (AWS CLI) Você pode definir aliases de propriedades para mapear seus fluxos de dados para suas propriedades de estado de alarme. Isso ajuda você a identificar facilmente uma propriedade do estado de alarme ao ingerir ou recuperar dados. Para obter mais informações sobre propriedade de aliases, consulte [Gerencie fluxos de dados para AWS IoT SiteWise](manage-data-streams.md). Você pode usar o AWS Command Line Interface (AWS CLI) para definir um alias para uma propriedade de estado de alarme. Para executar este procedimento, é necessário saber quais são o `assetId` do ativo e o `propertyId` da propriedade. Você também pode usar o ID externo. Se você criou um ativo e não o conhece`assetId`, use a [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API para listar todos os ativos de um modelo específico. Use a [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)operação para visualizar as propriedades do seu ativo, incluindo propriedades IDs. **nota** A [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)resposta inclui a lista de modelos de ativos compostos para o ativo. Cada alarme é um modelo composto. Para encontrar o `propertyId`, encontre o modelo composto para o alarme e, em seguida, encontre a propriedade do `AWS/ALARM_STATE` nesse modelo composto. Para obter informações sobre como definir a o alias da propriedade, consulte [Atualizar um alias de propriedade do ativo](update-data-streams-method.md). # Ingerir dados do estado do alarme em AWS IoT SiteWise As propriedades do estado do alarme esperam que o estado do alarme seja uma string JSON serializada. Para inserir o estado de alarme em um alarme externo AWS IoT SiteWise, você ingere essa string serializada como um valor de string com carimbo de data e hora. O exemplo a seguir demonstra um valor de dados de estado para um alarme ativo. ``` {\"stateName\":\"Active\"} ``` Para identificar uma propriedade de estado de alarme, você pode especificar um dos seguintes elementos: + O `assetId` e `propertyId` da propriedade do alarme para o qual você está enviando dados. + O `propertyAlias`, que é um alias de fluxo de dados (por exemplo, `/company/windfarm/3/turbine/7/temperature/high`). Para usar esta opção, primeiro você deve definir o alias da propriedade do seu alarme. Para saber como definir aliases de propriedades para propriedades de estado do alarme, consulte [Mapeie fluxos externos de estado de alarme em AWS IoT SiteWise](connect-alarm-data-streams.md). O exemplo de carga útil [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)da API a seguir demonstra como formatar o estado de um alarme externo. Esse alarme externo relata quando a leitura de rotações por minuto (RPM) de uma turbina eólica está muito alta. **Example Exemplo de BatchPutAssetPropertyValue carga útil para dados de estado de alarme** ``` { "entries": [ { "entryId": "unique entry ID", "propertyAlias": "/company/windfarm/3/turbine/7/temperature/high", "propertyValues": [ { "value": { "stringValue": "{\"stateName\":\"Active\"}" }, "timestamp": { "timeInSeconds": 1607550262 } } ] } ] } ``` Para obter mais informações sobre como usar a API `BatchPutAssetPropertyValue` para ingerir dados, consulte [Ingira dados com AWS IoT SiteWise APIs](ingest-api.md). Para obter mais informações outras formas de ingerir dados, consulte [Ingerir dados para AWS IoT SiteWise](industrial-data-ingestion.md).