Definisci un AWS IoT Events allarme (AWS IoT SiteWise console)Definisci un AWS IoT Events allarme (AWS IoT Events console)Definisci un AWS IoT Events allarme (AWS CLI)

Definisci AWS IoT Events allarmi per AWS IoT SiteWise

Nota

Avviso di fine del supporto: AWS è terminato il supporto per AWS IoT Events. Per ulteriori informazioni, vedi AWS IoT Events fine del supporto.

Quando si crea un AWS IoT Events allarme, AWS IoT SiteWise invia i valori delle proprietà degli asset AWS IoT Events a per valutare lo stato dell'allarme. AWS IoT Events le definizioni degli allarmi dipendono dal modello di allarme in cui viene definito AWS IoT Events. Per definire un AWS IoT Events allarme su un modello di asset, si definisce un modello composito di allarme che specifica il modello di AWS IoT Events allarme come proprietà di origine dell'allarme.

AWS IoT Events gli allarmi dipendono da input quali le soglie di allarme e le impostazioni di notifica degli allarmi. Questi input vengono definiti come attributi nel modello di asset. È quindi possibile personalizzare questi input su ogni risorsa in base al modello. La AWS IoT SiteWise console può creare questi attributi per te. Se definisci gli allarmi con l'API AWS CLI or, devi definire manualmente questi attributi sul modello di asset.

Puoi anche definire altre azioni che si verificano quando viene rilevato un allarme, ad esempio azioni di notifica degli allarmi personalizzate. Ad esempio, puoi configurare un'azione che invia una notifica push a un argomento di Amazon SNS. Per ulteriori informazioni sulle azioni che puoi definire, consulta Lavorare con altri AWS servizi nella AWS IoT Events Developer Guide.

Quando aggiorni o elimini un modello di asset, AWS IoT SiteWise puoi verificare se un modello di allarme AWS IoT Events sta monitorando una proprietà dell'asset associata a questo modello di asset. Ciò impedisce di eliminare una proprietà dell'asset attualmente utilizzata da un AWS IoT Events allarme. Per abilitare questa funzionalità in AWS IoT SiteWise, è necessario disporre dell'iotevents:ListInputRoutingsautorizzazione. Questa autorizzazione consente AWS IoT SiteWise di effettuare chiamate all'operazione ListInputRoutings API supportata da AWS IoT Events. Per ulteriori informazioni, consulta ListInputRoutings Autorizzazione (opzionale).

Nota

La funzione di notifica degli allarmi non è disponibile nella regione Cina (Pechino).

Argomenti

Definisci un AWS IoT Events allarme (AWS IoT SiteWise console)
Definisci un AWS IoT Events allarme (AWS IoT Events console)
Definisci un AWS IoT Events allarme (AWS CLI)

Definisci un AWS IoT Events allarme (AWS IoT SiteWise console)

È possibile utilizzare la AWS IoT SiteWise console per definire un AWS IoT Events allarme su un modello di asset esistente. Per definire un AWS IoT Events allarme su un nuovo modello di asset, create il modello di asset e completate questi passaggi. Per ulteriori informazioni, consulta Crea modelli di asset in AWS IoT SiteWise.

Importante

Ogni allarme richiede un attributo che specifichi il valore di soglia con cui confrontare l'allarme. È necessario definire l'attributo del valore di soglia sul modello di asset prima di poter definire un allarme.

Prendete in considerazione un esempio in cui desiderate definire un allarme che rilevi quando una turbina eolica supera la velocità massima del vento di 50 mph. Prima di definire l'allarme, è necessario definire un attributo (Velocità massima del vento) con un valore predefinito di. 50

Per definire un AWS IoT Events allarme su un modello di asset

Passare alla console AWS IoT SiteWise.
Nel riquadro di navigazione selezionare Models (Modelli).
Scegliete il modello di asset per il quale definire un allarme.
Scegliete la scheda Allarme.
Scegli Aggiungi allarme.
Nella sezione delle opzioni del tipo di allarme, scegli AWS IoT Events allarme.
Nella sezione Dettagli dell'allarme, procedi come segue:
1. Immetti un nome per l’allarme.
2. (Facoltativo) Inserisci una descrizione per la sveglia.
Nella sezione Definizioni delle soglie, è possibile definire quando viene rilevato l'allarme e la gravità dell'allarme. Esegui questa operazione:
1. Selezionate la proprietà in base alla quale viene rilevato l'allarme. Ogni volta che questa proprietà riceve un nuovo valore, AWS IoT SiteWise invia il valore AWS IoT Events a per valutare lo stato dell'allarme.
2. Selezionare l'operatore da utilizzare per confrontare la proprietà con il valore di soglia. Seleziona una delle opzioni seguenti:
  - < inferiore a
  - <= minore o uguale
  - == uguale
  - ! = non uguale
  - >= maggiore o uguale
  - > maggiore di
3. Per Valore, selezionare la proprietà dell'attributo da utilizzare come valore di soglia. AWS IoT Events confronta il valore della proprietà con il valore di questo attributo.
4. Inserire la gravità dell'allarme. Usa un numero che il tuo team comprenda per indicare la gravità di questo allarme.
(Facoltativo) Nella sezione Impostazioni di notifica - opzionale, procedi come segue:
1. Scegli Attivo.
  
  Nota
  Se scegli Inattivo, tu e il tuo team non riceverete alcuna notifica di allarme.
2. Per Destinatario, scegli il destinatario.
  
  Importante
  Puoi inviare notifiche di allarme agli Centro identità AWS IAM utenti. Per utilizzare questa funzionalità, devi abilitare IAM Identity Center. Puoi abilitare IAM Identity Center solo in una AWS regione alla volta. Ciò significa che puoi definire le notifiche di allarme solo nella regione in cui abiliti IAM Identity Center. Per ulteriori informazioni, consulta Nozioni di base nella Guida per l'utente di Centro identità AWS IAM .
