• Object Storage Service

obs
  1. Help Center
  2. Object Storage Service
  3. User Guide
  4. FAQ
  5. How Do I Use Object Metadata?
  6. What Can I Do with Object Metadata?

What Can I Do with Object Metadata?

Metadata is the data that mainly describes objects' attributes. Object metadata is a set of name-value pairs that are part of object management.

OBS supports three types of metadata.
Table 1 Supported types of metadata

Name

Description

ContentDisposition

Provides a default file name for the object that is being requested. When an object is being downloaded or accessed, the file with the default file name is directly displayed in the browser or a download dialog box is displayed if the file is being accessed.

For example, select ContentDisposition as the metadata name and enter attachment; filename="testfile.xls" as the metadata value for an object. If you access the object through a link, a dialog box is directly displayed for downloading objects, and the object name is changed to testfile.xls. For details, see the definition about ContentDisposition in HTTP.

ContentLanguage

Indicates the language or languages intended for the audience. Therefore, a user can differentiate according to the user's preferred language. For details, see the definition about ContentLanguage in HTTP.

WebsiteRedirectLocation

Redirects an object to another object or an external URL. The redirection function is implemented using static website hosting.

For example, you can perform the following operations to implement object redirection:

  1. Set metadata of object testobject.txt in the root directory of bucket testbucket. Select WebsiteRedirectLocation for Name and enter http://www.example.com for Value.
    NOTE:

    OBS only supports redirection for objects in the root directory of a bucket.

  2. Select testbucket. Choose Static Website Hosting > Static Website Hosting to set object testobject.txt as the default homepage of static website hosting.
  3. If you access object testobject.txt using the Endpoint on the Static Website Hosting page, the access request is redirected to http://www.example.com.