Configuring a Storage Class

1. In the navigation pane of OBS Console, choose Object Storage.
2. In the upper right corner, click Create Bucket. The Create Bucket page is displayed.
   Figure 1 Creating a bucket
   

3. Configure bucket parameters.

   Table 1 Bucket parameters

   Parameter	Description
   Replicate Existing Settings	Optional. To use this function, click Select Bucket and select a bucket from the list as the replication source. After the replication source is selected, the following settings are replicated to the bucket you are creating: region, data redundancy policy, storage class, bucket policy, server-side encryption, Direct Reading, enterprise project, and tags. You can still change some or all of the replicated settings as needed.
   Region	Geographic area where a bucket resides. For low latency and fast access, select the region nearest to you. Once the bucket is created, its region cannot be changed. Most OBS features are available in all regions, but some are only available for certain regions. Consider the feature availability in each region when you select a region for a bucket. For details, see Function Overview. If your ECS needs to access an OBS bucket over an intranet, ensure that the bucket and the ECS are in the same region. For details, see Accessing OBS over an Intranet.
   Bucket Name	Name of the bucket. A bucket name must be unique across all accounts and regions. Once a bucket is created, its name cannot be changed. According to the globally applied DNS naming rules, an OBS bucket name: Must be unique across all accounts and regions. The name of a deleted bucket can be reused for another bucket or a parallel file system at least 30 minutes after the deletion. Must be 3 to 63 characters long. Only lowercase letters, digits, hyphens (-), and periods (.) are allowed. Cannot start or end with a period (.) or hyphen (-), and cannot contain two consecutive periods (..) or contain a period (.) and a hyphen (-) adjacent to each other. Cannot be formatted as an IP address. NOTE: When you access OBS through HTTPS using virtual hosted-style URLs, if the bucket name contains a period (.), the certificate verification will fail. To work around this issue, you are advised not to use periods (.) in bucket names.
   Data Redundancy Policy	Multi-AZ storage: Data is stored in multiple AZs to achieve higher reliability. Single-AZ storage: Data is stored in a single AZ, with lower costs. For details about the performance comparison between multi-AZ and single-AZ storage, see Comparison of Storage Classes. Once a bucket is created, the data redundancy policy cannot be changed, so choose the policy that can meet your needs. Multi-AZ storage is not available for Archive buckets. Multi-AZ storage is not available for buckets in the Deep Archive storage class.
   Storage Class	The storage class of a bucket. Different storage classes meet different requirements for storage performance and costs. The Standard storage class is for storing a large number of hot files or small files that are frequently accessed (multiple times per month on average) and require quick retrieval. The storage class is for storing data that is less frequently accessed (less than 12 times per year on average) but requires quick retrieval. The Archive storage class is for archiving data that is rarely accessed (once a year on average) and has less demanding requirements for quick retrieval. The Deep Archive storage class is for storing data that is rarely accessed (a lower frequency than the archived data) and has less demanding requirements for quick retrieval. For details, see Storage Classes.
   Bucket Policy	Controls read and write permissions for buckets. Private: Only users granted permissions by the bucket ACL can access the bucket. Public Read: Anyone can read objects in the bucket. Public Read and Write: Anyone can read, write, or delete objects in the bucket.
   Enterprise Project	You can add a bucket to an enterprise project for unified management. Create an enterprise project by referring to Creating an Enterprise Project. The default enterprise project is named default. On the Enterprise Project Management Service page, create an enterprise project, and add a user group to the enterprise project. By doing so, users in this user group obtain the operation permissions for the buckets and objects in the enterprise project. NOTE: Only an enterprise account can configure enterprise projects. OBS ReadOnlyAccess and OBS OperateAccess are the fine-grained authorizations of the enterprise project user group in OBS.
   Direct Reading	Direct reading allows you to directly download objects from the Archive storage class without restoring them first. Direct reading is a billable function. For details, see Product Pricing Details. No matter which default storage class you select, you can enable direct reading for your bucket. For example, if you select the Standard storage class and enable direct reading for your bucket, you can directly download objects stored in the Archive storage class from your bucket.
   Server-Side Encryption	Choose SSE-KMS. DEW APIs have traffic control limits. For details, see DEW API Overview. After SSE-KMS is enabled, your service access may be affected by traffic control. You can choose Default to use the default key in the current region to encrypt the objects you upload to the bucket. If you do not have a default key, OBS automatically creates one the first time you upload an object. You can also choose Custom to use a custom key for encryption. If there is no custom key available, click View KMS Keys to create one. You can also select Shared to enter a shared key ID. The key shared by other users will be used to encrypt your objects. For details about how to obtain a shared key ID, see Viewing a CMK. NOTE: A shared key from a project or a subproject can be configured here. However, if a shared key from a subproject is specified, the owner of the shared key cannot access objects encrypted with that key, but the bucket owner can. Selecting SSE-OBS for Encryption Method will use the keys created and managed by OBS for encryption. When Server-Side Encryption is enabled for a bucket, you can configure the object you upload to inherit encryption from the bucket or choose SSE-KMS or SSE-OBS.
   WORM	When you enable write-once-read-many (WORM), you can configure a retention policy for the current bucket. The object version which the retention policy is applied to cannot be deleted within a specified period. You can only enable WORM when you create a bucket. Once enabled for a bucket, WORM cannot be disabled. When you enable WORM, OBS automatically enables versioning for the bucket, and versioning cannot be suspended later for that bucket.
   Tags	Optional. Tags are used to identify and classify buckets in OBS. Each tag is represented by a key-value pair. For more information, see Tags.

