Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memecahkan masalah ephemerides yang tidak valid
<a name="troubleshooting-invalid-ephemerides"></a>

 Saat Anda mengunggah data ephemeris ke AWS Ground Station, data tersebut akan melalui alur kerja validasi asinkron. Jika validasi gagal, status ephemeris akan berubah menjadi. `INVALID` Pesan kesalahan dalam [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)respons memberikan informasi terperinci untuk membantu Anda mengidentifikasi dan menyelesaikan masalah. 

## Memahami kesalahan validasi ephemeris
<a name="w2aac74c19b5"></a>

 Ketika ephemeris gagal validasi, respons [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)API mencakup dua bidang untuk membantu mendiagnosis masalah: 

errorCode  
Kode yang dapat dibaca mesin yang mengidentifikasi kesalahan validasi spesifik. Ini dapat digunakan untuk penanganan kesalahan terprogram.

errorMessage  
Deskripsi kesalahan validasi yang dapat dibaca manusia dengan detail spesifik tentang apa yang salah dan panduan tentang cara memperbaikinya.

 Contoh [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)respons untuk ephemeris yang tidak valid: 

```
{
    "ephemerisId": "abc12345-6789-def0-1234-567890abcdef",
    "name": "My Invalid Ephemeris",
    "status": "INVALID",
    "creationTime": 1620254718.765,
    "invalidReason": "METADATA_INVALID",
    "errorCode": "OBJECT_NAME_MISSING",
    "errorMessage": "Metadata field missing: OBJECT_NAME",
    "suppliedData": {
        "tle": {
            "ephemerisData": "[...]"
        }
    }
}
```

## Kesalahan validasi umum untuk ephemerides TLE
<a name="w2aac74c19b7"></a>

 Berikut ini adalah kesalahan validasi umum yang ditemui saat mengunggah ephemerides TLE: 

Nomor katalog satelit yang tidak cocok  
 *Kesalahan:* “Nomor katalog satelit yang ada di ephemeris tidak cocok dengan nomor katalog satelit satelit terkait”   
 *Solusi:* Verifikasi bahwa nomor ID/satellite katalog NORAD di baris TLE Anda cocok dengan nomor katalog satelit satelit satelit Anda. Gunakan `00000` untuk satelit tanpa nomor katalog yang ditetapkan. 

Gerakan rata-rata tidak valid  
 *Kesalahan:* “Gerakan rata-rata dari ephemeris yang disediakan terlalu berbeda dari ephemeris referensi terbaru”   
 *Solusi:* Verifikasi bahwa data TLE Anda benar dan mewakili orbit yang valid. Ground Station menggunakan ephemerides Space-Track sebagai referensi selama validasi. 

## Kesalahan validasi umum untuk ephemerides OEM
<a name="w2aac74c19b9"></a>

 Berikut ini adalah kesalahan validasi umum yang ditemui saat mengunggah ephemerides OEM: 

Kerangka referensi tidak valid  
 *Kesalahan:* “REF\_FRAME tidak didukung”   
 *Solusi:* Perbarui file OEM Anda untuk menggunakan salah satu kerangka referensi yang didukung: EME2000 atau ITRF2000. 

Kolom wajib tidak ada  
 *Kesalahan:* “Bidang metadata hilang: INTERPOLASI”   
 *Solusi:* Tambahkan bidang INTERPOLASI dan INTERPOLATION\_DEGREE ke bagian metadata OEM Anda. Ini diperlukan AWS Ground Station untuk menghasilkan sudut penunjuk antena yang akurat. 

Sistem waktu yang tidak didukung  
 *Kesalahan:* “TIME\_SYSTEM tidak didukung”   
 *Solusi:* Pastikan file OEM Anda menggunakan UTC sebagai sistem waktu. 

Versi OEM yang tidak didukung  
 *Kesalahan:* “CCSDS\_OEM\_VERS tidak didukung”   
 *Solusi:* Pastikan file OEM Anda menggunakan CCSDS OEM versi 2.0. 

