View a markdown version of this page

Solucionar problemas nas atualizações de contatos - AWS Ground Station
Erros de validação síncronaCódigos de falha assíncronosVerificando o status de uma atualização

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solucionar problemas nas atualizações de contatos

Quando você chama a UpdateContactAPI, AWS Ground Station executa a validação síncrona na solicitação. Se a validação for aprovada, a atualização será processada de forma assíncrona para propagar as alterações na região da antena. Os erros de validação síncrona são retornados diretamente na resposta HTTP. Falhas assíncronas são failureCodes relatadas por meio de failureMessage campos na versão do contato, que você pode ver DescribeContactVersionchamando a versão que não foi atualizada.

Para obter mais informações sobre controle de versão de contatos, consulte. Atualizar contatos e controle de versão de contatos

Erros de validação síncrona

Os erros a seguir são retornados diretamente na resposta HTTP quando a UpdateContactsolicitação falha na validação.

ResourceNotFoundException: Contato não encontrado

Causa comum

O especificado contactId não existe ou pertence a uma AWS conta diferente.

Resolução

  1. Verifique se o contactId está correto.

  2. Confirme se você está usando as credenciais da AWS conta proprietária do contato.

  3. Use ListContactspara encontrar o corretocontactId.

ConflictException: Não é possível atualizar o contato

Causa comum

O contato está em um estado que não permite atualizações. A UpdateContactAPI só pode ser chamada quando o contato está no PASS estado SCHEDULEDPREPASS, ou. Esse erro também ocorre se outra atualização já estiver em andamento (a versão mais recente do contato está no UPDATING estado).

Resolução

  1. Ligue DescribeContactpara verificar o status atual do contato.

  2. Se o contato estiver em um estado terminal (por exemplo,, COMPLETEDFAILED, ouCANCELLED), ele não poderá ser atualizado. Um contato só pode ser atualizado quando está no PASS estado SCHEDULEDPREPASS, ou. Para obter uma lista completa dos estados dos terminais, consulteAWS Ground Station status de contato.

  3. Se outra atualização estiver em andamento, aguarde até que a atualização atual alcance ACTIVE ou o FAILED_TO_UPDATE status antes de enviar outra atualização. Você pode pesquisar a DescribeContactVersionAPI ou usar os utilitários de conveniência do ContactUpdated garçom fornecidos por some e o. AWS SDKs AWS Command Line Interface

InvalidParameterException: parâmetros de solicitação inválidos

Causa comum

A solicitação contém parâmetros inválidos. As causas comuns incluem:

  • Ausente ou vazioclientToken.

  • Vários tipos de ProgramTrackSettings (azimute/elevação, OEM e TLE) incluídos em uma única solicitação. Somente um tipo é permitido por solicitação.

  • satelliteArnDefinir como nulo sem ser aprovado para efemérides de elevação de azimute na estação terrestre do contato.

  • Falta AzElProgramTrackSettings quando satelliteArn é nulo.

  • Fornecendo um ephemerisId que não esteja associado ao especificadosatelliteArn.

  • O satélite não tem uma janela de visibilidade válida da estação terrestre para o intervalo de tempo de contato.

  • O satélite não está embarcado na estação terrestre ou não tem o licenciamento exigido pelo perfil da missão.

  • O perfil da missão inclui Configuração de decodificação de demodulação de downlink de antena configurações que não são compatíveis com atualizações de contatos.

Resolução

  1. Examine a mensagem de erro na resposta para obter detalhes sobre qual parâmetro é inválido.

  2. Certifique-se de fornecer exatamente um tipo de solicitação ProgramTrackSettings por solicitação.

  3. Se estiver usando ângulos de azimuth/elevation apontamento sem umsatelliteArn, confirme se sua conta foi aprovada para esse recurso na estação terrestre. Para obter mais informações, consulte Forneça dados de efemérides de elevação de azimute.

  4. Verifique se as efemérides referenciadas estão associadas ao satélite correto e cobrem o intervalo de tempo de contato.

ResourceLimitExceededException: limite máximo de versão atingido

Causa comum

O contato atingiu o número máximo de versões (128). Cada chamada para UpdateContactcria uma nova versão, e um contato não pode exceder esse limite.

Resolução

  1. Este limite não pode ser aumentado. Se precisar fazer mais alterações, cancele o contato e reserve um novo.

Códigos de falha assíncronos

Os códigos de falha a seguir aparecem no failureCodes campo de uma versão de contato com um FAILED_TO_UPDATE status. Use DescribeContactVersionpara recuperar esses detalhes. O failureMessage campo fornece contexto adicional sobre a falha.

