Help Center/ Data Admin Service/ API Reference/ APIs/ Intelligent O&M/ Querying the Number of DDS Instance Connections
Updated on 2026-08-25 GMT+08:00

Querying the Number of DDS Instance Connections

Function

This API is used to query the number of DDS instance connections.

Authorization Information

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

  • If you are using role/policy-based authorization, see the required permissions in Permissions Policies and Supported Actions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    das::showCloudDBAInfo

    Read

    -

    -

    -

    -

URI

GET /v3/{project_id}/instances/{instance_id}/dds-connection-stat

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID of a tenant in a region.

To obtain this value, see Obtaining a Project ID.

Constraints

N/A

Range

The value can contain 32 characters. Only letters and digits are supported.

Default Value

N/A

instance_id

Yes

String

Definition

Unique ID of an instance

Constraints

N/A

Range

The value can contain 32 characters. Only letters and digits are supported.

Default Value

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

total_connections

Integer

Definition

Total number of connections

Range

N/A

total_inner_connections

Integer

Definition

Total number of internal connections

Range

N/A

total_outer_connections

Integer

Definition

Total number of external connections

Range

N/A

inner_connections

Arrays of Table 3 Objects

Definition

Details about internal connections

Range

N/A

outer_connections

Arrays of Table 3 Objects

Definition

Details about external connections

Range

N/A

inner_connections_size

Integer

Definition

Total number of details about internal connections

Range

N/A

outer_connections_size

Integer

Definition

Total number of details about external connections

Range

N/A

Table 3 connectionDetail

Parameter

Type

Description

client_ip

String

Definition

Client IP address

Range

N/A

count

Integer

Definition

Number of connections

Range

N/A

Example Requests

GET https://das.cn-north-1.myhuaweicloud.com/v3/052041494800d57c2f02c00275b4c247/instances/9ef7cfff58864138a0adb8b32a97e185in02/dds-connection-stat 
 

Example Responses

Status code: 200

Success.

{
    "total_connections": 51,
    "total_inner_connections": 51,
    "total_outer_connections": 0,
    "inner_connections": [
        {
            "client_ip": "172.16.21.132",
            "count": 19
        },
        {
            "client_ip": "172.16.57.96",
            "count": 17
        },
        {
            "client_ip": "172.16.59.197",
            "count": 15
        }
    ],
    "outer_connections": [],
    "inner_connections_size": 3,
    "outer_connections_size": 0
}

Status Codes

Status Code

Description

200

Success.

400

Client error.

500

Server error.

Error Codes

See Error Codes.