调用 DeleteFileMeta 接口手动删除指定 Dataset 中某个 Object 的元数据。常用于已配置 IndexOptions.IgnoreObjectDelete=True 的场景:当 Object 已从 OSS 删除但元数据仍被保留时,通过该接口主动清理。
注意事项
阿里云账号默认拥有删除文件元数据的权限。如需通过 RAM 用户删除,请确保 RAM 用户拥有
oss:MetaQuery权限。调用本接口前,Bucket 必须已通过 OpenMetaQuery 开启元数据管理。
该接口仅作用于元数据索引,不会删除 OSS 中的 Object 本身。
请求路径中的 URI 必须是格式合法的 OSS URI(
oss://{bucket}/{object-key}),其中{bucket}应与请求所在 Bucket 一致。删除是异步的。接口返回 200 仅表示请求已被接收,实际清理在数秒内完成。
对未索引或已被自动清理的 URI 调用本接口,仍返回 HTTP 200(幂等行为)。
请求语法
POST /?metaQuery&action=deleteFileMeta&datasetName=DatasetName&uri=URI HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue请求头
此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。
请求元素
名称 | 类型 | 是否必选 | 示例值 | 描述 |
datasetName | 字符串 | 是 | photos-2026 | 文件元数据所在的 Dataset 名。 |
uri | 字符串 | 是 | oss://examplebucket/photos/sunset.jpg | OSS Object 的 URI,格式为 |
响应头
此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)。
响应元素
此接口无响应元素。
示例
请求示例
POST /?metaQuery&action=deleteFileMeta&datasetName=photos-2026&uri=oss%3A%2F%2Fexamplebucket%2Fphotos%2Fsunset.jpg 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: 64C8B6F4E7C5A3A8B9D6E7F5
Date: Wed, 20 May 2026 10:00:01 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS该文章对您有帮助吗？