uip or buckets

Syntax and options for `uip or buckets`, which manages Orchestrator storage containers used by automations.

管理 Orchestrator存储桶— 自动化使用的文件的存储容器。存储桶操作在文件夹范围内。有关存储桶内基于文件的操作，请参阅uip or bucket-files 。

有关跨资源约定（身份验证、文件夹作用域、密钥类型、输出信封），请参阅uip or概述。

大纲

uip or buckets list          [--folder-path <path> | --folder-key <key> | --all-folders] [-n <name>] [--exclude-folder-path <path>] [--exclude-folder-key <key>] [-l, --limit <n>] [--offset <n>] [--sort-by <field>] [--all-fields]
uip or buckets get           <bucket-key> [--folder-path <path> | --folder-key <key>] [--all-fields]
uip or buckets create        <name> --folder-path <path> | --folder-key <key> [options below]
uip or buckets update        <bucket-key> [options as for create]
uip or buckets delete        <bucket-key> --yes | --force
uip or buckets share         <bucket-key> --folder-path <path> | --folder-key <key>
uip or buckets unshare       <bucket-key> --folder-path <path> | --folder-key <key>
uip or buckets list-folders  <bucket-key>

列表

List buckets. Requires --folder-path, --folder-key, or --all-folders. With a folder, lists buckets inside that folder. With --all-folders, lists across every accessible folder (optionally excluding one via --exclude-folder-path / --exclude-folder-key, which apply only in that mode). Filter: -n, --name <name>. --sort-by <field> sorts results (default Id desc); --all-fields returns the full API response.

uip or buckets list --folder-path Shared

get

Get bucket details by key. --all-fields returns the full API response, including storage container, credential-store link, and tags.

uip or buckets get a1b2c3d4-0000-0000-0000-000000000001

创建

Create a bucket in a folder. Requires <name>. Optional flags include --identifier <guid> (auto-generated if omitted), -d, --description, --storage-provider <Azure|Amazon|Minio|S3Compatible|FileSystem> (omit for Orchestrator built-in), --storage-parameters, --storage-container, --credential-store-key (required for Azure and Amazon), --external-name, --password, --options <None|ReadOnly|AuditReadAccess|AccessDataThroughOrchestrator>, --tags <json> (a JSON array, e.g. '[{"name":"env","value":"prod"}]').

uip or buckets create invoices --folder-path Shared \
  --description "Invoice attachments"

更新

Update bucket properties by key. Same flags as create (all optional; -n, --name renames the bucket on update).

删除

Delete a bucket by key. Requires -y, --yes — the CLI never prompts for destructive operations. Refuses to delete a bucket that still has files unless you also pass -f, --force (which deletes the files too, and implies --yes).

uip or buckets delete a1b2c3d4-0000-0000-0000-000000000010 --yes
uip or buckets delete a1b2c3d4-0000-0000-0000-000000000010 --force

共享/取消共享

在文件夹中添加或删除存储桶。

列表文件夹

列出存储桶共享的文件夹。

退出代码

See Exit codes for the shared contract. delete exits 1 if -y, --yes / -f, --force is omitted, or if the bucket still has files and --force was not passed.

相关命令

• uip or bucket-files — 存储桶中每个文件的操作。
• uip or credential-stores list — find the --credential-store-key required for Azure/Amazon storage providers.

另请参阅

• uip or概述— 每个uip or动词的共享约定。
• 操作方法：管理 Orchestrator 资产和队列— 存储桶文件上传/下载模式。