3. Per Protocol, scegli tra le seguenti opzioni:
  - Email e testo: l'allarme notifica agli utenti di IAM Identity Center un messaggio SMS e un messaggio e-mail.
  - E-mail: l'allarme invia una notifica agli utenti di IAM Identity Center con un messaggio e-mail.
  - Testo: l'allarme invia una notifica agli utenti di IAM Identity Center con un messaggio SMS.
4. Per Sender, scegli il mittente.
  
  Importante
  Devi verificare l'indirizzo email del mittente in Amazon Simple Email Service (Amazon SES). Per ulteriori informazioni, consulta Verifica dell'identità di un indirizzo e-mail nella Amazon Simple Email Service Developer Guide.
Nella sezione Stato predefinito dell'asset, puoi impostare lo stato predefinito per gli allarmi creati da questo modello di asset.

Nota
Attivate o disattivate questo allarme per le risorse create da questo modello di asset in una fase successiva.
Nella sezione Impostazioni avanzate, è possibile configurare le autorizzazioni, le impostazioni di notifica aggiuntive, le azioni relative allo stato di allarme, il modello di allarme in SiteWise Monitor e il flusso di conferma.
Nota
AWS IoT Events gli allarmi richiedono i seguenti ruoli di servizio:
- Un ruolo che AWS IoT Events presuppone l'invio dei valori dello stato di allarme a. AWS IoT SiteWise
- Un ruolo che AWS IoT Events presuppone l'invio di dati a Lambda. Questo ruolo è necessario solo se l'allarme invia notifiche.
Nella sezione Autorizzazioni, procedi come segue:
1. Per AWS IoT Events il ruolo, utilizza un ruolo esistente o crea un ruolo con le autorizzazioni richieste. Questo ruolo richiede l'iotsitewise:BatchPutAssetPropertyValueautorizzazione e una relazione di fiducia che consenta a iotevents.amazonaws.com di assumere il ruolo.
2. Per il ruolo AWS IoT Events Lambda, utilizza un ruolo esistente o crea un ruolo con le autorizzazioni richieste. Questo ruolo richiede le sso-directory:DescribeUser autorizzazioni lambda:InvokeFunction and e una relazione di fiducia che iotevents.amazonaws.com consenta di assumere il ruolo.
(Facoltativo) Nella sezione Impostazioni di notifica aggiuntive, procedi come segue:
1. Per l'attributo Destinatario, si definisce un attributo il cui valore specifica il destinatario della notifica. Puoi scegliere gli utenti di IAM Identity Center come destinatari.
  
  Puoi creare un attributo o utilizzare un attributo esistente nel modello di asset.
  - Se scegli Crea un nuovo attributo destinatario, specifica il nome dell'attributo Destinatario e il valore predefinito del destinatario, facoltativo per l'attributo.
  - Se scegli Usa un attributo del destinatario esistente, scegli l'attributo nel nome dell'attributo Destinatario. L'allarme utilizza il valore predefinito dell'attributo scelto.
  È possibile sovrascrivere il valore predefinito su ogni risorsa creata da questo modello di asset.
2. Per l'attributo del messaggio personalizzato, si definisce un attributo il cui valore specifica il messaggio personalizzato da inviare in aggiunta al messaggio di modifica dello stato predefinito. Ad esempio, puoi specificare un messaggio che aiuti il tuo team a capire come risolvere questo allarme.
  
  Puoi scegliere di creare un attributo o utilizzare un attributo esistente nel modello di asset.
  - Se scegli di creare un nuovo attributo di messaggio personalizzato, specifica il nome dell'attributo del messaggio personalizzato e il valore predefinito del messaggio personalizzato, facoltativo per l'attributo.
  - Se scegli Usa un attributo di messaggio personalizzato esistente, scegli l'attributo in Nome dell'attributo del messaggio personalizzato. L'allarme utilizza il valore predefinito dell'attributo scelto.
  È possibile sovrascrivere il valore predefinito su ogni risorsa creata da questo modello di asset.
3. Per Gestisci la tua funzione Lambda, esegui una delle seguenti operazioni:
  - Per AWS IoT SiteWise creare una nuova funzione Lambda, scegli Crea una nuova lambda da un modello gestito da AWS.
  - Per utilizzare una funzione Lambda esistente, scegli Usa una lambda esistente e scegli il nome della funzione.
  Per ulteriori informazioni, consulta Gestione delle notifiche di allarme nella Guida per gli AWS IoT Events sviluppatori.
(Facoltativo) Nella sezione Imposta l'azione dello stato, procedi come segue:
1. Scegli l'azione Modifica.
2. In Aggiungi azioni relative allo stato di allarme, aggiungi le azioni. quindi scegli Salva.
  
  Puoi aggiungere fino a 10 azioni.
AWS IoT Events può eseguire azioni quando l'allarme è attivo. È possibile definire azioni integrate per utilizzare un timer o impostare una variabile o inviare dati ad altre AWS risorse. Per ulteriori informazioni, consulta Azioni supportate nella Guida per AWS IoT Events gli sviluppatori.
(Facoltativo) In Gestisci il modello di allarme in SiteWise Monitor - opzionale , scegli Attivo o Inattivo.

Usa questa opzione per aggiornare il modello di allarme in SiteWise Monitorss. Per impostazione predefinita, questa opzione è abilitata.
In Riconoscimento del flusso, scegli Attivo o Inattivo. Per ulteriori informazioni sul flusso di riconoscimento, consulta. Stati di allarme
Scegli Aggiungi allarme.

Nota
La AWS IoT SiteWise console effettua più richieste API per aggiungere l'allarme al modello di asset. Quando scegli Aggiungi allarme, la console apre una finestra di dialogo che mostra lo stato di avanzamento di queste richieste API. Rimani su questa pagina finché ogni richiesta API non ha esito positivo o fino a quando una richiesta API non ha esito positivo. Se una richiesta fallisce, chiudi la finestra di dialogo, risolvi il problema e scegli Aggiungi allarme per riprovare.

