:cp (upload files)

Paramètre

Type

Description

source

string

Chemin du fichier local. Accepte les chemins relatifs, absolus et -. Si la valeur est -, les données sont lues depuis l'entrée standard.

dest

string

Chemin du fichier dans le bucket de destination. Exemple : oss://bucket[/prefix].

--acl

string

Permissions d'accès pour l'objet. Valeurs valides :

• private : privé.

• public-read : lecture publique.

• public-read-write : lecture et écriture publiques.

• default : hérité du bucket.

--bandwidth-limit

SizeSuffix

Limite la bande passante réseau pour contrôler le taux de transfert des données. La valeur minimale est de 1024 B/s. L'unité par défaut est B/s.

Lors de la définition de ce paramètre, spécifiez une unité si nécessaire. Les unités valides incluent B (octets), K (kilo-octets), M (méga-octets) et G (giga-octets). Par exemple, 50 M définit la limite de bande passante à 50 MB/s.

--bigfile-threshold

SizeSuffix

Seuil (en octets) pour activer le téléversement, le téléchargement ou la copie multipartis pour les fichiers volumineux. Valeur par défaut : 104857600.

--cache-control

string

Définit le comportement de mise en cache lorsque l'objet est téléchargé par un navigateur web.

--content-disposition

string

Indique comment l'objet doit être affiché.

--content-encoding

string

Déclare la méthode d'encodage de l'objet.

--content-type

string

Type de contenu de l'objet.

--copy-props

string

Détermine les propriétés à copier depuis l'objet source. Valeurs valides :

• none

• metadata

• default

--checkpoint-dir

string

• Si aucun chemin de répertoire de point de contrôle n'est spécifié, le téléversement récupérable est désactivé.

• Si un répertoire est spécifié, le téléversement récupérable est activé et les fichiers de point de contrôle sont enregistrés dans le sous-répertoire .ossutil_checkpoint sous le chemin indiqué.

-d, --dirs

string

Liste les fichiers et sous-répertoires du répertoire courant sans lister récursivement tous les fichiers des sous-répertoires.

--encoding-type

string

Méthode d'encodage pour les noms d'objets ou de fichiers en entrée. Valeur valide : url.

--end-with

string

Renvoie les objets qui précèdent ou correspondent à la valeur spécifiée dans l'ordre alphabétique.

--exclude

stringArray

Règles d'exclusion pour les chemins ou les noms de fichiers.

--exclude-from

stringArray

Lit les règles d'exclusion depuis un fichier de règles.

--expires

stringArray

Spécifie la date d'expiration absolue pour le contenu mis en cache.

--files-from

stringArray

Lit une liste de noms de fichiers sources depuis un fichier, en ignorant les lignes vides et les commentaires. S'applique uniquement aux scénarios de filtrage.

--files-from-raw

stringArray

Lit une liste de noms de fichiers sources depuis un fichier. S'applique uniquement aux scénarios de filtrage.

--filter

stringArray

Règles de filtrage pour les chemins ou les noms de fichiers.

--filter-from

stringArray

Lit les règles de filtrage depuis un fichier de règles.

-f, --force

/

Force l'opération sans demander de confirmation.

--include

stringArray

Règles d'inclusion pour les chemins ou les noms de fichiers.

--include-from

stringArray

Lit les règles d'inclusion depuis un fichier de règles.

-j, --job

int

Nombre de tâches simultanées. Valeur par défaut : 3.

--listObjects

/

Utilise l'API ListObjects pour lister les objets.

--max-size

SizeSuffix

Taille maximale de fichier à transférer. L'unité par défaut est l'octet. Vous pouvez également utiliser des suffixes : B|K|M|G|T|P. Remarque : 1K (KiB) = 1024B.

--metadata

strings

Métadonnées définies par l'utilisateur pour l'objet, au format key=value.

--metadata-directive

string

Définit comment appliquer les métadonnées à l'objet de destination. Valeurs valides :

• COPY

• REPLACE

--metadata-exclude

stringArray

Règles d'exclusion pour les métadonnées d'objet.

