Über IBM Storage Ceph as a Service APIs
IBM Storage Ceph as a Service stellt Ihnen zwei APIs zur Verfügung, mit denen Sie Ihre Speicherressourcen konfigurieren und verwalten können.
Diese IBM Storage Ceph as a Service-APIs verwenden IBM Cloud® Identity and Access Management für Autorisierungs- und Authentifizierungsanfragen.
Da die „ Cloud Identity and Access Management “-Token relativ einfach zu handhaben sind, ist „ curl “ eine gute Wahl für grundlegende Tests und die Interaktion mit Ihrem Speicher. Weitere Informationen finden Sie in der curl-Referenz.
In den folgenden Abschnitten wird der gesamte Funktionsumfang der „ IBM Storage Ceph as a Service “-API beschrieben.
Block-Speicher-Verwaltungs-API
Verwenden Sie die Block-Speicherverwaltungs-API, um Block-Speicherressourcen innerhalb der IBM Storage Ceph as a Service-Bereitstellung programmgesteuert bereitzustellen und zu verwalten, einschließlich Volumes, Hosts und Volume-zu-Host-Zuordnungen.
Blockoperationen
Mit diesen Operationen lassen sich Blockspeicher anlegen, löschen, Informationen darüber abrufen und deren Verhalten steuern.
| Blockbetrieb | Aktion |
|---|---|
GET /volumes |
Wird verwendet, um eine Liste aller Blockvolumes abzurufen. |
DELETE /volumes/{id} |
Löscht ein Volume. |
POST /volumes |
Erstellen Sie Volumen in einer Bereitstellung. |
GET /volumes/{id} |
Ruft einen einzelnen Band ab. |
PATCH /volumes/{id} |
Aktualisiert den Namen oder die Kapazität eines Datenträgers. |
GET /hosts |
Ruft eine Liste aller Hosts in der Bereitstellung ab |
POST /hosts |
Erstellt einen neuen Host. |
DELETE /host/{id} |
Löscht einen bestimmten Host. |
GET /hosts/{id} |
Ruft einen bestimmten Host ab. |
PATCH /hosts/{id} |
Aktualisiert die Host-Informationen. |
POST /hosts/{id}/volume_mappings |
Erstellen Sie eine Volume-Zuordnung für einen Host. |
GET /hosts/{id}/volume_mappings/{volume_mapping_id} |
Ruft eine einzelne Volumenabbildung ab. |
GET /hosts/{id}/volume_mappings |
Ruft die Listen-Volume-Zuordnungen für einen Host ab. |
DELETE /hosts/{id}/volume_mappings/{volume_mapping_id} |
Löscht die spezifische Volume-Zuordnung. |
DELETE /hosts/{id}/volume_mappings |
Löscht alle Volume-Zuordnungen für einen Host. |
API zur Verwaltung der Objektspeicherung
Verwaltungsoperationen
Mit diesen Operationen lassen sich Verwaltungsobjekte anlegen, löschen, Informationen über sie abrufen und ihr Verhalten steuern.
| Verwaltungsvorgang | Anmerkung |
|---|---|
POST /certificates/{cert_type} |
Erstellen Sie ein „ S3 “-Zertifikat. |
PUT /certificates/{cert_type} |
Ersetzen oder aktualisieren Sie das Zertifikat für S3 |
GET /certificates/{cert_type} |
Ruft den Zertifikatsstatus ab. |
DELETE /certificates/{cert_type} |
Löscht das S3-Zertifikat. |
GET /certificates |
Ruft die Liste der konfigurierten Zertifikate ab |
POST /s3_credentials/{access_key} |
Erstellt S3-Berechtigung für Objekt. |
GET /s3_credentials |
Ruft einen oder mehrere S3-Zugangsdaten ab. |
DELETE /s3_credentials/{access_key} |
Löscht die Anmeldeinformationen für S3. |
Objektspeicher- S3-API
Die API „ IBM® Storage Ceph® as a Service “ Object Storage S3 ist eine REST-basierte API zum Lesen und Schreiben von Objekten.
Diese „ IBM Storage Ceph as a Service “-API nutzt „ IBM Cloud® Identity and Access Management “ für die Authentifizierung und Autorisierung und unterstützt eine Teilmenge der „ S3 “-API, um die Migration von Anwendungen zu „ IBM Cloud “ zu vereinfachen.
Objektoperationen
Mit diesen Operationen lassen sich Objekte vom Typ „ S3 “ erstellen, löschen, Informationen über sie abrufen und ihr Verhalten steuern.
| Objektoperation | Anmerkung |
|---|---|
DELETE Object |
Löscht ein Objekt aus einem Bucket. |
DELETE Stapelbericht |
Löscht mehrere Objekte mit einer Operation aus einem Bucket. |
GET Object |
Ruft ein Objekt aus einem Bucket ab. |
HEAD Object |
Ruft die Header eines Objekts ab. |
PUT Object |
Fügt ein Objekt zu einem Bucket hinzu. |
PUT Objekt (Kopieren) |
Erstellt eine Kopie eines Objekts. |
| Mehrteiligen Upload beginnen | Erstellt eine Upload-ID für eine Gruppe von Teilen, die hochgeladen werden sollen. |
| Teil hochladen | Lädt ein Teil eines Objekts hoch, das einer Upload-ID zugeordnet ist. |
| Teil hochladen (Kopieren) | Lädt ein Teil eines vorhandenen Objekts hoch, das einer Upload-ID zugeordnet ist. |
| Mehrteiligen Upload ausführen | Setzt ein Objekt aus den Teilen zusammen, die einer Upload-ID zugeordnet sind. |
| Mehrteiligen Upload abbrechen | Bricht den Upload ab und löscht noch anstehende Teile, die einer Upload-ID zugeordnet sind. |
| Teile auflisten | Gibt eine Liste der Teile zurück, die einer Upload-ID zugeordnet sind. |
Bucketoperationen
Mit diesen Operationen lassen sich Buckets erstellen, löschen, Informationen über sie abrufen und ihr Verhalten steuern.
| Bucketoperation | Anmerkung |
|---|---|
GET Buckets |
Wird verwendet, um eine Liste aller Buckets abzurufen, die zu einem Konto gehören. |
DELETE Bucket |
Löscht ein leeres Bucket. |
GET Bucket |
Listet die Objekte in einem Bucket auf. Es können maximal 1.000 Objekte gleichzeitig aufgelistet werden. |
HEAD Bucket |
Ruft die Header eines Buckets ab. |
GET Mehrteilige Uploads |
Listet mehrteilige Uploads auf, die nicht abgeschlossen oder abgebrochen wurden. |
PUT Bucket |
Die Buckets unterliegen Einschränkungen bei der Benennung. Konten sind auf 100 Buckets begrenzt. |
Weitere Informationen zu den Funktionen und Anwendungsfällen von IBM Storage Ceph as a Service finden Sie unter ibm.com.