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

Object Storage Service:config

最終更新日:Dec 20, 2023

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

重要

このトピックのサンプルコマンドラインは、64ビットLinuxシステムに基づいています。 他のシステムの場合は、を交換します。対応するバイナリ名を持つコマンドの /ossutil64。 詳細については、「ossutilの使用を開始する」をご参照ください。

コマンド構文

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

次のコマンド構文を使用して、非対話モードでコマンドを実行します。

. /ossutil64設定
[-e, -- endpoint <value>]
[-i, -- access-key-id <value>]
[-k, -- access-key-secret <value>]
[-t, -- sts-token <value>]
[-- ram-role-arn <value>]
[-L言語 <値>]
[-- 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 secret。 AccessKeyシークレット情報を表示する方法の詳細については、「AccessKeyペアの取得」をご参照ください。
-t, -- sts-tokenOSSへのアクセスに使用されるSTS (Security Token Service) トークン。 OSSへの一時的なアクセスにSTSを使用する場合にのみ、この項目を設定する必要があります。 STSトークンを生成する方法の詳細については、「許可されたサードパーティのアップロード」の「一時的なアクセス資格情報」セクションをご参照ください。
-- ram-role-arnリクエストの認証に使用されるRAM (Resource Access Management) ロールのARN (Alibaba Cloud Resource Name) 。 AssumeRoleを呼び出してRAMユーザーとしてOSSにアクセスする場合にのみ、この項目を設定する必要があります。
-L言語ossutilによって使用される言語。 デフォルト値: CH。 有効な値:
  • CH: 中国語。 この設定項目をCHに設定する場合は、システムがUTF-8エンコードをサポートしていることを確認してください。
  • EN: 英語。
-- output-dir出力オブジェクトが配置されているディレクトリ。 出力オブジェクトには、cpコマンドを実行して複数のオブジェクトをコピーするときに発生するエラーによって生成されたレポートオブジェクトが含まれます。

デフォルト値: 現在のディレクトリのossutil_outputディレクトリ。

-c, -- config-fileossutilの設定ファイルパス。 ossutilは、起動時に構成ファイルを読み取ります。

  • 対話モード
    で構成ファイルを生成します。/ossutil64設定
    設定ファイルの名前を入力します。 ファイル名にはパスを含めることができます。 デフォルトのパスは /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 
  • 非対話モード
    で構成ファイルを生成します。/ossutil64 config -e oss-cn-beijing.aliyuncs.com -i LTAIbZcdVCmQ **** -k D26oqKBudxDRBg8Wuh2EWDBrM0 **** -L CH -c /myconfig

    configコマンドの実行時に -L languageおよび -c, -- config-file以外のオプションを指定した場合、非対話モードが使用されます。 次に、オプションを使用してすべての設定項目を指定する必要があります。

設定ファイルの変更

重要
  • ossutil V1.7.15以降では、インタラクティブモードを使用する場合、Bucket-EndpointまたはBucket-Cnameを指定する必要はありません。 設定ファイルの各バケットにエンドポイントまたはCNAMEを指定できます。
  • ossutilを使用すると、さまざまな方法でエンドポイントを指定できます。 コマンドの -- endpointオプションで指定したエンドポイント、[Bucket-Cname] で指定したエンドポイント、[Bucket-endpoint] で指定したエンドポイント、[Credentials] で指定したエンドポイントの設定が降順で有効になります。
生成された設定ファイルを変更することで、OSSアクセス情報を変更できます。 ossutilの設定ファイルは次の形式です
。
        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
[バケット-エンドポイント]
        bucket1 = endpoint1
        bucket2 = endpoint2
        ...
[バケット-Cname]
        bucket1 = cname1
        bucket2 = cname2
        ...
[AkService]
        ecsAk=http:// 100.100.100.200/latest/meta-data/ram/security-credentials/EcsRamRoleTesting
[デフォルト]
        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: この項目は、ECS (Elastic Compute Service) インスタンスにバインドされたRAMロールを使用してOSSで操作を実行する必要がある場合に必要です。 この項目を設定するときは、ECSインスタンスにバインドされたRAMロールの名前にEcsRamRoleTestingを設定するだけで済みます。 このアイテムを設定した後、AccessKey ID、AccessKey Secret、およびSTSTokenアイテムを無視できます。 AccessKey IDを設定しても、AkServiceの設定は有効になりません。 AccessKey ID、AccessKey Secret、およびSTSToken設定は、IDの検証に使用されます。 RAMロールをECSインスタンスにバインドする方法の詳細については、「インスタンスRAMロールをECSインスタンスにアタッチする」をご参照ください。
  • デフォルト: 共通パラメーターのデフォルト値を変更する場合は、このオプションを指定できます。 オプションの詳細については、「オプションの表示」をご参照ください。
    説明 デフォルトオプションはossutil V1.7.15以降でのみサポートされます。