This topic describes how to run the config command to create a configuration file that is used to store Object Storage Service (OSS) access information. You can add the -c option when you run other commands. This way, ossutil uses configurations in the specified configuration file to access OSS.

Important Sample command lines in this topic are based on the 64-bit Linux system. For other systems, replace ./ossutil64 in the commands with the corresponding binary name. For more information, see ossutil.

Command syntax

You can run the command in interactive or non-interactive mode. In interactive mode, you must complete related configurations by using a configuration file before you run the config command. When you run the config command, ossutil directly reads configurations from the configuration file. In non-interactive mode, you must specify configuration items when you run the config command. Compared with the non-interactive mode, the interactive mode provides higher security.

Run the command in non-interactive mode by using the following command syntax:

./ossutil64 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>]

The following table describes the configuration items.

Configuration itemDescription
-e, --endpointThe endpoint of the region in which the bucket is located. For more information, see Regions and endpoints. To specify the protocol that ossutil uses to access OSS, add http:// or https://. The default protocol is HTTP.
-i, --access-key-idThe AccessKey ID in the [Credentials] section of the configuration file. For more information about how to view the AccessKey ID information, see Obtain an AccessKey pair.
-k, --access-key-secretThe AccessKey secret in the [Credentials] section of the configuration file. For more information about how to view the AccessKey secret information, see Obtain an AccessKey pair.
-t, --sts-tokenThe Security Token Service (STS) token used to access OSS. You need to configure this item only when you use STS for temporary access to OSS. For more information about how to generate an STS token, see the "Temporary access credential" section in Authorized third-party upload.
--ram-role-arnThe Alibaba Cloud Resource Name (ARN) of the Resource Access Management (RAM) role used to authenticate requests. You need to configure this item only when you call AssumeRole to access OSS as a RAM user.
-L languageThe language that is used by ossutil. Default value: CH. Valid values:
  • CH: Chinese. If you plan to set this configuration item to CH, make sure that your system supports UTF-8 encoding.
  • EN: English.
--output-dirThe directory in which the output objects are located. Output objects include report objects generated due to errors that occur when you run the cp command to copy multiple objects.

Default value: the ossutil_output directory in the current directory.

-c, --config-fileThe configuration file path of ossutil. ossutil reads the configuration file during startup.

Examples

  • Generate a configuration file in interactive mode
    ./ossutil64 config
    Enter the name of the configuration file. The file name can contain a path. The default path is /home/user/.ossutilconfig. If you press Enter without specifying a different destination, the file will be generated in the default path. 
    If you want to generate the file in another path, set the --config-file option to the path. 
    If you do not enter the path of the configuration file, the default configuration file /home/user/.ossutilconfig is used.  
    If you press the Enter key without configuring the following parameters, these parameters are ignored. To obtain 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
  • Generate a configuration file in non-interactive mode
    ./ossutil64 config -e oss-cn-beijing.aliyuncs.com -i LTAIbZcdVCmQ**** -k D26oqKBudxDRBg8Wuh2EWDBrM0****  -L CH -c /myconfig

    If you specify options other than -L language and -c, --config-file when you run the config command, the non-interactive mode is used. Then, you must use options to specify all configuration items.

Modify the configuration file

Important
  • In ossutil V1.7.15 and later, you do not need to specify Bucket-Endpoint or Bucket-Cname if you use the interactive mode. You can specify an endpoint or a CNAME for each bucket in the configuration file.
  • ossutil allows you to specify endpoints by using different methods. The following endpoint configurations take effect in descending order: endpoints specified by the --endpoint option in the command, endpoints specified in [Bucket-Cname], endpoints specified in [Bucket-Endpoint], and endpoints specified in [Credentials].
You can modify OSS access information by modifying the generated configuration file. The configuration file of ossutil is in the following format:
[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: Specify an endpoint for each specified bucket.
  • Bucket-Cname: Configure a CNAME for each specified bucket. For more information about CNAMEs, see Map custom domain names.
  • AkService: This item is required if you need to use a RAM role bound to an Elastic Compute Service (ECS) instance to perform operations on OSS. When you configure this item, you need only to set EcsRamRoleTesting to the name of the RAM role bound to the ECS instance. After you configure this item, you can ignore the AccessKey ID, AccessKey Secret, and STSToken items. If you configure AccessKey ID, the AkService configuration does not take effect. The AccessKey ID, AccessKey Secret, and STSToken configurations are used to verify your identity. For more information about how to bind a RAM role to an ECS instance, see Attach an instance RAM role to an ECS instance.
  • Default: You can specify this option if you want to modify the default values of common parameters. For more information about the options, see View options.
    Note The Default option is supported only in ossutil V1.7.15 and later.