As exceções do OSS SDK for C# são classificadas em dois tipos: OSSException e ClientException. Ambas são subclasses de RuntimeException.
ClientException
Uma ClientException indica uma exceção que ocorre quando o cliente envia uma requisição ou transmite dados ao OSS. Por exemplo, uma ClientException é retornada quando o cliente não consegue enviar uma requisição devido à desconexão da rede. Esse tipo de exceção também é retornado quando ocorre um erro de I/O durante o upload de um objeto.
OSSException
OSSException: indica uma exceção de servidor originada da análise de uma mensagem de erro do servidor. Uma ServiceException inclui o código de erro e a mensagem retornados pelo OSS, permitindo identificar e resolver o problema.
Uma OSSException contém as seguintes informações de erro:
|
Parâmetro |
Descrição |
|
Code |
O código de erro retornado pelo OSS. |
|
Message |
A mensagem de erro detalhada retornada pelo OSS. |
|
RequestId |
O UUID utilizado para identificar a requisição de forma exclusiva. Caso o problema persista, forneça o request ID aos engenheiros de desenvolvimento do OSS para obter suporte. |
|
HostId |
O ID do host no cluster OSS acessado, que corresponde ao host ID especificado na requisição. |
Códigos de erro comuns do OSS
|
Código de erro |
Descrição |
|
AccessDenied |
Acesso negado. |
|
BucketAlreadyExists |
O bucket já existe. |
|
BucketNotEmpty |
O bucket não está vazio. |
|
EntityTooLarge |
A entidade é muito grande. |
|
EntityTooSmall |
A entidade é muito pequena. |
|
FileGroupTooLarge |
O grupo de arquivos é muito grande. |
|
FilePartNotExist |
A parte do arquivo não existe. |
|
FilePartStale |
A parte do arquivo expirou. |
|
InvalidArgument |
O formato do parâmetro é inválido. |
|
InvalidAccessKeyId |
O AccessKey ID não existe. |
|
InvalidBucketName |
O nome do bucket é inválido. |
|
InvalidDigest |
O digest é inválido. |
|
InvalidObjectName |
O nome do objeto é inválido. |
|
InvalidPart |
A parte é inválida. |
|
InvalidPartOrder |
A ordem das partes é inválida. |
|
InvalidTargetBucketForLogging |
O bucket de destino para logging é inválido. |
|
InternalError |
Ocorreu um erro interno no OSS. |
|
MalformedXML |
O formato XML é inválido. |
|
MethodNotAllowed |
O método não é compatível. |
|
MissingArgument |
Alguns parâmetros obrigatórios não foram especificados. |
|
MissingContentLength |
O tamanho do conteúdo está ausente. |
|
NoSuchBucket |
O bucket OSS especificado não existe. |
|
NoSuchKey |
O objeto não existe. |
|
NoSuchUpload |
O ID de upload de partes existe. |
|
NotImplemented |
O método não pode ser implementado. |
|
PreconditionFailed |
Ocorreu um erro durante o pré-processamento. |
|
RequestTimeTooSkewed |
A diferença de horário entre o cliente OSS e o servidor OSS excede 15 minutos. |
|
RequestTimeout |
A requisição expirou. |
|
SignatureDoesNotMatch |
Ocorreu um erro de assinatura. |
|
TooManyBuckets |
O número de buckets excede o limite permitido. |