Updated on 2024-12-02 GMT+08:00

GeminiDB Actions

Table 1 Instance management actions

Permission

API

Action

IAM Project

Enterprise Project

Creating a DB instance

POST /v3/{project_id}/instances

nosql:instance:create

Deleting a DB instance

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

nosql:instance:delete

Querying DB instances

GET /v3/{project_id}/instances?id={id}&name={name}&mode={mode}&datastore_type={datastore_type}&vpc_id={vpc_id}&subnet_id={subnet_id}&offset={offset}&limit={limit}

nosql:instance:list

Scaling up storage space of an instance

POST /v3/{project_id}/instances/{instance_id}/extend-volume

nosql:instance:modifyStorageSize

Adding nodes for a cluster instance

POST /v3/{project_id}/instances/{instance_id}/enlarge-node

nosql:instance:extendNode

Deleting nodes from a cluster instance

POST /v3/{project_id}/instances/{instance_id}/reduce-node

nosql:instance:reduceNode

Changing specifications of an instance

PUT /v3/{project_id}/instances/{instance_id}/resize

nosql:instance:modifySpecification

Changing the administrator password

PUT /v3/{project_id}/instances/{instance_id}/password

nosql:instance:modifyPasswd

Editing the name of an instance

PUT /v3/{project_id}/instances/{instance_id}/name

nosql:instance:rename

Changing the security group of an instance

PUT /v3/{project_id}/instances/{instance_id}/security-group

nosql:instance:modifySecurityGroup

Upgrading minor version

POST

/v3/{project_id}/instances/{instance_id}/db-upgrade

nosql:instance:upgradeDatabaseVersion

Patching databases in batches

/v3/{projectId}/instances/db-upgrade

nosql:instance:batchUpgradeDatabaseVersion

Creating cold storage

POST /v3/{project_id}/instances/{instance_id}/cold-volume

nosql:instance:modifyStorageSize

Scaling up cold storage

PUT /v3/{project_id}/instances/{instance_id}/cold-volume

nosql:instance:modifyStorageSize

Binding or unbinding an EIP

POST /v3/{project_id}/instances/{instance_id}/nodes/{node_id}/public-ip

nosql:instance:bindPublicIp

Enabling or disabling SSL

POST /v3/{project_id}/instances/{instance_id}/ssl-option

nosql:instance:switchSSL

Restarting a DB instance

POST /v3/{project_id}/instances/{instance_id}/restart

nosql:instance:restart

Configuring an autoscaling policy for storage space

PUT /v3/{project_id}/instances/disk-auto-expansion

nosql:instance:modifyStorageSize

Modifying high-risk commands

PUT /v3/{projectId}/instances/{instanceId}/high-risk-commands

nosql:instances:modifyHighRiskCommands

Setting the maintenance period of an instance

PUT /v3/{project_id}/instances/{instance_id}/maintenance-window

nosql:instance:modifyMaintenanceWindow

Querying the password-free configuration of a GeminiDB Redis instance

Get /v3/{project_id}/instances/{instance_id}/passwordless-config

nosql:instance:getPasswordlessConfig

Modifying the password-free configuration of a GeminiDB Redis instance

PUT /v3/{project_id}/instances/{instance_id}/passwordless-config

nosql:instance:setPasswordlessConfig

Updating an agency permission policy

x

nosql:instance:updateAgency

Querying agency permission details

x

nosql:instance:listAgency

Querying memory acceleration rules and details

GET /v3/{project_id}/dbcache/mappings

nosql:instance:listDBCacheMappings

Creating a memory acceleration rule

POST /v3/{project_id}/dbcache/rule

nosql:instance:listDBCacheRules

Deleting a memory mapping

DELETE /v3/{project_id}/dbcache/mapping

nosql:instance:deleteDBCacheMapping

Creating a memory mapping

POST /v3/{project_id}/dbcache/mapping

nosql:instance:createDBCacheMapping

Modifying a memory acceleration rule

PUT /v3/{project_id}/dbcache/rule

nosql:instance:updateDBCacheRule

Querying memory acceleration rules and details

GET /v3/{project_id}/dbcache/rules

nosql:instance:listDBCacheRules

Deleting a memory acceleration rule

DELETE /v3/{project_id}/dbcache/rule

nosql:instance:deleteDBCacheRule

Enabling or disabling instance data export

PUT /v3/{project_id}/instances/{instance_id}/data-dump

nosql:instance:operateDataDump

Enabling or disabling second-level monitoring

PUT /v3/{project_id}/instances/{instance_id}/monitoring-by-seconds/switch

nosql:instance:secondLevelMonitoring

Querying second-level monitoring configurations

GET /v3/{project_id}/instances/{instance_id}/monitoring-by-seconds/switch

nosql:instance:secondLevelMonitoring

Querying hot keys of a GeminiDB Redis instance

GET /v3/{project_id}/instances/{instance_id}/hot-keys

nosql:instance:getHotKeys

Performing a primary/standby switchover for GeminiDB Redis instances

PUT /v3/{project_id}/instance/{instance_id}/switchover

nosql:instance:switchover

Querying disabled commands for a GeminiDB Redis instance

GET /v3/{project_id}/redis/instances/{instance_id}/disabled-commands

nosql:instance:queryRedisDisabledCommands

Setting disabled commands for a GeminiDB Redis instance

POST /v3/{project_id}/redis/instances/{instance_id}/disabled-commands

nosql:instance:setRedisDisabledCommands

Deleting disabled commands for a GeminiDB Redis instance

