Help Center/ Data Replication Service/ CLI Reference/ CLI Command Reference (V3)
Updated on 2026-09-18 GMT+08:00

CLI Command Reference (V3)

Quota

API Name

Command

Description

Operation

Querying Quotas

hcloud DRS ShowQuotas/v3

This API is used to query DRS quotas of a tenant in a project.

Go debug

Public API Management

API Name

Command

Description

Operation

Creating Tasks in Batches

hcloud DRS BatchCreateJobs/v3

This API is used to create real-time migration, real-time synchronization, and real-time DR tasks in batches based on different request parameters.

Go debug

Testing connections in batches

hcloud DRS BatchValidateConnections/v3

This API is used to test connections in batches.

Go debug

Testing Connections in Batches (Cluster Mode)

hcloud DRS BatchValidateClustersConnections/v3

  • This API is used to test connections in cluster mode.

Go debug

Selecting Database Objects in Batches

hcloud DRS BatchSetObjects/v3

This API is used to select the databases or tables to be migrated.

Go debug

Performing a Batch Pre-Check

hcloud DRS BatchCheckJobs/v3

This API is used to perform batch pre-check to check whether the migration can be performed.

Go debug

Querying Pre-check Results in Batches

hcloud DRS BatchCheckResults/v3

This API is used to query the pre-check results of tasks in batches.

Go debug

Configuring Flow Control for Tasks

hcloud DRS BatchSetSpeed/v3

This API is used to enable or disable flow control for tasks. By default, the migration speed is not limited after a task is created.- Control: You can customize the maximum migration speed.- No control: The migration speed is not limited and the outbound bandwidth of the source database is maximally used, which drives up read consumption on the source database accordingly. For example, if the outbound bandwidth of the source database is 100 MB/s and 80% bandwidth is used, the I/O consumption on the source database is 80 MB/s.

Go debug

Obtaining Database Parameters in Batches

hcloud DRS BatchShowParams/v3

To ensure that service applications are not affected after the migration, DRS provides parameter comparison to help you compare parameters between the source and destination databases. This API is used to obtain database parameters of the source and destination databases.

Go debug

Modifying Database Parameters

hcloud DRS UpdateParams/v3

This API is to modify database parameters.

Go debug

Starting Tasks in Batches

hcloud DRS BatchStartJobs/v3

This API is used to start real-time migration, synchronization, and disaster recovery tasks in batches.

Go debug

Resuming or Retrying Tasks in Batches

hcloud DRS BatchRestoreTask/v3

This API is used to retry failed migration tasks.

Go debug

Pausing Tasks in Batches

hcloud DRS BatchStopJobs/v3

This API is used to pause tasks in batches.

Go debug

Stopping or Deleting Tasks in Batches

hcloud DRS BatchDeleteJobs/v3

This API is used to stop tasks in batches or delete real-time migration, real-time synchronization, and real-time DR tasks.

Go debug

Modifying Tasks in Batches

hcloud DRS BatchUpdateJob/v3

This API is used to modify task names or descriptions in batches and set exception notification.

Go debug

Changing the Passwords of the Source and Destination Databases in Batches

hcloud DRS BatchResetPassword/v3

This API is used to change the passwords of the source and destination databases after a task is started.

Go debug

Setting Definers in Batches

hcloud DRS BatchSetDefiner/v3

The API is used to set whether to migrate all Definers to the user in batches.- If you select Yes, the Definers of all source database objects will be migrated to the user. Other users do not have permissions on database objects unless they are authorized.- If you select No, the Definers of all source database objects will not be changed. You need to migrate all accounts and permissions of the source database in the next step.

Go debug

Create a task.

hcloud DRS CreateCompareTask/v3

This API is used to create a comparison task

Go debug

Querying Comparison Results

hcloud DRS ListCompareResult/v3

This API is used to query the comparison result.

Go debug

Querying Task Progress in Batches

hcloud DRS BatchListProgresses/v3

This API is used to query the full progress and incremental delay information in batches based on the task ID.

Go debug

Querying Task Details in Batches

hcloud DRS BatchListJobDetails/v3

This API is used to query task details in batches by task ID.

Go debug

Tenant Task Query

hcloud DRS ShowJobList/v3

This API is used to query tenant tasks by engine type, network type, task status, task name, or task ID.

Go debug

Querying Task Statuses in Batches

hcloud DRS BatchListJobStatus/v3

This API is used to query task statuses in batches by task ID.

Go debug

Batch Configure Exception Notifications

hcloud DRS BatchSetSmn/v3

This API is used to set exception notifications in batches. This parameter cannot be set for stopped tasks.

Go debug