Definisci un AWS IoT Events allarme (AWS IoT Events console)

È possibile utilizzare la AWS IoT Events console per definire un AWS IoT Events allarme su un modello di asset esistente. Per definire un AWS IoT Events allarme su un nuovo modello di asset, create il modello di asset e completate questi passaggi. Per ulteriori informazioni, consulta Crea modelli di asset in AWS IoT SiteWise.

Importante

Per definire un AWS IoT Events allarme su un modello di asset

Passare alla console AWS IoT Events.
Nel pannello di navigazione, scegli Modelli di allarme.
Scegli Crea modello di allarme.
Immetti un nome per l’allarme.
(Facoltativo) Inserisci una descrizione per il tuo allarme.
Nella sezione Obiettivo dell'allarme, procedi come segue:
1. Per le opzioni Target, scegliete la proprietà AWS IoT SiteWise dell'asset.
2. Scegliete il modello di asset per il quale desiderate aggiungere l'allarme.
Nella sezione Definizioni delle soglie, potete definire quando viene rilevato l'allarme e la sua gravità. Esegui questa operazione:
1. Selezionate la proprietà in base alla quale viene rilevato l'allarme. Ogni volta che questa proprietà riceve un nuovo valore, AWS IoT SiteWise invia il valore AWS IoT Events a per valutare lo stato dell'allarme.
2. Selezionare l'operatore da utilizzare per confrontare la proprietà con il valore di soglia. Seleziona una delle opzioni seguenti:
  - < inferiore a
  - <= minore o uguale
  - == uguale
  - ! = non uguale
  - >= maggiore o uguale
  - > maggiore di
3. Per Valore, selezionare la proprietà dell'attributo da utilizzare come valore di soglia. AWS IoT Events confronta il valore della proprietà con il valore di questo attributo.
4. Inserire la gravità dell'allarme. Usa un numero che il tuo team comprenda per indicare la gravità di questo allarme.
(Facoltativo) Nella sezione Impostazioni di notifica - opzionale, procedi come segue:
1. Per Protocollo, scegli tra le seguenti opzioni:
  - Email e testo: l'allarme notifica agli utenti di IAM Identity Center un messaggio SMS e un messaggio e-mail.
  - E-mail: l'allarme invia una notifica agli utenti di IAM Identity Center con un messaggio e-mail.
  - Testo: l'allarme invia una notifica agli utenti di IAM Identity Center con un messaggio SMS.
2. Per Sender, scegli il mittente.
  
  Importante
  Devi verificare l'indirizzo email del mittente in Amazon Simple Email Service (Amazon SES). Per ulteriori informazioni, consulta Verifica degli indirizzi e-mail in Amazon SES, nella Amazon Simple Email Service Developer Guide.
3. Scegli l'attributo in Attributo destinatario - opzionale . L'allarme utilizza il valore predefinito dell'attributo scelto.
4. Scegli l'attributo in Attributo messaggio personalizzato - opzionale . L'allarme utilizza il valore predefinito dell'attributo scelto.
Nella sezione Istanza, specifica lo stato predefinito per questo allarme. È possibile attivare o disattivare questo allarme per tutte le risorse create da questo modello di asset in una fase successiva.
Nelle impostazioni avanzate, è possibile configurare le autorizzazioni, le impostazioni di notifica aggiuntive, le azioni relative allo stato di allarme, il modello di allarme in SiteWise Monitor e il flusso di conferma.
Nota
AWS IoT Events gli allarmi richiedono i seguenti ruoli di servizio:
- Un ruolo che AWS IoT Events presuppone l'invio dei valori dello stato di allarme a. AWS IoT SiteWise
- Un ruolo che AWS IoT Events presuppone l'invio di dati a Lambda. Questo ruolo è necessario solo se l'allarme invia notifiche.
1. Nella sezione Flusso di conferma, scegli Abilitato o Disabilitato. Per ulteriori informazioni sul flusso di riconoscimento, consulta. Stati di allarme
2. Nella sezione Autorizzazioni, procedi come segue:
  1. Per AWS IoT Events il ruolo, utilizza un ruolo esistente o crea un ruolo con le autorizzazioni richieste. Questo ruolo richiede l'iotsitewise:BatchPutAssetPropertyValueautorizzazione e una relazione di fiducia che consenta a iotevents.amazonaws.com di assumere il ruolo.
  2. Per il ruolo Lambda, utilizza un ruolo esistente o crea un ruolo con le autorizzazioni richieste. Questo ruolo richiede le sso-directory:DescribeUser autorizzazioni lambda:InvokeFunction and e una relazione di fiducia che iotevents.amazonaws.com consenta di assumere il ruolo.
3. (Facoltativo) Nel riquadro Impostazioni di notifica aggiuntive, effettuate le seguenti operazioni:
  1. Per Gestisci la tua funzione Lambda, esegui una delle seguenti operazioni:
    - Per AWS IoT Events creare una nuova funzione Lambda, scegli Crea una nuova funzione Lambda.
    - Per utilizzare una funzione Lambda esistente, scegli Usa una funzione Lambda esistente e scegli il nome della funzione.
    Per ulteriori informazioni, consulta Gestione delle notifiche di allarme nella Guida per gli AWS IoT Events sviluppatori.
4. (Facoltativo) Nella sezione Set state action - opzionale, procedi come segue:
  1. In Azioni relative allo stato di allarme, aggiungi le azioni. quindi scegli Salva.
    
    Puoi aggiungere fino a 10 azioni.
  AWS IoT Events può eseguire azioni quando l'allarme è attivo. È possibile definire azioni integrate per utilizzare un timer o impostare una variabile o inviare dati ad altre AWS risorse. Per ulteriori informazioni, consulta Azioni supportate nella Guida per AWS IoT Events gli sviluppatori.
Scegli Crea.

