構成ファイルを作成または管理します。構成ファイルには、アクセス認証情報と構成設定が保存されます。 config コマンドは、使用シナリオに応じて、インタラクティブまたは非インタラクティブに実行できます。
構成ファイルを作成する
次のコマンドを実行して、構成プロセスを開始します。
ossutil config画面の指示に従って、構成ファイルのパスを構成します。 Enter キーを押して、構成ファイルのデフォルトパスを使用することもできます。
この例は、Linux で構成ファイルのデフォルトパスを構成する方法を示しています。
// 構成ファイル名を入力してください。ファイル名にはパスを含めることができます(デフォルトは /root/.ossutilconfig です。Enter キーを押すとデフォルトファイルが使用されます。このオプションを他のファイルに指定した場合は、他のコマンドを使用するときに --config-file オプションでそのファイルを指定する必要があります)。 Please enter the config file name,the file name can include path(default /root/.ossutilconfig, carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):画面の指示に従って、AccessKey ID、AccessKey シークレット、およびリージョン ID を指定します。
作成した AccessKey ID を入力します。
Please enter Access Key ID [****************id]:LTAI****************作成した AccessKey シークレットを入力します。
Please enter Access Key Secret [****************sk]:R6vg*********************データが保存されているバケットがあるリージョンの ID を入力します。デフォルト値:cn-hangzhou。
Please enter Region [cn-hangzhou]: cn-hangzhouバケットがあるリージョンのエンドポイントを指定します。この手順は省略できます。
前の手順でリージョン ID を指定すると、デフォルトでそのリージョンのパブリックエンドポイントが使用されます。たとえば、
region-idをcn-hangzhouに設定すると、デフォルトのパブリックエンドポイントはhttps://oss-cn-hangzhou.aliyuncs.comになります。別のエンドポイントを使用する場合は、そのエンドポイントを入力します。 OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、そのリージョンの内部エンドポイント(この例では
https://oss-cn-hangzhou-internal.aliyuncs.com)を使用します。Please enter Endpoint (optional, use public endpoint by default) [None]: https://oss-cn-hangzhou-internal.aliyuncs.com
次の表にパラメーターを示します。
パラメーター
必須
説明
accessKeyID
はい
RAM ユーザーの AccessKey ペア(AccessKey ID とシークレット)。 AccessKey ペアの取得方法については、「RAM ユーザーの AccessKey ペアを作成する」をご参照ください。
accessKeySecret
はい
リージョン
はい
OSS バケットがあるリージョンの ID。この例では、中国 (杭州) リージョンの ID (cn-hangzhou) が使用されています。他のリージョンの ID については、「リージョンとエンドポイント」をご参照ください。
エンドポイント
いいえ
バケットがあるリージョンのエンドポイントを指定します。エンドポイントを手動で指定しない場合、リージョン パラメーターによってパブリックエンドポイントが自動的に生成されます。内部エンドポイントを指定する場合は、明示的に内部エンドポイントを指定する必要があります。この例では、中国 (杭州) リージョンのパブリックエンドポイント (
https://oss-cn-hangzhou.aliyuncs.com) が使用されています。OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、そのリージョンの内部エンドポイント(この例では
https://oss-cn-hangzhou-internal.aliyuncs.com)を使用します。リージョンとエンドポイントの関係の詳細については、「リージョンとエンドポイント」をご参照ください。
構成設定を作成およびクエリする
構成設定を作成する
ossutil config setこのコマンドは、アクセス認証情報設定または構成設定を作成します。この場合、コマンドは非インタラクティブです。 --config-file オプションは構成ファイルへのパスを指定し、--profile オプションはプロファイルセクションを指定します。
次のサンプルコマンドは、myconfig 構成ファイルの dev セクションで region パラメーターを設定します。
ossutil config set region cn-hangzhou --config-file myconfig --profile dev構成項目を削除するには、コマンドラインで値を空の文字列に設定するか、テキストエディターを使用して手動でエントリを削除します。
ossutil config set region "" --config-file myconfig --profile dev構成設定をクエリする
ossutil config getこのコマンドは、アクセス認証情報または構成設定をクエリします。この場合、コマンドは非インタラクティブです。 --config-file オプションは構成ファイルへのパスを指定し、--profile オプションは使用するプロファイルセクションを指定します。次のサンプルコマンドは、myconfig 構成ファイルの dev セクションで region パラメーターをクエリします。
ossutil config get region --config-file myconfig --profile devすべての構成セクションを一覧表示する
このコマンドは、すべてのセクションを一覧表示します。この場合、コマンドは非インタラクティブです。
ossutil config list-profilesアクセス認証情報を構成する
ossutil config credentialこのコマンドは、アクセス認証情報を構成します。この場合、コマンドはインタラクティブです。 AccessKey ID、AccessKey シークレット、およびトークンを暗号化するかどうかを尋ねられます。
// ossutil config credential
// このコマンドは、構成ファイルを作成し、構成設定と認証情報を保存します。
//
// 構成ファイル名を入力してください。ファイル名にはパスを含めることができます(デフォルトは "C:\Users\issuser\.ossutilconfig" です。Enter キーを押すとデフォルトファイルが使用されます。このオプションを他のファイルに指定した場合は、他のコマンドを使用するときに --config-file オプションでそのファイルを指定する必要があります)。
//
// 構成ファイルが入力されませんでした。デフォルトの構成ファイル "C:\Users\issuser\.ossutilconfig" が使用されます。
// 以下の設定では、Enter キーを押すと構成がスキップされます。
// プロファイルを入力してください。
// 認証モードを入力してください。RamRoleArn、EcsRamRole、Process、Uri、OIDCRoleArn、AK、StsToken がサポートされています。
// Access Key ID と Access Key Secret を暗号化する必要がありますか?(y または N)
// Access Key ID を入力してください [None]:
// Access Key Secret を入力してください [None]:
ossutil config credential
The command creates a config file and stores configuration settings and credentials.
Please enter the config file name,the file name can include path(default "C:\Users\issuser\.ossutilconfig", carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):
No config file entered, will use the default config file "C:\Users\issuser\.ossutilconfig"For the following settings, carriage return means skip the configuration.
Please enter profile:
Please enter authenticate mode, supports RamRoleArn,EcsRamRole,Process,Uri,OIDCRoleArn,AK,StsToken:
Do you need to encryt access key id and access key secret (y or N)
Please enter Access Key ID [None]:
Please enter Access Key Secret [None]:
