Auf dieser Seite wird beschrieben, wie Sie die Storage-Klasse von Objekten in einem Bucket durch Umschreiben des Objekts ändern.
- Informationen dazu, wie Sie Objektspeicherklassen ändern, ohne ein Objekt umzuschreiben, finden Sie unter dem Feature Verwaltung des Objektlebenszyklus.
- Informationen dazu, wie Cloud Storage die Speicherklassen Ihres Objekts automatisch verwalten kann, finden Sie unter dem Feature Autoclass.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die Rolle „Storage-Objekt-Nutzer“ (roles/storage.objectUser
) für den Bucket zuzuweisen, um die erforderlichen Berechtigungen zum Ändern der Speicherklasse eines Objekts durch Überschreiben des Objekts zu erhalten.
Diese Rolle enthält die Berechtigungen, die zum Ändern der Speicherklasse eines Objekts erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list
Sie können diese Berechtigungen möglicherweise auch mit anderen vordefinierten Rollen oder benutzerdefinierten Rollen erhalten.
Eine Anleitung zum Zuweisen von Rollen für Buckets finden Sie unter IAM mit Buckets verwenden.
Speicherklasse eines Objekts ändern
So ändern Sie die Speicherklasse eines Objekts:
Console
Einzelne Objektspeicherklassen können nicht über die Google Cloud Console festgelegt werden. Verwenden Sie stattdessen die Google Cloud CLI.
Befehlszeile
Führen Sie den Befehl gcloud storage objects update
mit dem Flag --storage-class
aus. Beispiele:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME --storage-class=STORAGE_CLASS
Dabei gilt:
BUCKET_NAME
ist der Name des Buckets, der das Objekt enthält, dessen Klasse Sie ändern möchten. Beispiel:my-bucket
OBJECT_NAME
ist der Name des Objekts, dessen Klasse Sie ändern möchten. Beispiel:pets/dog.png
.STORAGE_CLASS
ist die neue Speicherklasse für Ihr Objekt. Beispiel:nearline
Clientbibliotheken
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:
{ "storageClass": "STORAGE_CLASS" }
Dabei gilt:
STORAGE_CLASS
ist die neue Speicherklasse für Ihr Objekt. Beispiel:nearline
Verwenden Sie
cURL
, um die JSON API mit einerPOST
-Objektanfrage aufzurufen: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"
Dabei gilt:
JSON_FILE_NAME
ist der Pfad für die JSON-Datei, die Sie in Schritt 2 erstellt haben.BUCKET_NAME
ist der Name des Buckets, der das ursprüngliche Objekt enthält. Beispiel:my-bucket
.OBJECT_NAME
ist der URL-codierte Name des Objekts. Beispiel:pets/dog.png
, URL-codiert alspets%2Fdog.png
.
XML API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Verwenden Sie
cURL
, um die XML API mit einerPUT
-Objektanfrage aufzurufen: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"
Dabei gilt:
OBJECT
ist der lokale Pfad zu dem Objekt, dessen Speicherklasse Sie ändern möchten. Sie müssen das Objekt beim Ändern der Speicherklasse mit der XML API neu hochladen. Beispiel:Desktop/dog.png
OBJECT_CONTENT_TYPE
ist der Inhaltstyp des Objekts. Beispiel:image/png
STORAGE_CLASS
ist die neue Speicherklasse für Ihr Objekt. Beispiel:nearline
.BUCKET_NAME
ist der Name des Buckets, der das Objekt enthält, das Sie umschreiben. Beispiel:my-bucket
OBJECT_NAME
ist der URL-codierte Name des Objekts, das Sie umschreiben. Beispiel:pets/dog.png
, URL-codiert alspets%2Fdog.png
.
Nächste Schritte
- Speicherklassen
- Objektspeicherklassen mit Object Lifecycle Management ändern
- Weitere Features des Datenlebenszyklus in Cloud Storage
- Mehr über Objektmetadaten erfahren
- Anfragevorbedingungen verwenden, um Race-Bedingungen zu verhindern