View a markdown version of this page

Memecahkan masalah pembaruan kontak yang gagal - AWS Ground Station
Kesalahan validasi sinkronKode kegagalan asinkronMemeriksa status pembaruan

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 UpdateContactAPI, 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 DescribeContactVersionversi yang gagal diperbarui.

Untuk informasi selengkapnya tentang pembuatan versi kontak, lihat. Perbarui kontak dan versi kontak

Kesalahan validasi sinkron

Kesalahan berikut dikembalikan langsung dalam respons HTTP ketika UpdateContactpermintaan 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.

  2. Konfirmasikan bahwa Anda menggunakan kredensi untuk AWS akun yang memiliki kontak.

  3. Gunakan ListContactsuntuk menemukan yang benarcontactId.

ConflictException: Tidak dapat memperbarui kontak

Penyebab umum

Kontak berada dalam keadaan yang tidak mengizinkan pembaruan. UpdateContactAPI hanya dapat dipanggil ketika kontak berada diSCHEDULED,PREPASS, atau PASS status. Kesalahan ini juga terjadi jika pembaruan lain sudah berlangsung (versi kontak terbaru dalam UPDATING status).

Resolusi

  1. Hubungi DescribeContactuntuk memeriksa status kontak saat ini.

  2. Jika kontak dalam status terminal (misalnya,, COMPLETEDFAILED, atauCANCELLED), itu tidak dapat diperbarui. Kontak hanya dapat diperbarui ketika berada diSCHEDULED,PREPASS, atau PASS status. Untuk daftar lengkap status terminal, lihatAWS Ground Station status kontak.

  3. Jika pembaruan lain sedang berlangsung, tunggu pembaruan saat ini mencapai ACTIVE atau FAILED_TO_UPDATE status sebelum mengirimkan pembaruan lain. Anda dapat melakukan polling DescribeContactVersionAPI, 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 kosongclientToken.

  • 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 di stasiun bumi kontak.

  • Hilang AzElProgramTrackSettings satelliteArn saat nol.

  • Menyediakan ephemerisId yang tidak terkait dengan yang ditentukansatelliteArn.

  • 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 konfigurasi, yang tidak didukung untuk pembaruan kontak.

Resolusi

  1. Tinjau pesan kesalahan dalam respons untuk detail tentang parameter mana yang tidak valid.

  2. Pastikan Anda memberikan tepat satu jenis ProgramTrackSettings per permintaan.

  3. Jika menggunakan sudut azimuth/elevation penunjuk tanpa asatelliteArn, konfirmasikan bahwa akun Anda disetujui untuk kemampuan ini di stasiun bumi. Untuk informasi selengkapnya, lihat Berikan data ephemeris elevasi azimuth.

  4. 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 UpdateContactmembuat 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 DescribeContactVersionuntuk mengambil detail ini. failureMessageBidang 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.
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.
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 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 Atau, pertimbangkan untuk menggunakan data ephemeris TLE atau data ephemeris OEM jika sesuai dengan kasus penggunaan Anda.
AZEL_EPHEMERIS_NOT_FOUND Ephemeris elevasi azimuth yang dirujuk dalam permintaan tidak ada. Verifikasi ephemerisId dan konfirmasikan bahwa ephemeris elevasi azimuth belum dihapus.
AZEL_EPHEMERIS_WRONG_GROUND_STATION Ephemeris elevasi azimuth 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 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 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 meneleponUpdateContact, versi kontak baru dimulai di UPDATING negara bagian. Selama waktu ini, DescribeContactterus 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.

Untuk menentukan apakah pembaruan berhasil atau gagal:

  1. Panggil DescribeContactVersiondengan contactId dan versionId dikembalikan oleh UpdateContact tanggapan.

  2. Periksa version.status bidangnya. Status ACTIVE berarti pembaruan berhasil diterapkan. Status FAILED_TO_UPDATE berarti pembaruan gagal.

  3. Jika statusnyaFAILED_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. Gunakan pelayan alih-alih menerapkan logika polling Anda sendiri.