View a markdown version of this page

Risolvi i problemi relativi agli aggiornamenti dei contatti non riusciti - AWS Ground Station
Errori di convalida sincroniCodici di errore asincroniVerifica dello stato di un aggiornamento

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risolvi i problemi relativi agli aggiornamenti dei contatti non riusciti

Quando chiami l'UpdateContactAPI, AWS Ground Station esegue la convalida sincrona sulla richiesta. Se la convalida ha esito positivo, l'aggiornamento viene elaborato in modo asincrono per propagare le modifiche alla regione dell'antenna. Gli errori di convalida sincroni vengono restituiti direttamente nella risposta HTTP. Gli errori asincroni vengono segnalati tramite failureCodes i failureMessage campi della versione di contatto, che puoi visualizzare richiamando DescribeContactVersionla versione che non è stata aggiornata.

Per ulteriori informazioni sul controllo delle versioni dei contatti, consulta. Aggiorna i contatti e il controllo delle versioni dei contatti

Errori di convalida sincroni

I seguenti errori vengono restituiti direttamente nella risposta HTTP quando la UpdateContactrichiesta non viene convalidata.

ResourceNotFoundException: Contatto non trovato

Causa comune

L'oggetto specificato contactId non esiste o appartiene a un altro AWS account.

Resolution (Risoluzione)

  1. Verificare che contactId sia corretto.

  2. Conferma di utilizzare le credenziali per l' AWS account proprietario del contatto.

  3. Usa ListContactsper trovare quello correttocontactId.

ConflictException: impossibile aggiornare il contatto

Causa comune

Il contatto si trova in uno stato che non consente gli aggiornamenti. L'UpdateContactAPI può essere chiamata solo quando il contatto si trova nello PASS stato SCHEDULEDPREPASS, o. Questo errore si verifica anche se è già in corso un altro aggiornamento (l'ultima versione del contatto è disponibile nello UPDATING stato).

Resolution (Risoluzione)

  1. Chiama DescribeContactper verificare lo stato attuale del contatto.

  2. Se il contatto si trova in uno stato terminale (ad esempioCOMPLETED,FAILED, oCANCELLED), non può essere aggiornato. Un contatto può essere aggiornato solo quando si trova nello PASS stato SCHEDULEDPREPASS, o. Per un elenco completo degli stati dei terminali, vedereAWS Ground Station stati dei contatti.

  3. Se è in corso un altro aggiornamento, attendi che l'aggiornamento corrente raggiunga FAILED_TO_UPDATE lo stato ACTIVE o raggiunga lo stato prima di inviare un altro aggiornamento. Puoi sondare l'DescribeContactVersionAPI o utilizzare le utilità di convenienza per i ContactUpdated camerieri fornite da alcuni e da. AWS SDKs AWS Command Line Interface

InvalidParameterException: parametri di richiesta non validi

Causa comune

La richiesta contiene parametri non validi. Le cause più comuni includono:

  • Mancante o vuotoclientToken.

  • Diversi tipi di ProgramTrackSettings (azimut/elevazione, OEM e TLE) inclusi in un'unica richiesta. È consentito un solo tipo per richiesta.

  • Impostazione satelliteArn su zero senza approvazione per le effemeridi di elevazione dell'azimut presso la stazione terrestre del contatto.

  • satelliteArnManca quando è nullo. AzElProgramTrackSettings

  • Fornire ephemerisId un valore non associato a quanto specificatosatelliteArn.

  • Il satellite non dispone di una finestra di visibilità valida dalla stazione di terra per l'intervallo di tempo di contatto.

  • Il satellite non è a bordo della stazione di terra o non dispone della licenza richiesta dal profilo della missione.

  • Il profilo della missione include Config di decodifica demodulazione downlink antenna configurazioni, che non sono supportate per gli aggiornamenti dei contatti.

Resolution (Risoluzione)

  1. Controlla il messaggio di errore nella risposta per informazioni dettagliate su quale parametro non è valido.

  2. Assicurati di fornire esattamente un tipo ProgramTrackSettings per richiesta.

  3. Se utilizzi angoli azimuth/elevation di puntamento senza asatelliteArn, conferma che il tuo account sia approvato per questa funzionalità presso la stazione di terra. Per ulteriori informazioni, consulta Fornisci dati sulle effemeridi di elevazione dell'azimut.

  4. Verifica che le effemeridi a cui fai riferimento siano associate al satellite corretto e coprano l'intervallo di tempo di contatto.

ResourceLimitExceededException: È stato raggiunto il limite massimo di versioni

Causa comune

Il contatto ha raggiunto il numero massimo di versioni (128). Ogni chiamata a UpdateContactcrea una nuova versione e un contatto non può superare questo limite.

Resolution (Risoluzione)

  1. Questo limite non può essere aumentato. Se devi apportare ulteriori modifiche, annulla il contatto e prenotane uno nuovo.

Codici di errore asincroni

I seguenti codici di errore vengono visualizzati nel failureCodes campo di una versione di contatto con uno stato. FAILED_TO_UPDATE DescribeContactVersionUtilizzatelo per recuperare questi dettagli. Il failureMessage campo fornisce un contesto aggiuntivo sull'errore.

