You need to enable JavaScript to run this app.
导航
普通拷贝(Python SDK)
最近更新时间:2024.09.27 14:38:29首次发布时间:2021.12.31 17:38:36

您可以通过 copy_object 接口,在同一地域的存储桶之间拷贝对象,也可以在同一个存储桶内拷贝对象。拷贝不支持跨地域的拷贝,并且要求对原对象拥有读权限。

注意事项

  • 拷贝文件不支持跨区域的桶间拷贝。
  • 拷贝对象时,账号必须具备源对象的读取权限和目标桶的写入权限。
  • 拷贝对象时,可以保留所有元数据(默认值)或指定新的元数据。但 ACL 并未被保留,而是设置为私有。

示例代码

对象小于 5GiB 时,您可以使用普通拷贝。以下代码用于将 src_bucket_name 桶中 src_object_key 对象拷贝到 bucket_name 桶中,并设置对象名为 object_key

import os
import tos
from tos import MetadataDirectiveType

# 从环境变量获取 AK 和 SK 信息。
ak = os.getenv('TOS_ACCESS_KEY')
sk = os.getenv('TOS_SECRET_KEY')
# your endpoint 和 your region 填写Bucket 所在区域对应的Endpoint。# 以华北2(北京)为例,your endpoint 填写 tos-cn-beijing.volces.com,your region 填写 cn-beijing。
endpoint = "your endpoint"
region = "your region"
# 目标桶的名称
bucket_name = "bucket-test"
# 拷贝到目标桶后的新对象名称
object_key = "object-test"
# 源桶的名称
src_bucket_name = "your src bucket name"
# 源对象名称
src_object_key = "your src object key"
try:
    # 创建 TosClientV2 对象,对桶和对象的操作都通过 TosClientV2 实现
    client = tos.TosClientV2(ak, sk, endpoint, region)

    # 拷贝 src_bucket_name 桶中 src_object_key 对象到 bucket_name 桶中,并设置对象 key 为 object_key
    client.copy_object(bucket_name, object_key, src_bucket_name, src_object_key,
                       # 通过可选字段acl设置拷贝对象的acl权限
                       acl=tos.ACLType.ACL_Private,
                       # 通过可选字段设置拷贝对象的存储类型
                       storage_class=tos.StorageClassType.Storage_Class_Standard,
                       # 设置metadata_directive=MetadataDirectiveType.Metadata_Directive_Copy从元对象复制元数据
                       metadata_directive=MetadataDirectiveType.Metadata_Directive_Copy)

    # client.copy_object(bucket_name, object_key, src_bucket_name, src_object_key,
    #                  # 设置metadata_directive=MetadataDirectiveType.Metadata_Directive_Replace请求中提供的元数据替换
    #                   metadata_directive=MetadataDirectiveType.Metadata_Directive_Replace,
    #                  # 替换的对象元数据
    #                  meta={'key1': 'replaceValue'})
except tos.exceptions.TosClientError as e:
    # 操作失败,捕获客户端异常,一般情况为非法请求参数或网络异常
    print('fail with client error, message:{}, cause: {}'.format(e.message, e.cause))
except tos.exceptions.TosServerError as e:
    # 操作失败,捕获服务端异常,可从返回信息中获取详细错误信息
    print('fail with server error, code: {}'.format(e.code))
    # request id 可定位具体问题,强烈建议日志中保存
    print('error with request id: {}'.format(e.request_id))
    print('error with message: {}'.format(e.message))
    print('error with http code: {}'.format(e.status_code))
    print('error with ec: {}'.format(e.ec))
    print('error with request url: {}'.format(e.request_url))
except Exception as e:
    print('fail with unknown error: {}'.format(e))

相关文档

关于普通拷贝的 API 文档,请参见 CopyObject