Object Storage Service:cp (Download objects)

Acción de API

Descripción

oss:GetObject

Obligatorio para descargar un objeto.

oss:GetObjectVersion

Opcional. Obligatorio para descargar una versión específica de un objeto de origen mediante la opción --version-id.

kms:GenerateDataKey

Opcional. Obligatorio si el objeto descargado se cifra en el servidor mediante KMS.

kms:Decrypt

oss:ListObjects

Opcional. Obligatorio para descargas por lotes (operaciones recursivas).

Parámetro

Descripción

cloud_url

Ruta de origen del objeto de OSS. El formato es oss://bucket[/prefix]. Por ejemplo, oss://examplebucket/examplefile.txt.

file_url

Ruta de destino del archivo local. Si el destino es un directorio, la ruta debe terminar con un separador (/ o \). Por ejemplo, una ruta de Linux es /localfolder/examplefile.txt y una ruta de Windows es D:\localfolder\examplefile.txt.

-r, --recursive

Aplica la operación de forma recursiva a todos los objetos coincidentes bajo el prefijo especificado. De lo contrario, la operación se aplica únicamente al objeto indicado.

-f --force

Fuerza la ejecución de la operación sin solicitar confirmación.

-u，--update

Ejecuta la descarga solo si el archivo de destino no existe o si la última modificación del objeto de origen es posterior a la del archivo de destino.

--maxdownspeed

Velocidad máxima de descarga en KB/s. El valor predeterminado es 0, lo que significa que no hay límite de velocidad.

--disable-ignore-error

Deshabilita la omisión de errores durante las operaciones por lotes.

--only-current-dir

Descarga únicamente los objetos del directorio actual e ignora los subdirectorios y su contenido.

--bigfile-threshold

Umbral de tamaño en bytes para iniciar una descarga reanudable.

Valor predeterminado: 100 MB

Rango de valores: de 0 a 9223372036854775807

--part-size

Tamaño de cada parte en bytes. De forma predeterminada, ossutil calcula automáticamente un tamaño adecuado según el tamaño del objeto.

Rango de valores: de 1 a 9223372036854775807

--checkpoint-dir

Directorio donde ossutil almacena la información de puntos de control para una descarga reanudable. Si la descarga reanudable falla, ossutil crea el directorio .ossutil_checkpoint para registrar dicha información. Una vez que la descarga finaliza correctamente, ossutil elimina este directorio. Asegúrese de que el directorio especificado se pueda eliminar.

--range

Descarga un rango de bytes específico del objeto y lo guarda como un archivo nuevo. La numeración de los bytes comienza en cero.

• Especifique un rango

  Por ejemplo, 3-9 descarga desde el byte 3 hasta el byte 9, ambos incluidos.

• Especifique una posición inicial

  Por ejemplo, 3- descarga desde el byte 3 hasta el final del objeto, incluido.

• Especifique una posición final

  Por ejemplo, -9 descarga desde el byte 0 hasta el byte 9, ambos incluidos.

--encoding-type

Tipo de codificación del nombre del objeto. Establezca esta opción en url. Si no se especifica, el nombre del objeto no se codifica.

--include

Incluye todos los objetos que coinciden con el patrón especificado.

Para más información, consulte include and exclude options.

--exclude

Excluye todos los objetos que coinciden con el patrón especificado.

Para más información, consulte include and exclude options.

--meta

Establece los metadatos del objeto. El formato es header:value#header:value. Ejemplo: Cache-Control:no-cache#Content-Encoding:gzip. Para más información sobre los metadatos, consulte set-meta (Manage object metadata).

--acl

Lista de control de acceso (ACL) del objeto. Valores válidos:

• default (predeterminado): el objeto hereda la ACL del bucket.

• private: solo el propietario del bucket tiene permisos de lectura y escritura. Los demás usuarios no pueden acceder a los objetos del bucket.

• public-read: solo el propietario del bucket tiene permisos de escritura. Todos los demás usuarios, incluidos los anónimos, tienen permisos de solo lectura sobre los objetos del bucket. Esta configuración puede provocar filtraciones de datos y un aumento en los costos. Úsela con precaución.

• public-read-write: cualquier persona, incluidos los usuarios anónimos, puede leer y escribir objetos en el bucket. Esto puede generar filtraciones de datos, costos adicionales y posibles responsabilidades legales si se carga contenido malicioso. Salvo en casos de uso específicos, no configure permisos públicos de lectura y escritura.

--snapshot-path

Directorio donde se guarda la información de la instantánea durante la descarga. En la siguiente descarga, ossutil lee esta información desde dicho directorio para ejecutar una descarga incremental.

--disable-crc64

Deshabilita la verificación de redundancia cíclica de 64 bits (CRC-64). De forma predeterminada, ossutil habilita CRC-64 en todas las transferencias de datos.

--payer

Método de pago de la solicitud. Para que quien realiza la solicitud asuma el costo del tráfico y de las peticiones generadas al acceder a la ruta indicada, establezca esta opción en requester.

--partition-download

Especifica la partición del objeto que se va a descargar. El valor sigue el formato Partition number:Total partitions. Por ejemplo, 1:5 indica que este comando de ossutil descarga la partición 1 de un total de 5. La numeración de las particiones comienza en 1. El algoritmo interno de la herramienta determina cómo se divide el objeto. Esta opción le permite dividir un objeto en varias particiones y descargarlas en paralelo mediante múltiples comandos de ossutil. Cada comando descarga la partición asignada.

-j，--job

Número de tareas simultáneas para operaciones con varios objetos. Valor predeterminado: 3. Rango de valores: de 1 a 10 000.

--parallel

Número de tareas simultáneas para operaciones con un solo objeto. Rango de valores: de 1 a 10 000. Si no se establece esta opción, ossutil determina el valor según el tipo de operación y el tamaño del objeto.

--version-id

Descarga una versión específica de un objeto. Utilice la opción --version-id únicamente con buckets que tengan el control de versiones habilitado. Para habilitar el control de versiones en un bucket, consulte bucket-versioning (Versioning).

--start-time

Marca de tiempo UNIX. Si especifica esta opción, se ignoran los objetos cuya última modificación sea anterior a dicha marca de tiempo.

--end-time

Marca de tiempo UNIX. Si especifica esta opción, se ignoran los objetos cuya última modificación sea posterior a dicha marca de tiempo.