Querying the Number of New Connections and the Number of Concurrent Connections_AAD Overview_AAD APIs_API Reference

Function

This API is used to query the number of new connections and the number of concurrent connections.

Calling Method

For details, see Calling APIs.

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

GET /v2/aad/instances/{instance_id}/ddos-info/flow/connection-numbers

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
instance_id	Yes	String	Instance ID.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
start_time	Yes	String	Start time.
end_time	Yes	String	End time.
ip	Yes	String	AAD IP address
limit	No	Integer	Maximum records.
offset	No	Integer	Offset.

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	token
Content-Type	Yes	String	Content-Type

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
data	Array of ListConnectionNumberData objects	items

**Table 5** ListConnectionNumberData
Parameter	Type	Description
name	String	Connection name.
list	Array of ListConnectionNumberDataList objects	items

**Table 6** ListConnectionNumberDataList
Parameter	Type	Description
time	Integer	Timestamp (ms).
value	Integer	Number of connections

Status code: 400

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_description	String	Error description.

Example Requests

GET https://{endpoint}/v2/aad/instances/8205ed60-xxx-xxxx-8c33-c8f8cd9fc84c/ddos-info/flow/connection-numbers

Example Responses

Status code: 200

{
  "data" : [ {
    "name" : "tcpConcurCon",
    "list" : [ {
      "time" : 1772454000000,
      "value" : 2
    }, {
      "time" : 1772454300000,
      "value" : 1
    } ]
  } ]
}

Status Codes

Status Code	Description
200	OK
400	Error response

Error Codes

See Error Codes.

Querying the Number of New Connections and the Number of Concurrent Connections