S3 Object Storage HOSTKEY¶

In dit artikel

• Servicebeschrijving
• Belangrijkste functies
• Technische parameters
• Prijsstelling
• Het aanmaken van S3 Storage
• S3 Storage Control Panel in Invapi
• S3 Storage inloggegevens ophalen in Invapi
• Het beheren van S3 Storage Buckets in Invapi
• Gebruik via S3 Browser
• Basisbestandoperaties
• Werken met HOSTKEY S3 via AWS CLI

Servicebeschrijving¶

Belangrijkste functies¶

• Het maken van onafhankelijke storages - tijdens de gratis bètaperiode op het Free Beta 1 plan kunnen gebruikers tot 3 onafhankelijke S3 storage buckets aanmaken;
• Onafhankelijkheid van VPS/VDS - S3 storages werken autonoom en vereisen geen hosting van een HOSTKEY server;
• Het maken van Buckets - bij het aanmaken van opslag wordt de eerste bucket met een unieke naam automatisch aangemaakt. Het maken van Buckets: Tijdens de bètaperiode kunnen gebruikers tot 10 buckets in elke S3 storage aanmaken;
• S3-compatibele toegang - volledige ondersteuning voor het standaard Amazon S3-protocol voor alle gegevensoperaties;
• Werken met alle S3-clients - gebruik S3 Browser, Cyberduck, boto3 en andere S3-compatibele tools;
• Beveiligde toegang - autorisatie via Access Key en Secret Key over het HTTPS-protocol;
• Eenvoudig beheer van inloggegevens - genereren en bekijken van access keys via de webinterface van uw account;
• Kant-en-klare plannen - keuze uit plannen met een vast opslagvolume en bandbreedte.

Technische parameters¶

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

Prijsstelling¶

S3 storage wordt tegen betaling geleverd. U kunt de huidige prijsplannen hier bekijken. U kunt ook uw opslag- en verkeersvolume verhogen en betalen op basis van "pay-as-you-go". De kosten voor extra verbruik worden dagelijks berekend.

Op het moment van het bestellen van de service wordt een bedrag gelijk aan één maand werkelijk gebruik ingehouden van uw accounttegoed volgens de voorwaarden van het gekozen prijsplan. Vervolgens zullen betalingen voor de volgende maanden van gebruik, evenals kosten voor het overschrijden van de limieten van de resources, ook van uw accounttegoed worden ingehouden.

Om uw factuurgeschiedenis te bekijken, gaat u naar het menu Balance & Payments in het gebruikersprofiel binnen Invapi en navigeert u naar de sectie Billing Details.

In de sectie Billing Details kunt u de transactiegeschiedenis bekijken voor alle extra services die aan dit account zijn gekoppeld (Managed Apps, S3), evenals het totale bedrag dat aan dit account is gefactureerd. Elke servicefactuur wordt afzonderlijk vermeld binnen de maandelijkse factureringscyclus.

Facturen worden gegenereerd op de 2e dag van de maand volgend op de rapportagemaand om 05:00 UTC. U kunt facturen bekijken in de sectie Balance & Payments in Invapi onder het tabblad Billing Details. Het bedrag in de facturen wordt berekend voor een kalendermaand en bevat de kosten voor het gebruik van de service. Er kan één geconsolideerde factuur worden gegenereerd inclusief het totale bedrag voor alle extra services.

Het aanmaken van S3 Storage¶

1. Log in op uw account bij Invapi

2. Ga naar de sectie S3 Storage;

3. Maak nieuwe opslag aan:

   

   • Region: selecteer de regio (standaard NL - Nederland);
   • Bucket name: voer de bucketnaam in (bijvoorbeeld bde347688-testbucket):
     • naam moet uniek zijn;
     • maximaal 63 tekens;
     • alleen kleine letters, cijfers en streepjes;
     • moet beginnen en eindigen met een letter of cijfer.
   • Plan: selecteer een prijsplan (bijvoorbeeld Standart). Om te selecteren, klikt u op de naam van het plan;
   • Klik op Create S3 Storage.

Na het aanmaken van de opslag krijgt u de opdracht om voor uw bestelling te betalen.

S3 Storage Control Panel in Invapi¶

Na een succesvolle betaling wordt u doorgeleid naar het paneel Your Independent Storages (of door S3 Storage te selecteren in het linkermenu), waar u het volgende kunt doen:

1. Uw betaalde storages en hun tarieven bekijken
2. Een nieuwe onafhankelijke S3 storage aanmaken
3. Een specifieke opslag uit de lijst selecteren om de details te bekijken
4. Statistieken bekijken over het opslagvolume en het gegevensverkeer
5. Inloggegevens bekijken voor verbinding met de opslag
6. Nieuwe buckets toevoegen aan de huidige opslag
7. De lijst van toegevoegde buckets en hun statistieken bekijken
8. Bewerkingen uitvoeren op buckets

S3 Storage inloggegevens ophalen in Invapi¶

1. Zoek in de lijst met uw storages de aangemaakte opslag en ga naar het tabblad Credentials:

   

2. Kopieer de inloggegevens:

   U heeft het volgende nodig:

   • Host Name (Endpoint URL): https://s3-nl.hostkey.com;
   • S3 User ID: (bijv. oab56UivbdcUURCTrMCrcB86YWzyy1hB);
   • Access Key: klik op om de sleutel te onthullen;
   • Secret Key: klik op om de sleutel te onthullen.

   Sla deze gegevens op - ze zijn vereist voor de verbinding.

Het beheren van S3 Storage Buckets in Invapi¶

Direct vanuit de S3 storage interface in Invapi zijn de volgende bucket-bewerkingen beschikbaar:

1. Bekijk de ruimte die door de bucket wordt ingenomen in de opslag en het aantal objecten erin;
2. De bucket verwijderen;
3. De inhoud van de bucket bekijken door op de regel met de naam te klikken;
4. Bestandsgrootte en informatie over de creatiedatum bekijken voor bestanden in de bucket;
5. Zoeken naar bestanden in de bucket;
6. Individuele bestanden uit de bucket verwijderen.

Gebruik via S3 Browser¶

1. Download de gratis versie van S3 Browser: https://s3browser.com;

2. Voeg een nieuw account toe:

   

   • Open S3 Browser;
   • Klik op Accounts >> Add New Account.

3. Vul het formulier in:

   • Display name: HOSTKEY S3 (een willekeurige naam);
   • Account type: S3 Compatible Storage (niet Amazon S3 Storage!);
   • API endpoint: s3-nl.hostkey.com (zonder https://);
   • Access Key ID: plak uw Access Key uit het HOSTKEY paneel;
   • Secret Access Key: plak uw Secret Key uit het HOSTKEY paneel;
   • Use secure transfer (SSL/TLS): laat het selectievakje aangevinkt.

4. Klik op Add new account;

5. Werken met bestanden:

   

   Na een succesvolle verbinding ziet u:

   • Bucket list aan de linkerkant;
   • Files in bucket aan de rechterkant;
   • Beheerknoppen: Upload, Download, Delete, New Folder, Refresh.

   Beschikbare bewerkingen:

   • Upload - bestanden uploaden;
   • Download - bestanden downloaden;
   • Delete - bestanden verwijderen;
   • New Folder - mappen aanmaken;
   • Refresh - de lijst vernieuwen.

Basisbestandoperaties¶

Na het maken van verbinding met een S3 storage via een S3-compatibele client, zijn de volgende bewerkingen beschikbaar:

Bestanden uploaden¶

1. Via S3 Browser:

   • Selecteer een bucket in het linkerpaneel;
   • Klik op de knop Upload of Upload folder(s);
   • Selecteer bestanden van uw computer;
   • Bevestig de upload:

   

2. Via drag-and-drop:

   • Sleep bestanden simpelweg vanuit de verkenner naar het S3 Browser-venster.

Bestanden downloaden¶

1. Selecteer een bestand in de bucket;

2. Klik op de knop Download of klik met de rechtermuisknop en selecteer Download:

   

3. Geef de map aan waar u het bestand op uw computer wilt opslaan.

Bestanden en mappen verwijderen¶

1. Selecteer een bestand of map;

2. Klik op de knop Delete of druk op de Delete-toets op het toetsenbord:

   

3. Bevestig de verwijdering.

Mappenstructuur aanmaken¶

1. Selecteer een bucket of map;

2. Klik op New Folder:

   

3. Voer de mapnaam in:

   

4. Klik op Create new folder.

Bestanden kopiëren en verplaatsen¶

• Kopiëren: selecteer een bestand > rechtermuisknop > Copy > ga naar de doelmap > rechtermuisknop > Paste;
• Verplaatsen: sleep het bestand naar de gewenste map terwijl u de muisknop ingedrukt houdt.

Bestanden hernoemen¶

1. Klik met de rechtermuisknop op het bestand;

2. Selecteer Rename:

   

3. Voer een nieuwe naam in;

4. Druk op Enter op het toetsenbord.

Toegangsmachtigingen beheren (ACL)¶

1. Klik met de rechtermuisknop op het bestand of de bucket;

2. Selecteer in het contextmenu Edit Permissions (ACL):

   

3. Configureer in het geopende venster de toegangsmachtigingen voor gebruikers:

   • Owner - volledige controle over het object;
   • Any AWS Users - toegang voor alle AWS-gebruikers;
   • All Users - openbare toegang voor iedereen.

4. Voor elke gebruikerscategorie kunt u het volgende instellen:

   • Full Control - volledige controle;
   • Read - het object lezen;
   • Write - het object schrijven/wijzigen;
   • Read Permissions - leesrechten;
   • Write Permissions - wijzigingsrechten voor toegang:

   

5. Voor snelle configuratie kunt u de knoppen gebruiken:

   • Make public - maak het bestand openbaar;
   • Make private - maak het bestand privé.

6. Klik na de configuratie op Apply changes om op te slaan.

Weblinks genereren¶

Om een openbare link naar een bestand of map in S3 Object Storage te maken:

1. Klik met de rechtermuisknop op het bestand;

2. Selecteer in het contextmenu Generate Web URL:

   

3. Configureer in het geopende venster Web URL Generator de parameters voor linkgeneratie:

4. Use secure transfer (HTTPS) - gebruik een beveiligde verbinding (aanbevolen voor vertrouwelijke gegevens);

5. Expiration - kies de vervaltermijn van de link;

6. Hostname - selectie van de hostnaam:

   • Use default host name - gebruik het standaardadres (bijv. https://s3-nl.hostkey.com/bfcc62b88-testbucket/);
   • Of specificeer uw eigen domein;

7. Na het configureren van de parameters genereert het systeem een volledige link naar het bestand, bijv.:

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

De link inkorten:¶

1. Om een korte link te maken, klik op de knop Shorten en kies een service:

   • Shorten with Bitly - inkorten met Bitly;
   • Shorten with TinyURL - inkorten met TinyURL;
   • Configure... - configureer verkortingsservices;

   

   

2. Na het succesvol inkorten ontvangt u een korte link (bijv. https://tinyurl.com/2dhcsk8y);

3. Gebruik de knoppen:

   • Copy - kopieer de link naar het klembord;
   • Close - sluit het generatorvenster.

   

Werken met HOSTKEY S3 via AWS CLI¶

AWS CLI installeren¶

AWS CLI kan op twee manieren worden geïnstalleerd. Kies er één:

Methode 1: Installatie via pip (universeel)¶

Voordelen:

• Eenvoudige installatie met één commando;
• Eenvoudig bij te werken;
• Werkt op alle platforms (Windows, Linux, macOS).

Nadelen:

• Vereist een geïnstalleerde Python-omgeving;
• Kan waarschuwingen tonen in sommige terminals.

Installatie:

pip install awscli boto3

Verificatie van de installatie:

aws --version

pip show awscli boto3

Bijwerken:

pip install --upgrade awscli boto3

Methode 2: MSI-installer voor Windows (aanbevolen)¶

Voordelen:

• Vereist geen Python;
• Geen waarschuwingen in de terminal;
• Schone systeeminstallatie.

Nadelen:

• Alleen voor Windows;
• Updates moeten handmatig worden gedownload.

Installatie via terminal:

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

msiexec /i AWSCLIV2.msi /quiet /norestart

Na de installatie:

1. Start de terminal opnieuw op;
2. Verifieer de installatie:

   aws --version
   

   where aws
   

Verwacht resultaat:

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

Alternatieve installatiemethode:

• Handmatig downloaden: https://awscli.amazonaws.com/AWSCLIV2.msi;
• Voer de installer uit door er dubbel op te klikken;
• Start de terminal opnieuw op.

Controleren op conflicten:

where aws

Als er meerdere paden worden getoond, verwijder dan een van de versies:

pip uninstall awscli -y

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

De verbinding met HOSTKEY S3 configureren¶

1. Inloggegevens ophalen uit het HOSTKEY paneel

1. Log in op uw account bij Invapi;
2. Ga naar de sectie S3 Storage;
3. Open het tabblad "Credentials";

4. Kopieer de volgende gegevens:

   Voor de S3-gebruikersidentificatie (Access Key ID):

   • Klik op het oog-icoon om de sleutel te onthullen;
   • Kopieer de getoonde waarde handmatig of via de Copy knop.

   Voor de geheime sleutel (Secret Access Key):

   • Klik op het oog-icoon om de sleutel te onthullen;
   • Kopieer de getoonde waarde handmatig of via de Copy knop.

   Let op

   U moet eerst op het icoontje klikken om de werkelijke sleutels weer te geven; pas daarna kunnen ze correct worden gekopieerd.

5. U heeft ook het volgende nodig:

6. Host name: https://s3-nl.hostkey.com;
7. Region: wordt in het paneel weergegeven (bijv. nl voor Nederland).

2. Het profiel instellen

aws configure --profile hostkey

Voer bij de prompts het volgende in:

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

Voorbeeld:

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

3. Verificatie van de configuratie

aws configure list --profile hostkey

Verwacht resultaat:

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. Verificatie van de verbinding

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

Verwacht resultaat (lijst van uw buckets):

2025-11-26 13:54:16 uw-bucket-naam

Basisbestandoperaties¶

Inhoud van de bucket bekijken¶

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

Voorbeeld:

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

Resultaat:

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

Een bestand uploaden¶

Maak een testbestand aan:

echo Hello HOSTKEY S3 > test.txt

Upload het bestand naar de bucket:

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

Voorbeeld:

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

Resultaat:

upload: .\test_new.txt to s3://uw-bucket-naam/test_new.txt

Een bestand downloaden¶

aws s3 cp s3://bucket-naam/file.txt ./lokaal-bestand.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Voorbeeld:

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

Resultaat:

download: s3://uw-bucket-naam/test.txt to .\gedownload.txt

Een bestand controleren (Windows)¶

type gedownload.txt

Een bestand controleren (Linux/macOS)

cat gedownload.txt

Een bestand verwijderen¶

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

Voorbeeld:

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

Resultaat:

delete: s3://uw-bucket-naam/test.txt

Mappen synchroniseren¶

Een map uploaden naar de bucket:

aws s3 sync pad/naar/lokale/map s3://bucket-naam/pad-in-bucket/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Voorbeeld:

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

Resultaat:

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

Een map downloaden van de bucket:

aws s3 sync s3://bucket-naam/pad-in-bucket/ pad/naar/lokale/map --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Met voortgangsweergave:

aws s3 sync C:\Users\User\Documents\Test s3://uw-bucket-naam/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 (veroorzaakt een fout):

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

Aanvullende commando's¶

Een bucket aanmaken¶

aws s3 mb s3://nieuwe-bucket-naam --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Een lege bucket verwijderen¶

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

Een bucket met alle inhoud verwijderen¶

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

Kopiëren tussen buckets¶

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

Een bestand verplaatsen¶

aws s3 mv s3://bucket-naam/oud-bestand.txt s3://bucket-naam/nieuw-bestand.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Probleemoplossing¶

Fout: "aws" is geen commando¶

Oorzaak: AWS CLI is niet geïnstalleerd of niet toegevoegd aan de PATH.

Oplossing:

1. Start de terminal opnieuw op na installatie;
2. Verifieer de installatie met het commando where aws (moet een pad tonen);
3. Als dat niet helpt, installeer AWS CLI opnieuw.

Fout: Ongeldige bucketnaam¶

Oorzaak: Onjuiste bucketnaam.

Oplossing: Gebruik de exacte bucketnaam uit het HOSTKEY paneel (bijv. prefix-testbucket).

Fout: AccessDenied¶

Oorzaak: Onjuiste inloggegevens of onvoldoende machtigingen.

Oplossing:

1. Controleer de Access Key en Secret Key in het HOSTKEY paneel;
2. Maak het profiel opnieuw aan.

   aws configure --profile hostkey
   

Conflict tussen pip- en MSI-versies¶

Symptomen: Het commando where aws toont twee paden.

Oplossing: Verwijder een van de versies (zie de sectie "Meng geen installatiemethoden").

Configuratie resetten¶

Windows:

rmdir /S /Q %USERPROFILE%\.aws

Linux/macOS:

rm -rf ~/.aws

Opnieuw instellen:

aws configure --profile hostkey

Locatie van configuratiebestanden¶

Windows:

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

Linux/macOS:

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

Inhoud van de bestanden:

• credentials - Access Key en Secret Key;
• config - instellingen voor regio en uitvoerformaat.

Handige commando's voor verificatie¶

AWS CLI versie:

aws --version

Locatie van het uitvoerbare bestand:

where aws

Profielinformatie:

aws configure list --profile hostkey

Pakketinformatie (voor pip-versie):

pip show awscli boto3

Bijwerken (voor pip-versie):

pip install --upgrade awscli boto3