创建存储空间

使用说明

  • 在上传文件(Object)到 US3 之前,您需要使用 createbucket来创建一个用于存储文件的存储空间(Bucket),存储空间具有各种配置属性,包括地域、访问权限以及其他元数据。

函数说明

createbucket(bucket, region, buckettype='private', domainlist=None, header=None, projectid=None)

​ 创建新的空间

Parameters

  • bucket – string类型,空间名称 ,具有全局唯一性。命名规范参见Bucket创建
  • region – string类型,bucket 所在的地理区域,详细信息见地域和域名
含义
cn-bj 北京
hk 香港
cn-gd 广州
cn-sh2 上海二
us-ca 洛杉矶(暂时不能使用)
sg 新加坡
dn-jakarta 雅加达
afr-nigeria 拉各斯
bra-saopaulo 圣保罗
uae-dubai 迪拜
vn-sng 胡志明市
tw-tp 台北
ind-mumbai 孟买
us-ws 华盛顿(暂时不能使用)
ge-fra 法兰克福
kr-seoul 首尔
  • buckettype: string类型,'private' 或者 'public'

  • domainlist: list 类型, 要绑定的域名列表

  • header: dict类型,http 请求header,键值对类型分别为string,比如{'User-Agent': 'Google Chrome'}

  • projectid: string类型,项目ID。不填写为默认项目,若要创建在子帐号下则必须填写。 请参考GetProjectList接口

Returns

  • ret: 如果http状态码为[200, 204, 206]之一则返回None,否则如果服务器返回json信息则返回dict类型,键值对类型分别为string, unicode string类型,否则返回空的dict
  • ResponseInfo: 响应的具体信息,UCloud UFile 服务器返回信息或者网络链接异常

代码示例

1
2
3
4
5
6
7
8
9
10
11
12
13
public_key = ''         #账户公钥
private_key = ''        #账户私钥


from ufile import bucketmanager

bucketmanager_handler = bucketmanager.BucketManager(public_key, private_key)

# 创建新的bucket
bucketname = '' #创建的空间名称
region = 'cn-bj'#空间所在的地理区域
ret, resp = bucketmanager_handler.createbucket(bucketname, region,'public')
print(ret)