Object Storage Service:View options

Nom de l'option

Description

-s, --short-format

Affiche les résultats en format court. Par défaut : format long.

--bigfile-threshold

Seuil de taille de fichier pour le téléchargement reprenable. Unité : octets. Par défaut : 100 Mo. Plage : 0 à 9223372036854775807.

--acl

Configure la liste de contrôle d'accès (ACL).

--range

Spécifie une plage d'octets basée sur zéro à télécharger à partir d'un fichier.

• Vous pouvez spécifier une plage. Par exemple, 3-9 indique du 3e au 9e octet inclus.

• Vous pouvez spécifier un point de départ, tel que 3-, pour télécharger à partir de l'octet 3 jusqu'à la fin du fichier inclus.

• Vous pouvez spécifier la position de fin. Par exemple, -9 spécifie la plage de l'octet 0 à l'octet 9.

--all-versions

Spécifie toutes les versions d'un objet.

--type

Méthode de validation des données. Valeurs valides :

• crc64 (par défaut) : Effectue une vérification de redondance cyclique 64 bits (CRC64).

• md5 : Effectue une validation MD5.

-v, --version

Affiche la version d'ossutil et quitte.

-u, --update

Effectue une opération de mise à jour.

--origin

Valeur du champ origin dans l'en-tête de requête HTTP.

--upmode

Mode de téléchargement utilisé dans la commande probe. Valeurs valides :

• normal (par défaut) : Téléchargement simple.

• append : Téléchargement par ajout.

• multipart : Téléchargement en plusieurs parties.

--sse-algorithm

Algorithme de chiffrement côté serveur pour le bucket. Valeurs valides :

• KMS : Utilise une clé gérée par Key Management Service (KMS) pour le chiffrement et le déchiffrement, ce qui correspond à SSE-KMS.

• AES256 : Utilise une clé gérée par OSS pour le chiffrement et le déchiffrement, ce qui correspond à SSE-OSS.

--include

Liste les objets qui répondent aux conditions spécifiées. Par exemple, *.jpg liste tous les fichiers au format JPG.

Les options --include et --exclude.

--exclude

Liste les objets qui ne répondent pas aux conditions spécifiées. Par exemple, *.txt liste tous les fichiers qui ne sont pas au format TXT.

Les options --include et --exclude.

-r, --recursive

Opère récursivement sur tous les objets correspondants dans le bucket. Sans cette option, seul l'objet spécifié est concerné.

--addr

Spécifie une adresse réseau pour tester la connectivité via ping.

Valeur par défaut : www.aliyun.com

--kms-masterkey-id

ID de la clé maître cliente (CMK) dans KMS.

--version-id

ID de version de l'objet.

--version-id-marker

Liste les versions d'objets dont les ID suivent alphabétiquement le marqueur spécifié. Nécessite l'activation du versioning.

-m, --multipart

Spécifie que l'opération s'applique aux événements de téléchargement en plusieurs parties incomplets dans le bucket.

-d, --directory

Renvoie uniquement les fichiers et sous-répertoires du répertoire actuel.

--payer

Payeur de la requête. Définissez sur requester pour le mode « paiement par demandeur ».

--maxupspeed

Vitesse maximale de téléchargement. Unité : Ko/s. Par défaut : 0 (aucune limite).

--maxdownspeed

Vitesse maximale de téléchargement descendant. Unité : Ko/s. Par défaut : 0 (aucune limite).

--retry-times

Nombre de tentatives après une erreur. Par défaut : 10. Plage : 1 à 500.

--download

Teste la connectivité réseau en téléchargeant un objet depuis le bucket de destination à l'aide de l'URL du fichier.

-j, --jobs

Nombre de tâches simultanées pour les opérations sur plusieurs fichiers. Par défaut : 3. Plage : 1 à 10000.

-a, --all-type

Spécifie que l'opération s'applique aux objets et aux événements de téléchargement en plusieurs parties incomplets dans le bucket.

--disable-empty-referer

