--- title: "Object Storage - Premiers pas" description: "Ce guide a pour objectif de vous familiariser avec la gestion de vos buckets/objets." url: https://docs.ovhcloud.com/fr/guides/storage-and-backup/object-storage/s3-getting-started-with-object-storage lang: fr lastUpdated: 2026-06-01 --- # Object Storage - Premiers pas ## Objectif Ce guide vous aide à gérer vos buckets et objets. **Découvrez comment créer et gérer un bucket Object Storage.** :::info Si vous utilisez l'ancien système de stockage d'objets Swift : - pour la classe de stockage **Standard object storage - SWIFT API**, suivez [ce guide](/fr/guides/storage-and-backup/object-storage/pcs-create-container.md). - pour la classe de stockage **Cloud Archive - SWIFT API**, suivez [ce guide](/fr/guides/storage-and-backup/object-storage/pca-create-container.md). Pour les nouveaux projets, nous vous recommandons vivement d'utiliser notre stockage d'objets compatible S31 , qui bénéficie de nos dernières innovations et de nos nouvelles fonctionnalités. ::: ## Prérequis - Un [projet Public Cloud](/fr/guides/public-cloud/cross-functional/create-a-public-cloud-project.md) dans votre compte OVHcloud - Avoir créé un [utilisateur Object Storage](/fr/guides/storage-and-backup/object-storage/s3-identity-and-access-management.md) *** ### Accès à l'espace client OVHcloud - **Lien direct :** Projets Public Cloud - **Pour accéder à vos services :** Public Cloud > Sélectionnez votre projet *** ## En pratique :::info Si vous souhaitez utiliser le provider Terraform OVHcloud, vous pouvez suivre [ce guide](/fr/guides/storage-and-backup/object-storage/s3-terraform.md). ::: ### Préparation Pour utiliser l'AWS CLI Pour connaître la procédure d’installation de l’AWS CLI adaptée à votre environnement, nous vous recommandons de lire [la documentation officielle d’AWS](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html#getting-started-install-instructions). **Vérifier l'installation** ```bash aws --version ``` :::info Si vous avez besoin de plus d'informations sur l'installation de l'AWS CLI, consultez [la documentation AWS](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). ::: #### Collecter les informations d'identification - Vous aurez besoin de l'_Access key_ et de la _Secret key_ de votre utilisateur. Ces informations sont accessibles depuis l'onglet Utilisateurs Object Storage dans votre espace client OVHcloud. - Vous aurez également besoin de votre _endpoint\_url_. Si vous avez déjà créé votre bucket, cette information est accessible depuis l'onglet Mes conteneurs puis dans les détails du votre bucket. En cas de besoin, suivez ce [guide](/fr/guides/storage-and-backup/object-storage/s3-location.md). #### Où trouver l'endpoint d'un bucket ? Cliquez sur le nom de votre bucket et retrouvez ses détails dans l'onglet Informations générales : ![détails du bucket](/images/storage-and-backup/object-storage/s3-getting-started-with-object-storage/object_storage_information_panel.png)#### Configuration Vous pouvez utiliser la configuration interactive pour générer les fichiers de configuration ou les créer manuellement. :::info Pour utiliser la configuration interactive, exécutez la commande suivante : `aws configure` Ou cette commande : `aws configure --profile ` ::: Le format du fichier de configuration dans le client AWS est le suivant : ```bash cat ~/.aws/credentials ``` ```text [default] aws_access_key_id = aws_secret_access_key = ``` ```bash cat ~/.aws/config ``` ```text [default] region = endpoint_url = services = ovh-rbx-archive [profile ] region = rbx output = json services = ovh-rbx [services ovh-rbx-archive] s3 = endpoint_url = https://s3.rbx-archive.io.cloud.ovh.net/ signature_version = s3v4 s3api = endpoint_url = https://s3.rbx-archive.io.cloud.ovh.net/ [services ovh-rbx] s3 = endpoint_url = https://s3.rbx.io.cloud.ovh.net/ signature_version = s3v4 s3api = endpoint_url = https://s3.rbx.io.cloud.ovh.net/ ``` Voici les valeurs de configuration que vous pouvez définir spécifiquement : | Variable | Type | Valeur | Définition | | :------------------------ | :------------------ | :------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | max\_concurrent\_requests | Integer | **Défaut :** 10 | Le nombre maximum de requêtes simultanées. | | max\_queue\_size | Integer | **Défaut :** 1000 | Le nombre maximal de tâches dans la file d'attente des tâches. | | multipart\_threshold | Integer
String | **Défaut :** 8MB | Le seuil de taille que l'interface CLI utilise pour les transferts multipart de fichiers individuels. | | multipart\_chunksize | Integer
String | **Défaut :** 8MB
**Minimum for uploads:** 5MB | Lors de l'utilisation de transferts multipart, il s'agit de la taille en octets que l'interface CLI utilise pour les transferts multipart de fichiers individuels. | | max\_bandwidth | Integer | **Défaut :** None | La bande passante maximale qui sera consommée pour le chargement et le téléchargement de données vers et depuis vos buckets. | | verify\_ssl | Boolean | **Défaut :** true | Active / Désactive la vérification des certificats SSL | Pour connaître la liste des endpoints par région et par classe de stockage, vous pouvez vous référer à [cette page](/fr/guides/storage-and-backup/object-storage/s3-location.md). #### Utilisation :::info Si vous avez défini plusieurs profils, ajoutez `--profile ` à la ligne de commande. ::: Utiliser l'espace client OVHcloud Pour gérer un bucket Object Storage, rendez-vous dans Object Storage dans le menu de gauche. #### Lister vos buckets **Via AWS CLI** Avec AWS s3 ```bash aws s3 ls ``` Avec AWS S3api ```bash aws s3api list-buckets --query "Buckets[].Name" # Retirez --query pour afficher la sortie complète. ``` **Via l'espace client OVHcloud** Cliquez sur Object Storage dans la barre de navigation, puis sur l'onglet Mes conteneurs. **Via la CLI OVHcloud** Saisissez la commande suivante : ```shell ovhcloud cloud storage-s3 list ``` #### Créer un bucket **Via AWS CLI** Avec AWS s3 ```bash aws s3 mb s3:// aws --profile s3 mb s3:// ``` Avec AWS S3api ```bash aws s3api create-bucket --bucket aws --profile s3api create-bucket --bucket ``` **Via l'espace client OVHcloud** Cliquez sur Créer un conteneur d'objets. ![Créer votre bucket partie 1](/images/storage-and-backup/object-storage/s3-getting-started-with-object-storage/object-storage-bucket-creation-1.png)Vous pouvez saisir le nom de votre bucket (optionnel), puis **sélectionner votre offre**. **Sélectionnez un mode de déploiement.** :::info OVHcloud propose plusieurs modes de déploiement pour répondre à différents besoins en termes de résilience, de disponibilité et de performance. Chaque mode est optimisé pour des cas d'utilisation spécifiques et offre différents niveaux de redondance et de tolérance aux pannes. ::: **Sélectionnez une région.** :::info Les régions peuvent varier en fonction du mode de déploiement choisi. ::: Vous pouvez ensuite définir les paramètres de configuration de votre bucket. ![Créer votre bucket partie 2](/images/storage-and-backup/object-storage/s3-getting-started-with-object-storage/object-storage-bucket-creation-2.png):::info Si vous avez choisi le mode de déploiement 3AZ, une option supplémentaire apparaît pour **configurer la réplication offsite.** ::: À ce stade, vous pouvez décider d'activer ou non la **gestion des versions**. La gestion des versions vous permet de conserver plusieurs variantes d'un objet dans le même bucket. Cette fonctionnalité permet de **préserver, récupérer et restaurer chaque version de chaque objet stocké dans vos buckets**, ce qui facilite la récupération en cas d'actions involontaires de l'utilisateur ou de défaillances de l'application. Par défaut, la gestion des versions est désactivée sur les buckets, et vous devez l'activer explicitement. Vous trouverez plus d'informations sur la gestion des versions dans notre [guide dédié](/fr/guides/storage-and-backup/object-storage/s3-versioning.md). Vous pouvez également activer l’[Object Lock](/fr/guides/storage-and-backup/object-storage/s3-managing-object-lock.md) pour stocker vos objets en mode WORM (Write Once, Read Many) et garantir leur immutabilité pendant une période de rétention définie. :::info **Note :** cette option doit impérativement être activée à la création d'un bucket, elle ne peut pas être activée ultérieurement. ::: Vous devez associer un utilisateur au bucket. Pour cela, vous pouvez : - Associer un utilisateur Object Storage existant. Pour vérifier ses identifiants, cliquez sur Voir les credentials. - Ou créer un nouvel utilisateur Object Storage. Vous pouvez alors décider si vous souhaitez **chiffrer vos données** en utilisant [SSE-OMK (chiffrement côté serveur avec OVHcloud Managed Keys)](/fr/guides/storage-and-backup/object-storage/s3-encrypt-your-objects-with-sse-c.md). Une fois la configuration de votre bucket terminée, cliquez sur Créer. **Via la CLI OVHcloud** Saisissez la commande suivante en remplaçant `` par le code de votre région (ex. `GRA`, `BHS`) et `` par le nom souhaité : ```shell ovhcloud cloud storage-s3 create --name ``` Pour créer un bucket avec le versioning et le chiffrement activés : ```shell ovhcloud cloud storage-s3 create --name --versioning-status enabled --encryption-sse-algorithm AES256 ``` Pour créer un bucket avec l'Object Lock activé : ```shell ovhcloud cloud storage-s3 create --name --object-lock-status enabled --object-lock-rule-mode compliance --object-lock-rule-period P30D ``` :::info L'option `--object-lock-status enabled` doit impérativement être définie à la création du bucket, elle ne peut pas être activée ultérieurement. ::: #### Télécharger vos fichiers en tant qu'objets dans votre bucket Lors du téléversement d'objets, vous pouvez sélectionner une classe de stockage pour contrôler la disponibilité, la redondance et le coût. Pour vous aider à choisir la classe de stockage la plus adaptée à vos besoins, consultez la documentation [ici](/fr/guides/storage-and-backup/object-storage/s3-choosing-the-right-storage-class-for-your-needs.md). **Via AWS CLI** **Pour télécharger un objet :** Avec AWS s3 ```bash aws s3 cp /data/ s3:// ``` **Par défaut, les objets sont nommés d'après des fichiers, mais ils peuvent être renommés.** ```bash aws s3 cp /data/ s3:///other-filename ``` :::info La commande `aws s3 cp` utilisera STANDARD comme classe de stockage par défaut pour télécharger des objets. Pour stocker des objets dans le niveau de stockage High Performance, utilisez plutôt la commande `aws s3api put-object`, car `aws s3 cp` ne supporte pas la classe de stockage EXPRESS\_ONEZONE qui est utilisée pour mapper le niveau de stockage High Performance. Pour en savoir plus sur le mappage des classes de stockage entre les niveaux de stockage OVHcloud et les classes de stockage AWS, vous pouvez consulter [notre documentation](/fr/guides/storage-and-backup/object-storage/s3-location.md). ::: Avec AWS s3api ```bash # télécharger un objet vers le niveau de stockage High Performance aws s3api put-object --bucket --key --body /data/ --storage-class EXPRESS_ONEZONE # télécharger explicitement un objet vers le niveau de stockage Standard aws s3api put-object --bucket --key --body /data/ --storage-class STANDARD ``` **Via l'espace client OVHcloud** Cliquez sur le nom de votre conteneur, puis cliquez sur le bouton Ajouter des objets dans l'onglet **Objets**. Une fenêtre apparaît, vous pouvez ajouter un préfixe au nom de votre objet (le nom de l'objet est le même que le nom du fichier). Sélectionnez le fichier que vous souhaitez téléverser et cliquez sur le bouton Importer. #### Téléchargement d'un objet à partir d'un bucket **Via AWS CLI** Avec AWS s3 **Téléchargement d'un objet à partir d'un bucket :** ```bash aws s3 cp s3:/// . ``` **Téléchargement d'un objet d'un bucket vers un autre bucket :** ```bash aws s3 cp s3:/// s3:/// ``` **Télécharger ou uploader un bucket entier sur l'hôte/bucket :** ```bash aws s3 cp s3:// . --recursive aws s3 cp s3:// s3:// --recursive ``` Avec AWS s3api **Téléchargement d'un objet à partir d'un bucket :** ```bash aws s3api get-object --bucket --key ``` **Téléchargement d'un objet d'un bucket vers un autre bucket :** ```bash aws s3api copy-object --bucket --copy-source / --key ``` **Via l'espace client OVHcloud** Cliquez sur l’icône de téléchargement (flèche vers le bas dans un socle bleu) sur la ligne de l’objet. #### Synchronisation des buckets **Via AWS CLI** ```bash aws s3 sync . s3:// # Synchronisation du répertoire local avec le bucket S3 aws s3 sync s3:// . # Synchronisation du bucket S3 avec le répertoire local aws s3 sync s3:// s3:// # Synchroniser un bucket S3 avec un autre ``` #### Suppression d'objets et de buckets :::info Un bucket ne peut être supprimé que s'il est vide. ::: **Via AWS CLI** Avec AWS s3 **Suppression d'objets et de buckets** ```bash # Supprimer un objet aws s3 rm s3:/// # Supprimer tous les objets dans un bucket aws s3 rm s3:// --recursive # Supprimer un bucket. Pour supprimer un bucket, celui-ci doit être vide. aws s3 rb s3:// # Si le bucket n'est pas supprimé, vous pouvez utiliser la même commande avec l'option --force. # Cette commande supprime tous les objets du bucket, puis supprime le bucket. aws s3 rb s3:// --force ``` **Suppression d'objets et de buckets avec la gestion des versions activée** Si la gestion des versions est activée, une simple opération de suppression sur vos objets ne les supprimera pas définitivement. Pour supprimer définitivement un objet, vous devez spécifier un identifiant de version : ```bash aws s3api delete-object --bucket --key --version-id ``` Pour répertorier tous les objets et tous les IDs de versions, vous pouvez utiliser la commande suivante : ```bash aws s3api list-object-versions --bucket ``` Avec la commande `delete-object` précédente, vous devrez itérer sur toutes vos versions d'objets. Alternativement, vous pouvez utiliser la commande suivante pour vider votre bucket : ```bash aws s3api delete-objects --bucket --delete "$(aws s3api list-object-versions --bucket --query='{Objects: Versions[].{Key:Key,VersionId:VersionId}}')" ``` Avec AWS s3api **Suppression d'objets et de buckets** ```bash # Supprimer un objet aws s3api delete-object --bucket --key # Supprimer tous les objets dans un bucket aws s3api delete-objects --bucket --delete "$(aws s3api list-objects-v2 --bucket --query='{Objects: Contents[].{Key:Key}}')" # Supprimer un bucket. Pour supprimer un bucket, celui-ci doit être vide. aws s3api delete-bucket --bucket ``` **Suppression d'objets et de buckets avec la gestion des versions activée** Si la gestion des versions est activée, une simple opération de suppression sur vos objets ne les supprimera pas définitivement. Pour supprimer définitivement un objet, vous devez spécifier un identifiant de version : ```bash aws s3api delete-objects --bucket --delete "$(aws s3api list-object-versions --bucket --query='{Objects: Versions[].{Key:Key,VersionId:VersionId}}')" ``` :::info Si le verrouillage d'objet est activé dans votre bucket, vous ne pourrez pas supprimer définitivement vos objets. Consultez notre [documentation](/fr/guides/storage-and-backup/object-storage/s3-managing-object-lock.md) pour en savoir plus sur le verrouillage d'objet. Si vous utilisez le verrouillage d'objet en mode GOUVERNANCE et que vous avez la permission de contourner le mode GOUVERNANCE, vous devrez ajouter l'option `--bypass-governance-retention` à vos commandes de suppression. ::: **Via l'espace client OVHcloud** **Suppression d'un bucket** Dans la liste des conteneurs Object Storage, cliquez sur le bouton ... sur la ligne des conteneurs, puis sur Supprimer. Saisissez `TERMINATE` pour confirmer votre choix et cliquez sur Confirmer. **Suppression d'objets** Accédez au bucket et ouvrez l'onglet Objets. Cliquez sur l’icône de suppression (poubelle) sur la ligne de l’objet, saisissez `PERMANENTLY DELETE` pour confirmer la suppression définitive, puis cliquez sur Supprimer. **Via la CLI OVHcloud** **Suppression d'objets** ```shell # Supprimer un objet ovhcloud cloud storage-s3 object delete # Supprimer tous les objets d'un bucket ovhcloud cloud storage-s3 bulk-delete --all # Supprimer les objets correspondant à un préfixe ovhcloud cloud storage-s3 bulk-delete --prefix # Supprimer des objets spécifiques ovhcloud cloud storage-s3 bulk-delete --objects "file1.txt,file2.txt" ``` **Suppression d'un bucket** Le bucket doit être vide avant d'être supprimé. ```shell ovhcloud cloud storage-s3 delete ``` **Suppression d'objets avec la gestion des versions activée** Si la gestion des versions est activée, spécifiez l'identifiant de version pour supprimer définitivement un objet : ```shell ovhcloud cloud storage-s3 object version delete ``` Pour supprimer toutes les versions d'un objet, combinez la liste des versions et la suppression : ```shell ovhcloud cloud storage-s3 bulk-delete --objects "myfile.txt:,myfile.txt:" ``` #### Gérer les tags **Via AWS CLI** **Définir des tags sur un bucket** ```bash aws s3api put-bucket-tagging --bucket --tagging 'TagSet=[{Key=myKey,Value=myKeyValue}]' aws s3api get-bucket-tagging --bucket ``` ```json { "TagSet": [ { "Value": "myKeyValue", "Key": "myKey" } ] } ``` **Suppression de tags sur un bucket** ```bash aws s3api delete-bucket-tagging --bucket ``` **Définir des tags sur un objet** ```bash aws s3api put-object-tagging --bucket --key --tagging 'TagSet=[{Key=myKey,Value=myKeyValue}]' aws s3api get-bucket-tagging --bucket ``` ```json { "TagSet": [ { "Value": "myKeyValue", "Key": "myKey" } ] } ``` **Suppression de tags sur un objet** ```bash aws s3api delete-object-tagging --bucket --key ``` **Via la CLI OVHcloud** La CLI OVHcloud permet de définir des tags sur un bucket lors de sa **création** ou de sa **modification** via l'option `--tag key=value` (répétable pour plusieurs tags). La gestion individuelle des tags (lecture, suppression) n'est pas disponible via la CLI. **Définir des tags lors de la création d'un bucket** ```shell ovhcloud cloud storage-s3 create --name --tag myKey=myKeyValue --tag otherKey=otherValue ``` **Modifier les tags d'un bucket existant** ```shell ovhcloud cloud storage-s3 edit --tag myKey=myKeyValue ``` ## Aller plus loin Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur [ce lien](https://www.ovhcloud.com/fr/professional-services/) pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services. Échangez avec notre [communauté d’utilisateurs](https://community.ovhcloud.com/). 1 : S3 est une marque déposée appartenant à Amazon Technologies, Inc. Les services de OVHcloud ne sont pas sponsorisés, approuvés, ou affiliés de quelque manière que ce soit.