config コマンドは、OSS アクセス情報を保存するための設定ファイルを作成する場合に使用します。 -c オプションを他のコマンドに追加して、OSS アクセス情報を提供することができます。

コマンド構文

./ossutil config [-e endpoint] [-i id] [-k key] [-t token] [-L language] [--output-dir outdir] [-c file]
このコマンドは、インタラクティブモードと非インタラクティブモードの両方で使用できます。 セキュリティを確保するため、インタラクティブモードでコマンドを実行することを推奨します。

  • インタラクティブモードで設定ファイルを生成する
    ./ossutil config
    This command generates a configuration file. Enter the path of the configuration file. The default path is /home/user/.ossutilconfig. If you press Enter without specifying a different destination, the file is generated in the default path. If you want to generate the file in another path, set the --config-file option to the path. 
    If no configuration file path is entered, the default configuration file path /home/user/.ossutilconfig is used. 
    The following parameters are ignored if you press Enter without configuring them. For more information about the parameters, run the help config command. 
    Enter the endpoint: http://oss-cn-shenzhen.aliyuncs.com 
    Enter the AccessKey ID: yourAccessKeyID 
    Enter the AccessKey secret: yourAccessKeySecret
    Enter the STS token: 
    • endpoint:バケットが属するリージョンのドメイン名を指定します。 詳細は、「リージョンとエンドポイント」をご参照ください。
    • accessKeyID:AccessKey ID を表示する方法の詳細は、「AccessKey の作成」をご参照ください。
    • accessKeySecret:AccessKey Secret を表示する方法の詳細は、「AccessKey の作成」をご参照ください。
    • stsToken:このオプションは、一時的な STS トークンを使用して OSS バケットにアクセスする場合にのみ必要です。 それ以外の場合、このパラメーターを未指定のままにすることができます。 STS トークンを生成する方法の詳細は、「一時的なアクセス資格情報」をご参照ください。
  • 非インタラクティブモードで設定ファイルを生成する
    ./ossutil config -e oss-cn-beijing.aliyuncs.com -i LTAIbZcdVCmQ**** -k D26oqKBudxDRBg8Wuh2EWDBrM0****  -L CH -c /myconfig

    config コマンドに --language--config-file 以外のオプションを指定して実行した場合、非インタラクティブモードが使用されます。 すべての設定項目は、オプションを使用して指定します。

設定ファイルの形式

生成された設定ファイル内の OSS アクセス情報を変更できます。 設定ファイルの形式は次のとおりです。
[Credentials]
        language = CH
        endpoint = oss.aliyuncs.com
        accessKeyID = your_key_id
        accessKeySecret = your_key_secret
        stsToken = your_sts_token
        outputDir = your_output_dir
[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
  • Bucket-Endpoint:各バケットのエンドポイントを指定します。 Bucket-Endpoint オプションを設定した場合、バケットに対して操作を実行するとき、指定したエンドポイントが検索されます。 指定したエンドポイントが存在する場合、そのエンドポイントを使用してバケットが管理されます。 指定したエンドポイントが存在しない場合、Credentials オプションで指定したエンドポイントを使用してバケットが管理されます。
  • Bucket-Cname:各バケットのオリジンドメインを指定します。 Bucket-Cname オプションを設定した場合、バケットに対して操作を実行するとき、指定したオリジンドメインが検索されます。 指定したオリジンドメインが存在する場合、Bucket-Endpoint オプションと Credentials オプションで指定したエンドポイントはオリジンドメインに置き換えられます。 オリジンドメインの詳細は、「CNAME の設定」をご参照ください。
  • AkService:デフォルトでは、このオプションは追加されません。 ECS インスタンスにバインドされた RAM ロールを使用して OSS に対する操作を実行する必要がある場合、このオプションが必要です。 このオプションを設定するとき、ECS インスタンスにバインドされた RAM ロールに EcsRamRoleTesting を設定する必要があります。 AkService オプションを設定した後、accessKeyID、accessKeySecret、stsToken オプションを設定する必要はありません。 これらのオプションを設定した場合、AkService オプションではなく、これらのオプションの設定が有効になります。 RAM ロールを ECS インスタンスにバインドする方法の詳細は、「コンソールでの RAM ロールの使用」をご参照ください。 RAM ロールを ECS インスタンスにバインドする方法の詳細は、「コンソールでのインスタンス RAM ロールの使用」をご参照ください。
重要
  • ossutil の新バージョンでは、インタラクティブモードで Bucket-Endpoint オプションと Bucket-Cname オプションを指定する必要はありません。 ただし、2 つのオプションは設定ファイルで引き続き有効です。 設定ファイルの各バケットにエンドポイントかオリジンドメインを指定できます。
  • ossutil は、複数のリージョンのエンドポイントを指定できます。 すべてのエンドポイント設定の優先順位は次のとおりです。コマンドの --endpoint オプションで指定されたエンドポイント > Bucket-Cname で指定されたエンドポイント > Bucket-Endpoint で指定されたエンドポイント > Credentials で指定されたエンドポイント。 コマンド実行時に --endpoint (短縮形 -e) オプションを指定した場合、--endpoint オプションの値が優先されます。 このオプションが指定されていない場合、設定ファイルの Bucket-Cname、Bucket-Endpoint、および Credentials で指定されたエンドポイントが検索されます。 最も優先度の高いエンドポイントが使用されます。

一般的なオプション

次の表に、指定した設定項目を生成するために config コマンドに追加できるオプションを示します。
オプション 説明
-e、--endpoint 設定ファイルの [Credentials] セクションのエンドポイントを指定します。
-i、--access-key-id 設定ファイルの [Credentials] セクションの AccessKey ID を指定します。
-k、-access-key-secret 設定ファイルの [Credentials] セクションの AccessKey Secret を指定します。
-t、--sts-token オプション。 このオプションには、設定ファイルの [Credentials] セクションの STS トークンを指定します。
--output-dir 出力オブジェクトが存在するディレクトリを指定します。 出力オブジェクトには、cp コマンドを使用して複数のオブジェクトをコピーするときのエラーが原因で生成されたレポートオブジェクトが含まれます。 デフォルト値は、現在のディレクトリの ossutil_output ディレクトリです。
-L、--language ossutil の使用言語を指定します。 有効値:CH と EN。 デフォルト値:CH。 このオプションを CH に設定する場合、システムで UTF-8 エンコードがサポートされていることを確認してください。
--loglevel ログレベルを指定します。 デフォルト値は null で、ログファイルが生成されないことを示します。 有効値:
  • info:プロンプトログを生成します。
  • debug:対応する HTTP リクエストとレスポンス情報を含む詳細なログを生成します。
一般的なオプションの詳細は、「サポートされているすべてのオプションの表示」をご参照ください。