Nota
La AWS IoT Events console effettua più richieste API per aggiungere l'allarme al modello di asset. Quando scegli Aggiungi allarme, la console apre una finestra di dialogo che mostra lo stato di avanzamento di queste richieste API. Rimani su questa pagina finché ogni richiesta API non ha esito positivo o fino a quando una richiesta API non ha esito positivo. Se una richiesta fallisce, chiudi la finestra di dialogo, risolvi il problema e scegli Aggiungi allarme per riprovare.

Definisci un AWS IoT Events allarme (AWS CLI)

È possibile utilizzare AWS Command Line Interface (AWS CLI) per definire un AWS IoT Events allarme che monitora una proprietà dell'asset. È possibile definire l'allarme su un modello di asset nuovo o esistente. Dopo aver definito l'allarme sul modello di asset, si crea un allarme AWS IoT Events e lo si collega al modello di asset. In questo processo, effettuate le seguenti operazioni:

Fasi

Fase 1: Definire un allarme su un modello di asset
Fase 2: Definire un AWS IoT Events modello di allarme
Passaggio 3: abilita il flusso di dati tra AWS IoT SiteWise and AWS IoT Events

Fase 1: Definire un allarme su un modello di asset

Aggiungi una definizione di allarme e le proprietà associate a un modello di asset nuovo o esistente.

Per definire un allarme su un modello di asset (CLI)

Crea un file denominato asset-model-payload.json. Segui i passaggi indicati in queste altre sezioni per aggiungere i dettagli del tuo modello di asset al file, ma non inviare la richiesta di creazione o aggiornamento del modello di asset. In questa sezione, aggiungete una definizione di allarme ai dettagli del modello di asset nel asset-model-payload.json file.
- Per ulteriori informazioni su come creare un modello di asset, vedereCrea un modello di asset (AWS CLI).
- Per ulteriori informazioni su come aggiornare un modello di asset esistente, vedereAggiornare un modello di asset, un modello di componente o un'interfaccia (AWS CLI).
Nota
Il modello di asset deve definire almeno una proprietà dell'asset, inclusa la proprietà dell'asset da monitorare con l'allarme.

Aggiungete un modello composito di allarme (assetModelCompositeModels) al modello di asset. Un modello composito di AWS IoT Events allarme specifica il IOT_EVENTS tipo e specifica una proprietà della fonte di allarme. La proprietà della fonte di allarme viene aggiunta dopo aver creato il modello di allarme in. AWS IoT Events

Importante

Il modello composito di allarme deve avere lo stesso nome del modello di AWS IoT Events allarme creato successivamente. I nomi dei modelli di allarme possono contenere solo caratteri alfanumerici. Specificate un nome alfanumerico univoco in modo da poter utilizzare lo stesso nome per il modello di allarme.


{
  ...
  "assetModelCompositeModels": [
    {
      "name": "BoilerTemperatureHighAlarm",
      "type": "AWS/ALARM",
      "properties": [
        {
          "name": "AWS/ALARM_TYPE",
          "dataType": "STRING",
          "type": {
            "attribute": {
              "defaultValue": "IOT_EVENTS"
            }
          }
        },
        {
          "name": "AWS/ALARM_STATE",
          "dataType": "STRUCT",
          "dataTypeSpec": "AWS/ALARM_STATE",
          "type": {
            "measurement": {}
          }
        }
      ]
    }
  ]
}

Aggiungete un attributo di soglia di allarme al modello di asset. Specificate il valore predefinito da utilizzare per questa soglia. È possibile sovrascrivere questo valore predefinito su ogni risorsa basata su questo modello.

Nota
L'attributo della soglia di allarme deve essere un INTEGER o unDOUBLE.
```
{
  ...
  "assetModelProperties": [
    ...
    {
      "name": "Temperature Max Threshold",
      "dataType": "DOUBLE",
      "type": {
        "attribute": {
          "defaultValue": "105.0"
        }
      }
    }
  ]
}
```
(Facoltativo) Aggiungi gli attributi di notifica degli allarmi al modello di asset. Questi attributi specificano il destinatario dell'IAM Identity Center e altri input AWS IoT Events utilizzati per inviare notifiche quando l'allarme cambia stato. È possibile sovrascrivere queste impostazioni predefinite su ogni risorsa in base a questo modello.

Importante
È possibile inviare notifiche di allarme agli utenti. Centro identità AWS IAM Per utilizzare questa funzionalità, devi abilitare IAM Identity Center. Puoi abilitare IAM Identity Center solo in una AWS regione alla volta. Ciò significa che puoi definire le notifiche di allarme solo nella regione in cui abiliti IAM Identity Center. Per ulteriori informazioni, consulta Nozioni di base nella Guida per l'utente di Centro identità AWS IAM .

Esegui questa operazione:
1. Aggiungi un attributo che specifichi l'ID del tuo archivio di identità IAM Identity Center. Puoi utilizzare l'operazione ListInstances API IAM Identity Center per elencare i tuoi archivi di identità. Questa operazione funziona solo nella regione in cui abiliti IAM Identity Center.
```
aws sso-admin list-instances
```
  Quindi, specifica l'ID dell'archivio di identità (ad esempio,d-123EXAMPLE) come valore predefinito per l'attributo.
```
{
  ...
  "assetModelProperties": [
    ...
    {
      "name": "identityStoreId",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "d-123EXAMPLE"
        }
      }
    }
  ]
}
```
2. Aggiungi un attributo che specifichi l'ID dell'utente IAM Identity Center che riceve le notifiche. Per definire un destinatario di notifica predefinito, aggiungi un ID utente IAM Identity Center come valore predefinito. Effettua una delle seguenti operazioni per ottenere un ID utente IAM Identity Center:
  1. Puoi utilizzare l'ListUsersAPI IAM Identity Center per ottenere l'ID di un utente di cui conosci il nome utente. Sostituisci d-123EXAMPLE con l'ID del tuo archivio di identità e sostituiscilo Name con il nome utente dell'utente.
