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 [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)API 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](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html), die nicht aktualisiert werden konnte.
Weitere Informationen zur Versionierung von Kontakten finden Sie unter. [Kontakte und Kontaktversionierung aktualisieren](contacts.versioning.md)
## Fehler bei der synchronen Überprüfung
Die folgenden Fehler werden direkt in der HTTP-Antwort zurückgegeben, wenn die Überprüfung der [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)Anforderung 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.
1. Vergewissern Sie sich, dass Sie Anmeldeinformationen für das AWS Konto verwenden, dem der Kontakt gehört.
1. Verwenden Sie [ListContacts](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListContacts.html), um das Richtige zu finden`contactId`.
### ConflictException: Kontakt kann nicht aktualisiert werden
**Häufiger Grund**
Der Kontakt befindet sich in einem Zustand, in dem keine Aktualisierungen zulässig sind. Die [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)API kann nur aufgerufen werden, wenn sich der Kontakt im `PASS` Status `SCHEDULED``PREPASS`, 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 [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)an, um den aktuellen Kontaktstatus zu überprüfen.
1. Wenn sich der Kontakt in einem Endstatus befindet (z. B., `COMPLETED``FAILED`, oder`CANCELLED`), kann er nicht aktualisiert werden. Ein Kontakt kann nur aktualisiert werden, wenn er sich im `PASS` Status `SCHEDULED``PREPASS`, oder befindet. Eine vollständige Liste der Terminalstatus finden Sie unter[AWS Ground Station Status der Kontakte](contacts.lifecycle.md#contact-statuses).
1. 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 [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)API 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 leer`clientToken`.
+ 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](providing-azimuth-elevation-ephemeris-data.md) Genehmigung erteilt wurde.
+ Fehlt`AzElProgramTrackSettings`, wenn ist Null. `satelliteArn`
+ Bereitstellung eines`ephemerisId`, das nicht mit dem angegebenen verknüpft ist`satelliteArn`.
+ 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](how-it-works.config.md#how-it-works.config-antenna-downlink-demod-decode) 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.
1. Stellen Sie sicher, dass Sie `ProgramTrackSettings` pro Anfrage genau einen Typ angeben.
1. Wenn Sie azimuth/elevation Zeigewinkel ohne A verwenden`satelliteArn`, 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](providing-azimuth-elevation-ephemeris-data.md).
1. 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 [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)wird 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](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html), 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](https://console.aws.amazon.com/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](providing-custom-ephemeris-data.md). |
| 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](providing-azimuth-elevation-ephemeris-data.md) 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](https://console.aws.amazon.com/support) Erwägen Sie alternativ die Verwendung von [TLE-Ephemeridendaten oder OEM-Ephemeridendaten](providing-tle-ephemeris-data.md)[, sofern diese zu Ihrem Anwendungsfall passen](providing-oem-ephemeris-data.md). |
| AZEL\_EPHEMERIS\_NOT\_FOUND | Die [Azimut-Elevations-Ephemeride, auf die in der Anfrage verwiesen wird, ist](providing-azimuth-elevation-ephemeris-data.md) 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](providing-azimuth-elevation-ephemeris-data.md) 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](providing-azimuth-elevation-ephemeris-data.md) 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](providing-azimuth-elevation-ephemeris-data.md) 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 [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)wird 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](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html).
Gehen Sie wie folgt vor, um festzustellen, ob ein Update erfolgreich war oder fehlgeschlagen ist:
1. Rufen Sie [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)mit der `contactId` und geben Sie mit der `UpdateContact` Antwort `versionId` zurück.
1. Ü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.
1. Wenn der Status lautet`FAILED_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](https://docs.aws.amazon.com/cli/latest/reference/groundstation/wait/contact-updated.html) contact-updated bereit. Verwenden Sie den Kellner, anstatt Ihre eigene Abfragelogik zu implementieren.