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 de efemérides inválidas
Quando você carrega dados de efemérides para AWS Ground Station, eles passam por um fluxo de trabalho de validação assíncrona. Se a validação falhar, o status da efeméride mudará para. `INVALID` A mensagem de erro na [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)resposta fornece informações detalhadas para ajudar você a identificar e resolver o problema.
## Entendendo os erros de validação de efemérides
Quando uma efeméride falha na validação, a resposta da [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)API inclui dois campos para ajudar a diagnosticar o problema:
errorCode
Um código legível por máquina que identifica o erro de validação específico. Isso pode ser usado para tratamento de erros programáticos.
errorMessage
Uma descrição legível do erro de validação com detalhes específicos sobre o que deu errado e orientações sobre como corrigi-lo.
Exemplo de [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)resposta para uma efeméride inválida:
```
{
"ephemerisId": "abc12345-6789-def0-1234-567890abcdef",
"name": "My Invalid Ephemeris",
"status": "INVALID",
"creationTime": 1620254718.765,
"invalidReason": "METADATA_INVALID",
"errorCode": "OBJECT_NAME_MISSING",
"errorMessage": "Metadata field missing: OBJECT_NAME",
"suppliedData": {
"tle": {
"ephemerisData": "[...]"
}
}
}
```
## Erros comuns de validação para efemérides TLE
A seguir estão os erros de validação comuns encontrados ao fazer o upload de efemérides TLE:
Número de catálogo de satélites incompatível
*Erro:* “O número do catálogo do satélite presente nas efemérides não corresponde ao número do catálogo do satélite associado”
*Solução:* verifique se o número do ID/satellite catálogo NORAD em suas linhas TLE corresponde ao número do catálogo do satélite do seu satélite. Use `00000` para satélites sem um número de catálogo atribuído.
Movimento médio inválido
*Erro:* “O movimento médio das efemérides fornecidas difere muito das efemérides de referência mais recentes”
*Solução:* verifique se os dados do TLE estão corretos e representam uma órbita válida. A Ground Station usa efemérides do Space-Track como referência durante a validação.
## Erros comuns de validação para efemérides OEM
A seguir estão os erros comuns de validação encontrados ao fazer o upload de efemérides de OEM:
Quadro de referência inválido
*Erro:* “O REF\_FRAME não é suportado”
*Solução:* atualize seu arquivo OEM para usar um dos quadros de referência compatíveis: EME2000 ou ITRF2000.
Campos obrigatórios ausentes
*Erro:* “Campo de metadados ausente: INTERPOLAÇÃO”
*Solução:* adicione os campos INTERPOLATION e INTERPOLATION\_DEGREE à sua seção de metadados OEM. Eles são necessários AWS Ground Station para gerar ângulos precisos de apontamento da antena.
Sistema de horário não suportado
*Erro:* “O TIME\_SYSTEM não é suportado”
*Solução:* Certifique-se de que seu arquivo OEM use UTC como sistema de horário.
Versão OEM não suportada
*Erro:* “O CCSDS\_OEM\_VERS não é suportado”
*Solução:* Certifique-se de que seu arquivo OEM use o CCSDS OEM versão 2.0.
## Erros comuns de validação para efemérides de elevação de azimute
A seguir estão os erros de validação comuns encontrados ao carregar efemérides de elevação de azimute:
azimuth/elevation Dados ausentes
*Erro:* “Nenhum TimeAzEl campo estava presente em pelo menos um AzElSegment”
*Solução:* certifique-se de que cada segmento em seus dados de elevação de azimute contenha pelo menos um par com marcação temporal azimuth/elevation .
Faixa de ângulo de azimute inválida (graus)
*Erro:* “AzEl az deve ser maior ou igual a -180 e menor ou igual a 360 graus”
*Solução:* verifique se os ângulos de azimute estão dentro de [-180, 360] graus.
Faixa de ângulo de elevação inválida (graus)
*Erro:* "AzEl el deve ser maior ou igual a -90 e menor ou igual a 90 graus”
*Solução:* verifique se os ângulos de elevação estão dentro de [-90, 90] graus.
Faixa de ângulo de azimute inválida (radianos)
*Erro:* "AzEl az deve ser maior ou igual a -pi e menor ou igual a 2pi radianos”
*Solução:* verifique se os ângulos de azimute estão dentro de [-π, 2π] radianos.
Faixa de ângulo de elevação inválida (radianos)
*Erro:* "AzEl el deve ser maior ou igual a -pi/2 e menor ou igual a pi/2 radianos”
*Solução:* verifique se os ângulos de elevação estão dentro de [-π/2, π/2] radianos.
Valores de tempo não monotônicos
*Erro:* “Os TimeAzEl itens dentro de um AzElSegment devem estar temporariamente em ordem”
*Solução:* Certifique-se de que os valores de tempo em cada segmento estejam aumentando estritamente.
Segmentos fora de ordem
*Erro:* “AzElSegments deve estar temporariamente em ordem”
*Solução:* Certifique-se de que os segmentos estejam organizados em ordem cronológica.
Segmentos sobrepostos
*Erro:* “O intervalo de tempo de pelo menos um segmento se sobrepõe aos outros intervalos de tempo do segmento”
*Solução:* garanta que cada segmento tenha um intervalo de tempo exclusivo e sem sobreposição. O `endTime` de um segmento não deve exceder o `startTime` do próximo segmento.
## Etapas de solução de problemas
Se sua efeméride falhar na validação, siga estas etapas para resolver o problema:
1. Ligue [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)com seu ID de efeméride para recuperar o e. `errorCode` `errorMessage`
1. Revise a mensagem de erro para obter detalhes específicos sobre qual verificação de validação falhou.
1. Corrija os problemas identificados em seus dados de efemérides.
1. Faça o upload de uma nova efeméride com os dados corrigidos usando. [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html)
1. Monitore o novo status de efemérides até que ele atinja o estado. `ENABLED`
1. Exclua a efeméride inválida usando [DeleteEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DeleteEphemeris.html)se ela não for mais necessária.
## Referência completa do código de erro
As seções a seguir fornecem um mapeamento abrangente de todos os `errorCode` valores que podem ser retornados quando a validação de efemérides falha, organizado pela categoria de alto nível. `invalidReason`
### Motivo inválido: `METADATA_INVALID`
Esses erros ocorrem quando os campos de metadados obrigatórios estão ausentes, formatados incorretamente ou contêm valores não suportados nos dados de efemérides.
| Código de erro | Mensagem de erro |
| --- | --- |
| ID\_SATCAT\_ID INCOMPATÍVEL | O número do catálogo do satélite presente nas efemérides do TLE não corresponde ao número do catálogo do satélite associado |
| VERSÃO\_OEM NÃO SUPORTADA | As CCSDS\_OEM\_VERS efemérides do OEM não são suportadas. Valores suportados: [2.0] |
| ORIGINADOR\_AUSENTE | O campo do ORIGINATOR cabeçalho está ausente nas efemérides do OEM |
| FALTA\_DATA\_DE-CRIAÇÃO | O campo do CREATION\_DATE cabeçalho está ausente nas efemérides do OEM |
| NOME\_DO\_OBJETO\_AUSENTE | O campo de OBJECT\_NAME metadados está ausente nas efemérides do OEM |
| ID DO OBJETO AUSENTE | O campo de OBJECT\_ID metadados está ausente nas efemérides do OEM |
| REF\_FRAME\_NÃO SUPORTADO | As REF\_FRAME efemérides do OEM não são suportadas. Valores suportados: [EME2000,ITRF2000] |
| REF\_FRAME\_EPOCH\_NÃO SUPORTADO | O campo de REF\_FRAME\_EPOCH metadados nas efemérides do OEM não é suportado. Remova esse campo das efemérides |
| TIME\_SYSTEM\_NÃO SUPORTADO | As TIME\_SYSTEM efemérides do OEM não são suportadas. Valores suportados: [UTC] |
| CENTER\_BODY\_NÃO SUPORTADO | As CENTER\_BODY efemérides do OEM não são suportadas. Valores suportados: [Earth] |
| INTERPOLAÇÃO\_AUSENTE | O campo de INTERPOLATION metadados está ausente nas efemérides do OEM |
| GRAUS\_DE\_INTERPOLAÇÃO\_INVÁLIDO | O grau de interpolação nas efemérides do OEM deve ser maior que 0 para o método de interpolação |
| AZ\_EL\_SEGMENT\_LIST\_MISSING | O [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html)campo está faltando |
| TEMPO\_AZ\_INSUFICIENTE\_AZ\_EL | Nenhum [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)campo estava presente em pelo menos um [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html) |
### Motivo inválido: `TIME_RANGE_INVALID`
Esses erros ocorrem quando as efemérides contêm intervalos de tempo inválidos, incluindo problemas com start/end horários, ordenação de segmentos, segmentos sobrepostos ou inconsistências temporais.
| Código de erro | Mensagem de erro |
| --- | --- |
| HORÁRIO\_DE\_IN\_FUTURO | O horário de início das efemérides está no futuro, mas deve estar no passado |
| HORÁRIO DE TÉRMINO NO PASSADO | O fim do horário das efemérides está no passado, mas deve estar no futuro |
| TEMPO DE EXPIRAÇÃO MUITO CEDO | O tempo de expiração fornecido é anterior ao horário de término da efeméride |
| START\_TIME\_METADATA\_MUITO CEDO | O valor dos START\_TIME metadados é anterior ao primeiro momento presente nos dados de efemérides do OEM |
| STOP\_TIME\_METADATA\_MUITO TARDE | O valor dos STOP\_TIME metadados é posterior à última vez presente nos dados de efemérides do OEM |
| AZ\_EL\_SEGMENT\_END\_TIME\_BEFORE\_START\_TIME | O [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ISO8601TimeRange.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ISO8601TimeRange.html)de pelo menos um segmento de dados está antes do segmento [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ISO8601TimeRange.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ISO8601TimeRange.html) |
| AZ\_EL\_SEGMENT\_TIMES\_OVERLAP | O intervalo de tempo de pelo menos um segmento se sobrepõe aos outros intervalos de tempo do segmento |
| AZ\_EL\_SEGMENTS\_OUT\_OF\_ORDER | Os segmentos não estão ordenados temporalmente |
| TIME\_AZ\_EL\_ITEMS\_OUT\_OF\_ORDER | Os [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)itens dentro de um [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegment.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegment.html)devem estar temporariamente em ordem |
| AZ\_EL\_SEGMENT\_REFERENCE\_EPOCH\_INVÁLIDO | A época de referência para um segmento é inválida ou formatada incorretamente |
| AZ\_EL\_SEGMENT\_START\_TIME\_INVÁLIDO | A hora de início no intervalo de tempo válido de um segmento não começa após o primeiro segmento |
| AZ\_EL\_SEGMENT\_END\_TIME\_INVÁLIDO | A hora de término no intervalo de tempo válido de um segmento não termina após o último segmento |
| AZ\_EL\_SEGMENT\_VALID\_TIME\_RANGE\_INVÁLIDO | O intervalo de tempo válido para um segmento é inválido |
| AZ\_EL\_SEGMENT\_END\_TIME\_TOO\_LATE | A hora de término de um segmento excede a duração máxima permitida a partir da época de referência |
| AZ\_EL\_TOTAL\_DURATION\_EXCEDIDA | A duração total em todos os segmentos excede a duração máxima permitida do ângulo de apontamento |
### Motivo inválido: `TRAJECTORY_INVALID`
Esses erros ocorrem quando as efemérides contêm dados de trajetória inválidos, incluindo problemas com parâmetros orbitais, faixas de ângulos ou unidades.
| Código de erro | Mensagem de erro |
| --- | --- |
| MEAN\_MOTION\_INVÁLIDO | O movimento médio das efemérides TLE fornecidas difere muito das efemérides de referência mais recentes. Nota: A Ground Station usa efemérides do Space-Track como referência durante a validação |
| TIME\_AZ\_EL\_AZ\_RADIAN\_RANGE\_INVÁLIDO | AzEl [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)deve ser maior ou igual a -π e menor ou igual a 2π radianos |
| TIME\_AZ\_EL\_EL\_RADIAN\_RANGE\_INVÁLIDO | AzEl [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)deve ser maior ou igual a -π/2 e menor ou igual a π/2 radianos |
| TIME\_AZ\_EL\_AZ\_DEGREE\_RANGE\_INVÁLIDO | AzEl [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)deve ser maior ou igual a -180 e menor ou igual a 360 graus |
| TIME\_AZ\_EL\_EL\_DEGREE\_RANGE\_INVÁLIDO | AzEl [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)deve ser maior ou igual a -90 graus e menor ou igual a 90 graus |
| TIME\_AZ\_EL\_ANGLE\_UNITS\_INVÁLIDO | Unidades de AzEl ângulo inválidas |
### Motivo inválido: `KMS_KEY_INVALID`
Esses erros ocorrem quando há problemas com a chave do AWS Key Management Service (KMS) usada para criptografar os dados de efemérides.
| Código de erro | Mensagem de erro |
| --- | --- |
| PERMISSÕES\_KMS\_INSUFICIENTES | A Ground Station não tem permissões suficientes para acessar a chave KMS dessa efeméride |
### Motivo inválido: `VALIDATION_ERROR`
Esses erros ocorrem quando há problemas gerais de validação com os dados de efemérides que não se enquadram em outras categorias específicas.
| Código de erro | Mensagem de erro |
| --- | --- |
| INTERNAL\_ERROR | Ocorreu um erro interno durante a validação das efemérides |
| FORMATO\_DO\_ARQUIVO\_INVÁLIDO | O formato do arquivo de efemérides é inválido ou está corrompido. Verifique se o arquivo está em conformidade com o formato esperado para o tipo de efemérides |