Troubleshooting

Last updated: 2022-01-05 14:31:57

    Overview

    If an SDK API call to request the COS service fails, the system will return the error information in the callback.

    Sample error

    cos.headBucket({
       Bucket: 'examplebucket-1250000000',
       Region: 'COS_REGION',     /* Bucket region. Required */
    }, function(err, data) {
       if (err) {
           console.log(err.error);
       }
    });
    

    Client Exceptions

    Parameter Description Type
    err Network or service error returned when the request fails. If the request is successful, this parameter is empty. For more information, see Error Codes. Object
    - error Error message for the request Object/String

    Server Exceptions

    Parameter Description Type
    err Network or service error returned when the request fails. If the request is successful, this parameter is empty. For more information, see Error Codes. Object
    - statusCode HTTP status code, such as 200, 403, and 404 Number
    - headers Headers Object
    - error Error information Object/String
    - - Code Error code returned by the body when the request fails. For more information, see Error Codes String
    - - Message Error message returned by the body when the request fails. For more information, see Error Codes String
    - - RequestId Unique ID of the request in the server request log that can be submitted when you contact us for troubleshooting 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.
      Diagnosis Tool
      Click to start diagnosis
      Enter `RequestId` for intelligent diagnosis and obtain basic request information, directions, and diagnosis information to quickly locate request errors.
    3. Enter RequestId and click Diagnose.
    4. Wait and view the diagnostic result.