Informazioni sulle funzionalità di Google Cloud Storage

Bucket, oggetti e ACL

Un bucket è la posizione di archiviazione da cui leggi e scrivi file. Devi sempre specificare un bucket quando utilizzi la libreria client App Engine per Cloud Storage. Il tuo progetto può accedere a più bucket. Tieni presente che la libreria del client non supporta la creazione di bucket.

Gli elenchi di controllo dell'accesso (ACL) controllano l'accesso ai bucket e agli oggetti contenuti al loro interno. Il progetto e l'app App Engine vengono aggiunti automaticamente all'ACL che consente l'accesso al bucket quando crei un bucket nel progetto.

Tieni presente che l'ACL che consente l'accesso al bucket è distinto dai potenzialmente numerosi ACL che regolano gli oggetti al suo interno. Pertanto, la tua app dispone dei privilegi di lettura e scrittura per i bucket per i quali è attivata, ma ha pieni diritti solo per gli oggetti che crea nel bucket. L'accesso della tua app agli oggetti creati da altre app o persone è limitato ai diritti concessi alla tua app dal creatore degli oggetti.

Se un oggetto viene creato nel bucket senza un ACL definito esplicitamente, viene utilizzato l'ACL predefinito dell'oggetto assegnato al bucket dal proprietario del bucket. Se il proprietario del bucket non ha specificato un ACL dell'oggetto predefinito, l'impostazione predefinita dell'oggetto è public-read, il che significa che chiunque abbia accesso al bucket può leggere l'oggetto.

ACL e libreria client

Un'app che utilizza la libreria client non può modificare l'ACL del bucket, ma può specificare un'ACL che controlla l'accesso agli oggetti che crea. Le impostazioni ACL disponibili sono descritte nella documentazione relativa al metodo open.

Modifica degli oggetti Cloud Storage

Una volta creato un oggetto in un bucket, non puoi modificarlo né aggiungervi elementi. Devi invece sovrascrivere l'oggetto con un nuovo oggetto con lo stesso nome che contenga le modifiche che ti interessano.

Cloud Storage e sottodirectory

La libreria client App Engine per Cloud Storage ti consente di specificare delimitatori di sottodirectory quando crei un oggetto, ma in Cloud Storage non esistono sottodirectory vere e proprie. Una sottodirectory in Cloud Storage fa invece parte del nome del file dell'oggetto.

Ad esempio, potresti supporre che la creazione di un oggettosomewhere/over/the/rainbow.mp3 consenta di memorizzare il file rainbow.mp3 nella sottodirectory somewhere/over/the/. Il nome dell'oggetto viene invece impostato su somewhere/over/the/rainbow.mp3.

Questo concetto è importante da comprendere quando si utilizzano i filtri listbucket.

Se il comportamento della scheda sopra indicato non è ottimale per te, listbucket ha una modalità di emulazione della directory facoltativa. Per ulteriori informazioni, consulta listbucket.

Passaggi successivi