プロパティエイリアスを設定する (コンソール）プロパティエイリアスを設定する (AWS CLI）

産業データストリームをアセットプロパティにマッピングする

アセットプロパティでプロパティエイリアスを定義できます。これにより、アセットデータの取り込みまたは取得時にアセットプロパティを識別できます。アセットに測定プロパティがある場合は、プロパティエイリアスを定義して、データストリームをそのプロパティにマッピングすることができます。

このプロセスでは、プロパティのエイリアスを知っている必要があります。

Edge ゲートウェイの OPC UA データソースを使用して UA サーバーからデータを取り込む場合、プロパティエイリアスは Objects ノードの下の変数へのパスで、で始まります/。 OPC SiteWise

例
変数へのパスがの場合company/windfarm/3/turbine/7/temperature、プロパティエイリアスはです/company/windfarm/3/turbine/7/temperature。

OPC UA 情報アーキテクチャの詳細については、OPCUA オンラインリファレンスの「情報モデルとアドレス間隔マッピング」を参照してください。
メモ
- OPC UA ソースのデータストリームプレフィックスを設定する場合は、そのソースからのすべてのデータストリームのプロパティエイリアスにそのプレフィックスを含める必要があります。
  
  例
  /RentonWA がプレフィックスの場合、以前のエイリアスはです/RentonWA/company/windfarm/3/turbine/7/temperature。
- プロパティのエイリアスは、最大 1,000 バイトまで含むことができます。OPC UA 変数パスには、最大 4,096 バイトを含めることができます。現在、 AWS IoT SiteWise は長いパスを持つ OPC UA 変数からのデータの取り込みをサポートしていません。
SiteWise Edge ゲートウェイの Modbus TCPデータソースを使用して Modbus サーバーからデータを取り込む場合、プロパティエイリアスは次のとおりです。

Modbus register set tag name

この値を使用して、このレジスタセットからアセットプロパティにデータを送信します。
AWS IoT ルールやなど、他のソースからデータを取り込む場合はAPI、プロパティエイリアスを定義する必要があります。デバイス設定に適用可能なプロパティエイリアス命名システムを定義できます。たとえば、 AWS IoT のモノからデータを取り込む場合、プロパティエイリアスにモノの名を含めることで、データストリームを一意に識別できます。この例の詳細については、AWS IoT 「モノからのデータの取り込み」チュートリアルを参照してください。

プロパティエイリアスは、リージョンと AWS account AWS IoT SiteWise 内で一意である必要があります。プロパティエイリアスを別のアセットプロパティに既に存在するものに設定すると、エラーが返されます。

同じデータストリームパスを持つ複数の OPC UA ソースがある場合は、各ソースのパスにプレフィックスを追加して一意のエイリアスを作成します。詳細については、「OPC UA データソース」を参照してください。

注記

このセクションでは、測定プロパティのプロパティエイリアスを設定する方法について説明します。外部アラーム状態プロパティのプロパティエイリアスを設定する方法については、外部アラーム状態ストリームをマッピングするを参照してください。

プロパティエイリアスを設定する (コンソール）

AWS IoT SiteWise コンソールを使用して、アセットプロパティのエイリアスを設定できます。

プロパティエイリアスを設定するには (コンソール)

AWS IoT SiteWise コンソールに移動します。
ナビゲーションペインで [Assets (アセット) ] を選択します。
プロパティエイリアスを設定するアセットを選択します。

ヒント
矢印アイコンを選択して、アセット階層を展開してアセットを検索できます。
[編集] を選択します。
エイリアスを設定するプロパティを検索し、プロパティのエイリアスを入力します。
[Save] を選択します。

プロパティエイリアスを設定する (AWS CLI）

AWS Command Line Interface （AWS CLI) を使用して、アセットプロパティのエイリアスを設定します。

この手順を完了するには、アセットの assetId とプロパティの propertyId を知っている必要があります。外部 ID を使用することもできます。アセットを作成し、そのがわからない場合はassetId、を使用して特定のモデルのすべてのアセットをListAssetsAPI一覧表示します。DescribeAsset オペレーションを使用して、プロパティを含むアセットのプロパティを表示しますIDs。

UpdateAssetProperty オペレーションを使用して、データストリームをアセットのプロパティにマッピングします。以下のパラメータを指定します。

assetId – アセットの ID または外部 ID。詳細については、AWS IoT SiteWise ユーザーガイドの外部でオブジェクトを参照する IDsを参照してください。
propertyId – アセットプロパティの ID または外部 ID。
propertyAlias - プロパティへのエイリアスへのデータストリームのパス。
propertyNotificationState - プロパティ値の通知状態: ENABLED または DISABLED。プロパティのエイリアスを更新するときに、プロパティの既存の通知状態を指定します。DescribeAssetProperty オペレーションを使用して、既存の通知状態を取得できます。

このパラメータを省略すると、新しい通知状態が DISABLED になります。プロパティ通知の詳細については、「他の AWS サービスとやり取りする」を参照してください。

プロパティエイリアスを設定するには (AWS CLI）

次のコマンドを実行して、プロパティの現在の通知状態を取得します。置換 asset-id また、property-id アセットプロパティのを使用しますIDs。


aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

このオペレーションは、アセットプロパティの詳細を含むレスポンスを次の形式で返します。プロパティ通知の状態は JSON オブジェクトassetProperty.notification.stateのです。


{
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}

次のコマンドを実行して、アセットプロパティのエイリアスを設定します。置換 property-alias プロパティエイリアスおよびを持つ notification-state 通知状態を指定するか、を省略--property-notification-stateして通知を無効にします。オプションで、アセットの単位を新しいで更新できます。unit および --property-unit です。
```
aws iotsitewise update-asset-property \
  --asset-id asset-id \
  --property-id property-id \
  --property-alias property-alias \
  --property-notification-state notification-state \
  --property-unit unit
```

エイリアスが設定されていることを確認するには、以下のコマンドを実行してプロパティの詳細を取得します。置換 asset-id また、property-id アセットプロパティのを使用しますIDs。


aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

このオペレーションは、アセットプロパティの詳細を含むレスポンスを次の形式で返します。プロパティエイリアスは JSON オブジェクトassetProperty.aliasにあり、myAliasこの例ではに設定されています。


{
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "alias": "myAlias",
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

アセットの検索

属性値を更新する