fichiers-fichiers-uip ou bucket-files

Syntaxe et options pour `uip ou bucket-files`, qui gère les fichiers à l'intérieur des compartiments de stockage Orchestrator.

Gestion des fichiers à l’intérieur des compartiments: répertorie, inspecter, télécharger, charger, supprimer et récupérer les URL pré-signées. Chaque sous-commande prend <bucket-key> comme premier argument. Pour le compartiment lui-même (création/partage/répertorier entre les dossiers), voir uip or buckets.

Pour les conventions inter-ressources (authentification, étendue des dossiers, types de clés, enveloppe de sortie), consultez la vue d’ensembleuip or .

Synthèse

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

Répertorie les fichiers dans un compartiment. Deux modes mutuellement exclusifs: le mode par défaut (plat, filtré par préfixe) est paginé via --take-hint (par défaut 500, maximum 1 000) et --continuation-token, et accepte --prefix <path> et --expiry-in-minutes <n> (pour les URL de téléchargement pré-signées inclus dans chaque élément). La transmission de -d, --directory <path> bascule vers l'API de liste d'annuaire d'Orchestrator à la place — une forme de réponse différente sans jeton de poursuite — et est incompatible avec --prefix, --take-hint, --continuation-token et --expiry-in-minutes. --all-fields renvoie la réponse complète de l'API.

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

Répertoires-Liste

Lister des répertoires virtuels Facultatif -d, --directory <path> (répertorie la racine si omis), --file-name-glob <pattern>, -l, --limit, --offset, --all-fields.

get

Obtenez les métadonnées du fichier au niveau de <path>. --all-fields renvoie la réponse complète de l'API.

Supprimer (Delete)

Supprimer le fichier au niveau du chemin d’accès <path>. Requiert -y, --yes — la CLI ne demande jamais d'opérations destructrices.

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

Télécharger

Télécharge un fichier. Avec -d, --destination <file>, écrit sur le disque (émet une enveloppe BucketFileDownload ); sans, flux le contenu vers stdout.

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

Télécharger

Chargez un fichier local. Nécessite --file <local-file>. --content-type <mime> facultatif (détecté automatiquement si omis).

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

URL de téléchargement (Get-download-url)

Renvoyez une URL pré-signée vers l’emplacement du fichier sans transférer de données via la CLI. Facultatif --expiry-in-minutes <n>; la variante de téléchargement accepte également --content-type. Pour télécharger un fichier local de bout en bout (présignation et transfert en une seule étape), utilisez bucket-files upload à la place.

Codes de sortie

Voir Codes de sortie pour le contrat partagé. delete quitte 1 si -y, --yes est omis.

Commandes associées

• uip or buckets — CRUD au niveau du compartiment.

Voir également

• Vue d’ensemble deuip or — conventions partagées pour chaque uip or verbe.
• Procédures: gérer les ressources et les files d'attente d'Orchestrator — modèles de chargement/téléchargement de fichiers de compartiment.