Object Storage Service:Advanced commands

Alcance del comando

Opciones compatibles

Todos los comandos avanzados

• --encoding-type string: Codificación para los nombres de objetos o archivos de entrada. Valor válido: url.

• --request-payer string: Habilita el modo de pago por solicitante. Establezca este valor en requester.

Comandos que admiten operaciones por lotes

• --start-after/--end-with (, ]: Filtro de rango de claves. Inicio exclusivo, fin inclusivo.

• Opciones de filtro: Filtra por nombre de objeto o archivo, carpeta, tamaño, tiempo o metadatos. Filter options.

• --limited-num: Limita la cantidad de resultados devueltos por cada consulta a la API.

• --recursive/-r: Recorre recursivamente todos los subdirectorios.

• --dirs/-d: Lista únicamente el directorio actual y excluye los subdirectorios.

  Nota

  Para objetos, esta opción utiliza el método Delimiter y examina todos los objetos bajo el prefijo. A mayor cantidad de objetos, mayor será el tiempo de examen.

• --force/-f: Fuerza la operación sin solicitar confirmación.

• --list-objects: Utiliza la API ListObjects para listar objetos.

Comandos que admiten reglas de filtrado de destino

• --update: Compara únicamente la hora de modificación. Sincroniza solo cuando el origen es más reciente que el destino.

• --size-only: Compara únicamente el tamaño del archivo. Sincroniza solo los datos cuyo tamaño de archivo sea diferente.

• --checksum: Compara primero el tamaño del archivo y luego la suma de comprobación CRC-64. Si falta la suma de comprobación en cualquiera de los lados, los archivos se consideran inconsistentes. Válido únicamente para copias de objeto a objeto.

• --ignore-existing: Omite los archivos existentes.

Comandos que admiten objetos individuales

--version-id string: El ID de versión del objeto.

Comandos que admiten modo de lista

--list-format: El formato del archivo de lista. Valores válidos: plain e inventory.

--list-manifest-from: Lee la descripción del formato del archivo de lista desde un archivo. Este parámetro es obligatorio cuando el formato del archivo de lista es inventory.

Opción local

Tipo de opción

Descripción

--encoding-type

string

Codificación para los nombres de objetos o archivos de entrada. Valor válido: url.

--request-payer

string

Habilita el modo de pago por solicitante. Valor válido: requester.

--start-after

string

Devuelve objetos en orden alfabético posteriores al valor especificado (exclusivo).

--end-with

string

Devuelve objetos en orden alfabético hasta el valor especificado (inclusivo).

--page-size

int

Cantidad máxima de objetos por página en el procesamiento por lotes. Valor predeterminado: 1000. Rango: de 1 a 1000.

--include

stringArray

La regla de inclusión para rutas o nombres de archivo.

--include-from

stringArray

Lee las reglas de inclusión desde un archivo de reglas.

--exclude

stringArray

La regla de exclusión para rutas o nombres de archivo.

--exclude-from

stringArray

Lee las reglas de exclusión desde un archivo de reglas.

--filter

stringArray

La regla de filtro para rutas o nombres de archivo.

--files-from

stringArray

Lee una lista de nombres de archivo de origen desde un archivo. Se ignoran las líneas vacías o de comentarios. Esto aplica únicamente a operaciones de filtrado de archivos.

--files-from-raw

stringArray

Lee una lista de nombres de archivo de origen desde un archivo. Esto aplica únicamente a operaciones de filtrado de archivos.

--max-age

Duration

Omite archivos con una antigüedad mayor a la indicada. Unidad predeterminada: segundos. Admite sufijos: ms, s, m, h, d, w, M, y. Valor predeterminado: desactivado.

--min-age

Duration

Omite archivos con una antigüedad menor a la indicada. Unidad predeterminada: segundos. Admite sufijos: ms, s, m, h, d, w, M, y. Valor predeterminado: desactivado.

--max-mtime

Time

Omite archivos modificados después de esta marca de tiempo UTC. Valor predeterminado: desactivado.

--min-mtime

Time

Omite archivos modificados antes de esta marca de tiempo UTC. Valor predeterminado: desactivado.

--max-size

SizeSuffix

Tamaño máximo de archivo a transferir. Unidad predeterminada: bytes. Admite sufijos: B, K, M, G, T, P. 1 K (KiB) = 1024 B.

