Help Center/ Data Admin Service/ API Reference/ APIs (in OBT)/ Intelligent O&M/ Logging In Using a Built-in Account
Updated on 2026-01-20 GMT+08:00
View PDF
Share

Logging In Using a Built-in Account

Function

This API is used to log in using a built-in account.

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:clouddba:builtInAccountlogin

    Write

    Instance

    -

    -

    -

URI

POST /v3/{project_id}/instances/{instance_id}/login-built-in-account

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

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

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

datastore_type

Yes

String

Definition

DB engine type

Constraints

N/A

Range

MySQL

Default Value

N/A

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

db_user_id

String

Definition

Database user ID, that is, ID of a connection established between the database account and the database. A database user ID is created by calling the API in Creating a Database User.

Range

The value is a UUID containing 36 characters. Only letters, digits, and hyphens (-) are allowed.

Example Requests

POST https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/da304cd5bbb944de828759bc7be3d3fein01/login-built-in-account 
 
{ 
 "datastore_type": "MySQL" 
}

Example Responses

Status code: 200

Successful response

{ 
  "db_user_id" : "19a4c22a-8971-408c-9ca4-c5506aec4811" 
}

Status Codes

Status Code

Description

200

Successful response

400

Client error

500

Server error

Error Codes

See Error Codes.

Parent topic: Intelligent O&M