Updated on 2024-01-31 GMT+08:00

Querying Server Groups

Function

This API is used to query server groups.

Calling Method

For details, see Calling APIs.

URI

GET /v5/{project_id}/host-management/groups

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

group_name

No

String

Server group name

Minimum: 1

Maximum: 64

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

data_list

Array of HostGroupItem objects

Server group list

Array Length: 0 - 100

Table 5 HostGroupItem

Parameter

Type

Description

group_id

String

Server group ID

group_name

String

Server group name

host_num

Integer

Number of associated servers

risk_host_num

Integer

Number of unsafe servers

unprotect_host_num

Integer

Number of unprotected servers

host_id_list

Array of strings

Server ID list

is_outside

Boolean

Indicates whether the server group is an on-premises data center server group.

Example Requests

Query the server group whose name is test.

GET https://{endpoint}/v5/{project_id}/host-management/groups?offset=0&limit=200&enterprise_project_id=all_granted_eps&&group_name=test

Example Responses

Status code: 200

Server group list

{
  "data_list" : [ {
    "group_id" : "36e59701-e2e7-4d56-b229-0db3bcf4e6e8",
    "group_name" : "test",
    "host_id_list" : [ "71a15ecc-049f-4cca-bd28-5e90aca1817f" ],
    "host_num" : 1,
    "risk_host_num" : 1,
    "unprotect_host_num" : 0
  } ],
  "total_num" : 1
}

Status Codes

Status Code

Description

200

Server group list

Error Codes

See Error Codes.