Updates - Get Operations

Referencia

Szolgáltatás:: Device Update

API-verzió:: 2020-09-01

Szerezze be az összes importálási frissítési művelet listáját. A befejezett műveleteket az automatikus törlés előtt 7 napig őrzi meg a rendszer. A törlési műveleteket ez az API-verzió nem adja vissza.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
accountEndpoint	path	True	string	Fiókvégpont.
instanceId	path	True	string	Fiókpéldány azonosítója.
$filter	query		string	Korlátozza a visszaadott műveletek halmazát. Csak egy adott szűrő támogatott: "status eq 'NotStarted' vagy status eq 'Running'
$top	query		integer int32	Egy nem negatív egész számot ad meg, amely korlátozza a gyűjteményből visszaadott elemek számát. A szolgáltatás az elérhető elemek számát adja vissza legfeljebb, de nem nagyobb, mint a megadott n érték.

Válaszok

Name	Típus	Description
200 OK	PageableListOfOperations	Művelet részletei.
429 Too Many Requests		Túl sok kérés; van egy sebességkorlát arra vonatkozóan, hogy hány művelet hajtható végre egy adott időszakon belül.

Biztonság

azure_auth_implicit

Azure Active Directory OAuth2 implicit folyamat

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Hatókörök

Name	Description
user_impersonation	felhasználói fiók megszemélyesítése

azure_auth_code

Azure Active Directory OAuth2 AccessCode Flow

Típus: oauth2
Folyamat: accessCode
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Jogkivonat URL-címe: https://login.microsoftonline.com/common/oauth2/v2.0/token

Hatókörök

Name	Description
user_impersonation	felhasználói fiók megszemélyesítése

azure_auth_application

Azure Active Directory OAuth2 alkalmazásfolyamat

Típus: oauth2
Folyamat: application
Jogkivonat URL-címe: https://login.microsoftonline.com/common/oauth2/v2.0/token

Hatókörök

Name	Description
.default	ügyfél hitelesítő adatainak hatóköre

azure_auth_password

Azure Active Directory OAuth2 Password Flow

Típus: oauth2
Folyamat: password
Jogkivonat URL-címe: https://login.microsoftonline.com/common/oauth2/v2.0/token

Hatókörök

Name	Description
user_impersonation	felhasználói fiók megszemélyesítése

Példák

Updates_GetOperations

Mintakérelem

HTTP

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

Mintaválasz

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

Állapotkód:: 429

Definíciók

Name	Description
Error	Hiba részletei.
InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információkat tartalmaz a hibáról.
Operation	Művelet metaadatai.
OperationStatus	Művelet állapota.
PageableListOfOperations	A kiszolgálóoldali támogatással rendelkező műveletek listája.
UpdateId	Azonosító frissítése.

Error

Hiba részletei.

Name	Típus	Description
code	string	Kiszolgáló által definiált hibakód.
details	Error[]	Hibatömb, amely a jelentett hibához vezetett.
innererror	InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információkat tartalmaz a hibáról.
message	string	A hiba emberi olvasásra alkalmas ábrázolása.
occurredDateTime	string	A hiba bekövetkezésének dátuma és időpontja (UTC).
target	string	A hiba célja.

InnerError

Egy objektum, amely az aktuális objektumnál pontosabb információkat tartalmaz a hibáról.

Name	Típus	Description
code	string	Pontosabb hibakód, mint amit a hiba tartalmazott.
errorDetail	string	A belső hiba vagy kivétel üzenete.
innerError	InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információkat tartalmaz a hibáról.
message	string	A hiba emberi olvasásra alkalmas ábrázolása.

Operation

Művelet metaadatai.

Name	Típus	Description
createdDateTime	string	A művelet létrehozásának dátuma és időpontja (UTC).
error	Error	Műveleti hiba történt, ha van ilyen.
etag	string	ETag művelet.
lastActionDateTime	string	A művelet állapotának utolsó frissítésének dátuma és időpontja (UTC).
operationId	string	Műveletazonosító.
resourceLocation	string	Az importált frissítés helye, amikor a művelet sikeres.
status	OperationStatus	Művelet állapota.
traceId	string	Művelet korrelációs identitása, amelyet a Microsoft ügyfélszolgálata a hibaelhárításhoz használhat.
updateId	UpdateId	Az importált vagy törölt frissítés identitása. Importálás esetén ez a tulajdonság csak az importálási jegyzék sikeres feldolgozása után lesz feltöltve.

OperationStatus

Művelet állapota.

Name	Típus	Description
Failed	string	A háttérművelet sikertelen volt.
NotStarted	string	A háttérművelet létrejött, de még nem indult el.
Running	string	A háttérművelet jelenleg fut.
Succeeded	string	A háttérművelet sikeresen befejeződött.
Undefined	string	Nem definiált műveletállapot.

PageableListOfOperations

A kiszolgálóoldali támogatással rendelkező műveletek listája.

Name	Típus	Description
nextLink	string	Az elemek következő oldalára mutató hivatkozás.
value	Operation[]	A lapozható elemek gyűjteménye.

UpdateId

Azonosító frissítése.

Name	Típus	Description
name	string	Név frissítése.
provider	string	Frissítse a szolgáltatót.
version	string	Verzió frissítése.