Thing Types

Thing Typeは、デバイスのカテゴリを定義するスキーマテンプレートです。デバイスが報告するプロパティ、発生させるイベント、受け付けるコマンドを記述します。個々のデバイス（Thing）はThing Typeに登録され、その構造を継承します。

Thing Typeが作成されると、Fleetsは自動的にそのタイプのすべてのThingを含むデフォルトThingグループを作成します。グループ管理の詳細はThing Groupsを参照してください。

Thing Typeの作成

1. Fleetsのデプロイメントで、Device Management > Thing Types に移動します。
2. + New Type をクリックします。New Typeページが開きます。
3. 基本項目を入力します：
   • Name（必須）：デプロイメント内で一意の識別子。わかりやすくするためにリバースドメイン形式を推奨します。例：com.example.thermostat
   • Version：デフォルトは 1.0.0
   • Description（任意）
   • Tags（任意）
4. プロパティ、イベント、コマンドを追加してスキーマを定義します（以下参照）。すべてのセクションは任意で、空のままにして後からThing Typeを編集して追加することも可能です。
5. Confirm をクリックします。

プロパティの追加

プロパティはデバイスが報告する状態変数を表します。書き込み可能なプロパティはDevice Shadow経由でクラウドから設定可能です。

1. Properties セクションで + Add をクリックします。
2. 以下の項目を入力します：
   • Name：プロパティ名
   • Type：string、int、float、boolean、enum のいずれかを選択
   • Writable：シャドウのdesired stateを通じてクラウド側からの更新を許可する場合はオンにします
   • Description（任意）
3. 数値型（int または float）の場合は、Number constraints を展開して設定します：
   • Unit（任意）：単位（例：°C、%）
   • Min / Max（任意）：許容値の範囲
4. Confirm をクリックします。

イベントの追加

イベントは、アラームや故障状態など、デバイスが発生させる名前付きの事象です。

1. Events セクションで + Add をクリックします。
2. 以下の項目を入力します：
   • Name：イベント名
   • Severity：info、warn、error のいずれかを選択。デフォルトは warn
   • Description（任意）
3. Confirm をクリックします。

コマンドの追加

コマンドは、デバイスに実行させるアクションです。

1. Commands セクションで + Add をクリックします。
2. 以下の項目を入力します：
   • Name：コマンド名
   • Type：sync（リアルタイム、タイムアウト設定可能）
   • Timeout (ms)：Fleetsがデバイスの応答を待つ時間。デフォルトは 5000
   • Description（任意）
3. 入力パラメータを追加するには、Input セクションの + Add をクリックし、Add FieldダイアログでNameとType（string、int、float、boolean、enum）を入力します。
4. 出力パラメータを追加するには、Output セクションの + Add をクリックし、同様に入力します。
5. Confirm をクリックします。

Raw JSON

右上の Raw JSON を切り替えると、編集中のスキーマ全体をJSONオブジェクトとして表示できます。プロパティ、イベント、コマンドを追加するとリアルタイムで更新されます。

Thing Typeのインポート

JSONファイルからThing Typeをインポートして、デプロイメントや環境間でスキーマを再利用できます。

1. Thing Types ページ右上の Import をクリックします。
2. Download Template をクリックして、期待されるフォーマットのサンプルJSONファイルを取得します。
3. テンプレートを編集してスキーマを作成し、Select File でファイルを選択します。
4. Import をクリックします。

同じ名前のThing Typeが既に存在する場合はエラーになります。

Thing Typeの表示

リスト内のThing Type名をクリックすると詳細ページが開きます。詳細ページでは基本情報とスキーマ（プロパティ、イベント、コマンド）を読み取り専用で確認できます。右上の編集アイコンをクリックするとEdit Typeページが開きます。

Thing Typeのエクスポート

Thing TypeをJSONファイルとしてエクスポートするには、Actions 列のエクスポートアイコンをクリックします。このファイルは別のデプロイメントに同じスキーマをインポートする際に使用できます。

Thing Typeの更新

基本情報（名前、バージョン、説明、タグ）を編集するには：

1. Thing Types リストの Actions 列にある編集アイコンをクリックするか、詳細ページの右上にある編集アイコンをクリックします。
2. 項目を修正します。
3. Save をクリックします。

スキーマ（プロパティ、イベント、コマンドの追加・削除）を更新するには、Edit Typeページを開き、+ Add ボタンや各項目の削除アイコンを使用します。

重要なお知らせ

Thing Typeのスキーマを更新しても、既存のThingのシャドウ状態やプロパティは自動的に更新されません。変更は更新後に登録されたThingに適用されます。

Thing Typeの削除

1. Thing Types リストの Actions 列にある削除アイコンをクリックします。
2. 削除を確認します。

Thing Typeに登録されたThingが存在する場合は削除できません。関連するThingをすべて削除または再割り当てしてください。

Thing Typeを削除すると、そのデフォルトThingグループも削除されます。

次のステップ

• Things
• Thing Groups
• Device Shadow