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 |
---|---|---|---|---|
resource
|
path | True |
string |
IoT Hub를 포함하는 리소스 그룹의 이름입니다. |
resource
|
path | True |
string |
IoT Hub의 이름입니다. |
subscription
|
path | True |
string |
구독 식별자입니다. |
api-version
|
query | True |
string |
API 버전입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
excludeKeys | True |
boolean |
내보내기 중에 키를 제외해야 하는지 여부를 나타내는 값입니다. |
exportBlobContainerUri | True |
string |
Blob 컨테이너 내보내기 URI입니다. |
authenticationType |
스토리지 계정에 연결하는 데 사용되는 인증 유형을 지정합니다. |
||
configurationsBlobName |
string |
제공된 출력 Blob 컨테이너에서 만들 Blob의 이름입니다. 이 Blob에는 Iot Hub에 대해 내보낸 구성이 포함됩니다. |
|
exportBlobName |
string |
제공된 출력 Blob 컨테이너에서 만들 Blob의 이름입니다. 이 Blob에는 IoT Hub 대한 내보낸 디바이스 레지스트리 정보가 포함됩니다. |
|
identity |
디바이스 내보내기용 스토리지 엔드포인트의 관리 ID 속성입니다. |
||
includeConfigurations |
boolean |
구성을 내보낼지 여부를 나타내는 값입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
정상 |
|
Other Status Codes |
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
샘플 요청
샘플 응답
{
"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 |
---|---|
Authentication |
스토리지 계정에 연결하는 데 사용되는 인증 유형을 지정합니다. |
Error |
오류 세부 정보입니다. |
Export |
를 사용하여 IoT Hub의 모든 디바이스 내보내기를 요청할 때 매개 변수를 제공합니다. |
Job |
Job Response 개체의 속성입니다. |
Job |
작업의 상태. |
Job |
작업의 형식입니다. |
Managed |
관리 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 |
스토리지 계정에 연결하는 데 사용되는 인증 유형을 지정합니다. |
|
configurationsBlobName |
string |
제공된 출력 Blob 컨테이너에서 만들 Blob의 이름입니다. 이 Blob에는 Iot Hub에 대해 내보낸 구성이 포함됩니다. |
excludeKeys |
boolean |
내보내기 중에 키를 제외해야 하는지 여부를 나타내는 값입니다. |
exportBlobContainerUri |
string |
Blob 컨테이너 내보내기 URI입니다. |
exportBlobName |
string |
제공된 출력 Blob 컨테이너에서 만들 Blob의 이름입니다. 이 Blob에는 IoT Hub 대한 내보낸 디바이스 레지스트리 정보가 포함됩니다. |
identity |
디바이스 내보내기용 스토리지 엔드포인트의 관리 ID 속성입니다. |
|
includeConfigurations |
boolean |
구성을 내보낼지 여부를 나타내는 값입니다. |
JobResponse
Job Response 개체의 속성입니다.
Name | 형식 | Description |
---|---|---|
endTimeUtc |
string |
작업이 처리를 중지한 시간입니다. |
failureReason |
string |
== 상태 실패한 경우 실패 이유를 포함하는 이 문자열입니다. |
jobId |
string |
작업 ID입니다. |
parentJobId |
string |
부모 작업의 작업 식별자(있는 경우)입니다. |
startTimeUtc |
string |
작업의 시작 시간입니다. |
status |
작업의 상태. |
|
statusMessage |
string |
작업에 대한 상태 메시지입니다. |
type |
작업의 형식입니다. |
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입니다. |