设置对象属性

设置对象属性

更新时间： 2019-03-14 10:05

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

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

名称	描述	默认值
对象长度（Content-Length）	上传对象的长度，超过流/文件的长度会截断。	流/文件实际长度
对象MIME类型（Content-Type）	对象的MIME类型，定义对象的类型及网页编码，决定浏览器将以什么形式、什么编码读取对象。	binary/octet-stream
对象MD5值（Content-MD5）	对象数据的MD5值（经过Base64编码），提供给OBS服务端，校验数据完整性。	无
对象存储类型	对象的存储类型，不同的存储类型可以满足客户业务对存储性能、成本的不同诉求。默认与桶的存储类型保持一致，可以设置为与桶的存储类型不同。	无
对象自定义元数据	用户对上传到桶中对象的自定义属性描述，以便对对象进行自定义管理。	无

设置对象长度

您可以通过PutObjectInput.ContentLength或者PutFileInput.ContentLength来设置对象长度。以下代码展示如何设置对象长度：

// 引入依赖包
import (
       "fmt"
       "obs"
)
 
var ak = "*** Provide your Access Key ***"
var sk = "*** Provide your Secret Key ***"
var endpoint = "https://your-endpoint"
 
// 创建ObsClient结构体
var obsClient, _ = obs.New(ak, sk, endpoint)
 
func main() {
       input := &obs.PutFileInput{}
       input.Bucket = "bucketname"
       input.Key = "objectkey"
       input.SourceFile = "localfile"
       // 只上传100个字节
       input.ContentLength = 100
       output, err := obsClient.PutFile(input)
       if err == nil {
              fmt.Printf("RequestId:%s\n", output.RequestId)
       } else if obsError, ok := err.(obs.ObsError); ok {
              fmt.Printf("Code:%s\n", obsError.Code)
              fmt.Printf("Message:%s\n", obsError.Message)
       }
}

设置对象MIME类型

您可以通过PutObjectInput.ContentType或者PutFileInput.ContentType来设置对象MIME类型。以下代码展示如何设置对象MIME类型：

// 引入依赖包
import (
       "fmt"
       "obs"
)
 
var ak = "*** Provide your Access Key ***"
var sk = "*** Provide your Secret Key ***"
var endpoint = "https://your-endpoint"
 
// 创建ObsClient结构体
var obsClient, _ = obs.New(ak, sk, endpoint)
 
func main() {
       input := &obs.PutFileInput{}
       input.Bucket = "bucketname"
       input.Key = "objectkey"
       input.SourceFile = "localimage.jpg"
       // 上传图片
       input.ContentType = "image/jpeg"
       output, err := obsClient.PutFile(input)
       if err == nil {
              fmt.Printf("RequestId:%s\n", output.RequestId)
       } else if obsError, ok := err.(obs.ObsError); ok {
              fmt.Printf("Code:%s\n", obsError.Code)
              fmt.Printf("Message:%s\n", obsError.Message)
       }
}

说明：

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

设置对象MD5值

您可以通过PutObjectInput.ContentMD5或者PutFileInput.ContentMD5来设置对象MD5值。以下代码展示如何设置对象MD5值：

// 引入依赖包
import (
       "fmt"
       "obs"
)
 
var ak = "*** Provide your Access Key ***"
var sk = "*** Provide your Secret Key ***"
var endpoint = "https://your-endpoint"
 
// 创建ObsClient结构体
var obsClient, _ = obs.New(ak, sk, endpoint)
 
func main() {
       input := &obs.PutFileInput{}
       input.Bucket = "bucketname"
       input.Key = "objectkey"
       input.SourceFile = "localfile"
       // 设置MD5值
       input.ContentMD5 = "your md5 which should be encoded by base64"
       output, err := obsClient.PutFile(input)
       if err == nil {
              fmt.Printf("RequestId:%s\n", output.RequestId)
       } else if obsError, ok := err.(obs.ObsError); ok {
              fmt.Printf("Code:%s\n", obsError.Code)
              fmt.Printf("Message:%s\n", obsError.Message)
       }
}

说明：

对象数据的MD5值必须经过Base64编码。
OBS服务端会将该MD5值与对象数据计算出的MD5值进行对比，如果不匹配则上传失败，返回HTTP 400错误。
如果不设置对象的MD5值，OBS服务端会忽略对对象数据的MD5值校验。

设置对象存储类型

您可以通过PutObjectInput.StorageClass或者PutFileInput.StorageClass来设置对象存储类型。以下代码展示如何设置对象存储类型：

// 引入依赖包
import (
       "fmt"
       "obs"
)
 
var ak = "*** Provide your Access Key ***"
var sk = "*** Provide your Secret Key ***"
var endpoint = "https://your-endpoint"
 
// 创建ObsClient结构体
var obsClient, _ = obs.New(ak, sk, endpoint)
 
func main() {
       input := &obs.PutFileInput{}
       input.Bucket = "bucketname"
       input.Key = "objectkey"
       input.SourceFile = "localfile"
       // 设置对象存储类型为归档存储
 
       input.StorageClass = obs.StorageClassCold
       output, err := obsClient.PutFile(input)
       if err == nil {
              fmt.Printf("RequestId:%s\n", output.RequestId)
       } else if obsError, ok := err.(obs.ObsError); ok {
              fmt.Printf("Code:%s\n", obsError.Code)
              fmt.Printf("Message:%s\n", obsError.Message)
       }
}

说明：

如果不设置，对象的存储类型默认与桶的存储类型保持一致。
对象的存储类型分为三类，其含义与桶存储类型一致。
下载归档存储类型的对象前必须将其取回。

设置对象自定义元数据

您可以通过PutObjectInput.Metadata或者PutFileInput.Metadata参数来设置对象自定义元数据。以下代码展示如何设置对象自定义元数据：

// 引入依赖包
import (
       "fmt"
       "obs"
       "strings"
)
 
var ak = "*** Provide your Access Key ***"
var sk = "*** Provide your Secret Key ***"
var endpoint = "https://your-endpoint"
 
// 创建ObsClient结构体
var obsClient, _ = obs.New(ak, sk, endpoint)
 
func main() {
       input := &obs.PutObjectInput{}
       input.Bucket = "bucketname"
       input.Key = "objectkey"
       input.Body = strings.NewReader("Hello OBS")
       input.Metadata = map[string]string{"property1": "property-value1", "property2": "property-value2"}
       output, err := obsClient.PutObject(input)
       if err == nil {
              fmt.Printf("RequestId:%s\n", output.RequestId)
       } else if obsError, ok := err.(obs.ObsError); ok {
              fmt.Printf("Code:%s\n", obsError.Code)
              fmt.Printf("Message:%s\n", obsError.Message)
       }
}

说明：

在上面设置对象自定义元数据示例代码中，用户自定义了一个名称为“property1”，值为“property-value1”的元数据和一个名称为“property2”，值为“property-value2”的元数据。
一个对象可以有多个元数据，总大小不能超过8KB。
对象的自定义元数据可以通过ObsClient.GetObjectMetadata获取，参见获取对象元数据。
使用ObsClient.GetObject下载对象时，对象的自定义元数据也会同时下载。

父主题：上传对象