Partager via

Updates - Get Update

  • Référence
Service:
Device Update
Version d'API:
2020-09-01

Obtenir une version de mise à jour spécifique.

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/providers/{provider}/names/{name}/versions/{version}

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.
name
 path True

string

Mettre à jour le nom.
provider
 path True

string

Mettre à jour le fournisseur.
version
 path True

string

Mettre à jour la version.

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

Update

Version de mise à jour demandée.
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_GetUpdate

Exemple de requête

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0

Exemple de réponse

Code d’état:
200 
{
  "updateId": {
    "provider": "microsoft",
    "name": "adu",
    "version": "1.0.0.0"
  },
  "updateType": "image",
  "installedCriteria": "SwVer=5",
  "compatibility": [
    {
      "deviceManufacturer": "Microsoft",
      "deviceModel": "Toaster"
    }
  ],
  "manifestVersion": "0.1",
  "importedDateTime": "2020-04-22T21:01:43.8408797+00:00",
  "createdDateTime": "2019-09-12T00:00:00.0000000+00:00",
  "etag": "\"3fed3378-0c67-47d2-b796-296962c66cbb\""
}
Code d’état:
304
Code d’état:
404
Code d’état:
429

Définitions

Nom Description
Compatibility

Mettre à jour les informations de compatibilité.
Update

Mettre à jour les métadonnées.
UpdateId

Mettre à jour l’identificateur.

Compatibility

Mettre à jour les informations de compatibilité.

Nom Type Description
deviceManufacturer

string

Fabricant de l’appareil avec lequel la mise à jour est compatible.
deviceModel

string

Modèle d’appareil avec lequel la mise à jour est compatible.

Update

Mettre à jour les métadonnées.

Nom Type Description
compatibility

Compatibility[]

Liste des informations de compatibilité des mises à jour.
createdDateTime

string

Date et heure utc de création de la mise à jour.
etag

string

Mettre à jour ETag.
importedDateTime

string

Date et heure UTC auxquelles la mise à jour a été importée.
installedCriteria

string

Chaîne interprétée par le client Device Update pour déterminer si la mise à jour est installée sur l’appareil.
manifestVersion

string

Version de schéma du manifeste utilisé pour importer la mise à jour.
updateId

UpdateId

Identité de la mise à jour.
updateType

string

Type de mise à jour.

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.