|
| 1 | +--- |
| 2 | +title: "Gestion des objets RustFS" |
| 3 | +description: "Création et suppression d’objets" |
| 4 | +--- |
| 5 | + |
| 6 | +# Objets RustFS |
| 7 | + |
| 8 | +Un objet est l’unité de base du stockage dans RustFS. Il contient des données, des métadonnées et un identifiant unique (Object Key). Cette section illustre la gestion des objets via l’exemple du téléversement et de la suppression de fichiers. |
| 9 | + |
| 10 | +> Pour les notions liées aux objets, voir la section [Concepts](../../concepts/glossary.md). |
| 11 | +
|
| 12 | +## Créer un objet |
| 13 | + |
| 14 | +Prérequis : |
| 15 | + |
| 16 | +- Une instance RustFS disponible (voir ../../installation/index.md). |
| 17 | + |
| 18 | +Créez d’abord un [bucket](bucket-create-and-delete.md), puis téléversez un fichier dans ce bucket pour créer un objet. Cela peut se faire via l’UI, `mc` ou l’API. |
| 19 | + |
| 20 | +### Téléverser depuis l’UI |
| 21 | + |
| 22 | +1. Connectez‑vous à la console UI de RustFS. |
| 23 | +1. Sélectionnez le bucket de destination. |
| 24 | +1. En haut à droite de la page du bucket, choisissez « Nouveau dossier », « Nouveau fichier » ou « Téléverser fichier/dossier ». |
| 25 | +1. Pour un téléversement local, cliquez sur « Téléverser fichier/dossier », choisissez les éléments, puis « Démarrer le téléversement ». |
| 26 | + |
| 27 | + |
| 28 | + |
| 29 | +Après le téléversement, cliquez sur l’objet pour afficher ses détails. |
| 30 | + |
| 31 | + |
| 32 | + |
| 33 | +### Téléverser avec `mc` |
| 34 | + |
| 35 | +> Voir le guide [`mc`](../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 | +### Téléverser via l’API |
| 48 | + |
| 49 | +``` |
| 50 | +PUT /{bucketName}/{objectName} HTTP/1.1 |
| 51 | +``` |
| 52 | + |
| 53 | +Exemple : |
| 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 | +## Supprimer un objet |
| 65 | + |
| 66 | +La suppression d’un objet peut se faire via l’UI, `mc` ou l’API. Par exemple, supprimez le fichier créé ci‑dessus. |
| 67 | + |
| 68 | +## Supprimer depuis l’UI |
| 69 | + |
| 70 | +1. Connectez‑vous à la console UI de RustFS. |
| 71 | +1. Sélectionnez le bucket contenant le fichier. |
| 72 | +1. Sélectionnez le fichier à supprimer. |
| 73 | +1. Cliquez sur « Supprimer la sélection », puis « Confirmer ». |
| 74 | + |
| 75 | + |
| 76 | + |
| 77 | +### Supprimer avec `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 | +### Supprimer via l’API |
| 89 | + |
| 90 | +``` |
| 91 | +DELETE /{bucketName}/{objectName} HTTP/1.1 |
| 92 | +``` |
| 93 | + |
| 94 | +Exemple : |
| 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