Object Storage Service:View options

Nombre de la opción

Descripción

-s, --short-format

Muestra los resultados en formato corto. Valor predeterminado: formato largo.

--bigfile-threshold

Umbral de tamaño de archivo para la carga reanudable. Unidad: bytes. Valor predeterminado: 100 MB. Rango: de 0 a 9223372036854775807.

--acl

Configura la lista de control de acceso (ACL).

--range

Especifica un rango de bytes basado en cero para descargar de un archivo.

• Puede especificar un rango. Por ejemplo, 3-9 indica del byte 3 al 9, inclusive.

• Puede especificar un punto de inicio, como 3-, para descargar desde el byte 3 hasta el final del archivo, inclusive.

• Puede especificar la posición final. Por ejemplo, -9 especifica el rango del byte 0 al byte 9.

--all-versions

Especifica todas las versiones de un objeto.

--type

Método de validación de datos. Valores válidos:

• crc64 (predeterminado): Realiza una comprobación de redundancia cíclica de 64 bits (CRC64).

• md5: Realiza la validación MD5.

-v, --version

Muestra la versión de ossutil y sale.

-u, --update

Realiza una operación de actualización.

--origin

Valor del campo origin en el encabezado de solicitud HTTP.

--upmode

Modo de carga utilizado en el comando probe. Valores válidos:

• normal (predeterminado): Carga simple.

• append: Carga por anexión.

• multipart: Carga multiparte.

--sse-algorithm

Algoritmo de cifrado del lado del servidor para el bucket. Valores válidos:

• KMS: Utiliza una clave administrada por Key Management Service (KMS) para el cifrado y descifrado, lo que corresponde a SSE-KMS.

• AES256: Utiliza una clave administrada por OSS para el cifrado y descifrado, lo que corresponde a SSE-OSS.

--include

Lista los objetos que cumplen las condiciones especificadas. Por ejemplo, *.jpg lista todos los archivos en formato JPG.

The --include and --exclude options.

--exclude

Lista los objetos que no cumplen las condiciones especificadas. Por ejemplo, *.txt lista todos los archivos que no están en formato TXT.

The --include and --exclude options.

-r, --recursive

Opera recursivamente sobre todos los objetos coincidentes en el bucket. Sin esta opción, solo se ve afectado el objeto especificado.

--addr

Especifica una dirección de red para probar la conectividad mediante ping.

Valor predeterminado: www.aliyun.com

--kms-masterkey-id

ID de la clave maestra del cliente (CMK) en KMS.

--version-id

ID de versión del objeto.

--version-id-marker

Lista las versiones de objetos cuyos ID son alfabéticamente posteriores al marcador especificado. Requiere que el versionado esté habilitado.

-m, --multipart

Especifica que la operación se aplica a eventos de carga multiparte incompletos en el bucket.

-d, --directory

Devuelve solo los archivos y subdirectorios en el directorio actual.

--payer

Pagador de la solicitud. Establézcalo en requester para el modo de pago por solicitante.

--maxupspeed

Velocidad máxima de carga. Unidad: KB/s. Valor predeterminado: 0 (sin límite).

--maxdownspeed

Velocidad máxima de descarga. Unidad: KB/s. Valor predeterminado: 0 (sin límite).

--retry-times

Número de reintentos después de un error. Valor predeterminado: 10. Rango: de 1 a 500.

--download

Prueba la conectividad de red descargando un objeto del bucket de destino mediante la URL del archivo.

-j, --jobs

Número de tareas simultáneas para operaciones con múltiples archivos. Valor predeterminado: 3. Rango: de 1 a 10000.

-a, --all-type

Especifica que la operación se aplica a objetos y eventos de carga multiparte incompletos en el bucket.

--disable-empty-referer

Especifica que el campo Referer no puede estar vacío.

--method

Método de solicitud HTTP. Los valores válidos incluyen PUT, GET y DELETE.

--output-dir

Directorio de salida para archivos de informe, como los informes de fallas de copia por lotes del comando cp.

Valor predeterminado: el directorio ossutil_output en el directorio actual.

--meta

Establece los metadatos del objeto. Formato: Cache-Control:no-cache#Content-Encoding:gzip.

--object

Especifica el nombre del archivo en el comando probe.

--end-time

Marca de tiempo UNIX. Si utiliza esta opción, se ignoran los objetos cuya última modificación sea posterior a la hora especificada.

--limited-num

Número máximo de resultados a devolver.

-L, --language

Establece el idioma para ossutil. Valores válidos:

• CH (predeterminado): Chino. Si establece el idioma en CH, asegúrese de que la codificación de su sistema sea UTF-8.

• EN: Inglés.

--delete

Elimina un bucket, un objeto o un fragmento.

-b, --bucket

Utilice esta opción solo cuando elimine un bucket.

--disable-crc64

Deshabilita la validación CRC64. De forma predeterminada, ossutil habilita la validación CRC64 para la transferencia de datos.

--upload

Prueba la conectividad de red cargando un archivo local en el bucket de destino.

--part-size

Tamaño de la parte. Unidad: bytes. De forma predeterminada, ossutil calcula el tamaño de la parte según el tamaño del archivo. Rango: de 1 a 9223372036854775807.

--timeout

Tiempo de espera de la URL firmada. Unidad: segundos. Valor predeterminado: 60. Rango: de 0 a 9223372036854775807.

--checkpoint-dir

Directorio para los datos de punto de control de carga o descarga reanudable. En caso de falla, ossutil crea un directorio .ossutil_checkpoint que se elimina después de que la operación se completa correctamente. Asegúrese de que el directorio especificado se pueda eliminar.

--url

URL del archivo.

--marker

Lista buckets, objetos o partes cuyos nombres son alfabéticamente posteriores al marcador especificado.

-f, --force

Fuerza la operación sin solicitar confirmación.

--snapshot-path

Directorio para los datos de instantánea utilizados en cargas y descargas incrementales.

• --snapshot-path acelera las transferencias incrementales de grandes conjuntos de archivos cuando ningún otro usuario ha modificado los objetos correspondientes de OSS entre operaciones. No es compatible con operaciones de copia.

• --snapshot-path registra el lastModifiedTime de los archivos transferidos correctamente y omite los archivos sin cambios en ejecuciones posteriores. Si otros usuarios pueden modificar objetos de OSS, utilice --update en su lugar.

• Los datos de la instantánea no se eliminan automáticamente. Borre la ruta de la instantánea cuando ya no sea necesaria.

• Esta opción agrega sobrecarga de E/S. Para conjuntos pequeños de archivos u objetos compartidos, utilice --update en su lugar.

• --update y --snapshot-path se pueden combinar. ossutil comprueba primero la instantánea y luego recurre a --update.

--start-time

Marca de tiempo UNIX. Si utiliza esta opción, se ignoran los objetos cuya última modificación sea anterior a la hora especificada.

--storage-class

Clase de almacenamiento. Valores válidos:

• Standard (predeterminado): Para datos a los que se accede frecuentemente.

• IA: Acceso poco frecuente. Para datos a los que se accede una o dos veces al mes. Almacenamiento mínimo: 30 días. Tamaño facturable mínimo: 64 KB. Acceso en tiempo real con tarifas de recuperación de datos.

• Archive: Archivado de datos a largo plazo. Almacenamiento mínimo: 60 días. Tamaño facturable mínimo: 64 KB. Requiere restauración (~1 minuto) antes del acceso. Se aplican tarifas de recuperación de datos.

• ColdArchive: Datos extremadamente fríos que requieren almacenamiento a largo plazo. Almacenamiento mínimo: 180 días. Tamaño facturable mínimo: 64 KB. Requiere restauración antes del acceso; el tiempo varía según el tamaño de los datos y el modo de restauración. Se aplican tarifas de recuperación de datos.

