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'[UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)API, 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 [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)la 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](contacts.versioning.md)
## Errori di convalida sincroni
I seguenti errori vengono restituiti direttamente nella risposta HTTP quando la [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)richiesta 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.
1. Conferma di utilizzare le credenziali per l' AWS account proprietario del contatto.
1. Usa [ListContacts](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListContacts.html)per trovare quello corretto`contactId`.
### ConflictException: impossibile aggiornare il contatto
**Causa comune**
Il contatto si trova in uno stato che non consente gli aggiornamenti. L'[UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)API può essere chiamata solo quando il contatto si trova nello `PASS` stato `SCHEDULED``PREPASS`, 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 [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)per verificare lo stato attuale del contatto.
1. Se il contatto si trova in uno stato terminale (ad esempio`COMPLETED`,`FAILED`, o`CANCELLED`), non può essere aggiornato. Un contatto può essere aggiornato solo quando si trova nello `PASS` stato `SCHEDULED``PREPASS`, o. Per un elenco completo degli stati dei terminali, vedere[AWS Ground Station stati dei contatti](contacts.lifecycle.md#contact-statuses).
1. 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'[DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)API 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 vuoto`clientToken`.
+ 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](providing-azimuth-elevation-ephemeris-data.md).
+ `satelliteArn`Manca quando è nullo. `AzElProgramTrackSettings`
+ Fornire `ephemerisId` un valore non associato a quanto specificato`satelliteArn`.
+ 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](how-it-works.config.md#how-it-works.config-antenna-downlink-demod-decode) 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.
1. Assicurati di fornire esattamente un tipo `ProgramTrackSettings` per richiesta.
1. Se utilizzi angoli azimuth/elevation di puntamento senza a`satelliteArn`, 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](providing-azimuth-elevation-ephemeris-data.md).
1. 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 [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)crea 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` [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)Utilizzatelo 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](https://console.aws.amazon.com/support). |
| 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](providing-custom-ephemeris-data.md). |
| 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](providing-azimuth-elevation-ephemeris-data.md) 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](https://console.aws.amazon.com/support) In alternativa, prendi in considerazione l'utilizzo dei dati sulle [effemeridi TLE o dei dati sulle effemeridi](providing-tle-ephemeris-data.md) [OEM](providing-oem-ephemeris-data.md), se adatti al tuo caso d'uso. |
| AZEL\_EPHEMERIS\_NOT\_FOUND | Le effemeridi di [elevazione azimutale](providing-azimuth-elevation-ephemeris-data.md) 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](providing-azimuth-elevation-ephemeris-data.md) 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](providing-azimuth-elevation-ephemeris-data.md) 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](providing-azimuth-elevation-ephemeris-data.md). | 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 chiamata`UpdateContact`, la nuova versione di contatto viene avviata nello `UPDATING` stato. Durante questo periodo, [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)continua 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](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html).
Per determinare se un aggiornamento è riuscito o meno:
1. Chiamata [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)con `contactId` e `versionId` restituita dalla `UpdateContact` risposta.
1. 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.
1. 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](https://docs.aws.amazon.com/cli/latest/reference/groundstation/wait/contact-updated.html) contact-updated. Usa il cameriere invece di implementare la tua logica di polling.