Questa pagina descrive i metodi di risoluzione dei problemi per gli errori comuni che potresti riscontrare durante l'utilizzo di Cloud Storage
Consulta la Google Cloud Status Dashboard per informazioni sugli incidenti regionali o globali che interessano i servizi Google Cloud come Cloud Storage
## Registrazione delle richieste grezze
Quando si utilizzano strumenti come
gcloud o le librerie client di Cloud Storage, much
delle informazioni di richiesta e risposta vengono gestite dallo strumento. Tuttavia, lo è
a volte utile per vedere i dettagli per aiutare nella risoluzione dei problemi. Usa il
seguenti istruzioni per restituire le intestazioni di richiesta e risposta per il tuo strumento:
Consolle
La visualizzazione delle informazioni su richieste e risposte dipende dal browser che utilizzi per accedere a Google Cloud Console. Per il browser Google Chrome:
Fai clic su Chrome
pulsante menu principale (
)
Selezionare
Altri strumenti
Clic
Strumenti di sviluppo
Nel riquadro visualizzato, fare clic su
scheda Rete
Riga di comando
gcloud
Usa i flag di debug globali nella tua richiesta. Per esempio:
gcloud storage ls gsmy-bucket/my-object --log-http --verbosity=debug
gsutil
Usa il globale
-D flag nella tua richiesta. Per esempio:
gsutil -D ls gsmy-bucket/my-object
Librerie clienti
C++
Imposta la variabile di ambiente
CLOUD_STORAGE_ENABLE_TRACING=httpper ottenere il traffico HTTP completo
Imposta la variabile di ambiente CLOUD_STORAGE_ENABLE_CLOG=yes per ottenere la registrazione di ogni RPC
C#
Aggiungi un logger tramite
ApplicationContext.RegisterLogger e impostare la registrazione
opzioni sul
Gestore di messaggi HttpClient. Per ulteriori informazioni, vedere
la voce FAQ
andare
Imposta la variabile di ambiente
GODEBUG=http2debug=1. Per più
informazioni, vedere il pacchetto Go net/http
Se desideri registrare anche il corpo della richiesta, utilizza un client HTTP personalizzato
Giava
Crea un file denominato "logging.properties"con i seguenti contenuti:
# File delle proprietà che configura il funzionamento della funzione di registrazione JDK. # Il sistema cercherà questo file di configurazione da specificare come proprietà di sistema: # -Djava.util.logging.config.fileproject_loc:googleplus-simple-cmdline-sample}/logging.properties # Imposta il gestore della console (decommenta "level"per mostrare messaggi più granulari) handlers = java.util.logging.ConsoleHandler java.util.logging.ConsoleHandler.level = CONFIG # Imposta la registrazione di richieste e risposte HTTP (decommenta "level"per mostrare) com.google .api.client.http.level = CONFIG
Usa logging.properties con Maven
mvn -Djava.util.logging.config.file=percorso/a/logging.properties
insert_command
Per ulteriori informazioni, consulta Trasporto HTTP collegabile
Node.js
Imposta la variabile di ambiente
NODE_DEBUG=https prima di chiamare il file Node
copione
PHP
Fornisci il tuo gestore HTTP al client utilizzando
httpHandler e configurare il middleware per registrare la richiesta
e risposta
Pitone
Utilizzare il modulo di registrazione. Per esempio:
import registrazione import http.client logging.basicConfig(level=logging.DEBUG) http.client.HTTPConnection.debuglevel=5
Rubino
In cima al tuo
.rb dopo
richiedono "google/cloud/storage",
aggiungere quanto segue:
ruby Google::Apis.logger.level = Logger::DEBUG
## Codici di errore
I seguenti sono codici di stato HTTP comuni che potresti incontrare
301: Spostato definitivamente
**Problema durante la configurazione di un sito Web statico e l'accesso a un percorso di directory
restituisce un oggetto vuoto e a
301 codice di risposta HTTP
**Soluzione Se il tuo browser scarica un oggetto zero byte e ottieni un file
301
Codice di risposta HTTP quando si accede a una directory, ad esempio
httpwww.example.com/dir/, molto probabilmente il tuo bucket contiene un oggetto vuoto
di quel nome. Per verificare che sia così e risolvere il problema:
- Nella console di Google Cloud, vai a Cloud Storage
Secchipage
- Clicca il
Attiva il pulsante Cloud Shell nella parte superiore della console di Google Cloud
- Correre
gcloud storage ls --recursive gswww.example.com/dir/. Se l'output include
httpwww.example.com/dir/, hai un oggetto vuoto in quella posizione
- Rimuovere l'oggetto vuoto con il comando:
gcloud storage rm gswww.example.com/dir/
Ora puoi accedere
httpwww.example.com/dir/ e fallo restituire
directory
index.html invece dell'oggetto vuoto
400: Richiesta errata
**Problema Durante l'esecuzione di un caricamento ripristinabile, ho ricevuto questo errore e
il messaggio
Impossibile analizzare l'intestazione Content-Range
**Soluzione Il valore che hai usato nel tuo
L'intestazione Content-Range non è valida. Per
esempio,
Content-Range: non è valido e dovrebbe invece essere specificato come
Content-Range: bytesSe ricevi questo errore, il tuo file corrente verrà ripristinato
il caricamento non è più attivo ed è necessario avviare un nuovo caricamento ripristinabile
401: non autorizzato
**Le richieste di emissione a un bucket pubblico direttamente o tramite Cloud CDN lo sono
fallire con a
HTTP 401: non autorizzato e an
Autenticazione richiesta
risposta
**Soluzione Verificare che il client o qualsiasi proxy intermedio non stia aggiungendo un file
Intestazione di autorizzazione per le richieste a Cloud Storage. Qualsiasi richiesta con
un
L'header di autorizzazione, anche se vuoto, viene validato come se fosse un file
tentativo di autenticazione
403: Account disabilitato
**Problema: ho provato a creare un bucket ma ho ricevuto un
Errore 403 account disattivato
**Soluzione Questo errore indica che non hai ancora attivato la fatturazione per
il progetto associato. Per i passaggi per abilitare la fatturazione, vedere
Abilita la fatturazione per un progetto
Se la fatturazione è attiva e continui a ricevere questo messaggio di errore, puoi contattare l'assistenza fornendo il tuo ID progetto e una descrizione del problema
403: Proibito
**Problema: dovrei avere il permesso di accedere a un determinato bucket o oggetto, ma
quando provo a farlo, ottengo un
403 - Errore proibito con un messaggio che è
simile a:
[email protected] non ha storage.objects.get accesso a
Oggetto Google Cloud Storage
**Soluzione Manca un'autorizzazione IAM per il bucket
o oggetto necessario per completare la richiesta. Se ti aspetti di poterlo fare
effettuare la richiesta ma non ci riesce, effettuare le seguenti verifiche:
Il beneficiario indicato nel messaggio di errore è quello previsto? Se il messaggio di errore si riferisce a un indirizzo e-mail imprevisto o a "Chiamante anonimo", la tua richiesta non utilizza le credenziali che intendevi. Ciò potrebbe essere dovuto al fatto che lo strumento che stai utilizzando per effettuare la richiesta è stato configurato con le credenziali di un altro alias o entità oppure potrebbe essere dovuto al fatto che la richiesta viene effettuata per tuo conto da un account di servizio
L'autorizzazione a cui si fa riferimento nel messaggio di errore è quella che ritenevi necessaria? Se l'autorizzazione è inaspettata, è probabile che lo strumento che stai utilizzando richieda un accesso aggiuntivo per completare la tua richiesta. Ad esempio, per eliminare in blocco gli oggetti in un bucket,
gcloud deve prima creare un elenco di oggetti nel bucket da eliminare. Questa parte dell'azione di eliminazione in blocco richiede il file
storage.objects.listpermission, il che potrebbe sorprendere, dato che l'obiettivo è l'eliminazione dell'oggetto, che normalmente richiede solo il
storage.objects.deletepermission. Se questa è la causa del tuo messaggio di errore, assicurati di disporre dei ruoli IAM con le autorizzazioni aggiuntive necessarie
Ti è stato concesso il ruolo IAM sulla risorsa prevista o sulla risorsa padre? Ad esempio, se ti viene concesso il
Storage Object Viewerrole per un progetto e stai provando a scaricare un oggetto, assicurati che l'oggetto sia in un bucket che si trova nel progetto; potresti inavvertitamente avere il
Autorizzazione di Visualizzatore oggetti di archiviazione per un progetto diverso
403: Proibito
**Problema da cui sto scaricando i miei contenuti
storage.cloud.google.com e io
ricevere un
403: Errore proibito quando utilizzo il browser per navigare verso il file
oggetto utilizzando l'URL:
httpsstorage.cloud.google.com/
BUCKET_NAME/ OBJECT_NAME **Soluzione in uso
storage.cloud.google.com per scaricare oggetti è noto come
download del browser autenticati, che utilizza l'autenticazione basata su cookie
Se hai configurato gli audit log di accesso ai dati negli audit log di Cloud per tenere traccia
accesso agli oggetti, una delle restrizioni di quella funzione è quella
i download del browser autenticati non possono essere utilizzati per scaricare un oggetto monitorato,
a meno che l'oggetto non sia leggibile. Tentativo di utilizzare un file autenticato il download dal browser per oggetti non pubblici risulta in un file risposta 403. Questo esiste una restrizione per impedire il phishing per gli ID Google, che vengono utilizzati per autenticazione basata sui cookie Per evitare questo problema, eseguire una delle seguenti operazioni: - Utilizzare le chiamate API dirette, che supportano i download non autenticati, invece di utilizzare i download del browser autenticati - Disattivare i log di controllo dell'accesso ai dati di Cloud Storage che tengono traccia dell'accesso agli oggetti interessati. Tieni presente che i log di controllo dell'accesso ai dati sono impostati a livello di progetto o superiore e possono essere abilitati contemporaneamente a più livelli - Impostare esenzioni per escludere utenti specifici dal monitoraggio del registro di controllo dell'accesso ai dati, che consente a tali utenti di eseguire download del browser autenticati - Rendi leggibili gli oggetti interessati, concedendo il permesso di lettura a entrambi allUsersor allAuthenticatedUsers. I registri di controllo dell'accesso ai dati non registrano l'accesso agli oggetti pubblici 409: Conflitto **Problema: ho provato a creare un bucket ma ho ricevuto il seguente errore: 409 Conflitto. Spiacenti, quel nome non è disponibile. Provane uno diverso **Soluzione Il nome del bucket che hai tentato di utilizzare [ad es. gscats o gsdogs] è già stato preso. Cloud Storage ha uno spazio dei nomi globale, quindi non puoi nominare a bucket con lo stesso nome di un bucket esistente. Scegli un nome che non sia essere Usato 429: Troppe richieste **Problema Le mie richieste vengono respinte con a Errore 429 Troppe richieste **Soluzione Stai raggiungendo un limite al numero di richieste Cloud Storage consente una determinata risorsa. Vedi il Quote di Cloud Storage per una discussione sui limiti in Archiviazione cloud. Se il tuo carico di lavoro è composto da migliaia di richieste per secondo a un bucket, consulta le linee guida sulla velocità di richiesta e sulla distribuzione degli accessi per una discussione sulle best practice, incluso l'aumento graduale del carico di lavoro ed evitare nomi di file sequenziali ## Diagnosi degli errori della console di Google Cloud **Problema quando si utilizza Google Cloud Console per eseguire un'operazione operazione, ricevo un messaggio di errore generico. Ad esempio, vedo un messaggio di errore quando provo a eliminare un bucket, ma non vedo i dettagli sul perché dell'operazione fallito. **Soluzione Utilizza le notifiche della console di Google Cloud per visualizzare i dettagli informazioni sull'operazione non riuscita: Clicca il Pulsante Notifiche nell'intestazione della console di Google Cloud Un menu a discesa mostra le operazioni più recenti eseguite dalla console di Google Cloud Fai clic sull'elemento di cui vuoi saperne di più Si apre una pagina che visualizza informazioni dettagliate sull'operazione Fare clic su ciascuna riga per espandere le informazioni dettagliate sull'errore Di seguito è riportato un esempio di informazioni sull'errore per un'operazione di eliminazione del bucket non riuscita, che spiega che un criterio di conservazione del bucket ha impedito l'eliminazione del bucket ## Errori del sito web statico Di seguito sono riportati i problemi comuni che potresti riscontrare durante la configurazione di un bucket per l'hosting di un sito Web statico Servizio HTTPS **Problema: desidero pubblicare i miei contenuti su HTTPS senza utilizzare un bilanciatore del carico. **Soluzione È possibile fornire contenuto statico tramite HTTPS utilizzando URI diretti come httpsstorage.googleapis.com/my-bucket/my-object. Per altre opzioni per pubblicare i tuoi contenuti tramite un dominio personalizzato su SSL, puoi: - Utilizzare una rete di distribuzione dei contenuti di terze parti con Cloud Storage - Servi i contenuti del tuo sito web statico da Firebase Hosting invece che da Cloud StorageVerifica del dominio**Problema Non riesco a verificare il mio dominio.**Soluzione Normalmente, il processo di verifica in Search Consoleti indirizza a caricare un file nel tuo dominio, ma potresti non avere modo di farlosenza prima avere un bucket associato, che puoi creare solo*dopo* aver eseguito la verifica del dominioIn questo caso, verifica la proprietà utilizzando il**Fornitore del nome di dominio* * verificametodo.Vedi Verifica della proprietà per i passaggi da eseguire.Questaverifica può essere eseguita prima della creazione del bucketPagina inaccessibile**Problema ottengo unAccesso negato messaggio di errore per una pagina web servita dal miosito web**Soluzione Verificare che l'oggetto sia condiviso.In caso contrario, vedereRendere pubblici i dati per istruzioni su come farloSe in precedenza hai caricato e condiviso un oggetto, ma poi ne carichi uno nuovo versione di esso, è necessario ricondividere l'oggetto.Ciò accade perché l'autorizzazione pubblica viene sostituita con il nuovo caricamentoL'aggiornamento dell'autorizzazione non è riuscito**Problema ottengo un errore quando tento di rendere pubblici i miei dati .**Soluzione Assicurati di disporre dell'autorizzazionesetIamPolicy per il tuooggetto o bucket.Questa autorizzazione viene concessa, ad esempio, nel ruoloStorage Admin.Se disponi dell'autorizzazionesetIamPolicy ericevi ancora un errore, il tuo bucket potrebbe essere soggetto aprevenzione dell'accesso pubblico, che non consente l'accesso aallUsers oallAuthenticatedUsers.La prevenzione dell'accesso pubblico può essere impostata direttamente sul bucketoppure può essere applicata tramite una policy dell'organizzazioneimpostata a un livello superioreDownload del contenuto**Problema Mi viene richiesto di scaricare il contenuto della mia pagina, invece di poterlo visualizzare nel browser.**Soluzione Se si specifica unMainPageSuffix come oggetto che non haun tipo di contenuto web, invece di servire la pagina, ai visitatori del sito viene richiesto di scaricare il contenuto .Per risolvere questo problema, aggiorna la voce dei metadati del tipo di contenutoa un valore adatto, ad esempiotext/html.Vedi
Modifica dei metadati dell'oggetto per le istruzioni su come farlo
## Latenza
Di seguito sono riportati i problemi di latenza comuni che potresti riscontrare. Inoltre, Google Cloud Status Dashboard fornisce informazioni sugli incidenti regionali o globali che interessano i servizi Google Cloud come Cloud Storage
Latenza di upload o download
**Problema che vedo un aumento della latenza durante il caricamento o il download. **Soluzione Utilizzare il file
comando gsutil perfdiag per eseguire performance
diagnostica dall'ambiente interessato. Considera le seguenti cause comuni
di latenza di upload e download:
Vincoli della CPU o della memoria: il sistema operativo dell'ambiente interessato dovrebbe disporre di strumenti per misurare il consumo di risorse locali come l'utilizzo della CPU e della memoria
Vincoli di I/O disco: come parte del
gsutil perfdiagcomando, usa il
rthru_fileand
wthru_filetests per valutare l'impatto sulle prestazioni causato dall'IO del disco locale
Distanza geografica: le prestazioni possono essere influenzate dalla separazione fisica del bucket Cloud Storage e dell'ambiente interessato, in particolare nei casi intercontinentali. Il test con un bucket situato nella stessa regione dell'ambiente interessato può identificare la misura in cui la separazione geografica contribuisce alla latenza
- Se applicabile, il resolver DNS dell'ambiente interessato deve utilizzare il protocollo EDNS(0) in modo che le richieste dall'ambiente vengano instradate attraverso un Front End di Google appropriato
CLI o latenza della libreria client
**Problema con una maggiore latenza durante l'accesso a Cloud Storage
insieme a
gcloud storage, gsutil o una delle librerie client
**Soluzione Le CLI e le librerie client riprovano automaticamente
richieste quando è utile farlo, e questo comportamento può effettivamente aumentare
latenza vista dall'utente finale. Utilizza la metrica di Cloud Monitoring
storage.googleapis.com/api/request_count per vedere se
Cloud Storage serve costantemente un codice di risposta riprovabile, ad esempio
come
429 o
5xx
## Server proxy
**Problema durante la connessione tramite un server proxy. Cosa devo fare? **Soluzione Per accedere a Cloud Storage tramite un server proxy, è necessario
consentire l'accesso a questi domini:
accounts.google.com per la creazione di token di autenticazione OAuth2 tramite
configurazione gsutil
oauth2.googleapis.com per eseguire scambi di token OAuth2
*.googleapis.com per le richieste di archiviazione
Se il tuo server proxy o la tua policy di sicurezza non supporta l'inserimento in whitelist per dominio e richiede invece l'inserimento in whitelist per blocco di rete IP, ti consigliamo vivamente di configurare il tuo server proxy per tutti gli intervalli di indirizzi IP di Google. Puoi trovare gli intervalli di indirizzi interrogando i dati WHOIS su ARIN. Come best practice, dovresti rivedere periodicamente le impostazioni del proxy per assicurarti che corrispondano agli indirizzi IP di Google
Non consigliamo di configurare il tuo proxy con i tuoi indirizzi IP individuali
ottenere da ricerche una tantum di
oauth2.googleapis.com e
storage.googleapis.com. Poiché i servizi Google sono esposti tramite nomi DNS che
mappare a un gran numero di indirizzi IP che possono cambiare nel tempo, configurando
il tuo proxy basato su una ricerca una tantum potrebbe causare errori di connessione
Archiviazione cloud
Se le tue richieste vengono instradate attraverso un server proxy, potrebbe essere necessario
verificare con l'amministratore di rete per assicurarsi che il file
Autorizzazione
l'intestazione contenente le tue credenziali non viene rimossa dal proxy. Privo di
il
Intestazione di autorizzazione, le tue richieste vengono rifiutate e ricevi un
Errore MissingSecurityHeader
## Qual è il prossimo
- Ulteriori informazioni sulle opzioni di supporto
- Trova le risposte ad altre domande nelle Domande frequenti su Cloud Storage
- Scopri come Error Reporting può aiutarti a identificare e comprendere i tuoi errori di Cloud Storage.
Google Cloud
WEB HOSTING CONDIVISO#70
