Storage API の概要

オブジェクト ストレージ

Object Storage API には、Kubernetes Resource Model（KRM）と S3 REST API のセクションが含まれています。ブロック ストレージは、標準の Kubernetes ストレージ API（https://kubernetes.io/docs/concepts/storage/）で管理されます。

Object Storage API は Kubernetes カスタム リソースを使用し、Kubernetes リソースモデルに依存します。API は、オブジェクト ストレージ リソースのプロビジョニングと管理に使用されます。これらは、バケットの作成、読み取り、更新、削除など、組織内のオブジェクト ストレージ リソースのライフサイクルを管理するために使用されます。API は、バケットとバケットレベルのアクセス制御のリスト表示、保持ポリシーの設定、ストレージ クラスの設定にも使用されます。

サービス エンドポイントとディスカバリ ドキュメント

次の URL は、オブジェクト ストレージ API の API エンドポイントです。ここで、MANAGEMENT_API_SERVER_ENDPOINT は Management API サーバーの API エンドポイントです。https://MANAGEMENT_API_SERVER_ENDPOINT/apis/object.gdc.goog/v1

kubectl proxy コマンドを使用すると、ブラウザまたは curl などのツールでその URL にアクセスして、Object Storage API のディスカバリ ドキュメントを取得できます。kubectl proxy コマンドは、ローカルマシンの Kubernetes API サーバーへのプロキシを開きます。このコマンドの実行後、次の URL（http://127.0.0.1:8001/apis/object.gdc.goog/v1）でドキュメントにアクセスします。

S3 REST API の概要

ソフトウェア定義ストレージ は、Amazon S3 API と互換性のあるオブジェクト ストレージ API を提供します。Google Distributed Cloud（GDC）エアギャップ アプライアンスのオブジェクト ストレージ XML API は、オブジェクト ストレージ データをプログラムで管理できる RESTful インターフェースです。RESTful API として、実行するオペレーションを定義するためにメソッド情報とスコープ情報に依存します。

  • メソッド情報。メソッド情報は、DELETE、GET、HEAD、PUT などの標準 HTTP メソッドで指定します。
  • スコープ情報。スコーピング情報は、アクセス可能なエンドポイント（URI）とさまざまなスコーピング パラメータで指定します。XML API の場合、主なスコープ設定パラメータはバケット名とオブジェクト名です。HTTP ヘッダーとクエリ文字列パラメータを使用して、オペレーションのスコープをさらに絞り込みます。

ブロック ストレージ

ボリューム ストレージ API の概要

GDC 内のストレージとのやり取りは、すべて Kubernetes ストレージ プリミティブを使用して行われます。永続ボリュームを作成するには、Kubernetes のドキュメント（https://kubernetes.io/docs/concepts/storage/persistent-volumes/）をご覧ください。

永続ボリューム クレームの例を次に示します。

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