Updates - Get Operations

Serviço:

Device Update

Versão da API:

2020-09-01

Obtenha uma lista de todas as operações de atualização de importação. As operações concluídas são mantidas por 7 dias antes da exclusão automática. As operações de exclusão não são retornadas por esta versão da API.

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

Com parâmetros opcionais:

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
accountEndpoint	path	True	string	Ponto de extremidade da conta.
instanceId	path	True	string	Identificador de instância de conta.
$filter	query		string	Restringe o conjunto de operações retornadas. Há suporte apenas para um filtro específico: "status eq 'NotStarted' ou status eq 'Running'"
$top	query		integer int32	Especifica um inteiro não negativo n que limita o número de itens retornados de uma coleção. O serviço retorna o número de itens disponíveis até, mas não maior que o valor especificado n.

Respostas

Nome	Tipo	Description
200 OK	PageableListOfOperations	Detalhes da operação.
429 Too Many Requests		Muitas solicitações; há um limite de taxa em quantas operações podem ser executadas em um período de tempo.

Segurança

azure_auth_implicit

Fluxo Implícito do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

azure_auth_code

Fluxo do AccessCode do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
URL do Token: https://login.microsoftonline.com/common/oauth2/v2.0/token

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

azure_auth_application

Fluxo de Aplicativos OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: application
URL do Token: https://login.microsoftonline.com/common/oauth2/v2.0/token

Escopos

Nome	Description
.default	escopo da credencial do cliente

azure_auth_password

Fluxo de senha do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: password
URL do Token: https://login.microsoftonline.com/common/oauth2/v2.0/token

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Updates_GetOperations

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:

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\""
    }
  ]
}

Código de status:

429

Definições

Nome	Description
Error	Detalhes do erro.
InnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.
Operation	Metadados da operação.
OperationStatus	Status da operação.
PageableListOfOperations	A lista de operações com suporte à paginação do servidor.
UpdateId	Identificador de atualização.

Error

Detalhes do erro.

Nome	Tipo	Description
code	string	Código de erro definido pelo servidor.
details	Error[]	Uma matriz de erros que levou ao erro relatado.
innererror	InnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.
message	string	Uma representação legível pelo homem do erro.
occurredDateTime	string	Data e hora em UTC quando o erro ocorreu.
target	string	O destino do erro.

InnerError

Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.

Nome	Tipo	Description
code	string	Um código de erro mais específico do que o fornecido pelo erro que contém.
errorDetail	string	O erro interno ou a mensagem de exceção.
innerError	InnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.
message	string	Uma representação legível pelo homem do erro.

Operation

Metadados da operação.

Nome	Tipo	Description
createdDateTime	string	Data e hora em UTC quando a operação foi criada.
error	Error	Erro de operação encontrado, se houver.
etag	string	Operação ETag.
lastActionDateTime	string	Data e hora em UTC quando a operação status foi atualizada pela última vez.
operationId	string	ID da Operação.
resourceLocation	string	Local da atualização importada quando a operação for bem-sucedida.
status	OperationStatus	Status da operação.
traceId	string	Identidade de correlação de operação que pode ser usada por Suporte da Microsoft para solução de problemas.
updateId	UpdateId	A identidade da atualização que está sendo importada ou excluída. Para importação, essa propriedade só será preenchida depois que o manifesto de importação for processado com êxito.

OperationStatus

Status da operação.

Nome	Tipo	Description
Failed	string	Operação em segundo plano concluída com falha.
NotStarted	string	Operação em segundo plano criada, mas ainda não iniciada.
Running	string	A operação em segundo plano está em execução no momento.
Succeeded	string	Operação em segundo plano concluída com êxito.
Undefined	string	Operação indefinida status.

PageableListOfOperations

A lista de operações com suporte à paginação do servidor.

Nome	Tipo	Description
nextLink	string	O link para a próxima página de itens.
value	Operation[]	A coleção de itens pagináveis.

UpdateId

Identificador de atualização.

Nome	Tipo	Description
name	string	Nome da atualização.
provider	string	Atualizar provedor.
version	string	Atualizar versão.