Help Center/ Object Storage Service/ User Guide/ Object Management/ Object Management/ Configuring, Editing, and Viewing Object Metadata
Updated on 2025-08-26 GMT+08:00

Configuring, Editing, and Viewing Object Metadata

Scenarios

Object metadata is a set of name-value pairs that describe an object and is used for object management. OBS has two types of metadata: system-defined object metadata and user-defined object metadata. System-defined metadata includes the object's creation date, size, and storage class. User-defined metadata is the metadata that you can set for an object to identify the purpose or properties of the object.

You can configure metadata for an object when uploading it or edit the metadata after the object is uploaded.

Metadata Introduction

Constraints

  • In a versioning-enabled bucket, you can only configure metadata for the latest version of an object, but not for historical versions.
  • Metadata cannot be configured for Archive or Deep Archive objects.
  • The total size of user-defined metadata is limited to 8 KB.
  • For the permissions required to configure, edit, or view object metadata, see Object Actions.

Configuring Object Metadata

You can use OBS Console, APIs, SDKs, or obsutil to configure object metadata.

Editing Object Metadata

You can use OBS Console, APIs, SDKs, or obsutil to edit object metadata.

Viewing Object Metadata

You can use OBS Console, APIs, SDKs, or obsutil to view object metadata.