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	-	-	-	-

URI

GET /v3/{project_id}/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 this value, see Obtaining a Project ID. Constraints N/A Range The value can contain 32 characters, including only letters and digits. Default Value N/A

**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, including only letters and digits. Default Value N/A
datastore_type	Yes	String	Definition Database type Constraints N/A Range MySQL TaurusDB PostgreSQL Microsoft SQL Server Default Value N/A

Request Parameters

None

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, including only letters and digits.
instance_name	String	Definition Instance name Range N/A
instance_nodes	Array of Table 4 objects	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, including only letters and digits.
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/nodes-info?instance_id=5c59fa7d6f09456b947f32922f9aeda1in01&datastore_type=mysql"

Example Responses

Status code: 200

Successful response

{
  "instance_id": "5c59fa7d6f09456b947f32922f9aeda1in01",
  "instance_name": "DAS-MYSQL-AT",
  "instance_nodes": [
    {
      "id": "09ab88b8a12340569ac056af284011d9no01",
      "name": "DAS-MYSQL-AT_node0",
      "role": "master",
      "status": "normal",
      "type": "master"
    }
  ]
}