Codice di errore Cause comuni Risoluzione
INTERNAL_ERROR Si è verificato un errore interno imprevisto durante l'elaborazione dell'aggiornamento. Riprova a eseguire l'aggiornamento. Se il problema persiste, contatta Supporto AWS.
INVALID_SATELLITE_ARN L'ARN satellitare fornito nella richiesta di aggiornamento non è valido o non esiste. Verifica l'ARN del satellite e conferma che il satellite sia registrato nel tuo account.
INVALID_UPDATE_CONTACT_REQUEST La richiesta di aggiornamento contiene parametri non validi che non sono stati rilevati durante la convalida sincrona. Controlla i failureMessage dettagli e correggi i parametri della richiesta.
EPHEMERIS_NOT_FOUND Le effemeridi a cui si fa riferimento nelle sostituzioni di tracciamento non esistono. Verifica ephemerisId e conferma che le effemeridi non siano state eliminate.
EPHEMERIS_TIME_RANGE_INVALID Le effemeridi non coprono l'intervallo di tempo del contatto. Carica una nuova effemeride che copra l'intero intervallo di tempo di contatto. Se l'intervallo di tempo delle effemeridi non può essere esteso, annulla il contatto e prenotane uno nuovo durante l'intervallo di tempo delle effemeridi. Per ulteriori informazioni, consulta Fornisci dati sulle effemeridi personalizzati.
EPHEMERIS_NOT_ENABLED Le effemeridi a cui si fa riferimento non si trovano in uno stato. ENABLED Controlla lo stato delle effemeridi e abilitalo prima di riprovare l'aggiornamento.
SATELLITE_DOES_NOT_MATCH_EPHEMERIS Le effemeridi non sono associate al satellite specificato nella richiesta di aggiornamento. Assicurati che ephemerisId appartenga al satellite specificato in. satelliteArn
NOT_ONBOARDED_TO_AZEL_EPHEMERIS Il tuo account non è autorizzato a utilizzare i dati delle effemeridi di elevazione azimutale presso la stazione terrestre del contatto. Le effemeridi di elevazione di Azimuth sono una funzionalità limitata disponibile per un numero limitato di casi d'uso specializzati. Se per il tuo caso d'uso sono necessarie effemeridi di elevazione azimutale, apri un ticket tramite la pagina per richiedere l'accesso. Supporto AWS AWS Support Center Console In alternativa, prendi in considerazione l'utilizzo dei dati sulle effemeridi TLE o dei dati sulle effemeridi OEM, se adatti al tuo caso d'uso.
AZEL_EPHEMERIS_NOT_FOUND Le effemeridi di elevazione azimutale a cui si fa riferimento nella richiesta non esistono. Verificate ephemerisId e confermate che le effemeridi di elevazione dell'azimut non siano state eliminate.
AZEL_EPHEMERIS_WRONG_GROUND_STATION Le effemeridi di elevazione azimutale sono state create per una stazione terrestre diversa da quella utilizzata dal contatto. Carica una nuova effemeride di elevazione azimutale per la stazione terrestre corretta o usa un'effemeride esistente che corrisponda alla stazione di terra del contatto.
AZEL_EPHEMERIS_INVALID_STATUS Le effemeridi di elevazione azimutale non sono in uno stato valido per l'uso. Controlla lo stato delle effemeridi. Deve essere in uno stato. ENABLED Se la convalida delle effemeridi non è riuscita, carica una versione corretta.
AZEL_EPHEMERIS_TIME_RANGE_INVALID Le effemeridi di elevazione azimutale non coprono l'intervallo di tempo del contatto. Carica una nuova effemeride di elevazione azimutale che copra l'intero intervallo di tempo di contatto. Se l'intervallo di tempo delle effemeridi non può essere esteso, annulla il contatto e prenotane uno nuovo durante l'intervallo di tempo delle effemeridi.

Verifica dello stato di un aggiornamento

Dopo la chiamataUpdateContact, la nuova versione di contatto viene avviata nello UPDATING stato. Durante questo periodo, DescribeContactcontinua a restituire la versione precedentemente attiva del contatto. La nuova versione viene visualizzata solo DescribeContact dopo essere stata propagata all'antenna e aver raggiunto ACTIVE lo stato. Per verificare lo stato di una versione specifica, usa DescribeContactVersion.

Per determinare se un aggiornamento è riuscito o meno:

  1. Chiamata DescribeContactVersioncon contactId e versionId restituita dalla UpdateContact risposta.

  2. Controlla il version.status campo. Lo stato di ACTIVE indica che l'aggiornamento è stato applicato correttamente. Lo stato di FAILED_TO_UPDATE indica che l'aggiornamento non è riuscito.

  3. Se lo stato èFAILED_TO_UPDATE, controlla i version.failureMessage campi version.failureCodes e per i dettagli su cosa è andato storto.

Suggerimento

Alcuni AWS SDKs AWS Command Line Interface supportano un ContactUpdated cameriere che effettua automaticamente sondaggi DescribeContactVersion finché la versione non raggiunge ACTIVE lo stato della versione. FAILED_TO_UPDATE Ad esempio, AWS Command Line Interface fornisce un comando aws groundstation wait contact-updated. Usa il cameriere invece di implementare la tua logica di polling.