Updates - Get File

Tjänst:

Device Update

API-version:

2020-09-01

Hämta en specifik uppdateringsfil från versionen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountEndpoint	path	True	string	Kontoslutpunkt.
fileId	path	True	string	Filidentifierare.
instanceId	path	True	string	Kontoinstansidentifierare.
name	path	True	string	Uppdateringsnamn.
provider	path	True	string	Uppdatera provider.
version	path	True	string	Uppdatera version.

Begärandehuvud

Name	Obligatorisk	Typ	Description
If-None-Match		string	Definierar villkoret If-None-Match. Åtgärden utförs endast om ETag på servern inte matchar det här värdet.

Svar

Name	Typ	Description
200 OK	File	Den begärda filentiteten.
404 Not Found		Hittades inte.
429 Too Many Requests		För många begäranden; det finns en hastighetsgräns för hur många åtgärder som kan utföras inom en tidsperiod.
Other Status Codes		Har inte ändrats.

Säkerhet

azure_auth_implicit

Implicit flöde i Azure Active Directory OAuth2

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

azure_auth_code

Azure Active Directory OAuth2 AccessCode Flow

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token-webbadress: https://login.microsoftonline.com/common/oauth2/v2.0/token

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

azure_auth_application

Azure Active Directory OAuth2-programflöde

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

Omfattningar

Name	Description
.default	omfång för klientautentiseringsuppgifter

azure_auth_password

Azure Active Directory OAuth2-lösenordsflöde

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

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Updates_GetFile

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:

200

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

Statuskod:

304

Statuskod:

404

Statuskod:

429

Definitioner

File

Uppdatera filmetadata.

Name	Typ	Description
etag	string	Filen ETag.
fileId	string	Filidentitet som genereras av servern vid importtillfället.
fileName	string	Filnamn.
hashes	object	Mappning av hash-algoritmen till base64-kodade hash-värden.
mimeType	string	MIME-filtyp.
sizeInBytes	integer	Filstorlek i antal byte.