Help Center> Object Storage Service> User Guide (Kuala Lumpur Region)> Service Overview> Basic Concepts> Objects
Updated on 2022-08-16 GMT+08:00
View PDF

Objects

Objects are basic units stored in OBS. An object contains both data and the metadata that describes data attributes. Data uploaded to OBS is stored in buckets as objects.

An object consists of data, metadata, and a key.
  • A key specifies the name of an object. An object key is a UTF-8 string ranging from 1 to 1024 characters. Each object is uniquely identified by a key within a bucket.
  • Metadata: Metadata describes an object, and is classified into system metadata and custom metadata. The metadata is a set of key-value pairs that are assigned to the object stored in OBS.
    • System metadata is automatically assigned by OBS for managing the object. System metadata includes Date, Content-Length, Last-Modified, ETag, and more.
    • You can specify custom metadata to describe the object when you upload the object to OBS.
  • Data: refers to the content that the object contains.

Generally, objects are managed as files. However, OBS is an object-based storage service and there is no concept of files and folders. For easy data management, OBS provides a method to simulate folders. By adding a slash (/) to an object name, for example, test/123.jpg, you can specify test as a folder and 123.jpg as the name of a file in the test folder. The key of the object is test/123.jpg.

When uploading an object, you can set a storage class for the object. If no storage class is specified, the object is stored in the same storage class as the bucket in which it resides. You can also change the storage class of an existing object in a bucket.

On OBS Console, you can use folders the same way you use them in a file system.

Object Key Naming Guidelines

Although any UTF-8 characters can be used in an object key name, naming object keys according to the following guidelines can help maximize the object keys' compatibility with other applications. Ways to analyze special characters vary depending on applications. The following guidelines help object key names substantially meet the requirements of DNS, web security characters, XML analyzers and other APIs.

The following character sets can be safely used in key names.

Alphanumeric characters (also known as unreserved characters)

0–9, a–z, and A–Z

Special characters (also known as reserved characters)

Exclamation mark (!)

Hyphen (-)

Underscore (_)

Period (.)

Asterisk (*)

Single quote (')

Left parenthesis (()

Right parenthesis ())

The following are examples of valid object key names:

4my-organization 
my.great_photos-2014/jan/myvacation.jpg 
videos/2014/birthday/video1.wmv
Parent topic: Basic Concepts