Stockage d'objets S3 HOSTKEY¶

Dans cet article

• Description du service
• Fonctionnalités clés
• Paramètres techniques
• Tarifs
• Création d'un stockage S3
• Tableau de bord du stockage S3 dans Invapi
• Récupération des identifiants du stockage S3 dans Invapi
• Gestion des buckets du stockage S3 dans Invapi
• Utilisation via S3 Browser
• Opérations de base sur les fichiers
• Travail avec HOSTKEY S3 via AWS CLI

Description du service¶

Fonctionnalités clés¶

• Création de stockages indépendants - pendant la phase de bêta gratuite sur le plan Free Beta 1, les utilisateurs peuvent créer jusqu'à 3 buckets de stockage S3 indépendants ;
• Indépendance par rapport aux 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 automatiquement créé. Création de buckets : Pendant la période bêta, les utilisateurs peuvent créer jusqu'à 10 buckets dans chaque stockage S3 ;
• Accès compatible S3 - prise en charge complète du protocole Amazon S3 standard pour toutes les opérations de données ;
• Compatibilité avec tous les clients S3 - utilisez S3 Browser, Cyberduck, boto3 et d'autres outils compatibles S3 ;
• Accès sécurisé - autorisation via Access Key et Secret Key sur le protocole HTTPS ;
• Gestion simple des identifiants - génération et affichage des clés d'accès via l'interface web de votre compte ;
• Plans prêts à l'emploi - choix de plans avec volume de stockage et bande passante fixes.

Paramètres techniques¶

• URL de point de terminaison (Endpoint) : https://s3-nl.hostkey.com ;
• Protocole : HTTPS (SSL/TLS) ;
• Autorisation : AWS Signature Version 4.

Tarifs¶

Le stockage S3 est fourni sur une base payante. Vous pouvez consulter les plans tarifaires actuels ici. Vous pouvez également augmenter votre volume de stockage et de trafic et payer à l'usage ("pay-as-you-go"). Le coût de l'utilisation supplémentaire est calculé quotidiennement.

Au moment de la commande du service, des fonds seront déduits de votre solde de compte pour un mois d'utilisation effective selon les conditions du plan tarifaire sélectionné. Les paiements mensuels ultérieurs, ainsi que les frais liés au dépassement des limites de ressources, seront également déduits de votre solde de compte.

Les documents de facturation sont générés le 2 du mois suivant le mois de facturation à 05:00 UTC. Vous pouvez consulter les documents de facturation dans la section Facturation de Invapi. Le montant des documents de facturation couvre le mois civil et inclut le coût de l'utilisation du service, ainsi que tous les frais supplémentaires pour dépassement des limites de ressources.

Création d'un stockage S3¶

1. Connectez-vous à votre compte sur Invapi

2. Accédez à la section S3 Storage ;

3. Créez un nouveau stockage :

   

   • Région : sélectionnez la région (par défaut NL - Pays-Bas) ;
   • Nom du bucket : saisissez le nom du bucket (par exemple, bde347688-testbucket) :
     • le nom doit être unique ;
     • maximum 63 caractères ;
     • uniquement des lettres minuscules, des chiffres et des tirets ;
     • doit commencer et se terminer par une lettre ou un chiffre.
   • Plan : sélectionnez un plan tarifaire (par exemple, Standart). Pour sélectionner, cliquez sur le nom du plan ;
   • Cliquez sur Create S3 Storage.

Après la création du stockage, il vous sera demandé de payer votre commande

Tableau de bord du stockage S3 dans Invapi¶

Après un paiement réussi, vous serez redirigé vers le panneau Your Independent Storages (ou en sélectionnant S3 Storage dans le menu supérieur), où vous pouvez :

1. Consulter vos stockages payants et leurs tarifs
2. Créer un nouveau stockage S3 indépendant
3. Sélectionner un stockage spécifique dans la liste pour afficher ses détails
4. Consulter les statistiques sur le volume de stockage et l'utilisation du trafic
5. Consulter les identifiants pour se connecter au stockage
6. Ajouter de nouveaux buckets au stockage actuel
7. Consulter la liste des buckets ajoutés et leurs statistiques
8. Effectuer des opérations sur les buckets

Récupération des identifiants du stockage S3 dans Invapi¶

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

   

2. Copiez les identifiants :

   Vous aurez besoin de :

   • Host Name (Endpoint URL) : https://s3-nl.hostkey.com ;
   • S3 User ID : (par exemple, oab56UivbdcUURCTrMCrcB86YWzyy1hB) ;
   • Access Key : cliquez sur pour révéler la clé ;
   • Secret Key : cliquez sur pour révéler la clé.

   Attention

   Vous devez d'abord cliquer sur l'icône pour afficher les valeurs réelles des clés avant de pouvoir les copier correctement.

   Conservez ces données - elles seront requises pour la connexion.

Gestion des buckets du stockage S3 dans Invapi¶

Directement depuis l'interface de stockage S3 dans Invapi, les opérations de bucket suivantes sont disponibles :

1. Consulter l'espace occupé par le bucket dans le stockage et le nombre d'objets qu'il contient ;
2. Supprimer le bucket ;
3. Consulter le contenu du bucket en cliquant sur la ligne avec son nom ;
4. Consulter les informations sur la taille des fichiers et la date de création des fichiers dans le bucket ;
5. Rechercher des fichiers dans le bucket ;
6. Supprimer des fichiers individuels du bucket.

Utilisation via S3 Browser¶

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

2. Ajoutez un nouveau compte :

   

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

