|
| 1 | +--- |
| 2 | +title: "Verwaltung von RustFS‑Objekten" |
| 3 | +description: "Erstellen (Upload) und Löschen von Objekten" |
| 4 | +--- |
| 5 | + |
| 6 | +# RustFS‑Objekte |
| 7 | + |
| 8 | +Ein Objekt ist die Basiseinheit der Speicherung in RustFS. Es enthält Daten, Metadaten und einen eindeutigen Bezeichner (Object Key). Dieses Kapitel zeigt die Objektverwaltung am Beispiel von Datei‑Upload und ‑Löschung. |
| 9 | + |
| 10 | +> Zu objektbezogenen Begriffen siehe [Grundlagen](../../concepts/glossary.md). |
| 11 | +
|
| 12 | +## Objekt erstellen |
| 13 | + |
| 14 | +Voraussetzungen: |
| 15 | + |
| 16 | +- Eine verfügbare RustFS‑Instanz (siehe ../../installation/index.md). |
| 17 | + |
| 18 | +Erstellen Sie zunächst einen [Bucket](bucket-create-and-delete.md) und laden Sie anschließend eine Datei in diesen Bucket hoch. Das kann über die UI, `mc` oder die API erfolgen. |
| 19 | + |
| 20 | +### Upload über die RustFS‑UI |
| 21 | + |
| 22 | +1. Melden Sie sich an der RustFS UI‑Konsole an. |
| 23 | +1. Wählen Sie den Ziel‑Bucket aus. |
| 24 | +1. Rechts oben auf der Bucket‑Seite wählen Sie „Neuer Ordner“, „Neue Datei“ oder „Datei/Ordner hochladen“. |
| 25 | +1. Für lokale Uploads klicken Sie auf „Datei/Ordner hochladen“, wählen die lokalen Elemente aus und klicken auf „Upload starten“. |
| 26 | + |
| 27 | + |
| 28 | + |
| 29 | +Nach dem Upload können Sie Details des Objekts einsehen. |
| 30 | + |
| 31 | + |
| 32 | + |
| 33 | +### Upload mit `mc` |
| 34 | + |
| 35 | +> Siehe [`mc`‑Leitfaden](../mc.md). |
| 36 | +
|
| 37 | +``` |
| 38 | +# upload file |
| 39 | +mc cp 1.txt rustfs/bucket-creation-by-mc |
| 40 | +/tmp/1.txt: 13 B / 13 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 61 B/s 0s% |
| 41 | +
|
| 42 | +# confirm file uploaded |
| 43 | +mc ls rustfs/bucket-creation-by-mc |
| 44 | +[2025-08-01 10:01:08 CST] 13B 1.txt |
| 45 | +``` |
| 46 | + |
| 47 | +### Upload per API |
| 48 | + |
| 49 | +``` |
| 50 | +PUT /{bucketName}/{objectName} HTTP/1.1 |
| 51 | +``` |
| 52 | + |
| 53 | +Beispiel: |
| 54 | + |
| 55 | +``` |
| 56 | +curl --location --request PUT 'http://12.34.56.78:9000/bucket-creation-by-api/password.txt' \ |
| 57 | +--header 'Content-Type: text/plain' \ |
| 58 | +--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \ |
| 59 | +--header 'X-Amz-Date: 20250801T024840Z' \ |
| 60 | +--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-content-sha256;x-amz-date, Signature=b7d8dc29ee34dfdf1f3e9e8e069892a8936f478586e7a2c90cf34f5b86d3a2dc' \ |
| 61 | +--data-binary '@/path/to/password.txt' |
| 62 | +``` |
| 63 | + |
| 64 | +## Objekt löschen |
| 65 | + |
| 66 | +Das Löschen kann über die UI, `mc` oder die API erfolgen. Löschen Sie z. B. die oben erstellte Datei. |
| 67 | + |
| 68 | +## Löschung über die RustFS‑UI |
| 69 | + |
| 70 | +1. Melden Sie sich an der RustFS UI‑Konsole an. |
| 71 | +1. Wählen Sie den Bucket, der die Datei enthält. |
| 72 | +1. Wählen Sie die zu löschende Datei aus. |
| 73 | +1. Klicken Sie rechts oben auf „Ausgewählte löschen“ und bestätigen Sie im Dialog. |
| 74 | + |
| 75 | + |
| 76 | + |
| 77 | +### Löschen mit `mc` |
| 78 | + |
| 79 | +``` |
| 80 | +# delete file |
| 81 | +mc rm rustfs/bucket-creation-by-mc/1.txt |
| 82 | +Removed `rustfs/bucket-creation-by-mc/1.txt`. |
| 83 | +
|
| 84 | +# confirm deletion |
| 85 | +mc ls rustfs/bucket-creation-by-mc/1.txt |
| 86 | +``` |
| 87 | + |
| 88 | +### Löschen per API |
| 89 | + |
| 90 | +``` |
| 91 | +DELETE /{bucketName}/{objectName} HTTP/1.1 |
| 92 | +``` |
| 93 | + |
| 94 | +Beispiel: |
| 95 | + |
| 96 | +``` |
| 97 | +curl --location --request DELETE 'http://12.34.56.78:9000/bucket-creation-by-api/password.txt' \ |
| 98 | +--header 'Content-Type: text/plain' \ |
| 99 | +--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \ |
| 100 | +--header 'X-Amz-Date: 20250801T030822Z' \ |
| 101 | +--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-content-sha256;x-amz-date, Signature=1ee63bb0b699598602b2fdbd013e355a57bcb9991307a8ad41f6512e8afebf3a' \ |
| 102 | +--data-binary '@/Users/jhma/Desktop/password.txt' |
| 103 | +``` |
0 commit comments