Download and install the command-line tool ossutil - Object Storage Service

ossutil es una herramienta de línea de comandos que permite cargar archivos grandes, descargar archivos y eliminar archivos con un prefijo específico de forma rápida. ossutil se ejecuta en sistemas operativos como Windows, Linux y macOS. Descargue e instale la versión adecuada para su entorno.

Nueva versión disponible

Se recomienda utilizar la versión mejorada ossutil 2.0. Para obtener más información sobre cómo instalarla y usarla rápidamente, consulte Install ossutil. ossutil 1.0 ya no recibe actualizaciones. Las nuevas funciones y optimizaciones solo están disponibles en ossutil 2.0.

Funciones principales de ossutil 2.0:

Nueva estructura de comandos: Admite comandos multinivel, incluidos comandos a nivel de API como ossutil api put-bucket-acl y comandos de alto nivel como ossutil config.
Gestión de configuración mejorada: El proceso de configuración inicial se ha simplificado. Solo necesita proporcionar el AccessKey ID, el AccessKey secret y el ID de región para completar la configuración básica después de la instalación. También puede usar el parámetro --profile para especificar varios archivos de configuración y obtener mayor flexibilidad.
Más parámetros de filtro: Para comandos de procesamiento por lotes como ls, cp y rm, se admiten diversas condiciones de filtro basadas en ruta, tamaño de archivo, hora de modificación y metadatos del objeto. Esta compatibilidad mejora significativamente la precisión y eficiencia de las operaciones.
Formatos de salida flexibles: El parámetro --output-format permite establecer el formato de salida en JSON, YAML o XML para satisfacer distintos requisitos de procesamiento de datos. La opción --output-query permite filtrar la salida para recuperar la información necesaria.
Seguridad reforzada: Para mejorar la seguridad, ossutil 2.0 permite configurar parámetros sensibles mediante variables de entorno. Esto evita la exposición de claves en la línea de comandos y reduce el riesgo de fugas de datos. Además, la opción --dry-run permite verificar el comportamiento de un comando antes de ejecutarlo, lo que ayuda a prevenir operaciones no deseadas.

Versiones

Versión actual: 1.7.19
Versiones anteriores: Para obtener más información sobre el código fuente y el historial de versiones de ossutil, consulte GitHub.

Enlaces de descarga

Enlace de descarga	Suma de comprobación SHA-256
Linux x86 32-bit	f8a4a7e1df8529b06a3f3cca194a1c99163cb3b8ab3b5d64228c207c3ae63b86
Linux x86 64-bit	dcc512e4a893e16bbee63bc769339d8e56b21744fd83c8212a9d8baf28767343
Linux ARM 32-bit	ffe8b479e5fd3c0e146a14cd32e8ef5736d23f6c8de157944288ee09db2d7b1d
Linux ARM 64-bit	f612c2a88d4d28363e254168d521fac5df632f2547ba84eaebacf6497dc04d57
macOS 64-bit	9cf82a53fe24d8b5cc3dfb441787e0ea19c24dd7a1246653d5f1a28b7923d6fe
macOS ARM 64-bit	10ece4d328c5d2440833adc5f4167168e9b2a4c5d364f673b0c45bcc4fd02ec5
Windows x86 32-bit	772469ef02b91e893f7211acf732c2c07cd93214552ed7cf84157d3d9b9fb799
Windows x86 64-bit	8e9176aedc87d230ccd97dc7236b16564f2a068609ed301acdc73dc27faf7e77

Descarga e instalación de ossutil

Linux

Instale ossutil.
```
sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
```
Nota
- Debe descomprimir el paquete de ossutil antes de la instalación. Asegúrese de tener instalada una herramienta de descompresión, como unzip o 7z.
- De forma predeterminada, ossutil se instala en el directorio /usr/bin/.

Configure ossutil.

