--- title: "Object Storage Swift - Premiers pas avec l'API Swift S3" description: "Découvrez comment utiliser l'API Swift S3" url: https://docs.ovhcloud.com/fr/guides/storage-and-backup/object-storage/pcs-getting-started-with-the-swift-s3-api lang: fr lastUpdated: 2025-02-11 --- # Object Storage Swift - Premiers pas avec l'API Swift S3 ## Objectif Le middleware Swift s3api qui assure la compatibilité de l'API S3 a été activé sur toutes les régions du Public Cloud. **Ce guide vous aidera à accéder aux objets de Swift à l'aide d'un logiciel conçu pour interagir avec des points de terminaison compatibles S3.** ## Prérequis - [Préparer l’environnement pour utiliser l’API OpenStack](/fr/guides/public-cloud/cross-functional/compute-prepare-openstack-api-environment.md) - [Obtenir le fichier Openstack RC v3 d'Horizon](/fr/guides/public-cloud/cross-functional/compute-horizon-access-security.md) ## En pratique ### Définir les variables d'environnement OpenStack ```bash user@host:~$ source -openrc.sh Please enter your OpenStack Password for project as user : user@host:~$ ``` ### Installer le client OpenStack si nécessaire ```bash user@host:~$ pip install python-openstackclient user@host:~$ ``` Retrouvez la référence des commandes Openstack client [ici](https://docs.openstack.org/python-openstackclient/latest/). ### Créer des informations d'identification EC2 Les jetons S3 sont différents, vous avez besoin de 2 paramètres (**access** et **secret**) pour générer un jeton S3. Ces informations d'identification seront stockées en toute sécurité dans Keystone. Pour la générer : #### Générer le jeton S3 avec le client python-openstack ```bash user@host:~$ openstack ec2 credentials create +------------+----------------------------------------------------------------------------------------------------------------------------+ | Field | Value | +------------+----------------------------------------------------------------------------------------------------------------------------+ | access | 5a4d8b8d88104123a862c527ede5a3d3 | | links | {u'self': u'https://auth.cloud.ovh.net/v3/users/d74d05ff121b44bea9216495e7f0df61/credentials/OS- | | | EC2/5a4d8b8d88104123a862c527ede5a3d3'} | | project_id | 20e124b71be141299e111ec26b1892fa | | secret | 925d5fcfcd9f436d8ffcb20548cc53a2 | | trust_id | None | | user_id | d74d05ff121b44bea9216495e7f0df61 | +------------+----------------------------------------------------------------------------------------------------------------------------+ ``` #### Générer le jeton S3 avec curl ```bash . openrc.sh TMP_FILE=$(mktemp) OS_USER_ID=$(curl -s -D $TMP_FILE -X POST "${OS_AUTH_URL}auth/tokens" -H "Content-Type: application/json" -d '{"auth":{"identity":{"methods":["password"],"password":{"user":{"name":"'$OS_USERNAME'","domain":{"id":"default"},"password":"'$OS_PASSWORD'"}}},"scope":{"project":{ "id":"'$OS_TENANT_ID'","domain":{"id":"default"}}}}}' | jq -r '.["token"]["user"]["id"]') OS_TOKEN=$(awk 'BEGIN{IGNORECASE=1} /^X-Subject-Token/ {print $2}' $TMP_FILE | tr -d "\r") curl -s -X POST -H "Content-Type: application/json" -H "X-Auth-Token: $OS_TOKEN" -d '{"tenant_id": "'$OS_TENANT_ID'"}' "${OS_AUTH_URL}users/${OS_USER_ID}`/credentials/OS-EC2`" | jq . { "credential": { "user_id": "d74d05ff121b44bea9216495e7f0df61", "links": { "self": "https://auth.cloud.ovh.net/v3/users/d74d05ff121b44bea9216495e7f0df61/credentials/OS-EC2/660c89cfc4764271ba169941c7b2f310" }, "tenant_id": "20e124b71be141299e111ec26b1892fa", "access": "660c89cfc4764271ba169941c7b2f310", "secret": "fc9e8eb545724accadcfabbd99207df1", "trust_id": null } } ``` ### Configurer le client AWS Vous pouvez soit utiliser la méthode CLI, soit créer manuellement les fichiers de configuration AWS. Installez le client AWS et configurez-le comme suit : **Paquet Python** ```bash user@host:~$ pip install awscli ``` **OS basé sur Debian** ```bash user@host:~$ sudo apt install awscli ``` **OS basé sur RHEL** ```bash user@host:~$ sudo yum install awscli ``` **Méthode CLI** ```bash user@host:~$ aws configure ``` Suivez alors les étapes et saisissez vos informations d'identification AWS générées par les commandes ci-dessus. **Méthode manuelle** ```bash user@host:~$ cat ~/.aws/credentials [default] aws_access_key_id = aws_secret_access_key = user@host:~$ cat ~/.aws/config [plugins] endpoint = awscli_plugin_endpoint [default] region = s3 = endpoint_url = https://s3..cloud.ovh.net signature_version = s3v4 s3api = endpoint_url = https://s3..cloud.ovh.net ``` L'accès de type `hébergé virtuel` et l'accès de type `chemin d'accès` sont pris en charge dans toutes les régions, mais nous vous recommandons d'utiliser le style `hébergé virtuel` car l'accès de type `chemin d'accès` sera déprécié après le 30 septembre 2020. ### Utiliser le client AWS Utilisez la commande suivante pour obtenir la liste des Buckets (conteneurs) : :::info Si vous avez créé plusieurs profils, ajoutez `--profile ` à la ligne de commande. ::: ```bash user@host:~$ aws s3 ls ``` Utilisez la commande suivante pour créer un nouveau bucket : ```bash user@host:~$ aws s3 mb s3://bucket ``` :::info Les buckets S3 ne peuvent être créés que sur la stratégie PCS (Stockage d'objets). ::: :::info Le nom du conteneur doit respecter les règles suivantes - Le nom du conteneur peut comporter entre 3 et 63 caractères, et ne peut contenir que des caractères minuscules, des chiffres, des points et des tirets. - Chaque nom du conteneur doit commencer par une lettre minuscule ou un chiffre. - Le nom du conteneur ne peut pas contenir de traits de soulignement, se terminer par un tiret, avoir des points consécutifs ou utiliser des tirets adjacents à des points. - Le nom du conteneur ne peut pas être formaté comme une adresse IP (198.51.100.24). ::: Utilisez la commande suivante pour téléverser un fichier local sur Swift : ```bash user@host:~$ aws s3 cp file.txt s3://bucket/file.txt ``` Utilisez la commande suivante pour télécharger un objet à partir de Swift : ```bash user@host:~$ aws s3 cp s3://bucket/file.txt file.txt ``` Utilisez la commande suivante pour supprimer un objet Swift : ```bash user@host:~$ aws s3 rm s3://bucket/file.txt ``` Utilisez la commande suivante pour supprimer un bucket: ```bash user@host:~$ aws s3 rb s3://bucket ``` ## Aller plus loin Échangez avec notre [communauté d’utilisateurs](https://community.ovhcloud.com/).