Este tópico descreve como tratar erros ao utilizar o OSS SDK para C.
Tratamento de exceções
Quando ocorre um erro ao enviar uma solicitação pelo OSS SDK para C, o sistema retorna a mensagem de erro correspondente em aos_status_s. A tabela a seguir descreve os erros contidos em aos_status_s.
|
Código de erro |
Descrição |
Tipo |
|
code |
Código de status HTTP da solicitação com erro. |
Integer |
|
error_code |
Código de erro que o OSS retorna. |
String |
|
error_msg |
Mensagem de erro que o OSS retorna. |
String |
|
req_id |
UUID que identifica a solicitação. |
String |
Tratamento de tempo limite
Se o código de status HTTP no parâmetro aos_status_t retornado não for 2xx e error_code indicar -992 ou -995, a conexão ou a solicitação atingiu o tempo limite. Nesse caso, envie a solicitação novamente.
Utilize aos_should_retry(aos_status_t *) no arquivo aos_status.h para verificar se o erro requer nova tentativa com base no valor retornado. Se o valor retornado for 1, repita a operação para esse erro.
Códigos de erro comuns
|
Código de erro |
Descrição |
Código de status HTTP |
|
AccessDenied |
Acesso negado. |
403 |
|
BucketAlreadyExists |
O bucket já existe. |
409 |
|
BucketNotEmpty |
O bucket não está vazio. |
409 |
|
EntityTooLarge |
O tamanho da entidade excede o limite máximo. |
400 |
|
EntityTooSmall |
O tamanho da entidade está abaixo do limite mínimo. |
400 |
|
FileGroupTooLarge |
O tamanho do grupo de arquivos excede o limite máximo. |
400 |
|
FilePartNotExist |
A parte não existe. |
400 |
|
FilePartStale |
A parte expirou. |
400 |
|
InvalidArgument |
Formato de parâmetro inválido. |
400 |
|
InvalidAccessKeyId |
O AccessKey ID não existe. |
403 |
|
InvalidBucketName |
Nome de bucket inválido. |
400 |
|
InvalidDigest |
Digest inválido. |
400 |
|
InvalidObjectName |
Nome de objeto inválido. |
400 |
|
InvalidPart |
Parte inválida. |
400 |
|
InvalidPartOrder |
Sequência de partes inválida. |
400 |
|
InvalidTargetBucketForLogging |
Bucket de registro de logs inválido. |
400 |
|
InternalError |
Ocorreu um erro interno no OSS. |
500 |
|
MalformedXML |
Formato XML inválido. |
400 |
|
MethodNotAllowed |
Método não permitido. |
405 |
|
MissingArgument |
Alguns parâmetros obrigatórios não foram especificados. |
411 |
|
MissingContentLength |
O comprimento do conteúdo está ausente. |
411 |
|
NoSuchBucket |
O bucket não existe. |
404 |
|
NoSuchKey |
O objeto não existe. |
404 |
|
NoSuchUpload |
O ID de upload multipart não existe. |
404 |
|
NotImplemented |
Não é possível implementar o método. |
501 |
|
PreconditionFailed |
Ocorreu um erro durante o pré-processamento. |
412 |
|
RequestTimeTooSkewed |
O desvio de horário entre o cliente OSS e o servidor OSS excede 15 minutos. |
403 |
|
RequestTimeout |
A solicitação atingiu o tempo limite. |
400 |
|
SignatureDoesNotMatch |
Ocorreu um erro de assinatura. |
403 |
|
TooManyBuckets |
O número de buckets excede o limite. |
400 |