For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/storage-and-backup/object-storage/s3-getting-started-with-object-storage.md.
Aller au contenu

Object Storage - Premiers pas

Voir en Markdown

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

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


Accès à la console OVHcloud

  • Lien direct :
  • Pour accéder à vos services : Public Cloud > Sélectionnez votre projet > Stockage > Object Storage

En pratique

Info

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

Vérifier l'installation

aws --version
Info

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. Dans la console OVHcloud, ouvrez l'onglet Utilisateurs de la page Object Storage : la clé d'accès est affichée dans la colonne Clé d'accès. Pour afficher la clé secrète, cliquez sur le bouton ... de la ligne de l'utilisateur, puis sur Afficher la clé secrète.
  • Vous aurez également besoin de votre endpoint_url. Si vous avez déjà créé votre bucket, cette information est affichée dans l'onglet Vue d'ensemble du bucket (voir ci-dessous). En cas de besoin, suivez ce guide.

Où trouver l'endpoint d'un bucket ?

Dans l'onglet Conteneurs, cliquez sur le nom de votre bucket, puis ouvrez l'onglet Vue d'ensemble. L'endpoint est affiché dans le champ Endpoint de la section Détails de connexion.

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

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

cat ~/.aws/credentials

[default]
aws_access_key_id = <access_key>
aws_secret_access_key = <secret_key>
cat ~/.aws/config

[default]
region = <region_in_lowercase>
endpoint_url = <endpoint_url>
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 en octets 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

Info

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

Utiliser la console OVHcloud

Pour gérer un bucket Object Storage, cliquez sur Object Storage sous Stockage dans le menu de gauche de votre projet Public Cloud.

Lister vos buckets

Console OVHcloud
AWS CLI
CLI OVHcloud

Cliquez sur Object Storage sous Stockage dans le menu de gauche de votre projet Public Cloud. Vos buckets sont listés dans l'onglet Conteneurs.

Créer un bucket

Console OVHcloud
AWS CLI
CLI OVHcloud

Dans l'onglet Conteneurs, cliquez sur Créer un conteneur d'objets.

Dans la section Type de conteneur, sélectionnez API compatible S3, puis saisissez le nom de votre bucket dans la section Nom du conteneur (3 à 63 caractères en minuscules, . et - autorisés).

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.

Si vous avez choisi une région 3-AZ, la section Offsite Replication vous permet de répliquer automatiquement vos données sur un site distant. Son activation active également le versioning.

Dans une région Local Zone, le bucket est créé avec son nom uniquement. Dans les autres régions, vous pouvez ensuite configurer les sections suivantes.

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

Object Lock : 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. Le versioning doit d'abord être activé. Cochez ensuite Je comprends que l'Object Lock ne pourra pas être désactivé ultérieurement.

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.

Utilisateur : vous pouvez associer un utilisateur Object Storage au bucket. Sélectionnez un utilisateur existant dans la liste (cliquez sur Voir les credentials pour vérifier ses identifiants) ou cliquez sur Créer un utilisateur pour en créer un. La clé secrète d'un nouvel utilisateur n'est affichée qu'une seule fois : enregistrez-la.

Chiffrement : vous pouvez décider si vous souhaitez chiffrer vos données en utilisant SSE-OMK (chiffrement côté serveur avec OVHcloud Managed Keys). Sélectionnez Chiffrement côté serveur (SSE-OMK) ou Pas de chiffrement.

Vérifiez le récapitulatif de votre bucket, puis cliquez sur Créer.

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.

Console OVHcloud
AWS CLI

Dans l'onglet Conteneurs, cliquez sur le nom de votre bucket : son onglet Objets s'ouvre. Cliquez sur Ajouter un objet.

Dans le panneau qui s'ouvre, vous pouvez saisir un Préfixe à ajouter au nom de vos objets (le nom de l'objet est le même que le nom du fichier) et sélectionner une Classe de stockage. Glissez-déposez vos fichiers ou cliquez sur Parcourir les fichiers, puis cliquez sur Téléverser.

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

Console OVHcloud
AWS CLI

Dans l'onglet Objets de votre bucket, cliquez sur l'icône Télécharger de la ligne de l'objet.

Synchronisation des buckets

AWS CLI
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

Info

Avec l'AWS CLI, un bucket ne peut être supprimé que s'il est vide. Dans la console OVHcloud, un bucket contenant jusqu'à 2 000 objets est vidé puis supprimé (sauf dans une Local Zone). Au-delà, videz-le d'abord à l'aide d'une règle de cycle de vie.

Console OVHcloud
AWS CLI
CLI OVHcloud

Suppression d'un bucket

Dans l'onglet Conteneurs, cliquez sur le bouton ... de la ligne du bucket, puis sur Supprimer.

Saisissez TERMINATE pour confirmer (EMPTY AND TERMINATE si le bucket contient encore des objets), puis cliquez sur Supprimer.

Suppression d'objets

Accédez au bucket et ouvrez l'onglet Objets.

Cliquez sur l'icône Supprimer de la ligne de l'objet, puis sur Supprimer pour confirmer. Si le versioning n'est pas activé sur le bucket, la suppression est définitive.

Gérer les tags

AWS CLI
CLI OVHcloud

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 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 delete-object-tagging --bucket <bucket_name> --key <object_name>

Aller plus loin

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Échangez avec notre communauté d’utilisateurs.

1 : S3 est une marque déposée appartenant à Amazon Technologies, Inc. Les services OVHcloud ne sont pas sponsorisés, approuvés, ou affiliés de quelque manière que ce soit.

Cette page vous a-t-elle aidé ?