移动资源
更新时间：2025-08-18 15:32:38
此接口用于将指定资源移动到另一个空间，或在同一空间内重命名。
注意：如果移动的是m3u8文件，ts文件不会同时移动。
请求描述
POST /fmgr/move
HOST: <MgrDomain>
Authorization:<accessToken>
Header 描述
| 参数 | 是否必需 | 描述 |
|---|---|---|
| HOST | 是 | 管理域名，可在控制台空间概览界面获取。 |
| Authorization | 是 | 管理凭证。 |
参数描述
请求参数按以下格式组织，并作为请求内容提交：
fops=resource/<EncodeEntryURI>/bucket/<Urlsafe_Base64_Encoded_bucket>/key/<Urlsafe_Base64_Encoded_key>/prefix/<Urlsafe_Base64_Encoded_prefix>¬ifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
| 参数 | 是否必需 | 描述 |
|---|---|---|
| fops | 是 | 处理参数列表，格式如上所述，同时支持多个处理请求。参数列表用 ; 分隔。 |
| resource | 是 | 指定空间名和资源名。格式为： |
| bucket | 是 | 指定存储空间。<Urlsafe_Base64_Encoded_bucket>为指定空间名的URL安全Base64编码字符串。 |
| key | 否 | 指定存储资源的文件名。将文件复制到相同空间时，请指定key，不能与源文件的key相同。<Urlsafe_Base64_Encoded_key>为指定资源文件名的URL安全Base64编码字符串。 注意：未指定文件名时，资源的文件名为抓取URL的URI。 |
| prefix | 否 | 指定资源文件名的前缀。<Urlsafe_Base64_Encoded_prefix>为指定资源key前缀的URL安全Base64编码字符串。 注意：指定prefix参数时，资源最终保存为prefix/key。 |
| notifyURL | 否 | 处理结果通知接收的URL。通知内容格式详见任务查询接口返回内容。 |
| force | 否 | 是否强制处理。 1：强制数据处理，覆盖原结果。 0：当数据处理结果已存在时，认为处理成功，避免重复处理浪费资源。默认值为0。 |
| separate | 否 | 处理指令是否单独通知。设置1和0为选项码： 1：表示每执行一个命令就通知notifyURL。 0：表示所有命令执行完一次性通知notifyURL。默认值为0。 |
fops 参数示例
fops=resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy;resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy/key/YWJjL2FhLmpwZw==/prefix/ZGlyYWEv¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1
响应描述
- 如果请求成功，将返回包含以下内容的
JSON字符串：
{ "persistentId": <persistentId> }
| 字段名称 | 是否必需 | 描述 |
|---|---|---|
| persistentId | 是 | 任务进程ID，可用于查询任务进度。 |
- 如果请求失败，将返回包含以下内容的
JSON字符串：
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| 字段名称 | 是否必需 | 描述 |
|---|---|---|
| code | 是 | HTTP请求响应代码，请参见 HTTP响应状态码 |
| message | 是 | 请求失败的提示信息 |
示例
curl -v -X POST -d "fops=resource/bXlidWNrZXQ6YWFjLmpwZw==/bucket/bXlidWNrZXQy;resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy/key/YWJjL2FhLmpwZw==/prefix/ZGlyYWEv¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/move"
本篇文档内容对您是否有帮助？
有帮助
我要反馈