Updates - Get File

Dienst:

Device Update

API-Version:

2020-09-01

Rufen Sie eine bestimmte Updatedatei aus der Version ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountEndpoint	path	True	string	Kontoendpunkt.
fileId	path	True	string	Dateibezeichner.
instanceId	path	True	string	Konto instance Bezeichner.
name	path	True	string	Name aktualisieren.
provider	path	True	string	Updateanbieter.
version	path	True	string	Aktualisieren Sie die Version.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
If-None-Match		string	Definiert die If-None-Match-Bedingung. Der Vorgang wird nur ausgeführt, wenn das ETag auf dem Server nicht mit diesem Wert übereinstimmt.

Antworten

Name	Typ	Beschreibung
200 OK	File	Die angeforderte Dateientität.
404 Not Found		Nicht gefunden:
429 Too Many Requests		Zu viele Anforderungen; Es gibt ein Ratenlimit für die Anzahl von Vorgängen, die innerhalb eines Zeitraums ausgeführt werden können.
Other Status Codes		Nicht geändert.

Sicherheit

azure_auth_implicit

Impliziter Azure Active Directory OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

azure_auth_code

Azure Active Directory OAuth2 AccessCode Flow

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token-URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

azure_auth_application

Azure Active Directory OAuth2-Anwendungsflow

Typ: oauth2
Ablauf: application
Token-URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Bereiche

Name	Beschreibung
.default	Clientanmeldeinformationsbereich

azure_auth_password

Azure Active Directory OAuth2-Kennwortfluss

Typ: oauth2
Ablauf: password
Token-URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Updates_GetFile

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

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

Statuscode:

304

Statuscode:

404

Statuscode:

429

Definitionen

File

Aktualisieren von Dateimetadaten.

Name	Typ	Beschreibung
etag	string	Datei ETag.
fileId	string	Dateiidentität, die vom Server zur Importzeit generiert wird.
fileName	string	Dateiname
hashes	object	Zuordnung des Hashingalgorithmus zu Base64-codierten Hashwerten.
mimeType	string	Datei-MIME-Typ.
sizeInBytes	integer	Dateigröße in Byte