更新时间：2026-10-20 GMT+08:00

移除备份路径 - RemoveAgentPath

移除已添加的文件备份路径。

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

POST /v3/{project_id}/agents/{agent_id}/remove-path

表1 路径参数
参数	是否必选	参数类型	描述
agent_id	是	String	参数解释：客户端ID，用于标识备份客户端的唯一标识符，获取方法请参见查询客户端列表约束限制：不涉及取值范围：不涉及默认取值：不涉及
project_id	是	String	参数解释：项目ID，获取方法请参见获取项目ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：不涉及取值范围：不涉及默认取值：不涉及

表3 请求Body参数
参数	是否必选	参数类型	描述
remove_path	是	Array of strings	参数解释：需要移除的备份路径列表，每个元素为待移除的备份路径字符串约束限制：不涉及取值范围：不涉及默认取值：不涉及

状态码：200

表4 响应Body参数
参数	参数类型	描述
removed	Array of strings	参数解释：成功移除的备份路径列表，每个元素为已移除的备份路径字符串
not_existed	Array of strings	参数解释：请求移除但不存在的备份路径列表，每个元素为不存在的路径字符串

移除备份路径

POST https://{endpoint}/v3/{project_id}/agents/{agent_id}/remove-path

{
  "remove_path" : [ "/tmp", "/home" ]
}

状态码：200

{
  "removed" : [ "/tmp" ],
  "not_existed" : [ "/home" ]
}

状态码	描述
200	OK

请参见错误码。