3.1.6.1 構成タスクの作成

リモートデバイスに設定を適用するための設定タスクを作成します。これは、大量のデバイスや設定パラメータが多い場合に適しています。単一のデバイスや単純なパラメータの更新については、「デバイスプロパティの段階的な更新」を参照してください。

リクエスト URL

POST {base_url}/device/openapi/v1/tasks

リクエストパラメータ

表 1. ヘッダーパラメータ
パラメータ 必須 タイプ 説明
Authorization Yes String API 呼び出しを行うための有効なアクセストークン。形式は Bearer {access_token} である必要があります。
表 2. 本文パラメータ
パラメータ 必須 タイプ 説明
type Yes Enum <String> 自動プロビジョニング用の設定テンプレートのタイプ

有効な値:
deviceIds Yes Array<Long> デバイスを追加する際に返される、デバイスの一意の ID。デバイス ID は、コンマまたはセミコロンで区切ることができます。

注：デバイス ID を保存していない場合は、特定のデバイスの検索を使用してデバイスの ID を照会できます。
config Yes JSON 自動プロビジョニングの設定。以下の JSON 形式で表示されます。設定テンプレートは、設定テンプレートの内容をコピーまたは設定 API の取得で取得し、必要に応じて設定を変更してください。また、以下の形式を使用して設定を生成することもできます。

  • タイプが PROFILEの場合、以下のフォーマットを使用して設定を適用してください。
  • 値の内容は、デフォルトのプロファイルテンプレートを参照してください。
  • {
   "version":"v1.0",   //config version (optional)
   "values":[
    {
        "key": "",
        "value": 
     }
    {
        "key": "",
        "value": 
     }
          .......
     ]
}
  • タイプが TSLの場合、以下の形式を使用して設定を適用します： 
    {
   "version":"v1.0",   //config version (optional)
    "type": "tsl",   //TSL version (optional)
   "properties":{
        "reporting_interval": 600, 
          .......
     }
}

    The properties content can be referred to Configuration Properties.

応答パラメータ

 
パラメータ タイプ 説明
data Object<Task_Create_Result> タスクの情報。
status String API リクエストの結果。

  • Success
  • Failed
requestId String リクエストの一意の ID。リクエストをすばやく見つけるために使用できます。
Task_Create_Result
 
パラメータ タイプ 説明
deviceTaskRelations String
デバイスリストと関連するタスク
deviceId Long
Milesight 開発プラットフォーム上のこのデバイスの一意の ID
taskId Long
Milesight 開発プラットフォームで生成された設定タスクの一意の ID。

例

リクエスト例
VS133-P デバイスに設定を適用する設定タスクを作成します
POST /device/openapi/v1/devices HTTP/1.1
Host: demo.milesight.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzY5NTQ4MDE3MTMzMjgxMzAifSwiZXhwIjoxNzAzMjEzMDk4LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJiYjJjN2U4Yy03NGQwLTQ4NjEtODE3MS1iYTc0NWRlMGY0NmQiLCJjbGllbnRfaWQiOiI4OTNkNzdjNy1mMGNiLTRmMzQtOWNhMS03YzJhNGNmMTEzNDgiLCJ0cyI6MTcwMzIwOTQ5ODMzNH0
Content-Type: application/json

{
  "type": "PROFILE",
  "deviceIds": [
    "1904041077351141377"
  ],
  "config": {
    "values": [
      {
        "key": "install_height",
        "value": 3000
      },
      {
        "key": "min_target_height",
        "value": 1000
      }
    ]
  }
}
レスポンス例
HTTP/1.1 200 OK
{
  "data": {
    "deviceTaskRelations": [
      {
        "deviceId": "1904041077351141377",
        "taskId": "1904498522747006977"
      }
    ]
  },
  "status": "Success",
  "requestId": "de178ad55e213624facc3d82bb06cfe7"
}

関連記事

トップページに戻る

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


Milesight製品

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

居住者の健康を確保

  1. COVID-19の脅威にさらされた買い物客と労働者のためのスーパーマーケットアンビエンスモニタリング
  2. IoTでオフィスをグレードアップ。エネルギッシュなオフィス環境モニタリング

お知らせ

  1. 2025-4-3

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

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

  2. 2023-7-21

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

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

  3. 2023-4-6

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

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