```
aws identitystore list-users \
  --identity-store-id d-123EXAMPLE \
  --filters AttributePath=UserName,AttributeValue=Name
```
  2. Usa la console IAM Identity Center per sfogliare i tuoi utenti e trovare un ID utente.
  Quindi, specifica l'ID utente (ad esempio123EXAMPLE-a1b2c3d4-5678-90ab-cdef-33333EXAMPLE) come valore predefinito per l'attributo o definisci l'attributo senza un valore predefinito.
```
{
  ...
  "assetModelProperties": [
    ...
    {
      "name": "userId",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "123EXAMPLE-a1b2c3d4-5678-90ab-cdef-33333EXAMPLE"
        }
      }
    }
  ]
}
```
3. (Facoltativo) Aggiungete un attributo che specifichi l'ID mittente predefinito per le notifiche di messaggi SMS (di testo). L'ID mittente viene visualizzato come mittente del messaggio nei messaggi inviati da Amazon Simple Notification Service (Amazon SNS). Per ulteriori informazioni, consulta Richiedere un ID mittente AWS End User Messaging SMS nella Guida per l'utente. AWS End User Messaging SMS
```
{
  ...
  "assetModelProperties": [
    ...
    {
      "name": "senderId",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "MyFactory"
        }
      }
    }
  ]
}
```
4. (Facoltativo) Aggiungi un attributo che specifichi l'indirizzo email predefinito da utilizzare come indirizzo mittente nelle notifiche e-mail.
```
{
  ...
  "assetModelProperties": [
    ...
    {
      "name": "fromAddress",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "my.factory@example.com"
        }
      }
    }
  ]
}
```
5. (Facoltativo) Aggiungi un attributo che specifichi l'oggetto predefinito da utilizzare nelle notifiche e-mail.
```
{
  ...
  "assetModelProperties": [
    ...
    {
      "name": "emailSubject",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "[ALERT] High boiler temperature"
        }
      }
    }
  ]
}
```
6. (Facoltativo) Aggiungi un attributo che specifichi un messaggio aggiuntivo da includere nelle notifiche. Per impostazione predefinita, i messaggi di notifica includono informazioni sull'allarme. È inoltre possibile includere un messaggio aggiuntivo che fornisce all'utente ulteriori informazioni.
```
{
  ...
  "assetModelProperties": [
    ...
    {
      "name": "additionalMessage",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Turn off the power before you check the alarm."
        }
      }
    }
  ]
}
```
Crea il modello di asset o aggiorna il modello di asset esistente. Esegui una delle seguenti operazioni:
- Per creare il modello di asset, eseguite il comando seguente.
```
aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json
```
- Per aggiornare il modello di asset esistente, eseguite il comando seguente. Sostituisci asset-model-id con l'ID del modello di asset.
```
aws iotsitewise update-asset-model \
  --asset-model-id asset-model-id \
  --cli-input-json file://asset-model-payload.json
```
Dopo aver eseguito il comando, assetModelId annotatelo nella risposta.

Il seguente modello di asset rappresenta una caldaia che riporta i dati di temperatura. Questo modello di asset definisce un allarme che rileva quando la caldaia si surriscalda.


{
  "assetModelName": "Boiler Model",
  "assetModelDescription": "Represents a boiler.",
  "assetModelProperties": [
    {
      "name": "Temperature",
      "dataType": "DOUBLE",
      "unit": "C",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "Temperature Max Threshold",
      "dataType": "DOUBLE",
      "type": {
        "attribute": {
          "defaultValue": "105.0"
        }
      }
    },
    {
      "name": "identityStoreId",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "d-123EXAMPLE"
        }
      }
    },
    {
      "name": "userId",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "123EXAMPLE-a1b2c3d4-5678-90ab-cdef-33333EXAMPLE"
        }
      }
    },
    {
      "name": "senderId",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "MyFactory"
        }
      }
    },
    {
      "name": "fromAddress",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "my.factory@example.com"
        }
      }
    },
    {
      "name": "emailSubject",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "[ALERT] High boiler temperature"
        }
      }
    },
    {
      "name": "additionalMessage",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Turn off the power before you check the alarm."
        }
      }
    }
  ],
  "assetModelHierarchies": [
  
  ],
  "assetModelCompositeModels": [
    {
      "name": "BoilerTemperatureHighAlarm",
      "type": "AWS/ALARM",
      "properties": [
        {
          "name": "AWS/ALARM_TYPE",
          "dataType": "STRING",
          "type": {
            "attribute": {
              "defaultValue": "IOT_EVENTS"
            }
          }
        },
        {
          "name": "AWS/ALARM_STATE",
          "dataType": "STRUCT",
          "dataTypeSpec": "AWS/ALARM_STATE",
          "type": {
            "measurement": {}
          }
        }
      ]
    }
  ]
}

Fase 2: Definire un AWS IoT Events modello di allarme

Crea il modello di allarme in AWS IoT Events. In AWS IoT Events, si utilizzano espressioni per specificare i valori nei modelli di allarme. È possibile utilizzare espressioni per specificare i valori AWS IoT SiteWise da valutare e utilizzare come input per l'allarme. Quando AWS IoT SiteWise invia i valori delle proprietà dell'asset al modello di allarme, AWS IoT Events valuta l'espressione per ottenere il valore della proprietà o l'ID della risorsa. È possibile utilizzare le seguenti espressioni nel modello di allarme:

Valori delle proprietà degli asset

Per ottenere il valore di una proprietà dell'asset, utilizzate l'espressione seguente. Sostituisci assetModelId con l'ID del modello di asset e sostituisci propertyId con l'ID della proprietà.
```
$sitewise.assetModel.`assetModelId`.`propertyId`.propertyValue.value
```
ID degli asset

Per ottenere l'ID della risorsa, utilizzate la seguente espressione. Sostituisci assetModelId con l'ID del modello di asset e sostituisci propertyId con l'ID della proprietà.
```
$sitewise.assetModel.`assetModelId`.`propertyId`.assetId
```

Nota

