View a markdown version of this page

Résoudre les problèmes liés aux mises à jour des contacts - AWS Ground Station
Erreurs de validation synchronesCodes de défaillance asynchronesVérifier l'état d'une mise à jour

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 mises à jour des contacts

Lorsque vous appelez l'UpdateContactAPI, AWS Ground Station effectue une validation synchrone de la demande. Si la validation est réussie, la mise à jour est traitée de manière asynchrone pour propager les modifications apportées à la région de l'antenne. Les erreurs de validation synchrones sont renvoyées directement dans la réponse HTTP. Les défaillances asynchrones sont signalées par le biais failureCodes des failureMessage champs de la version du contact, que vous pouvez consulter en appelant DescribeContactVersionla version qui n'a pas pu être mise à jour.

Pour plus d'informations sur la gestion des versions des contacts, consultezMettre à jour les contacts et la gestion des versions des contacts.

Erreurs de validation synchrones

Les erreurs suivantes sont renvoyées directement dans la réponse HTTP lorsque la UpdateContactdemande échoue à la validation.

ResourceNotFoundException: Contact introuvable

Cause commune

Le compte spécifié contactId n'existe pas ou appartient à un autre AWS compte.

Résolution

  1. Vérifiez que contactId c'est correct.

  2. Vérifiez que vous utilisez les informations d'identification du AWS compte auquel appartient le contact.

  3. ListContactsUtilisez-le pour trouver le boncontactId.

ConflictException: Impossible de mettre à jour le contact

Cause commune

Le contact est dans un état qui n'autorise pas les mises à jour. L'UpdateContactAPI ne peut être appelée que lorsque le contact est dans l'PASSétat SCHEDULEDPREPASS, ou. Cette erreur se produit également si une autre mise à jour est déjà en cours (la dernière version du contact est dans l'UPDATINGétat actuel).

Résolution

  1. Appelez DescribeContactpour vérifier l'état actuel du contact.

  2. Si le contact est dans un état terminal (par exemple,, ouCANCELLED) COMPLETEDFAILED, il ne peut pas être mis à jour. Un contact ne peut être mis à jour que lorsqu'il est dans l'PASSétat SCHEDULEDPREPASS, ou. Pour une liste complète des états du terminal, voirAWS Ground Station statuts des contacts.

  3. Si une autre mise à jour est en cours, attendez que la mise à jour actuelle atteigne ACTIVE FAILED_TO_UPDATE son statut avant de soumettre une autre mise à jour. Vous pouvez interroger l'DescribeContactVersionAPI ou utiliser les utilitaires de ContactUpdated commodité pour serveurs fournis par certains AWS SDKs et le AWS Command Line Interface.

InvalidParameterException: paramètres de demande non valides

Cause commune

La demande contient des paramètres non valides. Les causes courantes incluent :

  • Manquant ou videclientToken.

  • Plusieurs types de ProgramTrackSettings (azimut/élévation, OEM et TLE) sont inclus dans une seule demande. Un seul type est autorisé par demande.

  • Réglage satelliteArn sur zéro sans approbation pour les éphémérides d'altitude azimutale à la station au sol du contact.

  • AzElProgramTrackSettingsManquant lorsque satelliteArn est nul.

  • Fournir un ephemerisId qui n'est pas associé à ce qui est spécifiésatelliteArn.

  • Le satellite ne dispose pas d'une fenêtre de visibilité valide depuis la station au sol pour la plage de temps de contact.

  • Le satellite n'est pas embarqué à bord de la station au sol ou ne possède pas la licence requise par le profil de mission.

  • Le profil de mission inclut des Config de décodage/démodulation des signaux d’antenne de liaison descendante configurations, qui ne sont pas prises en charge pour les mises à jour des contacts.

Résolution

  1. Consultez le message d'erreur contenu dans la réponse pour savoir quel paramètre n'est pas valide.

  2. Assurez-vous de fournir exactement un type ProgramTrackSettings de demande.

  3. Si vous utilisez des angles de azimuth/elevation pointage sans unsatelliteArn, vérifiez que votre compte est approuvé pour cette fonctionnalité à la station au sol. Pour de plus amples informations, veuillez consulter Fournir des données sur les éphémérides d'altitude azimutale.

  4. Vérifiez que l'éphéméride à laquelle vous faites référence est associée au bon satellite et couvre la plage de temps de contact.

ResourceLimitExceededException: limite de version maximale atteinte

Cause commune

Le contact a atteint le nombre maximum de versions (128). Chaque appel UpdateContactcrée une nouvelle version, et un contact ne peut pas dépasser cette limite.

Résolution

  1. Cette limite ne peut pas être augmentée. Si vous devez apporter d'autres modifications, annulez le contact et réservez-en un nouveau.

Codes de défaillance asynchrones

Les codes d'erreur suivants apparaissent dans le failureCodes champ d'une version de contact avec un FAILED_TO_UPDATE statut. DescribeContactVersionÀ utiliser pour récupérer ces informations. Le failureMessage champ fournit un contexte supplémentaire concernant l'échec.

