Updates - Get File

Servicio:

Device Update

Versión de la API:

2020-09-01

Obtenga un archivo de actualización específico de la versión.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
accountEndpoint	path	True	string	Punto de conexión de la cuenta.
fileId	path	True	string	Identificador de archivo.
instanceId	path	True	string	Identificador de instancia de cuenta.
name	path	True	string	Nombre de actualización.
provider	path	True	string	Proveedor de actualización.
version	path	True	string	Actualizar versión.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
If-None-Match		string	Define la condición If-None-Match. La operación solo se realizará si la etiqueta ETag del servidor no coincide con este valor.

Respuestas

Nombre	Tipo	Description
200 OK	File	Entidad de archivo solicitada.
404 Not Found		Not found.
429 Too Many Requests		Demasiadas solicitudes; hay un límite de velocidad en el número de operaciones que se pueden ejecutar en un período de tiempo.
Other Status Codes		No se ha modificado.

Seguridad

azure_auth_implicit

Flujo implícito de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

azure_auth_code

Flujo de código de código de acceso de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Dirección URL del token: https://login.microsoftonline.com/common/oauth2/v2.0/token

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

azure_auth_application

Flujo de aplicaciones de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: application
Dirección URL del token: https://login.microsoftonline.com/common/oauth2/v2.0/token

Ámbitos

Nombre	Description
.default	ámbito de credenciales de cliente

azure_auth_password

Flujo de contraseña de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: password
Dirección URL del token: https://login.microsoftonline.com/common/oauth2/v2.0/token

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Updates_GetFile

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:

200

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

status code:

304

status code:

404

status code:

429

Definiciones

File

Actualizar los metadatos del archivo.

Nombre	Tipo	Description
etag	string	ETag de archivo.
fileId	string	Identidad de archivo, generada por el servidor en el momento de la importación.
fileName	string	Nombre de archivo.
hashes	object	Asignación del algoritmo hash a valores hash codificados en base64.
mimeType	string	Tipo MIME de archivo.
sizeInBytes	integer	Tamaño de archivo en número de bytes.