{"base_path":"/","components":null,"consumes":"[\"application/json;charset=UTF-8\"]","definitions":{"Agent":{"description":"","properties":{"agent_id":{"description":"客户端ID","type":"string"},"agent_type":{"description":"客户端类型","type":"string"},"agent_version":{"description":"客户端版本号","type":"string"},"created_at":{"description":"客户端创建时间","format":"date-time","type":"string"},"host_ip":{"description":"客户端所在主机的IP","type":"string"},"host_name":{"description":"客户端所在的主机名","type":"string"},"host_nickname":{"description":"客户端所在的主机昵称","type":"string"},"host_os":{"description":"客户端主机所在的操作系统","type":"string"},"last_active_time":{"description":"客户端上次激活时间","format":"date-time","type":"string"},"paths":{"description":"客户端的备份路径","items":{"$ref":"#/definitions/Path","description":"路径详情"},"type":"array"},"status":{"description":"客户端状态","type":"string"},"updated_at":{"description":"客户端更新时间","format":"date-time","type":"string"}},"required":["agent_id"]},"AgentGetResp":{"description":"","properties":{"agent":{"$ref":"#/definitions/Agent","description":"客户端详情"}},"required":["agent"]},"AgentUpdate":{"description":"","properties":{"status":{"description":"客户端状态,当前只支持卸载,由客户端被卸载时自动触发","enum":["uninstall"],"type":"string"}},"required":["status"]},"AgentUpdateReq":{"description":"","properties":{"agent":{"$ref":"#/definitions/AgentUpdate","description":"待更新的agent参数"}},"required":["agent"]},"Path":{"description":"","properties":{"agent_id":{"description":"该路径所属于的客户端ID","type":"string"},"dir_path":{"description":"路径详情","type":"string"},"exclude_paths":{"description":"排除目录列表,多个路径之间以英文逗号分隔\n> 该特性目前处于公测阶段,部分region可能无法使用。","type":"string"},"id":{"description":"路径ID","type":"string"},"status":{"description":"路径状态,有available和remove两种状态","type":"string"}}}},"description":null,"group_id":"11b1e4b30d524dacb6891902e04115dd","host":"cbr.cn-north-4.myhuaweicloud.com","id":"4a82dba6662141ab8cfc8e2b068b6f33","info_version":"v1","method":"put","name":"UpdateAgent","parameters":{},"paths":{"/v3/{project_id}/agents/{agent_id}":{"put":{"consumes":[],"deprecated":false,"description":"修改客户端状态","operationId":"UpdateAgent","parameters":[{"description":"","in":"path","name":"project_id","required":true,"type":"string","x-order":1},{"description":"","in":"path","name":"agent_id","required":true,"type":"string","x-order":2},{"description":"用户Token。\n通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。","in":"header","name":"X-Auth-Token","required":true,"type":"string","x-example":"MIIDkgYJKoZIhvcNAQcCoIIDgzCCXXXXX...","x-open-region-cloud":"","x-order":3},{"description":"","in":"body","name":"UpdateAgentRequestBody","required":true,"schema":{"$ref":"#/definitions/AgentUpdateReq"},"x-open-region-cloud":"","x-order":4}],"produces":[],"responses":{"200":{"description":"OK","examples":{"application/json":{"agent":{"agent_id":"489654f2-363b-4ebf-966a-bdf079d97114","agent_type":"native","agent_version":"1.0.0","created_at":"2022-01-30T09:28:09.334153","host_ip":"192.168.10.144","host_name":"ecs-0001","host_nickname":"","host_os":"linux","last_active_time":"2022-01-30T09:28:08.959908","paths":[{"agent_id":"0cba3ff9-f836-4178-9ce8-91dc8026321c","dir_path":"/opt/cloud/cbragent/lib","id":"5684b0fb-44c8-4c70-bb59-b03ec2738360","status":"available"},{"agent_id":"0cba3ff9-f836-4178-9ce8-91dc8026321c","dir_path":"/opt/backup","id":"1ad949d5-c955-4995-8c28-60fc8b110a21","status":"available"}],"status":"uninstall","updated_at":"2022-01-30T09:28:09.334153"}}},"schema":{"$ref":"#/definitions/AgentGetResp"}}},"summary":"修改客户端","tags":["文件应用备份"],"x-apiErrorCodes":[{"errorCode":"BackupService.7403","errorDescription":"非法的客户端ID","errorDescriptionEn":"Invalid agent %(agent_id)s","errorMessage":"非法的客户端ID","httpStatus":"400","parentId":"i8b7e3a8792445909d83cf56e8d71981","solution":"客户端注册和解注册不需要手动调用,如有问题请联系技术支持。","solutionEn":""}],"x-apiexplorer-hide":"false","x-constraint":"","x-first-open-time":"","x-hybridcloud":"","x-is-registered":"Y","x-name":"修改客户端","x-open-region-cloud":"hc,hk","x-order":5,"x-publishpath":"","x-request-examples-1":{"agent":{"status":"uninstall"}},"x-request-examples-description-1":"更新客户端状态为卸载","x-request-examples-text-1":"{\n \"agent\": {\n \"status\": \"uninstall\"\n }\n}","x-request-examples-url-1":"PUT https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/agents/79bd9daa-884f-4f84-b8fe-235d58cd927d","x-scope":"Commercial","x-source":"","x-support-sdk":"Y"}}},"product_short":"CBR","region_id":"cn-north-4","schemes":["HTTPS"],"security_definitions":null,"summary":"修改客户端","tags":"文件应用备份","uri":null,"version":"2.0"}