UIP oder Bucket-Dateien

Syntax und Optionen für „uip oder bucket-files“, das Dateien in Orchestrator-Speicher-Buckets verwaltet.

Verwalten von Dateien in Buckets: Auflisten, Prüfen, Herunterladen, Hochladen, Löschen und Abrufen von vorsignierten URLs. Jeder Unterbefehl verwendet <bucket-key> als erstes Argument. Den Bucket selbst (ordnerübergreifend erstellen/freigeben/auflisten) finden Sie unter uip or buckets.

Die ressourcenübergreifenden Konventionen (Authentifizierung, Ordner-Scoping, Schlüsseltypen, Ausgabeumschlag) finden Sie in der uip or -Übersicht.

Zusammenfassung

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

Liste

Listen Sie Dateien in einem Bucket auf. Zwei sich gegenseitig ausschließende Modi: Der Standardmodus (ebene, mit Präfix gefiltert) wird über --take-hint (Standard 500, max. 1000) und --continuation-token paginiert und akzeptiert --prefix <path> und --expiry-in-minutes <n> (für die vorsignierten Download-URLs). in jedem Element enthalten). Bei der Übergabe von -d, --directory <path> wird stattdessen die Verzeichnisauflistungs-API von Orchestrator verwendet – eine andere Antwortform ohne Fortsetzungstoken – und ist nicht mit --prefix, --take-hint, --continuation-token und --expiry-in-minutes kompatibel. --all-fields gibt die vollständige API-Antwort zurück.

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

Listenalgorithmus

Listen Sie virtuelle Verzeichnisse auf. Optional -d, --directory <path> (listet den Stamm auf, wenn er weggelassen wird), --file-name-glob <pattern>, -l, --limit, --offset, --all-fields.

get

Rufen Sie Dateimetadaten unter <path> ab. --all-fields gibt die vollständige API-Antwort zurück.

Löschen

Löschen Sie die Datei unter <path>. Erfordert -y, --yes – die CLI fordert nie zu destruktiven Vorgängen auf.

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

Herunterladen (Download)

Laden Sie eine Datei herunter. Schreibt mit -d, --destination <file> auf den Datenträger (gibt einen BucketFileDownload -Umschlag aus); ohne, streamt der Inhalt nach standardout.

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

Hochladen

Laden Sie eine lokale Datei hoch. Erfordert --file <local-file>. Optional --content-type <mime> (Automatisch erkannt, wenn es weggelassen wird).

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

Geben Sie eine vorsignierte URL zum Dateispeicherort zurück, ohne Daten über die CLI zu übertragen. Optionale --expiry-in-minutes <n>; Die Upload-Variante akzeptiert auch --content-type. Um eine lokale Datei von Anfang bis Ende hochzuladen (Vorsignieren und Übertragen in einem Schritt), verwenden Sie stattdessen bucket-files upload.

Exitcodes

Siehe Austrittscodes für den gemeinsamen Vertrag. delete beendet 1, wenn -y, --yes weggelassen wird.

Zugehörige Befehle

• uip or buckets – CRUD auf Bucket-Ebene.

Siehe auch

• uip or Übersicht – gemeinsame Konventionen für jedes uip or -Verb.
• So: Verwalten von Orchestrator-Assets und Warteschlangen – Muster für Upload/Download von Bucket-Dateien.