4. Click Create Now.

Specifying a Storage Class During Bucket Creation (adding the x-obs-storage-class header)

1. Log in to OBS Browser+.
2. In the upper part of the page, click Create Bucket.
3. In the displayed dialog box, configure bucket parameters, as shown in Figure 2.
   Figure 2 Creating buckets

   

   Table 2 Creating buckets

   Parameter	Description
   Region	Enter the region where you want to create a bucket. Once the bucket is created, its region cannot be changed.
   Storage Class	The storage class of a bucket. Different storage classes meet customers' needs for storage performance and costs. The Standard storage class is for storing a large number of hot files or small files that are frequently accessed (multiple times per month on average) and require quick retrieval. The Infrequent Access storage class is for storing data that is less frequently accessed (less than 12 times per year on average) but requires quick retrieval. The Archive storage class is for archiving data that is rarely accessed (once a year on average) and has less demanding requirements for quick retrieval. For details, see Storage Classes.
   Bucket ACL	Controls read and write permissions for buckets. Private: Only users granted permissions by the bucket ACL can access the bucket. Public Read: Anyone can read objects in the bucket. Public Read and Write: Anyone can read, write, or delete objects in the bucket.
   Multi-AZ Mode	If multi-AZ storage is enabled, data will be stored in multiple AZs. Once a bucket is created, its multi-AZ status cannot be changed. So, plan in advance and determine whether to enable the multi-AZ function during bucket creation.
   Bucket Name	Name of the bucket you want to create, which must be globally unique. A bucket name: Must be 3 to 63 characters long and start with a digit or letter. Only lowercase letters, digits, hyphens (-), and periods (.) are allowed. Cannot be formatted as an IP address. Cannot start or end with a hyphen (-) or period (.). Cannot contain two consecutive periods (..), for example, my..bucket. Cannot contain a period (.) and a hyphen (-) adjacent to each other, for example, my-.bucket or my.-bucket.

   You can click next to the bucket name to learn about the bucket naming rules. A user can create a maximum of 100 buckets in OBS.

   

   • When a URL is used to access a bucket, the bucket name will become a part of the URL. According to the DNS rule, URLs do not support uppercase letters and cannot be used to access a bucket whose name contains uppercase letters. Therefore, a bucket name can contain only lowercase letters, digits, hyphens (-), and periods (.) For example, if you attempt to access bucket MyBucket using a URL, MyBucket will be parsed as mybucket. This results in an access error.
   • DNS naming rules standardize bucket names globally, facilitating the resolution during bucket access. With the DNS naming rules used, you can benefit from new functions and optimized features, and configure static website hosting for buckets.
   • Once you have created a bucket, you cannot change the name of it. Make sure that the bucket name you set is appropriate.

