Almacenamiento de objetos S3 HOSTKEY¶

En este artículo

• Descripción del servicio
• Características principales
• Parámetros técnicos
• Precios
• Creación de almacenamiento S3
• Panel de control de almacenamiento S3 en Invapi
• Obtención de credenciales de almacenamiento S3 en Invapi
• Gestión de cubos de almacenamiento S3 en Invapi
• Uso mediante S3 Browser
• Operaciones básicas con archivos
• Trabajo con HOSTKEY S3 mediante AWS CLI

Descripción del servicio¶

Características principales¶

• Creación de almacenamientos independientes: durante el período de beta gratuita en el plan Free Beta 1, los usuarios pueden crear hasta 3 cubos (buckets) de almacenamiento S3 independientes;
• Independencia de VPS/VDS: los almacenamientos S3 operan de forma autónoma y no requieren el alquiler de un servidor HOSTKEY;
• Creación de cubos (Buckets): al crear un almacenamiento, se crea automáticamente el primer cubo con un nombre único. Creación de cubos: durante el período de beta, los usuarios pueden crear hasta 10 cubos en cada almacenamiento S3;
• Acceso compatible con S3: soporte completo para el protocolo estándar de 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 y 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¶

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

Precios¶

El almacenamiento S3 se proporciona de forma pagada. Puede consultar los planes de precios actuales aquí. También puede aumentar su volumen de almacenamiento y tráfico y pagar bajo el esquema "pague según su uso". El costo del uso adicional se calcula diariamente.

En el momento del pedido del servicio, se descontarán fondos de su saldo de cuenta por un mes de uso real según los términos del plan de precios seleccionado. Los pagos mensuales posteriores, así como los cargos por exceder los límites de recursos, también se descontarán de su saldo de cuenta.

Los documentos de facturación se generan el día 2 del mes siguiente al mes de facturación a las 05:00 UTC. Puede ver los documentos de facturación en la sección Billing de Invapi. El importe en los documentos de facturación cubre el mes calendario e incluye el costo del uso del servicio, así como todos los cargos adicionales por exceder los límites de recursos.

Creación de 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 cubo (por ejemplo, bde347688-testbucket):
     • el nombre debe ser único;
     • máximo 63 caracteres;
     • solo letras minúsculas, números y guiones;
     • debe comenzar 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.

Después de crear el almacenamiento, se le pedirá que pague su pedido.

Panel de control de almacenamiento S3 en Invapi¶

Después de un pago exitoso, será redirigido al panel Your Independent Storages (o seleccionando S3 Storage en el menú superior), donde puede:

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 uso de volumen de almacenamiento y tráfico
5. Ver las credenciales para conectarse al almacenamiento
6. Agregar nuevos cubos al almacenamiento actual
7. Ver la lista de cubos agregados y sus estadísticas
8. Realizar operaciones en los cubos

Obtención de credenciales de almacenamiento S3 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: (por ejemplo, oab56UivbdcUURCTrMCrcB86YWzyy1hB);
   • Access Key: haga clic en para revelar la clave;
   • Secret Key: haga clic en para revelar la clave.

   Atención

   Debe hacer clic primero en el icono para mostrar los valores reales de las claves antes de poder copiarlas correctamente.

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

Gestión de cubos de almacenamiento S3 en Invapi¶

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

1. Ver el espacio ocupado por el cubo en el almacenamiento y el número de objetos dentro de él;
2. Eliminar el cubo;
3. Ver el contenido del cubo haciendo clic en la fila con su nombre;
4. Ver información sobre el tamaño del archivo y la fecha de creación de los archivos en el cubo;
5. Buscar archivos en el cubo;
6. Eliminar archivos individuales del cubo.

Uso mediante S3 Browser¶

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

2. Agregue 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 Amazon S3 Storage!);
   • API endpoint: s3-nl.hostkey.com (sin https://);
   • Access Key ID: pegue su Access Key desde el panel de HOSTKEY;
   • Secret Access Key: pegue su Secret Key desde el panel de HOSTKEY;
   • Use secure transfer (SSL/TLS): deje la casilla activa.

4. Haga clic en Add new account;

5. Trabaje con archivos:

   

   Después de una conexión exitosa, verá:

   • Lista de cubos a la izquierda;
   • Archivos en el cubo a la derecha;
   • Botones de gestión: Upload, Download, Delete, New Folder, Refresh.

   Operaciones disponibles:

   • Upload - cargar archivos;
   • Download - descargar archivos;
   • Delete - eliminar archivos;
   • New Folder - crear carpetas;
   • Refresh - actualizar la lista.

Operaciones básicas con archivos¶

Después de conectarse a un almacenamiento S3 a través de un cliente compatible con S3, están disponibles las siguientes operaciones:

Carga de archivos¶

1. A través de S3 Browser:

   • Seleccione un cubo en el panel izquierdo;
   • Haga clic en el botón Upload o Upload folder(s);
   • Seleccione archivos de su computadora;
   • Confirme la carga:

   

2. A través de arrastrar y soltar:

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

Descarga de archivos¶

1. Seleccione un archivo en el cubo;

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

   

3. Especifique la carpeta para guardar el archivo en su computadora.

Eliminación de archivos y carpetas¶

1. Seleccione un archivo o carpeta;

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

   

3. Confirme la eliminación.

Creación de estructura de carpetas¶

1. Seleccione un cubo o carpeta;

2. Haga clic en New Folder:

   

3. Introduzca el nombre de la carpeta:

   

4. Haga clic en Create new folder.

Copia y movimiento de 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 presionado el botón del ratón.

Renombrar archivos¶

1. Haga clic derecho en el archivo;

2. Seleccione Rename:

   

3. Introduzca un nuevo nombre;

4. Presione Enter en el teclado.

Gestión de permisos de acceso (ACL)¶

1. Haga clic derecho en el archivo o cubo;

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 todos.

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

   • Full Control - control total;
   • Read - leer el objeto;
   • Write - escribir/modificar el objeto;
   • Read Permissions - leer permisos de acceso;
   • Write Permissions - modificar permisos de acceso:

   

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

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

6. Después de la configuración, haga clic en Apply changes para guardar.

Generación de enlaces web¶

Para crear un enlace público a un archivo o carpeta en el almacenamiento de objetos S3:

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 período de expiración del enlace;

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

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

7. Después de configurar los parámetros, el sistema generará un enlace completo al archivo, por ejemplo:

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

Acortamiento del enlace:¶

1. Para crear 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. Después de un acortamiento exitoso, recibirá un enlace corto (por ejemplo, https://tinyurl.com/2dhcsk8y);

3. Utilice los botones:

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

   

Trabajo 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 solo comando;
• Fácil de actualizar;
• Funciona en todas las plataformas (Windows, Linux, macOS).

Desventajas:

• Requiere Python instalado;
• Puede mostrar advertencias en algunas terminales.

Instalación:

pip install awscli boto3

Verificar instalación:

aws --version

pip show awscli boto3

Actualizar:

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

Después de 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 alternativo de instalación:

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

Comprobar conflictos:

where aws

Si muestra varias 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 de 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

   Debe hacer clic primero en el icono para mostrar los valores reales de las claves; solo después de eso pueden copiarse correctamente.

5. También necesitará:

6. Nombre de host: https://s3-nl.hostkey.com;
7. Región: mostrada en el panel (por ejemplo, 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 cubos):

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

Operaciones básicas con archivos¶

Visualización del contenido del cubo¶

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

Carga de un archivo¶

Crear un archivo de prueba:

echo Hello HOSTKEY S3 > test.txt

Cargar el archivo al cubo:

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

Descarga de 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

Eliminación de 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

Sincronización de carpetas¶

Carga de una carpeta al cubo:

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

Descarga de una carpeta desde el cubo:

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 del 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¶

Creación de un cubo¶

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

Eliminación de un cubo vacío¶

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

Eliminación de un cubo con todo su contenido¶

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

Copia entre cubos¶

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

Movimiento de 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

Solución de problemas¶

Error: "aws" no es un comando¶

Causa: AWS CLI no está instalado o no se ha añadido a 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 cubo no válido¶

Causa: Nombre de cubo incorrecto.

Solución: Utilice el nombre exacto del cubo desde el panel de HOSTKEY (por ejemplo, prefix-testbucket).

Error: AccessDenied¶

Causa: Credenciales incorrectas o permisos insuficientes.

Solución:

1. Compruebe la Access Key y la Secret Key en el panel de HOSTKEY;
2. Vuelva a crear el perfil.

   aws configure --profile hostkey
   

Conflicto entre versiones pip y MSI¶

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

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

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

Linux/macOS:

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

Contenido de los archivos:

• credentials - Access Key y Secret Key;
• config - configuración 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

Actualizar (para la versión pip):

pip install --upgrade awscli boto3