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' eller 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 kö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 Password Flow

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 serverindelning.
UpdateId	Uppdatera identifierare.

Error

Objekt

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 (date-time)	Datum och tid i UTC när felet inträffade.
target	string	Målet för felet.

InnerError

Objekt

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

Objekt

Åtgärdsmetadata.

Name	Typ	Description
createdDateTime	string (date-time)	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 (date-time)	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 lyckades.
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

Uppräkning

Åtgärdsstatus.

Värde	Description
Failed	Bakgrundsåtgärden avslutades med ett fel.
NotStarted	Bakgrundsåtgärden har skapats men inte startats än.
Running	Bakgrundsåtgärden körs för närvarande.
Succeeded	Bakgrundsåtgärden slutfördes.
Undefined	Status för odefinierad åtgärd.

PageableListOfOperations

Objekt

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

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

UpdateId

Objekt

Uppdatera identifierare.

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