IoT Platform:デバイスジョブ

背景情報

• カスタムタスクを実装するには、デバイス側でタスク管理機能を開発する必要があります。詳細な操作については、「デバイスジョブ」をご参照ください。

• デバイスバッチサービス呼び出しタスクとデバイスバッチプロパティ設定タスクの場合、デバイス側の Link SDK がサービス呼び出しとプロパティ設定機能を統合している場合は、デバイスジョブを実行するために追加のタスク管理機能を開発する必要はありません。

  デバイス側の Link SDK へのサービス呼び出しとプロパティ設定機能の統合方法については、「デバイスアクセス概要」のそれぞれの Link SDK の Thing Specification Language 開発方法を参照してください。

  サービス呼び出しとプロパティ設定に使用される Alink プロトコルの説明については、「デバイスのプロパティ、イベント、およびサービス」をご参照ください。

デバイスジョブステータスの更新通知

ダウンストリーム。

トピック: /sys/${productKey}/${deviceName}/thing/job/notify。

Alink JSON 形式のリクエスト例:

{
    "id": "7542940",
    "version": "1.0",
    "params": {
        "task": {
            "taskId": "i5Ks6***pF010101",
            "status": "SENT", // スケジュール済み
            "jobDocument": {},
            "jobFile":{
                "signMethod":"Md5", // 署名方式
                "sign":"wssxff56dhdsd***", // 署名パラメータ
                "fileUrl": "https://iotx-***.oss-cn-shanghai.aliyuncs.com/***.zip" // タスクファイルのダウンロード URL
            }
        }
    }
}

Alink JSON 形式のレスポンス例:

{
    "id": "7542940",
    "code": 200,
    "data": {}
}

デバイスジョブの詳細を取得する

アップストリーム。

• リクエストトピック: /sys/${productKey}/${deviceName}/thing/job/get。

• レスポンストピック: /sys/${productKey}/${deviceName}/thing/job/get_reply。

Alink JSON 形式のリクエスト例:

{
    "id": "123",
    "version": "1.0",
    "params": {
        "taskId": "i5Ks***F010101"
    }
}

taskId の値が異なると、Alink レスポンスデータ形式も異なります。

• taskId がサブタスクの ID の場合:

  {
      "id": "1234",
      "code": 200,
      "data": {
          "statusDetails":{"devs":"test","status":"init"}, // デバイス上のタスク作成時のユーザー定義構成
          "taskId": "i5Ks***F010101",
          "task":{
              "taskId": "i5Ks***F010101",
              "status": "IN_PROGRESS", // 処理中
              "jobDocument": {},
              "jobFile":{
                  "signMethod":"Md5", // 署名方式
                  "sign":"wssxff56dhdsd***", // 署名パラメータ
                  "fileUrl": "https://iotx-***.oss-cn-shanghai.aliyuncs.com/***.zip" // タスクファイルのダウンロード URL
              }
          }
      }
  }

• taskId が $next の場合:

  {
      "id": "1234",
      "code": 200,
      "data": {
          "statusDetails":{"devs":"test","status":"init"}, // デバイス上のタスク作成時のユーザー定義構成
          "taskId": "$next",
          "task":{
              "taskId": "i5Ks***F010101",
              "status": "IN_PROGRESS", // 処理中
              "jobDocument": {},
              "jobFile":{
                  "signMethod":"Md5", // 署名方式
                  "sign":"wssxff56dhdsd***", // 署名パラメータ
                  "fileUrl": "https://iotx-***.oss-cn-shanghai.aliyuncs.com/***.zip" // タスクファイルのダウンロード URL
              }
          }
      }
  }

• taskId が $list の場合:

  {
      "id": "1234",
      "code": 200,
      "data": {
          "statusDetails":{"devs":"test","status":"init"}, // デバイス上のタスク作成時のユーザー定義構成
          "taskId": "$list",
          "task":[
              {
                  "taskId": "i5Ks***",
                  "status": "IN_PROGRESS" // 処理中
              },
              {
                  "taskId": "i61s***",
                  "status": "IN_PROGRESS" // 処理中
              }
          ]
      }
  }

サブタスクステータスを更新する

アップストリーム。

• リクエストトピック: /sys/${productKey}/${deviceName}/thing/job/update。

• レスポンストピック: /sys/${productKey}/${deviceName}/thing/job/update_reply。

Alink JSON 形式のリクエスト例:

{
    "id": "123",
    "version": "1.0",
    "params": {
        "taskId": "i5Ks***F010101",
        "status": "IN_PROGRESS", // 処理中
        "statusDetails": { // ユーザー定義ステータスの詳細
            "key": "value"
        },
        "progress": 50 // 実行の進捗状況 (パーセント)
    }
}

Alink JSON 形式のレスポンス例:

{
    "id":"123",
    "code":200,
    "data":{
        "taskId":"i5Ks***F010101"
    }
}