Informationen zur S3-API von IBM Cloud Object Storage
Die IBM Cloud® Object Storage-API ist eine REST-basierte API für das Lesen und Schreiben von Objekten.
Sie verwendet IBM Cloud® Identity and Access Management für die Authentifizierung und Berechtigung und unterstützt eine Untergruppe der S3-API für die einfache Migration von Anwendungen auf IBM Cloud.
Diese Referenzdokumentation wird laufend verbessert. Wenn Sie technische Fragen zur Verwendung der API in Ihrer Anwendung haben, posten Sie sie unter StackOverflow. Fügen Sie die Tags ibm-cloud-platform und object-storage hinzu und verbessern Sie diese Dokumentation mit Ihrem Feedback.
Da das Arbeiten mit Cloud Identity and Access Management-Tokens relativ einfach ist, stellt curl eine gute Wahl zum Durchführen grundlegender Tests und zur Interaktion mit Ihrem Speicher dar. Weitere Informationen finden Sie in der
curl-Referenz.
In den folgenden Tabellen wird die vollständige Gruppe der Operationen in der IBM Cloud Object Storage-API beschrieben. Weitere Informationen finden Sie auf der API-Referenzseite für Buckets oder Objekte.
Bucketoperationen
Diese Operationen dienen zum Erstellen und Löschen von Buckets, zum Abrufen von Informationen zu Buckets und zum Steuern des Verhaltens von Buckets.
| 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. |
DELETE Bucket-CORS |
Löscht die gesamte CORS-Konfiguration (CORS = Cross-Origin Resource Sharing), die für ein Bucket festgelegt wurde. |
GET Bucket |
Listet die Objekte in einem Bucket auf. Es können maximal 1.000 Objekte gleichzeitig aufgelistet werden. |
GET Bucket-CORS |
Ruft die gesamte CORS-Konfiguration ab, die für ein Bucket festgelegt wurde. |
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. |
PUT Bucket-CORS |
Erstellt eine CORS-Konfiguration für einen Bucket. |
Objektoperationen
Diese Operationen dienen zum Erstellen und Löschen von Buckets, zum Abrufen von Informationen zu Buckets und zum Steuern des Verhaltens von Buckets.
| 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. |
OPTIONS Object |
Überprüft die CORS-Konfiguration, um festzustellen, ob eine bestimmte Anforderung gesendet werden kann. |
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. |
Weitere Informationen zu den Features und Anwendungsfällen von IBM Cloud Object Storage finden Sie unter ibm.com.