tencent cloud

Feedback

Troubleshooting

Last updated: 2024-02-04 14:25:57

    Overview

    When you fail to request COS service via the SDK, such as getting 4xx or 5xx return code, the system will throw an exception (Qcloud\\Cos\\Exception\\ServiceResponseException).

    Server Exceptions

    CosServiceException contains the status code returned by the server, requestId, error details, etc. After an exception is caught, it is recommended to print the entire exception to get the necessary information for troubleshooting. The following describes member variables of an exception and an example of catching an exception:
    Member
    Description
    Type
    requestId
    Request ID which identifies a request. It is very important for troubleshooting.
    string
    statusCode
    Status code in the response. 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

    Example of Exception Capturing

    <?php
    
    require dirname(__FILE__) . '/../vendor/autoload.php';
    
    $secretId = "SECRETID"; //Replace it with the actual SecretId, which can be viewed and managed at https://console.tencentcloud.com/cam/capi
    $secretKey = "SECRETKEY"; //Replace it with the actual SecretKey, which can be viewed and managed at https://console.tencentcloud.com/cam/capi
    $region = "ap-beijing"; //Replace it with the actual region, which can be viewed in the console at https://console.tencentcloud.com/cos5/bucket
    $cosClient = new Qcloud\\Cos\\Client(
    array(
    'region' => $region,
    'schema' => 'https', // Protocol header, which is http by default
    'credentials'=> array(
    'secretId' => $secretId ,
    'secretKey' => $secretKey)));
    
    try {
    $cosClient->listBuckets()
    } catch (Qcloud\\Cos\\Exception\\ServiceResponseException $e) {
    $statusCode = $e->getStatusCode(); // Get the error code
    $errorMessage = $e->getMessage(); // Get the error message
    $requestId = $e->getRequestId(); // Get the requestId corresponding to the error
    $errorCode = $e->getCosErrorCode(); // Get the error name
    $request = $e->getRequest(); // Get the entire request
    $response = $e->getResponse(); // Get the entire response
    echo ($e);
    } catch (\\Exception $e) {
    
    }
    Note:
    If you install the SDK using Phar or the source code, the error messages returned will be clearer. If you install with Composer and the error messages returned do not meet your requirements, you can customize some error messages by modifying vendor/guzzlehttp/guzzle-services/src/SchemaValidator.php.

    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.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support