ユースケース
リクエストを直接送信してCloud Object Storage(COS)内のオブジェクトをダウンロードすることができます。オブジェクトのダウンロードについては次の機能をサポートしています。
完全な単一のオブジェクトのダウンロード:GETリクエストを直接送信すると、完全なオブジェクトデータをダウンロードできます。
単一のオブジェクトの内容の一部をダウンロード:GETリクエストにRangeリクエストヘッダーを含めることで、ある特定の文字範囲を検索することができます。複数の範囲を検索することはできません。
オブジェクトのメタデータはHTTPレスポンスヘッダーとして、オブジェクトの内容と共に返されます。GETリクエストはURLパラメータを使用する方法で、応答の一部のメタデータ値を上書きします。
Content-Dispositionの応答値を例にとります。変更可能なレスポンスヘッダーには次のものがあります。
Content-Type
Content-Language
Expires
Cache-Control
Content-Disposition
Content-Encoding
利用方法
COSコンソールの使用
単一オブジェクトのダウンロード
2. 左側ナビゲーションバーでバケットリストをクリックし、バケットリストページに進みます。
3. オブジェクトがあるバケットを見つけ、そのバケット名をクリックし、バケット管理ページに進みます。
4. 左側ナビゲーションバーでファイルリストを選択し、ファイルリストページに進みます。
5. ダウンロードしたいオブジェクトを見つけ、対応するダウンロードボタンを選択します。
選択したオブジェクト右側の操作バーで、ダウンロードをクリックするとダウンロードできます。
オブジェクトにチェックを入れ、上のその他の操作 > ダウンロードをクリックするとダウンロードできます。
選択したオブジェクト右側の操作バーで、詳細をクリックし、ファイル詳細ページに進み、そのページでオブジェクトのダウンロードをクリックするとダウンロードできます。
あるいは、そのページで一時リンクのコピーをクリックし、ブラウザのアドレスバーにリンクを貼り付けてエンターキーを押せば、そのオブジェクトをダウンロードすることができます。
説明:
オブジェクトが属するバケットの属性がプライベート読み取り/書き込みである場合、ここにコピーされたアドレスは自動的に署名を計算し、拡張子を追加します。署名の発行方法の詳細については、リクエスト署名のドキュメントをご参照ください。 署名付きの一時リンクは、オブジェクトの詳細確認をしてから1時間有効です。また、有効期間の更新をクリックして、署名の有効期間を更新することもできます。
デフォルトで、ダウンロードしたオブジェクトをブラウザで直接開くことがサポートされている場合、ダウンロードではなく、一時リンクにアクセスする方法でオブジェクトを直接プレビューできます。
オブジェクトまたはフォルダの一括ダウンロード
説明:
COSコンソールは、単一オブジェクトのダウンロードのみをサポートしています。複数のオブジェクトまたはフォルダを一括ダウンロードしたい場合は、COSBrowserクライアントを直接インストールして使用することをお勧めします。次に、COSBrowserクライアントと連携してコンソールからオブジェクトやフォルダを一括ダウンロードする方法についてご説明します。 2. 左側ナビゲーションバーでバケットリストをクリックし、バケットリストページに進みます。
3. オブジェクトがあるバケットを見つけ、そのバケット名をクリックし、バケット管理ページに進みます。
4. 左側ナビゲーションバーでファイルリストを選択し、ファイルリストページに進みます。
5. 複数のオブジェクトにチェックを入れ、上のその他の操作 > ダウンロードをクリックします。
6. ポップアップウィンドウのプロンプトに従って、COSBrowserクライアントをインストールするか、開いてログインします。
7. COSBrowserを開いた後、ファイルの保存先を選択すると、選択したファイルが自動的にダウンロードキューに追加され、ダウンロードが開始されます。右上の転送アイコンをクリックすると、ダウンロードの進捗を確認できます。
REST APIの使用
REST APIを直接使用してオブジェクトのダウンロードリクエストを送信できます。 詳細については、GET ObjectのAPIドキュメントをご参照ください。 SDKの使用
SDKのオブジェクトダウンロードメソッドを直接呼び出すことができます。詳細については、下記の各言語のSDKドキュメントをご参照ください。