Quando si crea il modello di allarme, è possibile definire valori letterali anziché espressioni che restituiscono AWS IoT SiteWise valori. Ciò può ridurre il numero di attributi definiti nel modello di asset. Tuttavia, se definisci un valore come letterale, non puoi personalizzare quel valore sulle risorse in base al modello di asset. Inoltre, gli AWS IoT SiteWise Monitor utenti non possono personalizzare l'allarme, perché possono configurare le impostazioni degli allarmi solo sulle risorse.

Per creare un AWS IoT Events modello di allarme (CLI)

Quando si crea il modello di allarme in AWS IoT Events, è necessario specificare l'ID di ciascuna proprietà utilizzata dall'allarme, che include quanto segue:
- La proprietà dello stato di allarme nel modello di asset composito
- La proprietà monitorata dall'allarme
- L'attributo di soglia
- (Facoltativo) L'attributo ID dell'archivio di identità di IAM Identity Center
- (Facoltativo) L'attributo ID utente di IAM Identity Center
- (Facoltativo) L'attributo ID del mittente SMS
- (Facoltativo) L'attributo email da indirizzo
- (Facoltativo) L'attributo dell'oggetto dell'email
- (Facoltativo) L'attributo aggiuntivo del messaggio
Eseguite il comando seguente per recuperare gli ID di queste proprietà sul modello di asset. Sostituisci asset-model-id con l'ID del modello di asset del passaggio precedente.
```
aws iotsitewise describe-asset-model --asset-model-id asset-model-id
```
L'operazione restituisce una risposta contenente i dettagli del modello di asset. Annota l'ID di ogni proprietà utilizzata dall'allarme. Questi ID vengono utilizzati quando si crea il modello di AWS IoT Events allarme nel passaggio successivo.

Create il modello di allarme in AWS IoT Events. Esegui questa operazione:

Crea un file denominato alarm-model-payload.json.
Copia il seguente oggetto JSON nel file.
Inserisci un nome (alarmModelName), una descrizione (alarmModelDescription) e una gravità (severity) per l'allarme. Per quanto riguarda la gravità, specifica un numero intero che rifletta i livelli di gravità della tua azienda.

Importante
Il modello di allarme deve avere lo stesso nome del modello composito di allarme definito in precedenza nel modello di asset.
I nomi dei modelli di allarme possono contenere solo caratteri alfanumerici.
```
{
  "alarmModelName": "BoilerTemperatureHighAlarm",
  "alarmModelDescription": "Detects when the boiler temperature is high.",
  "severity": 3
}
```
Aggiungete la regola di confronto (alarmRule) all'allarme. Questa regola definisce la proprietà da monitorare (inputProperty), il valore di soglia da confrontare (threshold) e l'operatore di confronto da utilizzare (comparisonOperator).
- Sostituisci assetModelId con l'ID del modello di asset.
- Sostituisci alarmPropertyId con l'ID della proprietà monitorata dall'allarme.
- Sostituisci thresholdAttributeId con l'ID della proprietà dell'attributo di soglia.
- Sostituisci GREATER con l'operatore da utilizzare per confrontare i valori della proprietà con la soglia. Seleziona una delle opzioni seguenti:
  - LESS
  - LESS_OR_EQUAL
  - EQUAL
  - NOT_EQUAL
  - GREATER_OR_EQUAL
  - GREATER
```
{
  "alarmModelName": "BoilerTemperatureHighAlarm",
  "alarmModelDescription": "Detects when the boiler temperature is high.",
  "severity": 3,
  "alarmRule": {
    "simpleRule": {
      "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
      "comparisonOperator": "GREATER",
      "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
    }
  }
}
```

Aggiungete un'azione (alarmEventActions) per inviare lo stato di allarme al AWS IoT SiteWise momento in cui l'allarme cambia stato.

Nota

Per una configurazione avanzata, è possibile definire azioni aggiuntive da eseguire quando l'allarme cambia stato. Ad esempio, potresti chiamare una AWS Lambda funzione o pubblicarla su un argomento MQTT. Per ulteriori informazioni, consulta Lavorare con altri AWS servizi nella Guida per gli AWS IoT Events sviluppatori.

Sostituisci assetModelId con l'ID del modello di asset.
Sostituisci alarmPropertyId con l'ID della proprietà monitorata dall'allarme.
Sostituisci alarmStatePropertyId con l'ID della proprietà dello stato di allarme nel modello composito di allarme.


{
  "alarmModelName": "BoilerTemperatureHighAlarm",
  "alarmModelDescription": "Detects when the boiler temperature is high.",
  "severity": 3,
  "alarmRule": {
    "simpleRule": {
      "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
      "comparisonOperator": "GREATER",
      "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
    }
  },
  "alarmEventActions": {
    "alarmActions": [
      {
        "iotSiteWise": {
          "assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
          "propertyId": "'alarmStatePropertyId'"
        }
      }
    ]
  }
}

(Facoltativo) Configura le impostazioni di notifica degli allarmi. L'azione di notifica degli allarmi utilizza una funzione Lambda nel tuo account per inviare notifiche di allarme. Per ulteriori informazioni, consulta Requisiti per le notifiche di allarme in AWS IoT SiteWise. Nelle impostazioni delle notifiche di allarme, puoi configurare le notifiche SMS ed e-mail da inviare agli utenti di IAM Identity Center. Esegui questa operazione:

Aggiungi la configurazione delle notifiche di allarme (alarmNotification) al payload inalarm-model-payload.json.

Sostituisci alarmNotificationFunctionArn con l'ARN della funzione Lambda che gestisce le notifiche di allarme.


{
  "alarmModelName": "BoilerTemperatureHighAlarm",
  "alarmModelDescription": "Detects when the boiler temperature is high.",
  "severity": 3,
  "alarmRule": {
    "simpleRule": {
      "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
      "comparisonOperator": "GREATER",
      "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
    }
  },
  "alarmEventActions": {
    "alarmActions": [
      {
        "iotSiteWise": {
          "assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
          "propertyId": "'alarmStatePropertyId'"
        }
      }
    ]
  },
  "alarmNotification": {
    "notificationActions": [
      {
        "action": {
          "lambdaAction": {
            "functionArn": "alarmNotificationFunctionArn"
          }
        }
      }
    ]
  }
}

