doc-exports/docs/obs/tool-obsutil/obs_11_0006.html

Quick Start

This section uses Linux as an example to describe how to use obsutil to perform basic operations in OBS.

Prerequisites

• You have obtained obsutil and completed initial configuration.
• You are in the directory where obsutil is located.

Procedure

1. Run the ./obsutil mb obs://bucket-test command to create a bucket named bucket-test in the region.

   ./obsutil mb obs://bucket-test
   
   Create bucket [bucket-test] successfully!

2. Run the ./obsutil cp /temp/test.txt obs://bucket-test/test.txt command to upload the test.txt file to bucket bucket-test.

   ./obsutil cp /temp/test.txt obs://bucket-test/test.txt
   
   Parallel:      5                   Jobs:          5
   Threshold:     52428800            PartSize:      5242880
   VerifyLength:  false               VerifyMd5:     false
   CheckpointDir: /temp/.obsutil_checkpoint
   
   test.txt:[==============================================] 100.00% 48.47 KB/s 0s
   Upload successfully, 4.44KB, /temp/test.txt --> obs://bucket-test1/test.txt

   

   To upload local folder test to the OBS bucket, run the following command:

   ./obsutil cp /test/ obs://bucket-test -r -f

   • For details about the cp command, see Uploading an Object.
   • For more upload scenarios, see Upload.

3. Run the ./obsutil cp obs://bucket-test/test.txt /temp/test1.txt command to download test.txt from bucket bucket-test to a local PC.

   ./obsutil cp obs://bucket-test/test.txt /temp/test1.txt
   
   Parallel:      5                   Jobs:          5
   Threshold:     52428800            PartSize:      5242880
   VerifyLength:  false               VerifyMd5:     false
   CheckpointDir: /temp/.obsutil_checkpoint
   
   test.txt:[=============================================] 100.00% 775.52 KB/s 0s
   Download successfully, 4.44KB, obs://bucket-test1/test.txt --> /temp/test1.txt

   

   To download directory test from the OBS bucket to the local folder temp, run the following command:

   ./obsutil cp obs://bucket-test/test /temp -r -f

   • For details about the cp command, see Downloading an Object.
   • For more download scenarios, see Download.

4. Run the ./obsutil rm obs://bucket-test/test.txt -f command to delete object test.txt from bucket bucket-test.

   ./obsutil rm obs://bucket-test/test.txt -f
   
   Delete object [test.txt] in the bucket [bucket-test] successfully!

5. Run the ./obsutil rm obs://bucket-test -f command to delete bucket bucket-test.

   ./obsutil rm obs://bucket-test -f
   
   Delete bucket [bucket-test] successfully!

Parent topic: Getting Started