すべてのプロダクト
Search

このプロダクト

    Object Storage Service:config

    ドキュメントセンター

    Object Storage Service:config

    最終更新日:May 08, 2025

    このトピックでは、config コマンドを実行して、Object Storage Service (OSS) アクセス情報を保存するために使用される構成ファイルを作成する方法について説明します。-c オプションは、他のコマンドを実行するときに追加できます。このようにして、ossutil は特定の構成ファイルの構成を使用して OSS にアクセスします。

    重要

    ossutil 1.6.16 以降では、コマンドラインでバイナリ名として ossutil を直接使用できます。オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 1.6.16 より前の ossutil の場合は、オペレーティングシステムに基づいてバイナリ名を更新する必要があります。詳細については、「ossutil コマンドリファレンス」をご参照ください。

    コマンド構文

    config コマンドは、インタラクティブモードまたは非インタラクティブモードで実行できます。インタラクティブモードでは、config コマンドを実行する前に、構成ファイルを使用して関連する構成を完了する必要があります。 config コマンドを実行すると、ossutil は構成ファイルから構成を直接読み取ります。非インタラクティブモードでは、config コマンドを実行するときにパラメータを指定する必要があります。非インタラクティブモードと比較して、インタラクティブモードはより高いセキュリティを提供します。

    次のコマンド構文を使用して、非インタラクティブモードで config コマンドを実行します。

    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>]

    次の表は、上記のオプションについて説明しています。

    オプション

    説明

    -e, --endpoint

    バケットが配置されているリージョンのエンドポイント。詳細については、「リージョンとエンドポイント」をご参照ください。 ossutil が OSS にアクセスするために使用するプロトコルを指定するには、http:// または https:// を追加します。デフォルトのプロトコルは HTTP です。

    -i, --access-key-id

    構成ファイルの [Credentials] セクションにある AccessKey ID。 AccessKey ID の表示方法の詳細については、「AccessKey ペアの作成」をご参照ください。

    -k, --access-key-secret

    構成ファイルの [Credentials] セクションにある AccessKey シークレット。 AccessKey シークレットの表示方法の詳細については、「AccessKey ペアの作成」をご参照ください。

    -t, --sts-token

    OSS へのアクセスに使用される Security Token Service (STS) トークン。このパラメータは、STS 一時アクセス認証情報を使用して OSS にアクセスする場合にのみ必要です。 STS トークンの生成方法の詳細については、「STS によって提供される一時的なアクセス認証情報を使用して OSS にアクセスする」をご参照ください。

    --ram-role-arn

    認証用の RamRoleArn モードの RAM ロールの Alibaba Cloud Resource Name (ARN)。このパラメータは、AssumeRole を呼び出して RAM ユーザーとして OSS にアクセスする場合にのみ構成する必要があります。

    -L language

    ossutil が使用する言語。値：

    • CH: 中国語。このパラメータを CH に設定する場合は、システムが UTF-8 エンコーディングをサポートしていることを確認してください。

    • EN: 英語。

    --output-dir

    出力オブジェクトが保存されるディレクトリ。出力オブジェクトには、cp コマンドを実行して複数のオブジェクトを同時にコピーするときに発生するエラーが原因で生成されるレポートオブジェクトが含まれます。

    デフォルトでは、出力オブジェクトの保存に使用されるディレクトリは、現在のディレクトリの ossutil_output です。

    -c, --config-file

    ossutil 構成ファイルのパス。 ossutil が起動されると、構成ファイルからパスを読み取ります。

    例

    • インタラクティブモードで構成ファイルを生成する

      ossutil config
構成ファイルの名前を指定します。ファイル名にはファイルパスを含めることができます。デフォルトのファイル名は /home/user/.ossutilconfig です。ファイルパスを指定せずに Enter キーを押すと、構成ファイルはデフォルトパスに生成されます。
構成ファイルを別のパスに保存する場合は、--config-file オプションをファイルパスに設定します。
構成ファイルのパスを指定しない場合は、/home/user/.ossutilconfig という名前のデフォルトの構成ファイルが使用されます。
以下のパラメータを指定せずに Enter キーを押すと、これらのパラメータは無視されます。パラメータの詳細については、help config コマンドを実行してください。
エンドポイントを入力してください: https://oss-cn-shenzhen.aliyuncs.com
AccessKey ID を入力してください: yourAccessKeyID
AccessKey シークレットを入力してください: yourAccessKeySecret
STS トークンを入力してください: yourStsToken

    • 非インタラクティブモードで構成ファイルを生成する

      ossutil config -e oss-cn-beijing.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret -L CH -c /myconfig

      -L language と -c, --config-file を除くパラメータを config コマンドの実行時に指定すると、非インタラクティブモードが使用されます。次に、すべてのパラメータを指定する必要があります。

    構成ファイルを変更する

    重要

    • ossutil V1.7.15 以降では、インタラクティブモードを使用する場合、Bucket-Endpoint または Bucket-Cname を指定する必要はありません。構成ファイルでバケットごとにエンドポイントまたは CNAME を指定できます。

    • ossutil では、さまざまな方法でエンドポイントを指定できます。次のエンドポイント構成は、降順で有効になります。コマンドの --endpoint オプションで指定されたエンドポイント、[Bucket-Cname] セクションで指定されたエンドポイント、[Bucket-Endpoint] セクションで指定されたエンドポイント、[Credentials] セクションで指定されたエンドポイント。

    生成された構成ファイルを変更することで、OSS アクセス情報を変更できます。 ossutil の構成ファイルの形式は次のとおりです。

    [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: 指定された各バケットのエンドポイントを指定します。

    • Bucket-Cname: 指定された各バケットの CNAME を指定します。 CNAME の詳細については、「カスタムドメイン名をマッピングする」をご参照ください。

    • AkService: Elastic Compute Service (ECS) インスタンスにアタッチされた RAM ロールを使用して OSS で操作を実行する場合に、このオプションが必要です。このオプションを指定する場合は、EcsRamRoleTesting を ECS インスタンスにアタッチされた RAM ロールの名前に設定するだけです。このオプションを指定した後、AccessKey ID、AccessKey Secret、および STSToken パラメータを指定する必要はありません。 AccessKey ID を指定した場合、AkService 構成は有効になりません。 AccessKey ID、AccessKey Secret、および STSToken 構成は、ID を検証するために使用されます。 RAM ロールを ECS インスタンスにアタッチする方法の詳細については、「インスタンス RAM ロール」をご参照ください。

    • Default: 共通パラメータのデフォルト値を変更する場合に、このオプションを指定できます。詳細については、「オプションを表示する」をご参照ください。

      説明

      ossutil V1.7.15 以降のみが Default オプションをサポートしています。