華為云計(jì)算 云知識(shí) 創(chuàng)建桶CreateBucket
創(chuàng)建桶CreateBucket
時(shí)間: 2023-08-15 11:37:38
猜你想看：
實(shí)時(shí)語(yǔ)音識(shí)別 云服務(wù)器配置 CDN是什么意思 視頻點(diǎn)播加速 什么是云桌面

 

接口說(shuō)明

創(chuàng)建桶是指按照用戶指定的桶名創(chuàng)建一個(gè)新桶的操作。

說(shuō)明: 默認(rèn)情況下,一個(gè)用戶可以擁有的桶的數(shù)量不能超過(guò)100個(gè)。 用戶刪除桶后,需要等待30分鐘才能創(chuàng)建同名桶和并行文件系統(tǒng)。 OBS支持在創(chuàng)建桶時(shí)指定桶的AZ類型,您可以開(kāi)啟或關(guān)閉多AZ。關(guān)閉多AZ時(shí),桶內(nèi)數(shù)據(jù)默認(rèn)存儲(chǔ)在單個(gè)AZ內(nèi);開(kāi)啟多AZ時(shí),桶內(nèi)數(shù)據(jù)冗余存儲(chǔ)在多個(gè)AZ內(nèi),可靠性更高。舊桶AZ類型默認(rèn)為單AZ。 新創(chuàng)建桶的桶名在OBS中必須是唯一的。如果是同一個(gè)用戶重復(fù)創(chuàng)建同一區(qū)域的同名桶時(shí)返回成功。除此以外的其他場(chǎng)景重復(fù)創(chuàng)建同名桶返回桶已存在。用戶可以在請(qǐng)求消息頭中加入x-obs-acl等參數(shù),設(shè)置要?jiǎng)?chuàng)建桶的權(quán)限控制策略。

存儲(chǔ)類型

允許用戶創(chuàng)建不同默認(rèn)存儲(chǔ)類型的桶。發(fā)送創(chuàng)桶請(qǐng)求時(shí)攜帶頭域“x-obs-storage-class”來(lái)指定桶的默認(rèn)存儲(chǔ)類型。桶內(nèi)對(duì)象的存儲(chǔ)類型與桶默認(rèn)存儲(chǔ)類型保持一致。存儲(chǔ)類型有3種:STANDARD(標(biāo)準(zhǔn)存儲(chǔ))、WARM(低頻訪問(wèn)存儲(chǔ))、COLD(歸檔存儲(chǔ))。如果沒(méi)有攜帶此頭域 ,則創(chuàng)建的桶為標(biāo)準(zhǔn)存儲(chǔ)類型。

當(dāng)往桶內(nèi)上傳對(duì)象時(shí),如果沒(méi)有指定對(duì)象的存儲(chǔ)類別(參考PUT上傳),則該對(duì)象的存儲(chǔ)類型取桶的默認(rèn)存儲(chǔ)類型。

OBS標(biāo)準(zhǔn)存儲(chǔ)擁有低訪問(wèn)時(shí)延和較高的吞吐量,因而適用于有大量熱點(diǎn)文件需要頻繁訪問(wèn)數(shù)據(jù)的業(yè)務(wù)場(chǎng)景,例如: 大數(shù)據(jù) 、移動(dòng)應(yīng)用、熱點(diǎn)視頻、社交圖片等場(chǎng)景。 OBS低頻訪問(wèn)存儲(chǔ)適用于不頻繁訪問(wèn)(少于每月一次訪問(wèn))但在需要時(shí)也要求快速訪問(wèn)數(shù)據(jù)的業(yè)務(wù)場(chǎng)景,例如:文件同步/共享、企業(yè)備份等場(chǎng)景。與標(biāo)準(zhǔn)存儲(chǔ)相比,低頻訪問(wèn)存儲(chǔ)有相同的數(shù)據(jù)持久性、吞吐量以及訪問(wèn)時(shí)延,且成本較低,但是可用性略低于標(biāo)準(zhǔn)存儲(chǔ)。 OBS歸檔存儲(chǔ)適用于很少訪問(wèn)(平均一年訪問(wèn)一次)數(shù)據(jù)的業(yè)務(wù)場(chǎng)景,例如:數(shù)據(jù)歸檔、長(zhǎng)期備份等場(chǎng)景。歸檔存儲(chǔ)安全、持久且成本極低,可以用來(lái)替代磁帶庫(kù)。為了保持成本低廉,數(shù)據(jù)取回時(shí)間可能長(zhǎng)達(dá)數(shù)分鐘到數(shù)小時(shí)不等。

URL
PUT  https://obs.cn-north-4.myhuaweicloud.com/ 
請(qǐng)求參數(shù)
名稱 類型 IN 必選 描述
Authorization
 
 string header 是

請(qǐng)求消息中可帶的簽名信息。
Date
 
 string header 否

請(qǐng)求發(fā)起端的日期和時(shí)間,例如:Wed, 27 Jun 2018 13:39:15 +0000。 默認(rèn)值:無(wú)。 條件:如果消息頭中帶了x-obs-date字段,則可以不帶該字段,其他情況下必選。
x-obs-acl
 
 string header 否

