Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # AWS IoT SiteWise Tindakan AWS IoT SiteWise (`iotSiteWise`) mengirimkan data dari pesan MQTT ke properti aset di. AWS IoT SiteWise Anda dapat mengikuti tutorial yang menunjukkan cara menelan data dari AWS IoT berbagai hal. Untuk informasi selengkapnya, lihat tutorial [Menelan data ke AWS IoT SiteWise dari AWS IoT hal-hal](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/ingest-data-from-iot-things.html) atau bagian [Menyerap data menggunakan aturan AWS IoT Inti](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/iot-rules.html) di *AWS IoT SiteWise Panduan Pengguna*. ## Persyaratan Tindakan aturan ini memiliki persyaratan sebagai berikut: + Peran IAM yang AWS IoT dapat diasumsikan untuk melakukan `iotsitewise:BatchPutAssetPropertyValue` operasi. Untuk informasi selengkapnya, lihat [Memberikan AWS IoT aturan akses yang dibutuhkannya](iot-create-role.md). Anda dapat melampirkan contoh kebijakan kepercayaan berikut ke peran tersebut. **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*" } ] } ``` Untuk meningkatkan keamanan, Anda dapat menentukan jalur hierarki AWS IoT SiteWise aset di `Condition` properti. Contoh berikut adalah kebijakan kepercayaan yang menentukan jalur hierarki aset. **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/{{root node asset ID}}", "/{{root node asset ID}}/*" ] } } } ] } ``` + Saat Anda mengirim data AWS IoT SiteWise dengan tindakan ini, data Anda harus memenuhi persyaratan `BatchPutAssetPropertyValue` operasi. Untuk informasi selengkapnya, lihat [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) di dalam *Referensi API AWS IoT SiteWise *. ## Parameter Saat Anda membuat AWS IoT aturan dengan tindakan ini, Anda harus menentukan informasi berikut: `putAssetPropertyValueEntries` Daftar entri nilai properti aset yang masing-masing berisi informasi berikut: `propertyAlias` (Opsional) Alias properti yang terkait dengan properti aset Anda. Tentukan salah satu `propertyAlias` atau keduanya `assetId` dan a`propertyId`. *Untuk informasi selengkapnya tentang alias properti, lihat [Memetakan aliran data industri ke properti aset di Panduan](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/connect-data-streams.html) Pengguna.AWS IoT SiteWise * Mendukung [template substitusi](iot-substitution-templates.md): Ya `assetId` (Opsional) ID AWS IoT SiteWise aset. Tentukan salah satu `propertyAlias` atau keduanya `assetId` dan a`propertyId`. Mendukung [template substitusi](iot-substitution-templates.md): Ya `propertyId` (Opsional) ID properti aset. Tentukan salah satu `propertyAlias` atau keduanya `assetId` dan a`propertyId`. Mendukung [template substitusi](iot-substitution-templates.md): Ya `entryId` (Opsional) Pengidentifikasi unik untuk entri ini. Tentukan `entryId` untuk melacak pesan mana yang menyebabkan kesalahan dengan lebih baik jika terjadi kegagalan. Default untuk UUID baru. Mendukung [template substitusi](iot-substitution-templates.md): Ya `propertyValues` Daftar nilai properti untuk disisipkan yang masing-masing berisi stempel waktu, kualitas, dan nilai (TQV) dalam format berikut: `timestamp` Struktur stempel waktu yang berisi informasi berikut: `timeInSeconds` Sebuah string yang berisi waktu dalam detik dalam waktu epoch Unix. Jika payload pesan Anda tidak memiliki stempel waktu, Anda dapat menggunakan[stempel waktu ()](iot-sql-functions.md#iot-function-timestamp), yang mengembalikan waktu saat ini dalam milidetik. Untuk mengonversi waktu itu menjadi detik, Anda dapat menggunakan templat substitusi berikut:**${floor(timestamp() / 1E3)}**. Mendukung [template substitusi](iot-substitution-templates.md): Ya `offsetInNanos` (Opsional) String yang berisi offset waktu nanodetik dari waktu dalam detik. Jika payload pesan Anda tidak memiliki stempel waktu, Anda dapat menggunakan[stempel waktu ()](iot-sql-functions.md#iot-function-timestamp), yang mengembalikan waktu saat ini dalam milidetik. Untuk menghitung offset nanodetik sejak saat itu, Anda dapat menggunakan templat substitusi berikut:. **${(timestamp() % 1E3) \* 1E6}** Mendukung [template substitusi](iot-substitution-templates.md): Ya Mengenai waktu epoch Unix, hanya AWS IoT SiteWise menerima entri yang memiliki stempel waktu hingga 7 hari di masa lalu hingga 5 menit di masa depan. `quality` (Opsional) String yang menggambarkan kualitas nilai. Nilai-nilai yang valid: `GOOD`, `BAD`, `UNCERTAIN`. Mendukung [template substitusi](iot-substitution-templates.md): Ya `value` Struktur nilai yang berisi salah satu bidang nilai berikut, tergantung pada tipe data properti aset: `booleanValue` (Opsional) Sebuah string yang berisi nilai Boolean dari entri nilai. Mendukung [template substitusi](iot-substitution-templates.md): Ya `doubleValue` (Opsional) String yang berisi nilai ganda dari entri nilai. Mendukung [template substitusi](iot-substitution-templates.md): Ya `integerValue` (Opsional) Sebuah string yang berisi nilai integer dari entri nilai. Mendukung [template substitusi](iot-substitution-templates.md): Ya `stringValue` (Opsional) Nilai string dari entri nilai. Mendukung [template substitusi](iot-substitution-templates.md): Ya `roleArn` ARN dari peran IAM yang memberikan AWS IoT izin untuk mengirim nilai properti aset ke. AWS IoT SiteWise Untuk informasi selengkapnya, lihat [Persyaratan](#iotsitewise-rule-action-requirements). Mendukung [template substitusi](iot-substitution-templates.md): Tidak ## Contoh Contoh JSON berikut mendefinisikan SiteWise tindakan IoT dasar dalam sebuah aturan. AWS IoT ``` { "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "iotSiteWise": { "putAssetPropertyValueEntries": [ { "propertyAlias": "/some/property/alias", "propertyValues": [ { "timestamp": { "timeInSeconds": "${my.payload.timeInSeconds}" }, "value": { "integerValue": "${my.payload.value}" } } ] } ], "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sitewise" } } ] } } ``` Contoh JSON berikut mendefinisikan SiteWise tindakan IoT dalam sebuah aturan. AWS IoT Contoh ini menggunakan topik sebagai alias properti dan `timestamp()` fungsi. Misalnya, jika Anda mempublikasikan data ke`/company/windfarm/3/turbine/7/rpm`, tindakan ini mengirimkan data ke properti aset dengan alias properti yang sama dengan topik yang Anda tentukan. ``` { "topicRulePayload": { "sql": "SELECT * FROM '/company/windfarm/+/turbine/+/+'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "iotSiteWise": { "putAssetPropertyValueEntries": [ { "propertyAlias": "${topic()}", "propertyValues": [ { "timestamp": { "timeInSeconds": "${floor(timestamp() / 1E3)}", "offsetInNanos": "${(timestamp() % 1E3) * 1E6}" }, "value": { "doubleValue": "${my.payload.value}" } } ] } ], "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sitewise" } } ] } } ``` ## Lihat juga + [Apa itu AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) dalam *AWS IoT SiteWise Panduan Penggguna* + [Menelan data menggunakan AWS IoT Core aturan](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/iot-rules.html) di *AWS IoT SiteWise Panduan Pengguna* + [Menelan data AWS IoT SiteWise dari AWS IoT hal-hal](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/ingest-data-from-iot-things.html) di *AWS IoT SiteWise Panduan Pengguna* + [Memecahkan masalah tindakan AWS IoT SiteWise aturan](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshoot-rule.html) *di Panduan Pengguna AWS IoT SiteWise *