次の方法で共有

Jobs - Get Scheduled Job

  • リファレンス
サービス:
IoT Hub
API バージョン:
2021-04-12

IoT Hub からスケジュールされたジョブの詳細を取得します。 詳細については、https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-jobs を参照してください。

GET https://fully-qualified-iothubname.azure-devices.net/jobs/v2/{id}?api-version=2021-04-12

URI パラメーター

名前 / 必須 型 説明
id
 path True

string

ジョブの一意識別子。
api-version
 query True

string

API のバージョン。

応答

名前 型 説明
200 OK

JobResponse

わかりました。

定義

名前 説明
CloudToDeviceMethod

デバイスでダイレクト メソッドを実行するパラメーター。
DeviceCapabilities

デバイスで有効になっている機能の状態。
DeviceJobStatistics

実行状態に関するジョブ統計。
JobResponse
Twin

デバイスまたはモジュールの状態情報。 これは、対応するデバイス/モジュール ID が IoT Hub で作成または削除されるときに、暗黙的に作成および削除されます。
TwinProperties

ツインの必要なプロパティと報告されるプロパティ。 オブジェクトの最大深度は 10 です。
X509Thumbprint

CloudToDeviceMethod

Object

デバイスでダイレクト メソッドを実行するパラメーター。

名前 型 説明
connectTimeoutInSeconds

integer (int32)

methodName

string

実行するメソッドの名前。
payload

object

JSON 形式のダイレクト メソッド ペイロード。最大サイズは 128 kb です。
responseTimeoutInSeconds

integer (int32)

DeviceCapabilities

Object

デバイスで有効になっている機能の状態。

名前 型 説明
iotEdge

boolean

デバイスがエッジ デバイスかどうかを決定するプロパティ。

DeviceJobStatistics

Object

実行状態に関するジョブ統計。

名前 型 説明
deviceCount

integer (int32)

ジョブの対象となるデバイスの数。
failedCount

integer (int32)

失敗したジョブの数。
pendingCount

integer (int32)

保留中の (スケジュールされた) ジョブの数。
runningCount

integer (int32)

実行中のジョブの数。
succeededCount

integer (int32)

成功したジョブの数。

JobResponse

Object
名前 型 説明
cloudToDeviceMethod

CloudToDeviceMethod

メソッドの型とパラメーター。 これは、ジョブの種類が cloudToDeviceMethod の場合に必要です。
createdTime

string (date-time)

システムが生成されました。 作成時に無視されます。 ジョブの作成日時。
deviceJobStatistics

DeviceJobStatistics

ジョブの実行状態に関する詳細。
endTime

string (date-time)

システムが生成されました。 作成時に無視されます。 ジョブの終了日時 (UTC)。
failureReason

string

エラーが発生した場合のエラーの理由。
jobId

string

システムが生成されました。 作成時に無視されます。 ジョブの一意識別子。
maxExecutionTimeInSeconds

integer (int64)

秒単位の最大実行時間。
queryCondition

string

デバイスのクエリ条件。
startTime

string (date-time)

スケジュールされたジョブの開始日時 (UTC)。
status enum:
  • cancelled
  • completed
  • enqueued
  • failed
  • queued
  • running
  • scheduled
  • unknown

システムが生成されました。 作成時に無視されます。 ジョブの状態。
statusMessage

string

ジョブの状態メッセージ。
type enum:
  • backup
  • export
  • factoryResetDevice
  • failoverDataCopy
  • firmwareUpdate
  • import
  • readDeviceProperties
  • rebootDevice
  • restoreFromBackup
  • scheduleDeviceMethod
  • scheduleUpdateTwin
  • unknown
  • updateDeviceConfiguration
  • writeDeviceProperties

ジョブの種類。
updateTwin

Twin

デバイスまたはモジュールの状態情報。 これは、対応するデバイス/モジュール ID が IoT Hub で作成または削除されるときに、暗黙的に作成および削除されます。

Twin

Object

