Iot Hub Resource - Import Devices

Reference

Service:: IoT Hub

API Version:: 2018-04-01

Importujte, aktualizujte nebo odstraňte identity zařízení v registru identit služby IoT Hub z objektu blob. Další informace najdete v tématu: 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=2018-04-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje centrum IoT.
resourceName	path	True	string	Název centra IoT.
subscriptionId	path	True	string	Identifikátor předplatného.
api-version	query	True	string	Verze rozhraní API

Text požadavku

Name	Vyžadováno	Typ	Description
inputBlobContainerUri	True	string	Identifikátor URI vstupního kontejneru objektů blob.
outputBlobContainerUri	True	string	Identifikátor URI výstupního kontejneru objektů blob.

Odpovědi

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

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

IotHubResource_ImportDevices

Sample Request

HTTP

POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub/importDevices?api-version=2018-04-01

{
  "inputBlobContainerUri": "testBlob",
  "outputBlobContainerUri": "testBlob"
}

Sample Response

Status code:: 200

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

Definice

Name	Description
ErrorDetails	Podrobnosti o chybě.
ImportDevicesRequest	Slouží k zadání parametrů při žádosti o import všech zařízení v centru.
JobResponse	Vlastnosti objektu Job Response.
JobStatus	Stav úlohy.
JobType	Typ úlohy.

ErrorDetails

Podrobnosti o chybě.

Name	Typ	Description
code	string	Kód chyby
details	string	Podrobnosti o chybě
httpStatusCode	string	Stavový kód HTTP
message	string	Chybová zpráva

ImportDevicesRequest

Slouží k zadání parametrů při žádosti o import všech zařízení v centru.

Name	Typ	Description
inputBlobContainerUri	string	Identifikátor URI vstupního kontejneru objektů blob.
outputBlobContainerUri	string	Identifikátor URI výstupního kontejneru objektů blob.

JobResponse

Vlastnosti objektu Job Response.

Name	Typ	Description
endTimeUtc	string	Čas, kdy úloha přestala zpracovávat.
failureReason	string	Pokud stav == selhal, tento řetězec obsahuje důvod selhání.
jobId	string	Identifikátor úlohy.
parentJobId	string	Identifikátor úlohy nadřazené úlohy, pokud existuje.
startTimeUtc	string	Čas zahájení úlohy.
status	JobStatus	Stav úlohy.
statusMessage	string	Stavová zpráva úlohy.
type	JobType	Typ úlohy.

JobStatus

Stav úlohy.

Name	Typ	Description
cancelled	string
completed	string
enqueued	string
failed	string
running	string
unknown	string

JobType

Typ úlohy.

Name	Typ	Description
backup	string
export	string
factoryResetDevice	string
firmwareUpdate	string
import	string
readDeviceProperties	string
rebootDevice	string
unknown	string
updateDeviceConfiguration	string
writeDeviceProperties	string