Skip to main content

uip resource bucket-files

Manage files inside buckets: list, inspect, upload, download, delete, and fetch pre-signed URLs. Every subcommand takes <bucket-key> as its first argument. For the bucket itself (create / share / list across folders), see uip resource buckets.

For the cross-resource conventions (auth, folder scoping, key types, output envelope), see the uip resource overview.

Synopsis​

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

list​

List files in a bucket. Paginated via --take-hint, --continuation-token. Optional --prefix <path> and --expiry-in-minutes <n> (for the pre-signed download URLs included in the response).

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

list-dirs​

List virtual directories. Optional -d, --directory <path>, --file-name-glob <pattern>, -l, --limit, --offset.

get​

Get file metadata at <path>.

delete​

Delete file at <path>.

read​

Download a file. With -d, --destination <file>, writes to disk (emits a BucketFileRead envelope); without, streams content to stdout.

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

write​

Upload a local file. Requires --file <local-file>. Optional --content-type <mime> (auto-detected if omitted).

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

get-download-url / get-upload-url​

Return a pre-signed URL to the file location. Optional --expiry-in-minutes <n>; upload variant also accepts --content-type.

See also​