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'[UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)API, 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 [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)la version qui n'a pas pu être mise à jour.
Pour plus d'informations sur la gestion des versions des contacts, consultez[Mettre à jour les contacts et gérer les versions des contacts](contacts.versioning.md).
## Erreurs de validation synchrones
Les erreurs suivantes sont renvoyées directement dans la réponse HTTP lorsque la [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)demande é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.
1. Vérifiez que vous utilisez les informations d'identification du AWS compte auquel appartient le contact.
1. [ListContacts](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListContacts.html)Utilisez-le pour trouver le bon`contactId`.
### ConflictException: Impossible de mettre à jour le contact
**Cause commune**
Le contact est dans un état qui n'autorise pas les mises à jour. L'[UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)API ne peut être appelée que lorsque le contact est dans l'`PASS`état `SCHEDULED``PREPASS`, 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 [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)pour vérifier l'état actuel du contact.
1. Si le contact est dans un état terminal (par exemple,, ou`CANCELLED`) `COMPLETED``FAILED`, il ne peut pas être mis à jour. Un contact ne peut être mis à jour que lorsqu'il est dans l'`PASS`état `SCHEDULED``PREPASS`, ou. Pour une liste complète des états du terminal, voir[AWS Ground Station statuts des contacts](contacts.lifecycle.md#contact-statuses).
1. 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'[DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)API 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 vide`clientToken`.
+ 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](providing-azimuth-elevation-ephemeris-data.md) du contact.
+ `AzElProgramTrackSettings`Manquant 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](how-it-works.config.md#how-it-works.config-antenna-downlink-demod-decode) 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.
1. Assurez-vous de fournir exactement un type `ProgramTrackSettings` de demande.
1. Si vous utilisez des angles de azimuth/elevation pointage sans un`satelliteArn`, 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'élévation azimutale](providing-azimuth-elevation-ephemeris-data.md).
1. 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 [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)cré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](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)À 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](https://console.aws.amazon.com/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](providing-custom-ephemeris-data.md). |
| 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](providing-azimuth-elevation-ephemeris-data.md) 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](https://console.aws.amazon.com/support) Vous pouvez également envisager d'utiliser des données [d'éphémérides TLE ou des données](providing-tle-ephemeris-data.md) [d'éphémérides OEM](providing-oem-ephemeris-data.md) 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'](providing-azimuth-elevation-ephemeris-data.md)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](providing-azimuth-elevation-ephemeris-data.md) é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](providing-azimuth-elevation-ephemeris-data.md) 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](providing-azimuth-elevation-ephemeris-data.md) 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'appel`UpdateContact`, la nouvelle version du contact démarre dans l'`UPDATING`état. Pendant ce temps, [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)continue 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](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html).
Pour déterminer si une mise à jour a réussi ou échoué, procédez comme suit :
1. Appelez [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)avec le `contactId` et `versionId` renvoyé par la `UpdateContact` réponse.
1. 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é.
1. Si le statut est le cas`FAILED_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](https://docs.aws.amazon.com/cli/latest/reference/groundstation/wait/contact-updated.html). Utilisez le serveur au lieu d'implémenter votre propre logique de sondage.