IBM Storage Ceph as a Service APIについて

IBM Storage Ceph as a Service ストレージリソースの設定と管理を行うための2つのAPIを提供します。

これらの IBM Storage Ceph as a Service APIは、認可および認証リクエストに IBM Cloud® Identity and Access Management を使用しています。

Cloud Identity and Access Management トークンは比較的扱いやすいため、 curl は、基本的なテストやストレージとの連携を行う上で適した選択肢です。詳しくは、curl 解説書を参照してください。

以下のセクションでは、 IBM Storage Ceph as a Service API のすべての操作について説明します。

ブロックストレージ管理API

IBM Storage Ceph as a Service デプロイメント内のブロックストレージリソース（ボリューム、ホスト、ボリュームとホストのマッピングなど）をプログラムでプロビジョニングおよび管理するには、ブロックストレージ管理 API を使用します。

ブロック操作

これらの操作により、ブロックストレージの作成、削除、情報の取得、および動作の制御が行われます。

ブロックストレージ操作
ブロック操作	アクション
`GET /volumes`	すべてのブロックボリュームのリストを取得するために使用します。
`DELETE /volumes/{id}`	ボリュームを削除します。
`POST /volumes`	展開にボリュームを持たせる。
`GET /volumes/{id}`	1つのボリュームを取得します。
`PATCH /volumes/{id}`	ボリュームの名前または容量を更新します。
`GET /hosts`	デプロイメント内のすべてのホストのリストを取得します
`POST /hosts`	新しいホストを作成します。
`DELETE /host/{id}`	特定のホストを削除します。
`GET /hosts/{id}`	特定のホストを取得します。
`PATCH /hosts/{id}`	ホスト情報を更新します。
`POST /hosts/{id}/volume_mappings`	ホストのボリュームマッピングを作成します。
`GET /hosts/{id}/volume_mappings/{volume_mapping_id}`	単一のボリュームマッピングを取得します。
`GET /hosts/{id}/volume_mappings`	ホストのリストボリュームマッピングを取得します。
`DELETE /hosts/{id}/volume_mappings/{volume_mapping_id}`	特定のボリュームマッピングを削除します。
`DELETE /hosts/{id}/volume_mappings`	ホストのすべてのボリュームマッピングを削除します。

オブジェクトストレージ管理API

「管理」操作

これらの操作により、管理オブジェクトの作成、削除、情報の取得、および動作の制御が行われます。

オブジェクト管理操作
管理業務	注
`POST /certificates/{cert_type}`	S3 証明書を作成します。
`PUT /certificates/{cert_type}`	S3 証明書を置き換えまたは更新する
`GET /certificates/{cert_type}`	証明書のステータスを取得します。
`DELETE /certificates/{cert_type}`	S3 証明書を削除します。
`GET /certificates`	設定済みの証明書のリストを取得する
`POST /s3_credentials/{access_key}`	オブジェクト用の S3 認証情報を作成します。
`GET /s3_credentials`	1つ以上の S3 認証情報を取得します。
`DELETE /s3_credentials/{access_key}`	S3 の認証情報を削除します。

オブジェクトストレージ「 S3 」API

IBM® Storage Ceph® as a Service Object Storage S3 API は、オブジェクトの読み取りおよび書き込みを行うための REST ベースの API です。

この IBM Storage Ceph as a Service APIは、認証および認可に IBM Cloud® Identity and Access Management を使用しており、アプリケーションを IBM Cloud へ容易に移行できるよう、 S3 APIの一部の機能をサポートしています。

オブジェクト操作

これらの操作により、 S3 オブジェクトの作成、削除、情報の取得、および動作の制御を行うことができます。

オブジェクト操作
オブジェクト操作	注
`DELETE` オブジェクト	バケットからオブジェクトを削除します。
`DELETE` バッチ	1 つの操作でバケットから多数のオブジェクトを削除します。
`GET` オブジェクト	バケットからオブジェクトを取得します。
`HEAD` オブジェクト	オブジェクトのヘッダーを取得します。
`PUT` オブジェクト	バケットにオブジェクトを追加します。
`PUT` オブジェクト (コピー)	オブジェクトのコピーを作成します。
マルチパート・アップロードの開始	アップロードするパートのセットのアップロード ID を作成します。
パートのアップロード	アップロード ID と関連付けられた、オブジェクトのパートをアップロードします。
パートのアップロード (コピー)	アップロード ID と関連付けられた、既存オブジェクトのパートをアップロードします。
マルチパート・アップロードの実行	1 つのアップロード ID と関連付けられた一連のパートから 1 つのオブジェクトを組み立てます。
マルチパート・アップロードのキャンセル	アップロードをキャンセルし、アップロード ID と関連付けられた未処理パートを削除します。
パートのリスト	アップロードIDに関連付けられているパーツのリストを返します。

バケット操作

これらの操作により、バケットの作成、削除、情報の取得、および動作の制御を行うことができます。

バケット操作
バケット操作	注
`GET` バケット	アカウントに属しているすべてのバケットのリストを取得するために使用されます。
`DELETE` バケット	空のバケットを削除します。
`GET` バケット	バケット内のオブジェクトをリストします。一度にリストできるのは 1,000 オブジェクトに制限されています。
`HEAD` バケット	バケットのヘッダーを取得します。
`GET` マルチパート・アップロード	未完了またはキャンセル済みのマルチパート・アップロードをリストします。
`PUT` バケット	バケットの命名には制約があります。アカウントは 100 バケットに制限されます。

IBM Storage Ceph as a Service の機能と使用例に関する詳細は、こちらでご覧いただけます。 ibm.com。