다음을 통해 공유

Updates - Import Update

  • 참조
서비스:
Device Update
API 버전:
2020-09-01

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

POST https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates?action=import

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
accountEndpoint
 path True

string

계정 엔드포인트.
instanceId
 path True

string

계정 instance 식별자입니다.
action
 query True

ImportAction

업데이트 가져오기 작업.

요청 본문

Name 필수 형식 Description
files True

FileImportMetadata[]

파일 이름 및 원본 URL과 같은 하나 이상의 업데이트 파일 속성입니다.
importManifest True

ImportManifestMetadata

원본 URL, 파일 크기/해시 등과 같은 매니페스트 메타데이터를 가져옵니다.

응답

Name 형식 Description
202 Accepted

수락된 업데이트 가져오기 요청; 상태 추적하는 백그라운드 작업 위치는 Operation-Location 응답 헤더에 지정됩니다.

헤더

  • Location: string
  • Operation-Location: string
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_ImportUpdate

샘플 요청

POST https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates?action=import

{
  "importManifest": {
    "url": "http://test.blob.core.windows.net/test/uploadimportMan.json",
    "sizeInBytes": 816,
    "hashes": {
      "sha256": "O19LyyncPe1AGstOdkcmozLV8pSbBdqrE18HdYVohRc="
    }
  },
  "files": [
    {
      "filename": "file1.bin",
      "url": "http://test.blob.core.windows.net/test/upload1v5uww1q"
    },
    {
      "filename": "file2.bin",
      "url": "http://test.blob.core.windows.net/test/uploadkrmn5yw0"
    },
    {
      "filename": "file3.bin",
      "url": "http://test.blob.core.windows.net/test/uploaddq52ky5m"
    }
  ]
}

샘플 응답

상태 코드:
202 
Location: /deviceupdate/instanceId/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f
Operation-Location: /deviceupdate/instanceId/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f
상태 코드:
429

정의

Name Description
FileImportMetadata

업데이트 파일을 설명하는 메타데이터입니다.
ImportAction

업데이트 가져오기 작업.
ImportManifestMetadata

가져오기 매니페스트를 설명하는 메타데이터, 업데이트 버전에 대한 파일 및 기타 메타데이터를 설명하는 문서입니다.
ImportUpdateInput

업데이트 입력 메타데이터를 가져옵니다.

FileImportMetadata

업데이트 파일을 설명하는 메타데이터입니다.

Name 형식 Description
filename

string

가져오기 매니페스트 내에 지정된 대로 파일 이름을 업데이트합니다.
url

string

IoT Hub 디바이스 업데이트에서 업데이트 파일을 다운로드할 수 있는 Azure Blob 위치입니다. 일반적으로 만료가 4시간 이상으로 설정된 읽기 전용 SAS로 보호되는 Blob URL입니다.

ImportAction

업데이트 가져오기 작업.

Name 형식 Description
import

string

가져오기 작업.

ImportManifestMetadata

가져오기 매니페스트를 설명하는 메타데이터, 업데이트 버전에 대한 파일 및 기타 메타데이터를 설명하는 문서입니다.

Name 형식 Description
hashes

object

파일의 해시를 포함하는 JSON 개체입니다. SHA256 해시 이상이 필요합니다. 이 개체는 키가 해시 알고리즘이고 값이 해당 알고리즘을 사용하여 계산된 파일의 해시인 키-값 쌍 집합으로 생각할 수 있습니다.
sizeInBytes

integer

파일 크기(바이트 수)입니다.
url

string

IoT Hub 디바이스 업데이트에서 가져오기 매니페스트를 다운로드할 수 있는 Azure Blob 위치입니다. 일반적으로 만료가 4시간 이상으로 설정된 읽기 전용 SAS로 보호되는 Blob URL입니다.

ImportUpdateInput

업데이트 입력 메타데이터를 가져옵니다.

Name 형식 Description
files

FileImportMetadata[]

파일 이름 및 원본 URL과 같은 하나 이상의 업데이트 파일 속성입니다.
importManifest

ImportManifestMetadata

원본 URL, 파일 크기/해시 등과 같은 매니페스트 메타데이터를 가져옵니다.