DeleteBucketMetadataConfiguration
Call DeleteBucketMetadataConfiguration to delete the metadata management configuration of a general-purpose bucket. This operation deletes only the configuration and stops data collection; it does not delete the metadata tables that have already been generated.
Permissions
By default, an Alibaba Cloud account has full permissions. A RAM user or RAM role under an Alibaba Cloud account has no permissions by default; the account or an account administrator must grant the required permissions.
|
API |
Action |
Description |
|
DeleteBucketMetadataConfiguration |
|
Deletes the metadata management configuration. |
Request syntax
DELETE /?metadataConfiguration HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
Request headers
|
Name |
Type |
Required |
Description |
|
x-oss-expected-bucket-owner |
String |
No |
The expected account ID of the bucket owner. |
Response
If the deletion succeeds, HTTP status code 204 is returned with an empty response body.
Usage notes
-
The deletion is synchronous. The configuration is removed as soon as the operation returns; there is no intermediate DELETING state.
-
The deletion can be performed in any state (CREATING, ACTIVE, or FAILED).
-
The deletion removes only the control-plane configuration; it does not clean up the underlying namespace or table resources. After the configuration is deleted, the generated journal table and live inventory table are retained and historical data remains queryable, but the tables are no longer updated.
-
This operation is not idempotent: it returns 404 if the configuration does not exist.
To fully clean up the metadata tables, delete the corresponding journal table, live inventory table, and namespace yourself after you delete the configuration.
Response headers
This operation uses only common response headers. For more information, see Common response headers.
Examples
-
Sample request
DELETE /?metadataConfiguration HTTP/1.1 Host: examplebucket.oss-cn-hangzhou.aliyuncs.com Date: Wed, 16 Sep 2026 12:00:00 GMT Authorization: SignatureValue -
Sample response
HTTP/1.1 204 No Content
SDK
The SDKs for DeleteBucketMetadataConfiguration in each language are as follows:
ossutil command-line interface
For the ossutil command that corresponds to DeleteBucketMetadataConfiguration, see delete-bucket-metadata-configuration.