--metadata-filter

stringArray

Règles de filtrage pour les métadonnées d'objet.

--metadata-filter-from

stringArray

Lit les règles de filtrage des métadonnées d'objet depuis un fichier de règles.

--metadata-include

stringArray

Règles d'inclusion pour les métadonnées d'objet.

--min-age

Duration

Téléverse uniquement les fichiers modifiés avant l'intervalle de temps spécifié. L'unité par défaut est la seconde. Vous pouvez utiliser des suffixes tels que h (heures). Exemple : 1h signifie 1 heure.

--max-age

Duration

Téléverse uniquement les fichiers modifiés dans l'intervalle de temps spécifié. L'unité par défaut est la seconde. Vous pouvez utiliser des suffixes tels que h (heures). Exemple : 1h signifie 1 heure.

--min-mtime

Time

Téléverse uniquement les fichiers modifiés après l'heure spécifiée, par exemple 2006-01-02T15:04:05.

--max-mtime

Time

Téléverse uniquement les fichiers modifiés avant l'heure spécifiée, par exemple 2006-01-02T15:04:05.

--min-size

SizeSuffix

Taille minimale de fichier à transférer. L'unité par défaut est l'octet. Vous pouvez également utiliser des suffixes : B|K|M|G|T|P. Remarque : 1K (KiB) = 1024B.

--no-progress

/

Ne pas afficher la barre de progression.

--page-size

int

Nombre maximal d'objets listés par page lors d'un téléversement par lot. Valeur par défaut : 1000. Plage valide : 1–1000.

--parallel

int

Nombre de tâches simultanées pour les opérations internes sur un seul fichier.

--part-size

SizeSuffix

Taille des parties pour le téléversement multipartis. Par défaut, ossutil calcule une taille de partie appropriée en fonction de la taille du fichier. Plage valide : 100 KiB–5 GiB.

-r, --recursive

/

Exécute l'opération de manière récursive. Lorsque cette option est spécifiée, la commande s'applique à tous les objets correspondants dans le bucket. Sinon, elle s'applique uniquement à l'objet spécifié par le chemin.

--request-payer

string

Mode de paiement pour la requête. Définissez ce paramètre si le bucket utilise le mode pay-by-requester. Valeur valide : requester.

--size-only

/

Téléverse uniquement les fichiers sources dont la taille diffère de celle des fichiers de destination.

--storage-class

string

Classe de stockage de l'objet. Valeurs valides :

• Standard : Stockage standard.

• IA : Stockage à accès peu fréquent.

• Archive : Archive Storage.

• ColdArchive : Stockage Cold Archive.

• DeepColdArchive : Stockage Deep Cold Archive.

--tagging

strings

Tags pour l'objet, au format key=value.

--tagging-directive

string

Définit comment appliquer les tags à l'objet de destination. Valeurs valides :

• COPY

• REPLACE

-u, --update

/

Ignore les fichiers qui existent déjà à la destination et dont l'heure de modification est plus récente que celle des fichiers sources.

--ignore-existing

/

Ignore les fichiers qui existent déjà à la destination.

--enable-symlink-dir

/

Suit et téléverse les sous-répertoires liés symboliquement (symlink) pendant le téléversement. Par défaut, la commande cp ignore les sous-répertoires liés symboliquement lors du téléversement d'un répertoire. Lorsque cette option est spécifiée, la commande téléverse récursivement le contenu des sous-répertoires liés symboliquement.

Paramètre

Valeur recommandée

Description

-j, --job

10

Nombre de tâches simultanées pour le téléversement de plusieurs fichiers. Valeur par défaut : 3. Cette option ne prend effet que si vous spécifiez également -f, --update, --size-only ou --ignore-existing.

--parallel

10

Nombre de tâches simultanées pour les opérations internes (telles que les téléversements multipartis) sur un seul fichier. L'augmentation de cette valeur accélère le téléversement d'un seul fichier volumineux.

--checkpoint-dir

/path/to/checkpoint

Répertoire utilisé pour le téléversement récupérable.