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

要求のサンプル

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

バージョンを更新します。