Jobs - Get Scheduled Job

  • Référence
Service:
IoT Hub
API Version:
2020-05-31-preview

Obtient les détails d’un travail planifié à partir du IoT Hub. Consultez la rubrique https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-jobs (éventuellement en anglais) pour plus d'informations.

GET https://fully-qualified-iothubname.azure-devices.net/jobs/v2/{id}?api-version=2020-05-31-preview

Paramètres URI

Nom Dans Obligatoire Type Description
id
 path True

string

Identificateur unique du travail.
api-version
 query True

string

Version de l’API.

Réponses

Nom Type Description
200 OK

JobResponse

OK.

Définitions

Nom Description
CloudToDeviceMethod

Paramètres pour exécuter une méthode directe sur l’appareil.
DeviceCapabilities

Status des fonctionnalités activées sur l’appareil.
DeviceJobStatistics

Statistiques de travail relatives à l’exécution status.
JobResponse
Twin

Informations d’état d’un appareil ou d’un module. Elle est implicitement créée et supprimée lorsque l’identité d’appareil/module correspondante est créée ou supprimée dans le IoT Hub.
TwinProperties

Propriétés souhaitées et signalées du jumeau. La profondeur maximale de l’objet est de 10.
X509Thumbprint

CloudToDeviceMethod

Paramètres pour exécuter une méthode directe sur l’appareil.

Nom Type Description
connectTimeoutInSeconds

integer

methodName

string

Nom de la méthode à exécuter.
payload

object

Charge utile de la méthode directe au format JSON, d’une taille maximale de 128 Ko.
responseTimeoutInSeconds

integer

DeviceCapabilities

Status des fonctionnalités activées sur l’appareil.

Nom Type Description
iotEdge

boolean

Propriété qui détermine si l’appareil est un périphérique ou non.

DeviceJobStatistics

Statistiques de travail relatives à l’exécution status.

Nom Type Description
deviceCount

integer

Nombre d’appareils ciblés par le travail.
failedCount

integer

Nombre de travaux ayant échoué.
pendingCount

integer

Nombre de travaux (planifiés) en attente.
runningCount

integer

Nombre de travaux en cours d’exécution.
succeededCount

integer

Nombre de travaux réussis.

JobResponse

Nom Type Description
cloudToDeviceMethod

CloudToDeviceMethod

Type et paramètres de méthode. Cela est obligatoire si le type de travail est cloudToDeviceMethod.
createdTime

string

Généré par le système. Ignoré lors de la création. Date et heure de création du travail.
deviceJobStatistics

DeviceJobStatistics

Détails relatifs à l’exécution du travail status.
endTime

string

Généré par le système. Ignoré lors de la création. Date et heure de fin du travail en UTC.
failureReason

string

Raison de l’échec, si un échec s’est produit.
jobId

string

Généré par le système. Ignoré lors de la création. Identificateur unique du travail.
maxExecutionTimeInSeconds

integer

Durée d’exécution maximale dans les secounds.
queryCondition

string

Condition de requête de l’appareil.
startTime

string

Date et heure de début du travail planifié au format UTC.
status enum:
  • cancelled
  • completed
  • enqueued
  • failed
  • queued
  • running
  • scheduled
  • unknown

Généré par le système. Ignoré lors de la création. État du travail.
statusMessage

string

Message status du travail.
type enum:
  • backup
  • export
  • factoryResetDevice
  • failoverDataCopy
  • firmwareUpdate
  • import
  • readDeviceProperties
  • rebootDevice
  • restoreFromBackup
  • scheduleDeviceMethod
  • scheduleUpdateTwin
  • unknown
  • updateDeviceConfiguration
  • writeDeviceProperties

Type de travail.
updateTwin

Twin

Informations d’état d’un appareil ou d’un module. Elle est implicitement créée et supprimée lorsque l’identité d’appareil/module correspondante est créée ou supprimée dans le IoT Hub.

Twin

Informations d’état d’un appareil ou d’un module. Elle est implicitement créée et supprimée lorsque l’identité d’appareil/module correspondante est créée ou supprimée dans le IoT Hub.

