DeleteBucketMetadataConfiguration

Updated at:

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

oss:DeleteBucketMetadataTableConfiguration

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.

Note

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.