Bu sayfada, Cloud Storage'ı kullanırken karşılaşabileceğiniz yaygın hatalar için sorun giderme yöntemleri açıklanmaktadır.

Cloud Storage gibi Google Cloud hizmetlerini etkileyen bölgesel veya küresel olaylar hakkında bilgi için Google Cloud Status Dashboard'a bakın.

## Ham istekleri günlüğe kaydetme
gibi araçları kullanırken
gcloud veya Cloud Storage istemci kitaplıkları, çok
istek ve yanıt bilgilerinin tamamı araç tarafından işlenir. Ancak öyle
bazen sorun gidermeye yardımcı olacak ayrıntıları görmek yararlıdır. Kullan
aracınız için istek ve yanıt başlıklarını döndürmek için aşağıdaki talimatları izleyin:
 Konsol
İstek ve yanıt bilgilerinin görüntülenmesi, Google Cloud konsoluna erişmek için kullandığınız tarayıcıya bağlıdır. Google Chrome tarayıcısı için:
Chrome'u tıklayın
ana menü düğmesi (
)

Seçme
Daha Fazla Araç

Tıklamak
Geliştirici Araçları

Görünen bölmede,
Ağ sekmesi

 Komut satırı
 bulut
İsteğinizde genel hata ayıklama bayraklarını kullanın. Örneğin:
gcloud depolama ls gsmy-bucket/nesnem --log-http --verbosity=debug
 gsutil
küresel kullan
-D bayrağı isteğinizde. Örneğin:
gsutil -D ls gsmy grubu/nesnem
 İstemci kitaplıkları
 C++
Ortam değişkenini ayarlayın
CLOUD_STORAGE_ENABLE_TRACING=httptam HTTP trafiğini almak için

Her bir RPC'nin günlüğünü almak için CLOUD_STORAGE_ENABLE_CLOG=yes ortam değişkenini ayarlayın

 C#
Şununla bir günlükçü ekle:
ApplicationContext.RegisterLogger ve günlüğe kaydetmeyi ayarlama
üzerindeki seçenekler
HttpClient mesaj işleyicisi. Daha fazla bilgi için, bkz
SSS girişi

 Gitmek
Ortam değişkenini ayarlayın
GODEBUG=http2debug=1. Daha fazlası için
bilgi için Go paketine bakın net/http

İstek gövdesini de günlüğe kaydetmek istiyorsanız, özel bir HTTP istemcisi kullanın.

 java
Aşağıdaki içeriklerle "logging.properties"adlı bir dosya oluşturun:
# JDK kayıt tesisinin çalışmasını yapılandıran Özellikler dosyası. # Sistem, sistem özelliği olarak belirtilecek bu yapılandırma dosyasını arayacaktır: # -Djava.util.logging.config.fileproject_loc:googleplus-simple-cmdline-sample}/logging.properties # Konsol işleyicisini kurun (açıklama "level"daha ayrıntılı mesajlar göstermek için) işleyiciler = java.util.logging.ConsoleHandler java.util.logging.ConsoleHandler.level = CONFIG # HTTP isteklerinin ve yanıtlarının günlüğünü ayarlayın (göstermek için "seviye"açıklamasını kaldırın) com.google .api.client.http.level = YAPILANDIRMA
Maven ile logging.properties kullanın
mvn -Djava.util.logging.config.file=yol/to/logging.properties
ekle_komutu
Daha fazla bilgi için bkz. Takılabilir HTTP Aktarımı

 Node.js
Ortam değişkenini ayarlayın
NODE_DEBUG=Düğümü çağırmadan önce https
senaryo

 PHP
Kullanarak istemciye kendi HTTP işleyicinizi sağlayın

httpHandler ve isteği günlüğe kaydetmek için ara yazılımı kurun
ve yanıt

 Piton
Kayıt modülünü kullanın. Örneğin:
içe aktarma günlüğü içe aktarma http.client logging.basicConfig(level=logging.DEBUG) http.client.HTTPConnection.debuglevel=5
 Yakut
senin üstünde
.rb dosyasından sonra
"google/bulut/depolama"gerektirir,
şunları ekleyin:
yakut Google::Apis.logger.level = Logger::DEBUG
## Hata kodları
Aşağıdakiler, karşılaşabileceğiniz yaygın HTTP durum kodlarıdır

 301: Kalıcı Olarak Taşındı
**Sorun Statik bir web sitesi kuruyorum ve bir dizin yoluna erişiyorum
boş bir nesne döndürür ve
301 HTTP yanıt kodu

