コンポーネントモデルを作成する

AWS IoT SiteWise コンポーネントモデルを使用して、アセットモデルやその他のコンポーネントモデルから参照できるサブアセンブリを定義します。このようにして、コンポーネントの定義を他の複数のモデル間で、または同じモデル内で複数回再利用できます。

コンポーネントモデルを定義するプロセスは、アセットモデルを定義するのと非常によく似ています。アセットモデルと同様に、コンポーネントモデルには名前、説明、アセットプロパティがあります。ただし、コンポーネントモデル自体を使用してアセットを直接作成することはできないため、コンポーネントモデルにアセット階層定義を含めることはできません。また、コンポーネントモデルではアラームを定義できません。

例えば、モーター温度、エンコーダー温度、および衝撃耐性特性を持つサーボモーターのコンポーネントを定義できます。次に、CNC機械などのサーボモーターを含む機器のアセットモデルを定義できます。

注記

最下位レベルのノードから業務をモデル化することをお勧めします。例えば、CNC機械のアセットモデルを作成する前に、サーボモーターコンポーネントを作成します。アセットモデルには、既存のコンポーネントモデルへの参照が含まれています。
コンポーネントモデルから直接アセットを作成することはできません。コンポーネントを使用するアセットを作成するには、アセットのアセットモデルを作成する必要があります。次に、コンポーネントを参照するカスタム複合モデルを作成します。アセットモデルの作成の詳細については、アセットモデルの作成「」を参照してください。カスタム複合モデルの作成の詳細については、「」を参照してくださいカスタム複合モデル (コンポーネント) を作成する。

以下のセクションでは、を使用して AWS IoT SiteWise APIコンポーネントモデルを作成する方法について説明します。

コンポーネントモデルを作成する (AWS CLI）

AWS Command Line Interface （AWS CLI) を使用してコンポーネントモデルを作成できます。

CreateAssetModel オペレーションを使用して、プロパティを持つコンポーネントモデルを作成します。このオペレーションでは、次の構造を持つペイロードが必要です。


{
  "assetModelType": "COMPONENT_MODEL",
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
}

コンポーネントモデルを作成するには (AWS CLI）

という名前のファイルを作成しcomponent-model-payload.json、次のJSONオブジェクトをファイルにコピーします。
```
{
  "assetModelType": "COMPONENT_MODEL",
  "assetModelName": "",
  "assetModelDescription": "",
  "assetModelProperties": [

  ]
}
```
任意のJSONテキストエディタを使用して、次のcomponent-model-payload.jsonファイルを編集します。
1. コンポーネントモデルの名前 (assetModelName) を入力しますServo Motor Model。例: Servo Motorまたは。この名前は、こののアカウント内のすべてのアセットモデルとコンポーネントモデルで一意である必要があります AWS リージョン。
2. （オプション) コンポーネントモデルの外部 ID (assetModelExternalId) を入力します。これはユーザー定義の ID です。詳細については、AWS IoT SiteWise ユーザーガイドの外部でオブジェクトを参照する IDsを参照してください。
3. (オプション) アセットモデルの説明 (assetModelDescription) を入力するか、assetModelDescription キーと値のペアを削除します。
4. （オプション) コンポーネントモデルのアセットプロパティ (assetModelProperties) を定義します。詳細については、「データプロパティを定義する」を参照してください。
5. (オプション) アセットモデルのタグ (tags) を追加します。詳細については、「AWS IoT SiteWise リソースにタグを付ける」を参照してください。
次のコマンドを実行して、 JSON ファイルの定義からコンポーネントモデルを作成します。
```
aws iotsitewise create-asset-model --cli-input-json file://component-model-payload.json
```
オペレーションは、アセットモデルまたは別のコンポーネントモデルでコンポーネントモデルへの参照を追加するときに参照assetModelIdするを含むレスポンスを返します。レスポンスには、モデルの状態 (assetModelStatus.state) も含まれます。これは、最初は CREATING です。変更が反映されCREATINGるまで、コンポーネントモデルのステータスはです。

注記
複雑なモデルの場合、コンポーネントモデルの作成プロセスには数分かかることがあります。コンポーネントモデルの現在のステータスを確認するには、を指定して DescribeAssetModelオペレーションを使用しますassetModelId。コンポーネントモデルのステータスがになったらACTIVE、アセットモデルまたは他のコンポーネントモデルでコンポーネントモデルへの参照を追加できます。詳細については、「アセットおよびモデルの状態」を参照してください。
（オプション) コンポーネントモデルのカスタム複合モデルを作成します。カスタム複合モデルでは、モデル内のプロパティをグループ化したり、別のコンポーネントモデルを参照してサブパーティクルを含めることができます。詳細については、「カスタム複合モデル (コンポーネント) を作成する」を参照してください。

コンポーネントモデルの例

このセクションでは、 AWS CLI およびでコンポーネントモデルを作成するために使用できるコンポーネントモデル定義の例を示します AWS IoT SiteWise SDKs。このコンポーネントモデルは、CNC機械などの別の機器内で使用できるサーボモーターを表します。

トピック

Servo モーターコンポーネントモデル

Servo モーターコンポーネントモデル

次のコンポーネントモデルは、CNC機械などの機器内で使用できるサーボモーターを表しています。サーボモーターは、温度や耐電力など、さまざまな測定値を提供します。これらの測定値は、サーボモーターコンポーネントモデルを参照するアセットモデルから作成されたアセットのプロパティとして使用できます。


{
    "assetModelName": "ServoMotor",
    "assetModelType": "COMPONENT_MODEL",
    "assetModelProperties": [
        {
            "dataType": "DOUBLE",
            "name": "Servo Motor Temperature",
            "type": {
            "measurement": {}
            },
            "unit": "Celsius"
        },
        {
            "dataType": "DOUBLE",
            "name": "Spindle speed",
            "type": {
            "measurement": {}
            },
            "unit": "rpm"
        }
    ]
}

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

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

ドキュメントの表記規則

アセットモデル階層の定義

データプロパティを定義する