Menyelesaikan masalah | Storan Awan

Halaman ini menerangkan kaedah penyelesaian masalah untuk ralat biasa yang mungkin anda hadapi semasa menggunakan Storan Awan Lihat Papan Pemuka Status Awan Google untuk mendapatkan maklumat tentang insiden serantau atau global yang mempengaruhi perkhidmatan Awan Google seperti Storan Awan ## Melog permintaan mentah Apabila menggunakan alatan seperti gcloud atau perpustakaan klien Cloud Storage, banyak maklumat permintaan dan respons dikendalikan oleh alat. Walau bagaimanapun, ia adalah kadangkala berguna untuk melihat butiran untuk membantu menyelesaikan masalah. Menggunakan arahan berikut untuk mengembalikan pengepala permintaan dan respons untuk alat anda: Konsol Melihat maklumat permintaan dan respons bergantung pada penyemak imbas yang anda gunakan untuk mengakses konsol Google Cloud. Untuk penyemak imbas Google Chrome: Klik Chrome butang menu utama ( ) Pilih Lebih Banyak Alat klik Alat Pembangun Dalam anak tetingkap yang muncul, klik butang Tab rangkaian Barisan arahan gcloud Gunakan bendera penyahpepijatan global dalam permintaan anda. Sebagai contoh: storan gcloud ls gsmy-bucket/my-object --log-http --verbosity=debug gsutil Gunakan global -D bendera dalam permintaan anda. Sebagai contoh: gsutil -D ls gsmy-baldi/objek-saya Perpustakaan pelanggan C++ Tetapkan pembolehubah persekitaran CLOUD_STORAGE_ENABLE_TRACING=httpuntuk mendapatkan trafik HTTP penuh Tetapkan pembolehubah persekitaran CLOUD_STORAGE_ENABLE_CLOG=ya untuk mendapatkan pengelogan setiap RPC C# Tambah pembalak melalui ApplicationContext.RegisterLogger, dan tetapkan pengelogan pilihan pada Pengendali mesej HttpClient. Untuk maklumat lanjut, lihat entri FAQ Pergi Tetapkan pembolehubah persekitaran GODEBUG=http2debug=1. Untuk lebih maklumat, lihat pakej Go net/http Jika anda ingin log badan permintaan juga, gunakan klien HTTP tersuai Jawa Buat fail bernama "logging.properties"dengan kandungan berikut: # Fail sifat yang mengkonfigurasi operasi kemudahan pembalakan JDK. # Sistem akan mencari fail konfigurasi ini untuk ditentukan sebagai sifat sistem: # -Djava.util.logging.config.fileproject_loc:googleplus-simple-cmdline-sample}/logging.properties # Sediakan pengendali konsol (nyahkomen "level"untuk menunjukkan lebih banyak mesej yang terperinci) pengendali = java.util.logging.ConsoleHandler java.util.logging.ConsoleHandler.level = CONFIG # Sediakan pengelogan permintaan dan respons HTTP (nyahkomen "peringkat"untuk ditunjukkan) com.google .api.client.http.level = KONFIG Gunakan logging.properties dengan Maven mvn -Djava.util.logging.config.file=path/to/logging.properties insert_command Untuk maklumat lanjut, lihat Pengangkutan HTTP Boleh Pasang Node.js Tetapkan pembolehubah persekitaran NODE_DEBUG=https sebelum memanggil Node skrip PHP Sediakan pengendali HTTP anda sendiri kepada pelanggan yang menggunakan httpHandler dan sediakan middleware untuk log permintaan dan tindak balas Ular sawa Gunakan modul pengelogan. Sebagai contoh: import logging import http.client logging.basicConfig(level=logging.DEBUG) http.client.HTTPConnection.debuglevel=5 Ruby Di bahagian atas anda .rb fail selepas memerlukan "google/cloud/storage", tambah yang berikut: ruby Google::Apis.logger.level = Logger::DEBUG ## Kod ralat Berikut ialah kod status HTTP biasa yang mungkin anda hadapi 301: Bergerak Secara Kekal **Isu saya sedang menyediakan tapak web statik dan mengakses laluan direktori mengembalikan objek kosong dan a Kod respons HTTP 301 **Penyelesaian Jika pelayar anda memuat turun objek sifar bait dan anda mendapat a 301 Kod respons HTTP apabila mengakses direktori, seperti httpwww.example.com/dir/, baldi anda kemungkinan besar mengandungi objek kosong daripada nama itu. Untuk menyemak sama ada perkara ini berlaku dan selesaikan isu tersebut: - Dalam konsol Awan Google, pergi ke Storan Awan Halaman baldi - Klik pada Aktifkan Butang Cangkang Awan di bahagian atas konsol Awan Google - Lari storan gcloud ls --rekursif gswww.example.com/dir/. Jika output termasuk httpwww.example.com/dir/, anda mempunyai objek kosong di lokasi itu - Keluarkan objek kosong dengan arahan: storan gcloud rm gswww.example.com/dir/ Anda kini boleh mengakses httpwww.example.com/dir/ dan minta ia mengembalikannya direktori fail index.html dan bukannya objek kosong 400: Permintaan Buruk **Isu Semasa melakukan muat naik boleh disambung semula, saya menerima ralat ini dan mesej itu Gagal menghuraikan pengepala Julat Kandungan **Penyelesaian Nilai yang anda gunakan dalam anda Pengepala Julat Kandungan tidak sah. Untuk contoh, Julat Kandungan:tidak sah dan sebaliknya harus dinyatakan sebagai Julat Kandungan: baitJika anda menerima ralat ini, semasa anda boleh disambung semula muat naik tidak lagi aktif dan anda mesti memulakan muat naik baharu yang boleh disambung semula 401: Tanpa kebenaran **Permintaan Keluaran kepada baldi awam secara langsung, atau melalui Cloud CDN, adalah gagal dengan a HTTP 401: Tidak dibenarkan dan a Pengesahan diperlukan tindak balas **Penyelesaian Pastikan pelanggan anda, atau mana-mana proksi perantaraan, tidak menambah Pengepala kebenaran untuk permintaan kepada Storan Awan. Sebarang permintaan dengan an Pengepala kebenaran, walaupun kosong, disahkan seolah-olah ia adalah percubaan pengesahan 403: Akaun Dilumpuhkan **Isu saya cuba mencipta baldi tetapi mendapat a Ralat 403 Akaun Dilumpuhkan **Penyelesaian Ralat ini menunjukkan bahawa anda masih belum menghidupkan pengebilan projek yang berkaitan. Untuk langkah-langkah untuk mendayakan pengebilan, lihat Dayakan pengebilan untuk projek Jika pengebilan dihidupkan dan anda terus menerima mesej ralat ini, anda boleh menghubungi sokongan dengan ID projek anda dan penerangan tentang masalah anda 403 Terlarang **Isu saya sepatutnya mempunyai kebenaran untuk mengakses baldi atau objek tertentu, tetapi apabila saya cuba berbuat demikian, saya mendapat a 403 - Ralat terlarang dengan mesej yang sama seperti: [email protected] tidak mempunyai storage.objects.get akses kepada Objek Storan Awan Google **Penyelesaian Anda kehilangan kebenaran IAM untuk baldi atau objek yang diperlukan untuk melengkapkan permintaan. Jika anda mengharapkan untuk dapat membuat permintaan tetapi tidak boleh, lakukan semakan berikut: Adakah penerima yang dirujuk dalam mesej ralat adalah yang anda jangkakan? Jika mesej ralat merujuk kepada alamat e-mel yang tidak dijangka atau kepada "Pemanggil Tanpa Nama", maka permintaan anda tidak menggunakan bukti kelayakan yang anda maksudkan. Ini mungkin kerana alat yang anda gunakan untuk membuat permintaan telah disediakan dengan bukti kelayakan daripada alias atau entiti lain, atau mungkin kerana permintaan itu dibuat bagi pihak anda oleh akaun perkhidmatan Adakah kebenaran dirujuk dalam mesej ralat yang anda fikirkan diperlukan? Jika kebenaran itu tidak dijangka, ia berkemungkinan kerana alat yang anda gunakan memerlukan akses tambahan untuk melengkapkan permintaan anda. Contohnya, untuk memadamkan objek secara pukal dalam baldi, gcloudmesti mula-mula membina senarai objek dalam baldi untuk dipadamkan. Bahagian tindakan pemadaman pukal ini memerlukan storage.objects.listpermission, yang mungkin mengejutkan, memandangkan matlamatnya ialah pemadaman objek, yang biasanya memerlukan hanya storage.objects.deletepermission. Jika ini adalah punca mesej ralat anda, pastikan anda diberikan peranan IAM yang mempunyai kebenaran tambahan yang diperlukan Adakah anda diberikan peranan IAM pada sumber yang dimaksudkan atau sumber induk? Sebagai contoh, jika anda diberikan Peranan Pemapar Objek Penyimpanan untuk projek dan anda cuba memuat turun objek, pastikan objek itu berada dalam baldi yang ada dalam projek; anda mungkin secara tidak sengaja mempunyai Kebenaran Pemapar Objek Penyimpanan untuk projek lain 403 Terlarang **Isu saya memuat turun kandungan saya dari storage.cloud.google.com, dan saya menerima a 403: Ralat terlarang apabila saya menggunakan penyemak imbas untuk menavigasi ke objek menggunakan URL: httpsstorage.cloud.google.com/ BUCKET_NAME/ OBJECT_NAME **Menggunakan Penyelesaian storage.cloud.google.com untuk memuat turun objek dikenali sebagai muat turun penyemak imbas yang disahkan, yang menggunakan pengesahan berasaskan kuki Jika anda telah mengkonfigurasikan log audit Akses Data dalam Log Audit Awan untuk dijejak akses kepada objek, salah satu sekatan ciri itu ialah muat turun penyemak imbas yang disahkan tidak boleh digunakan untuk memuat turun objek yang dijejaki, melainkan objek itu boleh dibaca. Percubaan untuk menggunakan yang disahkan muat turun pelayar untuk objek bukan awam menghasilkan a 403 respons. ini sekatan wujud untuk menghalang pancingan data untuk ID Google, yang digunakan untuk pengesahan berasaskan kuki Untuk mengelakkan masalah ini, lakukan salah satu daripada yang berikut: - Gunakan panggilan API langsung, yang menyokong muat turun tidak disahkan, bukannya menggunakan muat turun penyemak imbas yang disahkan - Lumpuhkan log audit Akses Data Storan Awan yang menjejaki akses kepada objek yang terjejas. Harap maklum bahawa log audit Akses Data ditetapkan pada atau di atas peringkat projek dan boleh didayakan serentak pada berbilang peringkat - Tetapkan pengecualian untuk mengecualikan pengguna tertentu daripada penjejakan log audit Akses Data, yang membolehkan pengguna tersebut melakukan muat turun penyemak imbas yang disahkan - Jadikan objek yang terjejas boleh dibaca, dengan memberikan kebenaran baca sama ada allUsersor allAuthenticatedUsers. Log audit Akses Data tidak merekodkan akses kepada objek awam 409: Konflik **Isu saya cuba mencipta baldi tetapi menerima ralat berikut: 409 Konflik. Maaf, nama itu tidak tersedia. Sila cuba yang lain **Penyelesaian Nama baldi yang anda cuba gunakan [cth gscats atau gsdogs] sudah diambil. Storan Awan mempunyai ruang nama global supaya anda tidak boleh menamakan a baldi dengan nama yang sama dengan baldi sedia ada. Pilih nama yang bukan sedang digunakan 429: Terlalu Banyak Permintaan **Isu Permintaan saya ditolak dengan a Ralat 429 Terlalu Banyak Permintaan **Penyelesaian Anda mencapai had kepada bilangan permintaan Storan Awan membenarkan sumber yang diberikan. Lihat Kuota Storan Awan untuk perbincangan tentang had dalam Storan Awan. Jika beban kerja anda terdiri daripada 1000 permintaan setiap kedua selepas baldi, lihat Kadar permintaan dan garis panduan pengedaran akses untuk perbincangan tentang amalan terbaik, termasuk meningkatkan beban kerja anda secara beransur-ansur dan mengelakkan nama fail berurutan ## Mendiagnosis ralat konsol Google Cloud **Isu Apabila menggunakan konsol Google Cloud untuk melaksanakan operasi, saya mendapat mesej ralat generik. Sebagai contoh, saya melihat mesej ralat apabila cuba memadam baldi, tetapi saya tidak melihat butiran mengapa operasi itu gagal. **Penyelesaian Gunakan pemberitahuan konsol Google Cloud untuk melihat butirannya maklumat tentang operasi yang gagal: Klik pada Butang Pemberitahuan dalam pengepala konsol Google Cloud Jatuh turun memaparkan operasi terbaharu yang dilakukan oleh konsol Google Cloud Klik item yang anda ingin ketahui lebih lanjut Halaman dibuka dan memaparkan maklumat terperinci tentang operasi Klik pada setiap baris untuk mengembangkan maklumat ralat terperinci Di bawah ialah contoh maklumat ralat untuk operasi pemadaman baldi yang gagal, yang menjelaskan bahawa dasar pengekalan baldi menghalang pemadaman baldi ## Ralat tapak web statik Berikut ialah isu biasa yang mungkin anda hadapi semasa menyediakan baldi untuk mengehoskan tapak web statik Pelayanan HTTPS **Isu saya ingin menyampaikan kandungan saya melalui HTTPS tanpa menggunakan pengimbang beban. **Penyelesaian Anda boleh menyampaikan kandungan statik melalui HTTPS menggunakan URI langsung seperti httpsstorage.googleapis.com/my-bucket/my-object. Untuk pilihan lain untuk menyampaikan kandungan anda melalui domain tersuai melalui SSL, anda boleh: - Gunakan Rangkaian Penghantaran Kandungan pihak ketiga dengan Storan Awan - Layankan kandungan tapak web statik anda daripada Firebase Hosting dan bukannya Cloud StoragePengesahan domain**Isu saya tidak dapat mengesahkan domain saya.**Penyelesaian Biasanya, proses pengesahan dalam Konsol Carianmengarahkan anda untuk memuat naik fail ke domain anda, tetapi anda mungkin tidak mempunyai cara untuk melakukanini tanpa terlebih dahulu mempunyai baldi yang berkaitan, yang anda hanya boleh buat*selepas* anda telah melakukan pengesahan domainDalam kes ini, sahkan pemilikan menggunakan kaedah**Pembekal nama domain** pengesahan.Lihat Pengesahan pemilikan untuk langkah-langkah untuk mencapai ini.Pengesahanini boleh dilakukan sebelum baldi dibuatHalaman tidak boleh diakses**Isu Saya mendapatMesej ralat yang ditolak akses untuk halaman web yang disediakan olehtapak web saya**Penyelesaian Semak bahawa objek dikongsi.Jika tidak, lihatMenjadikan Data Umum untuk arahan tentang cara melakukan iniJika anda pernah memuat naik dan berkongsi objek, tetapi kemudian memuat naik versi baharunya, maka anda mesti berkongsi semula objek tersebut.Ini kerana kebenaran awam digantikan dengan muat naik baharuKemas kini kebenaran gagal**Isu saya mendapat ralat apabila saya cuba membuat data saya awam.**Penyelesaian Pastikan anda mempunyaikebenaran setIamPolicy untuk objek atau baldianda.Kebenaran ini diberikan, contohnya, dalam perananPentadbir Storan.Jika anda mempunyaikebenaran setIamPolicy dan andamasih mendapat ralat, baldi anda mungkin tertakluk kepadapencegahan akses awam , yang tidak membenarkan akses kepadaallUsers atauallAuthenticatedUsers.Pencegahan akses awam mungkin ditetapkan pada baldisecara langsung, atau ia mungkin dikuatkuasakan melalui dasar organisasi yangditetapkan pada tahap yang lebih tinggiMuat turun kandungan**Isu saya digesa untuk memuat turun kandungan halaman saya, bukannya boleh melihatnya dalam penyemak imbas saya.**Penyelesaian Jika anda menentukanMainPageSuffix sebagai objek yang tidak mempunyaijenis kandungan web, maka bukannya menyajikan halaman, pelawat tapak digesa untuk memuat turun kandungan.Untuk menyelesaikan isu ini, kemas kini entri metadata jenis kandungankepada nilai yang sesuai, sepertiteks/html.Lihat Mengedit metadata objek untuk arahan tentang cara melakukan ini ## Latensi Berikut ialah isu kependaman biasa yang mungkin anda hadapi. Selain itu, Papan Pemuka Status Awan Google menyediakan maklumat tentang insiden serantau atau global yang mempengaruhi perkhidmatan Awan Google seperti Storan Awan Muat naik atau muat turun kependaman **Isu saya melihat peningkatan kependaman semasa memuat naik atau memuat turun. **Penyelesaian Gunakan arahan gsutil perfdiag untuk menjalankan prestasi diagnostik daripada persekitaran yang terjejas. Pertimbangkan punca biasa berikut kependaman muat naik dan muat turun: CPU atau kekangan memori: Sistem pengendalian persekitaran yang terjejas harus mempunyai alatan untuk mengukur penggunaan sumber tempatan seperti penggunaan CPU dan penggunaan memori Kekangan IO cakera: Sebagai sebahagian daripada gsutil perfdiagcommand, gunakan rthru_fileand wthru_filetests untuk mengukur kesan prestasi yang disebabkan oleh IO cakera tempatan Jarak geografi: Prestasi boleh dipengaruhi oleh pemisahan fizikal baldi Storan Awan anda dan persekitaran yang terjejas, terutamanya dalam kes merentas benua. Menguji dengan baldi yang terletak di rantau yang sama dengan persekitaran anda yang terjejas boleh mengenal pasti sejauh mana pemisahan geografi menyumbang kepada kependaman anda - Jika berkenaan, penyelesai DNS persekitaran yang terjejas harus menggunakan protokol EDNS(0) supaya permintaan daripada persekitaran disalurkan melalui Google Front End yang sesuai CLI atau kependaman perpustakaan pelanggan **Isu saya melihat peningkatan kependaman apabila mengakses Storan Awan dengan storan gcloud, gsutil atau salah satu perpustakaan pelanggan **Penyelesaian CLI dan perpustakaan pelanggan mencuba semula secara automatik meminta apabila ia berguna untuk berbuat demikian, dan tingkah laku ini boleh meningkat dengan berkesan kependaman seperti yang dilihat daripada pengguna akhir. Gunakan metrik Pemantauan Awan storage.googleapis.com/api/request_count untuk melihat sama ada Storan Awan secara konsisten menyediakan kod respons yang boleh dicuba semula, seperti sebagai 429 atau 5xx ## Pelayan proksi **Isu saya menyambung melalui pelayan proksi. Apa yang perlu saya buat? **Penyelesaian Untuk mengakses Storan Awan melalui pelayan proksi, anda mesti benarkan akses kepada domain ini: accounts.google.comuntuk membuat token pengesahan OAuth2 melalui konfigurasi gsutil oauth2.googleapis.comuntuk melakukan pertukaran token OAuth2 *.googleapis.comuntuk permintaan storan Jika pelayan proksi atau dasar keselamatan anda tidak menyokong penyenaraian putih mengikut domain dan sebaliknya memerlukan penyenaraian putih mengikut blok rangkaian IP, kami amat mengesyorkan agar anda mengkonfigurasi pelayan proksi anda untuk semua julat alamat IP Google. Anda boleh mencari julat alamat dengan menanyakan data WHOIS di ARIN. Sebagai amalan terbaik, anda harus menyemak tetapan proksi anda secara berkala untuk memastikan ia sepadan dengan alamat IP Google Kami tidak mengesyorkan anda mengkonfigurasi proksi anda dengan alamat IP individu anda dapatkan daripada carian sekali sahaja oauth2.googleapis.com dan storage.googleapis.com. Kerana perkhidmatan Google didedahkan melalui nama DNS itu petakan kepada sejumlah besar alamat IP yang boleh berubah dari semasa ke semasa, mengkonfigurasi proksi anda berdasarkan carian sekali sahaja boleh menyebabkan kegagalan untuk disambungkan Storan Awan Jika permintaan anda sedang dihalakan melalui pelayan proksi, anda mungkin perlu melakukannya semak dengan pentadbir rangkaian anda untuk memastikan bahawa Kebenaran pengepala yang mengandungi kelayakan anda tidak dilucutkan oleh proksi. Tanpa yang Pengepala kebenaran, permintaan anda ditolak dan anda menerima a Ralat MissingSecurityHeader ## Apa yang akan datang - Ketahui tentang pilihan sokongan anda - Cari jawapan kepada soalan tambahan dalam Soalan Lazim Storan Awan - Terokai cara Pelaporan Ralat boleh membantu anda mengenal pasti dan memahami ralat Storan Awan anda.

Menyelesaikan masalah | Storan Awan | Google Cloud