View a markdown version of this page

Behebung fehlgeschlagener Kontaktaktualisierungen - AWS Ground Station
Fehler bei der synchronen ÜberprüfungAsynchrone FehlercodesÜberprüfen Sie den Status eines Updates

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Behebung fehlgeschlagener Kontaktaktualisierungen

AWS Ground Station Führt beim Aufrufen der UpdateContactAPI eine synchrone Validierung der Anfrage durch. Wenn die Überprüfung erfolgreich ist, wird das Update asynchron verarbeitet, um Änderungen in der Antennenregion zu übertragen. Synchrone Validierungsfehler werden direkt in der HTTP-Antwort zurückgegeben. Asynchrone Fehler werden in den failureMessage Feldern failureCodes und in der Kontaktversion gemeldet. Sie können diese anzeigen, indem Sie die Version aufrufen DescribeContactVersion, die nicht aktualisiert werden konnte.

Weitere Informationen zur Versionierung von Kontakten finden Sie unter. Kontakte und Kontaktversionierung aktualisieren

Fehler bei der synchronen Überprüfung

Die folgenden Fehler werden direkt in der HTTP-Antwort zurückgegeben, wenn die Überprüfung der UpdateContactAnforderung fehlschlägt.

ResourceNotFoundException: Kontakt wurde nicht gefunden

Gemeinsame Ursache

Das angegebene Konto contactId existiert nicht oder gehört zu einem anderen AWS Konto.

Resolution (Auflösung)

  1. Stellen Sie sicher, dass das korrekt contactId ist.

  2. Vergewissern Sie sich, dass Sie Anmeldeinformationen für das AWS Konto verwenden, dem der Kontakt gehört.

  3. Verwenden Sie ListContacts, um das Richtige zu findencontactId.

ConflictException: Kontakt kann nicht aktualisiert werden

Häufiger Grund

Der Kontakt befindet sich in einem Zustand, in dem keine Aktualisierungen zulässig sind. Die UpdateContactAPI kann nur aufgerufen werden, wenn sich der Kontakt im PASS Status SCHEDULEDPREPASS, oder befindet. Dieser Fehler tritt auch auf, wenn bereits ein anderes Update ausgeführt wird (die neueste Kontaktversion befindet sich im UPDATING Status).

Resolution (Auflösung)

  1. Rufen Sie DescribeContactan, um den aktuellen Kontaktstatus zu überprüfen.

  2. Wenn sich der Kontakt in einem Endstatus befindet (z. B., COMPLETEDFAILED, oderCANCELLED), kann er nicht aktualisiert werden. Ein Kontakt kann nur aktualisiert werden, wenn er sich im PASS Status SCHEDULEDPREPASS, oder befindet. Eine vollständige Liste der Terminalstatus finden Sie unterAWS Ground Station Status der Kontakte.

  3. Wenn gerade ein anderes Update ausgeführt wird, warten Sie, bis das aktuelle Update den FAILED_TO_UPDATE Status ACTIVE oder erreicht hat, bevor Sie ein weiteres Update einreichen. Sie können die DescribeContactVersionAPI abfragen oder die Hilfsprogramme für ContactUpdated Kellner nutzen, die von some AWS SDKs und the AWS Command Line Interface bereitgestellt werden.

InvalidParameterException: Ungültige Anforderungsparameter

Häufiger Grund

Die Anfrage enthält ungültige Parameter. Zu den häufigsten Ursachen gehören:

  • Fehlt oder ist leerclientToken.

  • In einer einzigen Anfrage sind mehrere Typen ProgramTrackSettings (Azimut/Elevation, OEM und TLE) enthalten. Pro Anfrage ist nur ein Typ zulässig.

  • Wird satelliteArn auf Null gesetzt, ohne dass für die Azimuthöhenephemeride an der Bodenstation des Kontakts eine Genehmigung erteilt wurde.

  • FehltAzElProgramTrackSettings, wenn ist Null. satelliteArn

  • Bereitstellung einesephemerisId, das nicht mit dem angegebenen verknüpft istsatelliteArn.

  • Der Satellit hat für den Kontaktzeitbereich kein gültiges Sichtfenster von der Bodenstation aus.

  • Der Satellit ist nicht an der Bodenstation installiert oder verfügt nicht über die im Missionsprofil vorgeschriebene Lizenz.

  • Das Missionsprofil enthält Antennen-Downlink-Demod-Decode-Config Konfigurationen, die für Kontaktaktualisierungen nicht unterstützt werden.

