Jobs - Get Scheduled Job
Obtient les détails d’un travail planifié à partir de l’IoT Hub. Pour plus d’informations, consultez https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-jobs.
GET https://fully-qualified-iothubname.azure-devices.net/jobs/v2/{id}?api-version=2021-04-12
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 |
D’ACCORD. |
Définitions
Nom | Description |
---|---|
Cloud |
Paramètres à exécuter une méthode directe sur l’appareil. |
Device |
État des fonctionnalités activées sur l’appareil. |
Device |
Statistiques du travail concernant l’état d’exécution. |
Job |
|
Twin |
Informations d’état pour un appareil ou un module. Cela est implicitement créé et supprimé lorsque l’identité d’appareil/module correspondante est créée ou supprimée dans IoT Hub. |
Twin |
Propriétés souhaitées et signalées du jumeau. La profondeur maximale de l’objet est de 10. |
X509Thumbprint |
CloudToDeviceMethod
Paramètres à exécuter une méthode directe sur l’appareil.
Nom | Type | Description |
---|---|---|
connectTimeoutInSeconds |
integer (int32) |
|
methodName |
string |
Nom de la méthode à exécuter. |
payload |
object |
Charge utile de la méthode directe au format JSON, jusqu’à 128 Ko de taille. |
responseTimeoutInSeconds |
integer (int32) |
DeviceCapabilities
État des fonctionnalités activées sur l’appareil.
Nom | Type | Description |
---|---|---|
iotEdge |
boolean |
Propriété qui détermine si l’appareil est un appareil de périphérie ou non. |
DeviceJobStatistics
Statistiques du travail concernant l’état d’exécution.
Nom | Type | Description |
---|---|---|
deviceCount |
integer (int32) |
Nombre d’appareils ciblés par le travail. |
failedCount |
integer (int32) |
Nombre de travaux ayant échoué. |
pendingCount |
integer (int32) |
Nombre de travaux en attente (planifiés). |
runningCount |
integer (int32) |
Nombre de travaux en cours d’exécution. |
succeededCount |
integer (int32) |
Nombre de travaux réussis. |
JobResponse
Nom | Type | Description |
---|---|---|
cloudToDeviceMethod |
Type de méthode et paramètres. Cela est nécessaire si le type de travail est cloudToDeviceMethod. |
|
createdTime |
string (date-time) |
Système généré. Ignoré lors de la création. Date et heure de création du travail. |
deviceJobStatistics |
Détails relatifs à l’état d’exécution du travail. |
|
endTime |
string (date-time) |
Système généré. Ignoré lors de la création. Date et heure de fin du travail au format UTC. |
failureReason |
string |
Raison de l’échec, si une défaillance s’est produite. |
jobId |
string |
Système généré. Ignoré lors de la création. Identificateur unique du travail. |
maxExecutionTimeInSeconds |
integer (int64) |
Durée d’exécution maximale dans les décodages. |
queryCondition |
string |
Condition de requête de l’appareil. |
startTime |
string (date-time) |
Date et heure de début du travail planifié au format UTC. |
status |
enum:
|
Système généré. Ignoré lors de la création. État du travail. |
statusMessage |
string |
Message d’état du travail. |
type |
enum:
|
Type de travail. |
updateTwin |
Informations d’état pour un appareil ou un module. Cela est implicitement créé et supprimé lorsque l’identité d’appareil/module correspondante est créée ou supprimée dans IoT Hub. |
Twin
Informations d’état pour un appareil ou un module. Cela est implicitement créé et supprimé lorsque l’identité d’appareil/module correspondante est créée ou supprimée dans IoT Hub.
Nom | Type | Description |
---|---|---|
authenticationType |
enum:
|
Type d’authentification utilisé par l’appareil. |
capabilities |
État des fonctionnalités activées sur l’appareil. |
|
cloudToDeviceMessageCount |
integer (int32) |
Nombre de messages cloud-à-appareil envoyés. |
connectionState |
enum:
|
É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 d’identités de l’IoT Hub. Il s’agit d’une chaîne sensible à 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-time) |
Date et heure de la dernière connexion ou réception ou envoi d’un message sur l’appareil. La date et l’heure sont sépecifiées au format datetime ISO8601 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 hub IoT. Il s’agit d’une chaîne sensible à la casse (jusqu’à 128 caractères) de caractères alphanumériques ASCII 7 bits, et les caractères spéciaux suivants {'-', ' :', '.', '+', '%', '_', '#', '*', ' ?', ' !', '(', ')', ',', '=', '@', ' ;', '$', ''}. |
parentScopes |
string[] |
Étendues des périphériques de niveau supérieur, le cas échéant. Disponible uniquement pour les appareils de périphérie. |
properties |
Propriétés souhaitées et signalées du jumeau. |
|
status |
enum:
|
État activé de l’appareil. Si cette option est désactivée, l’appareil ne peut pas se connecter au service. |
statusReason |
string |
Raison de l’état actuel de l’appareil, le cas échéant. |
statusUpdateTime |
string (date-time) |
Date et heure de la dernière mise à jour de l’état de l’appareil. |
tags |
object |
Collection de paires clé-valeur lues et écrites par le back-end de solution. Elles ne sont pas visibles pour les applications d’appareil. Elles sont codées en UTF-8, sensibles à la casse et up-to longueur de 1 Ko. Les caractères autorisés excluent les caractères de contrôle UNICODE (segments C0 et C1), « . », « $ » et espace. Les valeurs sont des objets JSON, up-to longueur de 4 Ko. |
version |
integer (int64) |
Version du jumeau d’appareil, y compris les balises et les propriétés souhaitées |
x509Thumbprint |
Empreinte 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 codées en UTF-8, respectant la casse et up-to longueur de 1 Ko. Les caractères autorisés excluent les caractères de contrôle UNICODE (segments C0 et C1), « . », « $ » et espace. Les valeurs porperty souhaitées sont des objets JSON, up-to longueur de 4 Ko. |
reported |
object |
Collection de paires clé-valeur de propriété signalées. Les clés sont codées en UTF-8, respectant la casse et up-to longueur de 1 Ko. Les caractères autorisés excluent les caractères de contrôle UNICODE (segments C0 et C1), « . », « $ » et espace. Les valeurs de propriété signalées sont des objets JSON, up-to longueur de 4 Ko. |
X509Thumbprint
Nom | Type | Description |
---|---|---|
primaryThumbprint |
string |
Empreinte numérique principale du certificat client X509. |
secondaryThumbprint |
string |
Empreinte numérique secondaire du certificat client X509. |