共用方式為

Updates - Import Update

  • 參考
服務:
Device Update
API 版本:
2020-09-01

匯入新的更新版本。

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

URI 參數

名稱 位於 必要 類型 Description
accountEndpoint
 path True

string

帳戶端點。
instanceId
 path True

string

帳戶實例標識碼。
action
 query True

ImportAction

匯入更新動作。

要求本文

名稱 必要 類型 Description
files True

FileImportMetadata[]

一或多個更新檔案屬性，例如檔名和來源 URL。
importManifest True

ImportManifestMetadata

匯入指令清單元數據，例如來源 URL、檔案大小/哈希等等。

回應

名稱 類型 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

範圍

名稱 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

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

azure_auth_application

Azure Active Directory OAuth2 應用程式流程

類型: oauth2
Flow: application
權杖 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

範圍

名稱 Description
.default 用戶端認證範圍

azure_auth_password

Azure Active Directory OAuth2 密碼流程

類型: oauth2
Flow: password
權杖 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

範圍

名稱 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

定義

名稱 Description
FileImportMetadata

描述更新檔案的元數據。
ImportAction

匯入更新動作。
ImportManifestMetadata

描述匯入指令清單的元數據，此檔描述有關更新版本的檔案和其他元數據。
ImportUpdateInput

匯入更新輸入元數據。

FileImportMetadata

描述更新檔案的元數據。

名稱 類型 Description
filename

string

更新匯入指令清單內指定的檔名。
url

string

裝置更新可從中下載更新檔案的 Azure Blob 位置，以進行 IoT 中樞。 這通常是只讀 SAS 保護的 Blob URL，到期時間設定為至少 4 小時。

ImportAction

匯入更新動作。

名稱 類型 Description
import

string

匯入動作。

ImportManifestMetadata

描述匯入指令清單的元數據，此檔描述有關更新版本的檔案和其他元數據。

名稱 類型 Description
hashes

object

JSON 物件，包含檔案的哈希 (es) 。 至少需要SHA256哈希。 這個物件可以視為一組索引鍵/值組，其中索引鍵是哈希演算法，而值則是使用該演算法計算的檔案哈希。
sizeInBytes

integer

檔案大小 (以位元組數為單位)。
url

string

裝置更新可從中下載匯入指令清單的 Azure Blob 位置，以進行 IoT 中樞。 這通常是只讀 SAS 保護的 Blob URL，到期時間設定為至少 4 小時。

ImportUpdateInput

匯入更新輸入元數據。

名稱 類型 Description
files

FileImportMetadata[]

一或多個更新檔案屬性，例如檔名和來源 URL。
importManifest

ImportManifestMetadata

匯入指令清單元數據，例如來源 URL、檔案大小/哈希等等。