文档中心 > PostObject
PostObject

最近更新时间:2021-12-24

使用PostObject接口为指定Bucket添加Object。

POST操作采用HTML格式为指定Bucket添加Object。


请求

请求语法

POST / HTTP/1.1

Host: examplebucket.region.unicloudsrv.com

User-Agent: browser_data

Accept: file_types

Accept-Language: Regions

Accept-Encoding: encoding

Accept-Charset: character_set

Keep-Alive: 300

Connection: keep-alive

Content-Type: multipart/form-data; boundary=9431149156168

Content-Length: length

 

--9431149156168

Content-Disposition: form-data; name="key"

 

 

acl

--9431149156168

Content-Disposition: form-data; name="success_action_redirect"

 

success_redirect

--9431149156168

Content-Disposition: form-data; name="Content-Type"

 

content_type

--9431149156168

Content-Disposition: form-data; name="x-amz-meta-uuid"

 

uuid

--9431149156168

Content-Disposition: form-data; name="x-amz-meta-tag"

 

metadata

--9431149156168

Content-Disposition: form-data; name="AWSAccessKeyId"

 

access-key-id

--9431149156168

Content-Disposition: form-data; name="Policy"

 

encoded_policy

--9431149156168

Content-Disposition: form-data; name="Signature"

 

signature=

--9431149156168

Content-Disposition: form-data; name="file"; filename="MyFilename.jpg"

Content-Type: image/jpeg

 

file_content

--9431149156168

Content-Disposition: form-data; name="submit"

 

Upload to los

--9431149156168--

请求参数

参数

描述

AWSAccessKeyId

bucket拥有者的Unicloud访问ID,该拥有者授权匿名用户一个符合很多约束的请求的访问权限。

acl

访问控制列表。

Cache-Control,Content-Type,Content-Disposition,Content-Encoding,Expires

其他特定的头。

file

文件或文本内容。

key

上传key的名字。

policy

请求中允许的安全策略。

success_action_redirect,redirect

客户端在成功上传被重定向的网址。

success_action_status

如果没有指定success_action_redirect,   成功上传后返回给客户端的状态码。

x-amz-storage-class

用于存储对象的存储类。

x-amz-meta-

从这个前缀开始的标题是用户定义的元数据。

x-amz-security-token

安全令牌。

x-amz-website-redirect-location

如果bucket被设置为一个网站,重定向这个Object到相同bucket中的另一个Object或者一个额外的ULR链接。


响应

响应消息头

参数

描述

x-amz-expiration

如果Object的Expiration作为bucket的生命周期中的一部分被设置,该头被返回。

success_action_redirect, redirect

客户端成功上传重定向到该URL上。

x-amz-server-side-encryption

POST请求中如果服务端使用了Unicloud KMS加密或者Unicloud托管加密,响应中包括该头。

x-amz-server-side-encryption-aws-kms-key-id

如果x-amz-server-side-encryption存在并且赋值为aws:kms,该头标识为Object所使用的KMS主密钥。

x-amz-server-side-encryption-customer-algorithm

如果服务端采用了SSE-C加密请求,响应中就会包括该头来确认使用了该加密算法。

x-amz-server-side-encryption-customer-key-MD5

如果SSE-C加密被请求,响应中的该头提供往返消息完整性验证的客户提供加密密钥。

x-amz-version-id

Object的版本ID。

响应元素

参数

描述

Bucket

Object所在的bucket。

ETag

实体标签对象的MD5哈希。

Key

Object的key名称。

Location

Object的URI。