抓取Object并存储到Bucket中
更新时间：2022-01-10
接口说明
此接口用于从指定URL抓取资源，并将资源存储到指定的Bucket中。此操作需要请求者对该Bucket有写权限，每次只能抓取一个Object，且用户可以自定义Object的名称。
说明：
- FetchObject接口抓取资源的大小限制为0~10GB。
请求URI
POST /v1/{bucketName}/{objectKey}?fetch
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 | 参数位置 |
|---|---|---|---|---|---|
| bucketName | String | 是 | bucket的名称 | "bucketName_example" | Path |
| objectKey | String | 是 | object的名称 | "objectKey_example" | Path |
请求头参数
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| xBceFetchSource | String | 是 | 抓取文件的源地址，如http://www.abc.com/img.jpg。该参数可以放到querystring里，当放到querystring时需要做UrlEncode。 | "xBceFetchSource_example" |
| xBceFetchMode | String | 否 | 抓取模式，支持异步抓取async和同步抓取sync两种模式。其中异步模式下BOS收到抓取任务后立刻返回成功，同步模式下BOS需要等到抓取Object完成后才会返回成功。对于数据量小或关注抓取结果实时性的建议使用同步模式，异步模式不需要等待，适用不需要实时查看抓取结果的场景，可以后续再对抓取结果进行查询。默认值为sync。 该参数可以放到querystring里。 | "xBceFetchMode_example" |
| xBceStorageClass | String | 否 | 存储类型，支持标准存储STANDARD、低频存储STANDARD_IA、冷存储COLD和归档存储ARCHIVE。默认存储为STANDARD。 该参数可以放到querystring里。 | "xBceStorageClass_example" |
| xBceServerSideEncryption | String | 否 | 服务端加密算法，当前仅支持AES256。 | "xBceServerSideEncryption_example" |
请求体参数
请求体字段数据结构说明
响应体参数
响应体字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| errors | List<Errors> | 抓取过程中出错的Object信息的容器，里面包含一个或多个Object元素。 |
Errors字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| key | String | 抓取出错的Object名称。 | my-object2 |
| code | String | 错误代码。 | InvalidArgument |
| message | String | 错误信息。 | Invalid Argument. |
请求示例
POST /v1/bucketName_example/objectKey_example?fetch
<公共请求头>
x-bce-fetch-source: xBceFetchSource_example
x-bce-fetch-mode: xBceFetchMode_example
x-bce-storage-class: xBceStorageClass_example
x-bce-server-side-encryption: xBceServerSideEncryption_example
{ }响应示例
HTTP/1.1 200 OK
<公共响应头>
{
"errors" : [ {
"code" : "InvalidArgument",
"message" : "Invalid Argument.",
"key" : "my-object2"
}, {
"code" : "InvalidArgument",
"message" : "Invalid Argument.",
"key" : "my-object2"
} ]
}错误码
请参考通用错误码