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

 

接口說明

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

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

存儲類型

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

當往桶內(nèi)上傳對象時,如果沒有指定對象的存儲類別(參考PUT上傳),則該對象的存儲類型取桶的默認存儲類型。

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

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

請求消息中可帶的簽名信息。
Date
 
 string header 否

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

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

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

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

授權(quán)給指定domain下的所有用戶有WRITE權(quán)限。允許創(chuàng)建、刪除、覆蓋桶內(nèi)所有對象,允許初始化段、上傳段、拷貝段、合并段、取消多段上傳任務。
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)限,并且在默認情況下,該READ權(quán)限將傳遞給桶內(nèi)所有對象。
x-obs-grant-full-control-delivered
 
 string header 否

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

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

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

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

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

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

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

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

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

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

成功響應消息

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

響應消息體的字節(jié)長度。
Connection
 
 string 否

指明與服務器的連接是長連接還是短連接。
Date
 
 string 否

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

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

幫助定位問題的特殊符號。
x-obs-request-id
 
 string 否

由OBS創(chuàng)建來唯一確定本次請求的值,可以通過該值來定位問題。
返回碼: 400

請求失敗響應消息。

名稱 類型 必選 描述
Code
 
 string 否

錯誤響應消息體XML中錯誤響應對應的HTTP消息返回碼,具體的錯誤碼請參見錯誤碼-表2。
Message
 
 string 否

錯誤響應消息體XML中具體錯誤更全面、詳細的英文解釋,具體的錯誤消息請參見錯誤碼-表2。
RequestId
 
 string 否

本次錯誤請求的請求ID,用于錯誤定位。
HostId
 
 string 否

返回該消息的服務端ID。
Resource
 
 string 否

該錯誤相關(guān)的桶或?qū)ο筚Y源。
請求示例
示例 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>"
錯誤碼
請參考 錯誤碼說明。

 

創(chuàng)建桶CreateBucket

意見反饋

0/200

提交 取消

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