創(chuàng)建桶時(shí),可以加上此消息頭設(shè)置桶的權(quán)限控制策略,使用的策略為預(yù)定義的常用策略,包括:private、public-read、public-read-write、public-read-delivered、public-read-write-delivered、bucket-owner-full-control(各策略詳細(xì)說(shuō)明見(jiàn)ACL章節(jié)的“使用頭域設(shè)置ACL”)。
x-obs-storage-class
 
 string header 否

創(chuàng)建桶時(shí),可以加上此消息頭設(shè)置桶的默認(rèn)存儲(chǔ)類型,默認(rèn)存儲(chǔ)類型有3種:STANDARD(標(biāo)準(zhǔn)存儲(chǔ))、WARM(低頻訪問(wèn)存儲(chǔ))、COLD(歸檔存儲(chǔ))、HIGH_PERFORMANCE(高性能存儲(chǔ),只有并行文件系統(tǒng)支持)。如果沒(méi)有指定此頭域,則創(chuàng)建的桶為標(biāo)準(zhǔn)存儲(chǔ)類型。
x-obs-grant-read
 
 string header 否

授權(quán)給指定domain下的所有用戶有READ權(quán)限。允許列舉桶內(nèi)對(duì)象、列舉桶中多段任務(wù)、列舉桶中多版本對(duì)象、獲取桶元數(shù)據(jù)。
x-obs-grant-write
 
 string header 否

授權(quán)給指定domain下的所有用戶有WRITE權(quán)限。允許創(chuàng)建、刪除、覆蓋桶內(nèi)所有對(duì)象,允許初始化段、上傳段、拷貝段、合并段、取消多段上傳任務(wù)。
x-obs-grant-read-acp
 
 string header 否

授權(quán)給指定domain下的所有用戶有READ_ACP權(quán)限。允許讀桶的ACL信息。
x-obs-grant-write-acp
 
 string header 否

授權(quán)給指定domain下的所有用戶有WRITE_ACP權(quán)限,允許修改桶的ACL信息。
x-obs-grant-full-control
 
 string header 否

授權(quán)給指定domain下的所有用戶有FULL_CONTROL權(quán)限。
x-obs-grant-read-delivered
 
 string header 否

授權(quán)給指定domain下的所有用戶有READ權(quán)限,并且在默認(rèn)情況下,該READ權(quán)限將傳遞給桶內(nèi)所有對(duì)象。
x-obs-grant-full-control-delivered
 
 string header 否

授權(quán)給指定domain下的所有用戶有FULL_CONTROL權(quán)限,并且在默認(rèn)情況下,該FULL_CONTROL權(quán)限將傳遞給桶內(nèi)所有對(duì)象。
x-obs-az-redundancy
 
 string header 否

創(chuàng)建桶時(shí)帶上此消息頭設(shè)置桶的存儲(chǔ)類型為多AZ。不攜帶時(shí)默認(rèn)為單AZ。用戶攜帶該頭域指定新創(chuàng)的桶的存儲(chǔ)類型為多AZ,存在一種情況是當(dāng)該區(qū)域如果不支持多AZ存儲(chǔ),則該桶的存儲(chǔ)類型仍為單AZ。
x-obs-fs-file-interface
 
 string header 否

創(chuàng)建桶時(shí)可以帶上此消息頭以創(chuàng)建并行文件系統(tǒng)。
x-obs-epid
 
 string header 否

企業(yè)項(xiàng)目id,開(kāi)通企業(yè)項(xiàng)目的用戶可以從企業(yè)項(xiàng)目服務(wù)獲取,格式為uuid,默認(rèn)項(xiàng)目傳“0”或者不帶該頭域,未開(kāi)通企業(yè)項(xiàng)目的用戶可以不帶該頭域。
x-obs-cluster-type
 
 string header 否

指定桶是創(chuàng)建在公共集群還是專屬集群。
x-obs-location-clustergroup-id
 
 string header 否

集群顯性化創(chuàng)桶時(shí),指定的集群組ID
x-obs-ies-location
 
 string header 否

如果是要?jiǎng)?chuàng)建在IES站點(diǎn)上,則指定IES站點(diǎn)的AZ ID。此參數(shù)和x-obs-cluster-type不可共存。
bucket_name
 
 string query 是

考慮到桶名會(huì)作為訪問(wèn)域名的一部分,需要參與 域名解析 ,因此桶名需要滿足DNS域名規(guī)范。OBS系統(tǒng)在接受創(chuàng)桶請(qǐng)求時(shí),會(huì)對(duì)桶名進(jìn)行嚴(yán)格的檢查,具體規(guī)則如下: 需全局唯一,不能與已有的任何桶名稱重復(fù),包括其他用戶創(chuàng)建的桶。用戶刪除桶后,立即創(chuàng)建同名桶或并行文件系統(tǒng)會(huì)創(chuàng)建失敗,需要等待30分鐘才能創(chuàng)建。 長(zhǎng)度范圍為3到63個(gè)字符,支持小寫字母、數(shù)字、中劃線(-)、英文句號(hào)(.)。 禁止兩個(gè)英文句號(hào)(.)相鄰,禁止英文句號(hào)(.)和中劃線(-)相鄰,禁止以英文句號(hào)(.)和中劃線(-)開(kāi)頭或結(jié)尾。 禁止使用IP地址。 須知: 當(dāng)使用HTTPS協(xié)議訪問(wèn)OBS系統(tǒng)時(shí),由于SSL的通配符證書僅匹配不包含"."的桶。這將導(dǎo)致桶名包含"."的桶在訪問(wèn)OBS系統(tǒng)時(shí),客戶端會(huì)提示證書校驗(yàn)存在風(fēng)險(xiǎn),比如瀏覽器安全提示會(huì)呈現(xiàn)紅色告警。因此如非必要,請(qǐng)盡量不要在桶名中包含"."。
Body參數(shù)
名稱 類型 必選 描述
Location
 
 string 否