**Çözüm Tarayıcınız sıfır baytlık bir nesne indirirse ve bir
301
Bir dizine erişirken HTTP yanıt kodu, örneğin
httpwww.example.com/dir/, klasörünüz büyük olasılıkla boş bir nesne içeriyor
o ismin Durumun böyle olup olmadığını kontrol etmek ve sorunu çözmek için:
- Google Cloud konsolunda Cloud Storage'a gidin
Grup sayfası

- Tıkla
Google Cloud konsolunun üst kısmındaki Cloud Shelldüğmesini etkinleştirin

- Koşmak
gcloud depolama --recursive gswww.example.com/dir/. Çıktı şunları içeriyorsa
httpwww.example.com/dir/, o konumda boş bir nesneniz var

- Boş nesneyi şu komutla kaldırın:
gcloud depolama rm gswww.example.com/dir/
şimdi erişebilirsiniz
httpwww.example.com/dir/ ve bunu döndürmesini sağlayın
dizinin
boş nesne yerine index.html dosyası

 400: Hatalı İstek
**Sorun Devam ettirilebilir bir karşıya yükleme gerçekleştirirken bu hatayı aldım ve
mesaj
Content-Range başlığı ayrıştırılamadı

**Çözüm Projenizde kullandığınız değer
Content-Range başlığı geçersiz. İçin
misal,
Content-Range: geçersizdir ve bunun yerine şu şekilde belirtilmelidir:
Content-Range: baytBu hatayı alırsanız, geçerli devam ettirilebilir dosyanız
yükleme artık etkin değil ve devam ettirilebilir yeni bir yükleme başlatmanız gerekiyor

 401: Yetkisiz
**Talepleri doğrudan veya Cloud CDN aracılığıyla genel bir klasöre gönderin
ile başarısız
HTTP 401: Yetkisiz ve bir
Kimlik Doğrulaması Gerekli
cevap

**Çözüm İstemcinizin veya herhangi bir aracı proxy'nin eklemediğini kontrol edin.
Cloud Storage istekleri için yetkilendirme başlığı. ile herhangi bir istek
bir
Yetkilendirme başlığı, boş olsa bile, sanki bir
kimlik doğrulama girişimi

 403: Hesap Devre Dışı Bırakıldı
**Bir grup oluşturmaya çalıştığım, ancak bir sorunla karşılaştığım sorun
403 Hesap Devre Dışı Bırakıldı hatası

**Çözüm Bu hata, faturalandırmayı henüz açmadığınızı gösterir.
ilgili proje. Faturalandırmayı etkinleştirme adımları için bkz.
Bir proje için faturalandırmayı etkinleştirme

Faturalandırma açıksa ve bu hata mesajını almaya devam ederseniz proje kimliğiniz ve sorununuzun açıklamasıyla destek ekibine ulaşabilirsiniz.
 403 yasak
**Sorun, belirli bir klasöre veya nesneye erişim iznim olmalı, ancak
bunu yapmaya çalıştığımda, bir
403 - Bir mesajda yasak hata
benzer:
[email protected]'un Storage.objects.get erişimine sahip değil.
Google Bulut Depolama nesnesi

**Çözüm Grup için bir IAM izniniz yok
veya isteği tamamlamak için gereken nesne. Eğer yapabilmeyi umuyorsan
istekte bulunuyor ancak yapamıyorsanız, aşağıdaki kontrolleri yapın:
Hata mesajında ​​atıfta bulunulan, beklediğiniz kişi mi? Hata mesajı beklenmeyen bir e-posta adresine veya "Anonim arayan"a atıfta bulunuyorsa, isteğiniz, amaçladığınız kimlik bilgilerini kullanmıyor demektir. Bunun nedeni, istekte bulunmak için kullandığınız aracın başka bir takma adın veya varlığın kimlik bilgileriyle ayarlanmış olması veya isteğin sizin adınıza bir hizmet hesabı tarafından yapılıyor olması olabilir.

Hata mesajında ​​belirtilen izne ihtiyacınız olduğunu düşündünüz mü? İzin beklenmedikse bunun nedeni büyük olasılıkla kullandığınız aracın isteğinizi tamamlamak için ek erişim gerektirmesidir. Örneğin, bir klasördeki nesneleri toplu olarak silmek için,
gcloud önce silinecek klasördeki nesnelerin bir listesini oluşturmalıdır. Toplu silme eyleminin bu kısmı,
Storage.objects.listpermission, hedefin normalde yalnızca
storage.objects.deletepermission. Hata mesajınızın nedeni buysa, size gerekli ek izinlere sahip IAM rolleri verildiğinden emin olun.

