Download and install the command-line tool ossutil - Object Storage Service

ossutil est un outil en ligne de commande qui permet de télécharger rapidement des fichiers volumineux, de récupérer des fichiers et de supprimer des fichiers portant un préfixe spécifique. ossutil fonctionne sur les systèmes d'exploitation Windows, Linux et macOS. Téléchargez et installez la version adaptée à votre environnement.

Nouvelle version disponible

Nous vous recommandons d'utiliser la version améliorée ossutil 2,0. Pour plus d'informations sur l'installation et l'utilisation rapides, consultez la rubrique Install ossutil.

Principales fonctionnalités d'ossutil 2,0 :

Nouvelle structure de commandes : prend en charge les commandes multiniveaux, y compris les commandes au niveau de l'API telles que ossutil api put-bucket-acl et les commandes de haut niveau telles que ossutil config.
Gestion de configuration améliorée : le processus de configuration initiale est simplifié. Il suffit de fournir l'AccessKey ID, l'AccessKey Secret et l'ID de région pour effectuer la configuration de base après l'installation. Vous pouvez également utiliser le paramètre --profile pour spécifier plusieurs fichiers de configuration afin d'offrir une plus grande flexibilité.
Plus de paramètres de filtrage : pour les commandes de traitement par lot telles que ls, cp et rm, l'outil prend en charge diverses conditions de filtrage basées sur le chemin, la taille du fichier, l'heure de modification et les métadonnées d'objet. Cette fonctionnalité améliore considérablement la précision et l'efficacité des opérations.
Formats de sortie flexibles : le paramètre --output-format permet de définir le format de sortie en JSON, YAML ou XML pour répondre à différents besoins de traitement des données. L'option --output-query permet de filtrer la sortie pour récupérer les informations requises.
Sécurité renforcée : pour améliorer la sécurité, ossutil 2,0 permet de définir des paramètres sensibles à l'aide de variables d'environnement. Cela évite d'exposer des clés dans la ligne de commande et réduit le risque de fuites de données. De plus, l'option --dry-run permet de vérifier le comportement d'une commande avant de l'exécuter, ce qui aide à prévenir les opérations involontaires.

Versions

Version actuelle : 1.7.19
Versions précédentes : pour plus d'informations sur le code source et l'historique des versions précédentes d'ossutil, consultez GitHub.

Liens de téléchargement

Lien de téléchargement

Somme de contrôle SHA-256

Linux x86 32 bits

f8a4a7e1df8529b06a3f3cca194a1c99163cb3b8ab3b5d64228c207c3ae63b86

Linux x86 64 bits

dcc512e4a893e16bbee63bc769339d8e56b21744fd83c8212a9d8baf28767343

Linux ARM 32 bits

ffe8b479e5fd3c0e146a14cd32e8ef5736d23f6c8de157944288ee09db2d7b1d

Linux ARM 64 bits

f612c2a88d4d28363e254168d521fac5df632f2547ba84eaebacf6497dc04d57

macOS 64 bits

9cf82a53fe24d8b5cc3dfb441787e0ea19c24dd7a1246653d5f1a28b7923d6fe

macOS ARM 64 bits

10ece4d328c5d2440833adc5f4167168e9b2a4c5d364f673b0c45bcc4fd02ec5

Windows x86 32 bits

772469ef02b91e893f7211acf732c2c07cd93214552ed7cf84157d3d9b9fb799

Windows x86 64 bits

8e9176aedc87d230ccd97dc7236b16564f2a068609ed301acdc73dc27faf7e77

Télécharger et installer ossutil

Linux

Installez ossutil.
```
sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
```
Remarque
- Décompressez le package ossutil avant l'installation. Assurez-vous d'avoir installé un outil de décompression, tel que unzip ou 7z.
- Par défaut, ossutil s'installe dans le répertoire /usr/bin/.

Configurez ossutil.

