Updates - Get Operations

Referens

Tjänst:: Device Update

API-version:: 2020-09-01

Hämta en lista över alla importuppdateringsåtgärder. Slutförda åtgärder behålls i 7 dagar innan de tas bort automatiskt. Borttagningsåtgärder returneras inte av den här API-versionen.

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

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountEndpoint	path	True	string	Kontoslutpunkt.
instanceId	path	True	string	Kontoinstansidentifierare.
$filter	query		string	Begränsar den uppsättning åtgärder som returneras. Endast ett specifikt filter stöds: "status eq 'NotStarted' or status eq 'Running'"
$top	query		integer int32	Anger ett icke-negativt heltal n som begränsar antalet objekt som returneras från en samling. Tjänsten returnerar antalet tillgängliga objekt upp till men inte större än det angivna värdet n.

Svar

Name	Typ	Description
200 OK	PageableListOfOperations	Åtgärdsinformation.
429 Too Many Requests		För många begäranden; det finns en hastighetsgräns för hur många åtgärder som kan utföras inom en tidsperiod.

Säkerhet

azure_auth_implicit

Implicit flöde i Azure Active Directory OAuth2

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

azure_auth_code

Azure Active Directory OAuth2 AccessCode Flow

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token-webbadress: https://login.microsoftonline.com/common/oauth2/v2.0/token

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

azure_auth_application

Azure Active Directory OAuth2-programflöde

Typ: oauth2
Flow: application
Token-webbadress: https://login.microsoftonline.com/common/oauth2/v2.0/token

Omfattningar

Name	Description
.default	omfång för klientautentiseringsuppgifter

azure_auth_password

Azure Active Directory OAuth2-lösenordsflöde

Typ: oauth2
Flow: password
Token-webbadress: https://login.microsoftonline.com/common/oauth2/v2.0/token

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Updates_GetOperations

Exempelbegäran

HTTP

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

Exempelsvar

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

Statuskod:: 429

Definitioner

Name	Description
Error	Felinformation.
InnerError	Ett objekt som innehåller mer specifik information än det aktuella objektet om felet.
Operation	Åtgärdsmetadata.
OperationStatus	Åtgärdsstatus.
PageableListOfOperations	Listan över åtgärder med stöd för serverväxling.
UpdateId	Uppdateringsidentifierare.

Error

Felinformation.

Name	Typ	Description
code	string	Serverdefinierad felkod.
details	Error[]	En matris med fel som ledde till det rapporterade felet.
innererror	InnerError	Ett objekt som innehåller mer specifik information än det aktuella objektet om felet.
message	string	En mänsklig läsbar representation av felet.
occurredDateTime	string	Datum och tid i UTC när felet inträffade.
target	string	Målet för felet.

InnerError

Ett objekt som innehåller mer specifik information än det aktuella objektet om felet.

Name	Typ	Description
code	string	En mer specifik felkod än vad som angavs av det innehållande felet.
errorDetail	string	Det interna felet eller undantagsmeddelandet.
innerError	InnerError	Ett objekt som innehåller mer specifik information än det aktuella objektet om felet.
message	string	En mänsklig läsbar representation av felet.

Operation

Åtgärdsmetadata.

Name	Typ	Description
createdDateTime	string	Datum och tid i UTC när åtgärden skapades.
error	Error	Åtgärdsfel påträffades, om det finns några.
etag	string	Åtgärd ETag.
lastActionDateTime	string	Datum och tid i UTC när åtgärdsstatusen senast uppdaterades.
operationId	string	Åtgärds-ID.
resourceLocation	string	Platsen för den importerade uppdateringen när åtgärden lyckas.
status	OperationStatus	Åtgärdsstatus.
traceId	string	Åtgärdskorrelationsidentitet som kan användas av Microsoft Support för felsökning.
updateId	UpdateId	Identiteten för uppdateringen som importeras eller tas bort. För import fylls den här egenskapen bara i när importmanifestet har bearbetats.

OperationStatus

Åtgärdsstatus.

Name	Typ	Description
Failed	string	Bakgrundsåtgärden avslutades med fel.
NotStarted	string	Bakgrundsåtgärden har skapats men har inte startats än.
Running	string	Bakgrundsåtgärden körs för närvarande.
Succeeded	string	Bakgrundsåtgärden slutfördes.
Undefined	string	Odefinierad åtgärdsstatus.

PageableListOfOperations

Listan över åtgärder med stöd för serverväxling.

Name	Typ	Description
nextLink	string	Länken till nästa sida med objekt.
value	Operation[]	Samlingen med växlingsbara objekt.

UpdateId

Uppdateringsidentifierare.

Name	Typ	Description
name	string	Uppdateringsnamn.
provider	string	Uppdatera provider.
version	string	Uppdatera version.