Resolution (Auflösung)

  1. Einzelheiten darüber, welcher Parameter ungültig ist, finden Sie in der Fehlermeldung in der Antwort.

  2. Stellen Sie sicher, dass Sie ProgramTrackSettings pro Anfrage genau einen Typ angeben.

  3. Wenn Sie azimuth/elevation Zeigewinkel ohne A verwendensatelliteArn, vergewissern Sie sich, dass Ihr Konto für diese Funktion an der Bodenstation zugelassen ist. Weitere Informationen finden Sie unter Geben Sie Azimut-Elevations-Ephemeridendaten an.

  4. Vergewissern Sie sich, dass die Ephemeride, auf die Sie verweisen, dem richtigen Satelliten zugeordnet ist und den Kontaktzeitbereich abdeckt.

ResourceLimitExceededException: Das maximale Versionslimit wurde erreicht

Häufiger Grund

Der Kontakt hat die maximale Anzahl von Versionen (128) erreicht. Bei jedem Aufruf von UpdateContactwird eine neue Version erstellt, und ein Kontakt darf dieses Limit nicht überschreiten.

Resolution (Auflösung)

  1. Dieses Limit kann nicht erhöht werden. Wenn Sie weitere Änderungen vornehmen müssen, stornieren Sie den Kontakt und reservieren Sie einen neuen.

Asynchrone Fehlercodes

Die folgenden Fehlercodes werden im failureCodes Feld einer Kontaktversion mit einem FAILED_TO_UPDATE Status angezeigt. Wird verwendet DescribeContactVersion, um diese Details abzurufen. Das failureMessage Feld bietet zusätzlichen Kontext zu dem Fehler.

