对象元信息是对象的属性描述，包括 HTTP 标准属性（HTTP Header）和用户自定义元数据（User Meta）两种。

设置自定义元数据 #

示例代码 #

您可以设置对象元信息，用于标识对象的用途或属性，以下代码用于设置对象的元数据。

import os
import tos

# 从环境变量获取 AK 和 SK 信息。
ak = os.getenv('TOS_ACCESS_KEY')
sk = os.getenv('TOS_SECRET_KEY')
endpoint = "your endpoint"
region = "your region"
bucket_name = 'bucket-test'
# 对象名称，例如 example_dir 下的 example_object.txt 文件，则填写为 example_dir/example_object.txt
object_key = 'object-key'
try:
    # 创建 TosClientV2 对象，对桶和对象的操作都通过 TosClientV2 实现
    client = tos.TosClientV2(ak, sk, endpoint, region)

    # 普通上传时设置对象元数据
    client.put_object(bucket_name, object_key,
                      # 通过meta选填字段设置用户自定义元数据
                      meta={'author': 'test1', '姓名': '张三'},
                      # 通过content_disposition设置HTTP标准属性
                      content_disposition='attachment; filename=123.txt',
                      # 通过content_type设置对象类型
                      content_type="text/plain")
    # 分片上传时设置对象元数据
    client.create_multipart_upload(bucket_name, object_key,
                                   # 通过meta选填字段设置用户自定义元数据
                                   meta={'author': 'test2', '姓名': '张三'},
                                   # 通过content_disposition设置HTTP标准属性
                                   content_disposition='attachment; filename=123.txt',
                                   # 通过content_type设置对象类型
                                   content_type="text/plain")
    # 通过set_object_meta接口设置对象元数据
    client.set_object_meta(bucket_name, object_key, meta={'author': 'test3', '姓名': '张三'},
                           # 通过content_disposition设置HTTP标准属性
                           content_disposition='attachment; filename=123.txt',
                           # 通过content_type设置对象类型
                           content_type="text/plain")
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 文档，请参见 SetObjectMeta。

获取对象元数据 #

示例代码 #

可以通过 head_object 获取对象元信息，以下代码用于获取对象的元数据。

import os
import tos

# 从环境变量获取 AK 和 SK 信息。
ak = os.getenv('TOS_ACCESS_KEY')
sk = os.getenv('TOS_SECRET_KEY')
endpoint = "your endpoint"
region = "your region"
bucket_name = 'bucket-test'
# 对象名称，例如 example_dir 下的 example_object.txt 文件，则填写为 example_dir/example_object.txt
object_key = 'object-key'
try:
    # 创建 TosClientV2 对象，对桶和对象的操作都通过 TosClientV2 实现
    client = tos.TosClientV2(ak, sk, endpoint, region)
    # 获取对象元数据
    result = client.head_object(bucket_name, object_key)
    for key, value in result.meta.items():
        print('meta key', key)
        print('meta value', value)
    print('content-disposition', result.content_disposition)
    print('content-type', result.content_type)
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 文档，请参见 HeadObject。