Iot Hub Resource - Import Devices

Service:: IoT Hub

API Version:: 2017-01-19

Import, update, or delete device identities in the IoT hub identity registry from a blob. For more information, see: 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}/importDevices?api-version={api-version}

URI Parameters

Name	In	Required	Type	Description
subscriptionId	path	True	string	The subscription identifier.
resourceGroupName	path	True	string	The name of the resource group that contains the IoT hub.
resourceName	path	True	string	The name of the IoT hub.
api-version	query	True	string	The version of the API.

Request Body

Name	Required	Type	Description
InputBlobContainerUri	True	string	The input blob container URI.
OutputBlobContainerUri	True	string	The output blob container URI.

Responses

Name	Type	Description
200 OK	JobResponse	OK
Other Status Codes	ErrorDetails	DefaultErrorResponse

Definitions

ErrorDetails
JobResponse

ErrorDetails

Name	Type	Description
Code	string	The error code.
Details	string	The error details.
HttpStatusCode	string	The HTTP status code.
Message	string	The error message.

JobResponse

Name	Type	Description
endTimeUtc	string date-time-rfc1123	The time the job stopped processing.
failureReason	string	If status == failed, this string containing the reason for the failure.
jobId	string	The job identifier.
parentJobId	string	The job identifier of the parent job, if any.
startTimeUtc	string date-time-rfc1123	The start time of the job.
status	enum: unknown enqueued running completed failed cancelled	The status of the job.
statusMessage	string	The status message for the job.
type	enum: unknown export import backup readDeviceProperties writeDeviceProperties updateDeviceConfiguration rebootDevice factoryResetDevice firmwareUpdate	The type of the job.