Códigos de erro
Se ocorrer um erro durante a chamada da API, nenhum resultado será retornado. Você pode identificar a causa do erro com base nos códigos de erro de cada API. Se ocorrer um erro quando uma API é chamada, o código de status HTTP 3xx, 4xx ou 5xx será retornado. O corpo da resposta contém o código de erro e as informações específicas. Se você não conseguir identificar a causa de um erro, entre em contato com o atendimento ao cliente e forneça o código de erro para que possamos ajudá-lo a resolver o problema o mais rápido possível.
Sintaxe de resposta de erro
Quando ocorre um erro, as informações do cabeçalho da resposta contêm:
- Content-Type: application/xml
- Código de status de erro HTTP 3xx, 4xx ou 5xx
O corpo da resposta também contém informações sobre o erro. O seguinte é um exemplo de resposta de erro que mostra elementos comuns no corpo da resposta de erro de Transferência de Estado Representacional (REST).
1 2 3 4 5 6 7 8 9 | <?xml version="1.0" encoding="UTF-8"?> <Error> <Code>NoSuchKey</Code> <Message>The resource you requested does not exist</Message> <Resource>/example-filesystem/object</Resource> <RequestId>001B21A61C6C0000013402C4616D5285</RequestId> <HostId>RkRCRDJENDc5MzdGQkQ4OUY3MTI4NTQ3NDk2Mjg0M0FB QUFBQUFBYmJiYmJiYmJD</HostId> </Error> |
Tabela 1 descreve o significado de cada elemento.
| Elemento | Descrição |
|---|---|
| Erro | Elemento raiz que descreve o erro no corpo da resposta XML |
| Código | Código de retorno HTTP que corresponde ao erro no corpo da resposta XML. Para obter detalhes sobre códigos de erro, consulte Tabela 2. |
| Mensagem | Detalhes do erro no corpo da resposta XML. Para obter detalhes sobre mensagens de erro, consulte Tabela 2. |
| RequestId | ID da solicitação cuja resposta de erro é retornada. O ID é usado para localizar o erro. |
| HostId | ID do servidor que retorna uma resposta de erro |
| Recurso | Sistema de arquivos ou objeto relacionado a um erro. |
Algumas respostas de erro contêm informações mais detalhadas. Recomenda-se que todas as informações de erro sejam registradas para facilitar a correção de erros.
Descrição
Se o SFS encontrar um erro ao processar uma solicitação, uma resposta contendo o código de erro e a descrição será retornada. Tabela 2 mostra os códigos de erro do Sistema de arquivos de uso geral.
| Código de status | Código de erro | Mensagem de erro | Solução |
|---|---|---|---|
| 301 Moved Permanently | PermanentRedirect | O sistema de arquivos solicitado pode ser acessado apenas pelo endereço especificado. Envie solicitações subsequentes para o endereço. | Envie a solicitação para o endereço de redirecionamento retornado. |
| 301 Moved Permanently | WebsiteRedirect | A solicitação do site não possui bucketName. | Coloque o nome do sistema de arquivos na solicitação e tente novamente. |
| 307 Moved Temporarily | TemporaryRedirect | Redirecionamento temporário. Se o DNS for atualizado, a solicitação será redirecionada para o sistema de arquivos. | O sistema redireciona automaticamente a solicitação ou envia a solicitação para o endereço de redirecionamento. |
| 400 Bad Request | BadDigest | O valor do MD5 do conteúdo do objeto especificado pelo cliente é inconsistente com o que foi recebido pelo sistema. | Verifique se o valor do MD5 contido no cabeçalho é o mesmo que o calculado pelo corpo da mensagem. |
| 400 Bad Request | BadDomainName | O nome de domínio é inválido. | Use um nome de domínio válido. |
| 400 Bad Request | BadRequest | Parâmetros de solicitação inválidos. | Modifique os parâmetros de acordo com os detalhes do erro no corpo da mensagem. |
| 400 Bad Request | IllegalLocationConstraintException | Uma solicitação sem Location é enviada para criar um sistema de arquivos em uma região não padrão. | Envie a solicitação de criação do sistema de arquivos para a região padrão ou envie a solicitação com o Location de uma região não padrão. |
| 400 Bad Request | InvalidArgument | Parâmetro inválido. | Modifique os parâmetros de acordo com os detalhes do erro no corpo da mensagem. |
| 400 Bad Request | InvalidBucket | O sistema de arquivos a ser acessado não existe. | Tente novamente com outro nome de sistema de arquivos. |
| 400 Bad Request | InvalidBucketName | O nome do sistema de arquivos na solicitação é muito longo ou contém caracteres especiais não permitidos. | Tente novamente com outro nome de sistema de arquivos. |
| 400 Bad Request | InvalidLocationConstraint | O Location especificado na solicitação de criação do sistema de arquivos é inválido ou não existe. | Corrija o Location na solicitação de criação do sistema de arquivos. |
| 400 Bad Request | InvalidPolicyDocument | O conteúdo do formulário não atende às condições especificadas no documento de política. | Modifique a política no formulário construído de acordo com os detalhes do erro no corpo da mensagem e tente novamente. |
| 400 Bad Request | InvalidRedirectLocation | Local de redirecionamento inválido. | Especifica o endereço IP correto. |
| 400 Bad Request | InvalidRequest | Solicitação inválida. | Modifique os parâmetros de acordo com os detalhes do erro no corpo da mensagem. |
| 400 Bad Request | InvalidRequestBody | O corpo da solicitação é inválido. A solicitação requer um corpo de mensagem, mas nenhum corpo de mensagem foi carregado. | Carregue o corpo da mensagem no formato correto. |
| 400 Bad Request | KeyTooLongError | A chave fornecida é muito longa. | Use uma chave mais curta. |
| 400 Bad Request | MalformedError | O formato XML na solicitação está incorreto. | Use o formato XML correto para tentar novamente. |
| 400 Bad Request | MalformedQuotaError | O formato XML da cota está incorreto. | Use o formato XML correto para tentar novamente. |
| 400 Bad Request | MalformedXML | Um arquivo XML de um item de configuração está em um formato incorreto. | Use o formato XML correto para tentar novamente. |
| 400 Bad Request | MetadataTooLarge | O tamanho do cabeçalho de metadados excedeu o limite máximo. | Reduza o tamanho do cabeçalho de metadados. |
| 400 Bad Request | MissingRegion | Nenhuma região contida na solicitação e nenhuma região padrão definida no sistema. | Inclua as informações da região na solicitação. |
| 400 Bad Request | MissingRequestBodyError | Esse código de erro é retornado após o envio de um arquivo XML vazio. | Forneça o arquivo XML correto. |
| 400 Bad Request | MissingRequiredHeader | Os cabeçalhos obrigatórios estão ausentes na solicitação. | Forneça os cabeçalhos obrigatórios. |
| 400 Bad Request | MissingSecurityHeader | Um cabeçalho obrigatório não foi fornecido. | Forneça os cabeçalhos obrigatórios. |
| 400 Bad Request | TooManyBuckets | Você tentou criar mais sistemas de arquivos do que o permitido. | Exclua alguns sistemas de arquivos e tente novamente. |
| 400 Bad Request | TooManyWrongSignature | A solicitação foi rejeitada devido a erros de alta frequência. | Substitua a chave de acesso e tente novamente. |
| 400 Bad Request | UnexpectedContent | A solicitação requer um corpo de mensagem que não é transportado pelo cliente, ou a solicitação não requer um corpo de mensagem, mas o cliente transporta o corpo de mensagem. | Tente novamente de acordo com as instruções. |
| 400 Bad Request | ContentSHA256Mismatch | O valor SHA-256 do objeto calculado pelo cliente é diferente daquele calculado pelo servidor. | Verifique se o valor SHA-256 calculado pelo cliente está correto. |
| 403 Forbidden | AccessDenied | Access denied, because the request does not carry a date header or the header format is incorrect. | Provide a correct date header in the request. |
| 403 Forbidden | DeregisterUserId | O usuário teve seu registro cancelado. | Recarregue ou registre novamente. |
| 403 Forbidden | InArrearOrInsufficientBalance | O assinante deve taxas ou o saldo da conta é insuficiente, e o assinante não tem permissão para realizar uma operação. | Recarregue. |
| 403 Forbidden | InvalidAccessKeyId | O ID da chave de acesso fornecido pelo cliente não existe no sistema. | Forneça um ID de chave de acesso correto. |
| 403 Forbidden | RequestTimeTooSkewed | Houve um grande deslocamento de tempo entre o horário do servidor OBS e o horário em que o cliente iniciou uma solicitação. Para fins de segurança, o OBS verifica o deslocamento de tempo entre o cliente e o servidor. Se o deslocamento for maior que 15 minutos, o servidor OBS rejeitará suas solicitações e essa mensagem de erro será relatada. | Verifique se há um grande deslocamento de tempo entre o horário do cliente e o horário do servidor. Se houver, ajuste a hora do cliente com base na hora local (UTC) e tente novamente. |
| 403 Forbidden | SignatureDoesNotMatch | A assinatura fornecida não corresponde à assinatura calculada pelo sistema. | Verifique sua chave de acesso secreta e o algoritmo de assinatura. Para obter detalhes, consulte Por que as assinaturas não correspondem? |
| 403 Forbidden | VirtualHostDomainRequired | O nome de domínio de acesso ao hospedagem virtual não é usado. | Use o nome de domínio de acesso ao hospedagem virtual. Para obter detalhes, consulte Construção de uma solicitação. |
| 403 Forbidden | Unauthorized | A autenticação do nome real é necessária. | Autentique o nome real do usuário e tente novamente. |
| 404 Not Found | NoSuchBucket | O sistema de arquivos especificado não existe. | Crie um sistema de arquivos e execute a operação novamente. |
| 404 Not Found | NoSuchLifecycleConfiguration | A regra de ciclo de vida solicitada não existe. | Configure uma regra de ciclo de vida primeiro. |
| 405 Method Not Allowed | MethodNotAllowed | O método especificado não é permitido para o recurso solicitado. A mensagem "O método especificado não é permitido." é retornada. | O método não é permitido. |
| 408 Request Timeout | RequestTimeout | A conexão de soquete com o servidor não tem operações de leitura ou gravação dentro do período de tempo limite. | Verifique a rede e tente novamente ou entre em contato com o suporte técnico. |
| 409 Conflict | BucketAlreadyExists | O nome do sistema de arquivos solicitado já existe. O namespace do sistema de arquivos é compartilhado por todos os usuários. | Tente novamente com outro nome de sistema de arquivos. |
| 409 Conflict | BucketAlreadyOwnedByYou | Sua solicitação anterior para criar um sistema de arquivos com o nome especificado foi bem-sucedida e você já é o proprietário dele. | Nenhuma outra ação é necessária. |
| 409 Conflict | BucketNotEmpty | O sistema de arquivos que você tentou excluir não está vazio. | Exclua os objetos no sistema de arquivos e, em seguida, exclua o sistema de arquivos. |
| 409 Conflict | ServiceNotSupported | O método de solicitação não é compatível com o servidor. | Não é compatível com o servidor. Entre em contato com o suporte técnico. |
| 411 Length Required | MissingContentLength | O cabeçalho HTTP Content-Length não foi fornecido. | Forneça o cabeçalho Content-Length. |
| 412 Precondition Failed | PreconditionFailed | Pelo menos uma das pré-condições especificadas não foi atendida. | Modifique de acordo com o prompt de condição no corpo da mensagem retornada. |
| 500 Internal Server Error | InternalError | Ocorreu um erro interno. Tente novamente mais tarde. | Entre em contato com o suporte técnico. |
| 501 Not Implemented | ServiceNotImplemented | O método de solicitação não é implementado pelo servidor. | Atualmente, não há suporte. Entre em contato com o suporte técnico. |
| 503 Service Unavailable | ServiceUnavailable | O servidor está sobrecarregado ou com erros internos. | Tente mais tarde ou entre em contato com o suporte técnico. |
| 503 Service Unavailable | SlowDown | Solicitações muito frequentes. | Reduza a frequência de suas solicitações. |