Object Storage Service:cp (descargue archivos)

Parámetro

Tipo

Descripción

local-path

string

Admite rutas relativas, absolutas y -. Si se establece en -, la salida se dirige a la salida estándar.

prefix

string

Prefijo del objeto. Si termina con "/", solo se admiten operaciones por lotes. De lo contrario, el comando determina si realiza una descarga individual o por lotes según las opciones de la línea de comandos.

--acl

string

Permisos de acceso del objeto. Valores válidos:

• private: privado.

• public-read: lectura pública.

• public-read-write: lectura y escritura públicas.

• default: hereda la configuración del bucket.

--bandwidth-limit

SizeSuffix

Limita el ancho de banda de red para controlar la tasa de transferencia de datos. El valor mínimo es 1024 B/s. La unidad predeterminada es B/s.

Puede especificar una unidad para el valor de ancho de banda. Las unidades compatibles incluyen B (bytes), K (kilobytes), M (megabytes) y G (gigabytes). Por ejemplo, 50 M establece el límite en 50 MB/s.

--bigfile-threshold

SizeSuffix

Umbral para habilitar la carga, descarga o copia multiparte de archivos grandes (valor predeterminado: 104857600).

--cache-control

string

Especifica el comportamiento de caché cuando un navegador web descarga el objeto.

--checkers

int

Número de verificadores concurrentes (valor predeterminado: 16).

--checkpoint-dir

string

Directorio para almacenar la información de puntos de control de descargas reanudables (valor predeterminado: .ossutil_checkpoint/).

--content-disposition

string

Especifica cómo se muestra el objeto.

--content-encoding

string

Declara el método de codificación del objeto.

--content-type

string

Tipo de contenido del objeto.

--copy-props

string

Controla cómo se copian los metadatos y las etiquetas. Valores válidos:

• none: no copiar.

• metadata: copiar metadatos.

• default: copiar tanto metadatos como etiquetas.

-d, --dirs

string

Descarga archivos y subdirectorios del directorio actual sin descargar recursivamente todos los archivos de los subdirectorios anidados.

--encoding-type

string

Método de codificación para los nombres de objetos o archivos de entrada. Valor válido: url.

--end-with

string

Devuelve los objetos que anteceden o coinciden con el valor especificado en orden alfabético.

--exclude

stringArray

Reglas de exclusión para rutas o nombres de archivos.

--exclude-from

stringArray

Lee reglas de exclusión desde un archivo.

--expires

string

Especifica el tiempo de caducidad absoluto para el contenido en caché.

--files-from

stringArray

Lee una lista de nombres de archivos de origen desde un archivo e ignora las líneas vacías o de comentarios. Solo aplica a escenarios de filtrado.

--files-from-raw

stringArray

Lee una lista de nombres de archivos de origen desde un archivo. Solo aplica a escenarios de filtrado.

--filter

stringArray

Reglas de filtrado para rutas o nombres de archivos.

--filter-from

stringArray

Lee reglas de filtrado desde un archivo.

-f, --force

/

Fuerza la operación sin solicitar confirmación.

--include

stringArray

Reglas de inclusión para rutas o nombres de archivos.

--include-from

stringArray

Lee reglas de inclusión desde un archivo.

-j, --job

int

Número de tareas concurrentes (valor predeterminado: 3).

--list-objects

/

Utiliza la API ListObjects para enumerar objetos.

--max-size

SizeSuffix

Tamaño máximo de archivo a transferir. La unidad predeterminada es bytes. Puede agregar un sufijo: B|K|M|G|T|P. Nota: 1K (KiB) = 1024B.

--metadata

strings

Metadatos definidos por el usuario para el objeto, en formato clave=valor.

--metadata-directive

string

Especifica cómo establecer los metadatos del objeto de destino. Valores válidos:

• COPY

• REPLACE

--metadata-exclude

stringArray

Reglas de exclusión para metadatos de objetos.

--metadata-filter

stringArray

Reglas de filtrado para metadatos de objetos.

--metadata-filter-from

stringArray

Lee reglas de filtrado de metadatos de objetos desde un archivo.

--metadata-include

stringArray

Reglas de inclusión para metadatos de objetos.

--min-age

Duration

Descarga únicamente archivos modificados antes del intervalo de tiempo especificado. La unidad predeterminada es segundos. Puede usar sufijos como h (horas). Por ejemplo, 1h significa 1 hora.

--max-age

Duration

Descarga únicamente archivos modificados dentro del intervalo de tiempo especificado. La unidad predeterminada es segundos. Puede usar sufijos como h (horas). Por ejemplo, 1h significa 1 hora.

--min-mtime

Time

Descarga únicamente archivos modificados después de la hora especificada. Formato de hora: UTC; por ejemplo, 2006-01-02T15:04:05.

--max-mtime

Time

Descarga únicamente archivos modificados antes de la hora especificada. Formato de hora: UTC; por ejemplo, 2006-01-02T15:04:05.

--min-size

SizeSuffix

Tamaño mínimo de archivo a transferir. La unidad predeterminada es bytes. Puede agregar un sufijo: B|K|M|G|T|P. Nota: 1K (KiB) = 1024B.

--no-progress

/

No muestra la barra de progreso.

--page-size

int

Número máximo de objetos listados por página durante la descarga por lotes (valor predeterminado: 1000). Rango válido: 1–1000.

--parallel

int

Número de tareas concurrentes para operaciones internas en un solo archivo.

--part-size

SizeSuffix

Tamaño de parte para operaciones multiparte. De forma predeterminada, ossutil calcula un tamaño adecuado según el tamaño del archivo. Rango válido: 100 KiB–5 GiB.

-r, --recursive

/

Realiza operaciones de forma recursiva. Al especificar esta opción, el comando actúa sobre todos los objetos coincidentes del bucket. De lo contrario, solo opera sobre el objeto indicado por la ruta.

--request-payer

string

Método de pago de la solicitud. Establezca este valor en requester si el bucket utiliza el modo de pago por solicitante.

--size-only

/

Descarga solo los archivos de origen cuyo tamaño difiere del de los archivos de destino.

--start-after

string

Devuelve los objetos posteriores al valor especificado en orden alfabético, excluyendo dicho valor.

--storage-class

string

Clase de almacenamiento del objeto. Valores válidos:

• Standard: almacenamiento estándar.

• IA: almacenamiento de acceso poco frecuente.

• Archive: almacenamiento de archivo.

• ColdArchive: almacenamiento de archivo frío.

• DeepColdArchive: almacenamiento de archivo frío profundo.

--tagging

strings

Etiquetas del objeto, en formato clave=valor.

--tagging-directive

string

Especifica cómo establecer las etiquetas del objeto de destino. Valores válidos:

• COPY

• REPLACE

-u, --update

/

Omite archivos que ya existen en el destino y tienen una fecha de modificación más reciente que los archivos de origen.

--ignore-existing

/

Omite archivos que ya existen en el destino.

--version-id

string

ID de versión del objeto.

--write-buffer-size

SizeSuffix

Tamaño del búfer de memoria utilizado para escrituras. Se alinea automáticamente a límites de 4 KB. Admite sufijos B / K / M (valor predeterminado: 128 KiB). Rango válido: 0–32 MiB.