抓取Object并存储到Bucket中
所有文档

          对象存储 BOS

          抓取Object并存储到Bucket中

          接口说明

          此接口用于从指定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"
            } ]
          }

          错误码

          请参考通用错误码

          上一篇
          取回归档文件
          下一篇
          删除Object