Updates - Get File

  • リファレンス
サービス:
Device Update
API バージョン:
2020-09-01

バージョンから特定の更新ファイルを取得します。

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

URI パラメーター

名前 / 必須 型 説明
accountEndpoint
 path True

string

アカウント エンドポイント。
fileId
 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

File

要求されたファイル エンティティ。
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_GetFile

要求のサンプル

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0/files/abc123

応答のサンプル

状態コード:
200 
{
  "fileId": "abc123",
  "fileName": "1v5uww1q.my2",
  "sizeInBytes": 1862311,
  "hashes": {
    "sha256": "OVokcktf61lQXs17MzJCsM98lk48H1Wu1hy7Sp6lLfI="
  },
  "mimeType": "application/BuildAsync-s4jwikgq.44h",
  "etag": "\"26bd8eba-4bb2-4960-a357-ca4d60b5fb4b\""
}
状態コード:
304
状態コード:
404
状態コード:
429

定義

File

ファイル メタデータを更新します。

名前 型 説明
etag

string

ファイル ETag。
fileId

string

インポート時にサーバーによって生成されるファイル ID。
fileName

string

ファイル名。
hashes

object

base64 でエンコードされたハッシュ値へのハッシュ アルゴリズムのマッピング。
mimeType

string

ファイル MIME の種類。
sizeInBytes

integer

ファイルサイズ (バイト数)。