# Wasabi

{% code fullWidth="true" %}

```
NAME:
   singularity storage update s3 wasabi - Wasabiオブジェクトストレージ

USAGE:
   singularity storage update s3 wasabi [コマンドオプション] <名前|ID>

DESCRIPTION:
   --env-auth
      ランタイムからAWSの認証情報を取得します（環境変数またはenv varsやIAMのEC2/ECSメタデータが使用可能）。
      
      access_key_idとsecret_access_keyが空の場合のみ有効です。

      例:
         | false | 次のステップでAWSの認証情報を入力します。
         | true  | 環境（環境変数またはIAM）からAWSの認証情報を取得します。

   --access-key-id
      AWSアクセスキーIDです。
      
      匿名アクセスまたはランタイムの認証情報を使用する場合は空にします。

   --secret-access-key
      AWSシークレットアクセスキー（パスワード）です。
      
      匿名アクセスまたはランタイムの認証情報を使用する場合は空にします。

   --region
      接続するリージョンです。
      
      S3クローンを使用しリージョンを持っていない場合は空にします。

      例:
         | <unset>            | 確認できない場合に使用します。
         |                    | v4署名と空のリージョンを使用します。
         | other-v2-signature | v4署名が機能しない場合にのみ使用します。
         |                    | たとえば、Jewel/v10以前のCEPH。

   --endpoint
      S3 APIのエンドポイントです。
      
      S3クローンを使用している場合は必須です。

      例:
         | s3.wasabisys.com                | Wasabi米国東部1（N. バージニア）
         | s3.us-east-2.wasabisys.com      | Wasabi米国東部2（N. バージニア）
         | s3.us-central-1.wasabisys.com   | Wasabi米国中部1（テキサス）
         | s3.us-west-1.wasabisys.com      | Wasabi米国西部1（オレゴン）
         | s3.ca-central-1.wasabisys.com   | Wasabi CA中央1（トロント）
         | s3.eu-central-1.wasabisys.com   | Wasabi EU中央1（アムステルダム）
         | s3.eu-central-2.wasabisys.com   | Wasabi EU中央2（フランクフルト）
         | s3.eu-west-1.wasabisys.com      | Wasabi EU西1（ロンドン）
         | s3.eu-west-2.wasabisys.com      | Wasabi EU西2（パリ）
         | s3.ap-northeast-1.wasabisys.com | Wasabi AP東北1（東京）エンドポイント
         | s3.ap-northeast-2.wasabisys.com | Wasabi AP東北2（大阪）エンドポイント
         | s3.ap-southeast-1.wasabisys.com | Wasabi AP東南1（シンガポール）
         | s3.ap-southeast-2.wasabisys.com | Wasabi AP東南2（シドニー）

   --location-constraint
      リージョンと一致するように設定する場所の制約です。
      
      よくわからない場合は空にします。バケット作成時のみ使用されます。

   --acl
      バケットの作成およびオブジェクトの保存やコピー時に使用されるCanned ACLです。
      
      このACLはオブジェクトの作成時と、bucket_aclが設定されていない場合に使用されます。
      
      詳細については[こちらのドキュメント](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl)を参照してください。
      
      S3では、サーバー側でオブジェクトをコピーする際、ACLをコピーせずに新たに作成します。
      
      aclが空の文字列の場合、「X-Amz-Acl:」ヘッダーは追加されず、デフォルト（プライベート）が使用されます。
      

   --bucket-acl
      バケットの作成時に使用されるCanned ACLです。
      
      詳細については[こちらのドキュメント](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl)を参照してください。
      
      bucketを作成するときのみ、このACLが適用されます。設定されていない場合は「acl」が代わりに使用されます。
      
      「acl」と「bucket_acl」が空の文字列である場合、「X-Amz-Acl:」ヘッダーは追加されず、デフォルト（プライベート）が使用されます。
      

      例:
         | private            | オーナーにFULL_CONTROLが与えられます。
         |                    | 他にはアクセス権限がありません（デフォルト）。
         | public-read        | オーナーにFULL_CONTROLが与えられます。
         |                    | AllUsersグループにREADアクセスが与えられます。
         | public-read-write  | オーナーにFULL_CONTROLが与えられます。
         |                    | AllUsersグループにREADおよびWRITEアクセスが与えられます。
         |                    | バケットにこれを許可することは一般的にはお勧めできません。
         | authenticated-read | オーナーにFULL_CONTROLが与えられます。
         |                    | AuthenticatedUsersグループにREADアクセスが与えられます。

   --upload-cutoff
      チャンク化アップロードに切り替えるためのキャップです。
      
      これより大きなファイルは、chunk_sizeのチャンクでアップロードされます。
      最小値は0、最大値は5 GiBです。

   --chunk-size
      アップロードに使用するチャンクサイズです。
      
      upload_cutoffより大きなファイルまたはサイズが不明なファイル（例：「rclone rcat」からのアップロードや「rclone mount」、google photosやgoogle docsからのアップロード）は、このチャンクサイズを使用してマルチパートアップロードとしてアップロードされます。
      
      なお、「--s3-upload-concurrency」はこのチャンクサイズの数だけ転送毎にメモリにバッファします。
      
      高速リンク上で大きなファイルを転送してメモリが十分にある場合、チャンクサイズを増やすことで転送速度を向上させることができます。
      
      rcloneは、既知の大きさの大きなファイルをアップロードする場合はチャンクサイズを自動的に増やして、10000チャンクの制限に抑えます。
      
      未知のサイズのファイルは設定されたchunk_sizeでアップロードされます。デフォルトのチャンクサイズが5 MiBで最大10,000のチャンクがあるため、デフォルトではストリームアップロード可能なファイルの最大サイズは48 GiBです。さらに大きなファイルをストリームアップロードする場合、chunk_sizeを増やす必要があります。
      
      チャンクサイズを増やすと、報告される進捗の統計情報の精度が低下します。「-P」フラグとともに使用されるchunkは、AWS SDKによってバッファリングされるまで送信されたとみなされ、実際にはまだアップロードが行われる可能性があります。
      

   --max-upload-parts
      マルチパートアップロードにおけるパートの最大数です。
      
      このオプションは、マルチパートアップロード時に使用するパートの最大数を定義します。
      
      10,000のパートがサポートしていないサービスの場合に使用することができます。
      
      rcloneは、既知の大きさの大きなファイルをアップロードする場合、パート数の制限内に収まるように自動的にチャンクサイズを増やすことがあります。
      

   --copy-cutoff
      マルチパートコピーに切り替えるためのキャップです。
      
      サーバーサイドでコピーする必要があるこのサイズを超えるファイルは、このサイズのチャンクでコピーされます。
      
      最小値は0、最大値は5 GiBです。

   --disable-checksum
      オブジェクトのメタデータにMD5チェックサムを保存しません。
      
      通常、rcloneは、アップロードする前に入力のMD5チェックサムを計算してオブジェクトのメタデータに追加するため、大きなファイルのアップロードを開始するまでに長い遅延が発生する場合があります。

   --shared-credentials-file
      共有認証情報ファイルへのパスです。
      
      env_authがtrueの場合、rcloneは共有認証情報ファイルを使用することができます。
      
      この変数が空の場合、rcloneは「AWS_SHARED_CREDENTIALS_FILE」環境変数を探します。環境変数の値が空の場合は、現在のユーザーのホームディレクトリがデフォルト値となります。
      
          Linux/OSX: "$HOME/.aws/credentials"
          Windows:   "%USERPROFILE%\.aws\credentials"
      

   --profile
      共有認証情報ファイルで使用するプロファイルです。
      
      env_authがtrueの場合、rcloneは共有認証情報ファイルを使用することができます。この変数はそのファイルで使用するプロファイルを制御します。
      
      空の場合、環境変数「AWS_PROFILE」または「default」が設定されていない場合にデフォルト値となります。
      

   --session-token
      AWSのセッショントークンです。

   --upload-concurrency
      マルチパートアップロード時の同時実行数です。
      
      同じファイルのチャンクを同時にアップロードします。
      
      高速リンクで大量の大きなファイルをアップロードし、これらのアップロードが帯域幅を十分に活用しきれない場合、これを増やすことで転送速度を向上させることができます。

   --force-path-style
      trueの場合はパススタイルアクセスを使用し、falseの場合は仮想ホストスタイルを使用します。
      
      true（デフォルト）の場合、rcloneはパススタイルアクセスを使用します。falseの場合、rcloneは仮想パススタイルを使用します。詳細については[AWS S3ドキュメント](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro)を参照してください。
      
      一部のプロバイダ（例：AWS、Aliyun OSS、Netease COS、またはTencent COS）では、このオプションをfalseに設定する必要があります。rcloneは、プロバイダの設定に基づいてこれを自動的に行います。

   --v2-auth
      trueの場合はv2認証を使用します。
      
      false（デフォルト）の場合、rcloneはv4認証を使用します。設定した場合、rcloneはv2認証を使用します。
      
      v4署名が機能しない場合にのみ使用してください。たとえば、Jewel/v10以前のCEPHの場合です。

   --list-chunk
      リストのチャンクサイズ（各ListObject S3リクエストごとの応答リスト）です。
      
      このオプションは、AWS S3仕様の"MaxKeys"、"max-items"、または"page-size"としても知られています。
      ほとんどのサービスは、リクエストされたより多くのオブジェクトを要求しても、レスポンスリストを1000オブジェクトまでに切り詰めます。
      AWS S3では、これはグローバルに最大値であり、変更できません。
      Cephでは、「rgw list buckets max chunk」オプションでこれを増やすことができます。
      

   --list-version
      使用するListObjectsのバージョン: 1、2、または0（自動）。
      
      最初にS3がローンチされたとき、バケット内のオブジェクトを列挙するために「ListObjects」呼び出しされていました。
      
      しかし、2016年5月に「ListObjectsV2」呼び出しが導入されました。これははるかに高速であり、可能な限り使用する必要があります。
      
      デフォルトで設定された0であれば、rcloneはプロバイダに応じてどのリストオブジェクトメソッドを呼び出すかを推測します。正しく推測できない場合は、ここで手動で設定することができます。
      

   --list-url-encode
      リストをURLエンコードするかどうか: true/false/unset
      
      いくつかのプロバイダは、リストをURLエンコードサポートしており、これを利用できる場合は、ファイル名に制御文字を使用するときにより信頼性が高くなります。unset（デフォルト）に設定されている場合、rcloneはプロバイダの設定に従って適用するものを選択しますが、ここでrcloneの選択を上書きすることができます。
      

   --no-check-bucket
      バケットの存在を確認せずに作成を試みない場合は、このフラグを設定します。
      
      これは、バケットが既に存在することがわかっている場合に、rcloneが実行するトランザクションの数を最小限に抑えるために使用できます。
      
      バケット作成権限がない場合でも必要な場合があります。v1.52.0より前のバージョンでは、バグのためにこれが無視されました。
      

   --no-head
      HEADリクエストを使用してオブジェクトの整合性を確認しない場合は、このフラグを設定します。
      
      rcloneがオブジェクトをPUTでアップロードした後に200 OKメッセージを受け取った場合、正しくアップロードされたと仮定します。
      
      特に、次のことを仮定します：
      
      - 元のメタデータ、変更時刻、ストレージクラス、コンテンツタイプはアップロード時と同じであること。
      - サイズはアップロード時と同じであること。
      
      以下の項目を1つのパートのPUTのレスポンスから読み込みます：
      
      - MD5SUM
      - アップロード日時
      
      マルチパートアップロードでは、これらの項目は読み込まれません。
      
      サイズ不明のソースオブジェクトをアップロードする場合は、rcloneはHEADリクエストを行います。
      
      このフラグを設定すると、アップロードの際の検出されなかった失敗の可能性が高まるため、通常の操作にはお勧めできません。このフラグを使用しても、アップロードの失敗が検出されない可能性は非常に低いです。
      

   --no-head-object
      オブジェクトを取得する前にHEADを行わない場合は、このフラグを設定します。

   --encoding
      バックエンドのエンコーディングです。
      
      詳細については、[エンコーディングの概要](/overview/#encoding)を参照してください。

   --memory-pool-flush-time
      内部メモリバッファプールがフラッシュされる頻度です。
      
      追加のバッファが必要なアップロード（たとえばマルチパート）では、メモリプールを使用して割り当てが行われます。
      このオプションは、未使用のバッファがプールから削除される頻度を制御します。

   --memory-pool-use-mmap
      内部メモリプールでmmapバッファを使用するかどうか。

   --disable-http2
      S3バックエンドでのhttp2の使用を無効にします。
      
      現在、s3バックエンド（特にminio）とHTTP/2には未解決の問題があります。HTTP/2はデフォルトでS3バックエンドで有効になっていますが、ここで無効にすることができます。問題が解決されたら、このフラグは削除されます。
      
      参照: https://github.com/rclone/rclone/issues/4673, https://github.com/rclone/rclone/issues/3631
      
      

   --download-url
      ダウンロードのためのカスタムエンドポイントです。
      これは通常、AWS S3は、CloudFrontネットワーク経由でダウンロードされたデータに対してより安価なアウトバウンドトラフィックを提供するために、CloudFront CDNのURLに設定されます。

   --use-multipart-etag
      マルチパートアップロードの検証にETagを使用するかどうか
      
      これはtrue、false、または設定がない場合のいずれかである必要があります。
      

   --use-presigned-request
      シングルパートのアップロードに署名済リクエストまたはPutObjectを使用するかどうか
      
      これがfalseの場合、rcloneはAWS SDKのPutObjectを使用してオブジェクトをアップロードします。
      
      rclone < 1.59のバージョンでは、シングルパートオブジェクトのアップロードに署名済要求を使用し、このフラグをtrueに設定すると、その機能が再度有効になります。これは特殊な状況やテスト以外では必要ありません。
      

   --versions
      ディレクトリリストに古いバージョンを含めます。

   --version-at
      指定した時点でのファイルバージョンを表示します。
      
      パラメータは日付「2006-01-02」、日時「2006-01-02 15:04:05」、またはその前の期間、「100d」または「1h」のようにする必要があります。
      
      このオプションを使用すると、ファイルの書き込み操作は許可されないため、ファイルをアップロードしたり削除したりすることはできません。
      
      有効な形式については、[timeオプションのドキュメント](/docs/#time-option)を参照してください。
      

   --decompress
      これが設定されている場合、gzipでエンコードされたオブジェクトを展開します。
      
      "Content-Encoding: gzip"が設定されたままオブジェクトをAWS S3にアップロードすることが可能です。通常、rcloneはこれらのファイルを圧縮されたオブジェクトとしてダウンロードします。
      
      このフラグが設定されている場合、rcloneはこれらのファイルを"Lcontent-Encoding: gzip"が受信された段階で展開します。これにより、rcloneはサイズとハッシュをチェックできませんが、ファイルの内容は展開されます。
      

   --might-gzip
      プロバイダがオブジェクトにgzipを使用する可能性がある場合、これを設定します。
      
      通常、プロバイダは、ダウンロード時にオブジェクトを変更しません。`Content-Encoding:gzip`でアップロードされていない場合、ダウンロード時には設定されません。
      
      ただし、一部のプロバイダ（Cloudflareなど）は、`Content-Encoding:gzip`でアップロードされていなくてもオブジェクトをgzipで圧縮できる場合があります。
      
      これを設定すると、rcloneがContent-Encoding:gzipが設定されたチャンク転送エンコードを使用してオブジェクトをダウンロードすると、rcloneがオブジェクトを逐次的に解凍します。
      
      unset（デフォルト）に設定された場合、rcloneはプロバイダの設定に従って適用するかどうかを選択しますが、ここでrcloneの選択を上書きすることができます。
      

   --no-system-metadata
      システムメタデータの設定と読み取りを抑制します


OPTIONS:
   --access-key-id value        AWSアクセスキーIDです。 [$ACCESS_KEY_ID]
   --acl value                  バケットの作成およびオブジェクトの保存やコピー時に使用されるCanned ACLです。 [$ACL]
   --endpoint value             S3 APIのエンドポイントです。 [$ENDPOINT]
   --env-auth                   ランタイムからAWSの認証情報を取得します（環境変数またはenv varsやIAMのEC2/ECSメタデータが使用可能）。（デフォルト：false） [$ENV_AUTH]
   --help, -h                   ヘルプを表示します
   --location-constraint value  リージョンと一致するように設定する場所の制約です。 [$LOCATION_CONSTRAINT]
   --region value               接続するリージョンです。 [$REGION]
   --secret-access-key value    AWSシークレットアクセスキー（パスワード）。 [$SECRET_ACCESS_KEY]

   Advanced

   --bucket-acl value               バケットの作成時に使用されるCanned ACLです。 [$BUCKET_ACL]
   --chunk-size value               アップロードに使用するチャンクサイズです。 (デフォルト： "5MiB") [$CHUNK_SIZE]
   --copy-cutoff value              マルチパートコピーに切り替えるためのキャップです。 (デフォルト： "4.656GiB") [$COPY_CUTOFF]
   --decompress                     これが設定されている場合、gzipでエンコードされたオブジェクトを展開します。 (デフォルト： false) [$DECOMPRESS]
   --disable-checksum               オブジェクトのメタデータにMD5チェックサムを保存しません。 (デフォルト： false) [$DISABLE_CHECKSUM]
   --disable-http2                  S3バックエンドのHTTP/2の使用を無効にします。 (デフォルト： false) [$DISABLE_HTTP2]
   --download-url value             ダウンロードのためのカスタムエンドポイント。 [$DOWNLOAD_URL]
   --encoding value                 バックエンドのエンコーディングです。 (デフォルト： "Slash,InvalidUtf8,Dot") [$ENCODING]
   --force-path-style               trueの場合はパススタイルアクセスを使用し、falseの場合は仮想ホストスタイルを使用します。 (デフォルト： true) [$FORCE_PATH_STYLE]
   --list-chunk value               リストのチャンクサイズ（各ListObject S3リクエストごとの応答リスト）です。 (デフォルト： 1000) [$LIST_CHUNK]
   --list-url-encode value          リストをURLエンコードするかどうか。 (デフォルト： "unset") [$LIST_URL_ENCODE]
   --list-version value             使用するListObjectsのバージョン: 1、2、または0（自動）。 (デフォルト： 0) [$LIST_VERSION]
   --max-upload-parts value         マルチパートアップロードにおけるパートの最大数。 (デフォルト： 10000) [$MAX_UPLOAD_PARTS]
   --memory-pool-flush-time value   内部メモリバッファプールがフラッシュされる頻度。 (デフォルト： "1m0s") [$MEMORY_POOL_FLUSH_TIME]
   --memory-pool-use-mmap           内部メモリプールでmmapバッファを使用するかどうか。 (デフォルト： false) [$MEMORY_POOL_USE_MMAP]
   --might-gzip value               プロバイダがオブジェクトにgzipを使用する可能性がある場合、これを設定します。 (デフォルト： "unset") [$MIGHT_GZIP]
   --no-check-bucket                バケットの存在を確認せずに作成を試みない場合は、このフラグを設定します。 (デフォルト： false) [$NO_CHECK_BUCKET]
   --no-head                        HEADリクエストを使用してオブジェクトの整合性を確認しない場合は、このフラグを設定します。 (デフォルト： false) [$NO_HEAD]
   --no-head-object                 オブジェクトを取得する前にHEADを行わない場合は、このフラグを設定します。 (デフォルト： false) [$NO_HEAD_OBJECT]
   --no-system-metadata             システムメタデータの設定と読み取りを抑制します (デフォルト： false) [$NO_SYSTEM_METADATA]
   --profile value                  共有認証情報ファイルで使用するプロファイルです。 [$PROFILE]
   --session-token value            AWSのセッショントークンです。 [$SESSION_TOKEN]
   --shared-credentials-file value  共有認証情報ファイルへのパスです。 [$SHARED_CREDENTIALS_FILE]
   --upload-concurrency value       マルチパートアップロード時の同時実行数。 (デフォルト： 4) [$UPLOAD_CONCURRENCY]
   --upload-cutoff value            チャンク化アップロードに切り替えるためのキャップ。 (デフォルト： "200MiB") [$UPLOAD_CUTOFF]
   --use-multipart-etag value       マルチパートアップロードの検証にETagを使用するかどうか。 (デフォルト： "unset") [$USE_MULTIPART_ETAG]
   --use-presigned-request          シングルパートのアップロードに署名済リクエストまたはPutObjectを使用するかどうか。 (デフォルト： false) [$USE_PRESIGNED_REQUEST]
   --v2-auth                        trueの場合はv2認証を使用します。 (デフォルト： false) [$V2_AUTH]
   --version-at value               指定した時点でのファイルバージョンを表示します。 (デフォルト： "off") [$VERSION_AT]
   --versions                       ディレクトリリストに古いバージョンを含めます。 (デフォルト： false) [$VERSIONS]

```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://data-programs.gitbook.io/singularity/jp/cli-reference/storage/update/s3/wasabi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.