Updates - Get Operations

참조

서비스:: Device Update

API 버전:: 2020-09-01

모든 가져오기 업데이트 작업의 목록을 가져옵니다. 완료된 작업은 자동 삭제되기 전에 7일 동안 유지됩니다. 삭제 작업은 이 API 버전에서 반환되지 않습니다.

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

선택적 매개 변수:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
accountEndpoint	path	True	string	계정 엔드포인트.
instanceId	path	True	string	계정 instance 식별자입니다.
$filter	query		string	반환된 작업 집합을 제한합니다. 하나의 특정 필터만 지원됩니다. "상태 eq 'NotStarted' 또는 상태 eq 'Running'"
$top	query		integer int32	컬렉션에서 반환되는 항목 수를 제한하는 음수가 아닌 정수 n을 지정합니다. 서비스는 최대 사용 가능한 항목 수를 반환하지만 지정된 값 n보다 크지는 않습니다.

응답

Name	형식	Description
200 OK	PageableListOfOperations	작업 세부 정보입니다.
429 Too Many Requests		요청이 너무 많습니다. 기간 내에 실행할 수 있는 작업 수에 대한 속도 제한이 있습니다.

보안

azure_auth_implicit

Azure Active Directory OAuth2 암시적 흐름

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

azure_auth_code

Azure Active Directory OAuth2 AccessCode Flow

형식: oauth2
Flow: accessCode
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
토큰 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

범위

Name	Description
user_impersonation	사용자 계정 가장

azure_auth_application

Azure Active Directory OAuth2 애플리케이션 흐름

형식: oauth2
Flow: application
토큰 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

범위

Name	Description
.default	클라이언트 자격 증명 scope

azure_auth_password

Azure Active Directory OAuth2 암호 흐름

형식: oauth2
Flow: password
토큰 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Updates_GetOperations

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 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\""
    }
  ]
}

상태 코드:: 429

정의

Name	Description
Error	오류 세부 정보입니다.
InnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
Operation	작업 메타데이터.
OperationStatus	작업 상태입니다.
PageableListOfOperations	서버 페이징이 지원되는 작업 목록입니다.
UpdateId	식별자를 업데이트합니다.

Error

오류 세부 정보입니다.

Name	형식	Description
code	string	서버에서 정의한 오류 코드입니다.
details	Error[]	보고된 오류로 이어진 오류 배열입니다.
innererror	InnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.
occurredDateTime	string	오류가 발생한 날짜 및 시간(UTC)입니다.
target	string	오류의 대상입니다.

InnerError

오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.

Name	형식	Description
code	string	포함된 오류에서 제공한 것보다 더 구체적인 오류 코드입니다.
errorDetail	string	내부 오류 또는 예외 메시지입니다.
innerError	InnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.

Operation

작업 메타데이터.

Name	형식	Description
createdDateTime	string	작업을 만든 날짜 및 시간(UTC)입니다.
error	Error	작업 오류가 발생했습니다(있는 경우).
etag	string	ETag 작업.
lastActionDateTime	string	작업 상태 마지막으로 업데이트된 날짜 및 시간(UTC)입니다.
operationId	string	OperationID
resourceLocation	string	작업이 성공하면 가져온 업데이트의 위치입니다.
status	OperationStatus	작업 상태입니다.
traceId	string	Microsoft 지원 문제 해결에 사용할 수 있는 작업 상관 관계 ID입니다.
updateId	UpdateId	가져오거나 삭제할 업데이트의 ID입니다. 가져오기의 경우 이 속성은 가져오기 매니페스트가 성공적으로 처리된 후에만 채워집니다.

OperationStatus

작업 상태입니다.

Name	형식	Description
Failed	string	백그라운드 작업이 실패로 완료되었습니다.
NotStarted	string	백그라운드 작업이 만들어졌지만 아직 시작되지 않았습니다.
Running	string	백그라운드 작업이 현재 실행 중입니다.
Succeeded	string	백그라운드 작업이 성공적으로 완료되었습니다.
Undefined	string	정의되지 않은 작업 상태.

PageableListOfOperations

서버 페이징이 지원되는 작업 목록입니다.

Name	형식	Description
nextLink	string	항목의 다음 페이지에 대한 링크입니다.
value	Operation[]	페이지가 지정 가능한 항목의 컬렉션입니다.

UpdateId

식별자를 업데이트합니다.

Name	형식	Description
name	string	이름을 업데이트합니다.
provider	string	공급자를 업데이트합니다.
version	string	버전을 업데이트합니다.