Saisissez la commande de configuration.
```
ossutil config
```
Lorsque vous y êtes invité, configurez le chemin du fichier de configuration.
```
Please enter the config file name. The file name can include a path. (Default: /home/user/.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
Par défaut, ossutil enregistre le fichier de configuration dans /home/user/.ossutilconfig. Si vous spécifiez un autre chemin pour le fichier de configuration, vous devez ajouter l'option -c pour spécifier le fichier de configuration chaque fois que vous exécutez une commande ossutil. Par exemple, si vous enregistrez le fichier de configuration dans /home/config, exécutez la commande ls au format suivant et incluez l'option -c :
```
ossutil ls oss://examplebucket -c /home/config
```
Lorsque vous y êtes invité, définissez la langue de l'outil. Saisissez CH pour le chinois ou EN pour l'anglais. Par défaut, l'outil utilise la langue de votre système d'exploitation. Ce paramètre prend effet après l'exécution réussie de la commande config.
Définissez la langue de l'outil.

Saisissez CH ou EN. Par défaut, l'outil utilise la même langue que votre système d'exploitation. Cette configuration prend effet après l'exécution de la commande config.

Lorsque vous y êtes invité, définissez les paramètres Endpoint, AccessKey ID, AccessKey Secret et STSToken. Le paramètre STSToken n'est requis que lorsque vous utilisez des informations d'identification temporaires du Security Token Service (STS) pour accéder à OSS. Sinon, laissez ce paramètre vide.

Les paramètres sont décrits comme suit :

Paramètre	Obligatoire	Description
endpoint	Oui	Saisissez l'endpoint de la région où se trouve votre bucket. Par exemple, définissez l'endpoint public sur pour la région ou `https://oss-ap-southeast-1.aliyuncs.com` pour la région Singapore. Pour accéder à OSS depuis d'autres services Alibaba Cloud dans la même région, utilisez un endpoint interne, tel que ou `https://oss-ap-southeast-1-internal.aliyuncs.com`. Pour plus d'informations sur les endpoints de chaque région, consultez la rubrique Regions and endpoints. Important En raison d'un changement de politique visant à améliorer la conformité et la sécurité, à partir du 20 mars 2025, les nouveaux utilisateurs d'OSS doivent utiliser un nom de domaine personnalisé (CNAME) pour effectuer des opérations d'API de données sur les buckets OSS situés dans les régions de Chine continentale. Les endpoints publics par défaut sont restreints pour ces opérations. Consultez l'annonce officielle pour obtenir la liste complète des opérations concernées. Si vous accédez à vos données via HTTPS, vous devez associer un certificat SSL valide à votre domaine personnalisé. Cette opération est obligatoire pour l'accès à la console OSS, car la console impose l'utilisation du protocole HTTPS.
accessKeyID	Oui	Saisissez la paire AccessKey de votre compte. Pour plus d'informations sur l'obtention d'une paire AccessKey, consultez la rubrique Create an AccessKey pair. Créer rapidement une paire AccessKey pour un utilisateur RAM disposant d'autorisations de gestion OSS à l'aide d'un script ROS Sur la page Create Stack de la console Resource Orchestration Service (ROS), cochez la case de confirmation dans la section Security Confirmation, puis cliquez sur Create. Pour plus d'informations, consultez la rubrique Create a stack. Une fois la pile créée, copiez la paire AccessKey créée à partir de l'onglet Outputs. La liste de sortie contient deux éléments de sortie : AccessKeySecret et AccessKeyId. Copiez leurs valeurs respectives.
accessKeySecret	Oui
stsToken	Non	Ce paramètre n'est requis que lorsque vous utilisez des informations d'identification d'accès temporaires pour accéder à OSS. Sinon, laissez ce paramètre vide. Pour plus d'informations sur la génération d'un jeton STS, consultez la rubrique AssumeRole.

Vérifiez que ossutil est installé.
```
ossutil
```
Si une liste des commandes ossutil prises en charge s'affiche, l'installation a réussi.

Windows

Installez ossutil.
1. Cliquez sur le lien de téléchargement pour télécharger le package d'installation Windows.
2. Décompressez le package et double-cliquez sur le fichier ossutil.bat.

