接入地址
對象存儲網絡接入地址為:oos-cn.ctyunapi.cn。對象存儲網絡2接入地址為:oos-cn2.ctyunapi.cn。香港精品網接入地址為:oos-cnhk-hqnet.ctyunapi.cn。香港普通網接入地址為:oos-cnhk-nqnet.ctyunapi.cn。
注意對于對象存儲網絡、對象存儲網絡2中的OOS API,如果您的數據存儲在某個資源池,建議您直接使用該資源池的Endpoint,詳見域名(Endpoint)列表。
通信協議
為了保證通信的安全性,同時支持HTTP和HTTPS。
請求方法
OOS API支持GET、POST、PUT、HEAD、DELETE和OPTION請求方法發送請求。
請求參數
每個請求都需要指定如下信息:
- 每個操作接口都需要包含的公共請求參數。
- 操作接口所特有的請求參數。
本節主要描述公共請求參數和請求結果。
說明在后續提到具體API時,舉例中都會有 公共請求頭、 公共響應頭?,但是不對其進行描述和解釋。
公共請求頭
以下是OOS API的公共請求頭。
名稱 描述 是否必須 BucketName Bucket名稱。
除GET Service (List Bucket)、GET Regions外,其他Bucket、Object操作都需要該參數。
是 Authorization 用于身份驗證的請求頭。Authorization的構造方式請參考安全策略部分,請先確定使用V2還是V4版本的簽名方式,再按照對應的計算方式生成Authorization。? 是 Content-Length 請求體的長度。 否 Content-MD5 按照RFC 1864,使用base64編碼格式生成信息的128位MD5值。此請求頭可以用作數據完整性檢查,以驗證數據是否與客戶端發送的數據相同。 否 x-amz-content-sha256 當使用V4簽名對請求進行身份驗證時,此請求頭提供請求有效負載的哈希。 V4簽名必填。 Content-Type 描述請求內容的標準MIME類型。 否 Date 請求的日期和時間,GMT時間。 V2簽名可以填寫x-Amz-Date或Date。 x-amz-date 請求的日期和時間。日期和時間格式必須遵循ISO 8601標準,并且必須使用“yyyyMMddT HHmmssZ”格式進行格式化。例如,如果日期和時間是“08/01/2018 15:32:41.982-700”,則必須首先將其轉換為UTC(協調世界時),然后提交為“20180801T083241Z”。 V4簽名必填。 Host 請求的域名。
對象存儲網絡的請求域名為:oos-cn.ctyunapi.cn。
對象存儲網絡2的請求域名為:oos-cn2.ctyunapi.cn。
香港精品網的請求域名為:oos-cnhk-hqnet.ctyunapi.cn。
香港普通網的請求域名為:oos-cnhk-nqnet.ctyunapi.cn。
是 Connection 客戶端與OOS服務器之間的連接狀態。
取值:
keep-alive:長連接,請求結束后繼續保持連接。
close:短連接,請求結束后關閉連接。
默認值為:keep-alive。
否
公共響應頭
每個OOS API響應結果中都包含公共響應頭。
名稱 描述 Content-Length 響應體的長度。 Content-Type 響應內容的MIME類型。 Date OOS返回響應的日期和時間。 ETag 文件的哈希值。ETag只反映了文件的內容,而不是其元數據。此響應頭可以用作數據完整性檢查,以驗證數據是否與客戶端發送的數據相同。 Server 服務端名稱,默認值是CTYUN。 x-amz-request-id 用于唯一標示請求的ID。 Connection 客戶端與OOS服務器之間的連接狀態。
如果請求時Connection值為keep-alive,請求結束后繼續保持連接,不返回此響應頭。
如果請求時Connection值為close,請求結束后關閉連接,返回此響應頭Connection: close。