As exceções no OSS SDK for C# dividem-se em dois tipos: OSSException e ClientException. Ambas são subclasses de RuntimeException.
ClientException
A ClientException indica uma falha durante o envio de requisições ou a transmissão de dados para o OSS pelo cliente. Por exemplo, essa exceção ocorre quando há desconexão de rede e o cliente não consegue enviar a requisição. Ela também surge diante de erros de E/S durante o upload de objetos.
OSSException
A OSSException refere-se a uma exceção de servidor gerada ao analisar mensagens de erro. Essa ServiceException contém o código e a mensagem retornados pelo OSS, permitindo identificar e resolver o problema.
A OSSException inclui as seguintes informações de erro:
|
Parâmetro |
Descrição |
|
Code |
Código de erro retornado pelo OSS. |
|
Message |
Mensagem detalhada do erro fornecida pelo OSS. |
|
RequestId |
UUID que identifica a requisição de forma única. Caso o problema persista, forneça esse ID aos engenheiros de desenvolvimento do OSS para obter suporte. |
|
HostId |
Identificador do host no cluster do OSS acessado, correspondente ao 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 excede o tamanho permitido. |
|
EntityTooSmall |
A entidade é menor que o tamanho mínimo exigido. |
|
FileGroupTooLarge |
O grupo de arquivos ultrapassa o limite de tamanho. |
|
FilePartNotExist |
A parte do arquivo não existe. |
|
FilePartStale |
A parte do arquivo expirou. |
|
InvalidArgument |
Formato de parâmetro inválido. |
|
InvalidAccessKeyId |
O AccessKey ID informado não existe. |
|
InvalidBucketName |
Nome do bucket inválido. |
|
InvalidDigest |
Digest inválido. |
|
InvalidObjectName |
Nome do objeto inválido. |
|
InvalidPart |
Parte inválida. |
|
InvalidPartOrder |
Ordem das partes incorreta. |
|
InvalidTargetBucketForLogging |
Bucket de destino para logging inválido. |
|
InternalError |
Erro interno no OSS. |
|
MalformedXML |
Formato XML mal estruturado. |
|
MethodNotAllowed |
Método não suportado. |
|
MissingArgument |
Parâmetros obrigatórios ausentes. |
|
MissingContentLength |
Comprimento do conteúdo não especificado. |
|
NoSuchBucket |
O bucket do OSS indicado não existe. |
|
NoSuchKey |
Objeto inexistente. |
|
NoSuchUpload |
O ID de upload da parte existe. |
|
NotImplemented |
Implementação do método indisponível. |
|
PreconditionFailed |
Falha durante o pré-processamento. |
|
RequestTimeTooSkewed |
Diferença de horário entre o cliente e o servidor OSS superior a 15 minutos. |
|
RequestTimeout |
Tempo da requisição esgotado. |
|
SignatureDoesNotMatch |
Erro de assinatura detectado. |
|
TooManyBuckets |
Quantidade de buckets acima do limite permitido. |