オブジェクトのダウンロード
説明
このAPIは、バケットに保存されている必要なオブジェクトをダウンロードできるようにします。バケットはその一意のバケット名で参照され、必要なオブジェクトはその名前を使用して参照されます。
リクエスト詳細
リクエストURL
{bucket_name}.zohostratus.com/{key}
上記のドメイン名はデータセンターに応じて変わります:
| 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を取得することをお勧めします。
パスパラメータ
クエリパラメータ
リクエストヘッダー
Authorization: Zoho-oauthtoken {oauth_token}
オプションヘッダー
Range: オブジェクトの特定のバイト範囲をダウンロードする場合
retrieve-meta: オブジェクトのメタデータを取得する場合 | 指定可能な値: True/False | デフォルト値: False
スコープ
Stratus.fileop.READ
レスポンスをオーバーライドするクエリパラメータ
以下のクエリパラメータを追加してレスポンスを変更し、必要なレスポンスを取得できます。これらはすべてオプションパラメータです。オーバーライドはリクエストが成功した場合にのみ機能します。
attachment; filename=“name”
例: attachment; filename=“logo.svg”
例: public,max-age=3600,no-transform
レスポンス詳細
正常に実行されると、レスポンスにはオブジェクトがダウンロードされ、成功メッセージが表示されます。
失敗レスポンスの可能性
404 オブジェクト/バケットが見つからない場合:
{
"status": 404,
"code": "key_not_found",
"message": "no such key is associated with any object in the bucket"
}
403 未認証。ダウンロード操作を実行するために必要な権限がない場合
{
"status": 403,
"code": "access_forbidden",
"message": "request denied by resource access policy"
}
curl -X GET https://{bucket_name}.zohostratus.com/{key}
-H “Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57”
200 OK
// 生データのバイト
Yes
No
Send your feedback to us