オブジェクトのアップロード
説明
この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 |
パスパラメータ
注意: keyの値を指定する際には、以下の点に注意してください:
-
キーの最大長（パス名とオブジェクト名を含む）は255文字までサポートされます。
-
キーにはスペースを含む以下の文字を含めることはできません: ダブルクォート、両方の山括弧、ハッシュタグ、バックスラッシュ、パイプ記号。
クエリパラメータ
リクエストヘッダー
Authorization: Zoho-oauthtoken {oauth_token}
オプションヘッダー
content-type: application/json
content-length: アップロードされるオブジェクトのバイト単位の生の長さ。
compress: 保存時にオブジェクトを圧縮するかどうか。デフォルトでは常に圧縮が行われます。
cache-control: ブラウザのキャッシュポリシーを指定するためにこのヘッダーを使用します。
overwrite: ソースを上書きする必要があるかどうかを指定します。これはバージョニングされていないバケットのオブジェクトのみサポートされます。
expires-after: オブジェクトのTime-to-Live（TTL）を秒単位で設定するために使用できるオプションです。値は60秒以上である必要があります。
x-user-meta:{1stKey}={1stValue};{2ndKey}={2ndValue};..{NthKey}={NthValue};: オブジェクトのメタデータ。各キーと値のペアはセミコロンで区切られ、前のカラムに示されているように提供されます。このヘッダーの最大許可文字数は2047文字です。
スコープ
Stratus.fileop.CREATE
レスポンス詳細
正常に実行されると、レスポンスには成功メッセージが含まれ、オブジェクトがアップロードされます。
失敗レスポンスの可能性
404 オブジェクト/バケットが見つからない場合:
{
"status": 404,
"code": "bucket_not_found",
"message": "no such bucket exists"
}
403 未認証。アップロード操作を実行するために必要な権限がない場合
{
"status": 403,
"code": "access_forbidden",
"message": "request denied by resource access policy"
}
400 不正なリクエスト。無効なファイル名
{
"status": 400,
"code": "key_name_invalid",
"message": "key name does not support one or more character(s)"
}
409 コンフリクト。同じ名前のオブジェクトが既に存在する
{
"status": 409,
"code": "key_already_exists",
"message": "key is already associated with another object in the bucket"
}
curl -X PUT https://{bucket_name}.zohostratus.com/{key}
-H “Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57”
200 OK
Yes
No
Thank you for your feedback!
Send your feedback to us