DeleteBucketMetadataConfiguration-对象存储(OSS)-阿里云帮助中心

调用DeleteBucketMetadataConfiguration接口删除通用型 Bucket 的元数据管理（Metadata）功能配置。该操作仅删除配置并停止采集，不删除已生成的元数据表。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的 RAM 用户或 RAM 角色默认没有任何权限，需要阿里云账号或账号管理员授予操作权限。

API	Action	说明
DeleteBucketMetadataConfiguration	`oss:DeleteBucketMetadataTableConfiguration`	删除元数据管理功能配置。

请求语法

DELETE /?metadataConfiguration HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

请求头

名称	类型	是否必选	描述
x-oss-expected-bucket-owner	字符串	否	预期的 Bucket 拥有者账号 ID。

响应

删除成功时返回 HTTP 状态码 204，响应体为空。

使用说明

删除操作是同步的，返回后配置立即消失，没有 DELETING 中间状态。
在任意状态（CREATING、ACTIVE、FAILED）下均可执行删除。
删除操作仅移除控制面配置，不清理底层的 Namespace 和表资源。删除配置后，已生成的变更日志表和动态清单表仍然保留，历史数据仍可查询，但表不再更新。
该操作非幂等：当配置不存在时返回 404。

说明

如需彻底清理元数据表，请在删除配置后，自行删除对应的变更日志表、动态清单表以及 Namespace。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

请求示例

DELETE /?metadataConfiguration HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 16 Sep 2026 12:00:00 GMT
Authorization: SignatureValue

返回示例
```
HTTP/1.1 204 No Content
```

SDK

DeleteBucketMetadataConfiguration 接口所对应的各语言 SDK 如下：

命令行工具ossutil

DeleteBucketMetadataConfiguration 接口所对应的 ossutil 命令，请参见delete-bucket-metadata-configuration。