获取资源_API_Object Storage-文档中心

此接口用于从指定URL获取资源并将其存储到指定空间中。

请求说明

POST /fmgr/fetch
HOST: <MgrDomain>
Authorization:<accessToken>

Header 描述

参数	是否必需	描述
HOST	是	管理域名，可在控制台空间概览界面获取。
Authorization	是	管理凭证。

参数描述

请求参数按以下格式组织，并作为请求内容提交：

fops=fetchURL/<Urlsafe_Base64_Encoded_URL>/bucket/<Urlsafe_Base64_Encoded_bucket>/key/<Urlsafe_Base64_Encoded_key>/prefix/<Urlsafe_Base64_Encoded_prefix>/md5/<md5>/decompression/<decompression>/fetchTS/<fetchTS>&notifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&force=<Force>&separate=<Separate>

参数	是否必需	描述
fops	是	处理参数列表，格式如上所述，同时支持多个处理请求。参数列表用 ; 分隔。
fetchURL	是	指定抓取的URL。<Urlsafe_Base64_Encoded_URL>为指定URL的URL安全Base64编码字符串。
bucket	是	指定存储空间。<Urlsafe_Base64_Encoded_bucket>为指定空间名的URL安全Base64编码字符串。
key	否	指定存储资源的文件名。<Urlsafe_Base64_Encoded_key>为指定资源文件名的URL安全Base64编码字符串。注意：未指定文件名时，资源的文件名为抓取URL的URI。
prefix	否	指定资源文件名的前缀。<Urlsafe_Base64_Encoded_prefix>为指定资源键前缀的URL安全Base64编码字符串。注意：指定前缀参数时，资源最终保存为prefix/key。
md5	否	指定资源的md5值。如果指定URL抓取的资源的md5值与指定的md5值一致，则保存，否则不保存。如果未指定，则不检查md5值，直接保存。
decompression	否	解压指定类型的拉取文件，支持zip/tar/gzip。例如，配置 /decompression/zip 解压拉取文件。
fetchTS	否	抓取m3u8文件时，指定是否抓取TS文件： 0-表示不抓取TS文件 1-表示抓取TS文件注意：<1>未设置此参数时，默认不抓取TS文件。<2>仅支持m3u8文件，且TS访问路径为相对路径。<3>不支持多码率自适应m3u8文件。
notifyURL	否	处理结果通知接收的URL。通知内容格式详见任务查询接口返回内容。
force	否	是否强制处理。 1：强制数据处理，覆盖原结果。 0：当数据处理结果已存在时，认为处理成功，避免重复处理浪费资源。默认值为0。
separate	否	处理描述是否单独通知。设置1和0为选项码： 1：表示每执行一个命令就通知notifyURL。 0：表示所有命令执行完一次性通知notifyURL。默认值为0。

请求参数示例

fops=fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuanBn/bucket/bXlidWNrZXQ=;fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuanBn/bucket/bXlidWNrZXQ=/key/ZGlyL2FhLmpwZw==/prefix/YWFkaXIv/md5/0bee89b07a248e27c83fc3d5951213c1;fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuemlw/bucket/bXlidWNrZXQ=/decompress/zip;fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEubTN1OA==/bucket/bXlidWNrZXQ=/fetchTS/1&notifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&force=1&separate=1

响应说明

如果请求成功，将返回包含以下内容的 JSON 字符串：

{ "persistentId": <persistentId> }

字段名称	是否必需	描述
persistentId	是	任务进程ID，可用于查询任务进度

如果请求失败，将返回包含以下内容的 Json 字符串：

{
    "code": "<code string>",
    "message": "<ErrMsg string>"
}

字段名称	是否必需	描述
code	是	HTTP请求响应代码，请参见 HTTP响应状态码
message	是	请求失败的提示信息

示例

curl -v -X POST -d "fops=fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuanBn/bucket/bXlidWNrZXQ=/key/ZGlyL2FhLmpwZw==/prefix/YWFkaXIv/md5/0bee89b07a248e27c83fc3d5951213c1;fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuemlw/bucket/bXlidWNrZXQ=/decompress/zip&notifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&force=1&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/fetch"

Media Delivery

Cloud Security

Web Performance

Enterprise Application

Storage

Edge Computing

Console Guide

API Docs

获取资源

请求说明

Header 描述

参数描述

响应说明

示例

目录