Iot Hub Resource - Import Devices
Eszközidentitások importálása, frissítése vagy törlése az IoT Hub-identitásjegyzékben egy blobból. További információ: 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=2023-06-30
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Az IoT Hubot tartalmazó erőforráscsoport neve. |
resource
|
path | True |
string |
Az IoT Hub neve. |
subscription
|
path | True |
string |
Az előfizetés azonosítója. |
api-version
|
query | True |
string |
Az API verziója. |
Kérelem törzse
Name | Kötelező | Típus | Description |
---|---|---|---|
inputBlobContainerUri | True |
string |
A bemeneti blobtároló URI-ja. |
outputBlobContainerUri | True |
string |
A kimeneti blobtároló URI-ja. |
authenticationType |
Megadja a tárfiókhoz való csatlakozáshoz használt hitelesítési típust. |
||
configurationsBlobName |
string |
A megadott bemeneti blobtároló konfigurációinak importálásához használandó blobnév. |
|
identity |
A tárvégpont felügyelt identitástulajdonságai importálási eszközökhöz. |
||
includeConfigurations |
boolean |
Az az érték, amely azt jelzi, hogy importálni kell-e a konfigurációkat. |
|
inputBlobName |
string |
A megadott bemeneti blobtárolóból való importáláskor használandó blobnév. |
|
outputBlobName |
string |
Az importálási feladat állapotának tárolásához használandó blobnév. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
DefaultErrorResponse |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
IotHubResource_ImportDevices
Sample Request
POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub/importDevices?api-version=2023-06-30
{
"inputBlobContainerUri": "testBlob",
"outputBlobContainerUri": "testBlob"
}
Sample Response
{
"jobId": "test",
"startTimeUtc": "Thu, 15 Jun 2017 19:20:58 GMT",
"endTimeUtc": "Thu, 15 Jun 2017 19:20:58 GMT",
"type": "unknown",
"status": "unknown"
}
Definíciók
Name | Description |
---|---|
Authentication |
Megadja a tárfiókhoz való csatlakozáshoz használt hitelesítési típust. |
Error |
Hiba részletei. |
Import |
A használatával paramétereket adhat meg a központ összes eszközének importálásakor. |
Job |
A Feladat-válasz objektum tulajdonságai. |
Job |
A feladat állapota. |
Job |
A feladat típusa. |
Managed |
A felügyelt identitás tulajdonságai. |
AuthenticationType
Megadja a tárfiókhoz való csatlakozáshoz használt hitelesítési típust.
Name | Típus | Description |
---|---|---|
identityBased |
string |
|
keyBased |
string |
ErrorDetails
Hiba részletei.
Name | Típus | Description |
---|---|---|
code |
string |
A hibakód. |
details |
string |
A hiba részletei. |
httpStatusCode |
string |
A HTTP-állapotkód. |
message |
string |
A hibaüzenet. |
ImportDevicesRequest
A használatával paramétereket adhat meg a központ összes eszközének importálásakor.
Name | Típus | Description |
---|---|---|
authenticationType |
Megadja a tárfiókhoz való csatlakozáshoz használt hitelesítési típust. |
|
configurationsBlobName |
string |
A megadott bemeneti blobtároló konfigurációinak importálásához használandó blobnév. |
identity |
A tárvégpont felügyelt identitástulajdonságai importálási eszközökhöz. |
|
includeConfigurations |
boolean |
Az az érték, amely azt jelzi, hogy importálni kell-e a konfigurációkat. |
inputBlobContainerUri |
string |
A bemeneti blobtároló URI-ja. |
inputBlobName |
string |
A megadott bemeneti blobtárolóból való importáláskor használandó blobnév. |
outputBlobContainerUri |
string |
A kimeneti blobtároló URI-ja. |
outputBlobName |
string |
Az importálási feladat állapotának tárolásához használandó blobnév. |
JobResponse
A Feladat-válasz objektum tulajdonságai.
Name | Típus | Description |
---|---|---|
endTimeUtc |
string |
A feladat feldolgozásának leállítása. |
failureReason |
string |
Ha az állapot == nem sikerült, ez a sztring tartalmazza a hiba okát. |
jobId |
string |
A feladat azonosítója. |
parentJobId |
string |
Ha van ilyen, a szülőfeladat feladatazonosítója. |
startTimeUtc |
string |
A feladat kezdési időpontja. |
status |
A feladat állapota. |
|
statusMessage |
string |
A feladat állapotüzenete. |
type |
A feladat típusa. |
JobStatus
A feladat állapota.
Name | Típus | Description |
---|---|---|
cancelled |
string |
|
completed |
string |
|
enqueued |
string |
|
failed |
string |
|
running |
string |
|
unknown |
string |
JobType
A feladat típusa.
Name | Típus | Description |
---|---|---|
backup |
string |
|
export |
string |
|
factoryResetDevice |
string |
|
firmwareUpdate |
string |
|
import |
string |
|
readDeviceProperties |
string |
|
rebootDevice |
string |
|
unknown |
string |
|
updateDeviceConfiguration |
string |
|
writeDeviceProperties |
string |
ManagedIdentity
A felügyelt identitás tulajdonságai.
Name | Típus | Description |
---|---|---|
userAssignedIdentity |
string |
A felhasználó által hozzárendelt identitás. |