Files
doc-exports/docs/obs/tool-obsutil/obs_11_0058.html
weihongmin1 c4291b1dd5 OBS Util 0309 Verion
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: weihongmin1 <weihongmin1@huawei.com>
Co-committed-by: weihongmin1 <weihongmin1@huawei.com>
2026-03-27 12:15:19 +00:00

10 KiB

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.

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

-