Object 操作
Delete Multiple Objects
描述
该操作可以通过单个 HTTP 请求删除多个 Object，最多包含 1000 个 Object，如果未找到请求中指定的 Object，OSS 将会返回为已删除。批量删除支持两种响应方式，分别为 verbose 方式、quiet 方式。默认为 verbose 方式，该响应包含所有 Object 的删除结果；如果指定 quiet 模式，则响应仅包含发生错误的 Object。
请求
语法
请求参数
无请求参数
请求 Header
| 名称 | 描述 | 必须 |
|---|---|---|
| Content-MD5 | 对 128 位 MD5 进行 base64 编码。该 Header 用来确定请求实体在传输中 |
没有损坏。 Type: String Default: None | 是 | | Content-Length | 实体长度 Type: String Default: None | 是 |
请求元素
| 名称 | 描述 | 必须 |
|---|---|---|
| Delete | 请求集合。Ancestor: NoneType: Container 一个或多个 Object 元素和可选的 Quiet 元素。 | 是 |
| Quiet | 开启 quiet 模式，当添加此元素时，必须指定该值为 true。Ancestor: DeleteType: BooleanDefault: false | 否 |
| Object | 删除请求中指定 Object 的集合。Ancestor: DeleteType: ContainerChildren: Key | 是 |
| Key | object 名称 Ancestor: ObjectType: String | 是 |
响应
请求 Header
无请求 Header
请求元素
| 名称 | 描述 |
|---|---|
| DeleteResult | 响应集合 Children: Deleted, ErrorType: ContainerAncestor: None |
| Deleted | 已成功删除的元素集合。Children: KeyType: ContainerAncestor: DeleteResult |
| Key | 执行删除操作的 Object 名称。Type: StringAncestor: Deleted, or Error |
| Error | 错误信息集合。Children: Key, Code, Message.Type: StringAncestor: DeleteResult |
| Code | 删除失败返回的状态码。Type: StringValues: AccessDenied, InternalErrorAncestor: Error |
| Message | 错误描述 Type: StringAncestor: Error |
示例
请求示例
响应示例
Delete Object
描述
该操作可以删除 Object，需有该 Object 的 DELETE 权限。
请求
语法
请求参数
无请求参数
请求 Header
无特殊请求 Header
请求元素
无特殊元素
响应
响应 Header
无特殊响应 Header
响应元素
无响应元素
示例
请求示例
响应示例
Get Object
描述
该操作可以从 OSS 中取回 Object,您必须对该 Object 有 READ 权限。如果该 Object 权限为公有读，则可在不进行签名认证的情况下取回 Object。注：支持通过 x-amz-customize-back-source-url、x-amz-customize-back-source-param 头指定数据拉取，指定后下载该对象时，将会拉取请求头提供的 URL 数据，并返回给用户。
请求
语法
请求参数
无请求参数
请求 Header
除了共用的请求 Header 之外，该操作的实现还可以使用以下请求头，请求 Header 大小不超过 8KB。
| 名称 | 描述 | 必须 |
|---|---|---|
| Range | 指定字节范围下载 ObjectType: StringDefault: NoneConstraints: None | 否 |
| If-Modified-Since | 若 Object 在指定时间后修改，则返回该 Object，否则返回 304（not modified）Type: StringDefault: NoneConstraints: None | 否 |
| If-Unmodified-Since | 若 Object 在指定时间后未修改，则返回该 Object，否则返回 412（precondition failed）。Type: StringDefault: NoneConstraints: None | 否 |
| If-Match | 如果 ETag 与指定的相同，则返回该 Object，否则返回 412（precondition failed）。Type: StringDefault: NoneConstraints: None | 否 |
| x-amz-customize-back-source-url | 回源地址，支持如http://www.example.com:1000/path格式。Type：StringDefault：None | 否 |
| x-amz-customize-back-source-param | base64 编码的 json 字符串。参数同镜像回源设置。Type：StringDefault：None | 否 |
请求元素
| 名称 | 描述 | 必须 |
|---|---|---|
| Delete | 请求集合。Ancestor: NoneType: Container 一个或多个 Object 元素和可选的 Quiet 元素。 | 是 |
| Quiet | 开启 quiet 模式，当添加此元素时，必须指定该值为 true。Ancestor: DeleteType: BooleanDefault: false | 否 |
| Object | 删除请求中指定 Object 的集合。Ancestor: DeleteType: ContainerChildren: Key | 是 |
| Key | object 名称 Ancestor: ObjectType: String | 是 |
响应
请求 Header
无请求 Header
请求元素
| 名称 | 描述 |
|---|---|
| DeleteResult | 响应集合 Children: Deleted, ErrorType: ContainerAncestor: None |
| Deleted | 已成功删除的元素集合。Children: KeyType: ContainerAncestor: DeleteResult |
| Key | 执行删除操作的 Object 名称。Type: StringAncestor: Deleted, or Error |
| Error | 错误信息集合。Children: Key, Code, Message.Type: StringAncestor: DeleteResult |
| Code | 删除失败返回的状态码。Type: StringValues: AccessDenied, InternalErrorAncestor: Error |
| Message | 错误描述 Type: StringAncestor: Error |
注意： 如果 If-Match 与 If-Unmodified-Since 同时在请求中，若 If-Match 为 ture，If-Unmodified-Since 为 false，OSS 将会返回 200 OK 如果 If-None-Match 与 If-Modified-Since 同时在请求中，若 If-None-Match 为 false，If-Modified-Since 为 true，OSS 将会返回 403 Not Modified
响应
响应 Header
| 名称 | 描述 |
|---|---|
| x-amz-storage-class | 提供 Object 的存储类型信息。非标准存储情况下，OSS 将会返回该 Header |
| x-amz-restore | 该对象的还原信息及副本生命周期 |
响应元素
无响应元素
示例
请求示例
返回示例
Head Object
描述
该操作将返回 Object 的元数据，需有 Object 的 READ 权限。
请求
语法
请求参数
无请求参数
请求 Header
除了共用的请求 Header 之外，该操作的实现还可以使用以下请求头，请求 Header 大小不超过 8KB。
| 名称 | 描述 | 必须 |
|---|---|---|
| Range | 指定字节范围下载 ObjectType: StringDefault: NoneConstraints: None | 否 |
| If-Modified-Since | 若 Object 在指定时间后修改，则返回该 Object，否则返回 304（not modified）Type: StringDefault: NoneConstraints: None | 否 |
| If-Unmodified-Since | 若 Object 在指定时间后未修改，则返回该 Object，否则返回 412（precondition failed）。Type: StringDefault: NoneConstraints: None | 否 |
| If-Match | 如果 ETag 与指定的相同，则返回该 Object，否则返回 412（precondition failed）。Type: StringDefault: NoneConstraints: None | 否 |
| IF-None-Match | 如果 ETag 与指定的不同，则返回该 Object，否则返回 304（not modified）。Type: StringDefault: NoneConstraints: None | 否 |
注意： 如果 If-Match 与 If-Unmodified-Since 同时在请求中，若 If-Match 为 ture，If-Unmodified-Since 为 false，OSS 将会返回 200 OK 如果 If-None-Match 与 If-Modified-Since 同时在请求中，若 If-None-Match 为 false，If-Modified-Since 为 true，OSS 将会返回 403 Not Modified
请求元素
无请求元素
响应
响应 Header
| 名称 | 描述 |
|---|---|
| x-amz-storage-class | 提供 Object 的存储类型信息。非标准存储情况下，OSS 将会返回该 Header |
| x-amz-restore | 该对象的还原信息及副本生命周期 |
响应元素
无响应元素
示例
请求示例
响应示例
Put Object
描述
该操作可将一个 object 上传到 bucket 中，要求操作者有 bucket 的 WRITE 权限。您可以使用 Content-MD5 来确保数据完整性，OSS 将根据提供的 MD5 校验 Object，若不匹配，则返回错误。另外，您也可以在上传 object 计算 MD5，并与返回的 ETag 进行比对。
请求
语法
请求参数
无请求参数
请求 Header
除了共用的请求 Header 之外，该操作的实现还可以使用以下请求头，请求 Header 大小不超过 8KB。
| 名称 | 描述 | 必须 |
|---|---|---|
| Cache-Control | 指定该 Object 被下载时的网页的缓存行为；更详细描述请参照 RFC2616。Type: StringDefault: NoneConstraints: None | 否 |
| Content-Disposition | 指定返回的 Object 该以何种形式展示,长度限制为 100 个字节；更详细描述请参照 RFC2616。 | 否 |
| Content-Encoding | 它的值表示消息主体进行了何种方式的内容编码转换，用来告知客户端应该怎样解码才能获取在 Content-Type 中标示的媒体类型内容；更详细描述请访问 RFC2616。Type: StringDefault: NoneConstraints: None | 否 |
| Content-Length | Object 的大小，单位为 byte；更详细描述请参照 RFC2616。Type: StringDefault: NoneConstraints: None | 是 |
| Content-MD5 | 对报文主体进行 MD5 算法获得 128 位二进制数，再通过 Base64 编码写入 Content-MD5。可用于数据完整性检查。Type: StringDefault: NoneConstraints: None | 否 |
| Content-Type | 表示请求中的 MIME 类型。Type: StringDefault: binary/octet-streamValid Values: MIME typesConstraints: None | 否 |
| Expect | 客户端使用 Expect 告知 OSS，期望出现某种特定的行为。若 OSS 无法做出回应而发生错误时，请求报文主体将不会发送。Type: StringDefault: NoneValid Values: 100-continueConstraints: None | 否 |
| Expires | Object 缓存过期时间。Type: StringDefault: NoneConstraints: None | 否 |
| x-amz-storage-class | Object 存储类型，如果未指定，默认为标准存储。Type: EnumDefault: STANDARDValid Values: STANDARD、 GLACIER、REDUCED_REDUNDANCY、STANDARD_IA | 否 |
| x-amz-tagging | 设置对象标签。如"Key1=Value1"Type: StringDefault: NoneConstraints:标签键和标签值需分别做 urlencode。该标签头大小不能超过 2K。标签个数不能超过 10 个。 | 否 |
| x-amz-meta-* | 以 x-amz-meta- 前缀开头的 Header 为用户自定义 Header。】自定义 Header 的大小（包括 key、value）UTF-8 编码下不能超过 2K。 | 否 |
响应
响应 Header
无特殊 Header
响应元素
无响应元素
示例
请求示例
响应示例
