putobject -奇异果体育app竞彩官网下载

接口描述

此接口用于向指定的bucket上传一个文件，请求者必须具有write权限。在putobject前需要确保对应的bucket已经存在，bos支持object文件的长度范围是0byte-5gb。如果需要上传大于5gb的文件，请参考。

请求（request）

• 请求语法

put / http/1.1
host: .bj.bcebos.com
date: 
authorization: 
content-type: text/plain
content-length: 
x-bce-storage-class:  

• 请求参数

  无特殊参数

• 请求头域

  名称	类型	描述	是否必需
  cache-control	string	下载object的cache设置，常见的可取值为private、no-cache、max-age、must-revalidate	否
  content-disposition	string	设置浏览器是否下载，可取值为inline、attachment; filename="download.txt"	否
  content-md5	string	rfc2616定义的http请求内容的md5摘要，可以通过携带该字段来验证保存在bos侧的文件和用户预期的文件是否一致。	否
  expires	string	用于设置下载object时的缓存失效时间，如果不做时间设置，bos则会默认设置缓存失效时间为三天。	否
  x-bce-meta-*	string	用户自定义的meta	否
  x-bce-content-sha256	string	通过携带该字段来验证保存在bos侧的文件和用户预期的文件是否一致，sha256的校验准确性更高。所传数据的sha256值必须与此匹配，否则putobject失败	否
  x-bce-content-crc32	string	上传object的crc值(循环冗余校验码)。	否
  x-bce-storage-class	string	指定object的存储类型，standard_ia代表低频存储，cold代表冷存储，archive代表归档存储，不指定时默认是standard标准存储类型；如果是多az类型bucket，maz_standard_ia代表多az低频存储，不指定时默认是maz_standard多az标准存储类型，不能是其它取值	否
  x-bce-acl	string	cannedacl支持的header，用户设置object的权限，取值为private和public-read。	否
  x-bce-grant-read	string	cannedacl支持的header，用户设置object的读权限。支持多个id，以逗号分隔	否
  x-bce-grant-full-control	string	cannedacl支持的header，用户设置object的full_control权限。支持多个id，以逗号分隔	否
  x-bce-server-side-encryption	string	服务端加密算法，当前支持aes256和sm4加密。	否

响应（response）

• 响应头域

  名称	类型	描述
  etag	string	object的http协议实体标签

注意事项

1. content-length是必须参数，如果请求者指定的content-length比实际请求体（object的实际数据）长度小，bos只保存content-length指定长度的数据，多的这部分数据直接废弃；相反，如果content-length的长度大，bos将一直等待请求者上传数据，直到超时。
2. 上传的object，如不指定content-type，bos会自动识别设置合适的content-type，若无法识别则默认为application/octet-stream
3. bos目前不支持version，如果请求者重复put一个object，之前上传的数据将被覆盖。
4. 由于bos本身是一个(,)的存储系统，所以原则上并不会存在“文件夹”的概念。若需要按照文件夹来划分，可以把 “/” 符号作为分隔符模拟文件夹。例如上传object为 “work/test/123.txt”，控制台显示时会根据“/”自动切分，创建work文件夹下面的test文件夹和test文件夹下的123.txt文件。

• 响应参数

  无

示例

• 请求示例

put /objectname http/1.1
host: bucketname.bj.bcebos.com
date: wed, 06 apr 2016 06:34:40 gmt
authorization: authorizationstring
content-type: text/plain
content-length: 11434
x-bce-storage-class: standard_ia 
[11434 bytes of object data]

• 响应示例

http/1.1 200 ok
x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
date: wed, 06 apr 2016 06:34:40 gmt
etag: "1b2cf535f27731c974343645a3985328"
content-length: 0
connection: close
server: bcebos