Configurez ossutil.

Saisissez la commande de configuration.
```
ossutil config
```
Lorsque vous y êtes invité, définissez le chemin du fichier de configuration.
```
Please enter the config file name. The file name can include a path. (Default: C:\\Users\user\.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
Par défaut, ossutil enregistre le fichier de configuration dans C:\\Users\user\.ossutilconfig. Si vous spécifiez un autre chemin pour le fichier de configuration, vous devez ajouter l'option -c pour spécifier le fichier de configuration chaque fois que vous exécutez une commande. Par exemple, si le fichier de configuration est enregistré dans c:\ossutil\config, exécutez la commande ls au format suivant :
```
ossutil ls oss://examplebucket -c c:\ossutil\config
```
Lorsque vous y êtes invité, définissez la langue de l'outil. Saisissez CH pour le chinois ou EN pour l'anglais. Par défaut, l'outil utilise la langue de votre système d'exploitation. Cette configuration prend effet après l'exécution de la commande config.

Lorsque vous y êtes invité, définissez les paramètres Endpoint, AccessKey ID, AccessKey Secret et STSToken. Le paramètre STSToken n'est requis que lorsque vous utilisez des informations d'identification temporaires du STS pour accéder à OSS. Sinon, laissez ce paramètre vide.

Le tableau suivant décrit les paramètres.

Paramètre	Obligatoire	Description
endpoint	Oui	Saisissez l'endpoint de la région où se trouve votre bucket. Par exemple, définissez l'endpoint public sur pour la région ou `https://oss-ap-southeast-1.aliyuncs.com` pour la région Singapore. Pour accéder à OSS depuis d'autres services Alibaba Cloud dans la même région, utilisez un endpoint interne, tel que ou `https://oss-ap-southeast-1-internal.aliyuncs.com`. Pour plus d'informations sur les endpoints de chaque région, consultez la rubrique Regions and endpoints. Important En raison d'un changement de politique visant à améliorer la conformité et la sécurité, à partir du 20 mars 2025, les nouveaux utilisateurs d'OSS doivent utiliser un nom de domaine personnalisé (CNAME) pour effectuer des opérations d'API de données sur les buckets OSS situés dans les régions de Chine continentale. Les endpoints publics par défaut sont restreints pour ces opérations. Consultez l'annonce officielle pour obtenir la liste complète des opérations concernées. Si vous accédez à vos données via HTTPS, vous devez associer un certificat SSL valide à votre domaine personnalisé. Cette opération est obligatoire pour l'accès à la console OSS, car la console impose l'utilisation du protocole HTTPS.
accessKeyID	Oui	Saisissez la paire AccessKey de votre compte. Pour plus d'informations sur l'obtention d'une paire AccessKey, consultez la rubrique Create an AccessKey pair. Créer rapidement une paire AccessKey pour un utilisateur RAM disposant d'autorisations de gestion OSS à l'aide d'un script ROS Sur la page Create Stack de la console Resource Orchestration Service (ROS), cochez la case de confirmation dans la section Security Confirmation, puis cliquez sur Create. Pour plus d'informations, consultez la rubrique Create a stack. Une fois la pile créée, copiez la paire AccessKey créée à partir de l'onglet Outputs. Les mots-clés de sortie incluent AccessKeyId et AccessKeySecret. Copiez leurs valeurs respectives et conservez-les en toute sécurité.
accessKeySecret	Oui
stsToken	Non	Ce paramètre n'est requis que lorsque vous utilisez des informations d'identification d'accès temporaires pour accéder à OSS. Sinon, laissez ce paramètre vide. Pour plus d'informations sur la génération d'un jeton STS, consultez la rubrique AssumeRole.

Vérifiez que ossutil est installé.
```
ossutil
```
Si une liste des commandes ossutil prises en charge s'affiche, l'installation a réussi.

macOS

Installez ossutil.
```
sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
```
Remarque
Le répertoire d'installation par défaut est /usr/local/bin.

Configurez ossutil.

