Updates - Get Operations

Služba:

Device Update

Verze rozhraní API:

2020-09-01

Získejte seznam všech operací importu aktualizací. Dokončené operace se před automatickým odstraněním uchovávají po dobu 7 dnů. Tato verze rozhraní API nevrátá operace odstranění.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
accountEndpoint	path	True	string	Koncový bod účtu.
instanceId	path	True	string	Identifikátor instance účtu.
$filter	query		string	Omezuje sadu vrácených operací. Podporuje se pouze jeden konkrétní filtr: status eq 'NotStarted' nebo status eq 'Running'.
$top	query		integer int32	Určuje nezáporné celé číslo n, které omezuje počet položek vrácených z kolekce. Služba vrátí počet dostupných položek až do zadané hodnoty n, ale ne větší.

Odpovědi

Name	Typ	Description
200 OK	PageableListOfOperations	Podrobnosti o operaci.
429 Too Many Requests		Příliš mnoho požadavků; existuje omezení četnosti, kolik operací je možné provést během časového období.

Zabezpečení

azure_auth_implicit

Implicitní tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

azure_auth_code

Tok přístupového kódu Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
URL tokenu: https://login.microsoftonline.com/common/oauth2/v2.0/token

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

azure_auth_application

Tok aplikace Azure Active Directory OAuth2

Typ: oauth2
Tok: application
URL tokenu: https://login.microsoftonline.com/common/oauth2/v2.0/token

Rozsahy

Name	Description
.default	Rozsah přihlašovacích údajů klienta

azure_auth_password

Tok hesel Azure Active Directory OAuth2

Typ: oauth2
Tok: password
URL tokenu: https://login.microsoftonline.com/common/oauth2/v2.0/token

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Updates_GetOperations

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

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

Stavový kód:

429

Definice

Name	Description
Error	Podrobnosti o chybě.
InnerError	Objekt obsahující konkrétnější informace o chybě než aktuální objekt.
Operation	Metadata operace.
OperationStatus	Stav operace.
PageableListOfOperations	Seznam operací s podporou stránkování serveru
UpdateId	Identifikátor aktualizace.

Error

Podrobnosti o chybě.

Name	Typ	Description
code	string	Kód chyby definovaný serverem
details	Error[]	Pole chyb, které vedly k nahlášené chybě.
innererror	InnerError	Objekt obsahující konkrétnější informace o chybě než aktuální objekt.
message	string	Lidsky čitelná reprezentace chyby.
occurredDateTime	string	Datum a čas ve standardu UTC, kdy došlo k chybě.
target	string	Cíl chyby.

InnerError

Objekt obsahující konkrétnější informace o chybě než aktuální objekt.

Name	Typ	Description
code	string	Konkrétnější kód chyby, než jaký byl poskytnut v obsahující chybě.
errorDetail	string	Vnitřní chyba nebo zpráva o výjimce.
innerError	InnerError	Objekt obsahující konkrétnější informace o chybě než aktuální objekt.
message	string	Lidsky čitelná reprezentace chyby.

Operation

Metadata operace.

Name	Typ	Description
createdDateTime	string	Datum a čas ve standardu UTC, kdy byla operace vytvořena.
error	Error	Došlo k chybě operace, pokud existuje.
etag	string	Značka ETag operace.
lastActionDateTime	string	Datum a čas ve standardu UTC, kdy byl stav operace naposledy aktualizován.
operationId	string	ID operace.
resourceLocation	string	Umístění importované aktualizace, když je operace úspěšná.
status	OperationStatus	Stav operace.
traceId	string	Identita korelace operace, kterou může podpora Microsoftu použít k řešení potíží.
updateId	UpdateId	Identita importu nebo odstranění aktualizace. U importu se tato vlastnost naplní až po úspěšném zpracování manifestu importu.

OperationStatus

Stav operace.

Name	Typ	Description
Failed	string	Operace na pozadí byla dokončena se selháním.
NotStarted	string	Operace na pozadí byla vytvořena, ale ještě nebyla spuštěna.
Running	string	Operace na pozadí je právě spuštěná.
Succeeded	string	Operace na pozadí byla úspěšně dokončena.
Undefined	string	Nedefinovaný stav operace.

PageableListOfOperations

Seznam operací s podporou stránkování serveru

Name	Typ	Description
nextLink	string	Odkaz na další stránku položek
value	Operation[]	Kolekce stránkovatelných položek.

UpdateId

Identifikátor aktualizace.

Name	Typ	Description
name	string	Aktualizovat název.
provider	string	Poskytovatel aktualizace.
version	string	Aktualizovat verzi.