Partager via


Updates - Get File

Obtenez un fichier de mise à jour spécifique à partir de la version.

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

Paramètres URI

Nom Dans Obligatoire Type Description
accountEndpoint
path True

string

Point de terminaison de compte.

fileId
path True

string

Identificateur de fichier.

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

File

Entité de fichier 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_GetFile

Exemple de requête

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

Exemple de réponse

{
  "fileId": "abc123",
  "fileName": "1v5uww1q.my2",
  "sizeInBytes": 1862311,
  "hashes": {
    "sha256": "OVokcktf61lQXs17MzJCsM98lk48H1Wu1hy7Sp6lLfI="
  },
  "mimeType": "application/BuildAsync-s4jwikgq.44h",
  "etag": "\"26bd8eba-4bb2-4960-a357-ca4d60b5fb4b\""
}

Définitions

File

Mettre à jour les métadonnées du fichier.

Nom Type Description
etag

string

Fichier ETag.

fileId

string

Identité de fichier, générée par le serveur au moment de l’importation.

fileName

string

Nom du fichier.

hashes

object

Mappage de l’algorithme de hachage aux valeurs de hachage encodées en base64.

mimeType

string

Type MIME de fichier.

sizeInBytes

integer

Taille du fichier, en nombre d’octets.