共用方式為

Jobs - Get Scheduled Job

  • 參考
服務:
IoT Hub
API 版本:
2021-04-12

從IoT中樞取得排程工作的詳細數據。 如需相關資訊，請參閱 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 參數

名稱 位於 必要 類型 Description
id
 path True

string

作業的唯一標識碼。
api-version
 query True

string

Api 的版本。

回應

名稱 類型 Description
200 OK

JobResponse

還行。

定義

名稱 Description
CloudToDeviceMethod

在裝置上執行直接方法的參數。
DeviceCapabilities

裝置上啟用的功能狀態。
DeviceJobStatistics

有關執行狀態的作業統計數據。
JobResponse
Twin

裝置或模組的狀態資訊。 這會在IoT中樞中建立或刪除對應的裝置/模組身分識別時，以隱含方式建立和刪除。
TwinProperties

對應項的所需和報告屬性。 物件的最大深度為 10。
X509Thumbprint

CloudToDeviceMethod

Object

在裝置上執行直接方法的參數。

名稱 類型 Description
connectTimeoutInSeconds

integer (int32)

methodName

string

要執行之方法的名稱。
payload

object

JSON 格式的直接方法承載，大小上限為 128kb。
responseTimeoutInSeconds

integer (int32)

DeviceCapabilities

Object

裝置上啟用的功能狀態。

名稱 類型 Description
iotEdge

boolean

屬性，判斷裝置是否為邊緣裝置。

DeviceJobStatistics

Object

有關執行狀態的作業統計數據。

名稱 類型 Description
deviceCount

integer (int32)

作業的目標裝置數目。
failedCount

integer (int32)

失敗的工作數目。
pendingCount

integer (int32)

擱置中（已排程）作業的數目。
runningCount

integer (int32)

執行中作業的數目。
succeededCount

integer (int32)

成功作業的數目。

JobResponse

Object
名稱 類型 Description
cloudToDeviceMethod

CloudToDeviceMethod

方法類型和參數。 如果作業類型為 cloudToDeviceMethod，則需要此專案。
createdTime

string (date-time)

系統產生。 在建立時忽略。 作業的建立日期和時間。
deviceJobStatistics

DeviceJobStatistics

有關作業執行狀態的詳細數據。
endTime

string (date-time)

系統產生。 在建立時忽略。 以UTC為單位之作業的結束日期和時間。
failureReason

string

如果發生失敗，則為失敗的原因。
jobId

string

系統產生。 在建立時忽略。 作業的唯一標識碼。
maxExecutionTimeInSeconds

integer (int64)

secounds 中的運行時間上限。
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

裝置或模組的狀態資訊。 這會在IoT中樞中建立或刪除對應的裝置/模組身分識別時，以隱含方式建立和刪除。

Twin

Object

裝置或模組的狀態資訊。 這會在IoT中樞中建立或刪除對應的裝置/模組身分識別時，以隱含方式建立和刪除。

名稱 類型 Description
authenticationType enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned

裝置所使用的驗證類型。
capabilities

DeviceCapabilities

裝置上啟用的功能狀態。
cloudToDeviceMessageCount

integer (int32)

傳送的雲端到裝置訊息數目。
connectionState enum:
  • Connected
  • Disconnected

裝置的連接狀態。
deviceEtag

string

根據RFC7232，代表裝置 ETag 的字串。
deviceId

string

IoT 中樞身分識別登錄中裝置的唯一標識符。 這是區分大小寫的字串（最多 128 個字元長）的 ASCII 7 位英數位元字元， 和下列特殊字元 {'-'、'：'、'.'、'+'、'%'、'_'、'#'、'*'、'？'、'！'、'！'、'（'、'）'、'、'='、'@'、';'、'$'、'}。
deviceScope

string

裝置的範圍。
etag

string

字串，代表裝置對應項的 ETag，根據RFC7232。
lastActivityTime

string (date-time)

裝置上次連線或接收或傳送訊息的日期和時間。 日期和時間是以 UTC ISO8601日期時間格式來分隔，例如 2015-01-28T16：24：48.789Z。 如果裝置使用 HTTP/1 通訊協定來執行傳訊作業，則不會更新此值。
moduleId

string

IoT 中樞身分識別登錄中模組的唯一標識符。 這是區分大小寫的字串（最多 128 個字元長）的 ASCII 7 位英數位元字元， 和下列特殊字元 {'-'、'：'、'.'、'+'、'%'、'_'、'#'、'*'、'？'、'！'、'！'、'（'、'）'、'、'='、'@'、';'、'$'、'}。
parentScopes

string[]

適用時，上層邊緣裝置的範圍。 僅適用於邊緣裝置。
properties

TwinProperties

對應項的所需和報告屬性。
status enum:
  • disabled
  • enabled

裝置的啟用狀態。 如果停用，裝置就無法連線到服務。
statusReason

string

裝置目前狀態的原因，如果有的話。
statusUpdateTime

string (date-time)

上次更新裝置狀態的日期和時間。
tags

object

由解決方案後端讀取和寫入索引鍵/值組的集合。 裝置應用程式看不到它們。 這些密鑰的長度為 UTF-8 編碼、區分大小寫，up-to 1KB。 允許的字元會排除 UNICODE 控制字元（C0 和 C1 區段）、'.'、'$' 和空格。 這些值是 JSON 物件，up-to 長度為 4KB。
version

integer (int64)

裝置對應項的版本，包括標籤和所需屬性
x509Thumbprint

X509Thumbprint

裝置的 X509 指紋。

TwinProperties

Object

對應項的所需和報告屬性。 物件的最大深度為 10。

名稱 類型 Description
desired

object

所需屬性索引鍵/值組的集合。 密鑰是 UTF-8 編碼、區分大小寫，up-to 長度為 1KB。 允許的字元會排除 UNICODE 控制字元（C0 和 C1 區段）、'.'、'$' 和空格。 所需的門廊值是 JSON 對象，長度 up-to 4 KB。
reported

object

報告屬性索引鍵/值組的集合。 密鑰是 UTF-8 編碼、區分大小寫，up-to 長度為 1KB。 允許的字元會排除 UNICODE 控制字元（C0 和 C1 區段）、'.'、'$' 和空格。 報告的屬性值為 JSON 對象，長度 up-to 4KB。

X509Thumbprint

Object
名稱 類型 Description
primaryThumbprint

string

X509 用戶端憑證主要指紋。
secondaryThumbprint

string

X509 用戶端憑證次要指紋。