共用方式為

Jobs - Get Import Export Job

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

取得IoT中樞內匯入或匯出作業的狀態。 如需相關資訊，請參閱 https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-identity-registry#import-and-export-device-identities 。

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

URI 參數

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

string

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

string

Api 的版本。

回應

名稱 類型 Description
200 OK

JobProperties

還行。

定義

名稱 Description
JobProperties
ManagedIdentity

JobProperties

Object
名稱 類型 Description
configurationsBlobName

string

預設為 configurations.txt。 指定匯出/匯入組態時要使用的 Blob 名稱。
endTimeUtc

string (date-time)

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

boolean

匯出作業的選擇性;忽略其他作業。 如果未指定，服務會預設為 false。 如果為 false，則授權金鑰會包含在匯出輸出中。 否則，金鑰會匯出為 null。
failureReason

string

系統基因化。 在建立時忽略。 如果發生失敗，則為失敗的原因。
identity

ManagedIdentity

includeConfigurations

boolean

默認值為 false。 如果為 true，則組態會包含在數據匯出/匯入中。
inputBlobContainerUri

string

包含 SAS 令牌的 URI，指向包含要同步之登錄數據的 Blob 容器。
inputBlobName

string

從輸入 Blob 容器匯入時要使用的 Blob 名稱。
jobId

string

作業的唯一標識碼。
outputBlobContainerUri

string

用來存取 Blob 容器的 SAS 令牌。 這是用來輸出作業的狀態和結果。
outputBlobName

string

將在輸出 Blob 容器中建立的 Blob 名稱。 此 Blob 將包含IoT中樞的導出裝置登錄資訊。
progress

integer (int32)

系統產生。 在建立時忽略。 作業完成百分比。
startTimeUtc

string (date-time)

系統產生。 在建立時忽略。 作業的開始日期和時間，以UTC為單位。
status enum:
  • cancelled
  • completed
  • enqueued
  • failed
  • queued
  • running
  • scheduled
  • unknown

系統產生。 在建立時忽略。 作業的狀態。
storageAuthenticationType enum:
  • identityBased
  • keyBased

用於連線到記憶體帳戶的驗證類型。
type enum:
  • backup
  • export
  • factoryResetDevice
  • failoverDataCopy
  • firmwareUpdate
  • import
  • readDeviceProperties
  • rebootDevice
  • restoreFromBackup
  • scheduleDeviceMethod
  • scheduleUpdateTwin
  • unknown
  • updateDeviceConfiguration
  • writeDeviceProperties

作業類型。

ManagedIdentity

Object
名稱 類型 Description
userAssignedIdentity

string