Object Storage Service:cp (carga, descarga y copia de objetos)

Nota de uso

Antes de cargar, descargar o copiar, verifique que el usuario RAM o el rol RAM asociado a sus credenciales de acceso cuente con los permisos obligatorios para el bucket y los objetos de destino. Para obtener más detalles, consulte Grant custom policy permissions to RAM users.

Funcionamiento

El comando ossutil cp determina automáticamente si debe cargar, descargar o copiar según los tipos de ruta de origen y destino.

ossutil selecciona un método de transferencia según el tamaño del archivo:

• Los archivos por debajo del umbral de transferencia reanudable se transfieren en una sola operación. El umbral predeterminado es de 100 MB. Modifíquelo con la opción --bigfile-threshold.

• Los archivos que alcanzan o superan el umbral utilizan la transferencia reanudable. Si una transferencia se interrumpe debido a un error de red o a la finalización del proceso, ossutil guarda el progreso y reanuda la operación desde el punto donde se detuvo al ejecutar nuevamente el mismo comando. Si la transferencia no se puede reanudar, las partes incompletas permanecen en el bucket y continúan generando cargos de almacenamiento. Elimínelas manualmente mediante Delete parts o configure lifecycle rules para borrarlas automáticamente.

Cuando falla la transferencia reanudable, ossutil crea un directorio .ossutil_checkpoint para almacenar la información del punto de control. Este directorio se elimina automáticamente cuando finaliza la transferencia. Utilice la opción --checkpoint-dir/@parmname para especificar un directorio diferente para los registros de puntos de control.

Carga de objetos

Utilice el comando cp (upload objects) para cargar archivos locales, imágenes, videos y otros recursos a un bucket.

• Carga de un solo objeto: cargue un archivo desde una ruta local hacia un bucket.

• Carga masiva: cargue un directorio completo, incluidas todas sus subcarpetas y archivos.

• Filtrado por patrón: utilice las opciones --include y --exclude para controlar qué archivos se cargan. Por ejemplo, cargue únicamente archivos .log u omita todos los archivos temporales (.tmp).

Descarga de objetos

Utilice el comando cp (download objects) para descargar objetos de OSS a su sistema local. Las operaciones compatibles incluyen descargas masivas, límites de velocidad de descarga y la descarga de una versión específica desde un bucket con versionado habilitado.

• Descarga de un solo objeto: descargue un objeto específico a una ruta local.

• Descarga masiva: descargue una estructura de directorios completa desde un bucket hacia su sistema local.

• Descarga de una versión específica: si el versionado está habilitado en su bucket, descargue una versión histórica específica de un objeto.

Copia de objetos

Utilice el comando cp (copy objects) para copiar un objeto a otro bucket en la misma región, o a una ruta diferente dentro del mismo bucket. La operación de copia no modifica el contenido del objeto.

• Copia entre buckets: copie un objeto de un bucket a otro dentro de la misma región.

• Copia dentro del mismo bucket (mover o renombrar): copie un objeto de una ruta a otra dentro del mismo bucket. Para simular una operación de movimiento o cambio de nombre, copie el objeto a la nueva ruta y luego elimine el origen.

El comando ossutil cp no puede copiar objetos entre regiones. Para replicar objetos entre buckets de diferentes regiones, utilice Cross-Region Replication (CRR).

Aplicación en producción

Ajuste del rendimiento simultáneo

Ajuste las opciones -j, --jobs/@parmname y --parallel/@parmname si la concurrencia predeterminada no satisface sus requisitos de throughput. De forma predeterminada, ossutil calcula --parallel según el tamaño del archivo. En transferencias masivas de archivos grandes, la concurrencia efectiva equivale al número de trabajos multiplicado por el valor de parallel.

• Si el servidor o la instancia de Elastic Compute Service (ECS) que ejecuta ossutil tiene recursos limitados —como ancho de banda de red, memoria o CPU— reduzca los valores de concurrencia. Si los recursos están subutilizados, increméntelos gradualmente.

• Configurar una concurrencia demasiado alta puede degradar el rendimiento debido a la sobrecarga por cambio de hilos y la contención de recursos, además de provocar errores EOF. Comience con un valor bajo durante las pruebas de rendimiento y auméntelo poco a poco hasta encontrar la configuración óptima para -j, --jobs/@parmname y --parallel/@parmname.

Limitación de tasas de transferencia

Utilice las opciones --maxupspeed o --maxdownspeed para limitar el ancho de banda de carga o descarga y evitar que ossutil sature su conexión de red.

Referencias

• cp (upload objects)

• cp (download objects)

• cp (copy objects)