Exécutez la commande config pour créer un fichier de configuration - Object Storage Service

Cette rubrique explique comment exécuter la commande config pour créer un fichier de configuration stockant les informations d'accès à Object Storage Service (OSS). Ajoutez l'option -c lors de l'exécution d'autres commandes afin qu'ossutil utilise les configurations d'un fichier spécifique pour accéder à OSS.

Important

À partir de la version 1.6.16 d'ossutil, utilisez directement ossutil comme nom binaire dans la ligne de commande. Inutile d'adapter le nom binaire au système d'exploitation. Pour les versions antérieures à la 1.6.16, adaptez le nom binaire selon le système d'exploitation. Pour plus d'informations, consultez Prise en main rapide de l'outil de ligne de commande ossutil.

Syntaxe de la commande

Exécutez la commande config en mode interactif ou non interactif. En mode interactif, finalisez les configurations via un fichier avant d'exécuter la commande ; ossutil lit alors directement les configurations depuis ce fichier. En mode non interactif, spécifiez les paramètres lors de l'exécution de la commande. Le mode interactif offre une sécurité supérieure au mode non interactif.

Pour exécuter la commande config en mode non interactif, utilisez la syntaxe suivante :

ossutil config 
[-e, --endpoint <value>] 
[-i, --access-key-id <value>] 
[-k, --access-key-secret <value>] 
[-t, --sts-token <value>]
[--ram-role-arn <value>]
[-L language <value>] 
[--output-dir <value>] 
[-c, --config-file <value>]

Le tableau suivant décrit les options précédentes.

Option	Description
-e, --endpoint	Endpoint de la région où se trouve le bucket. Pour plus d'informations, consultez Régions et endpoints. Pour spécifier le protocole utilisé par ossutil pour accéder à OSS, ajoutez `http://` ou `https://`. Le protocole par défaut est HTTP.
-i, --access-key-id	AccessKey ID figurant dans la section [Credentials] du fichier de configuration. Pour savoir comment consulter l'AccessKey ID, consultez Obtenir une paire de clés AccessKey.
-k, --access-key-secret	AccessKey Secret figurant dans la section [Credentials] du fichier de configuration. Pour savoir comment consulter l'AccessKey Secret, consultez Obtenir une paire de clés AccessKey.
-t, --sts-token	Jeton Security Token Service (STS) utilisé pour accéder à OSS. Ce paramètre est requis uniquement si vous utilisez des identifiants d'accès temporaires STS. Pour savoir comment générer un jeton STS, consultez Accéder à OSS à l'aide d'identifiants temporaires STS.
--ram-role-arn	Alibaba Cloud Resource Name (ARN) du rôle RAM utilisé pour l'authentification en mode RamRoleArn. Configurez ce paramètre uniquement si vous appelez AssumeRole pour accéder à OSS en tant qu'utilisateur RAM.
-L language	Langue utilisée par ossutil. Valeurs possibles : CH : chinois. Si vous définissez ce paramètre sur CH, assurez-vous que votre système prend en charge l'encodage UTF-8. EN : anglais.
--output-dir	Répertoire de stockage des objets de sortie. Ces objets incluent les rapports générés suite aux erreurs survenues lors de l'exécution de la commande cp pour copier plusieurs objets simultanément. Par défaut, le répertoire de stockage des objets de sortie est ossutil_output dans le répertoire courant.
-c, --config-file	Chemin d'accès au fichier de configuration ossutil. Au démarrage, ossutil lit le chemin d'accès depuis le fichier de configuration.

Exemples

Générer un fichier de configuration en mode interactif

ossutil config
Specify the name of the configuration file. The file name can contain the file path. The default file name is /home/user/.ossutilconfig. If you press the Enter key without specifying a file path, the configuration file is generated in the default path. 
If you want to store the configuration file in another path, set the --config-file option to the file path. 
If you do not specify the path of the configuration file, the default configuration file named /home/user/.ossutilconfig is used.  
If you press the Enter key without specifying the following parameters, these parameters are ignored. For more information about the parameters, run the help config command.  
Enter the endpoint: https://oss-cn-shenzhen.aliyuncs.com 
Enter the AccessKey ID: yourAccessKeyID 
Enter the AccessKey secret: yourAccessKeySecret
Enter the STS token: yourStsToken

Générer un fichier de configuration en mode non interactif
```
ossutil config -e oss-cn-beijing.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret -L CH -c /myconfig
```
Si vous spécifiez des paramètres autres que -L language et -c, --config-file lors de l'exécution de la commande config, le mode non interactif s'active. Vous devez alors spécifier tous les paramètres.

Modifier le fichier de configuration

Important

À partir de la version 1.7.15 d'ossutil, inutile de spécifier Bucket-Endpoint ou Bucket-Cname en mode interactif. Spécifiez un endpoint ou un CNAME pour chaque bucket directement dans le fichier de configuration.
ossutil permet de spécifier les endpoints via différentes méthodes. L'ordre de priorité des configurations d'endpoint est le suivant (du plus prioritaire au moins prioritaire) : endpoints spécifiés par l'option --endpoint dans la commande, endpoints spécifiés dans la section [Bucket-Cname], endpoints spécifiés dans la section [Bucket-Endpoint], et endpoints spécifiés dans la section [Credentials].

Modifiez les informations d'accès à OSS en éditant le fichier de configuration généré. Le fichier de configuration ossutil respecte le format suivant :

[Credentials]
        language = CH
        endpoint = oss.aliyuncs.com
        accessKeyID = your_accesskey_id
        accessKeySecret = your_accesskey_secret
        stsToken = your_sts_token
        outputDir = your_output_dir
        ramRoleArn = your_ram_role_arn
[Bucket-Endpoint]
        bucket1 = endpoint1
        bucket2 = endpoint2
        ...
[Bucket-Cname]
        bucket1 = cname1
        bucket2 = cname2
        ...
[AkService]
        ecsAk=http://100.100.100.200/latest/meta-data/ram/security-credentials/EcsRamRoleTesting
[Default]
        userAgent = user_agent
        loglevel = log_level
        proxyHost = proxy_host
        proxyUser = proxy_user
        proxyPwd = proxy_pwd
        readTimeOut = read_time_out
        connectTimeOut = connect_time_out
        retryTimes = retry_times

Bucket-Endpoint : spécifiez un endpoint pour chaque bucket indiqué.
Bucket-Cname : spécifiez un CNAME pour chaque bucket indiqué. Pour plus d'informations sur les CNAME, consultez Lier un nom de domaine personnalisé.
AkService : cette option est requise si vous souhaitez utiliser un rôle RAM attaché à une instance Elastic Compute Service (ECS) pour effectuer des opérations sur OSS. Lorsque vous spécifiez cette option, définissez simplement EcsRamRoleTesting avec le nom du rôle RAM attaché à l'instance ECS. Une fois cette option configurée, inutile de spécifier les paramètres AccessKey ID, AccessKey Secret et STSToken. Si vous spécifiez un AccessKey ID, la configuration AkService ne prend pas effet. Les configurations AccessKey ID, AccessKey Secret et STSToken servent à vérifier votre identité. Pour savoir comment attacher un rôle RAM à une instance ECS, consultez Rôles RAM d'instance.
Default : utilisez cette option pour modifier les valeurs par défaut des paramètres courants. Pour plus d'informations, consultez Afficher les options.

Remarque
Seules les versions 1.7.15 et ultérieures d'ossutil prennent en charge l'option Default.