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 [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)API, 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 [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)chamando 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](contacts.versioning.md)
## Erros de validação síncrona
Os erros a seguir são retornados diretamente na resposta HTTP quando a [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)solicitaçã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.
1. Confirme se você está usando as credenciais da AWS conta proprietária do contato.
1. Use [ListContacts](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListContacts.html)para encontrar o correto`contactId`.
### ConflictException: Não é possível atualizar o contato
**Causa comum**
O contato está em um estado que não permite atualizações. A [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)API só pode ser chamada quando o contato está no `PASS` estado `SCHEDULED``PREPASS`, 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 [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)para verificar o status atual do contato.
1. Se o contato estiver em um estado terminal (por exemplo,, `COMPLETED``FAILED`, ou`CANCELLED`), ele não poderá ser atualizado. Um contato só pode ser atualizado quando está no `PASS` estado `SCHEDULED``PREPASS`, ou. Para obter uma lista completa dos estados dos terminais, consulte[AWS Ground Station status de contato](contacts.lifecycle.md#contact-statuses).
1. 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 [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)API 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 vazio`clientToken`.
+ 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.
+ `satelliteArn`Definir como nulo sem ser aprovado para [efemérides de elevação de azimute na estação terrestre do contato](providing-azimuth-elevation-ephemeris-data.md).
+ Falta `AzElProgramTrackSettings` quando `satelliteArn` é nulo.
+ Fornecendo um `ephemerisId` que não esteja associado ao especificado`satelliteArn`.
+ 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](how-it-works.config.md#how-it-works.config-antenna-downlink-demod-decode) 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.
1. Certifique-se de fornecer exatamente um tipo de solicitação `ProgramTrackSettings` por solicitação.
1. Se estiver usando ângulos de azimuth/elevation apontamento sem um`satelliteArn`, 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](providing-azimuth-elevation-ephemeris-data.md).
1. 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 [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)cria 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 [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)para 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](https://console.aws.amazon.com/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](providing-custom-ephemeris-data.md). |
| 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](providing-azimuth-elevation-ephemeris-data.md) 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](https://console.aws.amazon.com/support) Como alternativa, considere usar dados de [efemérides TLE ou dados de efemérides](providing-tle-ephemeris-data.md) de [OEM, se eles se adequarem ao seu caso](providing-oem-ephemeris-data.md) de uso. |
| AZEL\_EPHEMERIS\_NOT\_FOUND | As [efemérides de elevação de azimute](providing-azimuth-elevation-ephemeris-data.md) 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](providing-azimuth-elevation-ephemeris-data.md) 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](providing-azimuth-elevation-ephemeris-data.md) 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](providing-azimuth-elevation-ephemeris-data.md) 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 ligar`UpdateContact`, a nova versão do contato começa no `UPDATING` estado. Durante esse período, [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)continua 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](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html).
Para determinar se uma atualização foi bem-sucedida ou falhou:
1. Ligue [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)com o `contactId` e `versionId` retorne pela `UpdateContact` resposta.
1. 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.
1. Se o status for`FAILED_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](https://docs.aws.amazon.com/cli/latest/reference/groundstation/wait/contact-updated.html). Use o garçom em vez de implementar sua própria lógica de pesquisa.