## Kesalahan validasi umum untuk ephemerides elevasi azimuth
<a name="w2aac74c19c11"></a>

 Berikut ini adalah kesalahan validasi umum yang ditemui saat mengunggah ephemerides elevasi azimuth: 

 azimuth/elevation Data hilang  
 *Kesalahan:* “Tidak ada TimeAzEl bidang yang ada di setidaknya satu AzElSegment”   
 *Solusi:* Pastikan setiap segmen dalam data elevasi azimuth Anda berisi setidaknya satu pasangan yang diberi tag waktu. azimuth/elevation 

Rentang sudut azimuth (derajat) tidak valid  
 *Kesalahan:* "AzEl az harus lebih besar dari atau sama dengan -180 dan kurang atau sama dengan 360 derajat”   
 *Solusi:* Verifikasi bahwa sudut azimuth berada dalam [-180, 360] derajat. 

Rentang sudut elevasi (derajat) tidak valid  
 *Kesalahan:* "AzEl el harus lebih besar dari atau sama dengan -90 dan kurang dari atau sama dengan 90 derajat”   
 *Solusi:* Verifikasi bahwa sudut elevasi berada dalam [-90, 90] derajat. 

Rentang sudut azimuth (radian) tidak valid  
 *Kesalahan:* "AzEl az harus lebih besar dari atau sama dengan -pi dan kurang dari atau sama dengan 2pi radian”   
 *Solusi:* Verifikasi bahwa sudut azimuth berada dalam radian [-π, 2π]. 

Rentang sudut elevasi tidak valid (radian)  
 *Kesalahan:* "AzEl el harus lebih besar dari atau sama dengan -pi/2 dan kurang dari atau sama dengan pi/2 radian”   
 *Solusi:* Verifikasi bahwa sudut elevasi berada dalam radian [-π/2, π/2]. 

Nilai waktu non-monotonik  
 *Kesalahan:* “ TimeAzEl Item di dalam a AzElSegment harus berurutan sementara”   
 *Solusi:* Pastikan bahwa nilai waktu di setiap segmen meningkat secara ketat. 

Segmen rusak  
 *Kesalahan:* "AzElSegments harus secara temporal dalam urutan”   
 *Solusi:* Pastikan segmen disusun dalam urutan kronologis. 

Segmen yang tumpang tindih  
 *Kesalahan:* “Rentang waktu setidaknya satu segmen tumpang tindih dengan rentang waktu segmen lainnya”   
 *Solusi:* Pastikan setiap segmen memiliki rentang waktu yang unik dan tidak tumpang tindih. Satu `endTime` segmen tidak boleh melebihi `startTime` segmen berikutnya. 

## Langkah pemecahan masalah
<a name="w2aac74c19c13"></a>

 Jika ephemeris Anda gagal validasi, ikuti langkah-langkah berikut untuk mengatasi masalah: 

1. Panggil [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)dengan ID ephemeris Anda untuk mengambil dan. `errorCode` `errorMessage`

1. Tinjau pesan galat untuk detail spesifik tentang pemeriksaan validasi yang gagal.

1. Perbaiki masalah yang diidentifikasi dalam data ephemeris Anda.

1. Unggah ephemeris baru dengan data yang dikoreksi menggunakan. [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html)

1. Pantau status ephemeris baru hingga mencapai keadaan. `ENABLED`

1. Hapus ephemeris yang tidak valid menggunakan [DeleteEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DeleteEphemeris.html)jika tidak lagi diperlukan.

## Referensi kode kesalahan lengkap
<a name="w2aac74c19c15"></a>

 Bagian berikut memberikan pemetaan komprehensif dari semua `errorCode` nilai yang dapat dikembalikan ketika validasi ephemeris gagal, diatur oleh kategori tingkat tinggi. `invalidReason` 

### Alasan Tidak Valid: `METADATA_INVALID`
<a name="w2aac74c19c15b5"></a>

 Kesalahan ini terjadi ketika bidang metadata yang diperlukan hilang, salah diformat, atau berisi nilai yang tidak didukung dalam data ephemeris. 