Introduzca el comando de configuración.
```
ossutil config
```
Cuando se le solicite, configure la ruta del archivo de configuración.
```
Please enter the config file name. The file name can include a path. (Default: /home/user/.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
De forma predeterminada, ossutil guarda el archivo de configuración en /home/user/.ossutilconfig. Si especifica una ruta diferente para el archivo de configuración, debe agregar la opción -c para indicar dicho archivo cada vez que ejecute un comando de ossutil. Por ejemplo, si guarda el archivo de configuración en /home/config, ejecute el comando ls con el siguiente formato e incluya la opción -c:
```
ossutil ls oss://examplebucket -c /home/config
```
Cuando se le solicite, establezca el idioma de la herramienta. Introduzca CH para chino o EN para inglés. De forma predeterminada, la herramienta utiliza el idioma de su sistema operativo. Esta configuración surte efecto después de ejecutar correctamente el comando config.
Establezca el idioma de la herramienta.

Introduzca CH o EN. De forma predeterminada, la herramienta utiliza el mismo idioma que su sistema operativo. Esta configuración surte efecto después de ejecutar el comando config.

Cuando se le solicite, configure los parámetros Endpoint, AccessKey ID, AccessKey secret y STSToken. El parámetro STSToken solo es necesario cuando se utilizan credenciales temporales del Security Token Service (STS) para acceder a OSS. De lo contrario, deje este parámetro vacío.

Los parámetros se describen a continuación:

Parámetro	Obligatorio	Descripción
endpoint	Sí	Introduzca el endpoint de la región donde se encuentra su bucket. Por ejemplo, establezca el endpoint público en para la región o `https://oss-ap-southeast-1.aliyuncs.com` para la región Singapore. Para acceder a OSS desde otros servicios de Alibaba Cloud en la misma región, utilice un endpoint interno, como o `https://oss-ap-southeast-1-internal.aliyuncs.com`. Para obtener más información sobre los endpoints de cada región, consulte Regions and endpoints. Importante Debido a un cambio de directiva para mejorar el cumplimiento y la seguridad, a partir del 20 de marzo de 2025, los nuevos usuarios de OSS deben use a custom domain name (CNAME) para realizar operaciones de API de datos en buckets de OSS ubicados en regiones de China continental. Los endpoints públicos predeterminados están restringidos para estas operaciones. Consulte el anuncio oficial para obtener una lista completa de las operaciones afectadas. Si accede a sus datos mediante HTTPS, debe bind a valid SSL Certificate a su dominio personalizado. Esto es obligatorio para el acceso a la consola de OSS, ya que la consola exige HTTPS.
accessKeyID	Sí	Introduzca el par de AccessKey de su cuenta. Para obtener más información sobre cómo conseguir un par de AccessKey, consulte Create an AccessKey pair. Creación rápida de un par de AccessKey para un usuario de RAM con permisos de gestión de OSS mediante un script de ROS En la página Create Stack de la consola de Resource Orchestration Service (ROS), seleccione la casilla de confirmación en la sección Security Confirmation y luego haga clic en Create. Para obtener más información, consulte Create a stack. Una vez creada la pila, copie el par de AccessKey generado desde la pestaña Outputs. La lista de resultados contiene dos elementos: AccessKeySecret y AccessKeyId. Copie sus valores correspondientes respectivamente.
accessKeySecret	Sí
stsToken	No	Este parámetro solo es necesario cuando se utilizan credenciales de acceso temporales para acceder a OSS. De lo contrario, deje este parámetro vacío. Para obtener más información sobre cómo generar un token de STS, consulte AssumeRole.

Compruebe que ossutil esté instalado.
```
ossutil
```
Si se muestra una lista de comandos compatibles de ossutil, la instalación se completó correctamente.

Windows

Instale ossutil.
1. Haga clic en el enlace de descarga para obtener el paquete de instalación de Windows.
2. Descomprima el paquete y haga doble clic en el archivo ossutil.bat.

Configure ossutil.

Introduzca el comando de configuración.
```
ossutil config
```
Cuando se le solicite, establezca la ruta del archivo de configuración.
```
Please enter the config file name. The file name can include a path. (Default: C:\\Users\user\.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
De forma predeterminada, ossutil guarda el archivo de configuración en C:\\Users\user\.ossutilconfig. Si especifica una ruta diferente para el archivo de configuración, debe agregar la opción -c para indicar dicho archivo cada vez que ejecute un comando. Por ejemplo, si el archivo de configuración se guarda en c:\ossutil\config, ejecute el comando ls con el siguiente formato:
```
ossutil ls oss://examplebucket -c c:\ossutil\config
```
Cuando se le solicite, establezca el idioma de la herramienta. Introduzca CH para chino o EN para inglés. De forma predeterminada, la herramienta utiliza el idioma de su sistema operativo. Esta configuración surte efecto después de ejecutar el comando config.

Cuando se le solicite, configure los parámetros Endpoint, AccessKey ID, AccessKey secret y STSToken. El parámetro STSToken solo es necesario cuando se utilizan credenciales temporales de STS para acceder a OSS. De lo contrario, deje este parámetro vacío.

La siguiente tabla describe los parámetros.

Parámetro	Obligatorio	Descripción
endpoint	Sí	Introduzca el endpoint de la región donde se encuentra su bucket. Por ejemplo, establezca el endpoint público en para la región o `https://oss-ap-southeast-1.aliyuncs.com` para la región Singapore. Para acceder a OSS desde otros servicios de Alibaba Cloud en la misma región, utilice un endpoint interno, como o `https://oss-ap-southeast-1-internal.aliyuncs.com`. Para obtener más información sobre los endpoints de cada región, consulte Regions and endpoints. Importante Debido a un cambio de directiva para mejorar el cumplimiento y la seguridad, a partir del 20 de marzo de 2025, los nuevos usuarios de OSS deben use a custom domain name (CNAME) para realizar operaciones de API de datos en buckets de OSS ubicados en regiones de China continental. Los endpoints públicos predeterminados están restringidos para estas operaciones. Consulte el anuncio oficial para obtener una lista completa de las operaciones afectadas. Si accede a sus datos mediante HTTPS, debe bind a valid SSL Certificate a su dominio personalizado. Esto es obligatorio para el acceso a la consola de OSS, ya que la consola exige HTTPS.
accessKeyID	Sí	Introduzca el par de AccessKey de su cuenta. Para obtener más información sobre cómo conseguir un par de AccessKey, consulte Create an AccessKey pair. Creación rápida de un par de AccessKey para un usuario de RAM con permisos de gestión de OSS mediante un script de ROS En la página Create Stack de la consola de Resource Orchestration Service (ROS), seleccione la casilla de confirmación en la sección Security Confirmation y luego haga clic en Create. Para obtener más información, consulte Create a stack. Una vez creada la pila, copie el par de AccessKey generado desde la pestaña Outputs. Las palabras clave de salida incluyen AccessKeyId y AccessKeySecret. Copie sus valores correspondientes respectivamente y guárdelos en un lugar seguro.
accessKeySecret	Sí
stsToken	No	Este parámetro solo es necesario cuando se utilizan credenciales de acceso temporales para acceder a OSS. De lo contrario, deje este parámetro vacío. Para obtener más información sobre cómo generar un token de STS, consulte AssumeRole.