(Facoltativo) Configura le notifiche SMS (smsConfigurations) da inviare a un utente di IAM Identity Center quando l'allarme cambia stato.

Sostituisci identityStoreIdAttributeId con l'ID dell'attributo che contiene l'ID dell'archivio di identità di IAM Identity Center.
Sostituisci userIdAttributeId con l'ID dell'attributo che contiene l'ID dell'utente dell'IAM Identity Center.
Sostituiscilo senderIdAttributeId con l'ID dell'attributo che contiene l'ID mittente di Amazon SNS o rimuovilo senderId dal payload.
Sostituiscilo additionalMessageAttributeId con l'ID dell'attributo che contiene il messaggio aggiuntivo o rimuovilo additionalMessage dal payload.


{
  "alarmModelName": "BoilerTemperatureHighAlarm",
  "alarmModelDescription": "Detects when the boiler temperature is high.",
  "severity": 3,
  "alarmRule": {
    "simpleRule": {
      "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
      "comparisonOperator": "GREATER",
      "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
    }
  },
  "alarmEventActions": {
    "alarmActions": [
      {
        "iotSiteWise": {
          "assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
          "propertyId": "'alarmStatePropertyId'"
        }
      }
    ]
  },
  "alarmNotification": {
    "notificationActions": [
      {
        "action": {
          "lambdaAction": {
            "functionArn": "alarmNotificationFunctionArn"
          }
        },
        "smsConfigurations": [
          {
            "recipients": [
              {
                "ssoIdentity": {
                  "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                  "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                }
              }
            ],
            "senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
            "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
          }
        ]
      }
    ]
  }
}

(Facoltativo) Configura le notifiche e-mail (emailConfigurations) da inviare a un utente di IAM Identity Center quando l'allarme cambia stato.

Sostituisci identityStoreIdAttributeId con l'ID della proprietà dell'attributo ID dell'archivio di identità di IAM Identity Center.
Sostituisci userIdAttributeId con l'ID della proprietà dell'attributo ID utente di IAM Identity Center.
Sostituisci fromAddressAttributeId con l'ID della proprietà dell'attributo dell'indirizzo «from» o rimuovi from dal payload.
Sostituisci emailSubjectAttributeId con l'ID della proprietà dell'attributo dell'oggetto dell'email o rimuovi subject dal payload.
Sostituisci additionalMessageAttributeId con l'ID della proprietà aggiuntiva dell'attributo del messaggio o rimuovi additionalMessage dal payload.


{
  "alarmModelName": "BoilerTemperatureHighAlarm",
  "alarmModelDescription": "Detects when the boiler temperature is high.",
  "severity": 3,
  "alarmRule": {
    "simpleRule": {
      "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
      "comparisonOperator": "GREATER",
      "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
    }
  },
  "alarmEventActions": {
    "alarmActions": [
      {
        "iotSiteWise": {
          "assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
          "propertyId": "'alarmStatePropertyId'"
        }
      }
    ]
  },
  "alarmNotification": {
    "notificationActions": [
      {
        "action": {
          "lambdaAction": {
            "functionArn": "alarmNotificationFunctionArn"
          }
        },
        "smsConfigurations": [
          {
            "recipients": [
              {
                "ssoIdentity": {
                  "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                  "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                }
              }
            ],
            "senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
            "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
          }
        ],
        "emailConfigurations": [
          {
            "from": "$sitewise.assetModel.`assetModelId`.`fromAddressAttributeId`.propertyValue.value",
            "recipients": {
              "to": [
                {
                  "ssoIdentity": {
                    "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                    "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                  }
                }
              ]
            },
            "content": {
              "subject": "$sitewise.assetModel.`assetModelId`.`emailSubjectAttributeId`.propertyValue.value",
              "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
            }
          }
        ]
      }
    ]
  }
}

(Facoltativo) Aggiungete le funzionalità di allarme (alarmCapabilities) al payload in ingresso. alarm-model-payload.json In questo oggetto, è possibile specificare se il flusso di riconoscimento è abilitato e lo stato di abilitazione predefinito per le risorse in base al modello di asset. Per ulteriori informazioni sul flusso di riconoscimento, vedere. Stati di allarme


{
  "alarmModelName": "BoilerTemperatureHighAlarm",
  "alarmModelDescription": "Detects when the boiler temperature is high.",
  "severity": 3,
  "alarmRule": {
    "simpleRule": {
      "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
      "comparisonOperator": "GREATER",
      "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
    }
  },
  "alarmEventActions": {
    "alarmActions": [
      {
        "iotSiteWise": {
          "assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
          "propertyId": "'alarmStatePropertyId'"
        }
      }
    ]
  },
  "alarmNotification": {
    "notificationActions": [
      {
        "action": {
          "lambdaAction": {
            "functionArn": "alarmNotificationFunctionArn"
          }
        },
        "smsConfigurations": [
          {
            "recipients": [
              {
                "ssoIdentity": {
                  "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                  "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                }
              }
            ],
            "senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
            "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
          }
        ],
        "emailConfigurations": [
          {
            "from": "$sitewise.assetModel.`assetModelId`.`fromAddressAttributeId`.propertyValue.value",
            "recipients": {
              "to": [
                {
                  "ssoIdentity": {
                    "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                    "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                  }
                }
              ]
            },
            "content": {
              "subject": "$sitewise.assetModel.`assetModelId`.`emailSubjectAttributeId`.propertyValue.value",
              "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
            }
          }
        ]
      }
    ]
  },
  "alarmCapabilities": {
    "initializationConfiguration": {
      "disabledOnInitialization": false
    },
    "acknowledgeFlow": {
      "enabled": true
    }
  }
}

