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á.

# Defina alarmes externos em AWS IoT SiteWise
<a name="define-external-alarms"></a>

Os alarmes externos contêm o estado de um alarme que você detecta fora do AWS IoT SiteWise.

## Definir um alarme externo (console)
<a name="define-external-alarm-console"></a>

Você pode usar o AWS IoT SiteWise console para definir um alarme externo em um modelo de ativo existente. Para definir um alarme externo em um novo modelo de ativo, crie o modelo de ativo e execute essas etapas. Para obter mais informações, consulte [Crie modelos de ativos em AWS IoT SiteWise](create-asset-models.md).

**Para definir um alarme em um modelo de ativo**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-models"></a>No painel de navegação, selecione **Modelos**.

1. Escolha o modelo de ativo para o qual o alarme será definido.

1. Escolha a guia **Definições de alarme**.

1. Escolha **Adicionar alarme**.

1. Em **Opções do tipo de alarme**, escolha **Alarme externo**.

1. Insira um nome para o alarme.

1. (Opcional) Insira uma descrição do seu alarme.

1. Escolha **Adicionar alarme**.

## Definir um alarme externo (CLI)
<a name="define-external-alarm-cli"></a>

Você pode usar o AWS CLI para definir um alarme externo em um modelo de ativo novo ou existente.

Para adicionar um alarme externo a um modelo de ativo, você adiciona um modelo de alarme composto ao modelo de ativo. Um modelo de alarme composto especifica o tipo do `EXTERNAL` e não especifica uma propriedade da fonte de alarme. O exemplo de alarme composto a seguir define um alarme externo de temperatura.

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

Para obter mais informações sobre como adicionar um modelo composto a um modelo de ativo novo ou existente, consulte o seguinte:
+ [Criar um modelo de ativo (AWS CLI)](create-asset-models.md#create-asset-model-cli)
+ [Atualizar um modelo de ativo, modelo de componente ou interface (AWS CLI)](update-asset-models.md#update-asset-model-cli)

Depois de definir o alarme externo, você pode ingerir o estado do alarme nos ativos com base no modelo do ativo. Para obter mais informações, consulte [Ingerir um estado de alarme externo em AWS IoT SiteWise](ingest-external-alarm-state.md).