Übersicht über die Storage API

Objektspeicher

Die Object Storage API umfasst Abschnitte zum Kubernetes-Ressourcenmodell (Kubernetes Resource Model, KRM) und zur S3 REST API. Blockspeicher wird mit der standardmäßigen Kubernetes Storage API verwaltet (https://kubernetes.io/docs/concepts/storage/).

Die Object Storage API verwendet benutzerdefinierte Kubernetes-Ressourcen und basiert auf dem Kubernetes-Ressourcenmodell. Die APIs werden zum Bereitstellen und Verwalten von Objektspeicherressourcen verwendet. Sie werden verwendet, um den Lebenszyklus von Objektspeicherressourcen in der Organisation zu verwalten, einschließlich des Erstellens, Lesens, Aktualisierens und Löschens von Buckets. Die APIs werden auch zum Auflisten und Festlegen von Aufbewahrungsrichtlinien und der Speicherklasse von Buckets sowie für die Zugriffssteuerung auf Bucket-Ebene verwendet.

Dienstendpunkt und Discovery-Dokument

Die folgende URL ist der API-Endpunkt für die Object Storage APIs: https://MANAGEMENT_API_SERVER_ENDPOINT/apis/object.gdc.goog/v1, wobei MANAGEMENT_API_SERVER_ENDPOINT der API-Endpunkt Ihres Management API-Servers ist.

Mit dem Befehl kubectl proxy können Sie in Ihrem Browser oder mit einem Tool wie curl auf diese URL zugreifen, um das Discovery-Dokument für die Object Storage API abzurufen. Mit dem Befehl kubectl proxy wird ein Proxy zum Kubernetes API-Server auf Ihrem lokalen Computer geöffnet. Nachdem der Befehl ausgeführt wurde, können Sie über die folgende URL auf das Dokument zugreifen: http://127.0.0.1:8001/apis/object.gdc.goog/v1.

S3 REST API – Übersicht

Software-defined storage bietet die mit der Amazon S3 API kompatible Object Storage API. Die Object Storage XML API für die Air-Gap-Appliance von Google Distributed Cloud (GDC) ist eine RESTful-Schnittstelle, mit der Sie Objektspeicherdaten programmatisch verwalten können. Als RESTful API stützt sie sich auf Methoden- und Bereichsinformationen, um die auszuführenden Vorgänge zu definieren:

  • Methodeninformationen Sie geben die Methodeninformationen mit Standard-HTTP-Methoden wie DELETE, GET, HEAD und PUT an.
  • Informationen zum Umfang Sie geben die Bereichsinformationen mit einem zugänglichen Endpunkt (URI) und verschiedenen Bereichsparametern an. Für die XML API sind die primären Bereichsparameter die Bucket- und Objektnamen. Sie können den Umfang Ihrer Vorgänge weiter einschränken, indem Sie HTTP-Header und Abfragestringparameter verwenden.

Blockspeicher

Volume Storage API – Übersicht

Die Interaktion mit dem Speicher in GDC erfolgt ausschließlich über die Kubernetes-Speicherprimitive. Folgen Sie der Dokumentation von Kubernetes (https://kubernetes.io/docs/concepts/storage/persistent-volumes/), um nichtflüchtige Volumes zu erstellen.

Hier ist ein Beispiel für einen PersistentVolumeClaim:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: my_volume
spec:
accessModes:
- ReadWriteOnce
volumeMode: Filesystem
resources:
requests:
storage: 1Gi
storageClassName: standard-rwo