If a COS request fails when calling this SDK, it will throw a
CosXmlClientException (client exception) or
CosXmlServiceException (server exception).
CosXmlClientException, results from unexpected interaction issues between the client and the COS server, such as a failure to connect to the server, a failure to parse the data returned by the server, or the occurrence of an IO exception when reading a local file.
CosXmlServiceException, occurs when the client interacts with the COS server normally, but the operation fails. For example, the client accesses a bucket that does not exist, deletes a file that does not exist, or does not have the permission to perform an operation.
CosClientException is used in the same way as
Exception. An additional member
errorCode is also added, as described below:
|errorCode||Client error code, such as 10000, which indicates a parameter verification failure. For more information, see Error Codes||int|
The server exception,
CosXmlServiceException, occurs when, for example, the client accesses a bucket that does not exist, deletes a file that does not exist, or does not have the permission to perform an operation, etc.
CosXmlServiceException contains the status code returned by the server, the
requestid, the error details, and so on. After an exception is captured, we recommended that you print out the entire exception as it contains necessary factors for troubleshooting. The member variables of exception are described as follows:
|requestId||Request ID, used to identify a request. It is very important for troubleshooting.||string|
|statusCode||Status code in the response. 4xx indicates that the request failed due to a client exception. 5xx indicates that the request failed due to a server exception. For more information, see Error Codes.||string|
|errorCode||Error code returned by the body when the request fails. For more information, see Error Codes.||string|
|errorMessage||Error message returned by the body when the request fails. For more information, see Error Codes.||string|
COS provides a self-help diagnosis tool to help you quickly locate request problems and debug code.
RequestId) returned when the request error occurs.
RequestIdand click Diagnose.