次の方法で共有

Updates - Import Update

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

新しい更新プログラムのバージョンをインポートします。

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

URI パラメーター

名前 / 必須 型 説明
accountEndpoint
 path True

string

アカウント エンドポイント。
instanceId
 path True

string

アカウント インスタンス識別子。
action
 query True

ImportAction

更新アクションをインポートします。

要求本文

名前 必須 型 説明
files True

FileImportMetadata[]

filename や source URL などの 1 つ以上の更新ファイル プロパティ。
importManifest True

ImportManifestMetadata

ソース URL、ファイル サイズ/ハッシュなどのマニフェスト メタデータをインポートします。

応答

名前 型 説明
202 Accepted

受け入れられた更新プログラムのインポート要求。状態を追跡するバックグラウンド操作の場所は、応答ヘッダーで指定 Operation-Location。

ヘッダー

  • Location: string
  • Operation-Location: string
429 Too Many Requests

要求が多すぎます。期間内に実行できる操作の数にはレート制限があり、同時に実行できるインポートと削除のバックグラウンド操作の数にも制限があります。

セキュリティ

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

定義

名前 説明
FileImportMetadata

更新ファイルを記述するメタデータ。
ImportAction

更新アクションをインポートします。
ImportManifestMetadata

インポート マニフェストを記述するメタデータ。更新バージョンに関するファイルとその他のメタデータを記述するドキュメント。
ImportUpdateInput

更新プログラムの入力メタデータをインポートします。

FileImportMetadata

更新ファイルを記述するメタデータ。

名前 型 説明
filename

string

インポート マニフェスト内で指定されたファイル名を更新します。
url

string

Device Update for IoT Hubによって更新ファイルをダウンロードできる Azure BLOB の場所。 これは通常、有効期限が少なくとも 4 時間に設定された読み取り専用の SAS で保護された BLOB URL です。

ImportAction

更新アクションをインポートします。

名前 型 説明
import

string

インポート アクション。

ImportManifestMetadata

インポート マニフェストを記述するメタデータ。更新バージョンに関するファイルとその他のメタデータを記述するドキュメント。

名前 型 説明
hashes

object

ファイルのハッシュを含む JSON オブジェクト。 少なくとも SHA256 ハッシュが必要です。 このオブジェクトは、キーがハッシュ アルゴリズムであり、値がそのアルゴリズムを使用して計算されたファイルのハッシュであるキーと値のペアのセットと考えることができます。
sizeInBytes

integer

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

string

Device Update for IoT Hubによってインポート マニフェストをダウンロードできる Azure BLOB の場所。 これは通常、有効期限が少なくとも 4 時間に設定された読み取り専用の SAS で保護された BLOB URL です。

ImportUpdateInput

更新プログラムの入力メタデータをインポートします。

名前 型 説明
files

FileImportMetadata[]

filename や source URL などの 1 つ以上の更新ファイル プロパティ。
importManifest

ImportManifestMetadata

ソース URL、ファイル サイズ/ハッシュなどのマニフェスト メタデータをインポートします。