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

Deleting a Session

Function

This API is used to delete a session.

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 and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the permission listed below is required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    das:clouddba:deleteProcess

    write

    instance

    -

    -

    -

URI

POST /v3/{project_id}/instances/{instance_id}/kill-process

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

Default Value

N/A

instance_id

Yes

String

Definition

Instance ID, which uniquely identifies an instance.

Constraints

N/A

Range

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

Default Value

N/A

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

engine_type

Yes

String

Definition

DB engine type.

Constraints

N/A

Range

N/A

Default Value

N/A

processes

Yes

Array of objects in Table 3

Definition

Session list.

Constraints

N/A

Range

N/A

Default Value

N/A

Table 3 process

Parameter

Mandatory

Type

Description

id

Yes

Long

Definition

Process ID.

Constraints

N/A

Range

N/A

Default Value

N/A

user

Yes

String

Definition

Username.

Constraints

N/A

Range

N/A

Default Value

N/A

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

count

Integer

Definition

Count.

Range

N/A

Example Requests

POST https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/1b4af3014b794e6482e8f1cc4cbaaad3in03/kill-process
 
{
    "engine_type": "postgresql",
    "processes": [
        {
            "id": 429374,
            "user": "root"
        }
    ]
}

Example Responses

Status code: 200

Success.

""

Status Codes

Status Code

Description

200

Success.

400

Client error.

500

Server error.

Error Codes

See Error Codes.