Object Storage Service:Error handling (C SDK)

Error response structure

All failed requests return an aos_status_s struct with the following fields.

The following example shows how to inspect these fields after a failed request:

/* Check whether the request succeeded */
if (resp_status->code < 200 || resp_status->code >= 300) {
    /* HTTP status code — use to determine error category */
    printf("HTTP status code: %d\n", resp_status->code);

    /* OSS error code — use to identify the specific error */
    printf("Error code: %s\n", resp_status->error_code);

    /* Human-readable error message */
    printf("Error message: %s\n", resp_status->error_msg);

    /* Request ID — provide this to Alibaba Cloud Support when reporting issues */
    printf("Request ID: %s\n", resp_status->req_id);
}

Note: Save the request ID (req_id) when an error occurs. Alibaba Cloud Support uses this ID to look up the corresponding request logs.

Timeout errors

Timeout errors occur when the connection or request times out. They are indicated by:

• HTTP status code is not 2xx, and

• error_code is -992 (connection timeout) or -995 (request timeout)

When a timeout occurs, retry the request. Use aos_should_retry(aos_status_t *) from aos_status.h to determine whether a retry is appropriate:

#include "aos_status.h"

/* aos_should_retry returns 1 if the error warrants a retry */
if (aos_should_retry(resp_status) == 1) {
    /* Retry the request */
}

OSS error codes

OSS error codes are server-side errors returned in error_code. The following tables list common error codes grouped by HTTP status code.