Device Update - List Operation Statuses

Référence

Service:: Device Update

API Version:: 2022-10-01

Obtenez la liste de toutes les opérations de mise à jour d’importation. Les opérations terminées sont conservées pendant 7 jours avant la suppression automatique. Les opérations de suppression ne sont pas retournées par cette version de l’API.

GET https://{endpoint}/deviceUpdate/{instanceId}/updates/operations?api-version=2022-10-01

With optional parameters:

GET https://{endpoint}/deviceUpdate/{instanceId}/updates/operations?filter={filter}&top={top}&api-version=2022-10-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string url	Device Update pour IoT Hub point de terminaison de compte (nom d’hôte uniquement, aucun protocole).
instanceId	path	True	string	Identificateur de instance de compte Device Update pour IoT Hub.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente.
filter	query		string	Facultatif pour filtrer les opérations par status propriété. Un seul filtre spécifique est pris en charge : « status eq 'NotStarted' ou status eq 'Running' »
top	query		integer int32	Spécifie un entier non négatif n qui limite le nombre d’éléments retournés à partir d’une collection. Le service retourne le nombre d’éléments disponibles jusqu’à , mais pas supérieur à la valeur spécifiée n.

Réponses

Nom	Type	Description
200 OK	UpdateOperationsList	Détails de l’opération.
Other Status Codes	ErrorResponse	Réponse par défaut.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nom	Description
https://api.adu.microsoft.com/.default	Étendue d’autorisation par défaut.

Exemples

DeviceUpdate_ListOperationStatuses

Sample Request

HTTP

GET https://contoso.api.adu.microsoft.com/deviceUpdate/blue/updates/operations?api-version=2022-10-01

Sample Response

Status code:: 200

{
  "value": [
    {
      "operationId": "e4491c54-916f-443d-9094-bcca546ace2f",
      "status": "Succeeded",
      "update": {
        "updateId": {
          "provider": "microsoft",
          "name": "adu",
          "version": "1.0.0.0"
        },
        "friendlyName": "Microsoft ADU v1"
      },
      "resourceLocation": "/deviceUpdate/blue/updates/providers/microsoft/names/adu/versions/1.0.0.0?api-version=2022-10-01",
      "traceId": "2b881ef9deaf5d45b0a716ca5b4145ec",
      "createdDateTime": "2020-04-22T21:00:53.2548897+00:00",
      "lastActionDateTime": "2020-04-22T21:01:43.9401420+00:00",
      "etag": "\"a0f7b6f2-3f6c-4eb6-8a59-2f5411c23888\""
    }
  ]
}

Définitions

Nom	Description
Error	Détails de l’erreur.
ErrorResponse	Réponse d’erreur courante.
InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
OperationStatus	État de l’opération.
UpdateId	Mettre à jour l’identificateur.
UpdateInfo	Mettre à jour les informations.
UpdateOperation	Métadonnées d’opération.
UpdateOperationsList	Liste des opérations avec prise en charge de la pagination du serveur.

Error

Détails de l’erreur.

Nom	Type	Description
code	string	Code d’erreur défini par le serveur.
details	Error[]	Tableau d’erreurs ayant conduit à l’erreur signalée.
innererror	InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Représentation lisible par l’homme de l’erreur.
occurredDateTime	string	Date et heure UTC auxquelles l’erreur s’est produite.
target	string	Cible de l’erreur.

ErrorResponse

Réponse d’erreur courante.

Nom	Type	Description
error	Error	Détails de l’erreur.

InnerError

Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.

Nom	Type	Description
code	string	Code d’erreur plus spécifique que celui fourni par l’erreur contenante.
errorDetail	string	Message d’erreur ou d’exception interne.
innerError	InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Représentation lisible par l’homme de l’erreur.

OperationStatus

État de l’opération.

Nom	Type	Description
Failed	string	L’opération en arrière-plan a échoué.
NotStarted	string	Opération en arrière-plan créée mais pas encore démarrée.
Running	string	L’opération en arrière-plan est en cours d’exécution.
Succeeded	string	L’opération en arrière-plan s’est terminée avec succès.

UpdateId

Mettre à jour l’identificateur.

Nom	Type	Description
name	string	Mettre à jour le nom.
provider	string	Mettre à jour le fournisseur.
version	string	Mettre à jour la version.

UpdateInfo

Mettre à jour les informations.

Nom	Type	Description
description	string	Mettre à jour la description.
friendlyName	string	Nom de la mise à jour conviviale.
updateId	UpdateId	Mettre à jour l’identificateur.

UpdateOperation

Métadonnées d’opération.

Nom	Type	Description
createdDateTime	string	Date et heure utc de création de l’opération.
error	Error	Une erreur d’opération s’est produite, le cas échéant.
etag	string	Opération ETag.
lastActionDateTime	string	Date et heure UTC de la dernière mise à jour de l’opération status.
operationId	string	ID d'opération.
resourceLocation	string	Emplacement de la mise à jour importée lorsque l’opération réussit.
status	OperationStatus	État de l’opération.
traceId	string	Identité de corrélation d’opération qui peut être utilisée par Support Microsoft pour la résolution des problèmes.
update	UpdateInfo	Mise à jour importée ou supprimée. Pour l’importation, cette propriété n’est renseignée qu’une fois le manifeste d’importation traité avec succès.

UpdateOperationsList

Liste des opérations avec prise en charge de la pagination du serveur.

Nom	Type	Description
nextLink	string	Lien vers la page suivante des éléments.
value	UpdateOperation[]	Collection d’éléments paginables.

Share via