| Kode Kesalahan | Pesan Kesalahan | 
| --- | --- | 
| MISMATCHED\_SATCAT\_ID | Nomor katalog satelit yang ada di ephemeris TLE tidak cocok dengan nomor katalog satelit satelit terkait | 
| OEM\_VERSION\_TIDAK DIDUKUNG | CCSDS\_OEM\_VERSDalam ephemeris OEM tidak didukung. Nilai yang didukung: [2.0] | 
| ORIGINATOR\_MISSING | Bidang ORIGINATOR header hilang dari ephemeris OEM | 
| CREATION\_DATE\_MISSING | Bidang CREATION\_DATE header hilang dari ephemeris OEM | 
| OBJECT\_NAME\_MISSING | Bidang OBJECT\_NAME metadata hilang dari ephemeris OEM | 
| OBJECT\_ID\_MISSING | Bidang OBJECT\_ID metadata hilang dari ephemeris OEM | 
| REF\_FRAME\_UNSUPPORTED | REF\_FRAMEDalam ephemeris OEM tidak didukung. Nilai yang didukung: [EME2000,ITRF2000] | 
| REF\_FRAME\_EPOCH\_UNSUPPORTED | Bidang REF\_FRAME\_EPOCH metadata di ephemeris OEM tidak didukung. Harap hapus bidang ini dari ephemeris | 
| TIME\_SYSTEM\_UNSUPPORTED | TIME\_SYSTEMDalam ephemeris OEM tidak didukung. Nilai yang didukung: [UTC] | 
| CENTER\_BODY\_UNSUPPORTED | CENTER\_BODYDalam ephemeris OEM tidak didukung. Nilai yang didukung: [Earth] | 
| INTERPOLASI\_HILANG | Bidang INTERPOLATION metadata hilang dari ephemeris OEM | 
| INTERPOLATION\_DEGREE\_INVALID | Tingkat interpolasi dalam ephemeris OEM harus lebih besar dari 0 untuk metode interpolasi | 
| AZ\_EL\_SEGMENT\_LIST\_MISSING | [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html)Bidang hilang | 
| INSUFFICIENT\_TIME\_AZ\_EL | Tidak ada [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)bidang yang ada di setidaknya satu [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegments.html) | 

### Alasan Tidak Valid: `TIME_RANGE_INVALID`
<a name="w2aac74c19c15b7"></a>

 Kesalahan ini terjadi ketika ephemeris berisi rentang waktu yang tidak valid, termasuk masalah dengan start/end waktu, urutan segmen, segmen yang tumpang tindih, atau inkonsistensi temporal. 


| Kode Kesalahan | Pesan Kesalahan | 
| --- | --- | 
| START\_TIME\_IN\_FUTURE | Waktu mulai Ephemeris ada di masa depan, tetapi harus di masa lalu | 
| END\_TIME\_IN\_PAST | Waktu akhir Ephemeris ada di masa lalu, tetapi harus di masa depan | 
| KEDALUWARSA\_TIME\_TOO\_EARLY | Waktu kedaluwarsa yang diberikan lebih awal dari waktu akhir ephemeris | 
| START\_TIME\_METADATA\_TOO\_EARLY | Nilai START\_TIME metadata lebih awal dari waktu paling awal yang ada dalam data ephemeris OEM | 
| STOP\_TIME\_METADATA\_TOO\_LATE | Nilai STOP\_TIME metadata lebih lambat dari waktu terakhir yang ada dalam data ephemeris OEM | 
| AZ\_EL\_SEGMENT\_END\_TIME\_BEFORE\_START\_TIME | Setidaknya satu segmen data sebelum segmen [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ISO8601TimeRange.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ISO8601TimeRange.html) | 
| AZ\_EL\_SEGMENT\_TIMES\_TUMPANG TINDIH | Rentang waktu setidaknya satu segmen tumpang tindih dengan rentang waktu segmen lainnya | 
| AZ\_EL\_SEGMENTS\_OUT\_OF\_ORDER | Segmen tidak diurutkan secara temporal | 
| TIME\_AZ\_EL\_ITEMS\_OUT\_OF\_ORDER | [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)Item di dalam a [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegment.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AzElSegment.html)harus secara temporal dalam urutan | 
| AZ\_EL\_SEGMENT\_REFERENCE\_EPOCH\_TIDAK VALID | Epoch referensi untuk segmen tidak valid atau salah diformat | 
| AZ\_EL\_SEGMENT\_START\_TIME\_TIDAK VALID | Waktu mulai dalam rentang waktu valid segmen tidak dimulai setelah segmen pertama | 
| AZ\_EL\_SEGMENT\_END\_TIME\_TIDAK VALID | Waktu akhir dalam rentang waktu valid segmen tidak berakhir setelah segmen terakhir | 
| AZ\_EL\_SEGMENT\_VALID\_TIME\_RANGE\_TIDAK VALID | Rentang waktu yang valid untuk segmen tidak valid | 
| AZ\_EL\_SEGMENT\_END\_TIME\_TOO\_LATE | Waktu akhir suatu segmen melebihi durasi maksimum yang diizinkan dari zaman referensi | 
| AZ\_EL\_TOTAL\_DURATION\_TERLAMPAUI | Total durasi di semua segmen melebihi durasi sudut penunjuk maksimum yang diizinkan | 

