3.1.4.7 デバイス プロパティを段階的に更新する

デバイスのプロパティを段階的に更新します。これは、単一のデバイスおよび単純なパラメータの更新に適しています。

リクエスト URL

PATCH {base_url}/device/openapi/v1/devices/{deviceId}/properties

リクエストパラメータ

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

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

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

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

表 3. ボディパラメータ
パラメータ 必須 タイプ 説明
properties Yes JSON 更新が必要なプロパティ。

さまざまなデバイスの設定可能なプロパティを表示するには、設定可能なプロパティを参照してください。

応答パラメータ

 
パラメータ タイプ Description
data Object<Properties_Info> 更新されたプロパティの情報。
status String API リクエストの結果。

  • Success
  • Failed
requestId String リクエストの一意の ID。リクエストをすばやく見つけるために使用できます。
Properties_Info
 
パラメータ Type Description
properties JSON
正常に更新されたプロパティ。

リクエスト例
デバイス ID「1748256426492760066」のデバイスのデータ報告間隔を 30 分に変更します。
PATCH /device/openapi/v1/devices/1748256426492760066/properties HTTP/1.1
Host: demo.milesight.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzY5NTQ4MDE3MTMzMjgxMzAifSwiZXhwIjoxNzAzMjEzMDk4LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJiYjJjN2U4Yy03NGQwLTQ4NjEtODE3MS1iYTc0NWRlMGY0NmQiLCJjbGllbnRfaWQiOiI4OTNkNzdjNy1mMGNiLTRmMzQtOWNhMS03YzJhNGNmMTEzNDgiLCJ0cyI6MTcwMzIwOTQ5ODMzNH0
Content-Type: application/json

{
    "properties": {
        "reporting_interval": {    
            "time": 30
        }
    }
}
レスポンス例
HTTP/1.1 200 OK
{
    "data": {
        "properties": {
            "reporting_interval": {
                "time": 30
            }
        }
    },
    "status": "Success",
    "requestId": "d820fb189824a8809d74f76ebd02363a"
}

関連記事

ソリューション / 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 …
ページ上部へ戻る