DeleteDataset

注意事项

• 阿里云账号默认拥有删除 Dataset 的权限。如需通过 RAM 用户删除,请确保 RAM 用户拥有 oss:MetaQuery 权限。

• 删除操作不可恢复。Dataset 删除后,后续 GetDataset 会返回 DatasetNotExist。

• 不能删除非空 Dataset。当 Dataset 内仍存在已索引的文件元数据时,接口返回 StatusConflict(HTTP 409)。请先通过 DeleteFileMeta 清空 Dataset 内的文件元数据后再删除。

• 关闭整个 Bucket 的元数据管理可直接调用 CloseMetaQuery,无需逐个 Dataset 调用本接口。

• 请求体为空,响应体也为空。

请求语法

POST /?metaQuery&action=deleteDataset&datasetName=DatasetName HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。

请求元素

响应头

此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)。

响应元素

此接口无响应元素。

示例

请求示例

POST /?metaQuery&action=deleteDataset&datasetName=photos-2026 HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 May 2026 10:00:00 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260520/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 64C8B6F4E7C5A3A8B9D6E7F4
Date: Wed, 20 May 2026 10:00:01 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS