3.1.4.6 デバイス情報の更新

デバイスの名前、説明、およびタグを更新します。

リクエスト URL

PUT {base_url}/device/openapi/v1/devices

リクエストパラメータ

表 1. ヘッダーパラメータ
パラメータ 必須 タイプ 説明
Authorization Yes String API 呼び出しを行うための有効なアクセストークン。

形式は Bearer {access_token} である必要があります。

表 2. ボディパラメータ
パラメータ 必須 タイプ 説明
deviceId Yes Long このデバイスの一意の ID。デバイスを追加するときに返されます。

注: deviceID を保存していない場合は、特定のデバイスを検索を使用してデバイスの ID を照会できます。

name Yes String デバイス名を更新します。
tslVersion No String デバイスの TSL バージョンを更新します。
description No String デバイスの説明を更新します。
project No String デバイスのプロジェクトタグを更新します。
tag No Array<String>  デバイスのタグを更新します。

応答パラメータ

 
パラメータ タイプ 説明
data Object<Device_Info> 更新されたデバイスの情報。
status String API リクエストの結果

  • Success
  • Failed
requestId String リクエストの一意の ID。リクエストをすばやく見つけるために使用できます。
Device_Info
 
パラメータ タイプ 説明
sn String
このデバイスの SN (シリアル番号)
deviceId Long
Milesight 開発プラットフォームにおけるこのデバイスの一意の ID。
注:この deviceID は、API を通じてデバイスを管理または設定するために必要となるため、将来の使用のために保存しておくことをお勧めします。
devEUI String
注: 製品モデルによっては、このパラメータは返されない場合があります。
このデバイスの EUI (拡張一意識別子)。
imei String
注: 製品モデルによっては、このパラメーターが返されない場合があります。
このデバイスの IMEI(国際移動体装置識別番号)です。

リクエスト例
ID 「1742010610312101890」 のデバイスの名前とプロジェクトタグを更新します。
PUT /device/openapi/v1/devices HTTP/1.1
Host: demo.milesight.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzY5NTQ4MDE3MTMzMjgxMzAifSwiZXhwIjoxNzAzMjEzMDk4LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJiYjJjN2U4Yy03NGQwLTQ4NjEtODE3MS1iYTc0NWRlMGY0NmQiLCJjbGllbnRfaWQiOiI4OTNkNzdjNy1mMGNiLTRmMzQtOWNhMS03YzJhNGNmMTEzNDgiLCJ0cyI6MTcwMzIwOTQ5ODMzNH0
Content-Type: application/json

{
    "deviceId": "1742010610312101890",
    "name": "Comfort Sensor Room-3D",
    "project": "Workplace"
}
レスポンス例
HTTP/1.1 200 OK
{
    "data": {
        "sn": "6785C38073640023",
        "deviceId": "1742010610312101890",
    },
    "status": "Success",
    "requestId": "f3f81c188c03c4b098a83503109802d2"
}

関連記事

ソリューション / IoT サポート


Milesight製品

ウェーブクレスト株式会社が運営するMilesight製品特設サイトです

居住者の健康を確保

お知らせ

  1. 2025-4-3

    ピープル・センシング 駆動型スマートビルディング

    People Sensing Insights を通じてビルインテリジェンスに革命をもたらします。…
  2. 2023-7-21

    LoRaWANの説明: 理論から実践へのガイド

    この包括的なビデオでは、LoRaWANを深く掘り下げ、その仕組み、利点、アプリケーションについて説明…
  3. 2023-4-6

    センシング・インサイト Milesight リブランディングのお知らせ

    https://youtu.be/r40DK40DjIY …
ページ上部へ戻る