此操作用來向指定Bucket中添加一個文件,要求發送請求者對該Bucket有寫權限,用戶必須添加完整的文件。
說明
文件名稱不能包含ASCII碼為0的字符(NUL)。
請求語法
PUT /ObjectName HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue請求頭
| 名稱 | 描述 | 是否必須 |
|---|---|---|
| Cache-Control | 按照請求/回應的方式用來定義緩存行為。 類型:字符串。 | 否 |
| Content-Disposition | 指出文件的描述性的信息。 類型:字符串。 | 否 |
| Content-Encoding | 指出文件所使用的編碼格式。 類型:字符串。 | 否 |
| Content-Length | 指定文件的大小,單位為字節。 類型:字符串。 | 是 |
| Content-MD5 | 按照RFC 1864,使用base64編碼格式生成信息的128位MD5值。此請求頭可以用作數據完整性檢查,以驗證數據是否與客戶端發送的數據相同。 類型:字符串。 | 否 |
| Content-Type | 標準的MIME類型用來描述內容格式。 類型:字符串。 取值:MIME類型。默認值為application/octet-stream。 | 否 |
| Expires | 文件不再被緩存的時間。 類型:字符串。 | 否 |
| x-amz-meta- | 任何頭以這個前綴開始都會被認為是用戶的元數據,當用戶檢索時,它將會和文件一起被存儲并返回。PUT請求頭大小限制為8KiB。在PUT請求頭中,用戶定義的元數據大小限制為2KiB。 類型:字符串。 | 否 |
| x-amz-limit | 文件上傳限制的速率。格式為:x-amz-limit:rate=xxx。 類型:字符串。 取值:大于0的正整數,單位是KiB/s。當取值是大于0小于128的整數時,按速率等于128KiB/s處理。 | 否 |
| x-amz-storage-class | 數據的存儲類型。 類型:字符串。 取值:
默認值為STANDARD。 | 否 |
| x-ctyun-data-location | 設置數據存儲的位置。 注意 香港節點不支持此參數。 類型:字符串。 取值: 格式為:type=Local,scheduleStrategy=scheduleStrategy或者type=Specified,location=location,scheduleStrategy=scheduleStrategy
|
請求參數
| 名稱 | 描述 | 是否必須 |
|---|---|---|
| BucketName | 存儲桶名稱。 | 是 |
請求示例
在名叫example-bucket的Bucket中,存儲一張叫my-image.jpg的圖片。
PUT /my-image.jpg HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Date: Mon, 03 Sep 2012 17:50:00 GMT
Content-Type: image/jpeg
Content-Length: 11434
Authorization: SignatureValue
[11434 bytes of object data]響應示例
HTTP/1.1 100 Continue
HTTP/1.1 200 OK
x-amz-request-id: 767bc103031946fa81fbfdf4f6fcbbbdc0b1b3b5b7b9bbbdbf
Date: Mon, 03 Sep 2012 17:50:00 GMT
ETag: "1b2cf535f27731c974343645a3985328"
Content-Length: 0
Server: CTYUN