UIP o archivos de depósito

Sintaxis y opciones para `uip o bucket-files`, que gestiona archivos dentro de los depósitos de almacenamiento de Orchestrator.

Gestionar archivos dentro de depósitos: enumerar, inspeccionar, descargar, cargar, eliminar y obtener URL prefirmadas. Cada subcomando toma <bucket-key> como primer argumento. Para el propio depósito (crear/compartir/enumerar en todas las carpetas), consulta uip or buckets.

Para las convenciones de recursos cruzados (autenticación, ámbito de carpeta, tipos de clave, sobre de salida), consulta la uip or descripción general.

Sinopsis

uip or bucket-files list              <bucket-key> --folder-path <path> | --folder-key <key> [--prefix <path> | -d <directory>] [--take-hint <n>] [--continuation-token <token>] [--expiry-in-minutes <n>] [--all-fields]
uip or bucket-files list-dirs         <bucket-key> --folder-path <path> | --folder-key <key> [-d <directory>] [--file-name-glob <pattern>] [-l <n>] [--offset <n>] [--all-fields]
uip or bucket-files get               <bucket-key> <path> --folder-path <path> | --folder-key <key> [--all-fields]
uip or bucket-files delete            <bucket-key> <path> --folder-path <path> | --folder-key <key> --yes
uip or bucket-files download          <bucket-key> <path> --folder-path <path> | --folder-key <key> [-d <local-file>]
uip or bucket-files upload            <bucket-key> <path> --folder-path <path> | --folder-key <key> --file <local-file> [--content-type <mime>]
uip or bucket-files get-download-url  <bucket-key> <path> --folder-path <path> | --folder-key <key> [--expiry-in-minutes <n>]
uip or bucket-files get-upload-url    <bucket-key> <path> --folder-path <path> | --folder-key <key> [--expiry-in-minutes <n>] [--content-type <mime>]

Lista

Enumerar archivos en un depósito. Dos modos mutuamente excluyentes: el modo predeterminado (plano, filtrado por prefijo) se pagina a través de --take-hint (predeterminado 500, máx. 1000) y --continuation-token, y acepta --prefix <path> y --expiry-in-minutes <n> (para las URL de descarga prefirmadas incluido en cada elemento). Pasar los conmutadores -d, --directory <path> a la API de listado de directorios de Orchestrator en su lugar (una forma de respuesta diferente sin token de continuación) y es incompatible con --prefix, --take-hint, --continuation-token y --expiry-in-minutes. --all-fields devuelve la respuesta completa de la API.

uip or bucket-files list a1b2c3d4-0000-0000-0000-000000000001 \
  --folder-path Shared

directorios-de-lista

Enumerar directorios virtuales. Opcional -d, --directory <path> (enumera la raíz si se omite), --file-name-glob <pattern>, -l, --limit, --offset, --all-fields.

get

Obtenga los metadatos del archivo en <path>. --all-fields devuelve la respuesta completa de la API.

Eliminar

Eliminar archivo en <path>. Requiere -y, --yes: la CLI nunca solicita operaciones destructivas.

uip or bucket-files delete a1b2c3d4-0000-0000-0000-000000000001 \
  "reports/summary.csv" --folder-path Shared --yes

download

Descarga un archivo. Con -d, --destination <file>, escribe en el disco (emite un sobre BucketFileDownload ); sin, transmite el contenido a la salida estándar.

uip or bucket-files download a1b2c3d4-0000-0000-0000-000000000001 \
  "reports/summary.csv" --folder-path Shared --destination ./summary.csv

Cargar

Carga un archivo local. Requiere --file <local-file>. --content-type <mime> Opcional (detectado automáticamente si se omite).

uip or bucket-files upload a1b2c3d4-0000-0000-0000-000000000001 \
  "reports/summary.csv" --folder-path Shared --file ./summary.csv

get-download-url / get-upload-url

Devuelve una URL prefirmada a la ubicación del archivo, sin transferir ningún dato a través de la CLI. Opcional --expiry-in-minutes <n>; la variante de carga también acepta --content-type. Para cargar un archivo local de extremo a extremo (prefirmar y transferir en un solo paso), utiliza bucket-files upload en su lugar.

Códigos de salida

Consulta Códigos de salida para el contrato compartido. delete sale de 1 si se omite -y, --yes.

Comandos relacionados

• uip or buckets : CRUD a nivel de depósito.

Ver también

• Información generaluip or : convenciones compartidas para cada verbo uip or .
• Tutorial: gestionar activos y colas de Orchestrator : patrones de carga/descarga de archivos de depósito.