Códigos de erro comuns - Key Management Service: Central de Documentação do Alibaba Cloud

Quando uma solicitação à API do KMS falha, o KMS retorna um código de status HTTP e detalhes do erro no corpo da resposta. Os detalhes do erro são codificados no formato Protocol Buffers:

message Error {
     int32 StatusCode = 1;
     string ErrorCode = 2;
     string ErrorMessage = 3;
     string RequestId = 4;
}

Os códigos de erro a seguir se aplicam à maioria das operações do KMS. Algumas operações retornam códigos adicionais, descritos nos respectivos tópicos de referência da API.

400 Bad request

Código de erro	Mensagem de erro	Significado e como corrigir
`InvalidApiName`	The ApiName "\" is invalid.	O nome da API na solicitação não é reconhecido. Verifique e corrija o nome da API.
`InvalidApiVersion`	The ApiVersion "\" is invalid.	O campo de cabeçalho `x-kms-apiversion` está ausente na solicitação. Adicione-o ao cabeçalho da solicitação.
`InvalidParam`	The Param Date is invalid.	O valor do cabeçalho `Date` não está em conformidade com a RFC 1123. Atualize o cabeçalho `Date` para usar um valor compatível com a RFC 1123.
`InvalidParam`	The Param x-kms-signaturemethod is invalid.	O campo de cabeçalho `x-kms-signaturemethod` está ausente na solicitação. Adicione-o ao cabeçalho da solicitação.
`InvalidParam`	The Param x-kms-signaturemethod is invalid. message:"\".	O método de assinatura especificado em `x-kms-signaturemethod` não tem suporte. Use um método de assinatura compatível.
`MissingParameter`	Parameter x-kms-acccesskeyid does not exist in http header or body.	Nenhum AccessKeyID foi encontrado no cabeçalho `Authorization`. Adicione seu AccessKeyID ao cabeçalho `Authorization`. Se estiver usando SDKs da Alibaba Cloud, certifique-se de utilizar o KMS Instance SDK.
`RequestTimeTooSkewed`	Request time exceeds server time more than 15 minutes.	O timestamp da solicitação difere do horário do servidor em mais de 15 minutos. Sincronize o relógio do servidor e tente novamente.
`InvalidParameter`	The specified parameter is not valid.	Um valor de parâmetro é inválido. Verifique e corrija o valor do parâmetro.
`UnsupportedOperation`	Rejected.UnsupportedOperation	A operação solicitada não tem suporte. Para obter mais detalhes, consulte Perguntas frequentes sobre acesso a aplicações.

401 Unauthorized

Código de erro	Mensagem de erro	Significado e como corrigir
`SignatureNotMatch`	Signature is not matched.	A assinatura do cliente não corresponde à assinatura calculada pelo servidor. Use uma chave de cliente válida e tente novamente.

403 Forbidden

Código de erro	Mensagem de erro	Significado e como corrigir
`Forbidden.NoPermission`	This operation for "\" is forbidden by permission system.	Seu ponto de acesso à aplicação (AAP) não tem permissão para executar esta operação. Verifique as políticas de permissão do AAP. Para obter instruções, consulte Criar um AAP.

404 Not found

Código de erro	Mensagem de erro	Significado e como corrigir
`Forbidden.KeyNotFound`	The Key ID or Alias does not exist in the system.	A chave especificada não existe. Verifique o ID ou alias da chave e tente novamente.
`Forbidden.KeyNotFound`	The Key ID or Alias does not exist in the key store "\".	A chave especificada não existe no repositório de chaves informado. Verifique o nome do repositório de chaves e o ID ou alias da chave.
`Forbidden.KeyNotFound`	The specified key does not exist.	A chave especificada não existe. Verifique o ID ou alias da chave e tente novamente.
`Unauthorized`	The AccessKey ID "\" does not exist in our records.	O AccessKeyID não foi encontrado. O AccessKeyID corresponde ao valor `KeyId` no seu AAP. Verifique sua chave de cliente. Para obter instruções, consulte Criar um AAP.

409 Conflict

Esses erros ocorrem quando a chave está em um estado que não permite a operação solicitada.

Código de erro	Mensagem de erro	Estado da chave	Significado e como corrigir
`Rejected.PendingDeletion`	The request was rejected because the key state is PendingDeletion.	PendingDeletion	A chave está agendada para exclusão. Cancele a exclusão ou use uma chave diferente.
`Rejected.Disabled`	The request was rejected because the key state is Disabled.	Disabled	A chave está desativada. Reative a chave antes de usá-la.
`Rejected.PendingImport`	The request was rejected because the key state is PendingImport.	PendingImport	A chave aguarda a importação de material. Conclua a importação ou use uma chave diferente.

413 Request entity too large

Após a codificação de todos os parâmetros da solicitação no formato Protocol Buffers, o corpo da solicitação excede 3 MB.

Para evitar esse erro:

Criptografia e descriptografia: Mantenha os payloads abaixo de 6 KB para operações com chaves simétricas e abaixo de 1 KB para operações com chaves assimétricas. Para dados maiores, use criptografia de envelope.
Assinatura e verificação: Para mensagens grandes, gere um resumo (digest) da mensagem localmente e chame a operação Sign ou Verify com esse resumo.

415 Unsupported media type

Código de erro	Mensagem de erro	Significado e como corrigir
`InvalidContentType`	Content-Type "\" is unsupported.	O valor do cabeçalho `Content-Type` não tem suporte. Use o tipo de conteúdo correto para a solicitação.

500 Internal server error

Código de erro	Mensagem de erro	Significado e como corrigir
`InternalFailure`	Internal Failure.	Ocorreu um erro interno. Entre em contato com o suporte técnico da Alibaba Cloud. Para obter mais detalhes, consulte Fale conosco.

503 Service unavailable

Código de erro	Mensagem de erro	Significado e como corrigir
`ServiceUnavailableTemporary`	Service Unavailable Temporary.	O serviço está temporariamente indisponível. Tente novamente mais tarde.