デバイスまたはモジュールの状態情報。 これは、対応するデバイス/モジュール ID が IoT Hub で作成または削除されるときに、暗黙的に作成および削除されます。

名前 型 説明
authenticationType enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned

デバイスで使用される認証の種類。
capabilities

DeviceCapabilities

デバイスで有効になっている機能の状態。
cloudToDeviceMessageCount

integer (int32)

送信されたクラウドからデバイスへのメッセージの数。
connectionState enum:
  • Connected
  • Disconnected

デバイスの接続状態。
deviceEtag

string

RFC7232に従って、デバイスの ETag を表す文字列。
deviceId

string

IoT Hub の ID レジストリ内のデバイスの一意識別子。 これは、ASCII 7 ビット英数字文字の大文字と小文字を区別する文字列 (最大 128 文字) です。 次の特殊文字 {'-'、':'、'.'、'+'、'%', '_', '#', '*', '?', '!', '(', ')',','','=', '@', ';', '$', '''} です。
deviceScope

string

デバイスのスコープ。
etag

string

RFC7232に従って、デバイス ツインの ETag を表す文字列。
lastActivityTime

string (date-time)

デバイスが最後に接続または受信またはメッセージを送信した日時。 日付と時刻は、2015-01-28T16:24:48.789Z など、UTC ISO8601 datetime 形式で分離されます。 デバイスが HTTP/1 プロトコルを使用してメッセージング操作を実行する場合、この値は更新されません。
moduleId

string

IoT Hub の ID レジストリ内のモジュールの一意識別子。 これは、ASCII 7 ビット英数字文字の大文字と小文字を区別する文字列 (最大 128 文字) です。 次の特殊文字 {'-'、':'、'.'、'+'、'%', '_', '#', '*', '?', '!', '(', ')',','','=', '@', ';', '$', '''} です。
parentScopes

string[]

該当する場合は、上位レベルのエッジ デバイスのスコープ。 エッジ デバイスでのみ使用できます。
properties

TwinProperties

ツインの必要なプロパティと報告されるプロパティ。
status enum:
  • disabled
  • enabled

デバイスの有効な状態。 無効にした場合、デバイスはサービスに接続できません。
statusReason

string

デバイスの現在の状態の理由 (ある場合)。
statusUpdateTime

string (date-time)

デバイスの状態が最後に更新された日時。
tags

object

ソリューション バックエンドによって読み書きされるキーと値のペアのコレクション。 デバイス アプリには表示されません。 これらのキーは UTF-8 でエンコードされ、大文字と小文字が区別され、長さが 1 KB up-to。 使用できる文字は、UNICODE 制御文字 (セグメント C0 および C1)、'.'、'$'、およびスペースを除外します。 値は JSON オブジェクトであり、長さは 4 KB up-to。
version

integer (int64)

タグと必要なプロパティを含むデバイス ツインのバージョン
x509Thumbprint

X509Thumbprint

デバイスの X509 拇印。

TwinProperties

Object

ツインの必要なプロパティと報告されるプロパティ。 オブジェクトの最大深度は 10 です。

名前 型 説明
desired

object

目的のプロパティ キーと値のペアのコレクション。 キーは UTF-8 でエンコードされ、大文字と小文字が区別され、長さが 1 KB up-to。 使用できる文字は、UNICODE 制御文字 (セグメント C0 および C1)、'.'、'$'、およびスペースを除外します。 必要な値は JSON オブジェクトであり、長さは 4 KB up-to。
reported

object

報告されるプロパティのキーと値のペアのコレクション。 キーは UTF-8 でエンコードされ、大文字と小文字が区別され、長さが 1 KB up-to。 使用できる文字は、UNICODE 制御文字 (セグメント C0 および C1)、'.'、'$'、およびスペースを除外します。 報告されるプロパティ値は JSON オブジェクトであり、長さは 4 KB up-to。

X509Thumbprint

Object
名前 型 説明
primaryThumbprint

string

X509 クライアント証明書のプライマリ拇印。
secondaryThumbprint

string

X509 クライアント証明書のセカンダリ拇印。