Updates - Get Update

サービス:

Device Update

API バージョン:

2020-09-01

特定の更新プログラムのバージョンを取得します。

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

URI パラメーター

名前	/	必須	型	説明
accountEndpoint	path	True	string	アカウント エンドポイント。
instanceId	path	True	string	アカウント インスタンス識別子。
name	path	True	string	更新名。
provider	path	True	string	プロバイダーを更新します。
version	path	True	string	バージョンを更新します。

要求ヘッダー

名前	必須	型	説明
If-None-Match		string	If-None-Match 条件を定義します。 この操作は、サーバー上の ETag がこの値と一致しない場合にのみ実行されます。

応答

名前	型	説明
200 OK	Update	要求された更新プログラムのバージョン。
404 Not Found		見つかりません。
429 Too Many Requests		要求が多すぎます。期間内に実行できる操作の数にはレート制限があります。
Other Status Codes		変更されません。

セキュリティ

azure_auth_implicit

Azure Active Directory OAuth2 暗黙的フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/v2.0/authorize

スコープ

名前	説明
user_impersonation	ユーザー アカウントの借用

azure_auth_code

Azure Active Directory OAuth2 AccessCode フロー

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token URL (トークン URL): https://login.microsoftonline.com/common/oauth2/v2.0/token

スコープ

名前	説明
user_impersonation	ユーザー アカウントの借用

azure_auth_application

Azure Active Directory OAuth2 アプリケーション フロー

型: oauth2
フロー: application
Token URL (トークン URL): https://login.microsoftonline.com/common/oauth2/v2.0/token

スコープ

名前	説明
.default	クライアント資格情報スコープ

azure_auth_password

Azure Active Directory OAuth2 パスワード フロー

型: oauth2
フロー: password
Token URL (トークン URL): https://login.microsoftonline.com/common/oauth2/v2.0/token

スコープ

名前	説明
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

定義

名前	説明
Compatibility	互換性情報を更新します。
Update	メタデータを更新します。
UpdateId	識別子を更新します。

Compatibility

互換性情報を更新します。

名前	型	説明
deviceManufacturer	string	更新プログラムと互換性のあるデバイスの製造元。
deviceModel	string	更新プログラムと互換性のあるデバイスのモデル。

Update

メタデータを更新します。

名前	型	説明
compatibility	Compatibility[]	更新プログラムの互換性情報の一覧。
createdDateTime	string	更新が作成された UTC の日付と時刻。
etag	string	ETag を更新します。
importedDateTime	string	更新プログラムがインポートされた UTC の日付と時刻。
installedCriteria	string	更新プログラムがデバイスにインストールされているかどうかを判断するために、Device Update クライアントによって解釈される文字列。
manifestVersion	string	更新プログラムのインポートに使用されるマニフェストのスキーマ バージョン。
updateId	UpdateId	更新プログラム ID。
updateType	string	更新の種類。

UpdateId

識別子を更新します。

名前	型	説明
name	string	更新名。
provider	string	プロバイダーを更新します。
version	string	バージョンを更新します。