Help Center/ Object Storage Service/ Tools Guide/ obsutil/ Fault Locating/ Return Codes
Updated on 2026-07-29 GMT+08:00
View PDF
Share

Return Codes

If obsutil is invoked by processes, the command output cannot be viewed in real time. obsutil generates different return codes based on different execution results. Table 1 describes the return codes. You can use the following methods to obtain the return code of the latest execution result and then analyze and rectify the fault based on it:

  • In the macOS or Linux OS, run the following command to obtain the return code of the latest execution result: 
    echo $?
  • In the Windows OS, run the following command to obtain the return code of the latest execution result: 
    echo %errorlevel%
Table 1 Return codes

Return Code

Meaning

Example Scenario

0

Execution succeeded.

An object is successfully uploaded.

1

The file does not exist.

The entered file path does not exist for uploading a file by running the cp command.

2

The task does not exist.

The specified task ID does not exist for resuming a failed upload task by running the cp command.

3

Parameter error
  • At least one entered additional parameters is not supported for uploading a file by running the cp command.
  • The entered value of cloud_url is invalid for downloading a file by running the cp command.
    NOTE:

    cloud_url indicates the bucket path or object path. Set cloud_url in the format of obs://bucketname when downloading all objects in a bucket. Set cloud_url in the format of obs://bucketname/key when downloading a specified object in a bucket.

4

Bucket status error

The specified destination bucket does not exist for uploading a folder by running the cp command.

5

Initialization error during command execution
  • An error occurs when loading the configuration file.
  • Parameter -o is configured when running the cp command to upload a folder, but the folder specified by -o for saving the result files fails to be created.

6

Execution error.

When you run the ls command to query the bucket list, the query fails because the network times out.

7

The operation is not supported.

Running the chattri command to change object properties is not supported because the bucket version is not 3.0.

8

A batch task succeeded partially.

Some objects fail to be downloaded during a batch download by running the cp command.

9

Interruption error

Users press Ctrl + C to interrupt the command execution.

-1

Unknown error

-
Parent topic: Fault Locating