Code de défaillance Cause courante Résolution
INTERNAL_ERROR Une erreur interne inattendue s'est produite lors du traitement de la mise à jour. Réessayez la mise à jour. Si le problème persiste, contactez AWS Support.
INVALID_SATELLITE_ARN L'ARN du satellite fourni dans la demande de mise à jour n'est pas valide ou n'existe pas. Vérifiez l'ARN du satellite et confirmez que le satellite est enregistré dans votre compte.
INVALID_UPDATE_CONTACT_REQUEST La demande de mise à jour contient des paramètres non valides qui n'ont pas été interceptés lors de la validation synchrone. Consultez le failureMessage pour plus de détails et corrigez les paramètres de la demande.
EPHEMERIS_NOT_FOUND Les éphémérides référencées dans les dérogations de suivi n'existent pas. Vérifiez ephemerisId et confirmez que l'éphéméride n'a pas été supprimée.
EPHEMERIS_TIME_RANGE_INVALID L'éphéméride ne couvre pas la plage de temps du contact. Téléchargez une nouvelle éphéméride qui couvre l'ensemble de la plage de temps de contact. Si la plage de temps des éphémérides ne peut pas être prolongée, annulez le contact et réservez-en un nouveau pendant la durée des éphémérides. Pour de plus amples informations, veuillez consulter Fournir des données d'éphémérides personnalisées.
EPHEMERIS_NOT_ENABLED L'éphéméride référencée n'est pas en état. ENABLED Vérifiez le statut des éphémérides et activez-le avant de réessayer la mise à jour.
SATELLITE_DOES_NOT_MATCH_EPHEMERIS L'éphéméride n'est pas associée au satellite spécifié dans la demande de mise à jour. Assurez-vous qu'il ephemerisId appartient au satellite spécifié danssatelliteArn.
NOT_ONBOARDED_TO_AZEL_EPHEMERIS Votre compte n'est pas autorisé à utiliser les données d'éphémérides d'altitude azimutale à la station au sol du contact. L'éphéméride d'élévation d'azimut est une fonctionnalité restreinte disponible pour un nombre limité de cas d'utilisation spécialisés. Si des éphémérides d'élévation d'azimut sont requises pour votre cas d'utilisation, ouvrez un AWS Support ticket via le pour demander l'accès. AWS Support Center Console Vous pouvez également envisager d'utiliser des données d'éphémérides TLE ou des données d'éphémérides OEM si elles correspondent à votre cas d'utilisation.
AZEL_EPHEMERIS_NOT_FOUND L'éphéméride d'élévation d'azimut référencée dans la demande n'existe pas. Vérifiez ephemerisId et confirmez que l'éphéméride d'altitude azimutale n'a pas été supprimée.
AZEL_EPHEMERIS_WRONG_GROUND_STATION L'éphéméride d'élévation azimutale a été créée pour une station au sol différente de celle utilisée par le contact. Téléchargez une nouvelle éphéméride d'altitude azimutale pour la bonne station au sol, ou utilisez une éphéméride existante correspondant à la station au sol du contact.
AZEL_EPHEMERIS_INVALID_STATUS L'éphéméride d'élévation d'azimut n'est pas dans un état valide pour être utilisée. Vérifiez l'état des éphémérides. Il doit être en ENABLED état. Si la validation de l'éphéméride a échoué, téléchargez une version corrigée.
AZEL_EPHEMERIS_TIME_RANGE_INVALID L'éphéméride d'élévation de l'azimut ne couvre pas la plage de temps du contact. Téléchargez une nouvelle éphéméride d'altitude azimutale qui couvre l'ensemble de la plage de temps de contact. Si la plage de temps des éphémérides ne peut pas être prolongée, annulez le contact et réservez-en un nouveau pendant la durée des éphémérides.

Vérifier l'état d'une mise à jour

Après l'appelUpdateContact, la nouvelle version du contact démarre dans l'UPDATINGétat. Pendant ce temps, DescribeContactcontinue de renvoyer la version précédemment active du contact. La nouvelle version n'apparaît pas DescribeContact tant qu'elle n'a pas été propagée à l'antenne et n'a pas atteint le ACTIVE statut. Pour vérifier l'état d'une version spécifique, utilisez DescribeContactVersion.

Pour déterminer si une mise à jour a réussi ou échoué, procédez comme suit :

  1. Appelez DescribeContactVersionavec le contactId et versionId renvoyé par la UpdateContact réponse.

  2. Vérifiez le version.status champ. Le statut indique ACTIVE que la mise à jour a été correctement appliquée. L'état indique FAILED_TO_UPDATE que la mise à jour a échoué.

  3. Si le statut est le casFAILED_TO_UPDATE, vérifiez les version.failureMessage champs version.failureCodes et pour plus de détails sur ce qui s'est mal passé.

Astuce

Certains AWS SDKs et le AWS Command Line Interface soutiennent un ContactUpdated serveur qui interroge automatiquement DescribeContactVersion jusqu'à ce que la version atteigne son ACTIVE FAILED_TO_UPDATE statut. Par exemple, AWS Command Line Interface fournit une commande aws groundstation wait contact-updated. Utilisez le serveur au lieu d'implémenter votre propre logique de sondage.