Troubleshooting

Overview
If a COS request fails when calling this SDK, it will throw a CosClientException (client exception) or CosServerException (server exception).
The CosClientException 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, etc.
The CosServerException 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, etc.
Client Exceptions
Inherited from System.ApplicationException, CosClientException is used in the same way as System.ApplicationException. An additional member errorCode is also added, as shown below:
Member
Description
Type
errorCode
Client error code, such as 10000, which indicates a parameter verification failure. For more information, see Error Codes
int
Server Exceptions
A CosServiceException contains the status code returned by the server, the requestid, and the error details. 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 the exception are described as follows:
Member
Description
Type
requestId
Request ID, used to identify a request. It is very important for troubleshooting.
string
statusCode
Status code in the response. A 4XX status code represents a request failure caused by the client, and a 5XX status code represents a failure caused by a server exception. For more information, see COS 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
Using the Diagnosis Tool
COS provides a self-help diagnosis tool to help you quickly locate request problems and debug code.
Directions
1. Copy the request ID (RequestId) returned when the request error occurs.
2. Click Diagnosis Tool.
﻿
3. Enter RequestId and click Diagnose.
4. Wait and view the diagnostic result.

Was this page helpful?

You can also Contact Sales or Submit a Ticket for help.

Yes

Member	Description	Type
errorCode	Client error code, such as 10000, which indicates a parameter verification failure. For more information, see Error Codes	int

tencent cloud

Sign Up

Log in

Compute

Microservice

Data Migration

Database SaaS Tool

Data Security

Application Security

Big Data

Voice Technology

Internet of Things

Stream Services

Cloud Real-time Rendering

Cloud Resource Management

More

Edge Computing

Serverless

Relational Database

Networking

Business Security

Domains & Websites

Face Recognition

AI Platform Service

Middleware

Media On-Demand

Game Services

Management and Audit Tools

Container

Essential Storage Service

Enterprise Distributed DBMS

CDN and Acceleration

Security Services

Enterprise Applications

Tencent Big Model

Natural Language Processing

Communication

Media Process Services

Education Sevices

Developer Tools

Distributed cloud

Data Process and Analysis

NoSQL Database

Network Security

Cloud Security

Office Collaboration

Image Creation

Optical Character Recognition

Interactive Video Services

Media SDK

Medical Services

Monitor and Operation

Overview

Client Exceptions

Server Exceptions

Using the Diagnosis Tool

Directions