Updates - Get Update

服務:

Device Update

API 版本:

2020-09-01

取得特定的更新版本。

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

URI 參數

名稱	位於	必要	類型	Description
accountEndpoint	path	True	string	帳戶端點。
instanceId	path	True	string	帳戶實例標識碼。
name	path	True	string	更新名稱。
provider	path	True	string	更新提供者。
version	path	True	string	更新版本。

要求標頭

名稱	必要	類型	Description
If-None-Match		string	定義 If-None-Match 條件。 只有在伺服器上的 ETag 不符合此值時，才會執行作業。

回應

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

範圍

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

定義

名稱	Description
Compatibility	更新相容性資訊。
Update	更新元數據。
UpdateId	更新標識碼。

Compatibility

更新相容性資訊。

名稱	類型	Description
deviceManufacturer	string	更新的裝置製造商與相容。
deviceModel	string	更新與裝置的型號相容。

Update

更新元數據。

名稱	類型	Description
compatibility	Compatibility[]	更新相容性信息的清單。
createdDateTime	string	建立更新的 UTC 日期和時間。
etag	string	更新ETag。
importedDateTime	string	匯入更新的 UTC 日期和時間。
installedCriteria	string	裝置更新用戶端解譯的字串，以判斷更新是否已安裝在裝置上。
manifestVersion	string	用來匯入更新的指令清單架構版本。
updateId	UpdateId	更新身分識別。
updateType	string	更新類型。

UpdateId

更新標識碼。

名稱	類型	Description
name	string	更新名稱。
provider	string	更新提供者。
version	string	更新版本。