FetchObject
所有文档

          对象存储 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;如果是多AZ类型bucket,支持MAZ_STANDARD_IA代表多AZ低频存储,不指定时默认是MAZ_STANDARD多AZ标准存储类型,不能是其它取值。该参数可以放到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