Compruebe que ossutil esté instalado.
```
ossutil
```
Si se muestra una lista de comandos compatibles de ossutil, la instalación se completó correctamente.

macOS

Instale ossutil.
```
sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
```
Nota
El directorio de instalación predeterminado es /usr/local/bin.

Configure ossutil.

Introduzca el comando de configuración.
```
ossutil config
```
Cuando se le solicite, establezca la ruta del archivo de configuración.
```
Please enter the config file name. The file name can include a path. (Default: /Users/user/.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
De forma predeterminada, ossutil guarda el archivo de configuración en /Users/user/.ossutilconfig.

Si especifica una ruta diferente para el archivo de configuración, debe agregar la opción -c para indicar dicho archivo cada vez que ejecute un comando. Por ejemplo, si el archivo de configuración se guarda en /home/config, ejecute el comando ls con el siguiente formato:
```
ossutil ls oss://examplebucket -c /home/config
```
Cuando se le solicite, establezca el idioma de la herramienta. Introduzca CH para chino o EN para inglés. De forma predeterminada, la herramienta utiliza el idioma de su sistema operativo. Esta configuración surte efecto después de ejecutar el comando config.

Cuando se le solicite, configure los parámetros Endpoint, AccessKey ID, AccessKey secret y STSToken. El parámetro STSToken solo es necesario cuando se utilizan credenciales temporales de STS para acceder a OSS. De lo contrario, deje este parámetro vacío.

La siguiente tabla describe los parámetros.

Parámetro	Obligatorio	Descripción
endpoint	Sí	Introduzca el endpoint de la región donde se encuentra su bucket. Por ejemplo, establezca el endpoint público en para la región o `https://oss-ap-southeast-1.aliyuncs.com` para la región Singapore. Para acceder a OSS desde otros servicios de Alibaba Cloud en la misma región, utilice un endpoint interno, como o `https://oss-ap-southeast-1-internal.aliyuncs.com`. Para obtener más información sobre los endpoints de cada región, consulte Regions and endpoints. Importante Debido a un cambio de directiva para mejorar el cumplimiento y la seguridad, a partir del 20 de marzo de 2025, los nuevos usuarios de OSS deben use a custom domain name (CNAME) para realizar operaciones de API de datos en buckets de OSS ubicados en regiones de China continental. Los endpoints públicos predeterminados están restringidos para estas operaciones. Consulte el anuncio oficial para obtener una lista completa de las operaciones afectadas. Si accede a sus datos mediante HTTPS, debe bind a valid SSL Certificate a su dominio personalizado. Esto es obligatorio para el acceso a la consola de OSS, ya que la consola exige HTTPS.
accessKeyID	Sí	Introduzca el par de AccessKey de su cuenta. Para obtener más información sobre cómo conseguir un par de AccessKey, consulte Create an AccessKey pair. Creación rápida de un par de AccessKey para un usuario de RAM con permisos de gestión de OSS mediante un script de ROS En la página Create Stack de la consola de Resource Orchestration Service (ROS), seleccione la casilla de confirmación en la sección Security Confirmation y luego haga clic en Create. Para obtener más información, consulte Create a stack. Una vez creada la pila, copie el par de AccessKey generado desde la pestaña Outputs. Las palabras clave de salida incluyen AccessKeyId y AccessKeySecret. Copie sus valores correspondientes respectivamente y guárdelos en un lugar seguro.
accessKeySecret	Sí
stsToken	No	Este parámetro solo es necesario cuando se utilizan credenciales de acceso temporales para acceder a OSS. De lo contrario, deje este parámetro vacío. Para obtener más información sobre cómo generar un token de STS, consulte AssumeRole.

Compruebe que ossutil esté instalado.
```
ossutil
```
Si se muestra una lista de comandos compatibles de ossutil, la instalación se completó correctamente.

Referencias

Después de instalar ossutil, puede utilizarlo para cargar, descargar, copiar y eliminar objetos. Para obtener más información, consulte cp (upload objects), cp (download objects), cp (copy objects) y rm (delete objects).