# Seaweedfs {% code fullWidth="true" %} ``` 名前： singularity storage update s3 seaweedfs - SeaweedFS S3 使用法： singularity storage update s3 seaweedfs [コマンドオプション] <名前|ID> 説明： --env-auth 実行時にAWS認証情報を取得します（環境変数または.envファイルがない場合はEC2/ECSメタデータから取得）。 access_key_idとsecret_access_keyが空白の場合にのみ適用されます。 例： | false | 次のステップでAWS認証情報を入力します。 | true | 環境（環境変数またはIAM）からAWS認証情報を取得します。 --access-key-id AWSアクセスキーID。 匿名アクセスまたは実行時の認証情報は空白のままにしておいてください。 --secret-access-key AWSシークレットアクセスキー（パスワード）。 匿名アクセスまたは実行時の認証情報は空白のままにしておいてください。 --region 接続するリージョンです。 S3クローンを使用し、リージョンが指定されていない場合は空白のままにしてください。 例： | <未設定> | 迷った場合はこれを使用します。 | | v4署名と空のリージョンを使用します。 | other-v2-signature | v4署名が機能しない場合にのみ使用します。 | | たとえば、ジュエル/v10 CEPH以前のバージョン。 --endpoint S3 APIのエンドポイントです。 S3クローンを使用する場合は必須です。 例： | localhost:8333 | SeaweedFS S3のlocalhost --location-constraint リージョンに一致する場所の制約です。 わからない場合は空白のままにしておいてください。バケットを作成する場合にのみ使用されます。 --acl バケットの作成、オブジェクトの保存またはコピー時に使用されるACL（アクセス制御リスト）です。 このACLはオブジェクトの作成に使用され、bucket_aclが設定されていない場合にはバケットの作成にも使用されます。 詳細については[Amazon S3のドキュメント](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl)を参照してください。 S3では、サーバーサイドでオブジェクトをコピーする際にACLがコピーされるのではなく、新しく書き込まれることに注意してください。 もしaclが空の文字列の場合、X-Amz-Acl: header は追加されず、デフォルト（private）が使用されます。 --bucket-acl バケットの作成時に使用されるACL（アクセス制御リスト）です。 詳細については[Amazon S3のドキュメント](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl)を参照してください。 bucket_aclが未設定の場合、"acl"が代わりに使用されます。 もし "acl" と "bucket_acl" が空の文字列の場合、X-Amz-Acl:header は追加されず、デフォルト（private）が使用されます。 例： | private | オーナーにはFULL_CONTROLが与えられます。 | | 他のユーザーにはアクセス権がありません（デフォルト）。 | public-read | オーナーにはFULL_CONTROLが与えられます。 | | AllUsersグループにはREAD権限が与えられます。 | public-read-write | オーナーにはFULL_CONTROLが与えられます。 | | AllUsersグループにはREADおよびWRITE権限が与えられます。 | | バケットにこれを付与することは一般的には推奨されません。 | authenticated-read | オーナーにはFULL_CONTROLが与えられます。 | | 認証済みユーザーグループにはREAD権限が与えられます。 --upload-cutoff チャンクアップロードに切り替えるためのカットオフです。 このサイズより大きいファイルは、chunk_sizeで指定されたサイズのチャンクでアップロードされます。 最小値は0、最大値は5 GiBです。 --chunk-size アップロードに使用するチャンクサイズです。 upload_cutoffより大きいファイルや、サイズが不明なファイル（"rclone rcat"によるアップロードや"rclone mount"、Google Photos、Google Docsでアップロードされたファイルなど）は、このチャンクサイズを使用してマルチパートアップロードされます。 注意："--s3-upload-concurrency"のチャンクは、各転送ごとにメモリ上にバッファリングされます。 高速リンクで大きなファイルを転送しており、十分なメモリがある場合は、この値を増やすことで転送速度を向上させることができます。 Rcloneは、既知のサイズの大きなファイルをアップロードする場合に、チャンクサイズを自動的に増やし、10,000チャンクの制限を下回るようにします。 サイズが不明なファイルは、設定されたchunk_sizeでアップロードされます。デフォルトのchunk_sizeは5 MiBで、最大で10,000のチャンクがあるため、デフォルトではストリームアップロード可能なファイルの最大サイズは48 GiBです。より大きなファイルをストリームアップロードする場合は、chunk_sizeを増やす必要があります。 チャンクサイズを増やすと、"-P"フラグで表示される進行状況の精度が低下します。Rcloneは、チャンクがAWS SDKによってバッファリングされたときにチャンクを送信したとみなしますが、実際にはまだアップロード中かもしれません。チャンクサイズが大きいほど、AWS SDKのバッファサイズも大きくなり、進行状況の報告が真実とは異なる場合があります。 --max-upload-parts マルチパートアップロードでの最大パーツ数です。 このオプションは、マルチパートアップロードを行う際に使用するマルチパートチャンクの最大数を定義します。 サービスがAWS S3の「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では、これはグローバルの最大値であり、変更できません。[AWS S3](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html)を参照してください。 Cephでは、「rgw list buckets max chunk」オプションでこれを増やすことができます。 --list-version 使用するListObjectsのバージョン：1、2または0（自動）。 S3の初期リリースでは、バケット内のオブジェクトを列挙するためのListObjects呼び出しが提供されていました。 しかし、2016年5月にListObjectsV2呼び出しが導入されました。これは非常に高性能であり、可能であれば使用する必要があります。 デフォルトの0に設定されている場合、rcloneはプロバイダの設定に基づいてListObjectsメソッドを呼び出すことを推測します。誤った推測をした場合は、ここで手動で設定することができます。 --list-url-encode リストをURLエンコードするかどうか：true/false/unset 一部のプロバイダは、ファイル名に制御文字を含む場合にURLエンコードリストをサポートしています。利用可能な場合、これはより信頼性の高い方法です。rcloneはプロバイダの設定に従って適用することをデフォルト（unset）として選択しますが、ここでrcloneの選択をオーバーライドすることができます。 --no-check-bucket バケットの存在を確認したり作成したりしません。 バケットが既に存在することを知っている場合、rcloneが実行するトランザクションの数を最小限にするため、これを設定すると便利です。 ユーザーにバケット作成権限がない場合にも必要になる場合があります。v1.52.0より前のバージョンでは、バグのために無視されてしまいました。 --no-head アップロード済みのオブジェクトの整合性を確認するためにHEADリクエストを行いません。 rcloneは、PUTでオブジェクトをアップロードした後に200 OKメッセージを受け取った場合、正しくアップロードされたと仮定します。 特に次の項目を仮定します： - メタデータ（modtime、ストレージクラス、コンテンツタイプ）はアップロードと同じであったか - サイズはアップロードと同じであったか 単一パートのPUTの場合、次の項目をレスポンスから読み取ります： - MD5SUM - アップロード日時 マルチパートアップロードの場合、これらの項目は読み取られません。 長さがわからないソースオブジェクトがアップロードされる場合、rcloneはHEADリクエストを実行します。 このフラグを設定すると、正常な操作には非推奨ですが、アップロードの失敗が検出されない確率が低くなります。実際には、このフラグがあっても、アップロードの失敗が検出される確率は非常に低いです。 --no-head-object GET実行前にHEADリクエストを行いません。 --encoding バックエンドのエンコーディングです。 詳細については、[概要セクションのエンコーディング](/overview/#encoding)を参照してください。 --memory-pool-flush-time インターナルメモリバッファプールをフラッシュする頻度です。 追加のバッファが必要なアップロード（マルチパートなど）は、割り当てのためにメモリプールを使用します。 このオプションは、未使用のバッファがどの頻度でプールから削除されるかを制御します。 --memory-pool-use-mmap インターナルメモリプールでmmapバッファを使用するかどうか。 --disable-http2 S3バックエンドに対してhttp2の使用を無効にします。 s3（特にminio）バックエンドとHTTP/2に関する問題が現在未解決です。S3バックエンドではデフォルトでHTTP/2が有効になっていますが、ここで無効にすることができます。問題が解決されたら、このフラグは削除されます。 参照: https://github.com/rclone/rclone/issues/4673, https://github.com/rclone/rclone/issues/3631 --download-url ダウンロード用のカスタムエンドポイント。 通常、AWS S3はCloudFrontネットワーク経由でダウンロードされるデータの出口が安価です。 --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」のいずれかである必要があります。 このオプションを使用する場合、ファイルの書き込み操作は許可されませんので、ファイルのアップロードや削除はできません。 有効な形式については[時間オプションのドキュメント](/docs/#time-option)を参照してください。 --decompress このフラグが設定されている場合、gzipでエンコードされたオブジェクトを展開します。 S3に「Content-Encoding: gzip」が設定されたままオブジェクトをアップロードすることが可能です。通常、rcloneはこれらのファイルを圧縮されたオブジェクトとしてダウンロードします。 このフラグが設定されている場合、rcloneはこれらのファイルを「Content-Encoding: gzip」で受け取るときに解凍します。これにより、rcloneはサイズとハッシュをチェックできませんが、ファイルの内容は解凍されます。 --might-gzip バックエンドがオブジェクトをgzipで圧縮する可能性がある場合に設定します。 通常、プロバイダはオブジェクトがダウンロードされる際には変更しません。`Content-Encoding: gzip`でアップロードされていないオブジェクトは、ダウンロード時にそれが設定されません。 ただし、一部のプロバイダは、gzipが設定されていないにもかかわらずオブジェクトをgzip圧縮する場合があります（例：Cloudflare）。 これによる症状は、次のようなエラーメッセージの受け取りです： ERROR corrupted on transfer: sizes differ NNN vs MMM このフラグを設定し、rcloneがContent-Encoding: gzipが設定されたオブジェクトとチャンク転送エンコーディングでダウンロードすると、rcloneはオブジェクトを動的に解凍します。 unsetに設定されている場合（デフォルト）、rcloneはプロバイダの設定に従って適用するため、ここでrcloneの選択をオーバーライドすることができます。 --no-system-metadata システムメタデータの設定と読み取りを抑制します。 オプション： --access-key-id value AWSアクセスキーID。[$ACCESS_KEY_ID] --acl value バケットの作成とオブジェクトの保存またはコピー時に使用されるACL。[$ACL] --endpoint value S3 APIのエンドポイント。[$ENDPOINT] --env-auth 実行時にAWS認証情報を取得します（環境変数または.envファイルがない場合はEC2/ECSメタデータから取得）。（デフォルト：false）[$ENV_AUTH] --help, -h ヘルプを表示します --location-constraint value リージョンに一致する場所の制約。[$LOCATION_CONSTRAINT] --region value 接続するリージョン。[$REGION] --secret-access-key value AWSシークレットアクセスキー（パスワード）。[$SECRET_ACCESS_KEY] 高度な設定 --bucket-acl value バケットの作成時に使用されるACL。[$BUCKET_ACL] --chunk-size value アップロードに使用するチャンクサイズ。（デフォルト： "5Mi"）[$CHUNK_SIZE] --copy-cutoff value マルチパートコピーに切り替えるためのカットオフ。（デフォルト： "4.656Gi"）[$COPY_CUTOFF] --decompress このフラグが設定されている場合、gzipでエンコードされたオブジェクトを展開します。（デフォルト：false）[$DECOMPRESS] --disable-checksum オブジェクトのメタデータにMD5チェックサムを保存しません。（デフォルト：false）[$DISABLE_CHECKSUM] --disable-http2 S3バックエンドに対してhttp2の使用を無効にします。（デフォルト：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エンコードするかどうか：true/false/unset。（デフォルト："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 GET実行前に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 チャンクアップロードに切り替えるためのカットオフ。（デフォルト： "200Mi"）[$UPLOAD_CUTOFF] --use-multipart-etag value バリデーションのためにマルチパートアップロードでETagを使用するかどうか（デフォルト："unset"）[$USE_MULTIPART_ETAG] --use-presigned-request シングルパートのアップロードに署名済みリクエストまたはPutObjectを使用するかどうか。（デフォルト：false）[$USE_PRESIGNED_REQUEST] --v2-auth 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/seaweedfs.md?ask= ``` 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.