Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Inserisci uno stato di allarme esterno in AWS IoT SiteWise
<a name="ingest-external-alarm-state"></a>

Gli allarmi esterni sono allarmi che vengono valutati all'esterno. AWS IoT SiteWiseÈ possibile utilizzare allarmi esterni quando si dispone di una fonte di dati che riporta lo stato dell'allarme che si desidera importare. AWS IoT SiteWise

Le proprietà dello stato di allarme richiedono un formato specifico per i valori dei dati dello stato di allarme. Ogni valore di dati deve essere un oggetto JSON serializzato su una stringa. Quindi, si inserisce la stringa serializzata come valore di stringa. Per ulteriori informazioni, consulta [Proprietà dello stato di allarme](industrial-alarms.md#alarm-state-properties).

**Example Esempio di valore dei dati sullo stato di allarme (non serializzato)**  

```
{
  "stateName": "Active"
}
```

**Example Esempio di valore dei dati sullo stato di allarme (serializzato)**  

```
{\"stateName\":\"Active\"}
```

**Nota**  
Se la tua fonte di dati non può riportare dati in questo formato o non puoi convertire i dati in questo formato prima di inserirli, puoi scegliere di non utilizzare una proprietà di allarme. Puoi invece importare i dati come proprietà di misurazione con il tipo di dati stringa, ad esempio. Per ulteriori informazioni, consultare [Definisci i flussi di dati provenienti dalle apparecchiature (misurazioni)](measurements.md) e [Inserisci dati in AWS IoT SiteWise](industrial-data-ingestion.md).

# Mappa i flussi di stato degli allarmi esterni in AWS IoT SiteWise
<a name="connect-alarm-data-streams"></a>

È possibile definire alias di proprietà per mappare i flussi di dati alle proprietà dello stato di allarme. Ciò consente di identificare facilmente una proprietà dello stato di allarme quando si inseriscono o recuperano dati. Per ulteriori informazioni sugli alias di proprietà, vedere. [Gestisci i flussi di dati per AWS IoT SiteWise](manage-data-streams.md)

**Topics**
+ [Mappa i flussi di stato degli allarmi esterni (console)](#connect-alarm-data-stream-console)
+ [Mappa i flussi di stato degli allarmi esterni ()AWS CLI](#connect-alarm-data-stream-cli)

## Mappa i flussi di stato degli allarmi esterni (console)
<a name="connect-alarm-data-stream-console"></a>

È possibile definire alias di proprietà per mappare i flussi di dati alle proprietà dello stato di allarme. Ciò consente di identificare facilmente una proprietà dello stato di allarme quando si inseriscono o recuperano dati. Per ulteriori informazioni sugli alias di proprietà, vedere. [Gestisci i flussi di dati per AWS IoT SiteWise](manage-data-streams.md)

È possibile utilizzare la AWS IoT SiteWise console per impostare un alias per una proprietà dello stato di allarme.

**Per impostare un alias di proprietà per una proprietà dello stato di allarme (console)**

1. <a name="sitewise-open-console"></a>Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-assets"></a>Nel riquadro di navigazione, scegli **Asset**.

1. Scegli l'asset per cui vuoi impostare un alias di proprietà.
**Suggerimento**  <a name="sitewise-expand-asset-hierarchy"></a>
Puoi scegliere l'icona a forma di freccia per espandere una gerarchia di asset e trovare il tuo asset.

1. Scegli **Modifica**.

1. Scorri fino a **Allarmi** ed espandi la sezione.

1. *In **Allarmi esterni**, inserisci l'alias in Alias di **proprietà**, facoltativo.*

1. Scegli **Save** (Salva).

## Mappa i flussi di stato degli allarmi esterni ()AWS CLI
<a name="connect-alarm-data-stream-cli"></a>

È possibile definire alias di proprietà per mappare i flussi di dati alle proprietà dello stato di allarme. Ciò consente di identificare facilmente una proprietà dello stato di allarme quando si inseriscono o recuperano dati. Per ulteriori informazioni sugli alias di proprietà, vedere. [Gestisci i flussi di dati per AWS IoT SiteWise](manage-data-streams.md)

È possibile utilizzare AWS Command Line Interface (AWS CLI) per impostare un alias per una proprietà dello stato di allarme.

Per completare questa procedura, è necessario conoscere l'elemento `assetId` dell'asset e l'elemento `propertyId` della proprietà. È inoltre possibile utilizzare l'ID esterno. Se hai creato una risorsa e non la conosci`assetId`, utilizza l'[ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API per elencare tutte le risorse per un modello specifico. Utilizzate l'[DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)operazione per visualizzare le proprietà della risorsa, inclusa la proprietà IDs.

**Nota**  
La [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)risposta include l'elenco di modelli di asset compositi per l'asset. Ogni allarme è un modello composito. Per trovare il`propertyId`, trova il modello composito per l'allarme, quindi trova la `AWS/ALARM_STATE` proprietà in quel modello composito.

Per ulteriori informazioni su come impostare l'alias della proprietà, vedere[Aggiorna l'alias di proprietà di un asset](update-data-streams-method.md).

# Inserisci i dati sullo stato di allarme in AWS IoT SiteWise
<a name="ingest-alarm-state-data"></a>

Le proprietà dello stato di allarme prevedono che lo stato di allarme sia una stringa JSON serializzata. Per importare lo stato di allarme in un allarme esterno in AWS IoT SiteWise, si inserisce questa stringa serializzata come valore di stringa con data e ora. L'esempio seguente mostra un valore di dati di stato per un allarme attivo.

```
{\"stateName\":\"Active\"}
```

Per identificare una proprietà dello stato di allarme, puoi specificare una delle seguenti opzioni:
+ La `assetId` fine `propertyId` della proprietà di allarme a cui stai inviando i dati.
+ Il`propertyAlias`, che è un alias di flusso di dati (ad esempio,`/company/windfarm/3/turbine/7/temperature/high`). Per utilizzare questa opzione, devi prima impostare l'alias della proprietà di allarme. Per informazioni su come impostare gli alias di proprietà per le proprietà dello stato di allarme, vedi. [Mappa i flussi di stato degli allarmi esterni in AWS IoT SiteWise](connect-alarm-data-streams.md)

Il seguente esempio di [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)API payload mostra come formattare lo stato di un allarme esterno. Questo allarme esterno segnala quando la lettura dei giri al minuto (RPM) di una turbina eolica è troppo alta.

**Example Esempio di BatchPutAssetPropertyValue payload per i dati sullo stato di allarme**  

```
{
    "entries": [
      {
        "entryId": "unique entry ID",
        "propertyAlias": "/company/windfarm/3/turbine/7/temperature/high",
        "propertyValues": [
          {
            "value": {
              "stringValue": "{\"stateName\":\"Active\"}"
            },
            "timestamp": {
              "timeInSeconds": 1607550262
            }
          }
        ]
      }
    ]
  }
```
Per ulteriori informazioni su come utilizzare l'`BatchPutAssetPropertyValue`API per importare dati, consulta. [Inserisci dati con AWS IoT SiteWise APIs](ingest-api.md)  
Per ulteriori informazioni su altri modi di importare dati, consulta. [Inserisci dati in AWS IoT SiteWise](industrial-data-ingestion.md)