다음을 통해 공유


Iot Hub Resource - Export Devices

IoT Hub ID 레지스트리의 모든 디바이스 ID를 Azure Storage Blob 컨테이너로 내보냅니다. 자세한 내용은 https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry#import-and-export-device-identities를 참조하세요.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/exportDevices?api-version=2023-06-30

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
resourceGroupName
path True

string

IoT Hub를 포함하는 리소스 그룹의 이름입니다.

resourceName
path True

string

IoT Hub의 이름입니다.

subscriptionId
path True

string

구독 식별자입니다.

api-version
query True

string

API 버전입니다.

요청 본문

Name 필수 형식 Description
excludeKeys True

boolean

내보내기 중에 키를 제외해야 하는지 여부를 나타내는 값입니다.

exportBlobContainerUri True

string

Blob 컨테이너 내보내기 URI입니다.

authenticationType

AuthenticationType

스토리지 계정에 연결하는 데 사용되는 인증 유형을 지정합니다.

configurationsBlobName

string

제공된 출력 Blob 컨테이너에서 만들 Blob의 이름입니다. 이 Blob에는 Iot Hub에 대해 내보낸 구성이 포함됩니다.

exportBlobName

string

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

identity

ManagedIdentity

디바이스 내보내기용 스토리지 엔드포인트의 관리 ID 속성입니다.

includeConfigurations

boolean

구성을 내보낼지 여부를 나타내는 값입니다.

응답

Name 형식 Description
200 OK

JobResponse

정상

Other Status Codes

ErrorDetails

DefaultErrorResponse

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

IotHubResource_ExportDevices

샘플 요청

POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub/exportDevices?api-version=2023-06-30

{
  "exportBlobContainerUri": "testBlob",
  "excludeKeys": true
}

샘플 응답

{
  "jobId": "test",
  "startTimeUtc": "Thu, 15 Jun 2017 19:20:58 GMT",
  "endTimeUtc": "Thu, 15 Jun 2017 19:20:58 GMT",
  "type": "unknown",
  "status": "unknown"
}

정의

Name Description
AuthenticationType

스토리지 계정에 연결하는 데 사용되는 인증 유형을 지정합니다.

ErrorDetails

오류 세부 정보입니다.

ExportDevicesRequest

를 사용하여 IoT Hub의 모든 디바이스 내보내기를 요청할 때 매개 변수를 제공합니다.

JobResponse

Job Response 개체의 속성입니다.

JobStatus

작업의 상태.

JobType

작업의 형식입니다.

ManagedIdentity

관리 ID의 속성입니다.

AuthenticationType

스토리지 계정에 연결하는 데 사용되는 인증 유형을 지정합니다.

Name 형식 Description
identityBased

string

keyBased

string

ErrorDetails

오류 세부 정보입니다.

Name 형식 Description
code

string

오류 코드입니다.

details

string

오류 세부 정보입니다.

httpStatusCode

string

HTTP 상태 코드입니다.

message

string

오류 메시지입니다.

ExportDevicesRequest

를 사용하여 IoT Hub의 모든 디바이스 내보내기를 요청할 때 매개 변수를 제공합니다.

Name 형식 Description
authenticationType

AuthenticationType

스토리지 계정에 연결하는 데 사용되는 인증 유형을 지정합니다.

configurationsBlobName

string

제공된 출력 Blob 컨테이너에서 만들 Blob의 이름입니다. 이 Blob에는 Iot Hub에 대해 내보낸 구성이 포함됩니다.

excludeKeys

boolean

내보내기 중에 키를 제외해야 하는지 여부를 나타내는 값입니다.

exportBlobContainerUri

string

Blob 컨테이너 내보내기 URI입니다.

exportBlobName

string

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

identity

ManagedIdentity

디바이스 내보내기용 스토리지 엔드포인트의 관리 ID 속성입니다.

includeConfigurations

boolean

구성을 내보낼지 여부를 나타내는 값입니다.

JobResponse

Job Response 개체의 속성입니다.

Name 형식 Description
endTimeUtc

string

작업이 처리를 중지한 시간입니다.

failureReason

string

== 상태 실패한 경우 실패 이유를 포함하는 이 문자열입니다.

jobId

string

작업 ID입니다.

parentJobId

string

부모 작업의 작업 식별자(있는 경우)입니다.

startTimeUtc

string

작업의 시작 시간입니다.

status

JobStatus

작업의 상태.

statusMessage

string

작업에 대한 상태 메시지입니다.

type

JobType

작업의 형식입니다.

JobStatus

작업의 상태.

Name 형식 Description
cancelled

string

completed

string

enqueued

string

failed

string

running

string

unknown

string

JobType

작업의 형식입니다.

Name 형식 Description
backup

string

export

string

factoryResetDevice

string

firmwareUpdate

string

import

string

readDeviceProperties

string

rebootDevice

string

unknown

string

updateDeviceConfiguration

string

writeDeviceProperties

string

ManagedIdentity

관리 ID의 속성입니다.

Name 형식 Description
userAssignedIdentity

string

사용자 할당 ID입니다.