In questa pagina viene descritto come modificare la classe di archiviazione degli oggetti all'interno di un bucket mediante la riscrittura dell'oggetto.
- Per informazioni su 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 del tuo oggetto, consulta la funzionalità Autoclass.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per modificare la classe di archiviazione di un oggetto mediante la riscrittura dell'oggetto, chiedi all'amministratore di concederti il ruolo Utente oggetti Storage (roles/storage.objectUser
) nel bucket.
Questo ruolo contiene le autorizzazioni necessarie per modificare la classe di archiviazione di un oggetto. Per visualizzare 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 riuscire a ottenere queste autorizzazioni con altri ruoli predefiniti o ruoli personalizzati.
Per istruzioni sulla concessione dei ruoli sui bucket, consulta Utilizzare IAM con i bucket.
Modifica della classe di archiviazione di un oggetto
Per modificare la classe di archiviazione di un oggetto:
Console
Non è possibile impostare classi di archiviazione di singoli oggetti tramite la console Google 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 che contiene 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 l'oggetto. Ad esempio:nearline
.
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Installa e inizializzatogcloud CLI per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'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 creato al passaggio 2.BUCKET_NAME
è il nome del bucket che contiene l'oggetto originale. Ad esempio,my-bucket
.OBJECT_NAME
è il nome dell'oggetto con codifica URL. Ad esempio,pets/dog.png
, con codifica URLpets%2Fdog.png
.
API XML
Installa e inizializzatogcloud CLI per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiesta OggettoPUT
: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
, con codifica URL comepets%2Fdog.png
.
Passaggi successivi
- Scopri di più sulle classi di archiviazione disponibili.
- Modificare le classi di archiviazione degli oggetti con 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 condizioni preliminari per le richieste per prevenire le condizioni di gara.