Loading...

お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

オブジェクトのダウンロード

説明

このAPIは、バケットに保存されている必要なオブジェクトをダウンロードできるようにします。バケットはその一意のバケット名で参照され、必要なオブジェクトはその名前を使用して参照されます。

リクエスト詳細

リクエストURL

GET

{bucket_name}.zohostratus.com/{key}

copy

上記のドメイン名はデータセンターに応じて変わります:

DC ドメイン名
US zohostratus.com
EU zohostratus.eu
IN zohostratus.in
AU zohostratus.com.au
CA zohostratus.ca
SA zohostratus.sa
JP zohostratus.jp

注意:

  • 開発環境でAPIを使用する場合、ドメインは次のような構造になります: https://<bucket_name>-development.zohostratus.com

  • コンソールからバケットURLを取得することをお勧めします。

パスパラメータ

project_id
Numerical
プロジェクトの一意のID

bucket_name
String

key
String
ダウンロードする必要があるオブジェクトの名前

クエリパラメータ

version_id String
optional
バージョニングが有効な場合にStratusによって生成されるIDです。version_idを使用して必要なオブジェクトを参照できます。

リクエストヘッダー

Authorization: Zoho-oauthtoken {oauth_token}

オプションヘッダー

Range: オブジェクトの特定のバイト範囲をダウンロードする場合

retrieve-meta: オブジェクトのメタデータを取得する場合 | 指定可能な値: True/False | デフォルト値: False

スコープ

Stratus.fileop.READ

レスポンスをオーバーライドするクエリパラメータ

以下のクエリパラメータを追加してレスポンスを変更し、必要なレスポンスを取得できます。これらはすべてオプションパラメータです。オーバーライドはリクエストが成功した場合にのみ機能します。

responseContentType String
optional
レスポンスのContent-Typeヘッダーを設定します。標準的なIANAで定義されたコンテンツタイプのみ使用できます。
responseContentLanguage String
optional
レスポンスのContent-Languageヘッダーを設定します。
responseContentDisposition String
optional
レスポンスのContent-Dispositionヘッダーを設定します。パラメータ値は次の形式である必要があります:
attachment; filename=“name”
例: attachment; filename=“logo.svg”
responseCacheControl String
optional
レスポンスのCache-Controlヘッダーを設定します。
例: public,max-age=3600,no-transform

レスポンス詳細

正常に実行されると、レスポンスにはオブジェクトがダウンロードされ、成功メッセージが表示されます。

失敗レスポンスの可能性

404 オブジェクト/バケットが見つからない場合:

失敗レスポンス
copy
{
"status": 404,
"code": "key_not_found",
"message": "no such key is associated with any object in the bucket"
}
View more

403 未認証。ダウンロード操作を実行するために必要な権限がない場合

失敗レスポンス
copy
{
"status": 403,
"code": "access_forbidden",
"message": "request denied by resource access policy"
}
View more
リクエスト例
copy

curl -X GET https://{bucket_name}.zohostratus.com/{key} -H “Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57”

レスポンス例
copy

200 OK // 生データのバイト

View more