Updates - Get Operation

Service:

Device Update

API Version:

2020-09-01

Pobieranie stanu operacji.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountEndpoint	path	True	string	Punkt końcowy konta.
instanceId	path	True	string	Identyfikator wystąpienia konta.
operationId	path	True	string	Identyfikator operacji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
If-None-Match		string	Definiuje warunek If-None-Match. Operacja zostanie wykonana tylko wtedy, gdy element ETag na serwerze nie jest zgodny z tą wartością.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Operation	Stan operacji. Headers Retry-After: string
404 Not Found		Nie znaleziono.
429 Too Many Requests		Zbyt wiele żądań; Istnieje limit liczby operacji, które można wykonać w danym okresie.
Other Status Codes		Nie zmodyfikowano.

Zabezpieczenia

azure_auth_implicit

Przepływ niejawny OAuth2 usługi Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

azure_auth_code

Przepływ kodu dostępu OAuth2 w usłudze Azure Active Directory

Type: oauth2
Flow: accessCode
Authorization URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

azure_auth_application

Przepływ aplikacji OAuth2 usługi Azure Active Directory

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

Scopes

Nazwa	Opis
.default	zakres poświadczeń klienta

azure_auth_password

Przepływ haseł OAuth2 w usłudze Azure Active Directory

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

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Updates_GetOperation

Sample Request

HTTP

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

Sample Response

Status code:

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

Status code:

304

Status code:

404

Status code:

429

Definicje

Nazwa	Opis
Error	Szczegóły błędu.
InnerError	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
Operation	Metadane operacji.
OperationStatus	Stan operacji.
UpdateId	Aktualizowanie identyfikatora.

Error

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Kod błędu zdefiniowany przez serwer.
details	Error[]	Tablica błędów, które doprowadziły do zgłoszonego błędu.
innererror	InnerError	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
message	string	Czytelna dla człowieka reprezentacja błędu.
occurredDateTime	string	Data i godzina w formacie UTC, kiedy wystąpił błąd.
target	string	Element docelowy błędu.

InnerError

Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.

Nazwa	Typ	Opis
code	string	Bardziej szczegółowy kod błędu niż podany przez błąd zawierający.
errorDetail	string	Błąd wewnętrzny lub komunikat o wyjątku.
innerError	InnerError	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
message	string	Czytelna dla człowieka reprezentacja błędu.

Operation

Metadane operacji.

Nazwa	Typ	Opis
createdDateTime	string	Data i godzina w formacie UTC utworzenia operacji.
error	Error	Napotkano błąd operacji, jeśli istnieje.
etag	string	Operacja ETag.
lastActionDateTime	string	Data i godzina w formacie UTC ostatniej aktualizacji stanu operacji.
operationId	string	Identyfikator operacji.
resourceLocation	string	Lokalizacja zaimportowanej aktualizacji, gdy operacja zakończy się pomyślnie.
status	OperationStatus	Stan operacji.
traceId	string	Tożsamość korelacji operacji, która może być używana przez pomoc techniczna firmy Microsoft na potrzeby rozwiązywania problemów.
updateId	UpdateId	Tożsamość aktualizacji importowanej lub usuniętej. W przypadku importu ta właściwość zostanie wypełniona tylko po pomyślnym przetworzeniu manifestu importu.

OperationStatus

Stan operacji.

Nazwa	Typ	Opis
Failed	string	Operacja w tle zakończyła się niepowodzeniem.
NotStarted	string	Operacja w tle została utworzona, ale nie została jeszcze uruchomiona.
Running	string	Operacja w tle jest obecnie uruchomiona.
Succeeded	string	Operacja w tle zakończyła się powodzeniem.
Undefined	string	Stan niezdefiniowanej operacji.

UpdateId

Aktualizowanie identyfikatora.

Nazwa	Typ	Opis
name	string	Zaktualizuj nazwę.
provider	string	Aktualizuj dostawcę.
version	string	Aktualizacja wersji.