Updates - Get Update

서비스:

Device Update

API 버전:

2020-09-01

특정 업데이트 버전을 가져옵니다.

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/providers/{provider}/names/{name}/versions/{version}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
accountEndpoint	path	True	string	계정 엔드포인트.
instanceId	path	True	string	계정 instance 식별자입니다.
name	path	True	string	이름을 업데이트합니다.
provider	path	True	string	공급자를 업데이트합니다.
version	path	True	string	버전을 업데이트합니다.

요청 헤더

Name	필수	형식	Description
If-None-Match		string	If-None-Match 조건을 정의합니다. 서버의 ETag가 이 값과 일치하지 않는 경우에만 작업이 수행됩니다.

응답

Name	형식	Description
200 OK	Update	요청된 업데이트 버전입니다.
404 Not Found		찾을 수 없음
429 Too Many Requests		요청이 너무 많습니다. 기간 내에 실행할 수 있는 작업의 수에 대한 속도 제한이 있습니다.
Other Status Codes		수정되지 않습니다.

보안

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_GetUpdate

샘플 요청

HTTP

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0

샘플 응답

상태 코드:

200

{
  "updateId": {
    "provider": "microsoft",
    "name": "adu",
    "version": "1.0.0.0"
  },
  "updateType": "image",
  "installedCriteria": "SwVer=5",
  "compatibility": [
    {
      "deviceManufacturer": "Microsoft",
      "deviceModel": "Toaster"
    }
  ],
  "manifestVersion": "0.1",
  "importedDateTime": "2020-04-22T21:01:43.8408797+00:00",
  "createdDateTime": "2019-09-12T00:00:00.0000000+00:00",
  "etag": "\"3fed3378-0c67-47d2-b796-296962c66cbb\""
}

상태 코드:

304

상태 코드:

404

상태 코드:

429

정의

Name	Description
Compatibility	호환성 정보를 업데이트합니다.
Update	메타데이터를 업데이트합니다.
UpdateId	식별자를 업데이트합니다.

Compatibility

호환성 정보를 업데이트합니다.

Name	형식	Description
deviceManufacturer	string	업데이트가 호환되는 디바이스 제조업체입니다.
deviceModel	string	업데이트가 호환되는 디바이스의 모델입니다.

Update

메타데이터를 업데이트합니다.

Name	형식	Description
compatibility	Compatibility[]	업데이트 호환성 정보 목록입니다.
createdDateTime	string	업데이트가 만들어진 날짜 및 시간(UTC)입니다.
etag	string	ETag를 업데이트합니다.
importedDateTime	string	업데이트를 가져온 날짜 및 시간(UTC)입니다.
installedCriteria	string	디바이스 업데이트 클라이언트에서 업데이트가 디바이스에 설치되어 있는지 확인하기 위해 해석되는 문자열입니다.
manifestVersion	string	업데이트를 가져오는 데 사용되는 매니페스트의 스키마 버전입니다.
updateId	UpdateId	ID를 업데이트합니다.
updateType	string	업데이트 유형입니다.

UpdateId

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

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