Amaçlanan kaynakta veya üst kaynakta size IAM rolü verildi mi? Örneğin,
Bir proje için Depolama Nesnesi Görüntüleyici rolü ve bir nesne indirmeye çalışıyorsanız, nesnenin projedeki bir kovada olduğundan emin olun; yanlışlıkla sahip olabilirsin
Farklı bir proje için Storage Object Viewer izni

 403 yasak
**İçeriğimi indirdiğim sorun
storage.cloud.google.com ve ben
almak
403: Şuraya gitmek için tarayıcıyı kullandığımda yasak hata
URL'yi kullanarak nesne:
httpsstorage.cloud.google.com/
BUCKET_NAME/ OBJECT_NAME **Kullanılan Çözüm
nesneleri indirmek için storage.cloud.google.com olarak bilinir
tanımlama bilgisi tabanlı kimlik doğrulama kullanan kimliği doğrulanmış tarayıcı indirmeleri

İzlemek için Bulut Denetim Günlüklerinde Veri Erişimi denetim günlüklerini yapılandırdıysanız
nesnelere erişim, bu özelliğin kısıtlamalarından biri,
kimliği doğrulanmış tarayıcı indirmeleri izlenen bir nesneyi indirmek için kullanılamaz,
nesne okunabilir olmadığı sürece.Herkese açık olmayan nesneler için kimliği doğrulanmış birtarayıcı indirmesi kullanmaya çalışmak403 yanıtıyla sonuçlanır.Bukısıtlama,çerez tabanlı kimlik doğrulama için kullanılan Google Kimliklerine yönelik kimlik avını önlemek için mevcutturBu sorunu önlemek için bir tane yapın- Kimliği doğrulanmış tarayıcı indirmelerini kullanmak yerine kimliği doğrulanmamış indirmeleri destekleyen doğrudan API çağrılarını kullanın- Erişimi izleyen Bulut Depolama Veri Erişimi denetim günlüklerini devre dışı bırakın etkilenen nesneler.Veri Erişimi denetim günlüklerinin proje düzeyinde veya üzerinde ayarlandığını ve aynı anda birden çok düzeyde etkinleştirilebileceğini unutmayın- Belirli kullanıcıları Veri Erişimi denetim günlüğünden hariç tutmak için muafiyetler ayarlayın izleme, bu kullanıcıların kimliği doğrulanmış tarayıcı indirmeleri gerçekleştirmesine olanak tanır-allUsers veyaallAuthenticatedUsers'a okuma izni vererek etkilenen nesneleri okunabilir hale getirin.Veri Erişimi denetleme günlükleri genel nesnelere erişimi kaydetmez409: Çakışma**Sorun Bir grup oluşturmaya çalıştım ancak aşağıdaki hatayı aldım:409 Çakışma.Maalesef bu ad mevcut değil.Lütfen farklı bir tane deneyin**Çözüm [ör. gscats veya gsdogs]kullanmaya çalıştığınız grup adı zaten alınmış.Cloud Storage'ın global bir ad alanı vardır, bu nedenlebir klasörü mevcut bir grupla aynı ada sahip olarak adlandıramazsınız.Kullanılmayan bir ad seçin429: Çok Fazla İstek**Sorun İsteklerim429 Çok Fazla İstek hatası**Çözüm İstek sayısı sınırına ulaşıyorsunuzBulut Depolamanın belirli bir kaynağa izin vermesi.Bulut Depolama'daki sınırlar hakkında bir tartışma içinBulut Depolama kotalarına bakın.İş yükünüz bir kovayasaniye başına 1000 istekten oluşuyorsa, iş yükünüzü kademeli olarak artırmak ve sıralı dosya adlarından kaçınmak da dahil olmak üzere en iyi uygulamalara ilişkin bir tartışma için İstek hızı ve erişim dağıtım yönergelerine bakın## Google Cloud konsol hatalarını teşhis etme**Sorun Birişlemi gerçekleştirmek için Google Cloud konsolunu kullanırken genel bir hata mesajı alıyorum.Örneğin, bir grubu silmeye çalışırkenhata mesajı görüyorum, ancakişleminin neden başarısız olduğuna ilişkin ayrıntıları göremiyorum.**Çözüm Başarısız işlemle ilgili ayrıntılıbilgileri görmek için Google Cloud konsolunun bildirimlerini kullanın:Google Cloud konsolu başlığındakiBildirimler düğmesini tıklayınBir açılır menü, Google Cloud konsolu tarafından gerçekleştirilen en son işlemleri görüntülerHakkında daha fazla bilgi edinmek istediğiniz öğeyi tıklayınBir sayfa açılır ve işlemle ilgili ayrıntılı bilgileri görüntülerAyrıntılı hata bilgilerini genişletmek için her satırı tıklayınAşağıda bir hata bilgisi örneği bir klasör tutma ilkesinin paketin silinmesini engellediğini açıklayan başarısız grup silme işlemi## Statik web sitesi hatalarıKurulum sırasında karşılaşabileceğiniz yaygın sorunlar aşağıdadır statik bir web sitesini barındırmak için bir grupHTTPS hizmeti veriyor**Sorun Bir yük dengeleyici kullanmadan HTTPS üzerinden içeriğimi sunmak istiyorum.**Çözümhttpsstorage.googleapis.com/my-bucket/my-object gibi doğrudan URI'lerikullanarak HTTPS üzerinden statik içerik sunabilirsiniz.İçeriğinizi SSL üzerinden özel bir etki alanı üzerinden sunmaya yönelik diğer seçenekler için şunları yapabilirsiniz:- Bulut Depolama ile üçüncü taraf bir İçerik Dağıtım Ağı kullanın- Statik web sitesi içeriğinizi Cloud Storage yerine Firebase Hosting'den sununAlan doğrulaması**Sorun Alanımı doğrulayamıyorum.**Çözüm Normalde Search Console'daki doğrulama işlemisizi alanınıza bir dosya yüklemeye yönlendirir, ancak bunu önce bir dosya yüklemedenyapmanın bir yolu olmayabilir. yalnızca*alan doğrulaması gerçekleştirdikten sonra* oluşturabileceğiniz ilişkili paketBu durumda, sahipliği**Alan adı sağlayıcısını* kullanarak doğrulayın. * doğrulamayöntemi.Bunu gerçekleştirme adımları için Sahiplik doğrulamaya bakın.Budoğrulama, grup oluşturulmadan önce yapılabilirSayfaya erişilemiyor**SorunErişim reddedildiweb sitem tarafından sunulan bir web sayfası için hata mesajı**Çözüm Nesnenin paylaşıldığını kontrol edin.Değilse, bunun nasıl yapılacağına ilişkin talimatlar içinVerileri Herkese Açık Hale Getirme bölümüne bakınDaha önce bir nesne yükleyip paylaştıysanız, ancak daha sonra yeni bir nesne yüklediyseniz sürümünü kullanıyorsanız, nesneyi yeniden paylaşmanız gerekir.Bunun nedeni, genel iznin yeni yüklemeyle değiştirilmesidirİzin güncellemesi başarısız oldu**Sorun Verilerimi herkese açık hale getirmeye çalıştığımda hata alıyorum .**Çözümnesneniz veya grubunuz içinsetIamPolicy iznine sahip olduğunuzdan emin olun.Bu izin, örneğinDepolama Yöneticisi rolünde verilir.setIamPolicy iznine sahipseniz vehala hata alıyorsanız, paketinizerişime izin vermeyen genel erişim engellemesine tabi olabilir|#|# allUsers veyaallAuthenticatedUsers.Genel erişim engelleme doğrudanklasöründe ayarlanabilir veyadaha yüksek bir düzeyde ayarlanmış bir kuruluş politikası aracılığıyla uygulanabilirİçerik indirme**Sorun Sayfamın içeriğini tarayıcımda görüntülemek yerine indirmem isteniyor.**ÇözümWeb içerik türüne sahip olmayan bir nesne olarakAna Sayfa Soneki belirtirseniz, sayfayı sunmak yerine site ziyaretçilerinden içeriği indirmeleri istenir .Bu sorunu çözmek için içerik türümeta veri girişinitext/html gibi uygun bir değere güncelleyin.Bkz.
Bunun nasıl yapılacağına ilişkin talimatlar için nesne meta verilerini düzenleme

