翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# でアセットにアラームを設定する AWS IoT SiteWise
アセットモデルに AWS IoT Events アラームを定義したら、アセットモデルに基づいて各アセットにアラームを設定できます。アラームのしきい値や通知設定を編集することができます。これらの値はそれぞれアセット上の属性であるため、属性のデフォルト値を更新することでこれらの値を設定することができます。
**注記**
これらの値は AWS IoT Events アラームには設定できますが、外部アラームには設定できません。
**Topics**
+ [しきい値を設定する (コンソール)](#configure-alarm-threshold-value-console)
+ [しきい値を設定する (AWS CLI)](#configure-alarm-threshold-value-cli)
+ [で通知設定を構成する AWS IoT SiteWise](configure-alarm-notification-settings.md)
## しきい値を設定する (コンソール)
AWS IoT SiteWise コンソールを使用して、アラームのしきい値を指定する属性の値を更新できます。
**アラームのしきい値を更新するには (コンソール)。**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。
1. ナビゲーションペインで [**Assets (アセット) **] を選択します。
1. アラームしきい値を更新したいアセットを選択します。
**ヒント**
矢印アイコンを選択して、アセット階層を展開してアセットを検索できます。
1. **[編集]** を選択します。
1. アラームがしきい値に使用している属性を検索し、新しい値を入力します。
1. **[保存]** を選択します。
## しきい値を設定する (AWS CLI)
AWS Command Line Interface (AWS CLI) を使用して、アラームのしきい値を指定する属性の値を更新できます。
この手順を完了するには、アセットの `assetId` とプロパティの `propertyId` を知っている必要があります。外部 ID を使用することもできます。アセットを作成したが、その `assetId` がわからない場合は、[ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html) API を使用して、特定のモデルのすべてのアセットを一覧表示します。[DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) オペレーションを使用して、プロパティ ID を含むアセットのプロパティを表示します。
[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) オペレーションを使用して、アセットに属性値を割り当てます。このオペレーションを使用すると、複数の属性を一度に設定できます。このオペレーションのペイロードにはエントリのリストが含まれ、各エントリにはアセット ID、プロパティ ID、属性値が含まれます。
**属性の値を更新するには (AWS CLI)**
1. `batch-put-payload.json` という名前のファイルを作成して、次の JSON オブジェクトをファイルにコピーします。このペイロードの例は、風力タービンの緯度と経度を設定する方法を示しています。ID、値、タイムスタンプを更新して、ユースケースのペイロードを変更します。
```
{
"entries": [
{
"entryId": "windfarm3-turbine7-latitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 47.6204
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
},
{
"entryId": "windfarm3-turbine7-longitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 122.3491
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
}
]
}
```
+ ペイロードの各エントリには、一意の文字列として定義できる `entryId` が含まれています。リクエストのエントリが失敗した場合、各エラーには、対応するリクエストの `entryId` が含まれるため、再試行するリクエストを確認できます。
+ 属性値を設定するには、各属性プロパティの `propertyValues` のリストに 1 つのタイムスタンプ品質値 (TQV) 構造を含めることができます。この構造には、新しい `value` および現在の `timestamp` を含める必要があります。
+ `value` - 設定中のプロパティの型に応じて、次のいずれかのフィールドを含む構造。
+ `booleanValue`
+ `doubleValue`
+ `integerValue`
+ `stringValue`
+ `nullValue`
+ `timestamp` – 現在の Unix エポック時間を秒単位で含む構造`timeInSeconds`。. は、過去 7 日以上、または今後 5 分より新しいタイムスタンプを持つデータポイント AWS IoT SiteWise を拒否します。
[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) の ペイロードを準備する方法の詳細については、[AWS IoT SiteWise APIs を使用してデータを取り込む](ingest-api.md) を参照してください。
1. 次のコマンドを実行して、属性値を AWS IoT SiteWiseに送信します。
```
aws iotsitewise batch-put-asset-property-value -\-cli-input-json file://batch-put-payload.json
```
# で通知設定を構成する AWS IoT SiteWise
アラーム通知設定は、 AWS IoT SiteWise コンソールまたは AWS Command Line Interface () を使用して設定できますAWS CLI。
## 通知設定を行う (コンソール)
AWS IoT SiteWise コンソールを使用して、アラームの通知設定を指定する属性の値を更新できます。
**アラームの通知設定を更新するには (コンソール)。**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。
1. ナビゲーションペインで [**アセット**] を選択します。
1. アラーム設定を更新するアセットを選択します。
1. **[編集]** を選択します。
1. 変更したい通知設定にアラームが使用している属性を探し、その新しい値を入力します。
1. **[保存]** を選択します。
## 通知設定を行う (CLI)
AWS Command Line Interface (AWS CLI) を使用して、アラームの通知設定を指定する属性の値を更新できます。
この手順を完了するには、アセットの `assetId` とプロパティの `propertyId` を知っている必要があります。外部 ID を使用することもできます。アセットを作成したが、その `assetId` がわからない場合は、[ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html) API を使用して、特定のモデルのすべてのアセットを一覧表示します。[DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) オペレーションを使用して、プロパティ ID を含むアセットのプロパティを表示します。
[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) オペレーションを使用して、アセットに属性値を割り当てます。このオペレーションを使用すると、複数の属性を一度に設定できます。このオペレーションのペイロードにはエントリのリストが含まれ、各エントリにはアセット ID、プロパティ ID、属性値が含まれます。
**属性の値を更新するには (AWS CLI)**
1. `batch-put-payload.json` という名前のファイルを作成して、次の JSON オブジェクトをファイルにコピーします。このペイロードの例は、風力タービンの緯度と経度を設定する方法を示しています。ID、値、タイムスタンプを更新して、ユースケースのペイロードを変更します。
```
{
"entries": [
{
"entryId": "windfarm3-turbine7-latitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 47.6204
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
},
{
"entryId": "windfarm3-turbine7-longitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 122.3491
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
}
]
}
```
+ ペイロードの各エントリには、一意の文字列として定義できる `entryId` が含まれています。リクエストのエントリが失敗した場合、各エラーには、対応するリクエストの `entryId` が含まれるため、再試行するリクエストを確認できます。
+ 属性値を設定するには、各属性プロパティの `propertyValues` のリストに 1 つのタイムスタンプ品質値 (TQV) 構造を含めることができます。この構造には、新しい `value` および現在の `timestamp` を含める必要があります。
+ `value` - 設定中のプロパティの型に応じて、次のいずれかのフィールドを含む構造。
+ `booleanValue`
+ `doubleValue`
+ `integerValue`
+ `stringValue`
+ `nullValue`
+ `timestamp` – 現在の Unix エポック時間を秒単位で含む構造`timeInSeconds`。. は、過去 7 日以上、または今後 5 分より新しいタイムスタンプを持つデータポイント AWS IoT SiteWise を拒否します。
[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) の ペイロードを準備する方法の詳細については、[AWS IoT SiteWise APIs を使用してデータを取り込む](ingest-api.md) を参照してください。
1. 次のコマンドを実行して、属性値を AWS IoT SiteWiseに送信します。
```
aws iotsitewise batch-put-asset-property-value -\-cli-input-json file://batch-put-payload.json
```