Help Center/ Distributed Database Middleware/ API Reference/ APIs (Recommended)/ Schemas/ Unbinding a Schema (a V3 API)
Updated on 2026-06-05 GMT+08:00
View PDF
Share

Unbinding a Schema (a V3 API)

Function

This API is used to unbind a schema.

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

    ddm:database:unbind

    Write

    database *

    • g:EnterpriseProjectId

    • g:ResourceTag/<tag-key>

    -

    -

URI

POST /v3/{project_id}/instances/{instance_id}/databases/{logic_db_name}/unbind

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID of a tenant in a region

For details about how to obtain the project ID, 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

logic_db_name

Yes

String

Name of the schema to be unbound

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

Unbinding a schema

POST https://{endpoint}/v3/a8e2a5e2a6xxxxxxxxxx5af5b9ddabe5/instances/b7eabbbc6bxxxxxxxxxxadfffa99a7c2in09/databases/db_xxxx/unbind

Response Parameters

None

Example Response

  • Normal response example 
    {}

Status Code

Error Codes

For details, see Error Codes.

Parent topic: Schemas