Updates - Get File

Usługa:

Device Update

Wersja interfejsu API:

2020-09-01

Pobierz określony plik aktualizacji z wersji.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountEndpoint	path	True	string	Punkt końcowy konta.
fileId	path	True	string	Identyfikator pliku.
instanceId	path	True	string	Identyfikator wystąpienia konta.
name	path	True	string	Zaktualizuj nazwę.
provider	path	True	string	Aktualizuj dostawcę.
version	path	True	string	Aktualizacja wersji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
If-None-Match		string	Definiuje warunek If-None-Match. Operacja zostanie wykonana tylko wtedy, gdy element ETag na serwerze nie jest zgodny z tą wartością.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	File	Żądana jednostka pliku.
404 Not Found		Nie znaleziono.
429 Too Many Requests		Zbyt wiele żądań; Istnieje limit liczby operacji, które można wykonać w danym okresie.
Other Status Codes		Nie zmodyfikowano.

Zabezpieczenia

azure_auth_implicit

Przepływ niejawny OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

azure_auth_code

Przepływ kodu dostępu OAuth2 w usłudze Azure Active Directory

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Adres URL tokenu: https://login.microsoftonline.com/common/oauth2/v2.0/token

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

azure_auth_application

Przepływ aplikacji OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: application
Adres URL tokenu: https://login.microsoftonline.com/common/oauth2/v2.0/token

Zakresy

Nazwa	Opis
.default	zakres poświadczeń klienta

azure_auth_password

Przepływ haseł OAuth2 w usłudze Azure Active Directory

Typ: oauth2
Flow: password
Adres URL tokenu: https://login.microsoftonline.com/common/oauth2/v2.0/token

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Updates_GetFile

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

200

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

Kod stanu:

304

Kod stanu:

404

Kod stanu:

429

Definicje

File

Aktualizowanie metadanych pliku.

Nazwa	Typ	Opis
etag	string	Plik ETag.
fileId	string	Tożsamość pliku wygenerowana przez serwer w czasie importowania.
fileName	string	Nazwa pliku.
hashes	object	Mapowanie algorytmu tworzenia skrótów na wartości skrótu zakodowane w formacie Base64.
mimeType	string	Typ MIME pliku.
sizeInBytes	integer	Rozmiar pliku w liczbie bajtów.