Object Storage - Premiers pas avec Object Storage

Base de connaissances

Object Storage - Premiers pas avec Object Storage


Icons/System/eye-open Created with Sketch. 824 vues 27.01.2026 Cloud / Object Storage S3

Objectif

Ce guide a pour objectif de vous familiariser avec la gestion de vos conteneurs/objets.

Découvrez comment créer et gérer un bucket Object Storage.

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.
  • pour la classe de stockage Cloud Archive - SWIFT API, suivez ce guide.

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

En pratique

Si vous souhaitez utiliser le provider Terraform OVHcloud, vous pouvez suivre ce guide.

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 consulter la documentation officielle d’AWS.

Vérifier l'installation

user@host:~$ aws --version

Si vous avez besoin de plus d'informations sur l'installation de l'AWS CLI, consultez la documentation AWS.

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 url_endpoint. 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.

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

Configuration

Vous pouvez utiliser la configuration interactive pour générer les fichiers de configuration ou les créer manuellement.

Pour utiliser la configuration interactive, exécutez la commande suivante :

aws configure

Ou cette commande :

aws configure --profile PROFILE_NAME

Le format du fichier de configuration dans le client AWS est le suivant :

user@host:~$ cat ~/.aws/credentials

[default]
aws_access_key_id = <access_key>
aws_secret_access_key = <secret_key>

user@host:~$ cat ~/.aws/config

[default]
region = <region_in_lowercase>
endpoint_url = <url_endpoint>
services = ovh-rbx-archive

[profile PROFILE_NAME]
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 :

VariableTypeValeurDéfinition
max_concurrent_requestsIntegerDéfaut : 10Le nombre maximum de requêtes simultanées.
max_queue_sizeIntegerDéfaut : 1000Le nombre maximal de tâches dans la file d'attente des tâches.
multipart_thresholdInteger
String
Défaut : 8MBLe seuil de taille que l'interface CLI utilise pour les transferts multipart de fichiers individuels.
multipart_chunksizeInteger
String
Défaut : 8MB
Minimum for uploads: 5MB
Lors de l'utilisation de transferts multipart, il s'agit de la taille de morceau que l'interface CLI utilise pour les transferts multipart de fichiers individuels.
max_bandwidthIntegerDéfaut : NoneLa bande passante maximale qui sera consommée pour le chargement et le téléchargement de données vers et depuis vos buckets.
verify_sslBooleanDéfaut : trueActive / 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.

Utilisation

Si vous avez défini plusieurs profils, ajoutez --profile <profile> à la ligne de commande.

Utiliser l'espace client OVHcloud

Pour gérer un bucket Object Storage, connectez-vous d'abord à votre espace client OVHcloud et ouvrez votre projet Public Cloud.

Lister vos buckets

Avec AWS s3
aws s3 ls
Avec AWS S3api
aws s3api list-buckets --query "Buckets[].Name" // retirez --query pour avoir plus d'info que le name.

Cliquez sur Object Storage dans la barre de navigation, puis sur l'onglet Mes conteneurs.

Créer un bucket

Avec AWS s3
aws s3 mb s3://<bucket_name>
aws --profile default s3 mb s3://<bucket_name>
Avec AWS S3api
aws s3api create-bucket --bucket <bucket_name>
aws s3api create-bucket --bucket <bucket_name> --profile default

Cliquez sur Créer un conteneur d'objets.

Créer votre bucket partie 1

Vous pouvez saisir le nom de votre bucket (optionnel), puis sélectionner votre offre.

Sélectionnez un mode de déploiement.

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.

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

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é.

Vous pouvez également activer l’Object Lock pour stocker vos objets en mode WORM (Write Once, Read Many) et garantir leur immutabilité pendant une période de rétention définie.

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).

Une fois la configuration de votre bucket terminée, cliquez sur Créer.

Télécharger vos fichiers en tant qu'objets dans votre bucket

Lors du téléchargement des objets dans un bucket Object Storage, les utilisateurs peuvent choisir la classe de stockage, ce qui leur permet de contrôler la disponibilité, la redondance et le coût associés. Pour vous aider à choisir la classe de stockage la plus adaptée à vos besoins, consultez la documentation ici.

Pour télécharger un objet :

Avec AWS s3
aws s3 cp /datas/<object_name> s3://<bucket_name>

Par défaut, les objets sont nommés d'après des fichiers, mais ils peuvent être renommés.

aws s3 cp /data/<object_name> s3://<bucket_name>/other-filename

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.

