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

Datasets - Delete

取消注册数据集。

返回的状态代码:

  • 204:操作已成功完成。
  • 400:请求格式不正确。
  • 404:找不到具有指定名称的数据集。
  • 412:提供了 If-Match 标头,但给定的 ETag 与当前 ETag 值不匹配。
DELETE /datasets/{name}?api-version=2023-04-01-preview

URI 参数

名称 必需 类型 说明
name
path True

string

要注销的数据集的名称。

正则表达式模式: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$

api-version
query True

string

请求的 API 版本。

请求头

名称 必需 类型 说明
If-Match

string

要注销的数据集的可选 ETag。
如果提供了 ETag,则仅当数据集的当前 ETag 值与给定的 ETag 匹配时,才会取消注册数据集。 如果 ETag 值不匹配,则注销操作将失败,状态代码为 412 (前置条件失败) 。 这表示自上次获取数据集信息以来,数据集已更新。
如果未提供 ETag 或其值为“*”,则无论当前 ETag 值如何,数据集都将始终取消注册。

响应

名称 类型 说明
204 No Content

无内容

Other Status Codes

ErrorResponse

错误

标头

x-ms-error-code: string

示例

Datasets_Unregister

示例请求

DELETE /datasets/my_dataset_name?api-version=2023-04-01-preview

示例响应

定义

名称 说明
ErrorResponse

发生错误时返回的响应。

ErrorResponseDetails

错误信息。

ErrorResponseInnerError

详细错误。

ErrorResponse

发生错误时返回的响应。

名称 类型 说明
error

ErrorResponseDetails

错误信息。

ErrorResponseDetails

错误信息。

名称 类型 说明
code

string

错误代码。

details

ErrorResponseDetails[]

详细错误列表。

innererror

ErrorResponseInnerError

详细错误。

message

string

错误消息。

target

string

错误的目标。

ErrorResponseInnerError

详细错误。

名称 类型 说明
code

string

错误代码。

innererror

ErrorResponseInnerError

详细错误。

message

string

错误消息。