Enables the metadata management feature for a bucket. After you enable the metadata management feature for a bucket, Object Storage Service (OSS) creates a metadata index library for the bucket and creates metadata indexes for all objects in the bucket. After the metadata index library is created, OSS continues to perform quasi-real-time scans on incremental objects in the bucket and creates metadata indexes for the incremental objects.
Usage notes
Required permissions
By default, an Alibaba Cloud account has the permission to enable the metadata management feature. If you want to enable the metadata management feature as a RAM user, make sure that the RAM user has the
oss:OpenMetaQuery
permission. For more information, see Common examples of RAM policies.Billing
During the public preview, you are not charged for metadata management. For more information about billable items of the data indexing feature, see Data indexing fees.
Time required for indexing
When you enable metadata management, OSS creates an index. The time required for creating the index is directly proportional to the number of objects stored in the bucket. That means, the larger the number of objects in the bucket, the longer the time required to create the index.
Request syntax
POST /?metaQuery&comp=add HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Request headers
This request contains only common request headers. For more information, see Common HTTP headers.
Response headers
This request contains only common response headers. For more information, see Common HTTP headers.
Examples
Sample requests
POST /?metaQuery&comp=add HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Mon, 26 Jul 2021 13:08:38 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:ceOEyZavKY4QcjoUWYSpYbJ3****
Sample responses
HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422299D
x-oss-server-time: 544
Error codes
Error code | HTTP status code | Description |
MetaQueryAlreadyExist | 400 | The metadata index library of the bucket is being created. Wait until the metadata index library is created and try again. |
AccessDenied | 403 | You do not have permissions to access the bucket. Make sure that the RAM user is granted permissions to access the bucket. |
NoSuchBucket | 404 | The destination bucket does not exist. Specify a valid bucket name. |