Aggiungi il ruolo del servizio IAM (roleArn) a cui AWS IoT Events può essere assegnato l'invio dei dati. AWS IoT SiteWise Questo ruolo richiede l'iotsitewise:BatchPutAssetPropertyValueautorizzazione e una relazione di fiducia che iotevents.amazonaws.com consenta di assumere il ruolo. Per inviare notifiche, questo ruolo richiede anche le sso-directory:DescribeUser autorizzazioni lambda:InvokeFunction and. Per ulteriori informazioni, consulta Ruoli del servizio Alarm nella Guida per AWS IoT Events gli sviluppatori.

Sostituisci il roleArn con l'ARN del ruolo che AWS IoT Events può assumere per eseguire queste azioni.


{
  "alarmModelName": "BoilerTemperatureHighAlarm",
  "alarmModelDescription": "Detects when the boiler temperature is high.",
  "severity": 3,
  "alarmRule": {
    "simpleRule": {
      "inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
      "comparisonOperator": "GREATER",
      "threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
    }
  },
  "alarmEventActions": {
    "alarmActions": [
      {
        "iotSiteWise": {
          "assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
          "propertyId": "'alarmStatePropertyId'"
        }
      }
    ]
  },
  "alarmNotification": {
    "notificationActions": [
      {
        "action": {
          "lambdaAction": {
            "functionArn": "alarmNotificationFunctionArn"
          }
        },
        "smsConfigurations": [
          {
            "recipients": [
              {
                "ssoIdentity": {
                  "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                  "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                }
              }
            ],
            "senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
            "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
          }
        ],
        "emailConfigurations": [
          {
            "from": "$sitewise.assetModel.`assetModelId`.`fromAddressAttributeId`.propertyValue.value",
            "recipients": {
              "to": [
                {
                  "ssoIdentity": {
                    "identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
                    "userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
                  }
                }
              ]
            },
            "content": {
              "subject": "$sitewise.assetModel.`assetModelId`.`emailSubjectAttributeId`.propertyValue.value",
              "additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
            }
          }
        ]
      }
    ]
  },
  "alarmCapabilities": {
    "initializationConfiguration": {
      "disabledOnInitialization": false
    },
    "acknowledgeFlow": {
      "enabled": false
    }
  },
  "roleArn": "arn:aws:iam::123456789012:role/MyIoTEventsAlarmRole"
}

Eseguite il comando seguente per creare il modello di AWS IoT Events allarme dal payload in. alarm-model-payload.json
```
aws iotevents create-alarm-model --cli-input-json file://alarm-model-payload.json
```
L'operazione restituisce una risposta che include l'ARN del modello di allarme,. alarmModelArn Copia questo ARN per impostarlo nella definizione dell'allarme sul tuo modello di asset nel passaggio successivo.

Passaggio 3: abilita il flusso di dati tra AWS IoT SiteWise and AWS IoT Events

Dopo aver creato le risorse richieste in AWS IoT SiteWise e AWS IoT Events, puoi abilitare il flusso di dati tra le risorse per attivare l'allarme. In questa sezione, si aggiorna la definizione dell'allarme nel modello di asset per utilizzare il modello di allarme creato nel passaggio precedente.

Per abilitare il flusso di dati tra AWS IoT SiteWise and AWS IoT Events (CLI)

Imposta il modello di allarme come fonte dell'allarme nel modello di asset. Esegui questa operazione:

Esegui il comando seguente per recuperare la definizione del modello di asset esistente. Sostituisci asset-model-id con l'ID del modello di asset.
```
aws iotsitewise describe-asset-model --asset-model-id asset-model-id
```
L'operazione restituisce una risposta contenente i dettagli del modello di asset.
Crea un file denominato update-asset-model-payload.json e copia la risposta del comando precedente nel file.
Rimuovete le seguenti coppie chiave-valore dal update-asset-model-payload.json file:
- assetModelId
- assetModelArn
- assetModelCreationDate
- assetModelLastUpdateDate
- assetModelStatus

Aggiungete la proprietà della fonte di allarme (AWS/ALARM_SOURCE) al modello composito di allarme definito in precedenza. Sostituisci alarmModelArn con l'ARN del modello di allarme, che imposta il valore della proprietà della fonte di allarme.


{
  ...
  "assetModelCompositeModels": [
    ...
    {
      "name": "BoilerTemperatureHighAlarm",
      "type": "AWS/ALARM",
      "properties": [
        {
          "id": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
          "name": "AWS/ALARM_TYPE",
          "dataType": "STRING",
          "type": {
            "attribute": {
              "defaultValue": "IOT_EVENTS"
            }
          }
        },
        {
          "id": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
          "name": "AWS/ALARM_STATE",
          "dataType": "STRUCT",
          "dataTypeSpec": "AWS/ALARM_STATE",
          "type": {
            "measurement": {}
          }
        },
        {
          "name": "AWS/ALARM_SOURCE",
          "dataType": "STRING",
          "type": {
            "attribute": {
              "defaultValue": "alarmModelArn"
            }
          }
        }
      ]
    }
  ]
}

Eseguite il comando seguente per aggiornare il modello di asset con la definizione memorizzata nel update-asset-model-payload.json file. Sostituisci asset-model-id con l'ID del modello di asset.
```
aws iotsitewise update-asset-model \
  --asset-model-id asset-model-id \
  --cli-input-json file://update-asset-model-payload.json
```

Il tuo modello di asset ora definisce un allarme che rileva l'ingresso. AWS IoT Events L'allarme monitora la proprietà target in tutte le risorse in base a questo modello di asset. È possibile configurare l'allarme su ogni risorsa per personalizzare proprietà come la soglia o il destinatario dello IAM Identity Center per ogni risorsa. Per ulteriori informazioni, consulta Configura gli allarmi sulle risorse in AWS IoT SiteWise.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Requisiti per le notifiche di allarme

Definisci allarmi esterni