Questa pagina descrive come modificare la classe di archiviazione degli oggetti all'interno di un bucket riscrivendoli.
- Per scoprire come modificare le classi di archiviazione degli oggetti senza riscrivere un oggetto, consulta la funzionalità Gestione del ciclo di vita degli oggetti.
- Per scoprire come Cloud Storage può gestire automaticamente le classi di archiviazione degli oggetti, consulta la funzionalità Autoclass.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per modificare la classe di archiviazione di un oggetto riscrivendolo, chiedi all'amministratore di concederti il ruolo Utente oggetti Storage (roles/storage.objectUser
) per il bucket.
Questo ruolo contiene le autorizzazioni necessarie per modificare la classe di archiviazione di un oggetto. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list
Potresti anche ottenere queste autorizzazioni con altri ruoli predefiniti o ruoli personalizzati.
Per istruzioni sulla concessione dei ruoli sui bucket, consulta Utilizzare IAM con i bucket.
Modificare la classe di archiviazione di un oggetto
Per modificare la classe di archiviazione di un oggetto:
Console
Le classi di archiviazione dei singoli oggetti non possono essere impostate tramite la consoleGoogle Cloud . Utilizza invece Google Cloud CLI.
Riga di comando
Utilizza il comando gcloud storage objects update
con il flag --storage-class
. Ad esempio:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME --storage-class=STORAGE_CLASS
Dove:
BUCKET_NAME
è il nome del bucket contenente l'oggetto di cui vuoi modificare la classe. Ad esempio,my-bucket
.OBJECT_NAME
è il nome dell'oggetto di cui vuoi modificare la classe. Ad esempio,pets/dog.png
.STORAGE_CLASS
è la nuova classe di archiviazione per il tuo oggetto. Ad esempio:nearline
.
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
API REST
API JSON
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Crea un file JSON contenente le seguenti informazioni:
{ "storageClass": "STORAGE_CLASS" }
Dove:
STORAGE_CLASS
è la nuova classe di archiviazione per il tuo oggetto. Ad esempio:nearline
.
Utilizza
cURL
per chiamare l'API JSON con un oggettoPOST
, richiesta:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME/rewriteTo/b/BUCKET_NAME/o/OBJECT_NAME"
Dove:
JSON_FILE_NAME
è il percorso del file JSON che hai creato nel passaggio 2.BUCKET_NAME
è il nome del bucket contenente l'oggetto originale. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto. Ad esempio,pets/dog.png
, codificato come URLpets%2Fdog.png
.
API XML
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiesta diPUT
oggetto:curl -X PUT --data-binary @OBJECT \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: OBJECT_CONTENT_TYPE" \ -H "x-goog-storage-class: STORAGE_CLASS" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Dove:
OBJECT
è il percorso locale dell'oggetto di cui vuoi modificare la classe di archiviazione (devi ricaricare l'oggetto quando modifichi la classe di archiviazione con l'API XML). Ad esempio,Desktop/dog.png
.OBJECT_CONTENT_TYPE
è il tipo di contenuto dell'oggetto. Ad esempio:image/png
.STORAGE_CLASS
è la nuova classe di archiviazione per il tuo oggetto. Ad esempio:nearline
.BUCKET_NAME
è il nome del bucket contenente l'oggetto che stai riscrivendo. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto che stai riscrivendo. Ad esempio,pets/dog.png
, codificato come URL comepets%2Fdog.png
.
Passaggi successivi
- Scopri di più sulle classi di archiviazione disponibili.
- Modifica le classi di archiviazione degli oggetti con la Gestione del ciclo di vita degli oggetti.
- Esplora altre funzionalità del ciclo di vita dei dati di Cloud Storage.
- Scopri di più sui metadati degli oggetti.
- Scopri come utilizzare le precondizioni delle richieste per evitare le race condition.