Autoclass verwenden (original) (raw)

Übersicht

Auf dieser Seite erfahren Sie, wie Sie den Status der für einen Bucket in Cloud Storage festgelegten Autoclass-Funktion aktivieren, deaktivieren und prüfen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Storage Admin“ (roles/storage.admin) für den Bucket zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Festlegen und Verwalten von Autoclass für einen Bucket benötigen. Diese vordefinierte Rolle enthält die Berechtigungen, die zum Festlegen und Verwalten von Autoclass für einen Bucket erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die genau erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen erhalten.

Informationen zum Zuweisen von Rollen für Buckets finden Sie unter IAM-Richtlinien für Buckets festlegen und verwalten.

Autoclass für einen Bucket festlegen

Führen Sie folgende Schritte aus, um Autoclass für einen Bucket festzulegen:

Console

  1. Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
    Buckets aufrufen
  2. Klicken Sie in der Bucket-Liste auf den Namen des gewünschten Buckets.
  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.
  4. Klicken Sie für die Standardspeicherklasse auf das Symbol Bearbeiten ().
  5. Wählen Sie im eingeblendeten Fenster die Option Autoclass aus, um Autoclass zu aktivieren. Wählen Sie Standardklasse festlegen und dann eine Standardspeicherklasse für den Bucket aus, um Autoclass zu deaktivieren.
  6. Klicken Sie auf Bestätigen.
  7. Um die Terminalspeicherklasse für einen Bucket zu wechseln, für den Autoclass aktiviert ist, klicken Sie auf das Symbol Bearbeiten () für Enthaltene Klassen und dann im eingeblendeten Fenster auf Bestätigen.

Befehlszeile

Verwenden Sie den gcloud storage buckets update-Befehl mit den entsprechenden Flags:

gcloud storage buckets update gs://BUCKET_NAME --default-storage-class=DEFAULT_CLASS AUTOCLASS_FLAG

Dabei gilt:

Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:

Updating gs://my-bucket/... Completed 1

Clientbibliotheken

REST APIs

JSON API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.
  2. Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:
    {
    "storageClass": "DEFAULT_CLASS",
    "autoclass": {
    "enabled": BOOLEAN,
    "terminalStorageClass":TERMINAL_CLASS
    }
    }
    Dabei gilt:
    • DEFAULT_CLASS legt die Speicherklasse-Metadaten für den Bucket fest. Wenn Sie die Autoclass aktivieren, ist STANDARD der einzige gültige Wert und erforderlich, wenn der Bucket derzeit eine andere Speicherklasse verwendet.
    • BOOLEAN ist true, um Autoclass zu aktivieren, oder false, um Autoclass zu deaktivieren.
    • TERMINAL_CLASS ist dieTerminalspeicherklasse, die bei aktivierter Autoclass verwendet werden soll.
  3. Verwenden Sie cURL, um die JSON API mit einer PATCH-Bucket-Anfrage aufzurufen:
    curl -X PATCH --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?fields=autoclass"
    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 entsprechenden Buckets. Beispiel: my-bucket.

XML API

Dieses Feature kann nicht über die XML API verwaltet werden. Verwenden Sie stattdessen dieGoogle Cloud Console oder ein anderes Tool.

Autoclass-Status eines Buckets anzeigen

So zeigen Sie den Autoclass-Status für einen einzelnen Bucket an:

Console

  1. Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
    Buckets aufrufen
  2. Klicken Sie auf den Namen des Buckets, dessen Status Sie prüfen möchten.
  3. Klicken Sie auf den Tab Konfiguration.
  4. Der Status für Autoclass wird im Feld Standardspeicherklasse angezeigt.
    Wenn Autoclass aktiviert ist, lautet das Feld Verwaltet mit Autoclass und das Feld Eingeschlossene Klassen zeigt die Speicherklassen, zwischen denen Objekte wechseln können.

Befehlszeile

Verwenden Sie den Befehl gcloud storage buckets describe mit dem Flag --format:

gcloud storage buckets describe gs://BUCKET_NAME --format="default(autoclass)"

Dabei ist BUCKET_NAME der Name des Buckets, dessen Status Sie aufrufen möchten. Beispiel: my-bucket.

Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:

autoclass: enabled: true terminalStorageClass: ARCHIVE terminalStorageClassUpdateTime: '2023-02-10T16:11:02.384000+00:00' toggleTime: '2022-11-09T16:01:40.775000+00:00'

Clientbibliotheken

REST APIs

JSON API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.
  2. Verwenden Sie cURL, um die JSON API mit einer GET-Bucket-Anfrage aufzurufen, die das autoclass-Feld enthält:
    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=autoclass"
    Dabei ist BUCKET_NAME der Name des entsprechenden Buckets. Beispiel: my-bucket.
    Wenn Autoclass für den Bucket aktiviert ist, sieht die Antwort so aus:
    {
    "autoclass": {
    "enabled": "BOOLEAN",
    "toggleTime": "DATETIME",
    "terminalStorageClass": "STORAGE_CLASS",
    "terminalStorageClassUpdateTime": "DATETIME"
    },
    }

XML API

Dieses Feature kann nicht über die XML API verwaltet werden. Verwenden Sie stattdessen die Google Cloud Console oder ein anderes Tool.

Nächste Schritte