Código de falha Causa comum Resolução
INTERNAL_ERROR Ocorreu um erro interno inesperado ao processar a atualização. Tente fazer a atualização novamente. Se o problema persistir, entre em contato com o AWS Support.
INVALID_SATELLITE_ARN O ARN do satélite fornecido na solicitação de atualização não é válido ou não existe. Verifique o ARN do satélite e confirme se o satélite está registrado em sua conta.
INVALID_UPDATE_CONTACT_REQUEST A solicitação de atualização contém parâmetros inválidos que não foram detectados durante a validação síncrona. Revise failureMessage os detalhes e corrija os parâmetros da solicitação.
EPHEMERIS_NOT_FOUND As efemérides referenciadas nas substituições de rastreamento não existem. Verifique ephemerisId e confirme se as efemérides não foram excluídas.
EPHEMERIS_TIME_RANGE_INVALID As efemérides não cobrem o intervalo de tempo do contato. Faça o upload de uma nova efeméride que cubra todo o intervalo de tempo de contato. Se o intervalo de tempo das efemérides não puder ser estendido, cancele o contato e reserve um novo durante o período das efemérides. Para obter mais informações, consulte Forneça dados de efemérides personalizados.
EPHEMERIS_NOT_ENABLED A efeméride referenciada não está em um estado. ENABLED Verifique o status das efemérides e ative-o antes de tentar novamente a atualização.
SATELLITE_DOES_NOT_MATCH_EPHEMERIS A efeméride não está associada ao satélite especificado na solicitação de atualização. Certifique-se de que ephemerisId pertence ao satélite especificado emsatelliteArn.
NOT_ONBOARDED_TO_AZEL_EPHEMERIS Sua conta não foi aprovada para usar dados de efemérides de elevação de azimute na estação terrestre do contato. A efeméride de elevação de azimute é um recurso restrito disponível para um número limitado de casos de uso especializados. Se efemérides de elevação de azimute forem necessárias para seu caso de uso, abra um AWS Support ticket por meio do para solicitar acesso. AWS Support Center Console Como alternativa, considere usar dados de efemérides TLE ou dados de efemérides de OEM, se eles se adequarem ao seu caso de uso.
AZEL_EPHEMERIS_NOT_FOUND As efemérides de elevação de azimute referenciadas na solicitação não existem. Verifique ephemerisId e confirme se as efemérides de elevação do azimute não foram excluídas.
AZEL_EPHEMERIS_WRONG_GROUND_STATION A efeméride de elevação do azimute foi criada para uma estação terrestre diferente daquela usada pelo contato. Faça upload de uma nova efeméride de elevação de azimute para a estação terrestre correta ou use uma efeméride existente que corresponda à estação terrestre do contato.
AZEL_EPHEMERIS_INVALID_STATUS As efemérides de elevação do azimute não estão em um estado válido para uso. Verifique o status das efemérides. Deve estar em um ENABLED estado. Se a efeméride falhar na validação, faça o upload de uma versão corrigida.
AZEL_EPHEMERIS_TIME_RANGE_INVALID As efemérides de elevação do azimute não cobrem o intervalo de tempo do contato. Faça o upload de uma nova efeméride de elevação de azimute que cubra toda a faixa de tempo de contato. Se o intervalo de tempo das efemérides não puder ser estendido, cancele o contato e reserve um novo durante o período das efemérides.

Verificando o status de uma atualização

Depois de ligarUpdateContact, a nova versão do contato começa no UPDATING estado. Durante esse período, DescribeContactcontinua retornando a versão anteriormente ativa do contato. A nova versão não aparece DescribeContact até ser propagada para a antena e atingir ACTIVE o status. Para verificar o status de uma versão específica, use DescribeContactVersion.

Para determinar se uma atualização foi bem-sucedida ou falhou:

  1. Ligue DescribeContactVersioncom o contactId e versionId retorne pela UpdateContact resposta.

  2. Verifique o version.status campo. Um status de ACTIVE significa que a atualização foi aplicada com sucesso. Um status de FAILED_TO_UPDATE significa que a atualização falhou.

  3. Se o status forFAILED_TO_UPDATE, verifique os version.failureMessage campos version.failureCodes e para obter detalhes sobre o que deu errado.

dica

Alguns AWS SDKs e outros AWS Command Line Interface apoiam um ContactUpdated garçom que faz pesquisas automaticamente DescribeContactVersion até que a versão alcance ACTIVE nosso status. FAILED_TO_UPDATE Por exemplo, ele AWS Command Line Interface fornece um comando aws groundstation wait contact-updated. Use o garçom em vez de implementar sua própria lógica de pesquisa.