你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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 中心帐户终结点的设备更新(仅主机名,无协议)。

instanceId
path True

string

IoT 中心帐户实例标识符的设备更新。

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

ErrorResponse

默认响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 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

错误详细信息。

ErrorResponse

常见的错误响应。

InnerError

包含与当前对象有关错误的更具体信息的对象。

Error

错误详细信息。

名称 类型 说明
code

string

服务器定义的错误代码。

details

Error[]

导致报告错误的错误的数组。

innererror

InnerError

包含与当前对象有关错误的更具体信息的对象。

message

string

错误的人工可读表示形式。

occurredDateTime

string (date-time)

发生错误的日期和时间(UTC)。

target

string

错误的目标。

ErrorResponse

常见的错误响应。

名称 类型 说明
error

Error

错误详细信息。

InnerError

包含与当前对象有关错误的更具体信息的对象。

名称 类型 说明
code

string

比包含的错误提供的错误代码更具体。

errorDetail

string

内部错误或异常消息。

innerError

InnerError

包含与当前对象有关错误的更具体信息的对象。

message

string

错误的人工可读表示形式。