S3 Object Storage HOSTKEY¶

En este artículo

• Descripción del servicio
• Características principales
• Parámetros técnicos
• Acceso desde el navegador y CORS
• Soporte para URLs presignadas
• Precios
• Crear almacenamiento S3
• Panel de control de S3 Storage en Invapi
• Recuperar credenciales de S3 Storage en Invapi
• Gestionar buckets de S3 Storage en Invapi
• Uso mediante S3 Browser
• Operaciones básicas de archivos
• Trabajar con HOSTKEY S3 mediante AWS CLI

Descripción del servicio¶

Características principales¶

• Creación de storages independientes - durante el periodo beta gratuito en el plan Free Beta 1, los usuarios pueden crear hasta 3 buckets de almacenamiento S3 independientes;
• Independencia de VPS/VDS - los storages S3 operan de forma autónoma y no requieren el alquiler de un servidor HOSTKEY;
• Creación de Buckets - al crear un storage, se crea automáticamente el primer bucket con un nombre único. Creación de Buckets: Durante el periodo beta, los usuarios pueden crear hasta 10 buckets en cada S3 storage;
• Acceso compatible con S3 - soporte completo para el protocolo estándar Amazon S3 para todas las operaciones de datos;
• Trabajo con cualquier cliente S3 - utilice S3 Browser, Cyberduck, boto3 y otras herramientas compatibles con S3;

• Acceso seguro - autorización mediante Access Key and Secret Key a través del protocolo HTTPS;

• Gestión sencilla de credenciales - generación y visualización de claves de acceso a través de la interfaz web de su cuenta;

• Planes preconfigurados - elección de planes con volumen de almacenamiento y ancho de banda fijos.

Parámetros técnicos¶

• Endpoint URL: https://s3-nl.hostkey.com;
• Protocolo: HTTPS (SSL/TLS);
• Autorización: AWS Signature Version 4.

Acceso desde el navegador y CORS¶

Al utilizar S3 Object Storage en aplicaciones web (acceso directo desde un navegador mediante fetch/XHR), debe configurar las reglas de CORS en el lado del bucket. Puede configurar las políticas de CORS usted mismo utilizando la API/CLI (método PutBucketCors).

Parámetros recomendados para aplicaciones web:

• Allowed Origins: La URL de su dominio (p. ej., https://your-app.com).
• Allowed Methods: GET, PUT, POST, HEAD.
• Allowed Headers: Authorization, Content-Type, Content-MD5, x-amz-*.
• Expose Headers: ETag (requerido para que Multipart Upload funcione correctamente).

Soporte para URLs presignadas¶

S3 Object Storage admite completamente los mecanismos de acceso temporal:

• URL Presigned GET/PUT: creación de enlaces firmados para la carga y descarga.
• Multipart Upload: soporte para la carga de archivos grandes mediante part-URL y finalización de la operación mediante CompleteMultipartUpload.

Precios¶

El almacenamiento S3 se proporciona bajo modalidad de pago. Puede revisar los planes de precios actuales aquí. También puede aumentar su volumen de almacenamiento y tráfico y pagar mediante la modalidad "pay-as-you-go". El coste del uso adicional se calcula diariamente.

En el momento de realizar el pedido del servicio, los fondos correspondientes a un mes de uso real se deducirán del saldo de su cuenta según los términos del plan de precios seleccionado. Posteriormente, los pagos de los meses siguientes de uso, así como los cargos por exceder los límites de recursos, también se deducirán del saldo de su cuenta.

Para ver su historial de facturación, vaya al menú Balance & Payments en el perfil de usuario dentro de Invapi y navegue hasta la sección Billing Details.

En la sección Billing Details, puede ver el historial de transacciones de todos los servicios adicionales asociados a esta cuenta (Managed Apps, S3), así como el importe total cargado a esta cuenta. Cada cargo de servicio se enumera por separado dentro del ciclo de facturación mensual.

Los estados de facturación se generan el segundo día del mes siguiente al mes de referencia a las 05:00 UTC. Puede revisar los estados de facturación en la sección Balance & Payments en Invapi bajo la pestaña Billing Details. El importe en los estados de facturación se calcula por un mes natural e incluye el coste del uso del servicio. Se puede generar una única factura consolidada que incluya el importe total de todos los servicios adicionales.

Crear almacenamiento S3¶

1. Inicie sesión en su cuenta en Invapi

2. Vaya a la sección S3 Storage;

3. Cree un nuevo almacenamiento:

   

   • Region: seleccione la región (por defecto NL - Países Bajos);
   • Bucket name: introduzca el nombre del bucket (por ejemplo, bde347688-testbucket):
     • el nombre debe ser único;
     • máximo 63 caracteres;
     • solo letras minúsculas, números y guiones;
     • debe empezar y terminar con una letra o un número.
   • Plan: seleccione un plan de precios (por ejemplo, Standart). Para seleccionar, haga clic en el nombre del plan;
   • Haga clic en Create S3 Storage.

Tras crear el almacenamiento, se le pedirá que pague su pedido

Panel de control de S3 Storage en Invapi¶

Tras un pago exitoso, se le redirigirá al panel Your Independent Storages (o seleccionando S3 Storage en el menú de la izquierda), donde podrá:

1. Ver sus almacenamientos pagados y sus tarifas
2. Crear un nuevo almacenamiento S3 independiente
3. Seleccionar un almacenamiento específico de la lista para ver sus detalles
4. Ver estadísticas sobre el volumen de almacenamiento y el uso de tráfico
5. Ver las credenciales para conectarse al almacenamiento

6. Añadir nuevos buckets al almacenamiento actual

7. Ver la lista de buckets añadidos y sus estadísticas

8. Realizar operaciones en los buckets

Recuperar credenciales de S3 Storage en Invapi¶

1. En la lista de sus almacenamientos, busque el almacenamiento creado y vaya a la pestaña Credentials:

   

2. Copie las credenciales:

   Necesitará:

   • Host Name (Endpoint URL): https://s3-nl.hostkey.com;
   • S3 User ID: (p. ej., oab56UivbdcUURCTrMCrcB86YWzyy1hB);
   • Access Key: haga clic en para revelar la clave;
   • Secret Key: haga clic en para revelar la clave.

   Guarde estos datos - serán necesarios para la conexión.

Gestionar buckets de S3 Storage en Invapi¶

Directamente desde la interfaz de almacenamiento S3 en Invapi, están disponibles las siguientes operaciones de bucket:

1. Ver el espacio ocupado por el bucket en el almacenamiento y el número de objetos dentro de él;

2. Eliminar el bucket;

3. Ver el contenido del bucket haciendo clic en la fila con su nombre;
4. Ver información sobre el tamaño del archivo y la fecha de creación para los archivos en el bucket;
5. Buscar archivos en el bucket;
6. Eliminar archivos individuales del bucket.

Uso mediante S3 Browser¶

1. Descargue la versión gratuita de S3 Browser: https://s3browser.com;

2. Añada una nueva cuenta:

   

   • Abra S3 Browser;
   • Haga clic en Accounts >> Add New Account.

3. Complete el formulario:

   • Display name: HOSTKEY S3 (cualquier nombre conveniente);
   • Account type: S3 Compatible Storage (¡no es Amazon S3 Storage!);
   • API endpoint: s3-nl.hostkey.com (sin https://);
   • Access Key ID: pegue su Access Key de su panel HOSTKEY;
   • Secret Access Key: pegue su Secret Key de su panel HOSTKEY;
   • Use secure transfer (SSL/TLS): deje la casilla marcada.

4. Haga clic en Add new account;

5. Trabaje con archivos:

   

   Tras una conexión exitosa, verá:

   • Bucket list a la izquierda;
   • Files in bucket a la derecha;
   • Botones de gestión: Upload, Download, Delete, New Folder, Refresh.

   Operaciones disponibles:

   • Upload - subir archivos;

   • Download - descargar archivos;

   • Delete - eliminar archivos;
   • New Folder - crear carpetas;
   • Refresh - actualizar la lista.

Operaciones básicas de archivos¶

Tras conectarse a un almacenamiento S3 mediante un cliente compatible con S3, las siguientes operaciones están disponibles:

Subir archivos¶

1. A través de S3 Browser:

   • Seleccione un bucket en el panel izquierdo;
   • Haga clic en el botón Upload o Upload folder(s);
   • Seleccione los archivos de su ordenador;
   • Confirme la subida:

   

2. Mediante arrastrar y soltar:

   • Simplemente arrastre los archivos desde el explorador a la ventana de S3 Browser.

Descargar archivos¶

1. Seleccione un archivo en el bucket;

2. Haga clic en el botón Download o haga clic derecho y seleccione Download:

   

3. Especifique la carpeta donde desea guardar el archivo en su ordenador.

Eliminar archivos y carpetas¶

1. Seleccione un archivo o carpeta;

2. Haga clic en el botón Delete o pulse la tecla Delete en el teclado:

   

3. Confirme la eliminación.

Crear estructura de carpetas¶

1. Seleccione un bucket o carpeta;

2. Haga clic en New Folder:

   

3. Introduzca el nombre de la carpeta:

   

4. Haga clic en Create new folder.

Copiar y mover archivos¶

• Copiar: seleccione un archivo > clic derecho > Copy > vaya a la carpeta de destino > clic derecho > Paste;
• Mover: arrastre el archivo a la carpeta deseada manteniendo pulsado el botón del ratón.

Renombrar archivos¶

1. Haga clic derecho en el archivo;

2. Seleccione Rename:

   

3. Introduzca un nuevo nombre;

4. Pulse Enter en el teclado.

Gestionar permisos de acceso (ACL)¶

1. Haga clic derecho en el archivo o bucket;

2. En el menú contextual, seleccione Edit Permissions (ACL):

   

3. En la ventana abierta, configure los permisos de acceso para los usuarios:

   • Owner - control total sobre el objeto;
   • Any AWS Users - acceso para cualquier usuario de AWS;
   • All Users - acceso público para todo el mundo.

4. Para cada categoría de usuario, puede establecer:

   • Full Control - control total;
   • Read - leer el objeto;
   • Write - escribir/modificar el objeto;
   • Read Permissions - permisos de lectura;
   • Write Permissions - permisos de modificación:

   

5. Para una configuración rápida, utilice los botones:

   • Make public - hacer el archivo público;
   • Make private - hacer el archivo privado.

6. Tras la configuración, haga clic en Apply changes para guardar.

Generar enlaces web¶

Para crear un enlace público a un archivo o carpeta en S3 Object Storage:

1. Haga clic derecho en el archivo;

2. En el menú contextual, seleccione Generate Web URL:

   

3. En la ventana abierta Web URL Generator, configure los parámetros de generación del enlace:

4. Use secure transfer (HTTPS) - utilizar una conexión segura (recomendado para datos confidenciales);

5. Expiration - elija el periodo de caducidad del enlace;

6. Hostname - selección del nombre de host:

   • Use default host name - usar la dirección por defecto (p. ej., https://s3-nl.hostkey.com/bfcc62b88-testbucket/);
   • O especifique su propio dominio;

7. Tras configurar los parámetros, el sistema generará un enlace completo al archivo, p. ej.:

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

Acortar el enlace:¶

1. Para crear un un enlace corto, haga clic en el botón Shorten y elija un servicio:

   • Shorten with Bitly - acortar con Bitly;
   • Shorten with TinyURL - acortar con TinyURL;
   • Configure... - configurar servicios de acortamiento;

   

   

2. Tras un acortamiento exitoso, recibirá un enlace corto (p. ej., https://tinyurl.com/2dhcsk8y);

3. Utilice los botones:

   • Copy - copiar el enlace al portapapeles;
   • Close - cerrar la ventana del generador.

   

Trabajar con HOSTKEY S3 mediante AWS CLI¶

Instalación de AWS CLI¶

AWS CLI se puede instalar de dos maneras. Elija una de ellas:

Método 1: Instalación mediante pip (universal)¶

Ventajas:

• Instalación sencilla con un único comando;
• Fácil de actualizar;
• Funciona en todas las plataformas (Windows, Linux, macOS).

Desventajas:

• Requiere tener instalado Python;

• Puede mostrar advertencias en algunas terminales.

Instalación:

pip install awscli boto3

Verificar instalación:

aws --version

pip show awscli boto3

Actualización:

pip install --upgrade awscli boto3

Método 2: Instalador MSI para Windows (recomendado)¶

Ventajas:

• No requiere Python;
• Sin advertencias en la terminal;
• Instalación limpia en el sistema.

Desventajas:

• Solo para Windows;
• Las actualizaciones deben descargarse manualmente.

Instalación mediante terminal:

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

msiexec /i AWSCLIV2.msi /quiet /norestart

Tras la instalación:

1. Reinicie la terminal;
2. Verifique la instalación.

   aws --version
   

   where aws
   

Resultado esperado:

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

Método de instalación alternativo:

• Descarga manual: https://awscli.amazonaws.com/AWSCLIV2.msi;
• Ejecute el instalador haciendo doble clic;
• Reinicie la terminal.

Comprobar conflictos:

where aws

Si muestra múltiples rutas, elimine una de las versiones:

pip uninstall awscli -y

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

Configuración de la conexión a HOSTKEY S3¶

1. Obtención de credenciales desde el panel HOSTKEY

1. Inicie sesión en su cuenta en Invapi;
2. Vaya a la sección S3 Storage;
3. Abra la pestaña "Credentials";

4. Copie los siguientes datos:

   Para el identificador de usuario S3 (Access Key ID):

   • Haga clic en el icono del ojo para revelar la clave;
   • Copie el valor mostrado manualmente o mediante el botón Copy.

   Para la clave secreta (Secret Access Key):

   • Haga clic en el icono del ojo para revelar la clave;
   • Copie el valor mostrado manualmente o mediante el botón Copy.

   Atención

   Primero debe hacer clic en el icono para mostrar los valores reales de las claves; solo después de eso podrán copiarse correctamente.

5. También necesitará:

6. Host name: https://s3-nl.hostkey.com;
7. Region: la que se muestra en el panel (p. ej., nl para los Países Bajos).

2. Configuración del perfil

aws configure --profile hostkey

Cuando se le solicite, introduzca:

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

Ejemplo:

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

3. Verificar configuración

aws configure list --profile hostkey

Salida esperada:

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. Verificar conexión

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

Resultado esperado (lista de sus buckets):

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

Operaciones básicas de archivos¶

Ver el contenido del bucket¶

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

Ejemplo:

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

Resultado:

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

Subir un archivo¶

Crear un archivo de prueba:

echo Hello HOSTKEY S3 > test.txt

Subir el archivo al bucket:

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

Ejemplo:

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

Resultado:

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

Descargar un archivo¶

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

Ejemplo:

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

Resultado:

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

Comprobar archivo descargado (Windows):

type downloaded.txt

Comprobar archivo descargado (Linux/macOS):

cat downloaded.txt

Eliminar un archivo¶

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

Ejemplo:

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

Resultado:

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

Sincronizar carpetas¶

Subir una carpeta al bucket:

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

Ejemplo:

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

Resultado:

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

Descargar una carpeta desde el bucket:

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

Con visualización de progreso:

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

Correcto:

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

Incorrecto (causará un error):

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

Comandos adicionales¶

Crear un bucket¶

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

Eliminar un bucket vacío¶

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

Eliminar un bucket con todo su contenido¶

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

Copiar entre buckets¶

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

Mover un archivo¶

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

Resolución de problemas¶

Error: "aws" no es un comando¶

Causa: AWS CLI no está instalado o no se ha añadido al PATH.

Solución:

1. Reinicie la terminal después de la instalación;
2. Verifique la instalación usando el comando where aws (debería mostrar una ruta);
3. Si eso no ayuda, reinstale AWS CLI.

Error: Nombre de bucket inválido¶

Causa: Nombre de bucket incorrecto.

Solución: Utilice el nombre exacto del bucket desde el panel HOSTKEY (p. ej., prefix-testbucket).

Error: AccessDenied¶

Causa: Credenciales incorrectas o permisos insuficientes.

Solución:

1. Compruebe la Access Key y la Secret Key en el panel HOSTKEY;
2. Recree el perfil.

   aws configure --profile hostkey
   

Conflicto entre las versiones de pip y MSI¶

Síntomas: El comando where aws muestra dos rutas.

Solución: Elimine una de las versiones (consulte la sección "No mezcle métodos de instalación").

Restablecer configuración¶

Windows:

rmdir /S /Q %USERPROFILE%\.aws

Linux/macOS:

rm -rf ~/.aws

Configurar de nuevo:

aws configure --profile hostkey

Ubicación de los archivos de configuración¶

Windows:

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

Linux/macOS:

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

Contenido de los archivos:

• credentials - Access Key y Secret Key;
• config - ajustes de región y formato de salida.

Comandos útiles para verificación¶

Versión de AWS CLI:

aws --version

Ubicación del ejecutable:

where aws

Información del perfil:

aws configure list --profile hostkey

Información del paquete (para la versión pip):

pip show awscli boto3

Actualización (para la versión pip):

pip install --upgrade awscli boto3