Updates - Get File

Служба:

Device Update

Версия API:

2020-09-01

Получение определенного файла обновления из версии.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
accountEndpoint	path	True	string	Конечная точка учетной записи.
fileId	path	True	string	Идентификатор файла.
instanceId	path	True	string	Идентификатор экземпляра учетной записи.
name	path	True	string	Имя обновления.
provider	path	True	string	Поставщик обновлений.
version	path	True	string	Обновление версии.

Заголовок запроса

Имя	Обязательно	Тип	Описание
If-None-Match		string	Определяет условие If-None-Match. Операция будет выполняться только в том случае, если ETag на сервере не соответствует этому значению.

Ответы

Имя	Тип	Описание
200 OK	File	Запрошенная сущность файла.
404 Not Found		Не найдено.
429 Too Many Requests		Слишком много запросов; существует ограничение скорости для количества операций, которые могут быть выполнены в течение определенного периода времени.
Other Status Codes		Не изменено.

Безопасность

azure_auth_implicit

Неявный поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

azure_auth_code

Поток кода доступа OAuth2 в Azure Active Directory

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
URL-адрес токена: https://login.microsoftonline.com/common/oauth2/v2.0/token

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

azure_auth_application

Поток приложений OAuth2 в Azure Active Directory

Тип: oauth2
Flow: application
URL-адрес токена: https://login.microsoftonline.com/common/oauth2/v2.0/token

Области

Имя	Описание
.default	область учетных данных клиента

azure_auth_password

Поток паролей OAuth2 в Azure Active Directory

Тип: oauth2
Flow: password
URL-адрес токена: https://login.microsoftonline.com/common/oauth2/v2.0/token

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Updates_GetFile

Образец запроса

HTTP

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

Пример ответа

Код состояния:

200

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

Код состояния:

304

Код состояния:

404

Код состояния:

429

Определения

File

Обновление метаданных файла.

Имя	Тип	Описание
etag	string	ETag файла.
fileId	string	Удостоверение файла, созданное сервером во время импорта.
fileName	string	Имя файла.
hashes	object	Сопоставление алгоритма хэширования с хэш-значениями в кодировке Base64.
mimeType	string	Тип MIME файла.
sizeInBytes	integer	Размер файла в байтах.