S3 Object Storage HOSTKEY¶

Dans cet article

• Description du service
• Fonctionnalités clés
• Paramètres techniques
• Prix
• Création de stockage S3
• Obtention des identifiants
• Utilisation via un navigateur S3
• Opérations de base sur les fichiers
• Travailler avec HOSTKEY S3 via AWS CLI

Description du service¶

Fonctionnalités clés¶

• Création de stockages indépendants - pendant la période bêta gratuite du forfait Free Beta 1, l'utilisateur peut créer jusqu'à 3 espaces de stockage S3 indépendants ;
• Indépendance des VPS/VDS - les stockages S3 fonctionnent de manière autonome et ne nécessitent pas la location d'un serveur HOSTKEY ;
• Création de buckets - lors de la création du stockage, le premier bucket avec un nom unique est créé automatiquement. Pendant la période bêta, l'utilisateur peut créer jusqu'à 10 buckets dans chaque stockage S3 ;
• Accès compatible S3 - support complet du protocole standard Amazon S3 pour toutes les opérations sur les données ;
• Travail avec tous les clients S3 - utilisation de S3 Browser, Cyberduck, boto3 et d'autres outils compatibles S3 ;
• Accès sécurisé - autorisation via un Identifiant d'accès (Access Key) et une Clé secrète (Secret Key) sur le protocole HTTPS ;
• Gestion simple des identifiants - génération et visualisation des clés d'accès via l'interface web de votre compte ;
• Forfaits prêts à l'emploi - choix de forfaits avec un volume de stockage et une bande passante fixes.

Paramètres techniques¶

• Endpoint URL : https://s3-nl.hostkey.com ;
• Protocol : HTTPS (SSL/TLS) ;
• Authorization : AWS Signature Version 4.

Prix¶

Pendant la période d'accès Beta, le stockage d'objets S3 HOSTKEY est fourni gratuitement selon le plan "Free Beta" avec les limitations suivantes :

• 250 Go de stockage ;
• 1 To de trafic sortant ;
• 1 500 requêtes de commande par mois ;
• Jusqu'à 3 stockages S3 indépendants par utilisateur ;
• Jusqu'à 10 buckets dans chaque stockage S3.

Pendant cette période, il n'est pas possible d'augmenter le volume de stockage, la bande passante et les limites des requêtes de commande.

Vous serez informé à l'avance avant la fin de la période Beta et les frais mensuels réguliers seront appliqués.

Création de stockage S3¶

1. Connectez-vous à votre compte sur Invapi

2. Accédez à la section S3 Object Storage ;

3. Créez un nouveau stockage :

   

   1. Region : sélectionnez la région (par défaut NL - Pays-Bas) ;
   2. Bucket name : entrez le nom du bucket (par exemple, bde347688-testbucket) :
      • le nom doit être unique ;
      • maximum 63 caractères ;
      • uniquement des lettres minuscules, chiffres et tirets ;
      • doit commencer et finir par une lettre ou un chiffre.
   3. Plan : sélectionnez un plan tarifaire (par exemple, Free Beta). Pour sélectionner, cliquez sur le nom du plan ;
   4. Cliquez sur Create S3 Storage.

   Après création, le stockage apparaîtra dans la liste Your separate S3 Storages.

Obtention des identifiants¶

1. Dans votre liste de stockage, trouvez le stockage créé et accédez à l'onglet Credentials :

   

2. Copiez les identifiants :

   Vous aurez besoin de :

   1. Hostname (Endpoint URL) : https://s3-nl.hostkey.com ;
   2. S3 user id : (par exemple, z5CrlJ67QuiF5xWp149TcmmhBjORRRu6) ;
   3. Access key : cliquez sur pour afficher la clé ;
   4. Secret key : cliquez sur pour afficher la clé.

   Important

   Vous devez d'abord cliquer sur l'icône pour afficher les vraies valeurs de clé ; seulement après cela peuvent-elles être correctement copiées.

   Save this data - vous en aurez besoin pour établir la connexion.

Utilisation via un navigateur S3¶

1. Téléchargez la version gratuite de S3 Browser : https://s3browser.com ;

2. Ajoutez un nouveau compte :

   

   1. Ouvrez S3 Browser ;
   2. Cliquez sur Accounts >> Add New Account.

