Updates - Get Operations

Référence

Service:: Device Update

Version d'API:: 2020-09-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://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/operations

Avec des paramètres facultatifs:

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/operations?$filter={$filter}&$top={$top}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
accountEndpoint	path	True	string	Point de terminaison de compte.
instanceId	path	True	string	Identificateur de instance de compte.
$filter	query		string	Limite l’ensemble des opérations retournées. 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	PageableListOfOperations	Détails de l’opération.
429 Too Many Requests		Trop de demandes ; il existe une limite de débit sur le nombre d’opérations pouvant être exécutées dans une période donnée.

Sécurité

azure_auth_implicit

Flux implicite OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

azure_auth_code

Flux de code d’accès OAuth2 Azure Active Directory

Type: oauth2
Flux: accessCode
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
URL du jeton: https://login.microsoftonline.com/common/oauth2/v2.0/token

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

azure_auth_application

Flux d’application OAuth2 Azure Active Directory

Type: oauth2
Flux: application
URL du jeton: https://login.microsoftonline.com/common/oauth2/v2.0/token

Étendues

Nom	Description
.default	Étendue des informations d’identification du client

azure_auth_password

Flux de mot de passe OAuth2 Azure Active Directory

Type: oauth2
Flux: password
URL du jeton: https://login.microsoftonline.com/common/oauth2/v2.0/token

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

Updates_GetOperations

Exemple de requête

HTTP

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/operations

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "operationId": "e4491c54-916f-443d-9094-bcca546ace2f",
      "status": "Succeeded",
      "resourceLocation": "/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0",
      "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\""
    }
  ]
}

Code d’état:: 429

Définitions

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

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.

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.

Operation

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.
updateId	UpdateId	Identité de la mise à jour en cours d’importation ou de suppression. Pour l’importation, cette propriété n’est renseignée qu’une fois le manifeste d’importation traité avec succès.

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.
Undefined	string	Status d’opération non définie.

PageableListOfOperations

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	Operation[]	Collection d’éléments paginables.

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.