4. Click OK. If the bucket is successfully created, it is displayed in the bucket list. If the creation fails, an error message will be displayed.

Command Line Structure

• Windows:

  obsutil mb obs://bucket [-fs] [-az=xxx] [-acl=xxx] [-sc=xxx] [-location=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

• Linux or macOS:

  ./obsutil mb obs://bucket [-fs] [-az=xxx] [-acl=xxx] [-sc=xxx] [-location=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

Examples

• Take the Windows OS as an example. Run the obsutil mb obs://bucket-test command to create a bucket. The example bucket was created.

  obsutil mb obs://bucket-test
  
  Create bucket [bucket-test] successfully, request id [0000016979E1D2EA860BB5E80A6B8FCC]

• Take the Windows OS as an example. Run the obsutil mb obs://bucket001 command to create a namesake bucket. The example bucket failed to be created.

  obsutil mb obs://bucket001
  
  Create bucket [bucket001] failed, http status [409], error code [BucketAlreadyExists], error message [The requested bucket name is not available. The bucket namespace is shared by all users of the system. Please select a different name and try again.], request id [04030000016757F31A0333281A6B1E92]

Parameter Description

1. In the navigation pane of OBS Console, choose Object Storage.
2. In the bucket list, click the bucket you want to operate. The Objects page is displayed.
3. Click Upload Object or go to the folder where you want to upload files and click Upload Object. The Upload Object dialog box is displayed.

   Batch upload is used as an example here. If the region you are using does not support batch upload, perform operations as instructed.

   

   If the files that you want to upload to OBS are stored in Microsoft OneDrive, it is recommended that the names of these files contain a maximum of 32 characters to ensure compatibility.

   Figure 3 Uploading objects

   
   

4. Select a storage class. If you do not specify a storage class, the objects you upload inherit the storage class of the bucket.
   

   An object can have a different storage class from its bucket. By default, an object inherits the storage class of the bucket where it is uploaded. You can specify a storage class for an object when uploading it, or you can change the object storage class after the object is uploaded.

5. In the Upload Object area, drag and drop the files or folders you want to upload.

   You can also click add files in the Upload Object area to select files.

6. Server-Side Encryption: Choose Disable, SSE-KMS, or SSE-OBS. For details, see Server-Side Encryption.
   

   If the bucket has server-side encryption configured, the object you upload will inherit encryption from the bucket by default.

7. (Optional) To configure metadata or WORM retention policies, click Next: (Optional) Configure Advanced Settings.
   

   WORM retention policies can be configured in the advanced settings only when WORM is enabled for the bucket.

   Configuring metadata: Add metadata ContentDisposition, ContentLanguage, WebsiteRedirectLocation, ContentEncoding, or ContentType as needed. For more information, see Object Metadata. Metadata is a set of name-value pairs. The metadata value cannot be left blank. You can add two or more metadata entries by clicking Add.

   Configuring WORM retention: Choose Inherit from bucket, or choose Configure and then specify a retention period, to automatically protect new objects uploaded to the bucket from being deleted.

   Figure 4 Configuring metadata or WORM retention

   

8. Click Upload.

Specifying a Storage Class During Object Uploads with PUT (adding the x-obs-storage-class header)

Specifying a Storage Class During Object Uploads with POST (adding the x-obs-storage-class header)

Initiating a Multipart Upload (adding the x-obs-storage-class header during the initiation process if a multipart upload is used)

1. Log in to OBS Browser+.
2. Click the bucket where you want to upload files or folders.
3. Click Upload and then Add File or Folder, as shown in Figure 5.
   Figure 5 Uploading a file or folder
   

   For better experience when using the Add File function, you are advised to upload a maximum of 100 files at a time. If you need to upload more, place all the files in a folder and upload them by adding a folder.

   

   1. If message "Service Unavailable" is displayed when files are being uploaded, try again later.
   2. If an access deny message is displayed when you are uploading a file or folder, possible causes are as follows:

   • Access to the bucket is restricted by an ACL. For example, you do not have the write permission for the bucket.
   • Access to the bucket is restricted by a bucket policy. For example, you do not have the write permission for the bucket, or write operations cannot be performed on the bucket during the current period.

     If such message is displayed, check ACL and policy settings of the bucket and resolve the problem accordingly.

   

   You must have access to the file you want to upload, or the file upload will fail.

