Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menelan status alarm eksternal di AWS IoT SiteWise
<a name="ingest-external-alarm-state"></a>

Alarm eksternal adalah alarm yang Anda evaluasi di luar. AWS IoT SiteWise Anda dapat menggunakan alarm eksternal ketika Anda memiliki sumber data yang melaporkan status alarm yang ingin Anda konsumsi. AWS IoT SiteWise

Properti status alarm memerlukan format khusus untuk nilai data status alarm. Setiap nilai data harus berupa objek JSON yang diserialisasikan ke string. Kemudian, Anda menelan string serial sebagai nilai string. Untuk informasi selengkapnya, lihat [Properti status alarm](industrial-alarms.md#alarm-state-properties).

**Example Contoh nilai data status alarm (tidak diserialisasi)**  

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

**Example Contoh nilai data status alarm (serial)**  

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

**catatan**  
Jika sumber data tidak dapat melaporkan data dalam format ini, atau Anda tidak dapat mengonversi data ke format ini sebelum menelannya, Anda mungkin memilih untuk tidak menggunakan properti alarm. Sebagai gantinya, Anda dapat menelan data sebagai properti pengukuran dengan tipe data string, misalnya. Untuk informasi selengkapnya, lihat [Tentukan aliran data dari peralatan (pengukuran)](measurements.md) dan [Menelan data ke AWS IoT SiteWise](industrial-data-ingestion.md).

# Petakan aliran status alarm eksternal di AWS IoT SiteWise
<a name="connect-alarm-data-streams"></a>

Anda dapat menentukan alias properti untuk memetakan aliran data Anda ke properti status alarm Anda. Ini membantu Anda dengan mudah mengidentifikasi properti status alarm saat Anda menelan atau mengambil data. Untuk informasi selengkapnya tentang alias properti, lihat[Mengelola aliran data untuk AWS IoT SiteWise](manage-data-streams.md).

**Topics**
+ [Peta aliran status alarm eksternal (konsol)](#connect-alarm-data-stream-console)
+ [Peta aliran status alarm eksternal ()AWS CLI](#connect-alarm-data-stream-cli)

## Peta aliran status alarm eksternal (konsol)
<a name="connect-alarm-data-stream-console"></a>

Anda dapat menentukan alias properti untuk memetakan aliran data Anda ke properti status alarm Anda. Ini membantu Anda dengan mudah mengidentifikasi properti status alarm saat Anda menelan atau mengambil data. Untuk informasi selengkapnya tentang alias properti, lihat[Mengelola aliran data untuk AWS IoT SiteWise](manage-data-streams.md).

Anda dapat menggunakan AWS IoT SiteWise konsol untuk menyetel alias untuk properti status alarm.

**Untuk menyetel alias properti untuk properti status alarm (konsol)**

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

1. <a name="sitewise-choose-assets"></a>Di panel navigasi, pilih **Aset**.

1. Pilih aset yang ingin Anda tetapkan alias properti.
**Tip**  <a name="sitewise-expand-asset-hierarchy"></a>
Anda dapat memilih ikon panah untuk memperluas hierarki aset untuk menemukan aset Anda.

1. Pilih **Edit**.

1. Gulir ke **Alarm** dan perluas bagian.

1. *Di bawah **Alarm Eksternal**, masukkan alias di alias **Properti - opsional**.*

1. Pilih **Simpan**.

## Peta aliran status alarm eksternal ()AWS CLI
<a name="connect-alarm-data-stream-cli"></a>

Anda dapat menentukan alias properti untuk memetakan aliran data Anda ke properti status alarm Anda. Ini membantu Anda dengan mudah mengidentifikasi properti status alarm saat Anda menelan atau mengambil data. Untuk informasi selengkapnya tentang alias properti, lihat[Mengelola aliran data untuk AWS IoT SiteWise](manage-data-streams.md).

Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk menyetel alias untuk properti status alarm.

Anda harus mengetahui aset `assetId` dan properti Anda `propertyId` untuk menyelesaikan prosedur ini. Anda juga dapat menggunakan ID eksternal. Jika Anda membuat aset dan tidak mengetahuinya`assetId`, gunakan [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API untuk mencantumkan semua aset untuk model tertentu. Gunakan [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)operasi untuk melihat properti aset Anda termasuk properti IDs.

**catatan**  
[DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)Tanggapan tersebut mencakup daftar model aset komposit untuk aset tersebut. Setiap alarm adalah model komposit. Untuk menemukan`propertyId`, temukan model komposit untuk alarm, dan kemudian temukan `AWS/ALARM_STATE` properti dalam model komposit itu.

Untuk informasi selengkapnya tentang cara menyetel alias properti, lihat[Memperbarui alias properti aset](update-data-streams-method.md).

# Menelan data status alarm di AWS IoT SiteWise
<a name="ingest-alarm-state-data"></a>

Properti status alarm mengharapkan status alarm sebagai string JSON serial. Untuk menyerap status alarm ke alarm eksternal AWS IoT SiteWise, Anda menelan string serial ini sebagai nilai string stempel waktu. Contoh berikut menunjukkan nilai data status untuk alarm aktif.

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

Untuk mengidentifikasi properti status alarm, Anda dapat menentukan salah satu dari berikut ini:
+ Alarm `assetId` dan `propertyId` properti alarm yang Anda kirimi datanya.
+ The`propertyAlias`, yang merupakan alias aliran data (misalnya,`/company/windfarm/3/turbine/7/temperature/high`). Untuk menggunakan opsi ini, Anda harus terlebih dahulu mengatur alias properti alarm Anda. Untuk mempelajari cara menyetel alias properti untuk properti status alarm, lihat[Petakan aliran status alarm eksternal di AWS IoT SiteWise](connect-alarm-data-streams.md).

Contoh payload [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)API berikut menunjukkan cara memformat status alarm eksternal. Alarm eksternal ini melaporkan ketika pembacaan rotasi turbin angin per menit (RPM) terlalu tinggi.

**Example Contoh BatchPutAssetPropertyValue payload untuk data status alarm**  

```
{
    "entries": [
      {
        "entryId": "unique entry ID",
        "propertyAlias": "/company/windfarm/3/turbine/7/temperature/high",
        "propertyValues": [
          {
            "value": {
              "stringValue": "{\"stateName\":\"Active\"}"
            },
            "timestamp": {
              "timeInSeconds": 1607550262
            }
          }
        ]
      }
    ]
  }
```
Untuk informasi selengkapnya tentang cara menggunakan `BatchPutAssetPropertyValue` API untuk menyerap data, lihat[Menelan data dengan AWS IoT SiteWise APIs](ingest-api.md).  
Untuk informasi selengkapnya tentang cara lain untuk menelan data, lihat[Menelan data ke AWS IoT SiteWise](industrial-data-ingestion.md).