Updates - Get Update

Servicio:

Device Update

Versión de la API:

2020-09-01

Obtenga una versión de actualización específica.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
accountEndpoint	path	True	string	Punto de conexión de la cuenta.
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	Actualice la 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 ETag del servidor no coincide con este valor.

Respuestas

Nombre	Tipo	Description
200 OK	Update	Versión de actualización 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_GetUpdate

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:

200

{
  "updateId": {
    "provider": "microsoft",
    "name": "adu",
    "version": "1.0.0.0"
  },
  "updateType": "image",
  "installedCriteria": "SwVer=5",
  "compatibility": [
    {
      "deviceManufacturer": "Microsoft",
      "deviceModel": "Toaster"
    }
  ],
  "manifestVersion": "0.1",
  "importedDateTime": "2020-04-22T21:01:43.8408797+00:00",
  "createdDateTime": "2019-09-12T00:00:00.0000000+00:00",
  "etag": "\"3fed3378-0c67-47d2-b796-296962c66cbb\""
}

status code:

304

status code:

404

status code:

429

Definiciones

Nombre	Description
Compatibility	Actualice la información de compatibilidad.
Update	Actualizar metadatos.
UpdateId	Identificador de actualización.

Compatibility

Actualice la información de compatibilidad.

Nombre	Tipo	Description
deviceManufacturer	string	El fabricante del dispositivo con el que la actualización es compatible.
deviceModel	string	El modelo de dispositivo con el que la actualización es compatible.

Update

Actualizar metadatos.

Nombre	Tipo	Description
compatibility	Compatibility[]	Lista de información de compatibilidad de actualizaciones.
createdDateTime	string	Fecha y hora en UTC cuando se creó la actualización.
etag	string	Actualice ETag.
importedDateTime	string	Fecha y hora en UTC cuando se importó la actualización.
installedCriteria	string	Cadena interpretada por el cliente de Device Update para determinar si la actualización está instalada en el dispositivo.
manifestVersion	string	Versión de esquema del manifiesto que se usa para importar la actualización.
updateId	UpdateId	Identidad de actualización.
updateType	string	Tipo de actualización.

UpdateId

Identificador de actualización.

Nombre	Tipo	Description
name	string	Nombre de actualización.
provider	string	Proveedor de actualización.
version	string	Actualice la versión.