您可以通过 copy_object 接口，在同一地域的存储桶之间拷贝对象，也可以在同一个存储桶内拷贝对象。拷贝不支持跨地域的拷贝，并且要求对原对象拥有读权限。
对象小于 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。