Querying the Servers Protected Against Ransomware

Function

This API is used to query the list of servers protected against ransomware. This API needs to be used together with Cloud Backup and Recovery (CBR). Ensure the site has CBR before using ransomware-related APIs.

URI

GET /v5/{project_id}/ransomware/server

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	User project ID Minimum: 1 Maximum: 256

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
enterprise_project_id	No	String	Enterprise project ID. To query all enterprise projects, set this parameter to all_granted_eps. Default: 0 Minimum: 1 Maximum: 256
offset	No	Integer	Offset, which specifies the start position of the record to be returned. The value must be a number no less than 0. The default value is 0. Minimum: 0 Maximum: 2000000 Default: 0
limit	No	Integer	Number of records displayed on each page. Minimum: 10 Maximum: 200 Default: 10
host_name	No	String	Server name
os_type	No	String	OS type. Its value can be: Linux Windows Minimum: 0 Maximum: 64
host_ip	No	String	Server IP address Minimum: 0 Maximum: 256
host_status	No	String	Server status. Its value can be: If no parameter is transferred, it indicates all items. ACTIVE SHUTOFF Minimum: 1 Maximum: 32
last_days	No	Integer	Number of days in the query time range. To query records in the last seven days, set last_days=7. If this parameter is not specified, the events and existing backups in the last day are queried by default. Minimum: 1 Maximum: 30

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
x-auth-token	Yes	String	User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. Minimum: 1 Maximum: 32768
region	Yes	String	region id Minimum: 0 Maximum: 128

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
total_num	Integer	Total number Minimum: 0 Maximum: 2097152
data_list	Array of ProtectionServerInfo objects	Query the servers protected against ransomware.

**Table 5** ProtectionServerInfo
Parameter	Type	Description
host_id	String	Server ID Minimum: 0 Maximum: 128
agent_id	String	Agent ID Minimum: 0 Maximum: 128
host_name	String	Server name Minimum: 0 Maximum: 128
host_ip	String	EIP Minimum: 0 Maximum: 128
private_ip	String	Private IP address Minimum: 0 Maximum: 128
os_type	String	OS type. Its value can be: Linux Windows Minimum: 0 Maximum: 128
os_name	String	OS name Minimum: 0 Maximum: 128
host_status	String	Server status. The options are as follows: ACTIVE SHUTOFF Minimum: 1 Maximum: 32
ransom_protection_status	String	Ransomware protection status. The options are as follows: closed opened opening: The function is being enabled. closing: The function is being disabled. Minimum: 0 Maximum: 128
protect_status	String	Protection status. Its value can be: closed opened: protection enabled Minimum: 1 Maximum: 32
group_id	String	Server group ID Minimum: 1 Maximum: 128
group_name	String	Server group name Minimum: 1 Maximum: 128
protect_policy_id	String	Policy ID Minimum: 1 Maximum: 128
protect_policy_name	String	Policy name Minimum: 1 Maximum: 128
backup_error	backup_error object	Backup error message
backup_protection_status	String	Whether to enable backup. The options are as follows: failed_to_turn_on_backup: Backup cannot be enabled. closed opened Minimum: 0 Maximum: 128
count_protect_event	Integer	Number of protection events Minimum: 0 Maximum: 2097152
count_backuped	Integer	Existing backups Minimum: 0 Maximum: 2097152
agent_status	String	Agent status Minimum: 1 Maximum: 128

**Table 6** backup_error
Parameter	Type	Description
error_code	Integer	Error code. The options are as follows: 0: No error information. 1: Backup cannot be enabled because another vault has been bound. 2: The number of backup vaults exceeds the upper limit. 3: An exception occurs when the CBR API is called. Minimum: 0 Maximum: 128
error_description	String	Error description Minimum: 1 Maximum: 128

Example Requests

None

Example Responses

Status code: 200

List of servers protected against ransomware

{
  "total_num" : 1,
  "data_list" : [ {
    "agent_id" : "2758d2a61598fd9144cfa6b201049e7c0af8c3f1280cd24e3ec95a2f0811a2a2",
    "agent_status" : "online",
    "backup_error" : {
      "error_code" : 1,
      "error_description" : "Backup cannot be enabled because another vault has been bound."
    },
    "ransom_protection_status" : "opened",
    "backup_protection_status" : "failed_to_turn_on_backup",
    "count_backuped" : 0,
    "count_protect_event" : 0,
    "group_id" : "7c659ea3-006f-4687-9f1c-6d975d955f37",
    "group_name" : "333",
    "host_id" : "caa958ad-a481-4d46-b51e-6861b8864515",
    "host_ip" : "100.85.119.68",
    "host_name" : "Euler",
    "host_status" : "ACTIVE",
    "os_name" : "EulerOS",
    "os_type" : "Linux",
    "private_ip" : "100.85.123.9",
    "protect_policy_id" : "0253edfd-30e7-439d-8f3f-17c54c99706",
    "protect_policy_name" : "tst",
    "protect_status" : "opened"
  } ]
}