对象存储BOS

    FetchObject

    接口描述

    此接口用于从指定URL抓取资源,并将资源存储到指定的Bucket中。此操作需要请求者对该Bucket有写权限,每次只能抓取一个Object,且用户可以自定义Object的名称。

    说明:

    • FetchObject接口抓取资源的大小限制为0~10GB。

    请求(Request)

    • 请求语法

      POST /<ObjectName>?fetch HTTP/1.1
      Host: <BucketName>.bj.bcebos.com
      Content-Length: 0
      Date: <Date>
      x-bce-fetch-source: <Source>
      x-bce-fetch-mode: <FetchMode>
      x-bce-storage-class: <StorageClass>
      Authorization: AuthorizationString
    • 请求头域

      名称 类型 描述 是否必需
      x-bce-fetch-source String 抓取文件的源地址,如http://www.abc.com/img.jpg。该参数可以放到querystring里,当放到querystring时需要做UrlEncode。
      x-bce-fetch-mode String 抓取模式,支持异步抓取async和同步抓取sync两种模式。其中异步模式下BOS收到抓取任务后立刻返回成功,同步模式下BOS需要等到抓取Object完成后才会返回成功。对于数据量小或关注抓取结果实时性的建议使用同步模式,异步模式不需要等待,适用不需要实时查看抓取结果的场景,可以后续再对抓取结果进行查询。默认值为sync。 该参数可以放到querystring里。
      x-bce-storage-class String 存储类型,支持标准存储STANDARD、低频存储STANDARD_IA、冷存储COLD和归档存储ARCHIVE。默认存储为STANDARD。 该参数可以放到querystring里。
      x-bce-server-side-encryption String 服务端加密算法,当前仅支持AES256。
    • 请求参数

    响应(Response)

    • 响应头域

    • 响应参数

      名称 类型 描述
      code String 返回请求成功或失败的返回码,成功返回success,错误返回错误码
      message String 返回请求成功或失败的信息,成功返回success,错误返回code对应的错误码
      requestId String 请求ID。
      jobId String 异步模式才会返回该参数,表示请求任务的ID号,可用于后续任务状态查询。

    示例

    • 请求示例(同步模式)

      POST /ObjectName?fetch HTTP/1.1
      Host: BucketName.bj.bcebos.com
      Content-Length: 0
      Date: <Date>
      x-bce-fetch-source: http://www.abc.com/demo.html
      x-bce-fetch-mode: sync
      x-bce-storage-class: STANDARD
      Authorization: AuthorizationString
    • 响应示例(同步模式)

      HTTP/1.1 200 OK
      x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
      Transfer-Encoding: chunked
      Date: Wed, 25 May 2016 06:34:40 GMT
      Server: BceBos
      
      {
          "code": "success",
          "message": "success",
          "requestId": "4db2b34d-654d-4d8a-b49b-3049ca786409",
      }
    • 请求示例(异步模式)

      POST /ObjectName?fetch HTTP/1.1
      Host: BucketName.bj.bcebos.com
      Content-Length: 0
      Date: <Date>
      x-bce-fetch-source: http://www.abc.com/demo.html
      x-bce-fetch-mode: async
      x-bce-storage-class: STANDARD_IA
      Authorization: AuthorizationString
    • 响应示例(异步模式)

      HTTP/1.1 200 OK
      x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
      Content-Length: 43
      Date: Wed, 25 May 2016 06:34:40 GMT
      Server: BceBos
      
      {
          "code": "success",
          "message": "success",
          "requestId": "4db2b34d-654d-4d8a-b49b-3049ca786409",
          "jobId": "b2419b1e3fd45d596ee22bdf62aaaa2f"
      }
    上一篇
    RestoreObject
    下一篇
    DeleteObject