Bucket:
A logical container for storing objects. Every object must reside in a bucket. Buckets serve as the top-level namespace in OSS.
Object:
The fundamental unit of data in OSS, consisting of:
Key – the unique identifier or full path name.
Data – the raw file content.
Metadata – a set of key-value pairs describing attributes such as file type, encoding, or custom tags.
Object Key:
Also referred to as ObjectKey, Key, or ObjectName in SDKs. It represents the full logical path of the object within a bucket (e.g., abc/efg/123.jpg).
Endpoint:
The public domain used to access OSS resources. It follows the format: https://tenant.oss.swiftserve.com
where <tenant> uniquely identifies the OSS instance.
Access Key:
Composed of an Access Key ID and an Access Key Secret. These credentials are required for request signing and API authentication. The secret key must be stored securely and never exposed.
Atomicity and Consistency:
OSS guarantees atomic object operations — each upload or delete either fully succeeds or fails. Strong consistency ensures that once an upload is completed, the object is immediately available for read. Likewise, deleted objects are immediately inaccessible, eliminating eventual consistency delays.