Informazioni sulle funzionalità di Google Cloud Storage

Bucket, oggetti e ACL

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

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

Tieni presente che l'ACL che consente l'accesso al bucket è distinto dai potenzialmente numerosi ACL che regolano gli oggetti in quel bucket. Pertanto, la tua app ha privilegi di lettura e scrittura nei bucket per cui è attivata, ma ha diritti completi solo sugli oggetti che crea nel bucket. L'accesso dell'app agli oggetti creati da altre app o persone è limitato ai diritti concessi all'app dall'autore degli oggetti.

Se un oggetto viene creato nel bucket senza un ACL esplicitamente definito, viene utilizzato l'oggetto ACL predefinito assegnato al bucket dal proprietario del bucket. Se il proprietario del bucket non ha specificato un ACL dell'oggetto predefinito, il valore predefinito dell'oggetto è public-read, il che significa che chiunque sia autorizzato ad accedere 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 o aggiungervi elementi. Devi invece sovrascrivere l'oggetto con un nuovo oggetto con lo stesso nome che contenga le modifiche desiderate.

Cloud Storage e sottodirectory

La libreria client di App Engine per Cloud Storage consente di fornire delimitatori delle sottodirectory quando crei un oggetto, ma non esistono vere sottodirectory in Cloud Storage. ma una sottodirectory in Cloud Storage fa parte del nome file dell'oggetto.

Ad esempio, puoi supporre che, creando un oggetto somewhere/over/the/rainbow.mp3, il file rainbow.mp3 venga archiviato nella sottodirectory somewhere/over/the/. ma il nome dell'oggetto è impostato su somewhere/over/the/rainbow.mp3.

È importante capire questo concetto quando si utilizza il filtro listbucket.

Se il comportamento dell'elenco precedente non è ottimale per te, listbucket ha una modalità di emulazione della directory facoltativa. Consulta listbucket per ulteriori informazioni.

Passaggi successivi