## Gecikme
Karşılaşabileceğiniz yaygın gecikme sorunları aşağıda verilmiştir. Ayrıca Google Cloud Status Dashboard, Cloud Storage gibi Google Cloud hizmetlerini etkileyen bölgesel veya küresel olaylar hakkında bilgi sağlar.

 Yükleme veya indirme gecikmesi
**Sorun Yükleme veya indirme sırasında artan gecikme görüyorum. **Çözüm
performansı çalıştırmak için gsutil perfdiag komutu
etkilenen ortamdan tanılama. Aşağıdaki yaygın nedenleri göz önünde bulundurun
yükleme ve indirme gecikmesi:
CPU veya bellek kısıtlamaları: Etkilenen ortamın işletim sistemi, CPU kullanımı ve bellek kullanımı gibi yerel kaynak tüketimini ölçmek için araçlara sahip olmalıdır.

Disk IO kısıtlamaları:
gsutil perfdiagkomutunu kullanın
rthru_fileand
wthru_filetests, yerel disk IO'sunun neden olduğu performans etkisini ölçmek için

Coğrafi uzaklık: Performans, özellikle kıtalar arası durumlarda, Bulut Depolama grubunuz ile etkilenen ortamın fiziksel olarak ayrılmasından etkilenebilir. Etkilenen ortamınızla aynı bölgede bulunan bir klasörle test etmek, hangi coğrafi ayrımın gecikmenize ne ölçüde katkıda bulunduğunu belirleyebilir

