Object Storage Service:オプションを表示

コマンド構文

./ossfs -h

このコマンドは、ossfsがあるディレクトリで使用する必要があります。 デフォルトのディレクトリは /usr/local/bin/ です。

オプションの形式と例

-o option_name[=option_value]  or  -ooption_name[=option_value]

ossfs bucket_name mount_point -ourl=endpoint -ouid=uid -ogid=gid

-ourl=oss-cn-hangzhou.aliyuncs.com
-ourl=http://oss-cn-hangzhou.aliyuncs.com
-ourl=https://oss-cn-hangzhou.aliyuncs.com

# Write the AccessKey pair to the /etc/passwd-ossfs file and set the file permission to 640.
echo bucket-test:LTAIbZcdVCmQ****:MOk8x0y9hxQ31coh7A5e2MZEUz**** > /etc/passwd-ossfs
chmod 640 /etc/passwd-ossfs

# Write the AccessKey pair to the /passwd-path/passwd-ossfs file and set the file permission to 600.
echo bucket-test:LTAIbZcdVCmQ****:MOk8x0y9hxQ31coh7A5e2MZEUz**** > /passwd-path/passwd-ossfs
chmod 600 /passwd-path/passwd-ossfs

# Set the opasswd_file variable to /passwd-path/passwd-ossfs.
-opasswd_file=/passwd-path/passwd-ossfs

ossfs bucket_name mount_point -omax_stat_cache_size=0

ossfs bucket_name mount_point -ourl=endpoint -oallow_other

ossfs bucket_name mount_point -odbglevel=info

ossfs bucket_name mount_point -f

ossfs bucket_name mount_point -d

オプション

特に明記されていない限り、すべてのオプションは -ooption_name=option_valueまたは -o option_name=option_value形式です。

• ossfsオプション

  オプション	説明
  再試行	リクエストが失敗したときの再試行回数。 デフォルト値：2
  storage_class	OSSにアップロードするオブジェクトのストレージクラス。 有効な値： 標準 (デフォルト) IA アーカイブ ストレージクラスの詳細については、「概要」をご参照ください。
  public_bucket	バケットに匿名でアクセスするかどうかを指定します。 このオプションは、アクセス制御リスト (ACL) がpublic-read-writeであるバケットにのみ適用されます。 有効な値： 0 (デフォルト): 認証モードでバケットにアクセスします。 1: 匿名モードでバケットにアクセスします。
  passwd_ファイル	バケットへのアクセスに使用されるAccessKeyペアを格納するファイル。 デフォルト値: /etc/passwd-ossfs
  connect_timeout	接続のタイムアウト時間 (秒) 。 デフォルト値は 300 です。
  readwrite_timeout	リクエストの読み取りまたは書き込みのタイムアウト時間 (秒) 。 デフォルト値: 120
  max_stat_cache_size	メタデータをキャッシュできるオブジェクトの最大数。 デフォルト値: 100,000 100,000オブジェクトのメタデータをキャッシュするには、約40 MBのストレージスペースが必要です。
  stat_cache_expire	オブジェクトメタデータキャッシュの有効期間。 単位は秒です。 デフォルト値: 900
  no_check_certificate	サーバー証明書が検証されないことを指定します。 このオプションは、リクエストプロトコルがHTTPSの場合にのみ有効です。 デフォルトでは、証明書の検証は有効です。 オプションに値を指定する必要はありません。 証明書の検証を無効にするには、-ono_check_certificateオプションを追加します。
  multireq_max	オブジェクトの一覧表示中にオブジェクトメタデータにアクセスする同時リクエストの最大数。 デフォルト値は 20 です。
  parallel_count	マルチパートアップロードを使用してラージオブジェクトをアップロードするときに同時にアップロードできるパーツの数。 既定値：5
  multipart_size	マルチパートアップロードを使用してデータをアップロードする場合のパーツサイズ (MB) 。 デフォルト値は 10 です。 このオプションは、アップロードできるオブジェクトの最大サイズを制限します。 マルチパートアップロードを使用する場合、オブジェクトを分割できるパーツの最大数は10,000です。 デフォルトでは、アップロードできるオブジェクトの最大サイズは100 GBです。 このオプションの値を変更すると、より大きなオブジェクトをアップロードできます。
  url	バケットへのアクセスに使用するエンドポイント。
  umask	マウントポイント上のファイル /フォルダーの権限マスク。 たとえば、-oumask=007を使用してマウントポイントのファイル /フォルダーの権限を770に設定したり、-oumask=007を使用してマウントポイントのファイル /フォルダーの権限を700に設定したりできます。
  enable_content_md5	オブジェクトのアップロードにCONTENT_MD5ヘッダーを設定するかどうかを指定します。 デフォルトでは、このヘッダーは設定されていません。 CONTENT_MD5ヘッダーを設定する場合は、-oenable_content_md5オプションを指定します。
  ram_role	RAMロールを使用してOSSにアクセスすることを指定します。 RAMロールを使用してOSSにアクセスすると、AccessKeyペアファイルのAccessKey IDとAccessKeyシークレットは無視されます。
  listobjectsv2	オブジェクトの一覧表示に使用されるメソッド。 バケットのバージョン管理が有効になっている場合は、-olistobjectsv2オプションを使用してオブジェクトを一覧表示することを推奨します。
  notsup_compat_dir	サポートされているディレクトリタイプ。 デフォルトでは、ossfsはdir/ 、dir、およびdir_$folde r$ をディレクトリとして認識します。 ossfsがdir/ のみをディレクトリとして認識して、サーバーとのリクエストのやり取りの数を減らす場合は、-onotsup_compat_dirオプションを指定します。
  ensure_diskfree	ossfsで予約できるディスクの使用可能なストレージ容量。 パフォーマンスを向上させるために、ossfsはディスクのストレージ容量を使用して、デフォルトでアップロードまたはダウンロードされた一時データを保存します。 このオプションを使用して、ossfsが予約できるディスクの使用可能なストレージ容量を設定できます。 単位：MB。 たとえば、ossfsでディスクのストレージ容量を1,024 MB確保する場合は、-oensure_diskfree=1024オプションを指定します。
  direct_read	直接読み取りモードを有効にします。 デフォルトでは、ossfsはディスクストレージ容量を使用して、アップロードまたはダウンロードされた一時データを保存します。 このオプションを指定すると、ローカルディスクではなくOSSから直接データを読み取ることができます。 このオプションはデフォルトで無効になっています。 -odirect_readを使用して、直接読み取りモードを有効にできます。 説明 直接読み取られているオブジェクトに対する書き込み、名前変更、または切り捨て操作は、オブジェクトが再び開かれるまで、直接読み取りを中断します。
  direct_read_chunk_size	1回の読み取り要求でOSSから直接読み取ることができるデータの量。 単位：MB。 デフォルト値: 4。 有効な値: 1 ~ 32。 このオプションは、-odirect_readオプションが指定されている場合にのみ有効になります。
  direct_read_prefetch_thread	同時にデータをプリフェッチするためのスレッドの最大数。 直接読み取りモードでは、ossfsはバックグラウンドでデータを非同期に読み取ります。 デフォルト値: 64。 このオプションは、-odirect_readオプションが指定されている場合にのみ有効になります。
  direct_read_prefetch_chunks	メモリにプリフェッチできるチャンクの数。 このオプションを使用して、シーケンシャル読み取りパフォーマンスを最適化できます。 デフォルト値: 32。 このオプションは、-odirect_readオプションが指定されている場合にのみ有効になります。
  direct_read_prefetch_limit	プリフェッチ可能なデータの総量。 直接読み取りモードでは、ossfsは事前に読み取られたデータをメモリにキャッシュします。 単位：MB。 デフォルト値: 1024。 このオプションは、-odirect_readオプションが指定されている場合にのみ有効になります。
  dbglevel	ログレベル。 有効な値： critical (デフォルト) error 警告 info デバッグ
  curldbg	libcurlロギングを有効にするかどうかを指定します。 デフォルトでは、libcurlログは無効になっています。 libcurlログを取得するには、-ocurldbgオプションを指定します。

• データキャッシュオプション

  説明

  オプション	説明
  use_cache	ossfsデータキャッシュを有効にし、データキャッシュのパスを指定します。 デフォルトでは、ossfsデータキャッシュは無効になっています。 たとえば、-ouse_cache=pathを指定した場合、ossfsデータキャッシュは有効になり、データキャッシュのパスはpathに設定されます。 ビジネス要件に基づいてパスを指定できます。 例: /tmp/your_foldername
  ensure_diskfree	ディスク容量が完全に占有され、データを書き込む他のアプリケーションに影響を与えないように予約されたディスク容量のサイズ。 デフォルトでは、ディスク容量は予約されていません。 単位：MB。 たとえば、ossfsの予約ディスク容量を1024 MBに設定する場合は、-oensure_diskfree=1024を指定できます。
  del_cache	ローカルキャッシュを削除するかどうかを指定します。 デフォルトでは、ローカルキャッシュは削除されません。 たとえば、-odel_cacheを指定した場合、ossfsはuse_cacheオプションで指定したディレクトリ内のキャッシュファイルを削除します。
  max_dirty_data	ファイルをアップロードするサイズのしきい値を指定します。 ファイルのサイズが値より大きい場合、ファイルが閉じられていなくてもファイルがアップロードされます。 単位：MB。 たとえば、ファイルが閉じられていない場合でもサイズが2,000 MBを超えるファイルをアップロードするように指定する場合は、-omax_dirty_data=2000を指定できます。
  tmpdir	デフォルトでは、データはシステムディスクの /tmpディレクトリにキャッシュされます。 このオプションは-use_cacheと併用できません。 たとえば、-otmpdir=pathを指定した場合、一時データキャッシュのデフォルトパスはpathに設定されます。 実際の要件に基づいてパスを指定できます。 例: /data/your_foldername

• FUSEオプション

  オプション	説明
  allow_other	マウントポイントのアクセス許可を変更して、すべてのユーザーがアクセスできるようにします。 デフォルトでは、rootユーザーのみがこのオプションを設定できます。 オプションに値を指定する必要はありません。 すべてのユーザーによるアクセスを許可するには、-oallow_otherオプションを追加します。
  uid	ディレクトリの所有者のUID。
  gid	ディレクトリの所有者のGID。