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 中心帐户终结点的设备更新(仅主机名,无协议)。 |
|
instance
|
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 |
默认响应。 |
安全性
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 |
错误详细信息。 |
|
Error |
常见的错误响应。 |
|
Inner |
包含与当前对象有关错误的更具体信息的对象。 |
Error
错误详细信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| code |
string |
服务器定义的错误代码。 |
| details |
Error[] |
导致报告错误的错误的数组。 |
| innererror |
包含与当前对象有关错误的更具体信息的对象。 |
|
| message |
string |
错误的人工可读表示形式。 |
| occurredDateTime |
string (date-time) |
发生错误的日期和时间(UTC)。 |
| target |
string |
错误的目标。 |
ErrorResponse
常见的错误响应。
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
错误详细信息。 |
InnerError
包含与当前对象有关错误的更具体信息的对象。
| 名称 | 类型 | 说明 |
|---|---|---|
| code |
string |
比包含的错误提供的错误代码更具体。 |
| errorDetail |
string |
内部错误或异常消息。 |
| innerError |
包含与当前对象有关错误的更具体信息的对象。 |
|
| message |
string |
错误的人工可读表示形式。 |