-t, --sts-token

Token de STS para acceso con credenciales temporales. Obligatorio solo con credenciales STS y anula la configuración del archivo de configuración. Temporary access credentials.

--parallel

Número de tareas simultáneas para operaciones con un solo archivo. Rango: de 1 a 10000. Valor predeterminado: determinado por el tipo de operación y el tamaño del archivo.

--partition-download

Especifica una partición para descargas paralelas. Formato: partition_number:total_partitions. Por ejemplo, 1:5 descarga la partición 1 de 5. Los números de partición comienzan en 1. Varias instancias de ossutil pueden descargar diferentes particiones en paralelo.

--bucketname

Nombre del bucket.

--encoding-type

Codifica en URL la clave del objeto después de oss://bucket_name. Valor válido: url. Si se omite, la clave no se codifica.

--origin

Valor del encabezado de solicitud HTTP Origin, utilizado para identificar solicitudes de origen cruzado.

--acr-method

Valor del encabezado de solicitud HTTP Access-Control-Request-Method. Los valores válidos son GET, PUT, POST, DELETE y HEAD.

--acr-headers

Valor de Access-Control-Request-Headers para solicitudes de preflight CORS. Separe varios encabezados con comas y enciérrelos entre comillas dobles, por ejemplo, --acr-headers "header1,header2,header3".

--upload-id-marker

Lista las partes cuyos ID de carga son alfabéticamente posteriores al marcador especificado.

-h, --help

Muestra información de ayuda.

--trafic-limit

Límite de velocidad HTTP para el comando sign. Unidad: bit/s.

Valor predeterminado: 0 (sin límite).

Rango: de 819200 a 838860800 (de 100 KB/s a 100 MB/s).

--local-host

Dirección IP local para acceder a OSS en el comando cp.

--enable-symlink-dir

Carga subdirectorios vinculados (omitidos de forma predeterminada). Utilice probe command para detectar enlaces simbólicos circulares.

--only-current-dir

Procesa solo los archivos en el directorio actual e ignora los subdirectorios.

--disable-dir-object

Omite la creación de objetos de directorio durante la carga. La estructura de directorios permanece visible en la consola, pero desaparece cuando se eliminan todos los archivos dentro de ella.

--probe-item

Objetivo de la prueba. Valores válidos:

• upload-speed: Prueba el ancho de banda de carga.

• download-speed: Prueba el ancho de banda de descarga.

• cycle-symlink: Comprueba si existen archivos o directorios de enlace en bucle infinito en el directorio de archivos local.

--redundancy-type

Tipo de redundancia de datos del bucket. Valores válidos:

• LRS (predeterminado): El almacenamiento con redundancia local (LRS) almacena sus datos de forma redundante en diferentes dispositivos de almacenamiento dentro de la misma zona. Garantiza la durabilidad y disponibilidad de los datos incluso si dos dispositivos de almacenamiento se dañan simultáneamente.

• ZRS: El almacenamiento con redundancia de zona (ZRS) utiliza un mecanismo de redundancia de datos multizona para almacenar sus datos de forma redundante en varias zonas dentro de la misma región. Garantiza la disponibilidad de los datos incluso si una zona deja de estar disponible.

--disable-encode-slash

No codifica la barra diagonal (/) en la URL.

--disable-all-symlink

Ignora todos los subarchivos de enlace simbólico y subdirectorios de enlace simbólico durante la carga.

--tagging

Establece etiquetas de objeto durante la carga o copia. Formato: "abc=1&bcd=2&...".

--disable-ignore-error

Finaliza inmediatamente ante un error en lugar de continuar con las operaciones por lotes.

--block-size

Unidad para los tamaños de objeto en la salida. Valores válidos: KB, MB, GB o TB. Valor predeterminado: bytes.