--min-size

SizeSuffix

Tamaño mínimo de archivo a transferir. Unidad predeterminada: bytes. Admite sufijos: B, K, M, G, T, P. 1 K (KiB) = 1024 B.

--metadata-exclude

stringArray

La regla de exclusión para metadatos de objetos.

--metadata-include

stringArray

La regla de inclusión para metadatos de objetos.

--metadata-filter

stringArray

La regla de filtro para metadatos de objetos.

--metadata-filter-from

stringArray

Lee las reglas de filtro de metadatos de objetos desde un archivo de reglas.

--checksum

/

Copia únicamente los archivos de origen cuyo tamaño y suma de comprobación (si existe) sean inconsistentes.

--size-only

/

Copia únicamente los archivos de origen con un tamaño inconsistente.

-u, --update

/

Copia únicamente los archivos de origen más recientes que los archivos de destino.

-r, --recursive

/

Opera recursivamente sobre todos los objetos coincidentes en el bucket. Sin esta opción, opera únicamente sobre la ruta especificada.

-d, --dirs

/

Lista únicamente archivos y subdirectorios en la carpeta actual, sin recursividad.

-f, --force

/

Fuerza la operación sin solicitar confirmación.

--list-objects

/

Utiliza la API ListObjects para listar objetos.

--no-progress

/

No muestra la barra de progreso.

-j, --job

int

Tareas simultáneas para operaciones con múltiples archivos. Valor predeterminado: 3.

--checkers

int

Verificadores en paralelo. Valor predeterminado: 16.

--parallel

int

Tareas simultáneas para operaciones multipartes de un solo archivo.

--part-size

SizeSuffix

Tamaño de parte para operaciones multipartes. Se calcula automáticamente de forma predeterminada. Rango: de 100 KiB a 5 GiB.

--bigfile-threshold

int

Umbral de tamaño para carga, descarga o copia multiparte. Valor predeterminado: 104857600 (100 MiB).

--version-id

string

El ID de versión del objeto.

--storage-class

string

La clase de almacenamiento del objeto. Valores válidos: Standard, IA, Archive, ColdArchive y DeepColdArchive.

--acl

string

Los permisos de acceso del objeto. Valores válidos: private, public-read, public-read-write y default.

--cache-control

string

Controla el comportamiento de caché del navegador cuando se descarga el objeto.

--content-disposition

string

Formato de visualización del objeto.

--content-encoding

string

Codificación de contenido del objeto.

--content-type

string

El tipo de contenido del objeto.

--expires

string

Tiempo de caducidad absoluto para el contenido en caché.

--copy-props

string

Propiedades a copiar del objeto de origen. Valores válidos: none, metadata, default.

--tagging

string

Etiquetas de objeto en formato clave=valor.

--tagging-directive

string

Cómo establecer las etiquetas del objeto de destino. Valores válidos: COPY, REPLACE.

--metadata

string

Metadatos de usuario en formato clave=valor.

--metadata-directive

string

Cómo establecer los metadatos del objeto de destino. Valores válidos: COPY, REPLACE.

--list-format

string

El formato del archivo de lista. Valores válidos: plain e inventory.

--list-manifest-from

string

Lee la descripción del formato del archivo de lista desde un archivo. Este parámetro es obligatorio cuando el formato del archivo de lista es inventory.

Elemento

Descripción

Sintaxis de regla de filtro

• patrón de regla parámetro de opción de regla: Un patrón de coincidencia Glob.

• nombre de archivo de regla parámetro de opción de regla: La ruta de un archivo que contiene reglas de patrones de coincidencia Glob.

• modificadores de regla patrón parámetro de opción de regla: Un patrón de coincidencia Glob con instrucción. La instrucción + indica una regla de inclusión. Los objetos que coinciden con esta regla se incluyen en el resultado. La instrucción - indica una regla de exclusión. Los objetos que coinciden con esta regla se excluyen del resultado.

Parámetros de opción de regla de filtro

• --include

• --include-from

• --exclude

• --exclude-from

• --filter

• --filter-from

Opción

Descripción

--include

--exclude

El parámetro va seguido de un patrón de coincidencia. Cada opción representa una regla. Para usar varias reglas, repita estas opciones.

