Device Update - Delete Update
特定の更新バージョンを削除します。 これは実行時間の長い操作です。応答ヘッダー値 Operation-Location 使用して、操作の状態をチェックします。
DELETE https://{endpoint}/deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions/{version}?api-version=2022-10-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
endpoint
|
path | True |
string url |
IoT Hub アカウント エンドポイントの Device Update (ホスト名のみ、プロトコルなし)。 |
instance
|
path | True |
string |
IoT Hub アカウント インスタンス識別子の Device Update。 |
name
|
path | True |
string |
更新名。 |
provider
|
path | True |
string |
プロバイダーを更新します。 |
version
|
path | True |
string |
バージョンを更新します。 |
api-version
|
query | True |
string |
クライアント要求で使用される API のバージョン。 |
応答
名前 | 型 | 説明 |
---|---|---|
202 Accepted |
更新プログラムの削除要求を受け入れた。状態を追跡するバックグラウンド操作の場所は、応答ヘッダーで指定 Operation-Location。 ヘッダー Operation-Location: string |
|
Other Status Codes |
既定の応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
https://api.adu.microsoft.com/.default | 既定の承認スコープ。 |
例
DeviceUpdate_DeleteUpdate
要求のサンプル
DELETE https://contoso.api.adu.microsoft.com/deviceUpdate/blue/updates/providers/microsoft/names/adu/versions/1.0.0.0?api-version=2022-10-01
応答のサンプル
Operation-Location: /deviceUpdate/blue/operations/e4491c54-916f-443d-9094-bcca546ace2f?api-version=2022-10-01
定義
名前 | 説明 |
---|---|
Error |
エラーの詳細。 |
Error |
一般的なエラー応答。 |
Inner |
エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。 |
Error
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
code |
string |
サーバー定義のエラー コード。 |
details |
Error[] |
報告されたエラーの原因となったエラーの配列。 |
innererror |
エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。 |
|
message |
string |
エラーの人間が判読できる表現。 |
occurredDateTime |
string |
エラーが発生した UTC の日付と時刻。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
一般的なエラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
エラーの詳細です。 |
InnerError
エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。
名前 | 型 | 説明 |
---|---|---|
code |
string |
含まれているエラーによって提供されたものよりも具体的なエラー コード。 |
errorDetail |
string |
内部エラーまたは例外メッセージ。 |
innerError |
エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。 |
|
message |
string |
エラーの人間が判読できる表現。 |