4. In the displayed dialog box, select the file or folder you want to upload and click Open.

   You can upload one folder or multiple files at a time. To upload multiple files, hold down Ctrl or Shift to select multiple files and batch upload them. You can also press Ctrl+A to select all files. The operations are consistent with those in Windows operating systems.

5. Click OK.

Command Line Structure

• Windows:
  • Uploading a file

    obsutil cp file_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-u] [-vlength] [-vmd5] [-p=1] [-threshold=5248800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-o=xxx] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

  • Uploading a folder

    obsutil cp folder_url obs://bucket[/key] -r [-arcDir=xxx] [-dryRun] [-link] [-f] [-flat] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

  • Uploading multiple files/folders

    obsutil cp file1_url,folder1_url|filelist_url obs://bucket[/prefix] -msm=1 [-r] [-arcDir=xxx] [-dryRun] [-link] [-f] [-u] [-vlength] [-vmd5] [-flat] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx][-timeRange=time1-time2] [-at] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

    

    In this command, /prefix is the name prefix for uploading folders.

• Linux or macOS:
  • Uploading a file

    ./obsutil cp file_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-u] [-vlength] [-vmd5] [-p=1] [-threshold=5248800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-o=xxx] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

  • Uploading a folder

    ./obsutil cp folder_url obs://bucket[/key] -r [-arcDir=xxx] [-dryRun] [-link] [-f] [-flat] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-at] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

  • Uploading multiple files/folders

    ./obsutil cp file1_url,folder1_url|filelist_url obs://bucket[/prefix] -msm=1 [-r] [-arcDir=xxx] [-dryRun] [-link] [-f] [-u] [-vlength] [-vmd5] [-flat] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx][-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

    

    In this command, /prefix is the name prefix for uploading folders.

Examples

• Take the Windows OS as an example. Run the obsutil cp d:\temp\test.txt obs://bucket-test/key command to upload the test.txt file in the temp directory in the D: drive to bucket bucket-test and rename the file as key.

  obsutil cp d:\temp\test.txt obs://bucket-test/key
  Start at 2024-09-30 08:11:41.6724827 +0000 UTC
  
  Parallel:      5                   Jobs:          5
  Threshold:     50.00MB             PartSize:      auto
  VerifyLength:  false               VerifyMd5:     false
  CheckpointDir: C:\Users\Administrator\.obsutil_checkpoint
  
  [====================================================] 100.00% 1.68 MB/s 8.46MB/8.46MB 5s
  Upload successfully, 8.46MB, n/a, d:\temp\test.txt --> obs://bucket-test/key, cost [5], status [200], request id [0000016979E1D2B2860BB5181229C72C]

• Take the Windows OS as an example. Run the obsutil cp d:\temp obs://bucket-test -f -r command to recursively upload all files and subfolders in the temp directory in the D: drive to the temp folder in bucket bucket-test.

  obsutil cp d:\temp obs://bucket-test -f -r
  Start at 2024-09-30 08:14:12.1406275 +0000 UTC
  
  Parallel:      5                   Jobs:          5
  Threshold:     50.00MB             PartSize:      auto
  VerifyLength:  false               VerifyMd5:     false
  CheckpointDir: C:\Users\Administrator\.obsutil_checkpoint
  
  Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed
  OutputDir: C:\Users\Administrator\.obsutil_output
  
  [========================================================] 100.00% tps:35.71 2.02 KB/s 7.20MB/7.20MB 0s
  Succeed count:   5         Failed count:    0
  Succeed bytes:      xxx
  Metrics [max cost:90 ms, min cost:45 ms, average cost:63.80 ms, average tps:35.71, transferred size: 7.20MB]
  
  Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed

Parameter Description

./obsutil cp /localpath/ obs://test/ -include=/localpath/2022-12-09/* -f -r