Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Résoudre les problèmes liés aux éphémérides non valides
Lorsque vous chargez des données d'éphémérides vers AWS Ground Station, elles sont soumises à un flux de travail de validation asynchrone. Si la validation échoue, le statut de l'éphéméride passe à. `INVALID` Le message d'erreur contenu dans la [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)réponse fournit des informations détaillées pour vous aider à identifier et à résoudre le problème.
## Comprendre les erreurs de validation des éphémérides
Lorsqu'une éphéméride échoue à la validation, la réponse de l'[DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)API inclut deux champs pour aider à diagnostiquer le problème :
errorCode
Code lisible par machine identifiant l'erreur de validation spécifique. Cela peut être utilisé pour la gestion des erreurs de programmation.
errorMessage
Une description lisible par l'homme de l'erreur de validation avec des détails spécifiques sur ce qui s'est mal passé et des conseils pour y remédier.
Exemple de [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)réponse pour une éphéméride non valide :
```
{
"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": "[...]"
}
}
}
```
## Erreurs de validation courantes pour les éphémérides TLE
Les erreurs de validation les plus courantes rencontrées lors du téléchargement d'éphémérides TLE sont les suivantes :
Numéro de catalogue satellite non concordant
*Erreur :* « Le numéro de catalogue satellite présent dans l'éphéméride ne correspond pas au numéro de catalogue satellite du satellite associé »
*Solution :* Vérifiez que le numéro de ID/satellite catalogue du NORAD figurant sur vos lignes TLE correspond au numéro de catalogue satellite de votre satellite. `00000`À utiliser pour les satellites sans numéro de catalogue attribué.
Mouvement moyen non valide
*Erreur :* « Le mouvement moyen des éphémérides fournies est trop différent de celui des éphémérides de référence les plus récentes »
*Solution :* Vérifiez que vos données TLE sont correctes et représentent une orbite valide. Ground Station utilise les éphémérides Space-Track comme référence lors de la validation.
## Erreurs de validation courantes pour les éphémérides OEM
Les erreurs de validation les plus courantes rencontrées lors du téléchargement d'éphémérides OEM sont les suivantes :
Cadre de référence non valide
*Erreur :* « Le REF\_FRAME n'est pas pris en charge »
*Solution :* mettez à jour votre fichier OEM pour utiliser l'un des cadres de référence pris en charge : EME2000 ou ITRF2000.
Champs obligatoires manquants
*Erreur :* « Champ de métadonnées manquant : INTERPOLATION »
*Solution :* ajoutez les champs INTERPOLATION et INTERPOLATION\_DEGREE à votre section de métadonnées OEM. Ils sont nécessaires pour AWS Ground Station générer des angles de pointage précis de l'antenne.
Système horaire non pris en charge
*Erreur :* « Le TIME\_SYSTEM n'est pas pris en charge »
*Solution :* Assurez-vous que votre fichier OEM utilise l'UTC comme système horaire.
Version OEM non prise en charge
*Erreur :* « Le CCSDS\_OEM\_VERS n'est pas pris en charge »
*Solution :* Assurez-vous que votre fichier OEM utilise la version 2.0 de CCSDS OEM.
## Erreurs de validation courantes pour les éphémérides d'élévation d'azimut
Les erreurs de validation les plus courantes rencontrées lors du téléchargement d'éphémérides d'élévation d'azimut sont les suivantes :
azimuth/elevation Données manquantes
*Erreur :* « Aucun TimeAzEl champ n'était présent dans au moins un AzElSegment »
*Solution :* Assurez-vous que chaque segment de vos données d'altitude azimutale contient au moins une paire horodatée. azimuth/elevation
Plage d'angles d'azimut non valide (degrés)
*Erreur :* « AzEl az doit être supérieur ou égal à -180 et inférieur ou égal à 360 degrés »
*Solution :* Vérifiez que les angles d'azimut se situent dans les limites de [-180, 360] degrés.
Plage d'angles d'élévation non valide (degrés)
*Erreur :* « AzEl el doit être supérieur ou égal à -90 et inférieur ou égal à 90 degrés »
*Solution :* Vérifiez que les angles d'élévation sont compris entre [-90, 90] degrés.
Plage d'angles d'azimut non valide (radians)
*Erreur :* « AzEl az doit être supérieur ou égal à -pi et inférieur ou égal à 2 pi radians »
*Solution :* Vérifiez que les angles d'azimut sont compris entre [-π, 2π] radians.
Plage d'angles d'élévation non valide (radians)
*Erreur :* « AzEl el doit être supérieur ou égal à -pi/2 et inférieur ou égal à pi/2 radians »
*Solution :* Vérifiez que les angles d'élévation sont compris entre [-π/2, π/2] radians.
Valeurs temporelles non monotones
*Erreur :* « Les TimeAzEl articles contenus dans un AzElSegment doivent être en ordre dans le temps »
*Solution :* assurez-vous que les valeurs temporelles de chaque segment augmentent strictement.
Segments hors ordre
*Erreur :* « AzElSegments doit être temporairement en ordre »
*Solution :* Assurez-vous que les segments sont classés par ordre chronologique.
Segments qui se chevauchent
*Erreur :* « La plage de temps d'au moins un segment se chevauche avec d'autres plages temporelles de segment »
*Solution :* Assurez-vous que chaque segment possède une plage de temps unique qui ne se chevauche pas. Le `endTime` d'un segment ne doit pas dépasser celui `startTime` du segment suivant.
## Étapes de résolution des problèmes
Si la validation de votre éphéméride échoue, procédez comme suit pour résoudre le problème :
1. Appelez [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)avec votre identifiant d'éphéméride pour récupérer le `errorCode` et. `errorMessage`
1. Consultez le message d'erreur pour obtenir des informations spécifiques sur le contrôle de validation qui a échoué.
1. Corrigez les problèmes identifiés dans vos données d'éphémérides.
1. Téléchargez une nouvelle éphéméride avec les données corrigées à l'aide de. [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html)
1. Surveillez le nouvel état des éphémérides jusqu'à ce qu'il atteigne `ENABLED` cet état.
1. Supprimez les éphémérides non valides en indiquant [DeleteEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DeleteEphemeris.html)si elles ne sont plus nécessaires.
## Référence complète du code d'erreur
Les sections suivantes fournissent un mappage complet de toutes les `errorCode` valeurs qui peuvent être renvoyées en cas d'échec de la validation des éphémérides, organisées par catégorie de haut niveau`invalidReason`.
### Motif non valide : `METADATA_INVALID`
Ces erreurs se produisent lorsque les champs de métadonnées obligatoires sont manquants, mal formatés ou contiennent des valeurs non prises en charge dans les données d'éphémérides.
| Code d’erreur | Message d’erreur |
| --- | --- |
| IDENTIFIANT\_SATCAT\_ID NON CONCORDANT | Le numéro de catalogue satellite présent dans les éphémérides TLE ne correspond pas au numéro de catalogue satellite du satellite associé |
| OEM\_VERSION\_NON PRISE EN CHARGE | Les éphémérides présentes CCSDS\_OEM\_VERS dans l'OEM ne sont pas prises en charge. Valeurs prises en charge : [2.0] |
| ORIGINATEUR\_MANQUANT | Le champ ORIGINATOR d'en-tête est absent des éphémérides OEM |
| DATE\_DE\_CRÉATION\_MANQUANTE | Le champ CREATION\_DATE d'en-tête est absent des éphémérides OEM |
| NOM\_OBJET\_MANQUANT | Le champ de OBJECT\_NAME métadonnées est absent des éphémérides OEM |
| IDENTIFIANT\_OBJET MANQUANT | Le champ de OBJECT\_ID métadonnées est absent des éphémérides OEM |
| REF\_FRAME\_NON PRIS EN CHARGE | Les éphémérides présentes REF\_FRAME dans l'OEM ne sont pas prises en charge. Valeurs prises en charge : [EME2000,ITRF2000] |
| REF\_FRAME\_EPOCH\_NON PRIS EN CHARGE | Le champ de REF\_FRAME\_EPOCH métadonnées dans les éphémérides OEM n'est pas pris en charge. Veuillez supprimer ce champ de l'éphéméride |
| TIME\_SYSTEM\_UNSUPPORTED | Les éphémérides présentes TIME\_SYSTEM dans l'OEM ne sont pas prises en charge. Valeurs prises en charge : [UTC] |
| CENTER\_BODY\_UNSUPPORTED | Les éphémérides présentes CENTER\_BODY dans l'OEM ne sont pas prises en charge. Valeurs prises en charge : [Earth] |
| INTERPOLATION\_MANQUANTE | Le champ de INTERPOLATION métadonnées est absent des éphémérides OEM |
| DEGRÉ\_INTERPOLATION\_INCORRECT | Le degré d'interpolation dans les éphémérides OEM doit être supérieur à 0 pour la méthode d'interpolation. |
| AZ\_EL\_SEGMENT\_LIST\_MISSING | Le [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html)champ est manquant |
| INSUFFICIENT\_TIME\_AZ\_EL | Aucun [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)champ n'était présent dans au moins un [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html) |
### Motif non valide : `TIME_RANGE_INVALID`
Ces erreurs se produisent lorsque l'éphéméride contient des plages temporelles non valides, notamment des problèmes liés aux start/end heures, à l'ordre des segments, à des segments qui se chevauchent ou à des incohérences temporelles.
| Code d’erreur | Message d’erreur |
| --- | --- |
| HEURE DE DÉBUT DANS LE FUTUR | L'heure de début des éphémérides est dans le futur, mais doit être dans le passé |
| END\_TIME\_IN\_PAST | La fin des éphémérides appartient au passé, mais elle doit l'être dans le futur |
| EXPIRATION\_TIME\_TROP TÔT | Le délai d'expiration indiqué est antérieur à l'heure de fin de l'éphéméride |
| START\_TIME\_METADATA\_TOO\_EARLY | La valeur START\_TIME des métadonnées est antérieure à la première heure présente dans les données d'éphémérides OEM |
| STOP\_TIME\_METADATA\_TOO\_LATE | La valeur STOP\_TIME des métadonnées est postérieure à la dernière date de présence dans les données d'éphémérides OEM |
| AZ\_EL\_SEGMENT\_END\_TIME\_BEFORE\_START\_TIME | Le [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ISO8601TimeRange.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ISO8601TimeRange.html)d'au moins un segment de données se situe avant le segment [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 | La plage de temps d'au moins un segment chevauche d'autres plages temporelles de segment |
| AZ\_EL\_SEGMENTS\_OUT\_OF\_ORDER | Les segments ne sont pas ordonnés dans le temps |
| TIME\_AZ\_EL\_ITEMS\_OUT\_OF\_ORDER | Les [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)articles contenus dans un [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegment.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegment.html)doivent être temporellement en ordre |
| AZ\_EL\_SEGMENT\_REFERENCE\_EPOCH\_INVALID | L'époque de référence d'un segment n'est pas valide ou n'est pas correctement formatée |
| AZ\_EL\_SEGMENT\_START\_TIME\_INVALID | L'heure de début comprise dans la plage horaire valide d'un segment ne commence pas après le premier segment |
| AZ\_EL\_SEGMENT\_END\_TIME\_INVALID | L'heure de fin comprise dans la plage horaire valide d'un segment ne se termine pas après le dernier segment |
| AZ\_EL\_SEGMENT\_VALID\_TIME\_RANGE\_INVALID | La plage horaire valide pour un segment n'est pas valide |
| AZ\_EL\_SEGMENT\_END\_TIME\_TOO\_LATE | L'heure de fin d'un segment dépasse la durée maximale autorisée par rapport à l'époque de référence |
| AZ\_EL\_TOTAL\_DURATION\_EXCEEDED | La durée totale sur tous les segments dépasse la durée maximale autorisée de l'angle de pointage |
### Motif non valide : `TRAJECTORY_INVALID`
Ces erreurs se produisent lorsque l'éphéméride contient des données de trajectoire non valides, notamment des problèmes liés aux paramètres orbitaux, aux plages d'angles ou aux unités.
| Code d’erreur | Message d’erreur |
| --- | --- |
| MOTION\_MOYEN\_INCORRECT | Le mouvement moyen des éphémérides TLE fournies est trop différent des éphémérides de référence les plus récentes. Remarque : Ground Station utilise les éphémérides Space-Track comme référence lors de la validation |
| 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)doit être supérieur ou égal à -π et inférieur ou égal à 2π radians |
| 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)doit être supérieur ou égal à -π/2 et inférieur ou égal à π/2 radians |
| 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)doit être supérieur ou égal à -180 et inférieur ou égal à 360 degrés |
| 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)doit être supérieur ou égal à -90 degrés et inférieur ou égal à 90 degrés |
| TIME\_AZ\_EL\_ANGLE\_UNITS\_INVALID | Unités AzEl angulaires non valides |
### Motif non valide : `KMS_KEY_INVALID`
Ces erreurs se produisent en cas de problème avec la clé AWS Key Management Service (KMS) utilisée pour chiffrer les données éphémérides.
| Code d’erreur | Message d’erreur |
| --- | --- |
| AUTORISATIONS\_KMS\_INSUFFISANTES | Ground Station ne dispose pas des autorisations suffisantes pour accéder à la clé KMS de cet éphéméride |
### Motif non valide : `VALIDATION_ERROR`
Ces erreurs se produisent en cas de problèmes généraux de validation des données d'éphémérides qui n'entrent pas dans les autres catégories spécifiques.
| Code d’erreur | Message d’erreur |
| --- | --- |
| INTERNAL\_ERROR | Une erreur interne s'est produite lors de la validation des éphémérides |
| FORMAT\_FICHIER\_INVALIDE | Le format de fichier éphéméride n'est pas valide ou est endommagé. Vérifiez que le fichier est conforme au format attendu pour le type d'éphéméride |