Spécifie que le champ Referer ne peut pas être vide.

--method

Méthode de requête HTTP. Les valeurs valides incluent PUT, GET et DELETE.

--output-dir

Répertoire de sortie pour les fichiers de rapport, tels que les rapports d'échec de copie groupée de la commande cp.

Par défaut : le répertoire ossutil_output dans le répertoire actuel.

--meta

Définit les métadonnées de l'objet. Format : Cache-Control:no-cache#Content-Encoding:gzip.

--object

Spécifie le nom du fichier dans la commande probe.

--end-time

Horodatage UNIX. Si vous utilisez cette option, les objets modifiés après l'heure spécifiée sont ignorés.

--limited-num

Nombre maximal de résultats à renvoyer.

-L, --language

Définit la langue pour ossutil. Valeurs valides :

• CH (par défaut) : Chinois. Si vous définissez la langue sur CH, assurez-vous que l'encodage de votre système est UTF-8.

• EN : Anglais.

--delete

Supprime un bucket, un objet ou un fragment.

-b, --bucket

Utilisez cette option uniquement lorsque vous supprimez un bucket.

--disable-crc64

Désactive la validation CRC64. Par défaut, ossutil active la validation CRC64 pour le transfert de données.

--upload

Teste la connectivité réseau en téléchargeant un fichier local vers le bucket de destination.

--part-size

Taille de la partie. Unité : octets. Par défaut, ossutil calcule la taille de la partie en fonction de la taille du fichier. Plage : 1 à 9223372036854775807.

--timeout

Délai d'expiration de l'URL signée. Unité : secondes. Par défaut : 60. Plage : 0 à 9223372036854775807.

--checkpoint-dir

Répertoire pour les données de point de contrôle de téléchargement/téléchargement reprenable. En cas d'échec, ossutil crée un répertoire .ossutil_checkpoint qui est supprimé après la réussite de l'opération. Assurez-vous que le répertoire spécifié peut être supprimé.

--url

URL du fichier.

--marker

Liste les buckets, objets ou parties dont les noms suivent alphabétiquement le marqueur spécifié.

-f, --force

Force l'opération sans demande de confirmation.

--snapshot-path

Répertoire pour les données de snapshot utilisées dans les téléchargements et téléchargements descendants incrémentiels.

• --snapshot-path accélère les transferts incrémentiels de grands ensembles de fichiers lorsqu'aucun autre utilisateur n'a modifié les objets OSS correspondants entre les opérations. Non pris en charge pour les opérations de copie.

• --snapshot-path enregistre le lastModifiedTime des fichiers transférés avec succès et ignore les fichiers inchangés lors des exécutions suivantes. Si d'autres utilisateurs peuvent modifier les objets OSS, utilisez plutôt --update.

• Les données de snapshot ne sont pas supprimées automatiquement. Effacez le chemin du snapshot lorsqu'il n'est plus nécessaire.

• Cette option ajoute une surcharge d'E/S. Pour les petits ensembles de fichiers ou les objets partagés, utilisez plutôt --update.

• --update et --snapshot-path peuvent être combinés. ossutil vérifie d'abord le snapshot, puis revient à --update.

--start-time

Horodatage UNIX. Si vous utilisez cette option, les objets modifiés avant l'heure spécifiée sont ignorés.

--storage-class

Classe de stockage. Valeurs valides :

• Standard (par défaut) : Pour les données fréquemment consultées.

• IA : Infrequent Access. Pour les données consultées une ou deux fois par mois. Stockage minimum : 30 jours. Taille minimale facturée : 64 Ko. Accès en temps réel avec frais de récupération des données.

• Archive : Archivage de données à long terme. Stockage minimum : 60 jours. Taille minimale facturée : 64 Ko. Nécessite une restauration (~1 minute) avant l'accès. Des frais de récupération des données s'appliquent.

