Iot Hub Resource - Import Devices
Importar, atualizar ou excluir identidades de dispositivo no registro de identidade do hub IoT de um blob. Para saber mais, confira 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
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos que contém o hub IoT. |
resource
|
path | True |
string |
O nome do hub IoT. |
subscription
|
path | True |
string |
O identificador da assinatura. |
api-version
|
query | True |
string |
A versão da API. |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
inputBlobContainerUri | True |
string |
O URI do contêiner de blob de entrada. |
outputBlobContainerUri | True |
string |
O URI do contêiner de blob de saída. |
authenticationType |
Especifica o tipo de autenticação que está sendo usado para se conectar à conta de armazenamento. |
||
configurationsBlobName |
string |
O nome do blob a ser usado ao importar configurações do contêiner de blob de entrada fornecido. |
|
identity |
Propriedades de identidade gerenciada do ponto de extremidade de armazenamento para importar dispositivos. |
||
includeConfigurations |
boolean |
O valor que indica se as configurações devem ser importadas. |
|
inputBlobName |
string |
O nome do blob a ser usado ao importar do contêiner de blob de entrada fornecido. |
|
outputBlobName |
string |
O nome do blob a ser usado para armazenar o status do trabalho de importação. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
DefaultErrorResponse |
Segurança
azure_auth
Fluxo do OAuth2 do Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
IotHubResource_ImportDevices
Solicitação de exemplo
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"
}
Resposta de exemplo
{
"jobId": "test",
"startTimeUtc": "Thu, 15 Jun 2017 19:20:58 GMT",
"endTimeUtc": "Thu, 15 Jun 2017 19:20:58 GMT",
"type": "unknown",
"status": "unknown"
}
Definições
Nome | Description |
---|---|
Authentication |
Especifica o tipo de autenticação que está sendo usado para se conectar à conta de armazenamento. |
Error |
Detalhes do erro. |
Import |
Use para fornecer parâmetros ao solicitar uma importação de todos os dispositivos no hub. |
Job |
As propriedades do objeto Job Response. |
Job |
O status do trabalho. |
Job |
O tipo do trabalho. |
Managed |
As propriedades da identidade gerenciada. |
AuthenticationType
Especifica o tipo de autenticação que está sendo usado para se conectar à conta de armazenamento.
Nome | Tipo | Description |
---|---|---|
identityBased |
string |
|
keyBased |
string |
ErrorDetails
Detalhes do erro.
Nome | Tipo | Description |
---|---|---|
code |
string |
O código de erro. |
details |
string |
Os detalhes do erro. |
httpStatusCode |
string |
O código de status do HTTP. |
message |
string |
A mensagem de erro. |
ImportDevicesRequest
Use para fornecer parâmetros ao solicitar uma importação de todos os dispositivos no hub.
Nome | Tipo | Description |
---|---|---|
authenticationType |
Especifica o tipo de autenticação que está sendo usado para se conectar à conta de armazenamento. |
|
configurationsBlobName |
string |
O nome do blob a ser usado ao importar configurações do contêiner de blob de entrada fornecido. |
identity |
Propriedades de identidade gerenciada do ponto de extremidade de armazenamento para importar dispositivos. |
|
includeConfigurations |
boolean |
O valor que indica se as configurações devem ser importadas. |
inputBlobContainerUri |
string |
O URI do contêiner de blob de entrada. |
inputBlobName |
string |
O nome do blob a ser usado ao importar do contêiner de blob de entrada fornecido. |
outputBlobContainerUri |
string |
O URI do contêiner de blob de saída. |
outputBlobName |
string |
O nome do blob a ser usado para armazenar o status do trabalho de importação. |
JobResponse
As propriedades do objeto Job Response.
Nome | Tipo | Description |
---|---|---|
endTimeUtc |
string |
A hora em que o trabalho parou de ser processado. |
failureReason |
string |
Se status == falhou, essa cadeia de caracteres que contém o motivo da falha. |
jobId |
string |
O identificador do trabalho. |
parentJobId |
string |
O identificador de trabalho do trabalho pai, se houver. |
startTimeUtc |
string |
A hora de início do trabalho. |
status |
O status do trabalho. |
|
statusMessage |
string |
A mensagem status para o trabalho. |
type |
O tipo do trabalho. |
JobStatus
O status do trabalho.
Nome | Tipo | Description |
---|---|---|
cancelled |
string |
|
completed |
string |
|
enqueued |
string |
|
failed |
string |
|
running |
string |
|
unknown |
string |
JobType
O tipo do trabalho.
Nome | Tipo | Description |
---|---|---|
backup |
string |
|
export |
string |
|
factoryResetDevice |
string |
|
firmwareUpdate |
string |
|
import |
string |
|
readDeviceProperties |
string |
|
rebootDevice |
string |
|
unknown |
string |
|
updateDeviceConfiguration |
string |
|
writeDeviceProperties |
string |
ManagedIdentity
As propriedades da identidade gerenciada.
Nome | Tipo | Description |
---|---|---|
userAssignedIdentity |
string |
A identidade atribuída pelo usuário. |