- Mümkünse, etkilenen ortamın DNS çözümleyicisi, ortamdan gelen isteklerin uygun bir Google Ön Uç aracılığıyla yönlendirilmesi için EDNS(0) protokolünü kullanmalıdır.

 CLI veya istemci kitaplığı gecikmesi
**Sorun Cloud Storage'a erişirken artan gecikme görüyorum
ile
gcloud depolama, gsutil veya istemci kitaplıklarından biri

**Çözüm CLI'ler ve istemci kitaplıkları otomatik olarak yeniden denenir
bunu yapmak yararlı olduğunda talep eder ve bu davranış etkili bir şekilde artabilir
son kullanıcıdan görüldüğü şekliyle gecikme. Bulut İzleme metriğini kullanın
olup olmadığını görmek için storage.googleapis.com/api/request_count
Cloud Storage, tutarlı bir şekilde yeniden denenebilir bir yanıt kodu sunar;
gibi
429 veya
5xx

## Proxy sunucuları
**Sorun Bir proxy sunucu üzerinden bağlanıyorum. Ne yapmaya ihtiyacım var? **Çözüm Bulut Depolamaya bir proxy sunucu üzerinden erişmek için şunları yapmalısınız:
şu etki alanlarına erişime izin ver:
Accounts.google.comOAuth2 kimlik doğrulama belirteçleri oluşturmak için
gsutil yapılandırması
oauth2.googleapis.comOAuth2 jeton değişimlerini gerçekleştirmek için
*.googleapis.comdepolama istekleri için
Proxy sunucunuz veya güvenlik politikanız etki alanına göre beyaz listeye almayı desteklemiyorsa ve bunun yerine IP ağ bloğuna göre beyaz listeye almayı gerektiriyorsa, proxy sunucunuzu tüm Google IP adresi aralıkları için yapılandırmanızı kesinlikle öneririz. ARIN'de WHOIS verilerini sorgulayarak adres aralıklarını bulabilirsiniz. En iyi uygulama olarak, Google'ın IP adresleriyle eşleştiğinden emin olmak için proxy ayarlarınızı düzenli olarak gözden geçirmelisiniz.

Proxy'nizi ayrı ayrı IP adresleriyle yapılandırmanızı önermiyoruz.
tek seferlik aramalardan elde
oauth2.googleapis.com ve
depolama.googleapis.com. Google hizmetleri, DNS adları aracılığıyla ifşa edildiğinden
zaman içinde değişebilen çok sayıda IP adresiyle eşleme, yapılandırma
tek seferlik aramaya dayalı proxy'niz, bağlantı kurulamamasına neden olabilir
Bulut depolama

İstekleriniz bir proxy sunucu üzerinden yönlendiriliyorsa,
olduğundan emin olmak için ağ yöneticinizle görüşün.
yetki
kimlik bilgilerinizi içeren başlık, proxy tarafından çıkarılmaz. Olmadan
the
Yetkilendirme başlığı, istekleriniz reddedilir ve bir
MissingSecurityHeader hatası

## Sıradaki ne
- Destek seçenekleriniz hakkında bilgi edinin

- Bulut Depolama SSS'sinde ek soruların yanıtlarını bulun

- Hata Raporlamanın Bulut Depolama hatalarınızı belirlemenize ve anlamanıza nasıl yardımcı olabileceğini keşfedin.