Iot Hub Resource - Export Devices
Exportálja az IoT Hub-identitásjegyzékben található összes eszközidentitást egy Azure Storage-blobtárolóba. 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}/exportDevices?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 |
---|---|---|---|
excludeKeys | True |
boolean |
Az az érték, amely azt jelzi, hogy a kulcsokat ki kell-e zárni az exportálás során. |
exportBlobContainerUri | True |
string |
Az exportálási blobtároló URI-ja. |
authenticationType |
Megadja a tárfiókhoz való csatlakozáshoz használt hitelesítési típust. |
||
configurationsBlobName |
string |
A megadott kimeneti blobtárolóban létrehozandó blob neve. Ez a blob tartalmazza az Iot Hub exportált konfigurációit. |
|
exportBlobName |
string |
A megadott kimeneti blobtárolóban létrehozandó blob neve. Ez a blob tartalmazni fogja a IoT Hub exportált eszközregisztrációs adatbázisának adatait. |
|
identity |
A tárolóvégpont felügyelt identitástulajdonságai exportálási eszközökhöz. |
||
includeConfigurations |
boolean |
Az érték, amely azt jelzi, hogy exportálni kell-e a konfigurációkat. |
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_ExportDevices
Sample Request
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. |
Export |
A használatával paramétereket adhat meg, amikor az IoT Hub összes eszközének exportálását kéri. |
Job |
A Feladatvá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. |
ExportDevicesRequest
A használatával paramétereket adhat meg, amikor az IoT Hub összes eszközének exportálását kéri.
Name | Típus | Description |
---|---|---|
authenticationType |
Megadja a tárfiókhoz való csatlakozáshoz használt hitelesítési típust. |
|
configurationsBlobName |
string |
A megadott kimeneti blobtárolóban létrehozandó blob neve. Ez a blob tartalmazza az Iot Hub exportált konfigurációit. |
excludeKeys |
boolean |
Az az érték, amely azt jelzi, hogy a kulcsokat ki kell-e zárni az exportálás során. |
exportBlobContainerUri |
string |
Az exportálási blobtároló URI-ja. |
exportBlobName |
string |
A megadott kimeneti blobtárolóban létrehozandó blob neve. Ez a blob tartalmazni fogja a IoT Hub exportált eszközregisztrációs adatbázisának adatait. |
identity |
A tárolóvégpont felügyelt identitástulajdonságai exportálási eszközökhöz. |
|
includeConfigurations |
boolean |
Az érték, amely azt jelzi, hogy exportálni kell-e a konfigurációkat. |
JobResponse
A Feladatválasz objektum tulajdonságai.
Name | Típus | Description |
---|---|---|
endTimeUtc |
string |
A feladat feldolgozásának leállítása. |
failureReason |
string |
Ha az állapot == sikertelen, ez a sztring tartalmazza a hiba okát. |
jobId |
string |
A feladat azonosítója. |
parentJobId |
string |
A szülőfeladat feladatazonosítója, ha van ilyen. |
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. |