Updates - Get Operation

Referens

Tjänst:: Device Update

API-version:: 2020-09-01

Hämta åtgärdsstatus.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountEndpoint	path	True	string	Kontoslutpunkt.
instanceId	path	True	string	Kontoinstansidentifierare.
operationId	path	True	string	Åtgärdsidentifierare.

Begärandehuvud

Name	Obligatorisk	Typ	Description
If-None-Match		string	Definierar villkoret If-None-Match. Åtgärden utförs endast om ETag på servern inte matchar det här värdet.

Svar

Name	Typ	Description
200 OK	Operation	Åtgärdsstatus. Sidhuvuden Retry-After: string
404 Not Found		Hittades inte.
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.
Other Status Codes		Har inte ändrats.

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_GetOperation

Exempelbegäran

HTTP

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

Exempelsvar

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

Statuskod:: 304

Statuskod:: 404

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.
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.

UpdateId

Uppdateringsidentifierare.

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