• ColdArchive : Données extrêmement froides nécessitant un stockage à long terme. Stockage minimum : 180 jours. Taille minimale facturée : 64 Ko. Nécessite une restauration avant l'accès ; le temps varie selon la taille des données et le mode de restauration. Des frais de récupération des données s'appliquent.

-t, --sts-token

Jeton STS pour l'accès par identifiants temporaires. Requis uniquement avec les identifiants STS et remplace le paramètre du fichier de configuration. Identifiants d'accès temporaires.

--parallel

Nombre de tâches simultanées pour les opérations sur un seul fichier. Plage : 1 à 10000. Par défaut : déterminé par le type d'opération et la taille du fichier.

--partition-download

Spécifie une partition pour les téléchargements parallèles. Format : partition_number:total_partitions. Par exemple, 1:5 télécharge la partition 1 sur 5. Les numéros de partition commencent à 1. Plusieurs instances ossutil peuvent télécharger différentes partitions en parallèle.

--bucketname

Nom du bucket.

--encoding-type

Encode l'URL de la clé d'objet après oss://bucket_name. Valeur valide : url. Si omis, la clé n'est pas encodée.

--origin

Valeur de l'en-tête de requête HTTP Origin, utilisée pour identifier les requêtes cross-origin.

--acr-method

Valeur de l'en-tête de requête HTTP Access-Control-Request-Method. Les valeurs valides sont GET, PUT, POST, DELETE et HEAD.

--acr-headers

Valeur Access-Control-Request-Headers pour les requêtes de préflight CORS. Séparez plusieurs en-têtes par des virgules et entourez-les de guillemets doubles, par exemple --acr-headers "header1,header2,header3".

--upload-id-marker

Liste les parties dont les ID de téléchargement suivent alphabétiquement le marqueur spécifié.

-h, --help

Affiche les informations d'aide.

--trafic-limit

Limite de vitesse HTTP pour la commande sign. Unité : bit/s.

Par défaut : 0 (aucune limite).

Plage : 819200 à 838860800 (100 Ko/s à 100 Mo/s).

--local-host

Adresse IP locale pour l'accès à OSS dans la commande cp.

--enable-symlink-dir

Télécharge les sous-répertoires liés (ignorés par défaut). Utilisez la commande probe pour détecter les liens symboliques circulaires.

--only-current-dir

Traite uniquement les fichiers du répertoire actuel, en ignorant les sous-répertoires.

--disable-dir-object

Ignore la création d'objets de répertoire lors du téléchargement. La structure du répertoire reste visible dans la console mais disparaît lorsque tous les fichiers qu'il contient sont supprimés.

--probe-item

Cible du test. Valeurs valides :

• upload-speed : Teste la bande passante de téléchargement.

• download-speed : Teste la bande passante de téléchargement descendant.

• cycle-symlink : Vérifie s'il existe des fichiers ou répertoires de lien en boucle infinie dans le répertoire de fichiers local.

--redundancy-type

Type de redondance des données du bucket. Valeurs valides :

• LRS (par défaut) : Le stockage localement redondant (LRS) stocke vos données de manière redondante sur différents périphériques de stockage dans la même zone. Il garantit la durabilité et la disponibilité des données même si deux périphériques de stockage sont endommagés simultanément.

• ZRS : Le stockage redondant interzones (ZRS) utilise un mécanisme de redondance des données multi-zones pour stocker vos données de manière redondante dans plusieurs zones de la même région. Il garantit la disponibilité des données même si une zone devient indisponible.

--disable-encode-slash

N'encode pas la barre oblique (/) dans l'URL.

--disable-all-symlink

Ignore tous les sous-fichiers de lien symbolique et les sous-répertoires de lien symbolique lors du téléchargement.

--tagging

Définit les tags d'objet lors du téléchargement ou de la copie. Format : "abc=1&bcd=2&...".

--disable-ignore-error

Arrête immédiatement en cas d'erreur au lieu de poursuivre les opérations par lots.

--block-size

Unité pour les tailles d'objet en sortie. Valeurs valides : Ko, Mo, Go ou To. Par défaut : octets.