Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2026-08-28 GMT+08:00

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.

Tabela 1 Elementos de resposta de erro

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.

Tabela 2 Códigos de erro

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.