Modifying an Agent

Function

This API is used to change the status of an agent.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, no identity policy-based permission required for calling this API.

URI

PUT /v3/{project_id}/agents/{agent_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
agent_id	Yes	String	Agent ID
project_id	Yes	String	Project ID

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. You can obtain it by calling the IAM API for obtaining a user token. The user token is the value of X-Subject-Token in the response header.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
agent	Yes	AgentUpdate object	Agent parameters to be updated

**Table 4** AgentUpdate
Parameter	Mandatory	Type	Description
status	Yes	String	Agent status. Currently, the agent can only be in the uninstall state. uninstall: This status is automatically displayed when the agent is uninstalled. It indicates that an update is in progress.

Response Parameters

Status code: 200

**Table 5** Response body parameters
Parameter	Type	Description
agent	Agent object	Agent details

**Table 6** Agent
Parameter	Type	Description
created_at	String	Time when the Agent was installed
updated_at	String	Time when the Agent was updated
agent_id	String	Agent ID
agent_version	String	Agent version
agent_type	String	Agent type. The value can be: native: local agent, which is installed on the local PC. cloud: cloud agent, which is installed on the cloud.
host_name	String	Name of the host where the Agent is installed
host_nickname	String	Host alias
host_ip	String	Host IP address
host_os	String	Host OS
status	String	Agent status. The value can be: normal: The agent can be used normally. abnormal: The agent is abnormal and needs to be recovered. Some functions are unavailable. uninstall: The agent has been uninstalled or is being upgraded.
last_active_time	String	Time when the Agent was last activated
paths	Array of Path objects	Backup path of the agent

**Table 7** Path
Parameter	Type	Description
id	String	Path ID
status	String	Path status, which can either be available or remove available: The file backup path is available. remove: The file backup path is removed and cannot be used.
agent_id	String	ID of the Agent to which the path belongs
dir_path	String	Path details
exclude_paths	String	List of excluded directories. Use commas (,) to separate multiple paths. NOTE: This feature is in the open beta test (OBT) phase and may be unavailable in some regions.

Example Requests

Changing the agent status to uninstalled

PUT https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/agents/79bd9daa-884f-4f84-b8fe-235d58cd927d

{
  "agent" : {
    "status" : "uninstall"
  }
}

Example Responses

Status code: 200

{
  "agent" : {
    "created_at" : "2022-01-30T09:28:09.334+00:00",
    "updated_at" : "2022-01-30T09:28:09.334+00:00",
    "agent_id" : "489654f2-363b-4ebf-966a-bdf079d97114",
    "agent_version" : "1.0.0",
    "agent_type" : "native",
    "host_name" : "ecs-0001",
    "host_nickname" : "",
    "host_ip" : "192.168.10.144",
    "host_os" : "linux",
    "status" : "uninstall",
    "last_active_time" : "2022-01-30T09:28:08.960+00:00",
    "paths" : [ {
      "id" : "5684b0fb-44c8-4c70-bb59-b03ec2738360",
      "agent_id" : "0cba3ff9-f836-4178-9ce8-91dc8026321c",
      "dir_path" : "/opt/huaweicloud/cbragent/lib",
      "status" : "available",
      "exclude_paths" : "*.txt,/opt/huaweicloud/cbragent/lib/test"
    }, {
      "id" : "1ad949d5-c955-4995-8c28-60fc8b110a21",
      "agent_id" : "0cba3ff9-f836-4178-9ce8-91dc8026321c",
      "dir_path" : "/opt/backup",
      "status" : "available",
      "exclude_paths" : "*.txt,/opt/huaweicloud/cbragent/lib/test"
    } ]
  }
}