Querying AZs Where Flavors Are Not Sold Out

hcloud DRS ListAvailableZone/v3

This API is used to querying AZs where flavors are not sold out.

Go debug

Querying Available Node Specifications

hcloud DRS ListAvailableNodeTypes/v3

This API is used to query available node specifications.

Go debug

Querying Data-level Table Comparison Tasks

hcloud DRS ListDataLevelTableCompareJobs/v3

This API is used to query data-level table comparison tasks.

Go debug

Creating a Data-level Table Comparison Task

hcloud DRS CreateDataLevelTableCompareJob/v3

This API is used to create a data-level table comparison task.

Go debug

Canceling a Comparison Task

hcloud DRS DeleteCompareJob/v3

This API is used to cancel a comparison task.

Go debug

Immediately Starting a Data-level Table Comparison Task

hcloud DRS StartPromptlyDataLevelTableCompareJob/v3

This API is used to immediately start a data-level table comparison task.

Go debug

Querying Row Comparison Overview

hcloud DRS ListDataCompareOverview/v3

This API is used to query the row comparison overview.

Go debug

Querying Row Comparison Details

hcloud DRS ListDataCompareDetail/v3

This API is used to query row comparison details.

Go debug

Querying Value Comparison Overview

hcloud DRS ListContentCompareOverview/v3

This API is used to query the value comparison overview.

Go debug

Querying Value Comparison Details

hcloud DRS ListContentCompareDetail/v3

This API is used to query value comparison details.

Go debug

Creating an Object-level Comparison Task

hcloud DRS CreateObjectLevelCompareJob/v3

This API is used to create an object-level comparison task.

Go debug

Querying the Overview of an Object Comparison Task

hcloud DRS ListObejectLevelCompareOverview/v3

This API is used to query the overview of an object comparison task.

Go debug

Querying Details About an Object Comparison Task

hcloud DRS ListObejectLevelCompareDetail/v3

This API is used to query details about an object comparison task.

Go debug

Querying Value Comparison Differences

hcloud DRS ListContentCompareDifference/v3

This API is used to query value comparison differences.

Go debug

Exporting the Result File of a Comparison Task

hcloud DRS CreateCompareResultFile/v3

This API is used to export the comparison result file.

Go debug

Downloading the Result File of a Comparison Task

hcloud DRS DownloadCompareResultFile/v3

This API is used to download the comparison result file.

Go debug

Querying the LTS Configuration

hcloud DRS SelectGroupAndStream/v3

This API is used to query the LTS configuration of a task.

Go debug

Updating the LTS Configuration

hcloud DRS ModifyGroupAndStream/v3

This API is used to update the LTS configuration of a task.

Go debug

Real-Time Synchronization Management

API Name

Command

Description

Operation

Processing Data in Batches

hcloud DRS BatchChangeData/v3

DRS processes synchronized objects and allows you to add rules for selected objects.

Go debug

Configuring Synchronization Policies in Batches

hcloud DRS BatchSetPolicy/v3

  • This API is used to configure synchronization policies in batches, including conflict policies, DROP DATASE filtering, and object synchronization scope.

Go debug

Advanced Settings

hcloud DRS UpdateTuningParams/v3

This API is used to change the values of tuning parameters.

Go debug

Querying Advanced Settings

hcloud DRS QueryTuningParams/v3

This API is used to query advanced settings.

Go debug

Real-Time Disaster Recovery Management

API Name

Command

Description

Operation

Performing a Batch Primary/Standby Switchover

hcloud DRS BatchSwitchover/v3

This API is used to perform a batch primary/standby switchover.

Go debug

Querying RPO and RTO in Batches

hcloud DRS BatchListRposAndRtos/v3

This API is used to query Recovery Point Objective (RPO) and Recovery Time Objective (RTO).

Go debug

Querying DR Monitoring Data

hcloud DRS ShowMonitoringData/v3

This API is used to query DR monitoring data based on the task ID.

Go debug

Querying the DR Initialization Progress in Batches

hcloud DRS BatchListStructProcess/v3

This API is used to query the DR initialization progress in batches based on the task ID. Virtual IDs cannot be queried.

Go debug

Querying DR Initialization Object Details in Batches

hcloud DRS BatchListStructDetail/v3

This API is used to query details about DR initialization objects in batches by task ID.

Go debug

Real-Time Migration Management

API Name

Command

Description

Operation

Updating Migrated User Information in Batches

hcloud DRS BatchUpdateUser/v3

This API is used to set the users and roles to be migrated in batches.

Go debug

Obtaining Migration Users of the Source Database

hcloud DRS ListUsers/v3

This API is used to query the user information of the source database.

Go debug