该接口提供将指定资源移动到另一个空间(如果目标空间存在同名资源,默认覆盖),或者在同一空间内对资源重命名。
注:如果移动的是m3u8文件,不会同时移动ts文件
POST /fmgr/move
HOST: <MgrDomain>
Authorization:<accessToken>
参数 | 必填 | 描述 |
---|---|---|
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>:<key>(不支持目录移动)
<EncodeEntryURI>为对指定资源进行URL安全的Base64编码后的字符串。 |
bucket | 是 | 指定存储空间。
<Urlsafe_Base64_Encoded_bucket>为对指定Bucket名称进行URL安全的Base64编码后的字符串。 |
key | 否 | 指定存储资源的key。
<Urlsafe_Base64_Encoded_key>为对指定资源的key进行URL安全的Base64编码后的字符串。 注:移动到不同空间,未指定key时,则以原资源的key命名。 |
prefix | 否 | 指定资源key的前缀。
<Urlsafe_Base64_Encoded_prefix>为对指定资源的key的前缀进行URL安全的Base64编码后的字符串。 注:指定prefix参数时,资源最终保存为prefix/key。 |
notifyURL | 否 | 处理结果通知接收URL,需要使用URL安全的Base64编码,通知内容格式见任务查询接口的返回内容。 |
force | 否 | 是否强制执行处理。
1:如果目标空间存在同名资源,则强制执行并覆盖。 0:如果目标空间存在同名资源,则不会执行,执行结果返回:File Already Exist。 默认值为1。 |
separate | 否 | 处理指令是否分开通知。设置1和0作为选项码:
1:表示每个指令执行完后都通知notifyURL 0:表示所有指令执行完后再一次性通知notifyURL 默认值为0。 |
fops参数示例
fops=resource/bXlidWNrZXQ6YWFjLmpwZw==/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"