Fehlercode Häufige Ursache Auflösung
INTERNAL_ERROR Bei der Verarbeitung des Updates ist ein unerwarteter interner Fehler aufgetreten. Versuchen Sie das Update erneut. Wenn das Problem weiterhin besteht, wenden Sie sich an den AWS Support.
INVALID_SATELLITE_ARN Der in der Aktualisierungsanforderung angegebene Satelliten-ARN ist ungültig oder existiert nicht. Überprüfen Sie den Satelliten-ARN und vergewissern Sie sich, dass der Satellit in Ihrem Konto registriert ist.
INVALID_UPDATE_CONTACT_REQUEST Die Aktualisierungsanforderung enthält ungültige Parameter, die bei der synchronen Überprüfung nicht erfasst wurden. Überprüfen Sie die failureMessage Einzelheiten und korrigieren Sie die Anforderungsparameter.
EPHEMERIS_NOT_FOUND Die Ephemeride, auf die in den Tracking-Overrides verwiesen wird, ist nicht vorhanden. Überprüfen Sie das ephemerisId und stellen Sie sicher, dass die Ephemeride nicht gelöscht wurde.
EPHEMERIS_TIME_RANGE_INVALID Die Ephemeride deckt nicht den Zeitraum des Kontakts ab. Laden Sie eine neue Ephemeride hoch, die den gesamten Kontaktzeitbereich abdeckt. Wenn der Zeitraum der Ephemeride nicht verlängert werden kann, stornieren Sie den Kontakt und reservieren Sie für den Zeitraum der Ephemeride einen neuen Kontakt. Weitere Informationen finden Sie unter Stellen Sie benutzerdefinierte Ephemeridendaten bereit.
EPHEMERIS_NOT_ENABLED Die referenzierte Ephemeride befindet sich in keinem Zustand. ENABLED Überprüfen Sie den Status der Ephemeride und aktivieren Sie ihn, bevor Sie das Update erneut versuchen.
SATELLITE_DOES_NOT_MATCH_EPHEMERIS Die Ephemeride ist nicht mit dem in der Aktualisierungsanfrage angegebenen Satelliten verknüpft. Stellen Sie sicher, dass der zu dem in angegebenen Satelliten ephemerisId gehört. satelliteArn
NOT_ONBOARDED_TO_AZEL_EPHEMERIS Ihr Konto ist nicht für die Verwendung von Azimut-Elevations-Ephemeridendaten an der Bodenstation des Kontakts zugelassen. Die Azimut-Elevation-Ephemeride ist eine eingeschränkte Funktion, die für eine begrenzte Anzahl von speziellen Anwendungsfällen verfügbar ist. Wenn für Ihren Anwendungsfall eine Azimut-Elevation-Ephemeride erforderlich ist, öffnen Sie ein Ticket über das, um Zugriff zu beantragen. AWS Support AWS Support Center Console Erwägen Sie alternativ die Verwendung von TLE-Ephemeridendaten oder OEM-Ephemeridendaten, sofern diese zu Ihrem Anwendungsfall passen.
AZEL_EPHEMERIS_NOT_FOUND Die Azimut-Elevations-Ephemeride, auf die in der Anfrage verwiesen wird, ist nicht vorhanden. Überprüfen Sie das ephemerisId und stellen Sie sicher, dass die Azimut-Elevation-Ephemeride nicht gelöscht wurde.
AZEL_EPHEMERIS_WRONG_GROUND_STATION Die Azimut-Elevations-Ephemeride wurde für eine andere Bodenstation als die vom Kontakt verwendete erstellt. Laden Sie eine neue Azimut-Elevations-Ephemeride für die richtige Bodenstation hoch oder verwenden Sie eine bestehende Ephemeride, die mit der Bodenstation des Kontakts übereinstimmt.
AZEL_EPHEMERIS_INVALID_STATUS Die Azimuthöhen-Ephemeride befindet sich nicht in einem für die Verwendung gültigen Zustand. Überprüfen Sie den Status der Ephemeride. Es muss in einem ENABLED Staat sein. Wenn die Ephemeride nicht validiert werden konnte, laden Sie eine korrigierte Version hoch.
AZEL_EPHEMERIS_TIME_RANGE_INVALID Die Azimut-Elevations-Ephemeride deckt nicht den Zeitraum des Kontakts ab. Laden Sie eine neue Azimut-Elevations-Ephemeride hoch, die den gesamten Kontaktzeitbereich abdeckt. Wenn der Zeitbereich der Ephemeride nicht verlängert werden kann, brechen Sie den Kontakt ab und reservieren Sie für den Zeitraum der Ephemeride einen neuen Kontakt.

Überprüfen Sie den Status eines Updates

Nach dem Anruf UpdateContact startet die neue Kontaktversion im UPDATING Status. Während dieser Zeit DescribeContactwird weiterhin die zuvor aktive Version des Kontakts zurückgegeben. Die neue Version erscheint DescribeContact erst, wenn sie an die Antenne übertragen wurde und den ACTIVE Status erreicht hat. Um den Status einer bestimmten Version zu überprüfen, verwenden Sie DescribeContactVersion.

Gehen Sie wie folgt vor, um festzustellen, ob ein Update erfolgreich war oder fehlgeschlagen ist:

  1. Rufen Sie DescribeContactVersionmit der contactId und geben Sie mit der UpdateContact Antwort versionId zurück.

  2. Überprüfe das version.status Feld. Der Status ACTIVE bedeutet, dass das Update erfolgreich installiert wurde. Der Status FAILED_TO_UPDATE bedeutet, dass das Update fehlgeschlagen ist.

  3. Wenn der Status lautetFAILED_TO_UPDATE, überprüfen Sie die version.failureMessage Felder version.failureCodes und, um zu erfahren, was schief gelaufen ist.

Tipp

Einige AWS SDKs und andere AWS Command Line Interface unterstützen einen ContactUpdated Kellner, der automatisch fragt, DescribeContactVersion bis die Version den Status ACTIVE oder FAILED_TO_UPDATE erreicht hat. Zum Beispiel AWS Command Line Interface stellt der den Befehl aws groundstation wait contact-updated bereit. Verwenden Sie den Kellner, anstatt Ihre eigene Abfragelogik zu implementieren.