翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# マネージド統合データモデル
<a name="managedintegrations-data-model"></a>

Managed Integrations データモデルは、エンドユーザーと Managed Integrations 間のすべての通信を管理します。

**デバイス階層**

`endpoint` および `capability` データ要素は、 Managed Integrations データモデル内のデバイスを記述するために使用されます。

**`endpoint`**

は、機能によって提供される論理インターフェイスまたはサービス`endpoint`を表します。

```
{
    "endpointId": { "type":"string" },
    "capabilities": Capability[]
}
```

**`Capability`**

はデバイスの機能`capability`を表します。

```
{
    "$id": "string",                // Schema identifier (e.g. /schema-versions/capability/matter.OnOff@1.4)
    "name": "string",               // Human readable name
    "version": "string",            // e.g. 1.0  
    "properties": Property[],
    "actions": Action[],
    "events": Event[]
}
```

`capability` データ要素には、その項目を構成する 、`property`、 `action`の 3 つの項目があります`event`。デバイスを操作およびモニタリングするために使用できます。
+ **プロパティ**: 調光可能な光の現在の明るさレベルの属性など、デバイスが保持する状態。
  + 

    ```
    {
        "name":                      // Property Name is outside of Property Entity
        "value": Value,              // value represented in any type e.g. 4, "A", []
        "lastChangedAt": Timestamp   // ISO 8601 Timestamp upto milliseconds yyyy-MM-ddTHH:mm:ss.ssssssZ
        "mutable": boolean,
        "retrievable": boolean,
        "reportable": boolean
        
    }
    ```
+ **アクション**: ドアロックでドアをロックするなど、実行できるタスク。アクションはレスポンスと結果を生成する場合があります。
  + 

    ```
    { 
        "name": { "$ref": "/schema-versions/definition/aws.name@1.0" }, //required 
        "parameters": Map<String name, JSONNode value>, 
        "responseCode": HTTPResponseCode,
        "errors": { 
            "code": "string",
            "message": "string"
        }
    }
    ```
+ **イベント**: 基本的には、過去の状態遷移の記録です。は現在の状態`property`を表しますが、イベントは過去のジャーナルであり、単調に増加するカウンター、タイムスタンプ、優先度が含まれます。これにより、状態遷移と、 では容易に達成できないデータモデリングをキャプチャできます`property`。
  + 

    ```
    {
        "name": { "$ref": "/schema-versions/definition/aws.name@1.0" },        //required
        "parameters": Map<String name, JSONNode value> 
    }
    ```