全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

快速入门(Python)

最近更新时间:2023-06-08 15:00:42

用户常用操作,创建存储空间,下载文件,上传文件等。

创建存储空间

在建立了连接后,可以创建一个 Bucket。Bucket 在 ks3 中是一个用于储存 key/value 的容器。用户可以将所有的数据存储在一个 Bucket 里,也可以为不同种类数据创建相应的 Bucket。
以下代码用于创建存储空间:

from ks3.connection import Connection

# 金山云主账号 AccessKey 拥有所有API的访问权限,风险很高。
# 强烈建议您创建并使用子账号进行 API 访问或日常运维,请登录 https://uc.console.ksyun.com/pro/iam/#/user/list 创建子账号。
# 通过指定 host(Endpoint),您可以在指定的地域创建新的存储空间。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='YOUR_REGION_ENDPOINT')

# 这里如果出现409 conflict错误,说明请求的bucket name有冲突,因为bucket name是全局唯一的。
# 默认创建私有访问权限的存储空间。
b = c.create_bucket('<YOUR_BUCKET_NAME>')

# 如果需要在创建存储空间时设置存储空间访问权限,请参考以下代码。
# 以下以配置存储空间为私有访问权限。
b = c.create_bucket('<YOUR_BUCKET_NAME>', policy='private')

列举存储空间

以下代码用于列举存储空间:

from ks3.connection import Connection

# 金山云主账号 AccessKey 拥有所有API的访问权限,风险很高。
# 强烈建议您创建并使用子账号进行 API 访问或日常运维,请登录 https://uc.console.ksyun.com/pro/iam/#/user/list 创建子账号。
# 通过指定 host(Endpoint),您可以在指定的地域创建新的存储空间。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='YOUR_REGION_ENDPOINT')

#获取客户所有的bucket信息。
buckets = c.get_all_buckets()

#打印出bucket的名称。
for b in buckets:
	print(b.name)

下载文件

以下代码用于下载文件到本地:

from ks3.connection import Connection

# 金山云主账号 AccessKey 拥有所有API的访问权限,风险很高。
# 强烈建议您创建并使用子账号进行 API 访问或日常运维,请登录 https://uc.console.ksyun.com/pro/iam/#/user/list 创建子账号。
# 通过指定 host(Endpoint),您可以在指定的地域创建新的存储空间。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='YOUR_REGION_ENDPOINT')

# 获取文件名称。
key_name = "YOUR_KEY_NAME"

# 获取存储空间实例。
b = c.get_bucket('<YOUR_BUCKET_NAME>')

# 获取文件实例。
# 填写Object完整路径。Object完整路径中不能包含Bucket名称。
k = b.get_key(key_name)

#下载object,并保存到该文件路径中。
k.get_contents_to_filename("<SAVED_FILE_PATH>")

上传文件

以下代码用于上传文件到KS3:

from ks3.connection import Connection

# 金山云主账号 AccessKey 拥有所有API的访问权限,风险很高。
# 强烈建议您创建并使用子账号进行 API 访问或日常运维,请登录 https://uc.console.ksyun.com/pro/iam/#/user/list 创建子账号。
# 通过指定 host(Endpoint),您可以在指定的地域创建新的存储空间。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='YOUR_REGION_ENDPOINT')

# 获取存储空间实例。
b = c.get_bucket("<YOUR_BUCKET_NAME>")

# 创建文件。
# 填写Object完整路径。Object完整路径中不能包含Bucket名称。
k = b.new_key("<YOUR_KEY_NAME>")

# 将指定目录下的某一文件上传。
# 填写本地文件的完整路径。
ret=k.set_contents_from_filename("<YOUR_SOURCE_FILE_PATH>")

# HTTP返回码。
if ret and ret.status == 200:
    print("上传成功")

删除文件

以下代码用于删除指定文件:

from ks3.connection import Connection

# 金山云主账号 AccessKey 拥有所有API的访问权限,风险很高。
# 强烈建议您创建并使用子账号进行 API 访问或日常运维,请登录 https://uc.console.ksyun.com/pro/iam/#/user/list 创建子账号。
# 通过指定 host(Endpoint),您可以在指定的地域创建新的存储空间。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='YOUR_REGION_ENDPOINT')

# 获取存储空间实例。
b=c.get_bucket("<YOUR_BUCKET_NAME>")

# 删除文件。<YOUR_KEY_NAME>表示删除KS3文件时需要指定包含文件后缀在内的完整路径。如 images/test.jpg。
# 暂不支持删除文件夹。
b.delete_key("<YOUR_KEY_NAME>")

列举文件

以下代码用于列举指定存储空间下的文件:

from ks3.connection import Connection
from ks3.prefix import Prefix
from ks3.key import Key

# 金山云主账号 AccessKey 拥有所有API的访问权限,风险很高。
# 强烈建议您创建并使用子账号进行 API 访问或日常运维,请登录 https://uc.console.ksyun.com/pro/iam/#/user/list 创建子账号。
# 通过指定 host(Endpoint),您可以在指定的地域创建新的存储空间。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='YOUR_REGION_ENDPOINT')

#获取存储空间实例。
b = c.get_bucket("<YOUR_BUCKET_NAME>")

#列举文件信息并打印。
keys = b.list()
for k in keys:
  print('object:', k)
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