None

Getting Started with OBS

Object Storage Service (OBS) provides secure, reliable, and cost-effective cloud storage for massive amounts of data. It can be used for big data analytics, static website hosting, video on demand (VOD), and many other scenarios.

Start your OBS journey in just three steps.

Create a HUAWEI ID and Enable Huawei Cloud Services

Before using OBS, you need to create an account and complete real-name authentication on the Huawei Cloud official website.

Top Up Your Account or Buy Resource Packages

OBS offers pay-per-use and yearly/monthly billing. To make sure you can use OBS normally, you need to top up your account or buy OBS resource packages first.

Top Up Buy OBS Resource Packages

Obtain Access Keys (AK/SK) and Endpoints

To use SDKs, APIs, obsutil, or OBS Browser+ to access OBS, obtain the corresponding AK/SK and endpoint first. (Access with OBS Browser+ requires only an AK/SK pair.)

Get AK/SK Get Endpoint

Buckets are containers for storing data in OBS. You can create a bucket in any of the following ways.

An OBS bucket name has to be globally unique. Once a bucket is created, its name and region cannot be changed, so plan the bucket name and region properly.

OBS Console

OBS Console is a web-based graphical user interface (GUI). You can access OBS Console from anywhere you have an Internet connection.

Logging In to OBS Console Creating a Bucket

OBS Browser+

OBS Browser+ is a GUI-based desktop application that is intuitive and easy to use.

Downloading OBS Browser+ Creating a Bucket

obsutil

obsutil is a command line tool compatible with Windows, macOS, and Linux.

Downloading obsutil Creating a Bucket

OBS API

OBS provides a REST API that you can use to access OBS from web applications.

API Reference

OBS SDKs

OBS software development kits (SDKs) in different programming languages (such as Java and Python) are available for secondary development.

OBS SDKs

After creating a bucket, you can upload files to it in any of the following ways. OBS stores the uploaded files as objects.

Files uploaded to OBS can be of any type, including text, image, and video. To upload files to a bucket, you must have the upload permission for that bucket.

OBS Console

Files can be uploaded one by one or in batches, but the largest single batch that can be uploaded is 5 GB. A maximum of 100 files can be uploaded at a time.

Uploading an Object Creating a Folder

OBS Browser+

A file up to 48.8 TB can be uploaded. Multipart uploads are also supported. You can also create folders to manage files.

Uploading an Object

obsutil

With obsutil, files as big as 48.8 TB can be uploaded. obsutil also supports resumable uploads, multipart uploads, and incremental uploads; and allows you to create folders to manage files.

Uploading an Object Synchronously Uploading Incremental Objects

OBS API

Files as large as 5 GB can be uploaded using PUT, POST, and append uploads; and files as large as 48.8 TB can be uploaded using multipart uploads.

Uploading Objects - PUT Uploading Objects - POST Multipart Upload

OBS SDKs

Files as large as 5 GB can be uploaded using streaming uploads, file-based uploads, and append uploads; and files as large as 48.8 TB can be uploaded using multipart uploads. Resumable uploads and browser-based uploads are supported too.

OBS SDKs

You can download objects stored in OBS in any of the following ways.

To download an object, you must have the download permission for the object, a temporary URL, an access code, or an authorization code that someone shared with you.

OBS Console

You can directly download objects on OBS Console. You can also share a temporary URL (for a file) or access code (for a folder) with anonymous users to allow them to download objects.

Downloading an Object Sharing an Object

OBS Browser+

You can directly download objects on OBS Browser+. You can also share a temporary URL (for a file) or access code (for a folder) with anonymous users to allow them to download objects.

Downloading a File or Folder Sharing a File or Folder

obsutil

You can use obsutil to download objects with a specified name or prefix. You can also share a temporary URL or authorization code with anonymous users to allow them to download objects.

Downloading an Object Sharing an Object

OBS API

With the GET API, you can download an entire object or part of the object content and rewrite some message headers (like ContentType) during the download. Image processing is also supported.

API Reference

OBS SDKs

You can perform streaming downloads, range-based downloads (only part of the object is downloaded), resumable downloads, conditional downloads, and image processing.

OBS SDKs