Auf dieser Seite wird gezeigt, wie Sie Cloud Storage-Buckets erstellen. Wenn in der Anfrage nichts anderes angegeben ist, werden Buckets in der US
-Multiregion mit der Standardspeicherklasse Standard Storage erstellt und haben eine Vorläufig löschen-Aufbewahrungsdauer von sieben Tagen.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle "Storage Admin" (roles/storage.admin
) für das Projekt zuzuweisen, um die erforderlichen Berechtigungen zum Erstellen eines Cloud Storage-Buckets zu erhalten.
Diese vordefinierte Rolle enthält die Berechtigung zum Erstellen eines Buckets. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
storage.buckets.create
storage.buckets.enableObjectRetention
(nur erforderlich, wenn Objektaufbewahrungskonfigurationen für den Bucket aktiviert werden)storage.buckets.list
(nur erforderlich, wenn Sie einen Bucket mit der Google Cloud Console erstellen)resourcemanager.projects.get
(nur erforderlich, wenn Sie einen Bucket mit der Google Cloud Console erstellen)
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten. Informationen dazu, welche Rollen mit welchen Berechtigungen verknüpft sind, finden Sie unter IAM-Rollen für Cloud Storage.
Eine Anleitung zum Zuweisen von Rollen für Projekte finden Sie unter Zugriff auf Projekte verwalten.
Neuen Bucket erstellen
Wenn Sie zum ersten Mal einen Bucket erstellen, lesen Sie den Hilfeartikel Objektspeicher mit der Google Cloud Console entdecken oder Objektspeicher mit der Google Cloud CLI entdecken.
So erstellen Sie Bucket mit bestimmten Einstellungen oder erweiterten Konfigurationen:
Console
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
Klicken Sie auf
Erstellen.Geben Sie auf der Seite Bucket erstellen die Bucket-Informationen ein. Klicken Sie nach jedem der folgenden Schritte auf Weiter, um mit dem nächsten Schritt fortzufahren:
Führen Sie im Abschnitt Einstieg die folgenden Schritte aus:
- Geben Sie einen global eindeutigen Namen ein, der den Anforderungen für Bucket-Namen entspricht.
Wenn Sie den hierarchischen Namespace aktivieren möchten, klicken Sie auf den Maximierungspfeil , um den Bereich Für dateiorientierte und datenintensive Arbeitslasten optimieren zu maximieren, und wählen Sie dann Hierarchischen Namespace für diesen Bucket aktivieren aus.
So fügen Sie ein Bucket-Label hinzu: Klicken Sie auf den Erweiterungspfeil, um den Abschnitt Label zu maximieren, klicken Sie auf add_box Label hinzufügen und geben Sie
key
undvalue
für Ihr Label an.
Gehen Sie im Bereich Speicherort für Daten auswählen so vor:
Standorttyp auswählen.
Wählen Sie im Drop-down-Menü für den Standorttyp einen Speicherort aus, an dem die Objektdaten in Ihrem Bucket dauerhaft gespeichert werden sollen.
- Wenn Sie den Standorttyp Dual-Region auswählen, können Sie auch die Turboreplikation aktivieren, indem Sie das entsprechende Kästchen anklicken.
Wenn Sie die Bucket-übergreifende Replikation einrichten möchten, maximieren Sie den Bereich Bucket-übergreifende Replikation einrichten und führen Sie die folgenden Schritte aus:
Bucket-übergreifende Replikation einrichten
- Klicken Sie das Kästchen neben Bucket-übergreifende Replikation über Storage Transfer Service hinzufügen an.
- Wählen Sie im Menü Ziel-Bucket einen Ziel-Bucket aus.
Klicken Sie im Bereich Replikationseinstellungen auf Konfigurieren, um die Einstellungen für den Replikationsjob zu konfigurieren.
Der Bereich Bucket-übergreifende Replikation konfigurieren wird angezeigt.
- Wenn Sie die zu replizierenden Objekte nach dem Objektnamenspräfix filtern möchten, geben Sie ein Präfix ein, mit dem Sie Objekte ein- oder ausschließen möchten, und klicken Sie dann auf Präfix hinzufügen.
- Wenn Sie eine Speicherklasse für die replizierten Objekte festlegen möchten, wählen Sie im Menü Speicherklasse eine Speicherklasse aus. Wenn Sie diesen Schritt überspringen, verwenden die replizierten Objekte standardmäßig die Speicherklasse des Ziel-Buckets.
- Klicken Sie auf Fertig.
Im Abschnitt Speicherklasse für Ihre Daten auswählen wählen Sie entweder Standardspeicherklasse für den Bucket oder wählen Sie Autoclass zur automatischen Verwaltung der Speicherklassen Ihrer Bucket-Daten.
Im Abschnitt Zugriff auf Objekte steuern wählen Sie aus, ob der Bucket Verhinderung des öffentlichen Zugriffs durchsetzt, und wählen Sie ein Zugriffssteuerungsmodell für die Objekte Ihres Buckets.
Gehen Sie im Abschnitt Festlegen, wie Objektdaten geschützt werden sollen so vor:
Wählen Sie unter Datenschutz die Optionen aus, die Sie für Ihren Bucket festlegen möchten.
Um auszuwählen, wie Ihre Objektdaten verschlüsselt werden, klicken Sie auf den Methode für die Datenverschlüsselung “
Erweiterungspfeil mit Label Datenverschlüsselung und wählen Sie eine
Klicken Sie auf Erstellen.
Unter Fehlerbehebung erfahren Sie, wie Sie detaillierte Fehlerinformationen zu fehlgeschlagenen Cloud Storage-Vorgängen in der Google Cloud Console abrufen.
Befehlszeile
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Führen Sie in Ihrer Entwicklungsumgebung den Befehl
gcloud storage buckets create
aus:gcloud storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION
Dabei gilt:
BUCKET_NAME
ist der Name, den Sie dem Bucket gemäß den Benennungsanforderungen geben möchten. Beispiel:my-bucket
.BUCKET_LOCATION
ist der Standort des Buckets. Beispiel:us-east1
Wenn die Anfrage erfolgreich ist, gibt der Befehl die folgende Meldung zurück:
Creating gs://BUCKET_NAME/...
Mit den folgenden optionalen Flags können Sie das Erstellen des Buckets noch genauer steuern:
--project
: Geben Sie die Projekt-ID oder Nummer des Projekts an, mit dem der Bucket verknüpft wird. Beispiel:my-project
.--default-storage-class
: Geben Sie die Standardspeicherklasse des Buckets an. Beispiel:STANDARD
--uniform-bucket-level-access
: Aktivieren Sie den einheitlichen Zugriff auf Bucket-Ebene für Ihren Bucket.
Beispiel:
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access
Eine vollständige Liste der Optionen für die Bucket-Erstellung finden Sie in der gcloud CLI unter
buckets create
-Optionen.
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.
Terraform
Sie können eine Terraform-Ressource zum Erstellen eines Storage-Buckets verwenden.
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 mit den Einstellungen für den Bucket, darunter auch ein
name
für den Bucket. Eine vollständige Liste der Einstellungen finden Sie in der Dokumentation zu Buckets:Insert. Folgende Einstellungen können verwendet werden:{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Dabei gilt:
BUCKET_NAME
ist der Name, den Sie Ihrem Bucket zuweisen möchten. Beachten Sie dabei die Anforderungen für Bucket-Namen. Beispiel:my-bucket
.BUCKET_LOCATION
ist der Standort, an dem Sie die Objektdaten Ihres Buckets speichern möchten. Beispiel:US-EAST1
.STORAGE_CLASS
ist die Standardspeicherklasse Ihres Buckets. Beispiel:STANDARD
Verwenden Sie
cURL
zum Aufrufen der JSON API: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?project=PROJECT_IDENTIFIER"
Dabei gilt:
JSON_FILE_NAME
ist der Name der JSON-Datei, die Sie in Schritt 2 erstellt haben.PROJECT_IDENTIFIER
ist die ID oder Nummer des Projekts, mit dem Ihr Bucket verknüpft wird. Beispiel:my-project
XML API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Erstellen Sie eine XML-Datei, die Einstellungen für den Bucket enthält. Eine vollständige Liste der Einstellungen finden Sie in der Dokumentation XML: Bucket erstellen. Folgende Einstellungen können verwendet werden:
<CreateBucketConfiguration> <StorageClass>STORAGE_CLASS</StorageClass> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> </CreateBucketConfiguration>
Dabei gilt:
STORAGE_CLASS
ist die Standardspeicherklasse Ihres Buckets. Beispiel:STANDARD
.BUCKET_LOCATION
ist der Standort, an dem Sie die Objektdaten Ihres Buckets speichern möchten. Beispiel:US-EAST1
.
Verwenden Sie
cURL
zum Aufrufen der XML API:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.googleapis.com/BUCKET_NAME"
Dabei gilt:
XML_FILE_NAME
ist der Name der XML-Datei, die Sie in Schritt 2 erstellt haben.PROJECT_ID
ist die ID des Projekts, mit dem Ihr Bucket verknüpft wird. Beispiel:my-project
.BUCKET_NAME
ist der Name, den Sie Ihrem Bucket zuweisen möchten. Beachten Sie dabei die Anforderungen für Bucket-Namen. Beispiel:my-bucket
.
Wenn die Anfrage erfolgreich war, wird keine Antwort zurückgegeben.
Nächste Schritte
- Buckets in einem Projekt auflisten
- Mehr über die mit einem Bucket verknüpften Metadaten erfahren.
- Buckets verschieben und umbenennen
- Buckets löschen
- Objekte in Ihren Bucket hochladen.
- Mit dem Kubernetes Config Connector können Sie Bucket deklarativ erstellen und konfigurieren. So können Sie Google Cloud-Ressourcen mithilfe von Kubernetes-Tools, ‑APIs und ‑Konfigurationen beschreiben. Weitere Informationen finden Sie in der Config Connector API-Dokumentation.
Überzeugen Sie sich selbst
Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit von Cloud Storage in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
Cloud Storage kostenlos testen