arquivos uip ou bucket

Sintaxe e opções para "uip ou bucket-files", que gerencia arquivos dentro de buckets de armazenamento do Orchestrator.

Gerencie arquivos dentro de buckets: listar, inspecionar, baixar, carregar, excluir e buscar URLs pré-assinadas. Cada subcomando recebe <bucket-key> como seu primeiro argumento. Para o próprio bucket (criar / compartilhar / listar em pastas), consulte uip or buckets.

Para as convenções entre recursos (autenticação, escopo de pasta, tipos de chave, envelope de saída), consulte a visão geraluip or .

Resumo

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>]

List

Listar arquivos em um bucket. Dois modos mutuamente exclusivos: o modo padrão (plano, filtrado por prefixo) é paginado por meio de --take-hint (padrão 500, máx. 1000) e --continuation-token, e aceita --prefix <path> e --expiry-in-minutes <n> (para as URLs de download pré-assinadas incluída em cada item). Passar -d, --directory <path> alterna para a API de listagem de diretórios do Orchestrator — um formato de resposta diferente sem token de continuação — e é incompatível com --prefix, --take-hint, --continuation-token e --expiry-in-minutes. --all-fields retorna a resposta completa da API.

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

diretórios da lista

Listar diretórios virtuais. Opcional -d, --directory <path> (lista raiz se omitido), --file-name-glob <pattern>, -l, --limit, --offset, --all-fields.

get

Obtenha metadados do arquivo em <path>. --all-fields retorna a resposta completa da API.

Excluir

Exclua o arquivo em <path>. Requer -y, --yes — a CLI nunca solicita operações destrutivas.

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

download

Baixe um arquivo. Com -d, --destination <file>, grava no disco (emite um envelope BucketFileDownload ); sem, transmite conteúdo para stdout.

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

Fazer upload

Carregue um arquivo local. Requer --file <local-file>. Opcional --content-type <mime> (detectado automaticamente se omitido).

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

Retorne um URL pré-assinado ao local do arquivo, sem transferir nenhum dado por meio da CLI. Opcional --expiry-in-minutes <n>; a variante de upload também aceita --content-type. Para carregar um arquivo local de ponta a ponta (pré-assinado e transferência em uma etapa), use bucket-files upload em vez disso.

Códigos de saída

Consulte Códigos de saída para o contrato compartilhado. delete sai de 1 se -y, --yes for omitido.

Comandos relacionados

• uip or buckets — CRUD no nível do bucket.

Veja também

• Visão geraluip or — convenções compartilhadas para cada verbo uip or .
• Como fazer: gerenciar ativos e filas do Orchestrator — padrões de upload/download de arquivos do bucket.