Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memecahkan masalah pembaruan kontak yang gagal
Saat Anda memanggil [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)API, AWS Ground Station lakukan validasi sinkron pada permintaan. Jika validasi berlalu, pembaruan diproses secara asinkron untuk menyebarkan perubahan ke wilayah antena. Kesalahan validasi sinkron dikembalikan langsung dalam respons HTTP. Kegagalan asinkron dilaporkan melalui `failureCodes` dan `failureMessage` bidang pada versi kontak, yang dapat Anda lihat dengan memanggil [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)versi yang gagal diperbarui.
Untuk informasi selengkapnya tentang pembuatan versi kontak, lihat. [Perbarui kontak dan versi kontak](contacts.versioning.md)
## Kesalahan validasi sinkron
Kesalahan berikut dikembalikan langsung dalam respons HTTP ketika [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)permintaan gagal validasi.
### ResourceNotFoundException: Kontak tidak ditemukan
**Penyebab umum**
Yang ditentukan `contactId` tidak ada atau milik AWS akun yang berbeda.
**Resolusi**
1. Verifikasi bahwa `contactId` sudah benar.
1. Konfirmasikan bahwa Anda menggunakan kredensi untuk AWS akun yang memiliki kontak.
1. Gunakan [ListContacts](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListContacts.html)untuk menemukan yang benar`contactId`.
### ConflictException: Tidak dapat memperbarui kontak
**Penyebab umum**
Kontak berada dalam keadaan yang tidak mengizinkan pembaruan. [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)API hanya dapat dipanggil ketika kontak berada di`SCHEDULED`,`PREPASS`, atau `PASS` status. Kesalahan ini juga terjadi jika pembaruan lain sudah berlangsung (versi kontak terbaru dalam `UPDATING` status).
**Resolusi**
1. Hubungi [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)untuk memeriksa status kontak saat ini.
1. Jika kontak dalam status terminal (misalnya,, `COMPLETED``FAILED`, atau`CANCELLED`), itu tidak dapat diperbarui. Kontak hanya dapat diperbarui ketika berada di`SCHEDULED`,`PREPASS`, atau `PASS` status. Untuk daftar lengkap status terminal, lihat[AWS Ground Station status kontak](contacts.lifecycle.md#contact-statuses).
1. Jika pembaruan lain sedang berlangsung, tunggu pembaruan saat ini mencapai `ACTIVE` atau `FAILED_TO_UPDATE` status sebelum mengirimkan pembaruan lain. Anda dapat melakukan polling [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)API, atau menggunakan utilitas kenyamanan `ContactUpdated` pelayan yang disediakan oleh beberapa orang AWS SDKs dan. AWS Command Line Interface
### InvalidParameterException: Parameter permintaan tidak valid
**Penyebab umum**
Permintaan berisi parameter yang tidak valid. Penyebab umum meliputi:
+ Hilang atau kosong`clientToken`.
+ Beberapa jenis `ProgramTrackSettings` (azimuth/elevasi, OEM, dan TLE) termasuk dalam satu permintaan. Hanya satu jenis yang diizinkan per permintaan.
+ Pengaturan `satelliteArn` ke nol tanpa disetujui untuk [ephemeris elevasi azimuth](providing-azimuth-elevation-ephemeris-data.md) di stasiun bumi kontak.
+ Hilang `AzElProgramTrackSettings` `satelliteArn` saat nol.
+ Menyediakan `ephemerisId` yang tidak terkait dengan yang ditentukan`satelliteArn`.
+ Satelit tidak memiliki jendela visibilitas yang valid dari stasiun bumi untuk rentang waktu kontak.
+ Satelit tidak terpasang ke stasiun bumi atau tidak memiliki lisensi yang diperlukan oleh profil misi.
+ Profil misi menyertakan [Antena Downlink Demod Decode Config](how-it-works.config.md#how-it-works.config-antenna-downlink-demod-decode) konfigurasi, yang tidak didukung untuk pembaruan kontak.
**Resolusi**
1. Tinjau pesan kesalahan dalam respons untuk detail tentang parameter mana yang tidak valid.
1. Pastikan Anda memberikan tepat satu jenis `ProgramTrackSettings` per permintaan.
1. Jika menggunakan sudut azimuth/elevation penunjuk tanpa a`satelliteArn`, konfirmasikan bahwa akun Anda disetujui untuk kemampuan ini di stasiun bumi. Untuk informasi selengkapnya, lihat [Berikan data ephemeris elevasi azimuth](providing-azimuth-elevation-ephemeris-data.md).
1. Verifikasi bahwa ephemeris yang Anda referensikan dikaitkan dengan satelit yang benar dan mencakup rentang waktu kontak.
### ResourceLimitExceededException: Batas versi maksimum tercapai
**Penyebab umum**
Kontak telah mencapai jumlah maksimum versi (128). Setiap panggilan untuk [UpdateContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateContact.html)membuat versi baru, dan kontak tidak dapat melebihi batas ini.
**Resolusi**
1. Batas ini tidak dapat dinaikkan. Jika Anda perlu membuat perubahan lebih lanjut, batalkan kontak dan pesan yang baru.
## Kode kegagalan asinkron
Kode kegagalan berikut muncul di `failureCodes` bidang versi kontak dengan `FAILED_TO_UPDATE` status. Gunakan [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)untuk mengambil detail ini. `failureMessage`Bidang ini memberikan konteks tambahan tentang kegagalan.
| Kode kegagalan | Penyebab umum | Resolusi |
| --- | --- | --- |
| INTERNAL\_ERROR | Terjadi kesalahan internal yang tidak terduga saat memproses pembaruan. | Coba lagi pembaruan. Jika masalah berlanjut, hubungi [AWS Dukungan](https://console.aws.amazon.com/support). |
| INVALID\_SATELLITE\_ARN | ARN satelit yang disediakan dalam permintaan pembaruan tidak valid atau tidak ada. | Verifikasi ARN satelit dan konfirmasikan bahwa satelit terdaftar di akun Anda. |
| INVALID\_UPDATE\_CONTACT\_REQUEST | Permintaan pembaruan berisi parameter tidak valid yang tidak tertangkap selama validasi sinkron. | Tinjau detailnya dan perbaiki parameter permintaan. failureMessage |
| EPHEMERIS\_NOT\_FOUND | Ephemeris yang direferensikan dalam penggantian pelacakan tidak ada. | Verifikasi ephemerisId dan konfirmasikan bahwa ephemeris belum dihapus. |
| EPHEMERIS\_TIME\_RANGE\_INVALID | Ephemeris tidak mencakup rentang waktu kontak. | Unggah ephemeris baru yang mencakup rentang waktu kontak penuh. Jika rentang waktu ephemeris tidak dapat diperpanjang, batalkan kontak dan pesan yang baru selama rentang waktu ephemeris. Untuk informasi selengkapnya, lihat [Berikan data ephemeris khusus](providing-custom-ephemeris-data.md). |
| EPHEMERIS\_NOT\_ENABLED | Ephemeris yang direferensikan tidak dalam keadaan. ENABLED | Periksa status ephemeris dan aktifkan sebelum mencoba kembali pembaruan. |
| SATELLITE\_DOES\_NOT\_MATCH\_EPHEMERIS | Ephemeris tidak terkait dengan satelit yang ditentukan dalam permintaan pembaruan. | Pastikan ephemerisId milik satelit yang ditentukan dalamsatelliteArn. |
| NOT\_ONBOARDED\_TO\_AZEL\_EPHEMERIS | Akun Anda tidak disetujui untuk menggunakan [data azimuth elevation ephemeris](providing-azimuth-elevation-ephemeris-data.md) di stasiun bumi kontak. Ephemeris elevasi Azimuth adalah fitur terbatas yang tersedia untuk sejumlah kasus penggunaan khusus. | Jika azimuth elevation ephemeris diperlukan untuk kasus penggunaan Anda, buka AWS Dukungan tiket melalui untuk meminta akses. [AWS Support Center Console](https://console.aws.amazon.com/support) Atau, pertimbangkan untuk menggunakan data [ephemeris TLE atau data](providing-tle-ephemeris-data.md) [ephemeris OEM](providing-oem-ephemeris-data.md) jika sesuai dengan kasus penggunaan Anda. |
| AZEL\_EPHEMERIS\_NOT\_FOUND | [Ephemeris elevasi azimuth yang dirujuk dalam permintaan tidak ada](providing-azimuth-elevation-ephemeris-data.md). | Verifikasi ephemerisId dan konfirmasikan bahwa ephemeris elevasi azimuth belum dihapus. |
| AZEL\_EPHEMERIS\_WRONG\_GROUND\_STATION | [Ephemeris elevasi azimuth](providing-azimuth-elevation-ephemeris-data.md) dibuat untuk stasiun bumi yang berbeda dari yang digunakan oleh kontak. | Unggah ephemeris elevasi azimuth baru untuk stasiun bumi yang benar, atau gunakan ephemeris yang ada yang cocok dengan stasiun bumi kontak. |
| AZEL\_EPHEMERIS\_INVALID\_STATUS | [Ephemeris elevasi azimuth tidak dalam keadaan](providing-azimuth-elevation-ephemeris-data.md) valid untuk digunakan. | Periksa status ephemeris. Itu harus dalam ENABLED keadaan. Jika ephemeris gagal validasi, unggah versi yang diperbaiki. |
| AZEL\_EPHEMERIS\_TIME\_RANGE\_INVALID | [Ephemeris elevasi azimuth tidak](providing-azimuth-elevation-ephemeris-data.md) mencakup rentang waktu kontak. | Unggah ephemeris elevasi azimuth baru yang mencakup rentang waktu kontak penuh. Jika rentang waktu ephemeris tidak dapat diperpanjang, batalkan kontak dan pesan yang baru selama rentang waktu ephemeris. |
## Memeriksa status pembaruan
Setelah menelepon`UpdateContact`, versi kontak baru dimulai di `UPDATING` negara bagian. Selama waktu ini, [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)terus kembalikan versi kontak yang sebelumnya aktif. Versi baru tidak muncul `DescribeContact` sampai telah disebarkan ke antena dan mencapai `ACTIVE` status. Untuk memeriksa status versi tertentu, gunakan [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html).
Untuk menentukan apakah pembaruan berhasil atau gagal:
1. Panggil [DescribeContactVersion](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContactVersion.html)dengan `contactId` dan `versionId` dikembalikan oleh `UpdateContact` tanggapan.
1. Periksa `version.status` bidangnya. Status `ACTIVE` berarti pembaruan berhasil diterapkan. Status `FAILED_TO_UPDATE` berarti pembaruan gagal.
1. Jika statusnya`FAILED_TO_UPDATE`, periksa `version.failureMessage` kolom `version.failureCodes` dan untuk detail tentang apa yang salah.
**Tip**
Beberapa AWS SDKs dan AWS Command Line Interface mendukung `ContactUpdated` pelayan yang secara otomatis melakukan polling `DescribeContactVersion` hingga versi mencapai `ACTIVE` atau `FAILED_TO_UPDATE` status. Misalnya, AWS Command Line Interface menyediakan perintah [aws groundstation wait contact-updated](https://docs.aws.amazon.com/cli/latest/reference/groundstation/wait/contact-updated.html). Gunakan pelayan alih-alih menerapkan logika polling Anda sendiri.