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
resourceGroupName
path True

string

O nome do grupo de recursos que contém o hub IoT.

resourceName
path True

string

O nome do hub IoT.

subscriptionId
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

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

ManagedIdentity

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

JobResponse

OK

Other Status Codes

ErrorDetails

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
AuthenticationType

Especifica o tipo de autenticação que está sendo usado para se conectar à conta de armazenamento.

ErrorDetails

Detalhes do erro.

ImportDevicesRequest

Use para fornecer parâmetros ao solicitar uma importação de todos os dispositivos no hub.

JobResponse

As propriedades do objeto Job Response.

JobStatus

O status do trabalho.

JobType

O tipo do trabalho.

ManagedIdentity

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

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

ManagedIdentity

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

JobStatus

O status do trabalho.

statusMessage

string

A mensagem status para o trabalho.

type

JobType

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.