DELETE /v3/{project_id}/redis/instances/{instance_id}/disabled-commands

nosql:instance:setRedisDisabledCommands

Table 2 Actions for backups and restorations

Permission

API

Action

IAM Project

Enterprise Project

Querying an automated backup policy

GET /v3.1/{project_id}/instances/{instance_id}/backups/policy

nosql:backup:list

Configuring an automated backup policy

PUT /v3/{project_id}/instances/{instance_id}/backups/policy

nosql:instance:modifyBackupPolicy

Querying instances that can be restored

GET /v3/{project_id}/backups/{backup_id}/restorable-instances

nosql:instance:list

Querying the time window when a backup can be restored

GET /v3/{project_id}/instances/{instance_id}/backups/restorable-time-periods

nosql:backup:list

Creating a manual backup

POST /v3/{project_id}/instances/{instance_id}/backups

nosql:backup:create

Deleting a manual backup

DELETE /v3/{project_id}/backups/{backup_id}

nosql:backup:delete

Restoring data to an existing instance

POST /v3/{project_id}/instances/{instance_id}/recovery

nosql:backup:refreshInstanceFromBacku

Restoring data of the current GeminiDB Redis instance to a point in time

PUT /v3/{project_id}/redis/instances/{instance_id}/pitr

nosql:instance:redisPitrRestore

Setting a policy for restoring data of GeminiDB Redis instance to a point in time

PUT /v3/{project_id}/redis/instances/{instance_id}/pitr/policy

nosql:instance:setRedisPitrPolicy

Querying a policy for restoring data of GeminiDB Redis instance to a point in time

GET /v3/{project_id}/redis/instances/{instance_id}/pitr/policy

nosql:instance:showRedisPitrPolicy

Querying the time range for restoring data of GeminiDB Redis instance to a point in time

GET /v3/{project_id}/redis/instances/{instance_id}/pitr/restorable-time-periods

nosql:instance:queryRedisPitrRestoreTime

Querying the storage space used for restoring data of GeminiDB Redis instance to a point in time

GET /v3/{project_id}/redis/instances/{instance_id}/pitr

nosql:instance:showRedisPitrInfo

Stopping a backup

PUT /v3/{project_id}/backups/{backup_id}

nosql:backup:stop

Deleting manual backups in batches

DELETE /v3/{project_id}/instances/backups

nosql:backup:delete

Table 3 Parameter template management actions

Permission

API

Action

IAM Project

Enterprise Project

Obtaining parameter templates

GET /v3/{project_id}/configurations

nosql:param:list

Creating a parameter template

POST

/v3/{project_id}/configurations

nosql:param:create

Modifying parameters in a parameter template

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

nosql:param:modify

Applying a parameter template

PUT /v3.1/{project_id}/configurations/{config_id}/apply

nosql:instance:modifyParameter

Modifying parameters of a specified instance

PUT /v3.1/{project_id}/instances/{instance_id}/configurations

nosql:instance:modifyParameter

Obtaining parameters of a specified instance

GET /v3/{project_id}/instances/{instance_id}/configurations

nosql:param:list

Obtaining parameters of a specified parameter template

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

nosql:param:list

Deleting a parameter template

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

nosql:param:delete

Querying instances that a parameter template can be applied to

GET /v3/{project_id}/configurations/{config_id}/applicable-instances

nosql:instance:list

Viewing parameter change history of an instance

GET /v3/{project_id}/instances/{instance_id}/configuration-histories

nosql:param:list

Viewing application records of a parameter template

GET /v3/{project_id}/configurations/{config_id}/applied-histories

nosql:param:list

Table 4 Tag management actions

Permission

API

Action

IAM Project

Enterprise Project

Querying an instance by tag

POST /v3/{project_id}/instances/resource_instances/action

  • nosql:instance:list
  • nosql:tag:list

Adding or deleting resource tags in batches

POST /v3/{project_id}/instances/{instance_id}/tags/action

nosql:instance:tag

Querying tags of an instance

GET /v3/{project_id}/instances/{instance_id}/tags

  • nosql:instance:list
  • nosql:tag:list

Table 5 Log management actions

Permission

API

Action

IAM Project

Enterprise Project

Querying slow query logs of an instance

GET /v3/{project_id}/instances/{instance_id}/slowlog?start_date={start_date}&end_date={end_date}

nosql:instance:list

Table 6 Quota management actions

Permission

API

Action

IAM Project

Enterprise Project

Querying resource quotas

GET /v3/{project_id}/quotas

nosql:instance:list

Table 7 Actions for disaster recovery management

Permission

API

Action

IAM Project

Enterprise Project

Querying regions where a dual-active relationship can be created between two instances

GET /v3/{project_id}/instances/{instance_id}/disaster-recovery/regions

nosql:instance:list

Setting the percentage of faulty nodes to be taken over in case of a failover

PUT /v3/{project_id}/instances/disaster-recovery/settings

nosql:dr:setDisasterRecoverySettings

Querying the percentage of faulty nodes to be taken over in case of a failover

GET /v3/{project_id}/instances/disaster-recovery/settings

nosql:dr:listDisasterRecoverySettings

Table 8 Task management

Permission

API

Action

IAM Project

Enterprise Project

Querying the maintenance period of an instance

GET /v3/{project_id}/instances/{instance_id}/ops-window

nosql:instance:maintenanceWindow

Canceling a scheduled task

DELETE /v3/{project_id}/scheduled-jobs/{job_id}

nosql:instance:cancleScheduleJob

Querying a scheduled task

GET /v3/{projectId}/scheduled-jobs

nosql:task:list

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