### Alasan Tidak Valid: `TRAJECTORY_INVALID`
<a name="w2aac74c19c15b9"></a>

 Kesalahan ini terjadi ketika ephemeris berisi data lintasan yang tidak valid, termasuk masalah dengan parameter orbital, rentang sudut, atau unit. 


| Kode Kesalahan | Pesan Kesalahan | 
| --- | --- | 
| MEAN\_MOTION\_INVALID | Gerakan rata-rata ephemeris TLE yang disediakan sangat berbeda dari ephemeris referensi terbaru. Catatan: Ground Station menggunakan ephemerides Space-Track sebagai referensi selama validasi | 
| TIME\_AZ\_EL\_AZ\_RADIAN\_RANGE\_TIDAK VALID | AzEl [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)harus lebih besar dari atau sama dengan -π dan kurang dari atau sama dengan 2π radian | 
| TIME\_AZ\_EL\_EL\_RADIAN\_RANGE\_TIDAK VALID | AzEl [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)harus lebih besar dari atau sama dengan -π/2 dan kurang dari atau sama dengan π/2 radian | 
| TIME\_AZ\_EL\_AZ\_DEGREE\_RANGE\_INVALID | AzEl [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)harus lebih besar dari atau sama dengan -180 dan kurang atau sama dengan 360 derajat | 
| TIME\_AZ\_EL\_EL\_DEGREE\_RANGE\_INVALID | AzEl [https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_TimeAzEl.html)harus lebih besar dari atau sama dengan -90 derajat dan kurang dari atau sama dengan 90 derajat | 
| TIME\_AZ\_EL\_ANGLE\_UNITS\_TIDAK VALID | Satuan sudut tidak valid AzEl  | 

### Alasan Tidak Valid: `KMS_KEY_INVALID`
<a name="w2aac74c19c15c11"></a>

 Kesalahan ini terjadi ketika ada masalah dengan kunci AWS Key Management Service (KMS) AWS Management Service yang digunakan untuk mengenkripsi data ephemeris. 


| Kode Kesalahan | Pesan Kesalahan | 
| --- | --- | 
| INSUFFICIENT\_KMS\_PERMISSIONS | Ground Station tidak memiliki izin yang cukup untuk mengakses kunci KMS ephemeris ini | 

### Alasan Tidak Valid: `VALIDATION_ERROR`
<a name="w2aac74c19c15c13"></a>

 Kesalahan ini terjadi ketika ada masalah validasi umum dengan data ephemeris yang tidak termasuk dalam kategori spesifik lainnya. 


| Kode Kesalahan | Pesan Kesalahan | 
| --- | --- | 
| INTERNAL\_ERROR | Kesalahan internal terjadi selama validasi ephemeris | 
| FILE\_FORMAT\_TIDAK VALID | Format file ephemeris tidak valid atau rusak. Verifikasi file sesuai dengan format yang diharapkan untuk jenis ephemeris |