すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:構成

最終更新日:Apr 25, 2025

構成ファイルを作成または管理します。構成ファイルには、アクセス認証情報と構成設定が保存されます。 config コマンドは、使用シナリオに応じて、インタラクティブまたは非インタラクティブに実行できます。

構成ファイルを作成する

  1. 次のコマンドを実行して、構成プロセスを開始します。

    ossutil config
  2. 画面の指示に従って、構成ファイルのパスを構成します。 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):
  3. 画面の指示に従って、AccessKey ID、AccessKey シークレット、およびリージョン ID を指定します。

    1. 作成した AccessKey ID を入力します。

      Please enter Access Key ID [****************id]:LTAI****************
    2. 作成した AccessKey シークレットを入力します。

      Please enter Access Key Secret [****************sk]:R6vg*********************
    3. データが保存されているバケットがあるリージョンの ID を入力します。デフォルト値:cn-hangzhou。

      Please enter Region [cn-hangzhou]: cn-hangzhou
    4. バケットがあるリージョンのエンドポイントを指定します。この手順は省略できます。

      前の手順でリージョン ID を指定すると、デフォルトでそのリージョンのパブリックエンドポイントが使用されます。たとえば、region-idcn-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 ペアを作成する」をご参照ください。

    ROS を使用して AccessKey ペアを作成する

    Resource Orchestration Service (ROS) スクリプトを使用すると、OSS のフルアクセス権限を持つ RAM ユーザーの AccessKey ペアをすばやく作成できます。これを行うには、[テンプレートベースのスタック作成ウィザード] に移動し、[セキュリティ確認] セクションで [Alibaba Cloud ROS が RAM リソースを作成することを確認します] を選択し、[作成] をクリックします。

    1.png

    注: このチュートリアルでは、WordPress オープンソース プラットフォームを使用します。

    1.png

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