S3 Object Storage HOSTKEY¶

In dit artikel

• Servicebeschrijving
• Belangrijkste functies
• Technische parameters
• Prijzen
• S3-opslag aanmaken
• S3-opslagdashboard in Invapi
• S3-opslaginloggegevens ophalen in Invapi
• S3-opslagbuckets beheren in Invapi
• Gebruik via S3 Browser
• Basisbestandoperaties
• Werken met HOSTKEY S3 via AWS CLI

Servicebeschrijving¶

Belangrijkste functies¶

• Aanmaken van onafhankelijke opslagruimtes - tijdens de gratis bètaperiode op het Free Beta 1-plan kunnen gebruikers tot 3 onafhankelijke S3-opslagbuckets aanmaken;
• Onafhankelijk van VPS/VDS - S3-opslagruimtes werken autonoom en vereisen geen verhuur van een HOSTKEY-server;
• Aanmaken van buckets - bij het aanmaken van opslag wordt automatisch de eerste bucket met een unieke naam aangemaakt. Aanmaken van buckets: tijdens de bètaperiode kunnen gebruikers tot 10 buckets in elke S3-opslagruimte aanmaken;
• S3-compatibele toegang - volledige ondersteuning voor het standaard Amazon S3-protocol voor alle gegevensoperaties;
• Werken met elke S3-client - gebruik S3 Browser, Cyberduck, boto3 en andere S3-compatibele tools;
• Veilige toegang - autorisatie via Access Key en Secret Key over het HTTPS-protocol;
• Eenvoudig beheer van inloggegevens - genereren en weergeven van toegangskeys via de webinterface van uw account;
• Kant-en-klare plannen - keuze uit plannen met vast opslagvolume en bandbreedte.

Technische parameters¶

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

Prijzen¶

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

Bij het plaatsen van de servicebestelling worden er middelen van uw accountsaldo afgeschreven voor één maand daadwerkelijk gebruik volgens de voorwaarden van het geselecteerde prijsplan. Volgende maandelijkse betalingen, evenals kosten voor het overschrijden van resource-limieten, worden eveneens van uw accountsaldo afgeschreven.

Factureringsdocumenten worden gegenereerd op de 2e van de maand na de factureringsmaand om 05:00 UTC. U kunt factureringsdocumenten bekijken in de sectie Billing van Invapi. Het bedrag in de factureringsdocumenten dekt de kalendermaand en omvat de kosten van servicegebruik, evenals alle extra kosten voor het overschrijden van resource-limieten.

S3-opslag aanmaken¶

1. Log in op uw account op Invapi

2. Ga naar de sectie S3 Storage;

3. Nieuwe opslag aanmaken:

   

   • 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 koppeltekens;
     • moet beginnen en eindigen met een letter of cijfer.
   • Plan: selecteer een prijsplan (bijvoorbeeld Standart). Om te selecteren, klikt u op de plannaam;
   • Klik op Create S3 Storage.

Na het aanmaken van de opslag wordt u gevraagd om uw bestelling te betalen

S3-opslagdashboard in Invapi¶

Na succesvolle betaling wordt u doorgestuurd naar het paneel Your Independent Storages (of door S3 Storage te selecteren in het bovenste menu), waar u kunt:

1. Uw betaalde opslagruimtes en hun tarieven bekijken
2. Een nieuwe onafhankelijke S3-opslagruimte aanmaken
3. Een specifieke opslagruimte uit de lijst selecteren om de details te bekijken
4. Statistieken over opslagvolume en verkeersgebruik bekijken
5. Inloggegevens voor verbinding met de opslagruimte bekijken
6. Nieuwe buckets toevoegen aan de huidige opslagruimte
7. De lijst met toegevoegde buckets en hun statistieken bekijken
8. Operaties op buckets uitvoeren

S3-opslaginloggegevens ophalen in Invapi¶

1. Zoek in de lijst van uw opslagruimtes de aangemaakte opslagruimte 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 key te onthullen;
   • Secret Key: klik op om de key te onthullen.

   Let op

   U moet eerst op het pictogram klikken om de daadwerkelijke key-waarden weer te geven voordat u ze correct kunt kopiëren.

   Bewaar deze gegevens - deze zijn vereist voor de verbinding.

S3-opslagbuckets beheren in Invapi¶

Direct vanuit de S3-opslaginterface in Invapi zijn de volgende bucket-operaties beschikbaar:

1. Bekijk de ruimte die door de bucket in de opslagruimte wordt ingenomen en het aantal objecten daarin;
2. Verwijder de bucket;
3. Bekijk de bucketinhoud door op de rij met de naam te klikken;
4. Bekijk informatie over bestandsgrootte en aanmaakdatum voor bestanden in de bucket;
5. Zoek naar bestanden in de bucket;
6. Verwijder individuele bestanden uit de bucket.

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 (elke handige 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 actief.

4. Klik op Add new account;

5. Werk met bestanden:

   

   Na succesvolle verbinding ziet u:

   • Bucket list links;
   • Files in bucket rechts;
   • Beheerknoppen: Upload, Download, Delete, New Folder, Refresh.

   Beschikbare operaties:

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

Basisbestandoperaties¶

Na verbinding met een S3-opslagruimte via een S3-compatibele client zijn de volgende operaties 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 het uploaden:

   

2. Via slepen en neerzetten:

   • Sleep bestanden eenvoudig 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 op om het bestand op uw computer op te slaan.

Bestanden en mappen verwijderen¶

1. Selecteer een bestand of map;

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

   

3. Bevestig het verwijderen.

Mapstructuur 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 > klik met de rechtermuisknop > Copy > ga naar de doelmap > klik met de 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.

Toegangsrechten 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 toegangsrechten voor gebruikers:

   • Owner - volledige controle over het object;
   • Any AWS Users - toegang voor elke AWS-gebruiker;
   • 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 - toegangsrechten lezen;
   • Write Permissions - toegangsrechten wijzigen:

   

5. Gebruik voor snelle configuratie de knoppen:

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

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

Webkoppelingen genereren¶

Om een openbare koppeling 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 koppelinggeneratie:

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

5. Expiration - kies de vervaldatum van de koppeling;

6. Hostname - hostnaamselectie:

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

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

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

De koppeling verkorten:¶

1. Om een korte koppeling te maken, klikt u op de knop Shorten en kiest u een service:

   • Shorten with Bitly - verkorten met Bitly;
   • Shorten with TinyURL - verkorten met TinyURL;
   • Configure... - verkortingservices configureren;

   

   

2. Na succesvolle verkorting ontvangt u een korte koppeling (bijv. https://tinyurl.com/2dhcsk8y);

3. Gebruik de knoppen:

   • Copy - kopieer de koppeling 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 opdracht;
• Makkelijk bij te werken;
• Werkt op alle platforms (Windows, Linux, macOS).

Nadelen:

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

Installatie:

pip install awscli boto3

Installatie verifiëren:

aws --version

pip show awscli boto3

Bijwerken:

pip install --upgrade awscli boto3

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

Voordelen:

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

Nadelen:

• Alleen 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 installatie:

1. Herstart de terminal;
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;
• Start het installatieprogramma door dubbel te klikken;
• Herstart de terminal.

Controleren op conflicten:

where aws

Als er meerdere paden worden weergegeven, verwijder dan één van de versies:

pip uninstall awscli -y

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

Verbinding met HOSTKEY S3 configureren¶

1. Inloggegevens ophalen uit het HOSTKEY-paneel

1. Log in op uw account op 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 oogpictogram om de key te onthullen;
   • Kopieer de weergegeven waarde handmatig of via de knop Copy.

   Voor de geheime key (Secret Access Key):

   • Klik op het oogpictogram om de key te onthullen;
   • Kopieer de weergegeven waarde handmatig of via de knop Copy.

   Let op

   U moet eerst op het pictogram klikken om de echte key-waarden weer te geven; pas daarna kunnen ze correct worden gekopieerd.

5. U heeft ook het volgende nodig:

6. Hostnaam: https://s3-nl.hostkey.com;
7. Regio: weergegeven in het paneel (bijv. nl voor Nederland).

2. Profiel instellen

aws configure --profile hostkey

Voer bij de prompt het volgende in:

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

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. Configuratie verifiëren

aws configure list --profile hostkey

Verwachte uitvoer:

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. Verbinding verifiëren

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

Verwacht resultaat (lijst van uw buckets):

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

Basisbestandoperaties¶

Bucketinhoud bekijken¶

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

Voorbeeld:

aws s3 ls s3://your-bucket-name/ --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¶

Een testbestand aanmaken:

echo Hello HOSTKEY S3 > test.txt

Het bestand naar de bucket uploaden:

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

Voorbeeld:

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

Resultaat:

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

Een bestand downloaden¶

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

Voorbeeld:

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

Resultaat:

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

Gedownload bestand controleren (Windows):

type downloaded.txt

Gedownload bestand controleren (Linux/macOS):

cat downloaded.txt

Een bestand verwijderen¶

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

Voorbeeld:

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

Resultaat:

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

Mappen synchroniseren¶

Een map naar de bucket uploaden:

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

Voorbeeld:

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

Resultaat:

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

Een map uit de bucket downloaden:

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

Met voortgangsweergave:

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

Onjuist (zou een fout veroorzaken):

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

Aanvullende opdrachten¶

Een bucket aanmaken¶

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

Een lege bucket verwijderen¶

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

Een bucket met alle inhoud verwijderen¶

aws s3 rb s3://bucket-name --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-name/old-file.txt s3://bucket-name/new-file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Probleemoplossing¶

Fout: "aws" is geen opdracht¶

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

Oplossing:

1. Herstart de terminal na installatie;
2. Verifieer de installatie met de opdracht 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 rechten.

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: De opdracht where aws toont twee paden.

Oplossing: Verwijder één van de versies (zie de sectie "Installatiemethoden niet mengen").

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\USER_NAME\.aws\credentials
C:\Users\USER_NAME\.aws\config

Linux/macOS:

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

Bestandsinhoud:

• credentials - Access Key en Secret Key;
• config - regio- en uitvoerformaatinstellingen.

Nuttige opdrachten 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