デバイスIDを表すパラメータを教えてください。
Things Cloud, IoT, 仕様
2026年3月3日 (2026年3月3日:更新)
デバイスのIDを表すパラメータはAPIエンドポイントにより複数種類があり、異なる名称を用いているケースがあります。主な例は、以下の通りです。
インベントリ API
始めに、インベントリにマネージドオブジェクトとして保存されます。マネージドオブジェクトAPIにて、c8y_IsDevice:{} をbodyに含めPOSTすると、デバイスとしてマネージドオブジェクトが作成されます。その際のレスポンスに含まれるidが、デバイスのIDを示しています。
また、マネージドオブジェクトのGETをする際のdeviceIdは、デバイスのIDを指定します。
詳細はをご参照ください。RESTデバイスインテグレーション > Hello REST! > RESTコールを実行する
メジャーメント/イベント/アラーム API
メジャーメント、イベントやアラームAPIでは、一覧取得するAPI(GET)を実行すると、レスポンスにsourceが含まれます。計測値やアラームなどデータの発生元となったマネージドオブジェクト(デバイス)情報がsourceに格納されており、このsourceの中のidが、メジャーメント等が格納されているデバイスのIDとなります。
デバイス制御 API
デバイス制御API中のオペレーションで指定されているdeviceIdは、デバイスのIDを指定しています。
また、Things Cloudの[デバイス管理]から各デバイスのdeviceIdを[システムID]によって確認することができます。