3. Remplissez le formulaire :

   • Display name : HOSTKEY S3 (tout nom pratique) ;
   • Account type : S3 Compatible Storage (pas Amazon S3 Storage !) ;
   • API endpoint : s3-nl.hostkey.com (sans https://) ;
   • Access Key ID : collez votre Access Key dans le champ correspondant depuis le panneau HOSTKEY ;
   • Secret Access Key : collez votre Secret Key dans le champ correspondant depuis le panneau HOSTKEY ;
   • Use secure transfer (SSL/TLS) : laissez la case à cocher active.

4. Cliquez sur Add new account ;

5. Travaillez avec les fichiers :

   

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

   • Liste des buckets à gauche ;
   • Fichiers dans le bucket à droite ;
   • Boutons de gestion : Upload, Download, Delete, New Folder, Refresh.

   Opérations disponibles :

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

Opérations de base sur les fichiers¶

Après la connexion à un stockage S3 via un client compatible S3, les opérations suivantes sont disponibles :

Téléchargement de fichiers¶

1. Via S3 Browser :

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

   

2. Via glisser-déposer :

   • Il suffit de faire glisser les fichiers depuis l'explorateur vers la fenêtre de S3 Browser.

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 pour enregistrer le fichier sur votre ordinateur.

Suppression de fichiers et de 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. Saisissez le nom du dossier :

   

4. Cliquez sur Create new folder.

Copie et déplacement de fichiers¶

• Copie : sélectionnez un fichier > clic droit > Copy > allez dans le dossier cible > clic droit > Paste ;
• Déplacement : faites glisser le fichier vers le dossier souhaité en maintenant le bouton de la souris enfoncé.

Renommage de fichiers¶

1. Faites un clic droit sur le fichier ;

2. Sélectionnez Rename :

   

3. Saisissez un nouveau nom ;

4. Appuyez sur la touche Enter du 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 tous les utilisateurs AWS ;
   • All Users - accès public pour tout le monde.

4. Pour chaque catégorie d'utilisateurs, 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 la 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 le stockage d'objets S3 :

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 du lien :

4. Use secure transfer (HTTPS) - utiliser 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 - utiliser l'adresse par défaut (par exemple, https://s3-nl.hostkey.com/bfcc62b88-testbucket/) ;
   • Ou spécifiez votre propre domaine ;

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

   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 un raccourcissement réussi, vous recevrez un lien court (par exemple, 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.

   

Travail avec HOSTKEY S3 via AWS CLI¶

Installation d'AWS CLI¶

AWS CLI peut être installé de deux manières. Choisissez-en une :

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

Avantages :

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

Inconvénients :

• Nécessite Python installé ;
• 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 : Installateur MSI pour Windows (recommandé)¶

Avantages :

• Ne nécessite pas Python ;
• Pas d'avertissements 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échargez manuellement : https://awscli.amazonaws.com/AWSCLIV2.msi ;
• Exécutez l'installateur en double-cliquant ;
• Redémarrez le terminal.

Vérifier les conflits :

where aws

S'il affiche plusieurs chemins, 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. Obtention des 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 révéler 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 révéler la clé ;
   • Copiez la valeur affichée manuellement ou via le bouton Copy.

   Attention

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

5. Vous aurez également besoin de :

6. Nom d'hôte : https://s3-nl.hostkey.com ;
7. Région : affichée dans le panneau (par exemple, nl pour les Pays-Bas).

2. Configuration du profil

aws configure --profile hostkey

Lors de la demande, entrez :

AWS Access Key ID [None]: votre_access_key_id
AWS Secret Access Key [None]: votre_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 votre-nom-de-bucket

Opérations de base sur les fichiers¶

Affichage du contenu du bucket¶

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

Exemple :

aws s3 ls s3://votre-nom-de-bucket/ --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 dans le bucket :

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

Exemple :

aws s3 cp test_new.txt s3://votre-nom-de-bucket/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

upload: .\test_new.txt to s3://votre-nom-de-bucket/test_new.txt

Téléchargement d'un fichier¶

aws s3 cp s3://nom-du-bucket/fichier.txt ./fichier-local.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

aws s3 cp s3://votre-nom-de-bucket/test.txt ./downloaded.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

download: s3://votre-nom-de-bucket/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://nom-du-bucket/fichier.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

aws s3 rm s3://votre-nom-de-bucket/test.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Résultat :

delete: s3://votre-nom-de-bucket/test.txt

Synchronisation de dossiers¶

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

aws s3 sync chemin/vers/dossier/local s3://nom-du-bucket/chemin-dans-bucket/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Exemple :

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

Résultat :

upload: Documents\Test\file1.txt to s3://votre-nom-de-bucket/remote-folder/file1.txt
upload: Documents\Test\file2.docx to s3://votre-nom-de-bucket/remote-folder/file2.docx

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

aws s3 sync s3://nom-du-bucket/chemin-dans-bucket/ chemin/vers/dossier/local --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Avec affichage de la progression :

aws s3 sync C:\Users\User\Documents\Test s3://votre-nom-de-bucket/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://nouveau-nom-de-bucket --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Suppression d'un bucket vide¶

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

Suppression d'un bucket avec tout son contenu¶

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

Copie entre buckets¶

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

Déplacement d'un fichier¶

aws s3 mv s3://nom-du-bucket/ancien-fichier.txt s3://nom-du-bucket/nouveau-fichier.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é à PATH.

Solution :

1. Redémarrez le terminal après l'installation ;
2. Vérifiez l'installation en utilisant 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 exact du bucket depuis le panneau HOSTKEY (par exemple, prefix-testbucket).

Erreur : AccessDenied¶

Cause : Identifiants incorrects ou permissions insuffisantes.

Solution :

1. Vérifiez l'Access Key et le 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 "Ne pas mélanger les méthodes d'installation").

Réinitialisation de la configuration¶

Windows :

rmdir /S /Q %USERPROFILE%\.aws

Linux/macOS :

rm -rf ~/.aws