Saisissez la commande de configuration.
```
ossutil config
```
Lorsque vous y êtes invité, définissez le chemin du fichier de configuration.
```
Please enter the config file name. The file name can include a path. (Default: /Users/user/.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
Par défaut, ossutil enregistre le fichier de configuration dans /Users/user/.ossutilconfig.

Si vous spécifiez un autre chemin pour le fichier de configuration, vous devez ajouter l'option -c pour spécifier le fichier de configuration chaque fois que vous exécutez une commande. Par exemple, si le fichier de configuration est enregistré dans /home/config, exécutez la commande ls au format suivant :
```
ossutil ls oss://examplebucket -c /home/config
```
Lorsque vous y êtes invité, définissez la langue de l'outil. Saisissez CH pour le chinois ou EN pour l'anglais. Par défaut, l'outil utilise la langue de votre système d'exploitation. Cette configuration prend effet après l'exécution de la commande config.

Lorsque vous y êtes invité, définissez les paramètres Endpoint, AccessKey ID, AccessKey Secret et STSToken. Le paramètre STSToken n'est requis que lorsque vous utilisez des informations d'identification temporaires du STS pour accéder à OSS. Sinon, laissez ce paramètre vide.

Le tableau suivant décrit les paramètres.

Paramètre	Obligatoire	Description
endpoint	Oui	Saisissez l'endpoint de la région où se trouve votre bucket. Par exemple, définissez l'endpoint public sur pour la région ou `https://oss-ap-southeast-1.aliyuncs.com` pour la région Singapore. Pour accéder à OSS depuis d'autres services Alibaba Cloud dans la même région, utilisez un endpoint interne, tel que ou `https://oss-ap-southeast-1-internal.aliyuncs.com`. Pour plus d'informations sur les endpoints de chaque région, consultez la rubrique Regions and endpoints. Important En raison d'un changement de politique visant à améliorer la conformité et la sécurité, à partir du 20 mars 2025, les nouveaux utilisateurs d'OSS doivent utiliser un nom de domaine personnalisé (CNAME) pour effectuer des opérations d'API de données sur les buckets OSS situés dans les régions de Chine continentale. Les endpoints publics par défaut sont restreints pour ces opérations. Consultez l'annonce officielle pour obtenir la liste complète des opérations concernées. Si vous accédez à vos données via HTTPS, vous devez associer un certificat SSL valide à votre domaine personnalisé. Cette opération est obligatoire pour l'accès à la console OSS, car la console impose l'utilisation du protocole HTTPS.
accessKeyID	Oui	Saisissez la paire AccessKey de votre compte. Pour plus d'informations sur l'obtention d'une paire AccessKey, consultez la rubrique Create an AccessKey pair. Créer rapidement une paire AccessKey pour un utilisateur RAM disposant d'autorisations de gestion OSS à l'aide d'un script ROS Sur la page Create Stack de la console Resource Orchestration Service (ROS), cochez la case de confirmation dans la section Security Confirmation, puis cliquez sur Create. Pour plus d'informations, consultez la rubrique Create a stack. Une fois la pile créée, copiez la paire AccessKey créée à partir de l'onglet Outputs. Les mots-clés de sortie incluent AccessKeyId et AccessKeySecret. Copiez leurs valeurs respectives et conservez-les en toute sécurité.
accessKeySecret	Oui
stsToken	Non	Ce paramètre n'est requis que lorsque vous utilisez des informations d'identification d'accès temporaires pour accéder à OSS. Sinon, laissez ce paramètre vide. Pour plus d'informations sur la génération d'un jeton STS, consultez la rubrique AssumeRole.

Vérifiez que ossutil est installé.
```
ossutil
```
Si une liste des commandes ossutil prises en charge s'affiche, l'installation a réussi.

Références

Après avoir installé ossutil, vous pouvez l'utiliser pour charger, télécharger, copier et supprimer des objets. Pour plus d'informations, consultez les rubriques cp (télécharger des objets), cp (télécharger des objets), cp (copier des objets) et rm (supprimer des objets).