3. Remplissez le formulaire :

   • Display name : HOSTKEY S3 (un nom pratique quelconque) ;
   • Account type : S3 Compatible Storage (pas Amazon S3 Storage !) ;
   • API endpoint : s3-nl.hostkey.com (sans https://) ;
   • Access Key ID : collez votre Access Key depuis le panneau HOSTKEY ;
   • Secret Access Key : collez votre Secret Key depuis le panneau HOSTKEY ;
   • Use secure transfer (SSL/TLS) : laissez la case cochée.

4. Cliquez sur Add new account ;

5. Travail avec les fichiers :

   

   Après une connexion réussie, vous verrez :

   • Bucket list sur la gauche ;
   • Files in bucket sur la droite ;
   • Boutons de gestion : Upload, Download, Delete, New Folder, Refresh.

   Available operations:

   • Upload - télécharger des fichiers ;
   • Download - télécharger des fichiers ;
   • Delete - supprimer des fichiers ;
   • New Folder - créer des dossiers ;
   • Refresh - rafraîchir la liste.

Opérations de base sur les fichiers¶

Après vous être connecté à un stockage S3 via un client compatible S3, les opérations suivantes sont disponibles :

Téléversement de fichiers¶

1. Par le navigateur S3 :

   • Sélectionnez un bucket dans le panneau de gauche ;
   • Cliquez sur le bouton Upload ou Upload folder(s) ;
   • Sélectionnez des fichiers depuis votre ordinateur ;
   • Confirmez le téléversement :

   

2. Par glisser-déposer :

   • Glissez simplement les fichiers depuis l'explorateur vers la fenêtre du navigateur S3.

Téléchargement de fichiers¶

1. Sélectionnez un fichier dans le bucket ;

2. Cliquez sur le bouton Download ou faites un clic droit et sélectionnez Download :

   

3. Spécifiez le dossier où enregistrer le fichier sur votre ordinateur.

Suppression de fichiers et dossiers¶

1. Sélectionnez un fichier ou un dossier ;

2. Cliquez sur le bouton Delete ou appuyez sur la touche Delete du clavier :

   

3. Confirmez la suppression.

Création de la structure de dossiers¶

1. Sélectionnez un bucket ou un dossier ;

2. Cliquez sur New Folder :

   

3. Entrez le nom du dossier :

   

4. Cliquez sur Create new folder.

Copier et déplacer des fichiers¶

• Copier : sélectionnez un fichier → clic droit → Copy → allez vers le dossier cible → clic droit → Paste ;
• Déplacer : faites glisser le fichier vers le dossier souhaité tout en maintenant le bouton de la souris enfoncé.

Renommer des fichiers¶

1. Faites un clic droit sur le fichier ;

2. Sélectionnez Rename :

   

3. Entrez un nouveau nom ;

4. Appuyez sur Enter sur le clavier.

Gestion des permissions d'accès (ACL)¶

1. Faites un clic droit sur le fichier ou le bucket ;

2. Dans le menu contextuel, sélectionnez Edit Permissions (ACL) :

   

3. Dans la fenêtre ouverte, configurez les permissions d'accès pour les utilisateurs :

   • Owner - contrôle total sur l'objet ;
   • Any AWS Users - accès pour tout utilisateur AWS ;
   • All Users - accès public pour tout le monde.

4. Pour chaque catégorie d'utilisateur, vous pouvez définir :

   • Full Control - contrôle total ;
   • Read - lire l'objet ;
   • Write - écrire/modifier l'objet ;
   • Read Permissions - lire les permissions d'accès ;
   • Write Permissions - modifier les permissions d'accès :

   

5. Pour une configuration rapide, utilisez les boutons :

   • Make public - rendre le fichier public ;
   • Make private - rendre le fichier privé.

6. Après configuration, cliquez sur Apply changes pour enregistrer.

Génération de liens web¶

Pour créer un lien public vers un fichier ou un dossier dans S3 Object Storage :

1. Faites un clic droit sur le fichier ;

2. Dans le menu contextuel, sélectionnez Generate Web URL :

   

3. Dans la fenêtre ouverte Web URL Generator, configurez les paramètres de génération de lien :

4. Use secure transfer (HTTPS) - utilisez une connexion sécurisée (recommandé pour les données confidentielles) ;

5. Expiration - choisissez la période d'expiration du lien ;

6. Hostname - sélection du nom d'hôte :

   • Use default host name - utilisez l'adresse par défaut (par ex., https://s3-nl.hostkey.com/bfcc62b88-testbucket/) ;
   • Ou spécifiez votre propre domaine ;

7. Après configuration des paramètres, le système générera un lien complet vers le fichier, par ex. :

      https://s3-nl.hostkey.com/bfcc62b88-testbucket/dedicated-server-architecture.drawio
   

Raccourcissement du lien :¶

1. Pour créer un lien court, cliquez sur le bouton Shorten et choisissez un service :

   • Shorten with Bitly - raccourcir avec Bitly ;
   • Shorten with TinyURL - raccourcir avec TinyURL ;
   • Configure... - configurer les services de raccourcissement ;

   

   

2. Après raccourcissement réussi, vous recevrez un lien court (par ex., https://tinyurl.com/2dhcsk8y) ;

3. Utilisez les boutons :

   • Copy - copier le lien dans le presse-papiers ;
   • Close - fermer la fenêtre du générateur.

   

Travailler avec HOSTKEY S3 via AWS CLI¶

Installation d'AWS CLI¶

AWS CLI peut être installé de deux façons. Choisissez-en une :

Méthode 1 : Installation via pip (universelle)¶

Avantages :

• Installation simple avec une seule commande ;
• Facile à mettre à jour ;
• Fonctionne sur toutes les plateformes (Windows, Linux, macOS).

Inconvénients :

• Nécessite l'installation de Python ;
• Peut afficher des avertissements dans certains terminaux.

Installation :

pip install awscli boto3

Vérifier l'installation :

aws --version

pip show awscli boto3

Mise à jour :

pip install --upgrade awscli boto3

Méthode 2 : Installeur MSI pour Windows (recommandé)¶

Avantages :

• Ne nécessite pas Python ;
• Aucun avertissement dans le terminal ;
• Installation système propre.

Inconvénients :

• Windows uniquement ;
• Les mises à jour doivent être téléchargées manuellement.

Installation via terminal :

curl -o AWSCLIV2.msi https://awscli.amazonaws.com/AWSCLIV2.msi

msiexec /i AWSCLIV2.msi /quiet /norestart

Après l'installation :

1. Redémarrez le terminal ;
2. Vérifiez l'installation.

   aws --version
   

   where aws
   

Résultat attendu :

aws-cli/2.x.x Python/3.x.x Windows/10 exe/AMD64
C:\Program Files\Amazon\AWSCLIV2\aws.exe

Méthode d'installation alternative :

• Télécharger manuellement : https://awscli.amazonaws.com/AWSCLIV2.msi ;
• Exécuter l'installeur en double-cliquant ;
• Redémarrer le terminal.

Vérifier les conflits :

where aws

Si plusieurs chemins sont affichés, supprimez l'une des versions :

pip uninstall awscli -y

wmic product where "name like 'AWS Command Line Interface%'" call uninstall

Configuration de la connexion à HOSTKEY S3¶

1. Obtenir les identifiants depuis le panneau HOSTKEY

1. Connectez-vous à votre compte sur Invapi ;
2. Accédez à la section S3 Storage ;
3. Ouvrez l'onglet "Credentials" ;

4. Copiez les données suivantes :

   Pour l'identifiant utilisateur S3 (Access Key ID) :

   • Cliquez sur l'icône œil pour afficher la clé ;
   • Copiez la valeur affichée manuellement ou via le bouton Copy.

   Pour la clé secrète (Secret Access Key) :

   • Cliquez sur l'icône œil pour afficher la clé ;
   • Copiez la valeur affichée manuellement ou via le bouton Copy.

   Important

   Vous devez d'abord cliquer sur l'icône pour afficher les vraies valeurs de clé ; seulement après cela peuvent-elles être correctement copiées.

5. Vous aurez également besoin de :

6. Host name : https://s3-nl.hostkey.com ;
7. Region : affichée dans le panneau (par ex., nl pour les Pays-Bas).

2. Configuration du profil

aws configure --profile hostkey

Lorsque vous y êtes invité, saisissez :

AWS Access Key ID [None]: your_access_key_id
AWS Secret Access Key [None]: your_secret_access_key
Default region name [None]: nl
Default output format [None]: json

Exemple :

AWS Access Key ID [None]: s3uid_XXXXXXXXXXXXXXXXX
AWS Secret Access Key [None]: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Default region name [None]: nl
Default output format [None]: json

3. Vérifier la configuration

aws configure list --profile hostkey

Sortie attendue :

NAME       : VALUE                    : TYPE             : LOCATION
profile    : hostkey                  : manual           : --profile
access_key : ****************xxxx     : shared-credentials-file :
secret_key : ****************xxxx     : shared-credentials-file :
region     : nl                       : config-file      : ~/.aws/config

4. Vérifier la connexion

aws s3 ls --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat attendu (liste de vos buckets) :

2025-11-26 13:54:16 your-bucket-name

Opérations de fichiers de base¶

Affichage du contenu du bucket¶

aws s3 ls s3://bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

aws s3 ls s3://your-bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

2025-11-28 12:14:28         21 test.txt
2025-11-28 14:52:11         19 test_new.txt

Téléchargement d'un fichier¶

Créer un fichier de test :

echo Hello HOSTKEY S3 > test.txt

Télécharger le fichier vers le bucket :

aws s3 cp test.txt s3://bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

aws s3 cp test_new.txt s3://your-bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

upload: .\test_new.txt to s3://your-bucket-name/test_new.txt

Téléchargement d'un fichier depuis le bucket¶

aws s3 cp s3://bucket-name/file.txt ./local-file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

aws s3 cp s3://your-bucket-name/test.txt ./downloaded.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

download: s3://your-bucket-name/test.txt to .\downloaded.txt

Vérifier le fichier téléchargé (Windows) :

type downloaded.txt

Vérifier le fichier téléchargé (Linux/macOS) :

cat downloaded.txt

Suppression d'un fichier¶

aws s3 rm s3://bucket-name/file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

aws s3 rm s3://your-bucket-name/test.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

delete: s3://your-bucket-name/test.txt

Synchronisation de dossiers¶

Téléchargement d'un dossier vers le bucket :

aws s3 sync path/to/local/folder s3://bucket-name/path-in-bucket/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

aws s3 sync C:\Users\User\Documents\Test s3://your-bucket-name/remote-folder/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

upload: Documents\Test\file1.txt to s3://your-bucket-name/remote-folder/file1.txt
upload: Documents\Test\file2.docx to s3://your-bucket-name/remote-folder/file2.docx

Téléchargement d'un dossier depuis le bucket :

aws s3 sync s3://bucket-name/path-in-bucket/ path/to/local/folder --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Avec affichage de la progression :

aws s3 sync C:\Users\User\Documents\Test s3://your-bucket-name/backup/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com --progress

Correct :

aws s3 sync "C:\Users\Name\My Documents" s3://bucket/docs/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Incorrect (provoquera une erreur) :

aws s3 sync C:\Users\Name\My Documents s3://bucket/docs/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Commandes supplémentaires¶

Création d'un bucket¶

aws s3 mb s3://new-bucket-name --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Suppression d'un bucket vide¶

aws s3 rb s3://bucket-name --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Suppression d'un bucket avec tout son contenu¶

aws s3 rb s3://bucket-name --force --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Copie entre buckets¶

aws s3 cp s3://source-bucket/file.txt s3://dest-bucket/file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Déplacement d'un fichier¶

aws s3 mv s3://bucket-name/old-file.txt s3://bucket-name/new-file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Dépannage¶

Erreur : "aws" n'est pas une commande¶

Cause : AWS CLI n'est pas installé ou n'est pas ajouté au PATH.

Solution :

1. Redémarrez le terminal après l'installation ;
2. Vérifiez l'installation avec la commande where aws (devrait afficher un chemin) ;
3. Si cela ne fonctionne pas, réinstallez AWS CLI.

Erreur : Nom de bucket invalide¶

Cause : Nom de bucket incorrect.

Solution : Utilisez le nom de bucket exact du panneau HOSTKEY (par ex., prefix-testbucket).

Erreur : AccessDenied¶

Cause : Identifiants incorrects ou permissions insuffisantes.

Solution :

1. Vérifiez l'Access Key et la Secret Key dans le panneau HOSTKEY ;
2. Recréez le profil.

   aws configure --profile hostkey
   

Conflit entre les versions pip et MSI¶

Symptômes : La commande where aws affiche deux chemins.

Solution : Supprimez l'une des versions (voir la section ci-dessus).

Réinitialisation de la configuration¶

Windows :

rmdir /S /Q %USERPROFILE%\.aws

Linux/macOS :

rm -rf ~/.aws

Reconfigurer :

aws configure --profile hostkey

Emplacement des fichiers de configuration¶

Windows :

C:\Users\USER_NAME\.aws\credentials
C:\Users\USER_NAME\.aws\config

Linux/macOS :

~/.aws/credentials
~/.aws/config

Contenu des fichiers :

• credentials - Access Key et Secret Key ;
• config - paramètres de région et de format de sortie.

Commandes utiles pour la vérification¶

Version d'AWS CLI :

aws --version

Emplacement de l'exécutable :

where aws

Informations sur le profil :

aws configure list --profile hostkey

Informations sur le package (pour la version pip) :

pip show awscli boto3

Mise à jour (pour la version pip) :

pip install --upgrade awscli boto3

Une partie du contenu de cette page a été créée ou traduite à l'aide d'IA.