Drive
名前:
singularity storage update drive - Google Drive
使用法:
singularity storage update drive [コマンドオプション] <名前|ID>
説明:
--client-id
GoogleのアプリケーションクライアントID
自分自身のものを設定することをおすすめします。
自分自身で作成する方法については、https://rclone.org/drive/#making-your-own-client-idを参照してください。
空白のままにすると、パフォーマンスが低下する内部キーが使用されます。
--client-secret
OAuthクライアントシークレット。
通常は空白のままにしておきます。
--token
OAuthアクセストークン(JSON形式)。
--auth-url
認証サーバーのURL。
プロバイダのデフォルトを使用するには空白のままにしておきます。
--token-url
トークンサーバーのURL。
プロバイダのデフォルトを使用するには空白のままにしておきます。
--scope
ドライブへのアクセス時にrcloneが使用するスコープ。
例:
| drive | 全ファイルへの完全アクセス(アプリケーションデータフォルダを除く)。
| drive.readonly | ファイルのメタデータとファイルの内容への読み取り専用アクセス。
| drive.file | rcloneによって作成されたファイルへのアクセスのみ。
| | これらはドライブのウェブサイトで表示されます。
| | ファイルの承認はユーザーがアプリを承認解除すると取り消されます。
| drive.appfolder | Application Dataフォルダへの読み取りと書き込みのアクセスを許可。
| | これはドライブのウェブサイトで表示されません。
| drive.metadata.readonly | ファイルのメタデータへの読み取り専用アクセスですが、
| | ファイルの内容を読み取ることやダウンロードすることはできません。
--root-folder-id
ルートフォルダのID。
通常は空白のままにしておきます。
ドキュメントを参照)またはrcloneが使用する非ルートフォルダを
開始点として使用するために入力します。
--service-account-file
サービスアカウントの認証情報のJSONファイルパス。
通常は空白のままにしておきます。
インタラクティブログインの代わりにSAを使用する場合にのみ必要です。
先頭の`~`はファイル名の中で展開されます。
`${RCLONE_CONFIG_DIR}`などの環境変数も同様です。
--service-account-credentials
サービスアカウント認証情報のJSON blob。
通常は空白のままにしておきます。
インタラクティブログインの代わりにSAを使用する場合にのみ必要です。
--team-drive
共有ドライブ(チームドライブ)のID。
--auth-owner-only
認証されたユーザーによって所有されているファイルのみを考慮する。
--use-trash
ファイルを完全に削除する代わりにゴミ箱に送信。
既定では、ファイルはゴミ箱に送信されます。
ファイルを完全に削除する場合は「--drive-use-trash=false」とします。
--copy-shortcut-content
ショートカットの代わりにサーバーサイドでショートカットの内容をコピーする。
サーバーサイドコピーを実行すると、通常rcloneはショートカットをショートカットのままコピーします。
このフラグを使用すると、サーバーサイドコピーを実行する際に、rcloneはショートカットの内容をコピーします。
--skip-gdocs
すべてのリストでGoogleドキュメントをスキップする。
与えられた場合、gdocsはrcloneにとってほとんど見えなくなります。
--skip-checksum-gphotos
GoogleフォトおよびビデオのMD5チェックサムをスキップする。
Googleフォトやビデオの転送時にチェックサムエラーが発生する場合に使用します。
このフラグを設定すると、Googleフォトおよびビデオは空のMD5チェックサムを返します。
なお、Googleフォトは「photos」スペースにあることで識別されます。
破損したチェックサムは、Googleがイメージ/ビデオを変更したが
チェックサムを更新しなかったために発生します。
--shared-with-me
共有されたファイルのみを表示する。
rcloneが「Shared with me」フォルダで操作するように指示します(
ここではGoogleドライブを介して他のユーザーが共有したファイルとフォルダにアクセスできます)。
これは「list」(lsd、lslなど)および「copy」(copy、syncなど)コマンドだけでなく、
他のすべてのコマンドでも機能します。
--trashed-only
ゴミ箱にあるファイルのみを表示する。
これにより、元のディレクトリ構造のまま、ゴミ箱の中のファイルが表示されます。
--starred-only
スターがついているファイルのみを表示する。
--formats
廃止予定: export_formatsを参照してください。
--export-formats
Googleドキュメントをダウンロードする際の優先フォーマットのカンマ区切りリスト。
--import-formats
Googleドキュメントをアップロードする際の優先フォーマットのカンマ区切りリスト。
--allow-import-name-change
Googleドキュメントをアップロードする際にファイルタイプの変更を許可する。
たとえば、file.docからfile.docxに変わります。
これにより、同期が混乱し、毎回再アップロードされます。
--use-created-date
更新日ではなく作成日を使用する。
データのダウンロード時に作成日を計算したい場合に便利です。
**警告**:このフラグにはいくつかの予期しない影響がある場合があります。
ドライブにアップロードすると、**すべてのファイルが上書き**されます
(作成以降に変更されていない場合を除く)。
ダウンロード時にはその逆が起こります。
この副作用を回避するには、「--checksum」フラグを使用します。
この機能は、Googleフォトによって記録された写真の撮影日を維持するために実装されました。
Googleドライブの設定で「Google Photosフォルダを作成する」オプションをチェックする必要があります。
その後、写真をローカルにコピーまたは移動し、
イメージの撮影日(作成日)を変更日として設定できます。
--use-shared-date
共有された日付(作成日)の代わりに更新日を使用する。
注:「--drive-use-created-date」と同様に、このフラグには
アップロード/ダウンロード時のファイルに予期しない影響がある場合があります。
このフラグと「--drive-use-created-date」の両方が設定されている場合、作成日が使用されます。
--list-chunk
リストのチャンクサイズ 100-1000、0で無効。
--impersonate
サービスアカウントを使用する場合に、このユーザーをなりすます。
--alternate-export
廃止予定: もはや必要ありません。
--upload-cutoff
チャンクアップロードに切り替えるための閾値。
--chunk-size
アップロードチャンクのサイズ。
2のn乗であり、256k以上である必要があります。
これを大きくするとパフォーマンスが向上しますが、
各チャンクは転送ごとにメモリに1つずつバッファリングされます。
これを減らすとメモリ使用量が減少しますが、パフォーマンスが低下します。
--acknowledge-abuse
"cannotDownloadAbusiveFile"エラーコードで「このファイルは悪意のあるコンテンツまたはスパムとして識別され、ダウンロードできません」というエラーメッセージが返されるファイルをダウンロードできるように設定する。
ファイルのダウンロード時に「cannotDownloadAbusiveFile」というエラーコードが返される場合、このフラグをrcloneに指定して、
ダウンロードするファイルのリスクを承知したことを示します。
rcloneはそれでもファイルをダウンロードします。
なお、サービス アカウントを使用している場合、このフラグが機能するためには Manager 権限(Content Manager ではありません)が必要です。
SAに適切な権限がない場合、Googleはこのフラグを無視します。
--keep-revision-forever
各ファイルの新しいヘッドリビジョンを永久に保持する。
--size-as-quota
サイズをストレージとしての使用クオータ表示する。
ファイルのサイズを使用したストレージクオータとして表示します。
これは現行バージョンと、永久に保持するように設定された古いバージョンを合算します。
**警告**:このフラグにはいくつかの予期しない影響がある場合があります。
構成ファイルでこのフラグを設定することはお勧めしません。
推奨されるのは、rclone ls/lsl/lsf/lsjsonなどを実行する際に--drive-size-as-quotaフラグを使用することです。
同期にこのフラグを使用する場合は --ignore size も使用する必要があります。
--v2-download-min-size
オブジェクトがこれよりも大きい場合は、v2 APIを使用してダウンロードします。
--pacer-min-sleep
API呼び出し間の最小スリープ時間。
--pacer-burst
スリープせずに許可されるAPI呼び出しの数。
--server-side-across-configs
異なるドライブ構成間でサーバーサイドの操作(例:コピー)を実行することを許可する。
これは、2つの異なるGoogleドライブ間でサーバーサイドのコピーを行いたい場合に便利です。
すべての構成の間で動作するかどうかは簡単に判断できないため、デフォルトでは無効になっています。
--disable-http2
Driveがhttp2を使用しないように設定する。
現在、GoogleドライブバックエンドとHTTP/2の間に解決できない問題があります。
ドライブバックエンドではHTTP/2はデフォルトで無効になっていますが、ここで再度有効にできます。
この問題が解決されると、このフラグは削除されます。
参照: https://github.com/rclone/rclone/issues/3631
--stop-on-upload-limit
アップロード制限エラーを致命的にする。
現時点では、Googleドライブに1日あたり750 GiBのデータをアップロードすることが可能です(これは非公開の制限です)。
この制限に達すると、Googleドライブはわずかに異なるエラーメッセージを生成します。
このフラグが設定されていると、これらのエラーは致命的となります。
これにより、進行中の同期が中止されます。
Googleが文書化していないエラーメッセージ文字列に依存しているため、この検出は将来的には壊れる可能性があります。
参照: https://github.com/rclone/rclone/issues/3857
--stop-on-download-limit
ダウンロード制限エラーを致命的にする。
現時点では、Googleドライブから1日あたり10 TiBのデータをダウンロードすることが可能です(これは非公開の制限です)。
この制限に達すると、Googleドライブはわずかに異なるエラーメッセージを生成します。
このフラグが設定されていると、これらのエラーは致命的となります。
これにより、進行中の同期が中止されます。
Googleが文書化していないエラーメッセージ文字列に依存しているため、この検出は将来的には壊れる可能性があります。
--skip-shortcuts
ショートカットファイルをスキップする場合は、設定する。
通常、rcloneではショートカットファイルを参照先のオリジナルファイルとして処理します(ショートカットについては、[ショートカットセクション](#shortcuts)を参照)。
このフラグが設定されている場合、rcloneはショートカットファイルを完全に無視します。
--skip-dangling-shortcuts
ダングリングショートカットファイルをスキップする場合は、設定する。
このフラグが設定されている場合、rcloneはリストにダングリングショートカットを表示しません。
--resource-key
リンク共有されたファイルにアクセスするためのリソースキー。
次のようなリンクで共有されたファイルにアクセスする必要がある場合は、
https://drive.google.com/drive/folders/XXX?resourcekey=YYY&usp=sharing
"XXX"を"root_folder_id"、"YYY"を"resource_key"として使用する必要があります。
そうしないと、ディレクトリにアクセスしようとすると、404 not found エラーが表示されます。
参照: https://developers.google.com/drive/api/guides/resource-keys
このリソースキーの要件は、一部の古いファイルにのみ適用されます。
また、(利用したいユーザーでrcloneが認証されている場合)、
1回ウェブインターフェースでフォルダを開くだけで、リソースキーを必要としないようです。
--encoding
バックエンドのエンコーディング。
詳細については[概要のエンコーディングセクション](/overview/#encoding)を参照してください。
オプション:
--alternate-export 廃止予定: もはや必要ありません。(default: false) [$ALTERNATE_EXPORT]
--client-id value GoogleのアプリケーションクライアントID [$CLIENT_ID]
--client-secret value OAuthクライアントシークレット [$CLIENT_SECRET]
--help, -h ヘルプを表示する
--scope value ドライブへのアクセス時にrcloneが使用するスコープ [$SCOPE]
--service-account-file value サービスアカウントの認証情報のJSONファイルパス [$SERVICE_ACCOUNT_FILE]
高度なオプション
--acknowledge-abuse "cannotDownloadAbusiveFile"エラーコードで「このファイルは悪意のあるコンテンツまたはスパムとして識別され、ダウンロードできません」というエラーメッセージが返されるファイルをダウンロードできるように設定する。(default: false) [$ACKNOWLEDGE_ABUSE]
--allow-import-name-change Googleドキュメントをアップロードする際にファイルタイプの変更を許可する。(default: false) [$ALLOW_IMPORT_NAME_CHANGE]
--auth-owner-only 認証されたユーザーによって所有されているファイルのみを考慮する。(default: false) [$AUTH_OWNER_ONLY]
--auth-url value 認証サーバーのURL [$AUTH_URL]
--chunk-size value アップロードチャンクのサイズ。(default: "8Mi") [$CHUNK_SIZE]
--copy-shortcut-content ショートカットの代わりにサーバーサイドでショートカットの内容をコピーする。(default: false) [$COPY_SHORTCUT_CONTENT]
--disable-http2 Driveがhttp2を使用しないように設定する。(default: true) [$DISABLE_HTTP2]
--encoding value バックエンドのエンコーディング。(default: "InvalidUtf8") [$ENCODING]
--export-formats value Googleドキュメントをダウンロードする優先フォーマットのカンマ区切りリスト。(default: "docx,xlsx,pptx,svg") [$EXPORT_FORMATS]
--formats value 廃止予定: export_formatsを参照してください。 [$FORMATS]
--impersonate value サービスアカウントを使用する場合に、このユーザーをなりすます。 [$IMPERSONATE]
--import-formats value Googleドキュメントをアップロードする優先フォーマットのカンマ区切りリスト。 [$IMPORT_FORMATS]
--keep-revision-forever 各ファイルの新しいヘッドリビジョンを永久に保持する。(default: false) [$KEEP_REVISION_FOREVER]
--list-chunk value リストのチャンクサイズ 100-1000、0で無効。 (default: 1000) [$LIST_CHUNK]
--pacer-burst value スリープせずに許可されるAPI呼び出しの数。 (default: 100) [$PACER_BURST]
--pacer-min-sleep value API呼び出し間の最小スリープ時間。 (default: "100ms") [$PACER_MIN_SLEEP]
--resource-key value リンク共有されたファイルにアクセスするためのリソースキー。 [$RESOURCE_KEY]
--root-folder-id value ルートフォルダのID。 [$ROOT_FOLDER_ID]
--server-side-across-configs 異なるドライブ構成間でサーバーサイドの操作(例:コピー)を実行することを許可する。(default: false) [$SERVER_SIDE_ACROSS_CONFIGS]
--service-account-credentials value サービスアカウント認証情報のJSON blob。 [$SERVICE_ACCOUNT_CREDENTIALS]
--shared-with-me 共有されたファイルのみを表示する。(default: false) [$SHARED_WITH_ME]
--size-as-quota サイズをストレージとしての使用クオータ表示する。(default: false) [$SIZE_AS_QUOTA]
--skip-checksum-gphotos GoogleフォトおよびビデオのMD5チェックサムをスキップする。(default: false) [$SKIP_CHECKSUM_GPHOTOS]
--skip-dangling-shortcuts ダングリングショートカットファイルをスキップする場合は、設定する。(default: false) [$SKIP_DANGLING_SHORTCUTS]
--skip-gdocs すべてのリストでGoogleドキュメントをスキップする。(default: false) [$SKIP_GDOCS]
--skip-shortcuts ショートカットファイルをスキップする場合は、設定する。(default: false) [$SKIP_SHORTCUTS]
--starred-only スターがついているファイルのみを表示する。(default: false) [$STARRED_ONLY]
--stop-on-download-limit ダウンロード制限エラーを致命的にする。(default: false) [$STOP_ON_DOWNLOAD_LIMIT]
--stop-on-upload-limit アップロード制限エラーを致命的にする。(default: false) [$STOP_ON_UPLOAD_LIMIT]
--team-drive value 共有ドライブ(チームドライブ)のID。 [$TEAM_DRIVE]
--token value OAuthアクセストークン(JSON形式)。 [$TOKEN]
--token-url value トークンサーバーのURL。 [$TOKEN_URL]
--trashed-only ゴミ箱にあるファイルのみを表示する。(default: false) [$TRASHED_ONLY]
--upload-cutoff value チャンクアップロードに切り替えるための閾値。(default: "8Mi") [$UPLOAD_CUTOFF]
--use-created-date 更新日ではなく作成日を使用する。(default: false) [$USE_CREATED_DATE]
--use-shared-date 共有された日付(作成日)の代わりに更新日を使用する。(default: false) [$USE_SHARED_DATE]
--use-trash ファイルを完全に削除する代わりにゴミ箱に送信する。(default: true) [$USE_TRASH]
--v2-download-min-size value オブジェクトがこれよりも大きい場合は、v2 APIを使用してダウンロードします。(default: "off") [$V2_DOWNLOAD_MIN_SIZE]
Last updated