Updated on 2026-05-30 GMT+08:00

Deleting an Account (a V3 API)

Function

This API is used to delete an account.

Constraints

None

API Calling

For details, see Calling APIs.

Authorization Information

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

  • 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

    ddm:instance:deleteUser

    Write

    instance *

    • g:EnterpriseProjectId

    • g:ResourceTag/<tag-key

    ddm:user:delete

    -

URI

DELETE /v3/{project_id}/instances/{instance_id}/users/{username}

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

Instance ID, which uniquely identifies an instance

Constraints

N/A

Range

The value contains 36 characters with a suffix of in09. Only letters and digits are allowed.

Default Value

N/A

username

Yes

String

Definition

Username of the account to be deleted

Constraints

N/A

Range

N/A

Default Value

N/A

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Definition

User token.

Constraints

N/A

Range

N/A

Default Value

N/A

Example Request

Deleting an account

DELETE https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/61a4ea66210545909d74a05c27a7179ein09/users/testuser

Response Parameters

  • Normal response

    None

Example Response

  • Normal response example
    { }

Status Code

Error Codes

For details, see Error Codes.