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 de validação comuns encontrados ao fazer o upload de efemérides de OEM:
Quadro de referência inválido
*Erro:* “O REF\$1FRAME 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\$1DEGREE à 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\$1SYSTEM 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\$1OEM\$1VERS 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\$1SATCAT\$1ID 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\$1OEM NÃO SUPORTADA | As CCSDS\$1OEM\$1VERS efemérides do OEM não são suportadas. Valores suportados: [2.0] |
| ORIGINADOR\$1AUSENTE | O campo do ORIGINATOR cabeçalho está ausente nas efemérides do OEM |
| FALTA\$1DATA\$1DE-CRIAÇÃO | O campo do CREATION\$1DATE cabeçalho está ausente nas efemérides do OEM |
| NOME\$1DO\$1OBJETO\$1AUSENTE | O campo de OBJECT\$1NAME metadados está ausente nas efemérides do OEM |
| ID DO OBJETO AUSENTE | O campo de OBJECT\$1ID metadados está ausente nas efemérides do OEM |
| REF\$1FRAME\$1NÃO SUPORTADO | As REF\$1FRAME efemérides do OEM não são suportadas. Valores suportados: [EME2000,ITRF2000] |
| REF\$1FRAME\$1EPOCH\$1NÃO SUPORTADO | O campo de REF\$1FRAME\$1EPOCH metadados nas efemérides do OEM não é suportado. Remova esse campo das efemérides |
| TIME\$1SYSTEM\$1NÃO SUPORTADO | As TIME\$1SYSTEM efemérides do OEM não são suportadas. Valores suportados: [UTC] |
| CENTER\$1BODY\$1NÃO SUPORTADO | As CENTER\$1BODY efemérides do OEM não são suportadas. Valores suportados: [Earth] |
| INTERPOLAÇÃO\$1AUSENTE | O campo de INTERPOLATION metadados está ausente nas efemérides do OEM |
| GRAUS\$1DE\$1INTERPOLAÇÃO\$1INVÁLIDO | O grau de interpolação nas efemérides do OEM deve ser maior que 0 para o método de interpolação |
| AZ\$1EL\$1SEGMENT\$1LIST\$1MISSING | 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\$1AZ\$1INSUFICIENTE\$1AZ\$1EL | 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\$1DE\$1IN\$1FUTURO | 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\$1TIME\$1METADATA\$1MUITO CEDO | O valor dos START\$1TIME metadados é anterior ao primeiro momento presente nos dados de efemérides do OEM |
| STOP\$1TIME\$1METADATA\$1MUITO TARDE | O valor dos STOP\$1TIME metadados é posterior à última vez presente nos dados de efemérides do OEM |
| AZ\$1EL\$1SEGMENT\$1END\$1TIME\$1BEFORE\$1START\$1TIME | 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\$1EL\$1SEGMENT\$1TIMES\$1OVERLAP | O intervalo de tempo de pelo menos um segmento se sobrepõe aos outros intervalos de tempo do segmento |
| AZ\$1EL\$1SEGMENTS\$1OUT\$1OF\$1ORDER | Os segmentos não estão ordenados temporalmente |
| TIME\$1AZ\$1EL\$1ITEMS\$1OUT\$1OF\$1ORDER | 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\$1EL\$1SEGMENT\$1REFERENCE\$1EPOCH\$1INVÁLIDO | A época de referência para um segmento é inválida ou formatada incorretamente |
| AZ\$1EL\$1SEGMENT\$1START\$1TIME\$1INVÁ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\$1EL\$1SEGMENT\$1END\$1TIME\$1INVÁLIDO | A hora de término no intervalo de tempo válido de um segmento não termina após o último segmento |
| AZ\$1EL\$1SEGMENT\$1VALID\$1TIME\$1RANGE\$1INVÁLIDO | O intervalo de tempo válido para um segmento é inválido |
| AZ\$1EL\$1SEGMENT\$1END\$1TIME\$1TOO\$1LATE | A hora de término de um segmento excede a duração máxima permitida a partir da época de referência |
| AZ\$1EL\$1TOTAL\$1DURATION\$1EXCEDIDA | 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\$1MOTION\$1INVÁ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\$1AZ\$1EL\$1AZ\$1RADIAN\$1RANGE\$1INVÁ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\$1AZ\$1EL\$1EL\$1RADIAN\$1RANGE\$1INVÁ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\$1AZ\$1EL\$1AZ\$1DEGREE\$1RANGE\$1INVÁ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\$1AZ\$1EL\$1EL\$1DEGREE\$1RANGE\$1INVÁ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\$1AZ\$1EL\$1ANGLE\$1UNITS\$1INVÁ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\$1KMS\$1INSUFICIENTES | 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\$1ERROR | Ocorreu um erro interno durante a validação das efemérides |
| FORMATO\$1DO\$1ARQUIVO\$1INVÁ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 |