Compartilhar via

Devices - Create Or Update Identity

Serviço:
IoT Hub
Versão da API:
2021-04-12

Cria ou atualiza a identidade de um dispositivo no registro de identidade do Hub IoT.

PUT https://fully-qualified-iothubname.azure-devices.net/devices/{id}?api-version=2021-04-12

Parâmetros de URI

Nome Em Obrigatório Tipo Description
id
 path True

string

O identificador exclusivo do dispositivo.
api-version
 query True

string

Versão da API.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
If-Match

string

A cadeia de caracteres que representa uma ETag fraca para a identidade do dispositivo, de acordo com RFC7232. Isso não deve ser definido ao criar um dispositivo, mas pode ser definido ao atualizar um dispositivo.

Corpo da solicitação

Nome Tipo Description
authentication

AuthenticationMechanism

O mecanismo de autenticação usado pelo dispositivo.
capabilities

DeviceCapabilities

O conjunto de recursos do dispositivo. Por exemplo, se este dispositivo for um dispositivo de borda ou não.
cloudToDeviceMessageCount

integer (int32)

O número de mensagens da nuvem para o dispositivo atualmente enfileiradas para serem enviadas ao dispositivo.
connectionState enum:
  • Disconnected
  • Connected

O estado do dispositivo.
connectionStateUpdatedTime

string (date-time)

A data e a hora em que o estado da conexão foi atualizado pela última vez.
deviceId

string

O identificador exclusivo do dispositivo.
deviceScope

string

O escopo do dispositivo. Gerado automaticamente e imutável para dispositivos de borda e modificável em dispositivos folha para criar uma relação filho/pai.
etag

string

A cadeia de caracteres que representa uma ETag fraca para a identidade do dispositivo, de acordo com RFC7232.
generationId

string

A cadeia de caracteres com diferenciação de maiúsculas e minúsculas gerada pelo Hub IoT com até 128 caracteres. Esse valor é usado para distinguir dispositivos com a mesma deviceId, quando eles foram excluídos e recriados.
lastActivityTime

string (date-time)

A data e a última vez que o dispositivo se conectou pela última vez, recebeu ou enviou uma mensagem.
parentScopes

string[]

Os escopos dos dispositivos de borda superior, se aplicável. Disponível apenas para dispositivos de borda.
status enum:
  • enabled
  • disabled

O status do dispositivo. Se o status estiver desabilitado, um dispositivo não poderá se conectar ao serviço.
statusReason

string

A cadeia de caracteres de 128 caracteres que armazena o motivo do status de identidade do dispositivo. Todos os caracteres UTF-8 são permitidos.
statusUpdatedTime

string (date-time)

A data e a hora em que o campo de status foi atualizado pela última vez.

Respostas

Nome Tipo Description
200 OK

Device

OKEY.

Definições

Nome Description
AuthenticationMechanism
Device
DeviceCapabilities

O status dos recursos habilitados no dispositivo.
SymmetricKey
X509Thumbprint

AuthenticationMechanism

Objeto
Nome Tipo Description
symmetricKey

SymmetricKey

As chaves primárias e secundárias usadas para autenticação baseada em SAS.
type enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned

O tipo de autenticação usado para se conectar ao serviço.
x509Thumbprint

X509Thumbprint

As impressões digitais x509 primárias e secundárias usadas para autenticação baseada em x509.

Device

Objeto
Nome Tipo Description
authentication

AuthenticationMechanism

O mecanismo de autenticação usado pelo dispositivo.
capabilities

DeviceCapabilities

O conjunto de recursos do dispositivo. Por exemplo, se este dispositivo for um dispositivo de borda ou não.
cloudToDeviceMessageCount

integer (int32)

O número de mensagens da nuvem para o dispositivo atualmente enfileiradas para serem enviadas ao dispositivo.
connectionState enum:
  • Connected
  • Disconnected

O estado do dispositivo.
connectionStateUpdatedTime

string (date-time)

A data e a hora em que o estado da conexão foi atualizado pela última vez.
deviceId

string

O identificador exclusivo do dispositivo.
deviceScope

string

O escopo do dispositivo. Gerado automaticamente e imutável para dispositivos de borda e modificável em dispositivos folha para criar uma relação filho/pai.
etag

string

A cadeia de caracteres que representa uma ETag fraca para a identidade do dispositivo, de acordo com RFC7232.
generationId

string

A cadeia de caracteres com diferenciação de maiúsculas e minúsculas gerada pelo Hub IoT com até 128 caracteres. Esse valor é usado para distinguir dispositivos com a mesma deviceId, quando eles foram excluídos e recriados.
lastActivityTime

string (date-time)

A data e a última vez que o dispositivo se conectou pela última vez, recebeu ou enviou uma mensagem.
parentScopes

string[]

Os escopos dos dispositivos de borda superior, se aplicável. Disponível apenas para dispositivos de borda.
status enum:
  • disabled
  • enabled

O status do dispositivo. Se o status estiver desabilitado, um dispositivo não poderá se conectar ao serviço.
statusReason

string

A cadeia de caracteres de 128 caracteres que armazena o motivo do status de identidade do dispositivo. Todos os caracteres UTF-8 são permitidos.
statusUpdatedTime

string (date-time)

A data e a hora em que o campo de status foi atualizado pela última vez.

DeviceCapabilities

Objeto

O status dos recursos habilitados no dispositivo.

Nome Tipo Description
iotEdge

boolean

A propriedade que determina se o dispositivo é um dispositivo de borda ou não.

SymmetricKey

Objeto
Nome Tipo Description
primaryKey

string

A chave primária codificada em base64 do dispositivo.
secondaryKey

string

A chave secundária codificada em base64 do dispositivo.

X509Thumbprint

Objeto
Nome Tipo Description
primaryThumbprint

string

A impressão digital primária do certificado do cliente X509.
secondaryThumbprint

string

A impressão digital secundária do certificado do cliente X509.