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 DescribeEphemerisresposta 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 DescribeEphemerisAPI 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 DescribeEphemerisresposta 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
00000para 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_FRAME não é suportado”
Solução: atualize seu arquivo OEM para usar um dos quadros de referência compatíveis: EME2 000 ou ITRF2 000.
- 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
endTimede um segmento não deve exceder ostartTimedo próximo segmento.
Etapas de solução de problemas
Se sua efeméride falhar na validação, siga estas etapas para resolver o problema:
-
Ligue DescribeEphemeriscom seu ID de efeméride para recuperar o e.
errorCodeerrorMessage -
Revise a mensagem de erro para obter detalhes específicos sobre qual verificação de validação falhou.
-
Corrija os problemas identificados em seus dados de efemérides.
-
Faça o upload de uma nova efeméride com os dados corrigidos usando. CreateEphemeris
-
Monitore o novo status de efemérides até que ele atinja o estado.
ENABLED -
Exclua a efeméride inválida usando DeleteEphemerisse 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 azElSegmentListcampo está faltando |
| TEMPO_AZ_INSUFICIENTE_AZ_EL | Nenhum TimeAzElcampo estava presente em pelo menos um azElSegmentList |
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 endTimede pelo menos um segmento de dados está antes do segmento startTime |
| 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 TimeAzElitens dentro de um AzElSegmentdevem 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 azdeve ser maior ou igual a -π e menor ou igual a 2π radianos |
| TIME_AZ_EL_EL_RADIAN_RANGE_INVÁLIDO | AzEl eldeve ser maior ou igual a -π/2 e menor ou igual a π/2 radianos |
| TIME_AZ_EL_AZ_DEGREE_RANGE_INVÁLIDO | AzEl azdeve ser maior ou igual a -180 e menor ou igual a 360 graus |
| TIME_AZ_EL_EL_DEGREE_RANGE_INVÁLIDO | AzEl eldeve 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 |