指定Bucket在哪個(gè)區(qū)域被創(chuàng)建。 使用華北-北京一的終端節(jié)點(diǎn)創(chuàng)桶時(shí) 不攜帶Location,桶將默認(rèn)創(chuàng)建在華北-北京一(cn-north-1) 在Location中指定其它區(qū)域,例如華北-北京四(cn-north-4),桶將創(chuàng)建在指定區(qū)域 使用華北-北京一以外其它區(qū)域的終端節(jié)點(diǎn)創(chuàng)桶時(shí),必須攜帶Location,并且Location只能指定為該終端節(jié)點(diǎn)對(duì)應(yīng)的區(qū)域。 例如使用obs.cn-north-4.myhuaweicloud.com終端節(jié)點(diǎn)創(chuàng)桶時(shí),必須指定Location為cn-north-4。

有關(guān)OBS區(qū)域和終端節(jié)點(diǎn)的更多信息,請(qǐng)參考地區(qū)和終端節(jié)點(diǎn)。
返回參數(shù)
返回碼: 200

成功響應(yīng)消息

名稱 類型 必選 描述
Content-Length
 
 string 否

響應(yīng)消息體的字節(jié)長(zhǎng)度。
Connection
 
 string 否

指明與服務(wù)器的連接是長(zhǎng)連接還是短連接。
Date
 
 string 否

OBS系統(tǒng)響應(yīng)的時(shí)間。
ETag
 
 string 否

對(duì)象的base64編碼的128位MD5摘要。ETag是對(duì)象內(nèi)容的唯一標(biāo)識(shí),可以通過(guò)該值識(shí)別對(duì)象內(nèi)容是否有變化。比如上傳對(duì)象時(shí)ETag為A,下載對(duì)象時(shí)ETag為B,則說(shuō)明對(duì)象內(nèi)容發(fā)生了變化。實(shí)際的ETag是對(duì)象的哈希值。ETag只反映變化的內(nèi)容,而不是其元數(shù)據(jù)。上傳的對(duì)象或拷貝操作創(chuàng)建的對(duì)象,通過(guò)MD5加密后都有唯一的ETag。如果通過(guò)多段上傳對(duì)象,則無(wú)論加密方法如何,MD5會(huì)拆分ETag,此類情況ETag就不是MD5的摘要。
x-obs-id-2
 
 string 否

幫助定位問(wèn)題的特殊符號(hào)。
x-obs-request-id
 
 string 否

由OBS創(chuàng)建來(lái)唯一確定本次請(qǐng)求的值,可以通過(guò)該值來(lái)定位問(wèn)題。
返回碼: 400

請(qǐng)求失敗響應(yīng)消息。

名稱 類型 必選 描述
Code
 
 string 否

錯(cuò)誤響應(yīng)消息體XML中錯(cuò)誤響應(yīng)對(duì)應(yīng)的HTTP消息返回碼,具體的錯(cuò)誤碼請(qǐng)參見(jiàn)錯(cuò)誤碼-表2。
Message
 
 string 否

錯(cuò)誤響應(yīng)消息體XML中具體錯(cuò)誤更全面、詳細(xì)的英文解釋,具體的錯(cuò)誤消息請(qǐng)參見(jiàn)錯(cuò)誤碼-表2。
RequestId
 
 string 否

本次錯(cuò)誤請(qǐng)求的請(qǐng)求ID,用于錯(cuò)誤定位。
HostId
 
 string 否

返回該消息的服務(wù)端ID。
Resource
 
 string 否

該錯(cuò)誤相關(guān)的桶或?qū)ο筚Y源。
請(qǐng)求示例
示例 1

在指定location上創(chuàng)建桶名為bucketname的3az桶。

 
"PUT / HTTP/1.1 "
 
"PUT / HTTP/1.1 \nHost: bucketname.obs.cn-north-4.myhuaweicloud.com \nContent-Length: length\nDate: date\nAuthorization: authorization\nx-obs-az-redundancy:3az\n<CreateBucketConfiguration xmlns=\"http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/\"> \n <Location>cn-north-4</Location> \n</CreateBucketConfiguration>"
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說(shuō)明。

 

創(chuàng)建桶CreateBucket

意見(jiàn)反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會(huì)繼續(xù)努力做到更好 反饋提交失敗！請(qǐng)稍后重試！