Compartilhar via

Updates - Get Operation

  • Referência
Serviço:
Device Update
Versão da API:
2020-09-01

Recuperar o status da operação.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
accountEndpoint
 path True

string

Ponto de extremidade da conta.
instanceId
 path True

string

Identificador da instância da conta.
operationId
 path True

string

Identificador de operação.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
If-None-Match

string

Define a condição If-None-Match. A operação será executada somente se a ETag no servidor não corresponder a esse valor.

Respostas

Nome Tipo Description
200 OK

Operation

Status da operação.

Cabeçalhos

Retry-After: string
404 Not Found

Não encontrado.
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.
Other Status Codes

Não modificado.

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_GetOperation

Solicitação de exemplo

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f

Resposta de exemplo

Código de status:
200 
{
  "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:
304
Código de status:
404
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 de operação.
OperationStatus

Status da operação.
UpdateId

Identificador de atualização.

Error

Objeto

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 ser humano do erro.
occurredDateTime

string (date-time)

Data e hora em UTC quando o erro ocorreu.
target

string

O destino do erro.

InnerError

Objeto

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 ser humano do erro.

Operation

Objeto

Metadados de operação.

Nome Tipo Description
createdDateTime

string (date-time)

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 (date-time)

Data e hora em UTC quando o status da operação foi atualizado 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 pelo 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

Enumeração

Status da operação.

Valor Description
Failed

Operação em segundo plano concluída com falha.
NotStarted

Operação em segundo plano criada, mas ainda não iniciada.
Running

A operação em segundo plano está em execução no momento.
Succeeded

Operação em segundo plano concluída com êxito.
Undefined

Status de operação indefinido.

UpdateId

Objeto

Identificador de atualização.

Nome Tipo Description
name

string

Nome da atualização.
provider

string

Atualizar o provedor.
version

string

Atualizar versão.