Updates - Get Operations

Servicio:

Device Update

Versión de la API:

2020-09-01

Obtenga una lista de todas las operaciones de actualización de importación. Las operaciones completadas se conservan durante 7 días antes de eliminarse automáticamente. Esta versión de api no devuelve las operaciones de eliminación.

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/operations

Con parámetros opcionales:

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/operations?$filter={$filter}&$top={$top}

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.
$filter	query		string	Restringe el conjunto de operaciones devueltas. Solo se admite un filtro específico: "status eq 'NotStarted' o status eq 'Running'"
$top	query		integer int32	Especifica un entero no negativo n que limita el número de elementos devueltos de una colección. El servicio devuelve el número de elementos disponibles hasta pero no mayor que el valor especificado n.

Respuestas

Nombre	Tipo	Description
200 OK	PageableListOfOperations	Detalles de la operación.
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.

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_GetOperations

Solicitud de ejemplo

HTTP

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/operations

Respuesta de muestra

status code:

200

{
  "value": [
    {
      "operationId": "e4491c54-916f-443d-9094-bcca546ace2f",
      "status": "Succeeded",
      "resourceLocation": "/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0",
      "traceId": "2b881ef9deaf5d45b0a716ca5b4145ec",
      "createdDateTime": "2020-04-22T21:00:53.2548897+00:00",
      "lastActionDateTime": "2020-04-22T21:01:43.9401420+00:00",
      "etag": "\"a0f7b6f2-3f6c-4eb6-8a59-2f5411c23888\""
    }
  ]
}

status code:

429

Definiciones

Nombre	Description
Error	Detalles del error.
InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
Operation	Metadatos de la operación.
OperationStatus	Estado de la operación.
PageableListOfOperations	Lista de operaciones con compatibilidad con paginación del servidor.
UpdateId	Identificador de actualización.

Error

Detalles del error.

Nombre	Tipo	Description
code	string	Código de error definido por el servidor.
details	Error[]	Matriz de errores que provocó el error notificado.
innererror	InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Representación legible del error.
occurredDateTime	string	Fecha y hora en UTC cuando se produjo el error.
target	string	Destino del error.

InnerError

Objeto que contiene información más específica que el objeto actual sobre el error.

Nombre	Tipo	Description
code	string	Un código de error más específico que el proporcionado por el error contenedor.
errorDetail	string	Mensaje interno de error o excepción.
innerError	InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Representación legible del error.

Operation

Metadatos de la operación.

Nombre	Tipo	Description
createdDateTime	string	Fecha y hora en UTC cuando se creó la operación.
error	Error	Error de operación encontrado, si existe.
etag	string	Operación ETag.
lastActionDateTime	string	Fecha y hora en UTC en que se actualizó por última vez el estado de la operación.
operationId	string	Identificador de operación.
resourceLocation	string	Ubicación de la actualización importada cuando la operación se realiza correctamente.
status	OperationStatus	Estado de la operación.
traceId	string	Identidad de correlación de operaciones que puede usar Soporte técnico de Microsoft para solucionar problemas.
updateId	UpdateId	Identidad de la actualización que se va a importar o eliminar. Para la importación, esta propiedad solo se rellenará después de que el manifiesto de importación se procese correctamente.

OperationStatus

Estado de la operación.

Nombre	Tipo	Description
Failed	string	La operación en segundo plano finalizó con un error.
NotStarted	string	Operación en segundo plano creada pero no iniciada todavía.
Running	string	La operación en segundo plano se está ejecutando actualmente.
Succeeded	string	La operación en segundo plano finalizó correctamente.
Undefined	string	Estado de la operación sin definir.

PageableListOfOperations

Lista de operaciones con compatibilidad con paginación del servidor.

Nombre	Tipo	Description
nextLink	string	Vínculo a la página siguiente de elementos.
value	Operation[]	Colección de elementos paginables.

UpdateId

Identificador de actualización.

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