다음을 통해 공유

Jobs - Create Import Export Job

  • 참조
서비스:
IoT Hub
API 버전:
2021-04-12

IoT Hub 새 가져오기 또는 내보내기 작업을 만듭니다. 자세한 내용은 https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-identity-registry#import-and-export-device-identities 을 참조하세요.

POST https://fully-qualified-iothubname.azure-devices.net/jobs/create?api-version=2021-04-12

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
api-version
 query True

string

API의 버전입니다.

요청 본문

Name 형식 Description
configurationsBlobName

string

기본값은 configurations.txt. 구성을 내보내고 가져올 때 사용할 Blob의 이름을 지정합니다.
endTimeUtc

string

시스템이 생성되었습니다. 만들 때 무시됩니다. 작업의 종료 날짜 및 시간(UTC)입니다.
excludeKeysInExport

boolean

내보내기 작업의 경우 선택 사항입니다. 다른 작업에 대해 무시됩니다. 지정하지 않으면 서비스가 기본적으로 false로 설정됩니다. false이면 권한 부여 키가 내보내기 출력에 포함됩니다. 그렇지 않으면 키가 null로 내보내집니다.
failureReason

string

계보가 있는 시스템. 만들 때 무시됩니다. 오류가 발생한 경우 실패의 원인입니다.
identity

ManagedIdentity

includeConfigurations

boolean

기본값은 false입니다. true이면 데이터 내보내기/가져오기에 구성이 포함됩니다.
inputBlobContainerUri

string

동기화할 레지스트리 데이터가 포함된 Blob 컨테이너에 대한 SAS 토큰을 포함하는 URI입니다.
inputBlobName

string

입력 Blob 컨테이너에서 가져올 때 사용할 Blob 이름입니다.
jobId

string

작업의 고유 식별자입니다.
outputBlobContainerUri

string

Blob 컨테이너에 액세스하기 위한 SAS 토큰입니다. 작업의 상태 결과를 출력하는 데 사용됩니다.
outputBlobName

string

출력 Blob 컨테이너에서 만들 Blob 이름입니다. 이 Blob에는 IoT Hub 대한 내보낸 디바이스 레지스트리 정보가 포함됩니다.
progress

integer

시스템이 생성되었습니다. 만들 때 무시됩니다. 작업 완료율입니다.
startTimeUtc

string

시스템이 생성되었습니다. 만들 때 무시됩니다. 작업의 시작 날짜 및 시간(UTC)입니다.
status enum:
  • unknown
  • enqueued
  • running
  • completed
  • failed
  • cancelled
  • scheduled
  • queued

시스템이 생성되었습니다. 만들 때 무시됩니다. 작업의 상태.
storageAuthenticationType enum:
  • keyBased
  • identityBased

스토리지 계정에 연결하는 데 사용되는 인증 유형입니다.
type enum:
  • unknown
  • export
  • import
  • backup
  • readDeviceProperties
  • writeDeviceProperties
  • updateDeviceConfiguration
  • rebootDevice
  • factoryResetDevice
  • firmwareUpdate
  • scheduleDeviceMethod
  • scheduleUpdateTwin
  • restoreFromBackup
  • failoverDataCopy

작업 유형입니다.

응답

Name 형식 Description
200 OK

JobProperties

OK.

정의

Name Description
JobProperties
ManagedIdentity

JobProperties

Name 형식 Description
configurationsBlobName

string

기본값은 configurations.txt. 구성을 내보내고 가져올 때 사용할 Blob의 이름을 지정합니다.
endTimeUtc

string

시스템이 생성되었습니다. 만들 때 무시됩니다. 작업의 종료 날짜 및 시간(UTC)입니다.
excludeKeysInExport

boolean

내보내기 작업의 경우 선택 사항입니다. 다른 작업에 대해 무시됩니다. 지정하지 않으면 서비스가 기본적으로 false로 설정됩니다. false이면 권한 부여 키가 내보내기 출력에 포함됩니다. 그렇지 않으면 키가 null로 내보내집니다.
failureReason

string

계보가 있는 시스템. 만들 때 무시됩니다. 오류가 발생한 경우 실패의 원인입니다.
identity

ManagedIdentity

includeConfigurations

boolean

기본값은 false입니다. true이면 데이터 내보내기/가져오기에 구성이 포함됩니다.
inputBlobContainerUri

string

동기화할 레지스트리 데이터가 포함된 Blob 컨테이너에 대한 SAS 토큰을 포함하는 URI입니다.
inputBlobName

string

입력 Blob 컨테이너에서 가져올 때 사용할 Blob 이름입니다.
jobId

string

작업의 고유 식별자입니다.
outputBlobContainerUri

string

Blob 컨테이너에 액세스하기 위한 SAS 토큰입니다. 작업의 상태 결과를 출력하는 데 사용됩니다.
outputBlobName

string

출력 Blob 컨테이너에서 만들 Blob 이름입니다. 이 Blob에는 IoT Hub 대한 내보낸 디바이스 레지스트리 정보가 포함됩니다.
progress

integer

시스템이 생성되었습니다. 만들 때 무시됩니다. 작업 완료율입니다.
startTimeUtc

string

시스템이 생성되었습니다. 만들 때 무시됩니다. 작업의 시작 날짜 및 시간(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

Name 형식 Description
userAssignedIdentity

string