Updates - Get Operation
Récupérer les status d’opération.
GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/operations/{operationId}Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
account
|
path | True |
string |
Point de terminaison de compte. |
|
instance
|
path | True |
string |
Identificateur de instance de compte. |
|
operation
|
path | True |
string |
Identificateur d'opération. |
En-tête de la demande
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| If-None-Match |
string |
Définit la condition If-None-Match. L’opération n’est effectuée que si l’ETag sur le serveur ne correspond pas à cette valeur. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
État de l’opération. En-têtes Retry-After: string |
|
| 404 Not Found |
Introuvable. |
|
| 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. |
|
| Other Status Codes |
Non modifié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_GetOperation
Exemple de requête
GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f
Exemple de réponse
{
"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\""
}Définitions
| Nom | Description |
|---|---|
| Error |
Détails de l’erreur. |
|
Inner |
Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur. |
| Operation |
Métadonnées d’opération. |
|
Operation |
État de l’opération. |
|
Update |
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 |
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 |
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 |
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 |
É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 |
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. |
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. |