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 で、ログファイルが生成されないことを示します。 有効値:
|
注 一般的なオプションの詳細は、「サポートされているすべてのオプションの表示」をご参照ください。