Códigos de erro
Se uma chamada de API falhar, nenhum dado de resultado será retornado. Você pode localizar a causa do erro de acordo com o código de erro de cada API. Se uma chamada de API falhar, o código de status HTTP 3xx, 4xx ou 5xx é retornado. O corpo da resposta contém o código de erro e as informações específicas. Se você não conseguir localizar a causa de um erro, entre em contato com o serviço de suporte da HUAWEI CLOUD 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:
- Tipo de conteúdo: 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. Segue-se um exemplo de resposta de erro que mostra elementos comuns no corpo de resposta de erro Representational State Transfer (REST).
1 | <?xml version="1.0" encoding="UTF-8"?> <Error> <Code>NoSuchKey</Code> <Message>The resource you requested does not exist</Message> <Resource>/example-bucket/object</Resource> <RequestId>001B21A61C6C0000013402C4616D5285</RequestId> <HostId>RkRCRDJENDc5MzdGQkQ4OUY3MTI4NTQ3NDk2Mjg0M0FB QUFBQUFBYmJiYmJiYmJD</HostId> </Error> |
Tabela 1 descreve o significado de cada elemento.
| Elemento | Descrição |
|---|---|
| Error | Elemento raiz que descreve o erro em um corpo de resposta XML |
| Code | 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. |
| Message | Detalha o erro no corpo da resposta de erro XML. Para obter detalhes sobre mensagens de erro, consulte Tabela 2. |
| RequestId | ID da requisição cuja resposta de erro é retornada. O ID é usado para localizar o erro. |
| HostId | ID do servidor que retorna uma resposta de erro |
| Resource | Bucket 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 OBS encontrar um erro ao processar uma solicitação, uma resposta contendo o código de erro e a descrição será retornada. Tabela 2 descreve os códigos de erro do OBS.
| Código de status | Código de erro | Mensagem de erro | Solução |
|---|---|---|---|
| 301 Moved Permanently | PermanentRedirect | O intervalo solicitado pode ser acessado somente por meio do 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 intervalo 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 intervalo. | O sistema redireciona automaticamente a solicitação ou envia a solicitação para o endereço de redirecionamento. |
| 400 Bad Request | BadDigest | O valor especificado de Content-MD5 não corresponde ao valor recebido pelo OBS. | Verifique se o valor MD5 transportado no cabeçalho é o mesmo que o calculado pelo corpo da mensagem. |
| 400 Bad Request | BadDomainName | O nome do 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 | CustomDomainAreadyExist | O domínio configurado já existe. | Ele foi configurado e não precisa ser configurado novamente. |
| 400 Bad Request | CustomDomainNotExist | Exclua o domínio que não existe. | Não está configurado ou foi excluído. Você não precisa excluí-lo. |
| 400 Bad Request | EntityTooLarge | O tamanho do objeto carregado usando o método POST excede o limite superior. | Modifique as condições especificadas na política ao publicar o objeto ou reduza o tamanho do objeto. |
| 400 Bad Request | EntityTooSmall | O tamanho do objeto carregado usando o método POST não atinge o limite inferior. | Modifique as condições especificadas na política ao postar o objeto ou aumente o tamanho do objeto. |
| 400 Bad Request | IllegalLocationConstraintException | Uma solicitação sem Location é enviada para a criação de um bucket em uma região não padrão. | Envie a solicitação de criação do bucket para a região padrão ou envie a solicitação com o Location da região não padrão. |
| 400 Bad Request | IncompleteBody | Nenhum corpo de solicitação completo é recebido devido a problemas de rede ou outros. | Carregue o objeto novamente. |
| 400 Bad Request | IncorrectNumberOfFilesInPost Request | Cada solicitação POST deve conter um arquivo a ser carregado. | Leve um arquivo a ser carregado. |
| 400 Bad Request | InvalidArgument | Parâmetro inválido. | Modifique o parâmetro de acordo com os detalhes do erro no corpo da mensagem. |
| 400 Bad Request | InvalidBucket | O bucket a ser acessado não existe. | Altere o nome do bucket. |
| 400 Bad Request | InvalidBucketName | O nome do intervalo especificado na solicitação é inválido, que pode ter excedido o comprimento máximo ou conter caracteres especiais que não são permitidos. | Altere o nome do bucket. |
| 400 Bad Request | InvalidEncryptionAlgorithmError | Algoritmo encriptação incorreto. O objeto não pode ser descriptografado devido ao cabeçalho de encriptação incorreto realizado ao baixar o objeto criptografado SSE-C. | Carregue o cabeçalho de encriptação correto ao baixar o objeto. |
| 400 Bad Request | InvalidLocationConstraint | O Location especificado na solicitação de criação do intervalo é inválido ou não existe. | Corrija o Location na solicitação de criação do bucket. |
| 400 Bad Request | InvalidPart | Uma ou mais peças especificadas não são encontradas. As peças não podem ser carregadas ou as tags de entidade especificadas (as ETag) não correspondem às ETag das peças. | Mesclar as peças corretamente de acordo com as ETag. |
| 400 Bad Request | InvalidPartOrder | As peças não são listadas em ordem crescente por número de peça. | Classifique as partes em ordem crescente e mescle-as novamente. |
| 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 | Localização de redirecionamento inválida. | Especifica o endereço IP correto. |
| 400 Bad Request | InvalidRequest | Pedido inválido. | Modifique o parâmetro 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 da mensagem, mas nenhum corpo da mensagem é carregado. | Carregue o corpo da mensagem no formato correto. |
| 400 Bad Request | InvalidTargetBucketForLogging | O grupo de entrega não tem permissão ACL para o intervalo de destino. | Configure a ACL do bucket de destino e tente novamente. |
| 400 Bad Request | KeyTooLongError | A chave fornecida é muito longa. | Use uma tecla mais curta. |
| 400 Bad Request | KMS.DisabledException | A chave mestra do cliente (CMK) é desabilitada no modo SSE-KMS. | Substitua a chave e tente novamente ou entre em contato com o suporte técnico. |
| 400 Bad Request | KMS.NotFoundException | A chave mestra do cliente (CMK) não existe no modo SSE-KMS. | Tente novamente com o CMK correto. |
| 400 Bad Request | MalformedACLError | O arquivo XML fornecido está em um formato incorreto ou não atende aos requisitos de formato. | Use o formato XML correto para tentar novamente. |
| 400 Bad Request | MalformedError | O formato XML na solicitação está incorreto. | Use o formato XML correto para tentar novamente. |
| 400 Bad Request | MalformedLoggingStatus | O formato XML do Logging está incorreto. | Use o formato XML correto para tentar novamente. |
| 400 Bad Request | MalformedPolicy | A política de bucket não existe. | Modifique a política do intervalo de acordo com os detalhes do erro retornados no corpo da mensagem. |
| 400 Bad Request | MalformedQuotaError | O formato XML de 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á no formato incorreto. | Use o formato XML correto para tentar novamente. |
| 400 Bad Request | MaxMessageLengthExceeded | Copiar um objeto não requer um corpo de mensagem na solicitação. | Remova o corpo da mensagem e tente novamente. |
| 400 Bad Request | MetadataTooLarge | O tamanho do cabeçalho de metadados excedeu o limite superior. | 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. | Leve as informações da região na solicitação. |
| 400 Bad Request | MissingRequestBodyError | Este código de erro é devolvido depois de enviar um ficheiro XML vazio. | Forneça o arquivo XML correto. |
| 400 Bad Request | MissingRequiredHeader | Cabeçalhos obrigatórios estão faltando na solicitação. | Forneça os cabeçalhos necessários. |
| 400 Bad Request | MissingSecurityHeader | Um cabeçalho obrigatório não é fornecido. | Forneça os cabeçalhos necessários. |
| 400 Bad Request | TooManyBuckets | Você tentou criar mais buckets do que o permitido. | Exclua alguns buckets e tente novamente. |
| 400 Bad Request | TooManyCustomDomains | Muitas contas de usuário estão configuradas. | Exclua algumas contas de usuário e tente novamente. |
| 400 Bad Request | TooManyWrongSignature | A solicitação é rejeitada devido a erros de alta frequência. | Substitua a Chave de Acesso e tente novamente. |
| 400 Bad Request | UnexpectedContent | O pedido requer um corpo da mensagem que não é transportado pelo cliente, ou o pedido não requer um corpo da mensagem, mas o cliente carrega o corpo da mensagem. | Tente novamente de acordo com as instruções. |
| 400 Bad Request | UserKeyMustBeSpecified | Esta operação está disponível apenas para usuários específicos. | Entre em contato com o suporte técnico. |
| 400 Bad Request | ContentSHA256Mismatch | O valor SHA-256 do objeto calculado pelo cliente é diferente do calculado pelo servidor. | Verifique se o valor de SHA-256 calculado pelo cliente está correto. |
| 403 Forbidden | AccessDenied | Acesso negado, porque a solicitação não carrega um cabeçalho de data ou o formato do cabeçalho está incorreto. | Forneça um cabeçalho de data correto na solicitação. |
| 403 Forbidden | AccessForbidden | Permissão insuficiente. Não existe nenhuma configuração CORS para o bucket ou a regra CORS não corresponde. | Modifique a configuração CORS do intervalo ou envie a solicitação OPTIONS correspondente com base na configuração CORS do intervalo. |
| 403 Forbidden | AllAccessDisabled | Você não possui permissão para realizar esta operação. O nome do bucket é proibido. | Altere o nome do bucket. |
| 403 Forbidden | DeregisterUserId | O usuário foi desregistrado. | Carregar ou recadastrar. |
| 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. | Top para cima. |
| 403 Forbidden | InsufficientStorageSpace | Espaço de armazenamento insuficiente. | Se a cota for excedida, aumente a cota ou exclua alguns objetos. |
| 403 Forbidden | InvalidAccessKeyId | O ID da chave de acesso fornecido pelo cliente não existe no sistema. | Forneça a identificação correta da chave de acesso. |
| 403 Forbidden | InvalidObjectState | Você precisa restaurar os objetos do Arquivo antes de baixá-los. | Restaure o objeto primeiro. |
| 403 Forbidden | NotSignedUp | Sua conta não foi registrada no sistema. Apenas uma conta registrada pode ser usada. | Inscreva-se no OBS. |
| 403 Forbidden | RequestTimeTooSkewed | Houve um grande offset de tempo entre a hora do servidor OBS e a hora em que o cliente iniciou uma solicitação. Para fins de segurança, o OBS verifica o offset de tempo entre o cliente e o servidor. Se o offset for maior que 15 minutos, o servidor OBS rejeitará suas solicitações e essa mensagem de erro será relatada. | Verifique se há um grande offset de tempo entre a hora do cliente e a hora 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 OBS. | Verifique a chave de acesso secreta e o algoritmo de assinatura. Para obter detalhes, consulte Por que as assinaturas não coincidem? |
| 403 Forbidden | VirtualHostDomainRequired | O nome de domínio de acesso à hospedagem virtual não é usado. | Use o nome de domínio de acesso à hospedagem virtual. Para mais detalhes, consulte Construção de uma solicitação. |
| 403 Forbidden | Unauthorized | O usuário não foi autenticado em nome real. | Autentique o nome real do usuário e tente novamente. |
| 404 Not Found | NoSuchBucket | O bucket especificado não existe. | Crie um bucket e execute a operação novamente. |
| 404 Not Found | NoSuchBucketPolicy | Não existe nenhuma política de bucket. | Configurar uma política de bucket. |
| 404 Not Found | NoSuchCORSConfiguration | Nenhuma configuração de CORS existe. | Configure o CORS primeiro. |
| 404 Not Found | NoSuchCustomDomain | A conta de usuário solicitada não existe. | Defina uma conta de usuário primeiro. |
| 404 Not Found | NoSuchKey | A chave especificada não existe. | Carregue o objeto primeiro. |
| 404 Not Found | NoSuchLifecycleConfiguration | A regra de ciclo de vida solicitada não existe. | Configure uma regra de ciclo de vida primeiro. |
| 404 Not Found | NoSuchUpload | O carregamento multiparte especificado não existe. O ID de carregamento não existe ou o carregamento multiparte foi encerrado ou concluído. | Use a peça existente ou reinicializar a peça. |
| 404 Not Found | NoSuchVersion | A ID de versão especificada não corresponde a nenhuma versão existente. | Use um ID de versão correto. |
| 404 Not Found | NoSuchWebsiteConfiguration | O site solicitado não existe. | Configure o site primeiro. |
| 405 Method Not Allowed | MethodNotAllowed | O método especificado não é permitido contra o recurso solicitado. A mensagem "O método especificado não é suportado." é retornada. | O método não é permitido. |
| 408 Request Timeout | RequestTimeout | A conexão de socket 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 bucket solicitado já existe. O namespace do intervalo é compartilhado por todos os usuários do OBS. Selecione outro nome e tente novamente. | Altere o nome do bucket. |
| 409 Conflict | BucketAlreadyOwnedByYou | Sua solicitação anterior para criar o intervalo homônimo foi bem-sucedida e você já o possui. | Não é necessário criar mais buckets. |
| 409 Conflict | BucketNotEmpty | O bucket que você tentou excluir não está vazio. | Exclua os objetos no bucket e, em seguida, exclua o bucket. |
| 409 Conflict | InvalidBucketState | Status do bucket inválido. Após a configuração da replicação entre regiões, o versionamento do bucket não pode ser desativado. | Ative o versionamento do bucket ou cancele a replicação entre regiões. |
| 409 Conflict | OperationAborted | Uma operação conflitante está em execução neste recurso. Tente novamente mais tarde. | Tente novamente mais tarde. |
| 409 Conflict | ServiceNotSupported | O método de requisição não é suportado pelo servidor. | Não suportado pelo servidor. Entre em contato com o suporte técnico. |
| 411 Length Required | MissingContentLength | O cabeçalho HTTP Content-Length não é fornecido. | Forneça o cabeçalho Content-Length. |
| 412 Precondition Failed | PreconditionFailed | Pelo menos uma das pré-condições especificadas não é atendida. | Modifique de acordo com o prompt de condição no corpo da mensagem retornada. |
| 416 Client Requested Range Not Satisfiable | InvalidRange | O intervalo solicitado não pode ser obtido. | Tente novamente com o intervalo correto. |
| 500 Internal Server Error | InternalError | Ocorre 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. | Não suportado no momento. Entre em contato com o suporte técnico. |
| 503 Service Unavailable | ServiceUnavailable | O servidor está sobrecarregado ou tem erros internos. | Tente mais tarde ou entre em contato com o suporte técnico. |
| 503 Service Unavailable | SlowDown | Pedidos muito frequentes. Reduza a frequência de solicitação. | Pedidos muito frequentes. Reduza a frequência de solicitação. |
| Código de status | Código de erro | Mensagem de erro | Solução |
|---|---|---|---|
| 500 Internal Server Error | SYS.0001 | Erro de serviço interno. | Entre em contato com o suporte técnico. |
| 404 Not Found | SYS.0003 | API não suportada. | Use outra API. |
| 401 Unauthorized | SYS.0004 | Solicitação não autenticada. | Entre em contato com o suporte técnico. |
| 403 Forbidden | SYS.0005 | Sem permissão de acesso. | Entre em contato com o suporte técnico. |
| 400 Bad Request | SYS.0006 | Formato de solicitação incorreto. | Verifique o formato da solicitação. |
| 400 Bad Request | SYS.0007 | Solicitação inválida para download de intervalo. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0008 | O token expirou. | Use um token válido. |
| 431 Request Header Fields Too Large | SYS.0009 | O número de cabeçalhos na solicitação HTTP excede o limite superior. | Reduza o número de cabeçalhos na solicitação HTTP. |
| 400 Bad Request | SYS.0010 | Parâmetros de solicitação inválidos. | Verifique os parâmetros da solicitação. |
| 429 Too Many Requests | SYS.0011 | O número de solicitações excedeu o limite superior. | Reduzir o número de solicitações. |
| 400 Bad Request | SYS.0012 | O corpo da solicitação é superdimensionado. | Reduza o tamanho do corpo da solicitação. |
| 403 Forbidden | SYS.0013 | A atualização de token é necessária devido a alterações de permissão. | Atualize o token. |
| 404 Not Found | SYS.0014 | O bucket não existe. | Tente com outro nome de bucket. |
| 404 Not Found | SYS.0015 | O objeto não existe. | Tente com outro nome de objeto. |
| 500 Erro de servidor interno | SYS.0016 | OBS access error. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0018 | Erro de solicitação interna. Possíveis causas: formato de solicitação incorreto ou desconexão da rede. | Verifique o formato da solicitação e a conectividade de rede. |
| 500 Internal Server Error | SYS.0019 | Falha ao acessar a política de bucket. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0020 | Falha ao acessar o serviço de gerenciamento de tarefas em segundo plano. | Entre em contato com o suporte técnico. |
| 403 Forbidden | SYS.0021 | Conta restrita. | Carregue sua conta. |
| 403 Forbidden | SYS.0022 | A conta está congelada. | Carregue ou registre uma nova conta. |
| 400 Bad Request | SYS.0023 | Região incorreta. | Tente com outro nome de região. |
| 500 Internal Server Error | SYS.0024 | Falha ao acessar um serviço autorizado. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0025 | Conteúdo de resposta incorreto. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0026 | Conteúdo de resposta de leitura incorreto. | Entre em contato com o suporte técnico. |
| 400 Bad Request | SYS.0027 | A agência não tem nenhuma permissão. | Entre em contato com o suporte técnico. |
| 400 Bad Request | SYS.0028 | A agência não existe. | Tente com outra agência. |
| 400 Bad Request | SYS.0029 | Nome de domínio da região OBS inválido. | Tente com outro nome de domínio de região OBS. |
| 400 Bad Request | SYS.0030 | O nome de domínio da região OBS não corresponde. | Tente com outro nome de domínio de região OBS. |
| 500 Internal Server Error | SYS.0031 | Falha ao autorizar o OBS a criar automaticamente uma agência. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0032 | Falha ao autorizar o OBS a modificar automaticamente uma agência. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0033 | Falha ao conceder ao OBS a criação automática de permissões personalizadas. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0034 | Falha ao conceder ao OBS para consultar automaticamente permissões personalizadas. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0035 | Falha ao conceder ao OBS para atualizar automaticamente permissões personalizadas. | Entre em contato com o suporte técnico. |
| 400 Bad Request | SYS.0036 | ID de projeto inválida. | Tente com outro ID de projeto. |
| 400 Bad Request | SYS.0037 | Insuficientes permissões concedidas à agência. | Entre em contato com o suporte técnico. |
| 400 Bad Request | SYS.0038 | O download multi-range não é suportado. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0039 | ID da conta inválido. | Insira a ID de locatário correta. |
| 500 Internal Server Error | SYS.0040 | Ocorreu um erro ao inicializar o cliente SDK. | Entre em contato com o suporte técnico. |
| 400 Bad Request | SYS.0041 | Falha ao substituir o parâmetro magic. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0042 | Tempo limite de processamento do servidor. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0043 | Falha ao desserializar a cadeia de caracteres JSON. | Entre em contato com o suporte técnico. |
| 500 Internal Server Error | SYS.0044 | Ocorreu um erro ao obter o status do cache interno. | Entre em contato com o suporte técnico. |
