Configuración inicial de ossutil
Para comenzar a gestionar los recursos de Object Storage Service (OSS) en Windows, es necesario descargar el paquete ejecutable y realizar la configuración del entorno. Una vez extraído el contenido del archivo comprimido, se debe ejecutar el archivo ossutil.bat para iniciar la terminal interactiva.
El primer paso consiste en establecer las credenciales de aceso mediante el siguiente comando:
ossutil config
Durante este proceso, el sistema solicitará los siguientes datos:
- Ruta del archivo de configuración: Por defecto se ubica en
C:\Users\nombre_usuario\.ossutilconfig. Si decide utilizar una ruta personalizada, deberá incluir el parámetro--config-fileo-cen cada ejecución posterior. - Idioma: Selección entre
CH(Chino) oEN(Inglés). - Credenciales de API: Endpoint regional, AccessKey ID y AccessKey Secret.
Para verificar que la herramienta está correctamente vinculada, ejecute el comando base sin argumentos:
ossutil
Parámetros de conexión requeridos
Al configurar la herramienta, es fundamental proporcionar valores precisos para garantizar la conectividad con los buckets de Alibaba Cloud:
| Parámetro | Descripción |
|---|---|
| endpoint | La dirección del centro de datos donde reside el bucket. Se puede especificar el protocolo https:// para conexiones seguras (ej. https://oss-cn-shanghai.aliyuncs.com). |
| accessKeyID | Identificador de la clave de acceso de la cuenta RAM o cuenta principal. |
| accessKeySecret | Clave secreta asociada al AccessKey ID. |
| stsToken | Token de seguridad temporal. Solo es necesario si se utiliza acceso mediante el servicio STS (Secruity Token Service). |
Comandos prácticos para la administración de archivos
A continuación, se presentan ejemplos comunes de uso para la transferencia y gestión de objetos dentro de los buckets:
Descarga recursiva de un directorio:
Este comando transfiere todos los archivos desde un bucket remoto hacia una unidad local.
ossutil.exe cp oss://mi-bucket-ejemplo/datos/ D:\Backup\Local -r
Sincronización incremental (omitir archivos existentes):
Utilizando la bandera -u, la herramienta solo descargará aquellos archivos que hayan sido modificados o que no existan en el destino local.
ossutil.exe cp oss://mi-bucket-ejemplo/multimedia/ C:\Proyectos\Assets -r -u
Eliminación de directorios en la nube:
Para borrar una carpeta completa y su contenido dentro del bucket de forma recursiva:
ossutil.exe rm oss://mi-bucket-ejemplo/temporal/ -r --recursive
Eliminación de un Bucket:
Si desea eliminar un bucket por completo (asegúrese de que esté vacío o use los flags correspondientes):
ossutil.exe rm oss://bucket-obsoleto -b