接口說明
OBS使用PUT操作為桶設置自定義域名,設置成功之后,用戶訪問桶的自定義域名就能訪問到桶。
必須保證此自定義域名通過DNS能夠正確解析到OBS服務。
URL
PUT https://obs.af-south-1.myhuaweicloud.com/
請求參數(shù)
| 名稱 | 類型 | IN | 必選 | 描述 |
|---|---|---|---|---|
|
Authorization
|
string | header | 是 |
請求消息中可帶的簽名信息。 |
|
Date
|
string | header | 否 |
請求發(fā)起端的日期和時間,例如:Wed, 27 Jun 2018 13:39:15 +0000。 默認值:無。 條件:如果消息頭中帶了x-obs-date字段,則可以不帶該字段,其他情況下必選。 |
|
bucket_name
|
string | query | 是 |
請求的桶名稱。 |
|
customdomain
|
string | query | 是 |
桶的自定義域名。 類型:字符串,必須滿足域名規(guī)則。 規(guī)格:最長256字節(jié)。 默認值:無。 約束:一個桶最多可以設置30個自定義域名,一個自定義域名只能被一個桶使用。 |
返回參數(shù)
返回碼: 200
請求成功響應消息。
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Content-Length
|
string | 否 |
響應消息體的字節(jié)長度。 |
|
Connection
|
string | 否 |
指明與服務器的連接是長連接還是短連接。 |
|
Date
|
string | 否 |
OBS系統(tǒng)響應的時間。 |
|
ETag
|
string | 否 |
對象的base64編碼的128位MD5摘要。ETag是對象內容的唯一標識,可以通過該值識別對象內容是否有變化。比如上傳對象時ETag為A,下載對象時ETag為B,則說明對象內容發(fā)生了變化。實際的ETag是對象的哈希值。ETag只反映變化的內容,而不是其元數(shù)據。上傳的對象或拷貝操作創(chuàng)建的對象,通過MD5加密后都有唯一的ETag。如果通過多段上傳對象,則無論加密方法如何,MD5會拆分ETag,此類情況ETag就不是MD5的摘要。 |
|
x-obs-id-2
|
string | 否 |
幫助定位問題的特殊符號。 |
|
x-obs-request-id
|
string | 否 |
由OBS創(chuàng)建來唯一確定本次請求的值,可以通過該值來定位問題。 |
請求示例
示例 1
"/?customdomain=obs.ccc.com"
"PUT /?customdomain=obs.ccc.com HTTP/1.1\nUser-Agent: curl/7.29.0\nHost: examplebucket.obs.cn-north-4.myhuaweicloud.com \nAccept: */*\nDate: Mon, 14 Jan 2019 08:31:36 +0000\nAuthorization: OBS UDS IAM STUBTEST000094:u2kJF4kENs6KlIDcAZpAKSKPtnc=\nContent-Length: 0\n"
錯誤碼
請參考 錯誤碼說明。
