

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Solucionar problemas de efemérides no válidas
<a name="troubleshooting-invalid-ephemerides"></a>

 Al cargar datos de efemérides a, estos pasan por un flujo de trabajo de AWS Ground Station validación asíncrono. Si se produce un error en la validación, el estado de las efemérides cambiará a. `INVALID` El mensaje de error de la [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)respuesta proporciona información detallada para ayudarle a identificar y resolver el problema. 

## Descripción de los errores de validación de efemérides
<a name="w2aac74c19b5"></a>

 Cuando una efeméride no pasa la validación, la respuesta de la [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)API incluye dos campos para ayudar a diagnosticar el problema: 

errorCode  
Un código legible por máquina que identifica el error de validación específico. Se puede utilizar para la gestión de errores programáticos.

errorMessage  
Una descripción legible para los humanos del error de validación con detalles específicos sobre lo que salió mal y orientación sobre cómo solucionarlo.

 Ejemplo de [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)respuesta para una efeméride no vá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": "[...]"
        }
    }
}
```

## Errores de validación comunes para las efemérides TLE
<a name="w2aac74c19b7"></a>

 Los siguientes son errores de validación comunes que se producen al cargar las efemérides de TLE: 

El número de catálogo de satélites no coincide  
 *Error:* «El número de catálogo de satélites presente en las efemérides no coincide con el número de catálogo de satélites del satélite asociado»   
 *Solución:* compruebe que el número de ID/satellite catálogo del NORAD de las líneas TLE coincide con el número de catálogo de satélites del satélite. `00000`Utilícelo para satélites sin un número de catálogo asignado. 

Movimiento medio no válido  
 *Error:* «El movimiento medio de las efemérides proporcionadas difiere demasiado del movimiento de las efemérides de referencia más recientes»   
 *Solución:* compruebe que los datos de TLE son correctos y representan una órbita válida. Ground Station utiliza las efemérides de Space-Track como referencia durante la validación. 

## Errores de validación comunes en las efemérides OEM
<a name="w2aac74c19b9"></a>

 Los siguientes son errores de validación comunes que se producen al cargar efemérides OEM: 

Marco de referencia no válido  
 *Error:* «El REF\_FRAME no es compatible»   
 *Solución:* actualice el archivo OEM para utilizar uno de los marcos de referencia compatibles: EME2000 o. ITRF2000 

Faltan campos obligatorios  
 *Error:* «Falta el campo de metadatos: INTERPOLACIÓN»   
 *Solución:* añada los campos INTERPOLATION e INTERPOLATION\_DEGREE a la sección de metadatos OEM. Estos son necesarios para generar ángulos de orientación de antena AWS Ground Station precisos. 

Sistema de tiempo no compatible  
 *Error:* «El TIME\_SYSTEM no es compatible»   
 *Solución:* asegúrese de que su archivo OEM utilice UTC como sistema horario. 

Versión OEM no compatible  
 *Error:* «El CCSDS\_OEM\_VERS no es compatible»   
 *Solución:* asegúrese de que su archivo OEM utilice la versión 2.0 del CCSDS OEM. 

## Errores de validación comunes para las efemérides de elevación azimutal
<a name="w2aac74c19c11"></a>

 Los siguientes son errores de validación comunes que se producen al cargar efemérides de elevación azimutal: 

Faltan datos azimuth/elevation   
 *Error:* «No había TimeAzEl campos en al menos uno AzElSegment»   
 *Solución:* asegúrese de que cada segmento de los datos de elevación del acimut contenga al menos un par marcado con el tiempo. azimuth/elevation 

Rango de ángulos acimutales (grados) no válido  
 *Error:* «AzEl az debe ser mayor o igual a -180 y menor o igual a 360 grados»   
 *Solución:* compruebe que los ángulos acimutales estén dentro de [-180, 360] grados. 

Rango de ángulos de elevación (grados) no válido  
 *Error:* «AzEl el debe ser mayor o igual a -90 y menor o igual a 90 grados»   
 *Solución:* compruebe que los ángulos de elevación estén dentro de [-90, 90] grados. 

Rango de ángulos de acimut (radianes) no válido  
 *Error:* «AzEl az debe ser mayor o igual que -pi y menor o igual que 2pi radianes»   
 *Solución:* compruebe que los ángulos acimutales estén dentro de [-π, 2π] radianes. 

Rango de ángulos de elevación (radianes) no válido  
 *Error:* «AzEl el debe ser mayor o igual que -pi/2 y menor o igual que pi/2 radianes»   
 *Solución:* compruebe que los ángulos de elevación estén dentro de [-π 2, π /2] radianes. 

Valores de tiempo no monótonos  
 *Error:* «Los TimeAzEl artículos incluidos en a AzElSegment deben estar en orden temporalmente»   
 *Solución:* asegúrese de que los valores de tiempo de cada segmento aumenten estrictamente. 

Segmentos fuera de orden  
 *Error:* «AzElSegments debe estar temporalmente en orden»   
 *Solución:* asegúrese de que los segmentos estén organizados en orden cronológico. 

Segmentos superpuestos  
 *Error:* «El intervalo de tiempo de al menos un segmento se superpone con otros intervalos de tiempo del segmento»   
 *Solución:* asegúrese de que cada segmento tenga un rango de tiempo único que no se superponga. El `endTime` de un segmento no debe superar el `startTime` del siguiente segmento. 

## Pasos para la solución de problemas
<a name="w2aac74c19c13"></a>

 Si tu efeméride no pasa la validación, sigue estos pasos para resolver el problema: 

1. Llama [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)con tu identificador de efemérides para recuperar la y. `errorCode` `errorMessage`

1. Revisa el mensaje de error para obtener detalles específicos sobre qué comprobación de validación ha fallado.

1. Corrija los problemas identificados en los datos de efemérides.

1. Cargue una nueva efeméride con los datos corregidos utilizando. [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html)

1. Supervisa el estado de la nueva efeméride hasta que alcance el estado. `ENABLED`

1. Elimine las efemérides no válidas utilizando [DeleteEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DeleteEphemeris.html)si ya no son necesarias.

## Referencia completa del código de error
<a name="w2aac74c19c15"></a>

 Las siguientes secciones proporcionan un mapeo completo de todos los `errorCode` valores que pueden devolverse cuando se produce un error en la validación de las efemérides, organizados por categoría de alto nivel`invalidReason`. 

### Motivo no válido: `METADATA_INVALID`
<a name="w2aac74c19c15b5"></a>

 Estos errores se producen cuando faltan campos de metadatos obligatorios, tienen un formato incorrecto o contienen valores no admitidos en los datos de efemérides. 


| Código de error | Mensaje de error | 
| --- | --- | 
| \_SATCAT\_ID NO COINCIDE | El número de catálogo de satélites presente en las efemérides de la TLE no coincide con el número de catálogo de satélites del satélite asociado | 
| OEM\_VERSION\_UNSUPPORTED | No se admiten las CCSDS\_OEM\_VERS efemérides del OEM. Valores admitidos: [] 2.0 | 
| ORIGINATOR\_MISSING | Falta el campo de ORIGINATOR encabezado en las efemérides del OEM | 
| FALTA LA FECHA DE CREACIÓN | Falta el campo de CREATION\_DATE encabezado en las efemérides del OEM | 
| FALTA EL NOMBRE\_OBJETO | Falta el campo de OBJECT\_NAME metadatos en las efemérides del OEM | 
| OBJECT\_ID\_MISSING | Falta el campo de OBJECT\_ID metadatos en las efemérides del OEM | 
| REF\_FRAME\_UNSUPPORTED | No se admiten las REF\_FRAME efemérides del OEM. Valores admitidos: [,] EME2000 ITRF2000 | 
| REF\_FRAME\_EPOCH\_UNSUPPORTED | No se admite el campo de REF\_FRAME\_EPOCH metadatos de las efemérides OEM. Elimine este campo de las efemérides | 
| TIME\_SYSTEM\_UNSUPPORTED | No se admiten las TIME\_SYSTEM efemérides del OEM. Valores admitidos: [] UTC | 
| CENTER\_BODY\_UNSUPPORTED | No se admiten las CENTER\_BODY efemérides del OEM. Valores admitidos: [] Earth | 
| FALTA INTERPOLACIÓN\_ | Falta el campo de INTERPOLATION metadatos en las efemérides del OEM | 
| GRADO DE INTERPOLACIÓN NO VÁLIDO | El grado de interpolación de las efemérides OEM debe ser superior a 0 para el método de interpolación | 
| AZ\_EL\_SEGMENT\_LIST\_MISSING | Falta el campo [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html) | 
| INSUFICIENT\_TIME\_AZ\_EL | No había ningún campo en al menos una [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html) | 

### Motivo no válido: `TIME_RANGE_INVALID`
<a name="w2aac74c19c15b7"></a>

 Estos errores se producen cuando las efemérides contienen intervalos de tiempo no válidos, como problemas con los start/end tiempos, el orden de los segmentos, la superposición de segmentos o las incoherencias temporales. 


| Código de error | Mensaje de error | 
| --- | --- | 
| TIME\_START\_IN\_FUTURE | La hora de inicio de las efemérides está en el futuro, pero debe estar en el pasado | 
| END\_TIME\_IN\_PAST | Efemérides: el fin del tiempo está en el pasado, pero debe estar en el futuro | 
| CADUCIDAD DEMASIADO TEMPRANA | La hora de caducidad proporcionada es anterior a la hora de finalización de la efeméride | 
| START\_TIME\_METADATA\_TOO\_EARLY | El valor de los START\_TIME metadatos es anterior a la primera vez que aparece en los datos de efemérides del OEM | 
| STOP\_TIME\_METADATA\_TOO\_LATE | El valor de los STOP\_TIME metadatos es posterior a la última vez que aparece en los datos de efemérides del OEM | 
| AZ\_EL\_SEGMENT\_END\_TIME\_BEFORE\_START\_TIME | El de al menos un segmento de datos está antes del 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 | El intervalo de tiempo de al menos un segmento se superpone con otros intervalos de tiempo del segmento | 
| AZ\_EL\_SEGMENTS\_OUT\_OF\_ORDER | Los segmentos no están ordenados temporalmente | 
| TIME\_AZ\_EL\_ITEMS\_OUT\_OF\_ORDER | Los artículos incluidos en un deben estar ordenados temporalmente [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html) | 
| AZ\_EL\_SEGMENT\_REFERENCE\_EPOCH\_INVALID | La época de referencia de un segmento no es válida o tiene un formato incorrecto | 
| AZ\_EL\_SEGMENT\_START\_TIME\_INVALID | La hora de inicio en el intervalo de tiempo válido de un segmento no comienza después del primer segmento | 
| AZ\_EL\_SEGMENT\_END\_TIME\_INVALID | La hora de finalización en el intervalo de tiempo válido de un segmento no termina después del último segmento | 
| AZ\_EL\_SEGMENT\_VALID\_TIME\_RANGE\_INVALID | El intervalo de tiempo válido para un segmento no es válido | 
| AZ\_EL\_SEGMENT\_END\_TIME\_TOO\_LATE | La hora de finalización de un segmento supera la duración máxima permitida a partir de la época de referencia | 
| AZ\_EL\_TOTAL\_DURATION\_EXCEEDED | La duración total en todos los segmentos supera la duración máxima permitida del ángulo de puntería | 

### Motivo no válido: `TRAJECTORY_INVALID`
<a name="w2aac74c19c15b9"></a>

 Estos errores se producen cuando la efeméride contiene datos de trayectoria no válidos, incluidos problemas con los parámetros orbitales, los rangos de ángulos o las unidades. 


| Código de error | Mensaje de error | 
| --- | --- | 
| MEAN\_MOTION\_INVALID | El movimiento medio de las efemérides TLE proporcionadas difiere demasiado de las efemérides de referencia más recientes. Nota: Ground Station utiliza las efemérides de Space-Track como referencia durante la validación | 
| TIME\_AZ\_EL\_AZ\_RADIAN\_RANGE\_INVALID | 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)debe ser mayor o igual a -π y menor o igual a 2π radianes | 
| TIME\_AZ\_EL\_EL\_RADIAN\_RANGE\_INVALID | 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)debe ser mayor o igual que -π /2 y menor o igual que π /2 radianes | 
| TIME\_AZ\_EL\_AZ\_DEGREE\_RANGE\_INVALID | 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)debe ser mayor o igual a -180 y menor o igual a 360 grados | 
| TIME\_AZ\_EL\_EL\_DEGREE\_RANGE\_INVALID | 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)debe ser mayor o igual a -90 grados y menor o igual a 90 grados | 
| TIME\_AZ\_EL\_ANGLE\_UNITS\_INVALID | Unidades de ángulo no válidas AzEl  | 

### Motivo no válido: `KMS_KEY_INVALID`
<a name="w2aac74c19c15c11"></a>

 Estos errores se producen cuando hay problemas con la clave de AWS Key Management Service (KMS) utilizada para cifrar los datos de efemérides. 


| Código de error | Mensaje de error | 
| --- | --- | 
| KMS\_PERMISSIONS INSUFICIENTES | Ground Station no tiene permisos suficientes para acceder a la clave KMS de esta efeméride | 

### Motivo no válido: `VALIDATION_ERROR`
<a name="w2aac74c19c15c13"></a>

 Estos errores se producen cuando hay problemas generales de validación con los datos de efemérides que no se incluyen en las otras categorías específicas. 


| Código de error | Mensaje de error | 
| --- | --- | 
| INTERNAL\_ERROR | Se produjo un error interno durante la validación de las efemérides | 
| FILE\_FORMAT\_INVALID | El formato del archivo de efemérides no es válido o está dañado. Compruebe que el archivo se ajusta al formato esperado para el tipo de efemérides | 