Compartilhar via

Jobs - Get Scheduled Job

  • Referência
Serviço:
IoT Hub
Versão da API:
2021-04-12

Obtém detalhes de um trabalho agendado do Hub IoT. Consulte https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-jobs para obter mais informações.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
id
 path True

string

O identificador exclusivo do trabalho.
api-version
 query True

string

Versão da API.

Respostas

Nome Tipo Description
200 OK

JobResponse

OK.

Definições

Nome Description
CloudToDeviceMethod

Os parâmetros para executar um método direto no dispositivo.
DeviceCapabilities

O status de recursos habilitados no dispositivo.
DeviceJobStatistics

As estatísticas de trabalho referentes à execução status.
JobResponse
Twin

As informações de estado de um dispositivo ou módulo. Isso é criado e excluído implicitamente quando a identidade do dispositivo/módulo correspondente é criada ou excluída no Hub IoT.
TwinProperties

As propriedades desejadas e relatadas do gêmeo. A profundidade máxima do objeto é 10.
X509Thumbprint

CloudToDeviceMethod

Os parâmetros para executar um método direto no dispositivo.

Nome Tipo Description
connectTimeoutInSeconds

integer

methodName

string

O nome do método a ser executado.
payload

object

O conteúdo do método direto formatado em JSON, com até 128 kb de tamanho.
responseTimeoutInSeconds

integer

DeviceCapabilities

O status de recursos habilitados no dispositivo.

Nome Tipo Description
iotEdge

boolean

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

DeviceJobStatistics

As estatísticas de trabalho referentes à execução status.

Nome Tipo Description
deviceCount

integer

O número de dispositivos direcionados pelo trabalho.
failedCount

integer

O número de trabalhos com falha.
pendingCount

integer

O número de trabalhos pendentes (agendados).
runningCount

integer

O número de trabalhos em execução.
succeededCount

integer

O número de trabalhos bem-sucedidos.

JobResponse

Nome Tipo Description
cloudToDeviceMethod

CloudToDeviceMethod

O tipo de método e os parâmetros. Isso será necessário se o tipo de trabalho for cloudToDeviceMethod.
createdTime

string

Sistema gerado. Ignorado na criação. A data e a hora de criação do trabalho.
deviceJobStatistics

DeviceJobStatistics

Os detalhes sobre a execução do trabalho status.
endTime

string

Sistema gerado. Ignorado na criação. A data e a hora de término do trabalho em UTC.
failureReason

string

O motivo da falha, se ocorreu uma falha.
jobId

string

Sistema gerado. Ignorado na criação. O identificador exclusivo do trabalho.
maxExecutionTimeInSeconds

integer

O tempo máximo de execução em secounds.
queryCondition

string

A condição de consulta do dispositivo.
startTime

string

A data e a hora de início do trabalho agendado em UTC.
status enum:
  • cancelled
  • completed
  • enqueued
  • failed
  • queued
  • running
  • scheduled
  • unknown

Sistema gerado. Ignorado na criação. O status do trabalho.
statusMessage

string

A mensagem status do trabalho.
type enum:
  • backup
  • export
  • factoryResetDevice
  • failoverDataCopy
  • firmwareUpdate
  • import
  • readDeviceProperties
  • rebootDevice
  • restoreFromBackup
  • scheduleDeviceMethod
  • scheduleUpdateTwin
  • unknown
  • updateDeviceConfiguration
  • writeDeviceProperties

O tipo de trabalho.
updateTwin

Twin

As informações de estado de um dispositivo ou módulo. Isso é criado e excluído implicitamente quando a identidade do dispositivo/módulo correspondente é criada ou excluída no Hub IoT.

Twin

As informações de estado de um dispositivo ou módulo. Isso é criado e excluído implicitamente quando a identidade do dispositivo/módulo correspondente é criada ou excluída no Hub IoT.

Nome Tipo Description
authenticationType enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned

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

DeviceCapabilities

O status de recursos habilitados no dispositivo.
cloudToDeviceMessageCount

integer

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

O estado de conexão do dispositivo.
deviceEtag

string

A cadeia de caracteres que representa uma ETag para o dispositivo, de acordo com RFC7232.
deviceId

string

O identificador exclusivo do dispositivo no registro de identidade do Hub IoT. É uma cadeia de caracteres que diferencia maiúsculas de minúsculas (até 128 caracteres de comprimento) de caracteres alfanuméricos ASCII de 7 bits, e os seguintes caracteres especiais {'-', ':', '.', '+', '%', '_', '#', '*', '?', '!', '(', ')', ',', '=', '@', ';', '$', '''}.
deviceScope

string

O escopo do dispositivo.
etag

string

A cadeia de caracteres que representa uma ETag para o dispositivo gêmeo, de acordo com RFC7232.
lastActivityTime

string

A data e a hora em que o dispositivo se conectou pela última vez ou recebeu ou enviou uma mensagem. A data e a hora são especificadas em ISO8601 formato datetime em UTC, por exemplo, 2015-01-28T16:24:48.789Z. Esse valor não será atualizado se o dispositivo usar o protocolo HTTP/1 para executar operações de mensagens.
moduleId

string

O identificador exclusivo do módulo no registro de identidade do Hub IoT. É uma cadeia de caracteres que diferencia maiúsculas de minúsculas (até 128 caracteres de comprimento) de caracteres alfanuméricos ASCII de 7 bits, e os seguintes caracteres especiais {'-', ':', '.', '+', '%', '_', '#', '*', '?', '!', '(', ')', ',', '=', '@', ';', '$', '''}.
parentScopes

string[]

Os escopos dos dispositivos de borda de nível superior, se aplicável. Disponível somente para dispositivos de borda.
properties

TwinProperties

As propriedades desejadas e relatadas do gêmeo.
status enum:
  • disabled
  • enabled

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

string

O motivo da status atual do dispositivo, se houver.
statusUpdateTime

string

A data e a hora em que o status do dispositivo foi atualizado pela última vez.
tags

object

A coleção de pares chave-valor lida e gravada pelo back-end da solução. Eles não são visíveis para aplicativos de dispositivo. As chaves são codificadas em UTF-8, diferenciam maiúsculas de minúsculas e até 1 KB de comprimento. Os caracteres permitidos excluem caracteres de controle UNICODE (segmentos C0 e C1), '.', '$' e espaço. Os valores são objetos JSON, com até 4 KB de comprimento.
version

integer

A versão do dispositivo gêmeo, incluindo marcas e propriedades desejadas
x509Thumbprint

X509Thumbprint

A impressão digital X509 do dispositivo.

TwinProperties

As propriedades desejadas e relatadas do gêmeo. A profundidade máxima do objeto é 10.

Nome Tipo Description
desired

object

A coleção de pares chave-valor de propriedade desejados. As chaves são codificadas em UTF-8, diferenciam maiúsculas de minúsculas e até 1 KB de comprimento. Os caracteres permitidos excluem caracteres de controle UNICODE (segmentos C0 e C1), '.', '$' e espaço. Os valores de propriedade desejados são objetos JSON, com até 4 KB de comprimento.
reported

object

A coleção de pares chave-valor de propriedade relatados. As chaves são codificadas em UTF-8, diferenciam maiúsculas de minúsculas e até 1 KB de comprimento. Os caracteres permitidos excluem caracteres de controle UNICODE (segmentos C0 e C1), '.', '$' e espaço. Os valores de propriedade relatados são objetos JSON, com até 4 KB de comprimento.

X509Thumbprint

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.