Help Center/ Distributed Database Middleware/ API Reference/ Permissions Policies and Supported Actions/ Instance Management
Updated on 2026-05-30 GMT+08:00
View PDF
Share

Instance Management

Table 1 DDM instance management

Permission

API

Action

IAM Project

Enterprise Project

Buying a pay-per-use instance

Buying a yearly/monthly DDM instance

POST /v1/{project_id}/instances

ddm:instance:create

Before buying a DDM instance, obtain the following dependent permissions:

  • ecs:*:get*
  • ecs:*:list*
  • vpc:vpcs:list
  • vpc:securityGroups:get
  • vpc:subnets:get
  • ecs:cloudServerNics:update
  • ecs:serverInterfaces:use
  • Global or region-level vpc:ports:*
  • BSS Finance and BSS Operator policies

    The last permission is required only when you buy a yearly/monthly DDM instance.

√

√

Querying DDM instances

GET /v1/{project_id}/instances?offset={offset}&limit={limit}

ddm:instance:list

√

√

Querying details of a DDM instance

GET /v1/{project_id}/instances/{instance_id}

ddm:instance:get

  • vpc:*:get*
  • vpc:*:list*

√

√

Modifying a DDM instance

PUT /v1/{project_id}/instances/{instance_id}

ddm:instance:modify

To modify a security group, the following permissions must be configured:
  • vpc:*:get*
  • vpc:*:list*
  • vpc:ports:update
  • vpc:securityGroups:get

√

√

Restarting a DDM instance

POST /v1/{project_id}/instances/{instance_id}/action

ddm:instance:reboot

√

√

Deleting a DDM instance

DELETE /v1/{project_id}/instances/{instance_id}?delete_rds_data=true

ddm:instance:delete

vpc:ports:delete

√

√

Setting an instance to read-only

PUT

/v3/{project_id}/instances/{instance_id}/readonly-status

ddm:instance:setReadOnly

√

√

Checking RDS connectivity (V3)

POST

/v3/{project_id}/instances/{instance_id}/rds/connection

ddm:instance:checkDataNodeConnection

√

√

Querying parameter template application records (V3)

GET

/v3/{project_id}/configurations/{config_id}/apply-histories

ddm::listParamGroup

√

√

Replicating a parameter template (V3)

POST

/v3/{project_id}/configurations/{config_id}/copy

ddm::copyParamGroup

√

√

Updating a parameter template (V3)

PUT

/v3/{project_id}/configurations/{config_id}

ddm::updateParamGroup

√

√

Querying instances that a parameter template can be applied to (V3)

GET

/v3/{project_id}/configurations/{config_id}/query-instances

ddm:instance:list

√

√

Comparing two parameter groups (V3)

PUT

/v3/{project_id}/configurations/diff

ddm::listParamGroup

√

√

The check mark (√) indicates that an action takes effect. The cross mark (x) indicates that an action does not take effect.