Return Codes

Updated on 2024-04-17 GMT+08:00

View PDF

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 either 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 lists 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	-

Parent topic: Fault Locating

Previous topic: Result Lists

Next topic: Best Practices

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot