tencent cloud

Cloud Object Storage

アーカイブファイルの取得 - restore

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-05-19 15:52:09
restoreコマンドは、アーカイブファイルを取得するときに使います。
注意:
このコマンドを使用するには、ポリシー許可を設定する際に、actionをcos:HeadBucket,cos:GetBucket,cos:PostObjectRestoreに設定する必要があります。詳細な権限については、CAM対応APIをご参照ください。

コマンド形式

./coscli restore cos://<bucket-name>[/prefix/] [flag]
restoreコマンドには以下のパラメータが含まれています:
パラメータ形式
パラメータ用途
cos://<bucket-name>
アクセスするバケットを指定します。パラメータ設定 のバケットの別名、またはバケット名を使用してアクセスすることがサポートされております。バケット名でアクセスする場合は、追加の endpoint flag が必要になります。
バケットの別名を使用してアクセスする場合:cos://example-aliasバケット名を使用してアクセスする場合:cos://examplebucket-1250000000
/prefix/
オプションのパラメータ。特定のフォルダを指定します。
/picture/
restoreコマンドには、以下のオプションflagが含まれます。
flagの略称
flagの正式名称
flagの用途
-h
--help
ヘルプ情報を出力
なし
--include
特定のモードを含むファイル
なし
--exclude
特定のモードを除外したファイル
-d
--days
一時ファイルの有効期限を指定(デフォルトは3日間)
-m
--mode
リカバリモードを指定(デフォルトはStandard)
アーカイブストレージタイプのデータを復元する場合、選択できる値はExpedited、Standard、Bulkであり、それぞれクイックリトリーブ、標準リトリーブ、およびバッチリトリーブに対応します。
ディープアーカイブストレージタイプのデータを復元する場合、選択できる値はStandard、Bulkです
-r
--recursive
フォルダの再帰的なトラバーサル処理
なし
--fail-output
このオプションは、ファイル復元失敗のエラー出力を有効にするかどうかを決定します(デフォルトはtrue、有効)。有効にすると、ファイル回復失敗が指定されたディレクトリ内に記録されます(指定されていない場合、デフォルトは./coscli_output)。無効にすると、エラーファイルの数のみがコンソールに出力されます。
なし
--fail-output-path
このオプションは、ファイル復元失敗のエラー出力フォルダを指定するために使用されます。カスタムフォルダパスを提供することで、エラー出力フォルダの場所と名前を制御できます。このオプションが設定されていない場合、デフォルトのエラーログフォルダ./coscli_outputが使用されます。
説明:
--include--excludeは標準的な正規表現の構文をサポートしており、これを使えば特定の条件を満たすファイルをフィルタリングすることができます。
zshを使用する場合、pattern文字列の両端に二重引用符を付ける必要がある場合があります。
./coscli restore cos://bucket1/example/ -r --include ".*\\.mp4$"
このコマンドのその他の一般的なオプション(バケットの切り替え、ユーザーアカウントの切り替えなど)については、一般オプション ドキュメンテーションを参照してください。
アーカイブファイルの取得の詳細は、POST Object restore をご参照ください。

操作事例

標準モードでbucket1のアーカイブファイルを取得します

./coscli restore cos://bucket1/picture.jpg

bucket1内のpictureフォルダにあるすべてのアーカイブファイルを超高速モードで取得します

./coscli restore cos://bucket1/picture/ -r --mode Expedited

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック