Updated on 2026-08-25 GMT+08:00

Obtaining Information About a Single Instance Node

Function

This API is used to obtain information about a single instance node.

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

-

-

-

-

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
das::showCloudDBAInfo	Read	-	-	-	-

URI

GET /v3/{project_id}/instance/get-instance-nodes-info

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID of a tenant in a region. To obtain the 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

Request Parameters

**Table 2** Query parameters
Parameter	Mandatory	Type	Description
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
engine_type	No	String	Definition Database type Constraints N/A Range N/A Default Value N/A

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
instance_id	String	Definition Instance ID Range The value can contain 32 characters. Only letters and digits are supported.
instance_name	String	Definition Instance name Range N/A
nodes	Array of objects in Table 4	Definition Instance node list Range N/A

**Table 4** instance_nodes
Parameter	Type	Description
id	String	Definition Node ID Range The value can contain 32 characters. Only letters and digits are supported.
name	String	Definition Node name Range N/A
role	String	Definition Node role Range N/A
status	String	Definition Node status Range normal abnormal
type	String	Definition Node type Range N/A

Example Requests

GET https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instance/get-instance-nodes-info?instance_id=bcfa975193f1402fa11a6d4fd6baf5fbin01&engine_type=mysql

Example Responses

Status code: 200

Success.

{
    "instance_id": "bcfa975193f1402fa11a6d4fd6baf5fbin01",
    "instance_name": "das-Do not delete 1.",
    "nodes": [
        {
            "id": "1a6bf163753d4c9b925b7d402c001a2eno01",
            "name": "das_node0",
            "role": "slave",
            "status": "normal",
            "type": "slave"
        },
        {
            "id": "7c1efa30d2a340b68bc0a80652e14179no01",
            "name": "das_node1",
            "role": "master",
            "status": "normal",
            "type": "master"
        }
    ]
}

Status Codes

Status Code	Description
200	Success.
400	Client error.
500	Server error.

Error Codes

See Error Codes.

Parent topic: Intelligent O&M