uip または bucket-files

「uip または bucket-files」の構文とオプション - Orchestrator のストレージ バケット内のファイルを管理する

バケット内のファイルの管理: 署名済み URL のリスト表示、検査、ダウンロード、アップロード、削除、取得を行います。すべてのサブコマンドは、最初の引数として <bucket-key> を取ります。バケット自体 (複数のフォルダーで作成/共有/一覧表示) については、「 uip or buckets」をご覧ください。

リソース間の規則 (認証、フォルダー スコープ、キーの種類、出力エンベロープ) については、「 uip or の概要」をご覧ください。

概要

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)

バケット内のファイルのリストを取得します。相互に排他的な 2 つのモードがあります。既定のモード (フラット、プレフィックス フィルター) モードは、 --take-hint (既定は 500、最大 1000) と --continuation-tokenでページ分割され、 --prefix <path> と --expiry-in-minutes <n> (各アイテムに含まれる署名済みダウンロード URL の場合) を受け入れます。-d, --directory <path>渡すと、代わりに Orchestrator のディレクトリ リスト API (継続トークンのない別の応答の形状) に切り替わり、--prefix、--take-hint、--continuation-token、--expiry-in-minutesには対応しません。--all-fields は完全な API 応答を返します。

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

list-dirs

仮想ディレクトリを一覧表示します。任意の -d, --directory <path> (省略する場合はルートを一覧表示)、 --file-name-glob <pattern>、 -l, --limit、 --offset、 --all-fields。

get

<path>でファイル メタデータを取得します。--all-fields は完全な API 応答を返します。

削除

<path>でファイルを削除-y, --yesが必要 — CLI で破壊的な操作が求められることはありません。

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

ダウンロード

ファイルをダウンロードします。-d, --destination <file>では、ディスクに書き込みます(BucketFileDownloadエンベロープを発行します)。含まず、コンテンツを stdout にストリーミングします。

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

アップロード

ローカル ファイルをアップロードします。--file <local-file>が必要です。任意 --content-type <mime> (省略した場合は自動検出)。

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

ダウンロード URL を取得 / アップロード URL を取得

CLI を介してデータを転送せずに、署名済み URL をファイルの場所に返します。任意 --expiry-in-minutes <n>。アップロード バリアントでは、 --content-typeも使用できます。ローカル ファイルをエンドツーエンドでアップロードするには (事前署名と転送を 1 ステップで実行)、代わりに bucket-files upload を使用します。

終了コード

共有コントラクトの 終了コード を参照してください。-y, --yesを省略するとdelete1終了します。

関連コマンド

• uip or buckets — バケットレベルの CRUD

参照

• uip orの概要—すべてのuip or動詞に共通する規則。
• 方法: Orchestrator のアセットとキューを管理する — バケット ファイルのアップロード/ダウンロード パターン。