次の方法で共有

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[]

ファイル名やソース 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

Object

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

名前 型 説明
filename

string

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

string

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

ImportAction

列挙

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

値 説明
import

インポート アクション。

ImportManifestMetadata

Object

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

名前 型 説明
hashes

object

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

integer (int64)

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

string

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

ImportUpdateInput

Object

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

名前 型 説明
files

FileImportMetadata[]

ファイル名やソース URL などの 1 つ以上の更新ファイルのプロパティ。
importManifest

ImportManifestMetadata

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