Cloud Control API:Solução de problemas

Identifique as causas e soluções para os códigos de erro mais comuns da Cloud Control API.

Códigos de erro de runtime de produtos em nuvem

As APIs dos produtos em nuvem retornam estes códigos de erro durante a execução.

Os dois códigos de erro a seguir referem-se a erros de runtime de produtos em nuvem. Analise o campo Message para obter informações detalhadas sobre o erro. A estrutura do Message é a seguinte:

OperationFailure.OperationFailed

Causa: O produto em nuvem downstream retornou um erro e a operação falhou completamente.

Solução: Analise a mensagem de erro e use o código de erro do produto em nuvem para identificar a causa raiz.

{
     "requestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
     "Code": "OperationFailure.OperationFailed",
     "Message": "{
          "requestId":"432654B9-BB7F-3AE6-76CF-A5DC0DE9****",
          "errorCode": "MissingName",
          "errorMsg": "Name is mandatory for this action."
     }"
}

OperationFailure.PartialOperationFailed

Causa: O produto em nuvem downstream retornou um erro e a operação falhou parcialmente.

Solução: Analise a mensagem de erro e use o código de erro do produto em nuvem para identificar a causa raiz.

Após uma falha parcial, chame GetResource para verificar o status mais recente do recurso. Se necessário, chame UpdateResource ou DeleteResource para corrigir o problema.

{
     "requestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
     "Code": "OperationFailure.PartialOperationFailed",
     "Message": "{
          "requestId":"432654B9-BB7F-3AE6-76CF-A5DC0DE9****",
          "errorCode": "InvalidRamUser.NoPermission",
          "errorMsg": "Ram user is not authorized to perform the operation."
     }"
}

Códigos de erro da Cloud Control

O serviço da Cloud Control API retorna estes códigos de erro.

InvalidRamUser.NoPermission

Causa: O usuário do Resource Access Management (RAM) não tem autorização do RAM para a Cloud Control API.

Solução: Conceda permissões da Cloud Control API ao usuário do RAM atribuindo uma política de sistema ou autorizando a API específica.

InvalidRamRole.NoPermission

Causa: A função do RAM não tem autorização do RAM para a Cloud Control API.

Solução: Conceda permissões da Cloud Control API à função do RAM atribuindo uma política de sistema ou autorizando a API específica.

InvalidResourceType.NotFound

Causa: O tipo de recurso inserido não existe ou não é compatível.

Solução: Verifique se o tipo de recurso está escrito corretamente e se consta na lista de tipos compatíveis.

InvalidOperation.NotSupported

Causa: O recurso não é compatível com esta operação. Por exemplo, alguns recursos não aceitam operações de atualização ou exclusão.

Solução: Não execute esta operação.

InvalidParameter.RequiredNotExisted

Causa: Um parâmetro obrigatório está ausente nas propriedades do recurso.

Solução: Adicione a propriedade ausente conforme indicado na mensagem de erro e chame a API novamente.

InvalidParameter.EnumCheckFailure

Causa: O valor de um parâmetro não está dentro do intervalo de enumeração especificado.

Solução: Ajuste o valor da propriedade para um valor permitido, conforme indicado na mensagem de erro.

InvalidOperation.InvalidTaskStatus

Causa: Não é possível cancelar a tarefa porque seu status não é Pending nem Running.

Solução: Não é necessário cancele esta tarefa.

InvalidOperation.TaskNotCompleted

Causa: Uma tarefa assíncrona incompleta está em execução no recurso.

Solução: Aguarde a conclusão da tarefa assíncrona em andamento. Se ela tiver atingido o tempo limite, cancele-a primeiro e depois execute a próxima operação no recurso.

InvalidRegion.NotFound

Causa: O produto em nuvem não é compatível com a região especificada.

Solução: Especifique uma região compatível e chame a API novamente.

Throttling, Throttling.Api e Throttling.User

Causa: Seu tráfego neste período excedeu o limite.

Solução: Caso o limite atual não atenda aos requisitos do seu negócio, envie um ticket para solicitar um aumento.

InternalError

Causa: Ocorreu um erro interno no serviço da Cloud Control API.

Solução: Tente executar a operação novamente. Se o erro persistir após várias tentativas, envie um ticket.

ServiceUnavailable

Causa: O serviço da Cloud Control API está indisponível.

Solução: Tente executar a operação novamente. Se o erro persistir após várias tentativas, envie um ticket.