Nom Type Description
authenticationType enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned

Type d’authentification utilisé par l’appareil.
capabilities

DeviceCapabilities

Status des fonctionnalités activées sur l’appareil.
cloudToDeviceMessageCount

integer

Nombre de messages cloud-à-appareil envoyés.
connectionState enum:
  • Connected
  • Disconnected

État de connexion de l’appareil.
deviceEtag

string

Chaîne représentant un ETag pour l’appareil, conformément RFC7232.
deviceId

string

Identificateur unique de l’appareil dans le registre des identités du IoT Hub. Il s’agit d’une chaîne respectant la casse (jusqu’à 128 caractères) de caractères alphanumériques ASCII 7 bits, et les caractères spéciaux suivants {'-', ' :', '.', '+', '%', '_', '#', '*', ' ?', ' !', '(', ')', ',', '=', '@', ' ;', '$', '''}.
deviceScope

string

Portée de l’appareil.
etag

string

Chaîne représentant un ETag pour le jumeau d’appareil, conformément RFC7232.
lastActivityTime

string

Date et heure de la dernière connexion de l’appareil, de réception ou d’envoi d’un message. La date et l’heure sont saisies dans ISO8601 format datetime au format UTC, par exemple 2015-01-28T16 :24 :48.789Z. Cette valeur n’est pas mise à jour si l’appareil utilise le protocole HTTP/1 pour effectuer des opérations de messagerie.
moduleId

string

Identificateur unique du module dans le registre des identités du IoT Hub. Il s’agit d’une chaîne respectant la casse (jusqu’à 128 caractères) de caractères alphanumériques ASCII 7 bits, et les caractères spéciaux suivants {'-', ' :', '.', '+', '%', '_', '#', '*', ' ?', ' !', '(', ')', ',', '=', '@', ' ;', '$', '''}.
properties

TwinProperties

Propriétés souhaitées et signalées du jumeau.
status enum:
  • disabled
  • enabled

status activé de l’appareil. S’il est désactivé, l’appareil ne peut pas se connecter au service.
statusReason

string

Raison de la status actuelle de l’appareil, le cas échéant.
statusUpdateTime

string

Date et heure de la dernière mise à jour du status de l’appareil.
tags

object

Collection de paires clé-valeur lues et écrites par le serveur principal de la solution. Ils ne sont pas visibles pour les applications d’appareil. Elles sont encodées en UTF-8, respectant la casse et d’une longueur maximale de 1 Ko. Les caractères autorisés excluent les caractères de contrôle UNICODE (segments C0 et C1), '.', '$' et space. Les valeurs sont des objets JSON, d’une longueur maximale de 4 Ko.
version

integer

Version du jumeau d’appareil, y compris les balises et les propriétés souhaitées
x509Thumbprint

X509Thumbprint

Empreinte numérique X509 de l’appareil.

TwinProperties

Propriétés souhaitées et signalées du jumeau. La profondeur maximale de l’objet est de 10.

Nom Type Description
desired

object

Collection de paires clé-valeur de propriété souhaitées. Les clés sont encodées en UTF-8, respectant la casse et d’une longueur maximale de 1 Ko. Les caractères autorisés excluent les caractères de contrôle UNICODE (segments C0 et C1), '.', '$' et space. Les valeurs souhaitées sont des objets JSON, d’une longueur maximale de 4 Ko.
reported

object

Collection de paires clé-valeur de propriété signalées. Les clés sont encodées en UTF-8, respectant la casse et d’une longueur maximale de 1 Ko. Les caractères autorisés excluent les caractères de contrôle UNICODE (segments C0 et C1), '.', '$' et space. Les valeurs de propriété signalées sont des objets JSON, d’une longueur maximale de 4 Ko.

X509Thumbprint

Nom Type Description
primaryThumbprint

string

Empreinte numérique principale du certificat client X509.
secondaryThumbprint

string

Empreinte secondaire du certificat client X509.