九游平台/ 对象存储服务 obs/ sdk参考/ / / 设置对象属性
更新时间：2023-11-08 gmt 08:00

设置对象属性-九游平台

开发过程中，您有任何问题可以在github上，或者在中发帖求助。详细介绍了每个接口的参数和使用方法。

您可以在上传对象时设置对象属性。对象属性包含对象mime类型、对象md5值（用于校验）、对象存储类型、对象自定义元数据。对象属性可以在多种上传方式下（流式上传、文件上传、分段上传），或时进行设置。

对象属性详细说明见下表：

名称

描述

默认值

对象mime类型（content-type）

对象的mime类型，定义对象的类型及网页编码，决定浏览器将以什么形式、什么编码读取对象。

binary/octet-stream

对象md5值（content-md5）

对象数据的md5值（经过base64编码），提供给obs服务端，校验数据完整性。

无

对象存储类型

对象的存储类型，不同的存储类型可以满足客户业务对存储性能、成本的不同诉求。默认与桶的存储类型保持一致，可以设置为与桶的存储类型不同。

无

对象自定义元数据

用户对上传到桶中对象的自定义属性描述，以便对对象进行自定义管理。

无

设置对象mime类型

您可以通过putobjectrequest.contenttype来设置对象mime类型。以下代码展示如何设置对象mime类型：

// 初始化配置参数
obsconfig config = new obsconfig();
config.endpoint = "https://your-endpoint";
// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量accesskeyid和secretaccesskey。
// 您可以登录访问管理控制台获取访问密钥ak/sk，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
string accesskey= environment.getenvironmentvariable("accesskeyid", environmentvariabletarget.machine);
string secretkey= environment.getenvironmentvariable("secretaccesskey", environmentvariabletarget.machine);
// 创建obsclient实例
obsclient client = new obsclient(accesskey, secretkey, config);
// 上传文件
try
{
    putobjectrequest request = new putobjectrequest()
    {
        bucketname = "bucketname",
        objectkey = "objectname",
        filepath = "localfile",//上传的本地文件路径，需要指定到具体的文件名
        contenttype = "image/jpeg",//对象mime类型
    };
    putobjectresponse response = client.putobject(request);
    console.writeline("put object response: {0}", response.statuscode);
}
catch (obsexception ex)
{
    console.writeline("errorcode: {0}", ex.errorcode);
    console.writeline("errormessage: {0}", ex.errormessage);
}

如果未设置对象mime类型，sdk会根据上传文件或者对象的后缀名自动判断对象mime类型，如.xml判断为application/xml文件；.html判断为text/html文件。

设置对象md5值

您可以通过putobjectrequest.contentmd5来设置对象md5值。以下代码展示如何设置对象md5值：

// 初始化配置参数
obsconfig config = new obsconfig();
config.endpoint = "https://your-endpoint";
// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量accesskeyid和secretaccesskey。
// 您可以登录访问管理控制台获取访问密钥ak/sk，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
string accesskey= environment.getenvironmentvariable("accesskeyid", environmentvariabletarget.machine);
string secretkey= environment.getenvironmentvariable("secretaccesskey", environmentvariabletarget.machine);
// 创建obsclient实例
obsclient client = new obsclient(accesskey, secretkey, config);
// 上传文件
try
{
    putobjectrequest request = new putobjectrequest
    {
        bucketname = "bucketname",
        objectkey = "objectname",
        filepath = "localfile",//上传的本地文件路径，需要指定到具体的文件名
        contentmd5 = "your md5 which should be encoded by base64"
    };
    putobjectresponse response = client.putobject(request);
    console.writeline("put object response: {0}", response.statuscode);
}
catch (obsexception ex)
{
    console.writeline("errorcode: {0}", ex.errorcode);
    console.writeline("errormessage: {0}", ex.errormessage);
}
  • 对象数据的md5值必须经过base64编码。
  • obs服务端会将该md5值与对象数据计算出的md5值进行对比，如果不匹配则上传失败，返回http 400错误。
  • 如果不设置对象的md5值，obs服务端会忽略对对象数据的md5值校验。

设置对象存储类型

您可以通过putobjectrequest.storageclass来设置对象存储类型。以下代码展示如何设置对象存储类型：

// 初始化配置参数
obsconfig config = new obsconfig();
config.endpoint = "https://your-endpoint";
// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量accesskeyid和secretaccesskey。
// 您可以登录访问管理控制台获取访问密钥ak/sk，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
string accesskey= environment.getenvironmentvariable("accesskeyid", environmentvariabletarget.machine);
string secretkey= environment.getenvironmentvariable("secretaccesskey", environmentvariabletarget.machine);
// 创建obsclient实例
obsclient client = new obsclient(accesskey, secretkey, config);
// 上传文件
try
{
    putobjectrequest request = new putobjectrequest
    {
        bucketname = "bucketname",
        objectkey = "objectname",
        filepath ="localfile",//上传的本地文件路径，需要指定到具体的文件名
        storageclass = storageclassenum.warm,//对象存储类型
    };
    putobjectresponse response = client.putobject(request);
    console.writeline("put object response: {0}", response.statuscode);
}
catch (obsexception ex)
{
    console.writeline("errorcode: {0}", ex.errorcode);
    console.writeline("errormessage: {0}", ex.errormessage);
}
  • 如果未设置，对象的存储类型默认与桶的存储类型保持一致。
  • 对象的存储类型分为三类，其含义与一致。
  • 下载归档存储类型的对象前必须将其恢复。

设置对象自定义元数据

您可以通过putobjectrequest.metadata来设置对象自定义元数据。以下代码展示如何设置对象自定义元数据：

// 初始化配置参数
obsconfig config = new obsconfig();
config.endpoint = "https://your-endpoint";
// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量accesskeyid和secretaccesskey。
// 您可以登录访问管理控制台获取访问密钥ak/sk，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
string accesskey= environment.getenvironmentvariable("accesskeyid", environmentvariabletarget.machine);
string secretkey= environment.getenvironmentvariable("secretaccesskey", environmentvariabletarget.machine);
// 创建obsclient实例
obsclient client = new obsclient(accesskey, secretkey, config);
// 上传文件
try
{
    putobjectrequest request = new putobjectrequest
    {
        bucketname = "bucketname",
        objectkey = "objectname",
        filepath = "localfile",//上传的本地文件路径，需要指定到具体的文件名
    };
    request.metadata.add("meta1", "value1");
    putobjectresponse response = client.putobject(request);
    console.writeline("put object response: {0}", response.statuscode);
}
catch (obsexception ex)
{
    console.writeline("errorcode: {0}", ex.errorcode);
    console.writeline("errormessage: {0}", ex.errormessage);
}
  • 一个对象可以有多个元数据，总大小不能超过8kb。
  • 对象的自定义元数据可以通过obsclient.getobjectmetadata获取，参见获取对象元数据。
  • 使用obsclient.getobject下载对象时，对象的自定义元数据也会同时下载。
父主题：

相关文档

网站地图