Kode kesalahan: Penyerapan Microsoft Planetary Computer Pro

Artikel ini mencantumkan kode kesalahan yang dapat terjadi saat menyerap atau menghapus data geospasial dari Microsoft Planetary Computer Pro GeoCatalog. Gunakan referensi ini untuk mengidentifikasi penyebab kegagalan penyerapan dan menemukan langkah-langkah resolusi untuk setiap jenis kesalahan.

Kesalahan penyerapan dapat terjadi selama berbagai tahap proses penyerapan data, termasuk autentikasi, validasi, transformasi, dan operasi penyimpanan (menambahkan dan menghapus). Tabel berikut ini menyediakan informasi terperinci tentang setiap kode kesalahan, maknanya, dan langkah-langkah untuk mengatasi masalah tersebut.

Tabel Kode Kesalahan:

Kode Penjelasan Penyelesaian Masalah
AssetTransformationError Sistem gagal mengubah aset selama pemasukan. • Verifikasi file aset dalam format yang didukung
• Periksa apakah file aset tidak rusak
• Pastikan URL aset dapat diakses dari sumber pengambilan data Anda
CogTransformationError Proses transformasi Cloud Optimized GeoTIFF (COG) gagal. • Pastikan file sumber adalah file GeoTIFF yang valid dengan informasi georeferensi yang tepat
• Validasi file Anda dengan alat GDAL sebelum penyerapan
CogTransformationTimeout Proses transformasi COG melebihi batas waktu, biasanya dengan file yang sangat besar. • Pisahkan file besar menjadi bagian yang lebih kecil
• Mengonversi file ke format COG sebelum penyerapan untuk melewati transformasi
CanceledOperation Operasi penyerapan dibatalkan atau dihentikan secara manual. • Tidak ada tindakan yang diperlukan untuk pembatalan yang disengaja
• Periksa log sistem untuk alasan pembatalan otomatis
CollectionDoesNotExist ID koleksi STAC yang dirujuk dalam permintaan penyerapan Anda tidak ada. Buat koleksi sebelum mencoba menyerap item ke dalamnya
EmptyAsset File aset yang dirujuk dalam item STAC tidak memiliki konten atau 0 byte. • Verifikasi file aset ada di URL yang ditentukan
• Pastikan file aset berisi data yang valid
ErrorsInBatchOperation Satu atau beberapa item dalam operasi penyerapan massal gagal. • Periksa detail operasi untuk kegagalan item tertentu
• Coba serap item yang gagal satu per satu untuk mengisolasi masalah
GenericHttpIngestionError Terjadi kesalahan HTTP umum saat mengakses sumber daya ingestasi. • Periksa konektivitas jaringan
• Verifikasi bahwa semua URL aset dapat diakses
• Tinjau kode status HTTP dalam log untuk masalah tertentu
GenericIngestionError Terjadi kesalahan yang tidak ditentukan selama penyerapan. • Periksa pesan kesalahan terperinci dan log sistem
• Hubungi dukungan jika masalah berlanjut
ImportFileValidationFailed Katalog STAC atau file koleksi gagal divalidasi. Pemecahan masalah kesalahan validasi STAC
IngestionAuthenticationFailed GeoCatalog tidak dapat mengautentikasi ke sumber penyerapan. Pemecahan masalah pada masalah izin akses
IngestionResourceConnectionFailed Tidak dapat membuat koneksi ke kontainer penyimpanan. Memecahkan masalah hak akses izin
IngestionResourceForbidden GeoCatalog tidak memiliki izin untuk mengakses sumber daya. Pemecahan masalah akses izin
IngestionResourceTimeout Permintaan untuk mengakses sumber penyerapan melebihi batas waktu. • Coba lagi operasi
• Periksa kesehatan layanan Azure untuk pemadaman
• Memverifikasi konektivitas jaringan antara GeoCatalog dan penyimpanan
IngestionResourceUriNotFound Aset atau URI katalog yang ditentukan tidak ada. Mengatasi masalah izin akses
InternalError Terjadi kesalahan tak terduga dalam layanan GeoCatalog. • Coba lagi operasi
• Jika kesalahan berlanjut, hubungi dukungan dengan ID operasi dan tanda waktu
InternalIntermitentError Terjadi kesalahan internal sementara. • Tunggu beberapa menit dan coba lagi operasi
• Kesalahan ini biasanya diselesaikan secara otomatis
InvalidAssetHref URL aset dalam item STAC salah bentuk atau tidak valid. • Pastikan semua href asset diformat sebagai URL yang benar
• Gunakan URL absolut, bukan jalur relatif
• Verifikasi semua URL yang mengarah ke sumber daya yang dapat diakses
InvalidGeoparquet File GeoParquet tidak memenuhi spesifikasi format yang diperlukan. • Memvalidasi file GeoParquet menggunakan alat yang sesuai
• Pastikan file berisi kolom geometri yang valid
InvalidInputData Item STAC atau data pengumpulan berisi bidang atau nilai yang tidak valid. Pemecahan masalah kesalahan validasi STAC
InvalidStacCatalog Struktur katalog STAC tidak sesuai dengan spesifikasi. Pemecahan masalah kesalahan validasi STAC
ItemAlreadyExistsInCollection Item STAC dengan ID yang sama sudah ada di koleksi. • Gunakan ID unik untuk setiap item
• Hapus item yang ada sebelum mencoba menyerap lagi
ItemSizeExceeded Item STAC JSON melebihi ukuran maksimum yang diizinkan (1 MB). • Mengurangi jumlah aset atau properti dalam item
• Membagi item besar menjadi beberapa item yang lebih kecil
ItemTransformationError Gagal memproses atau mengubah item STAC. Pemecahan masalah kesalahan validasi STAC
ManagedIdentityInfoNotFound Identitas terkelola yang ditentukan tidak ada atau tidak terkait dengan GeoCatalog. Mengatasi masalah izin akses
NoRecordsToDelete Operasi penghapusan tidak menemukan rekaman yang cocok. • Verifikasi ID item STAC atau kriteria pencarian yang digunakan untuk penghapusan
• Konfirmasi item ada dalam koleksi yang ditentukan
NoRecordsToPatch Operasi patch tidak menemukan rekaman yang cocok. • Pastikan item STAC yang Anda coba perbarui ada dalam koleksi
• Verifikasi ID item sudah benar
NoRecordsToUpdate Operasi pembaruan tidak menemukan rekaman yang cocok. • Verifikasi bahwa item ada sebelum mencoba pembaruan
• Periksa ID item dan ID koleksi untuk akurasi
OperationIsCanceled Operasi pemasukan dibatalkan sebelum selesai. • Periksa apakah pembatalan disengaja
• Meninjau log sistem untuk pemicu pembatalan otomatis
OperationNotExistsInCollection ID operasi yang dirujuk tidak ada untuk koleksi ini. • Verifikasi bahwa Anda menggunakan ID operasi dan koleksi yang benar
PatchValidation Operasi patch berisi data atau operasi yang tidak valid. • Pastikan patch Anda mengikuti spesifikasi JSON Patch
• Memverifikasi operasi patch menargetkan bidang yang valid
PostItemCollectionSizeExceeded Sekumpulan barang yang diposting melebihi batas ukuran maksimum. • Mengurangi jumlah item dalam satu permintaan
• Gunakan API penyerapan massal untuk himpunan data besar
PublicAccessRestricted Sumber daya penyimpanan tidak mengizinkan akses publik. Mengatasi masalah izin akses
StacValidationFailed Item STAC tidak memenuhi persyaratan validasi. Pemecahan masalah kesalahan validasi STAC
TotalAssetsExceeded Item STAC berisi terlalu banyak aset (maksimal 100 aset). • Mengurangi jumlah aset per item hingga di bawah 100
• Dibagi menjadi beberapa item