Por ejemplo, --include ".txt" --include ".js" --exclude "*.jpg" incluye todos los archivos .txt y .js, pero excluye todos los archivos .jpg.

El siguiente comando de ejemplo descarga recursivamente archivos que coinciden con las reglas de filtro desde la carpeta oss://examplebucket/exampledir/ en Alibaba Cloud OSS hacia la carpeta localdir/. Las reglas incluyen todos los archivos .txt y .js, pero excluyen todos los archivos .jpg.

ossutil cp -r oss://examplebucket/exampledir/ localdir/ --include "*.txt" --include "*.js" --exclude "*.jpg"

--filter

El parámetro va seguido de un patrón de coincidencia con instrucción. Cada valor de opción representa una regla. Para usar varias reglas, repita estas opciones.

Por ejemplo, --filter "+ .txt" --filter "+ .js" --filter "- *.jpg" incluye todos los archivos .txt y .js, pero excluye todos los archivos .jpg.

• El símbolo + indica una regla de inclusión. Los objetos que coinciden con esta regla se incluyen en el resultado.

• El símbolo - indica una regla de exclusión. Los objetos que coinciden con esta regla se excluyen del resultado.

El siguiente comando de ejemplo descarga recursivamente archivos que coinciden con las reglas de filtro desde la carpeta oss://examplebucket/exampledir/ en Alibaba Cloud OSS hacia la carpeta localdir/. Las reglas excluyen los archivos .txt y .js, e incluyen únicamente los archivos .png.

ossutil cp -r oss://examplebucket/exampledir/ localdir/ --filter "- *.txt" --filter "- *.js" --filter "+ *.png"

--include-from

--exclude-from

El parámetro va seguido de la ruta de un archivo de reglas. Cada línea en el archivo de reglas representa un patrón de coincidencia Glob. Para importar varios archivos de reglas, repita estas opciones.

Todas las reglas importadas con --include-from son reglas de inclusión. Todas las reglas importadas con --exclude-from son reglas de exclusión.

Por ejemplo, --include-from include-file.txt --exclude-from exclude-file.txt incluye todos los archivos .txt y .js, pero excluye todos los archivos .jpg.

El contenido del archivo de reglas include-file.txt es el siguiente:

 *.txt
 *.js

El archivo de reglas include-file.txt contiene lo siguiente:

 *.jpg

--filter-from

El parámetro va seguido de la ruta de un archivo de reglas. Cada línea en el archivo de reglas representa un patrón de coincidencia Glob con instrucción.

Para importar varios archivos de reglas, repita estas opciones.

Por ejemplo, en --filter-from filter-file.txt, el contenido del archivo de reglas filter-file.txt es el siguiente:

 # a filter rule file
     + *.txt
     + *.js
     - **

Opción

Descripción

--files-from

Lee una lista de rutas o nombres de archivo desde un archivo. Puede repetir esta opción para usar varios archivos de lista.

Al procesar cada línea en el archivo de lista, se eliminan los espacios iniciales o finales, y se ignoran las líneas de comentarios que comienzan con # o ;.

--files-from-raw

Lee una lista de rutas o nombres de archivo desde un archivo. Puede repetir esta opción para usar varios archivos de lista.

Al procesar cada línea en el archivo de lista, no se ignoran los espacios iniciales o finales ni las líneas de comentarios que comienzan con # o ;.

Parámetro

Descripción

--min-age

Duration

Procesa únicamente archivos modificados antes del intervalo especificado. Unidad predeterminada: segundos. Admite sufijos de unidad, p. ej., 1h.

--max-age

Duration

Procesa únicamente archivos modificados dentro del intervalo especificado. Unidad predeterminada: segundos. Admite sufijos de unidad, p. ej., 1h.

--min-mtime

Time

Procesa únicamente archivos modificados después de la hora especificada.

--max-mtime

Time

Procesa únicamente archivos modificados antes de la hora especificada.

Parámetro

Descripción

--min-size

Omite archivos menores a este tamaño. Unidad predeterminada: bytes. Ejemplo: 1K (KiB) = 1024 bytes.

--max-size

Omite archivos mayores a este tamaño. Unidad predeterminada: bytes. Ejemplo: 1K (KiB) = 1024 bytes.