Avec AWS s3api
# télécharger un objet vers le niveau de stockage High Performance
aws s3api put-object --bucket <bucket_name> --key <object_name> --body /data/<object_name> --storage-class EXPRESS_ONEZONE

# télécharger explicitement un objet vers le niveau de stockage Standard
aws s3api put-object --bucket <bucket_name> --key <object_name> --body /data/<object_name> --storage-class STANDARD

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

Avec AWS s3

Téléchargement d'un objet à partir d'un bucket :

aws s3 cp s3://<bucket_name>/<object_name> .

Téléchargement d'un objet d'un bucket vers un autre bucket :

aws s3 cp s3://<bucket_name>/<object_name> s3://<bucket_name_2

Télécharger ou uploader un bucket entier sur l'hôte/bucket :

aws s3 cp s3://<bucket_name> . --recursive
aws s3 cp s3://<bucket_name> s3://<bucket_name_2> --recursive
Avec AWS s3api

Téléchargement d'un objet à partir d'un bucket :

aws s3api get-object --bucket <bucket_name> --key <object_name> <object_name>

Téléchargement d'un objet d'un bucket vers un autre bucket :

aws s3api copy-object --bucket <bucket_name_2> --copy-source <bucket_name>/<object_name> --key <object_name>

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

aws s3 sync . s3://<bucket_name> # Synchronisation du répertoire local avec le bucket S3
aws s3 sync s3://<bucket_name> . # Synchronisation du bucket S3 avec le répertoire local
aws s3 sync s3://<bucket_name> s3://<bucket_name_2> # Synchroniser un bucket S3 avec un autre

Suppression d'objets et de buckets

Un bucket ne peut être supprimé que s'il est vide.

Avec AWS s3

Suppression d'objets et de buckets

# Supprimer un objet
aws s3 rm s3://<bucket_name>/<object_name>
# Supprimer tous les objets dans un bucket
aws s3 rm s3://<bucket_name> --recursive
# Supprimer un bucket. Pour supprimer un bucket, celui-ci doit être vide.
aws s3 rb s3://<bucket_name>
# 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://<bucket_name> --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 :

aws s3api delete-object --bucket <NAME> --key <KEY> --version-id <VERSION_ID>

Pour répertorier tous les objets et tous les IDs de versions, vous pouvez utiliser la commande suivante :

aws s3api list-object-versions --bucket <NAME>

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 :

aws s3api delete-objects --bucket <NAME> --delete "$(aws s3api list-object-versions --bucket <NAME> --query='{Objects: Versions[].{Key:Key,VersionId:VersionId}}')"
Avec AWS s3api

Suppression d'objets et de buckets

# Supprimer un objet
aws s3api delete-object --bucket <bucket_name> --key <object_name>
# Supprimer tous les objets dans un bucket
aws s3api delete-objects --bucket <bucket_name> --delete "$(aws s3api list-objects-v2 --bucket <bucket_name> --query='{Objects: Contents[].{Key:Key}}')"
# Supprimer un bucket. Pour supprimer un bucket, celui-ci doit être vide.
aws s3api delete-bucket --bucket <bucket_name>

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 :

aws s3api delete-objects --bucket <bucket_name> --delete "$(aws s3api list-object-versions --bucket <bucket_name> --query='{Objects: Versions[].{Key:Key,VersionId:VersionId}}')"

Si le verrouillage d'objet est activé dans votre bucket, vous ne pourrez pas supprimer définitivement vos objets. Consultez notre documentation 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.

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.

Gérer les tags

Définir des tags sur un bucket

aws s3api put-bucket-tagging --bucket <bucket_name> --tagging 'TagSet=[{Key=myKey,Value=myKeyValue}]'
aws s3api get-bucket-tagging --bucket <bucket_name>
{
  "TagSet": [
    {
    "Value": "myKeyValue",
    "Key": "myKey"
    }
  ]
}

Suppression de tags sur un bucket

aws s3api s3api delete-bucket-tagging --bucket <bucket_name>

Définir des tags sur un objet

aws s3api put-object-tagging --bucket <bucket_name> --key <object_name> --tagging 'TagSet=[{Key=myKey,Value=myKeyValue}]'
aws s3api get-bucket-tagging --bucket <bucket_name>
{
  "TagSet": [
    {
    "Value": "myKeyValue",
    "Key": "myKey"
    }
  ]
}

Suppression de tags sur un objet

aws s3api s3api delete-object-tagging --bucket <bucket_name> --key <object_name>

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 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.

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.

Articles associés