API overview

Updated at:
Copy as MD

The following tables list the API operations available for PolarDB-X 1.0, organized by functional category.

Instance management

APIDescription
CreateDrdsInstanceCreates a PolarDB-X 1.0 instance.
DescribeDrdsInstanceQueries the details of a specified PolarDB-X 1.0 instance.
DescribeDrdsInstances instances in the specified region.")Queries PolarDB-X 1.0 instances in a specified region.
RestartDrdsInstanceRestarts a specified PolarDB-X 1.0 instance.
ModifyDrdsInstanceDescriptionModifies the description of a specified PolarDB-X 1.0 instance.

Database management

APIDescription
CreateDrdsDBCreates a database in a PolarDB-X 1.0 instance.
CheckDrdsDbNameChecks whether the name of a specified PolarDB-X 1.0 database is valid.
RemoveDrdsDbFailedRecordDeletes the failure record of a database creation operation.
RemoveDrdsDbDeletes a specified database from a PolarDB-X 1.0 instance.
DescribeDrdsDBQueries the details of a specified database in a PolarDB-X 1.0 instance.
DescribeDrdsDBsQueries all databases in a specified PolarDB-X 1.0 instance.

Storage management

APIDescription
DescribeRdsPerformanceSummaryQueries the performance summary of the ApsaraDB RDS for MySQL instances used as storage resources.
DescribeRdsSuperAccountInstancesQueries the privileged accounts of the ApsaraDB RDS for MySQL instances used as storage resources.
DescribeDrdsDBClusterQueries the details of a specified PolarDB cluster in a logical PolarDB-X 1.0 database.
DescribeDrdsDbInstanceQueries the details of a specified ApsaraDB RDS for MySQL instance used as storage resources for PolarDB-X 1.0.
DescribeDrdsDbInstancesQueries the ApsaraDB RDS for MySQL instances used as storage resources for a specified PolarDB-X 1.0 database.
DescribeDrdsDbRdsNameListQueries the storage instances for a specified PolarDB-X 1.0 database.
GetDrdsDbRdsRelationInfo database.")Queries the structure of storage instances for a specified PolarDB-X 1.0 database.
ModifyRdsReadWeightModifies the read and write weights of the ApsaraDB RDS for MySQL instances used as storage resources.
ModifyPolarDbReadWeightModifies the read and write weights of a specified PolarDB cluster used as storage resources.
ResetDrdsToRdsConnectionsResets the number of connections from a PolarDB-X 1.0 instance to its ApsaraDB RDS for MySQL storage instances.
DescribeRDSPerformanceQueries the performance data of the ApsaraDB RDS for MySQL instances used as storage resources.
DescribeDbInstancesQueries the storage-layer instances, such as ApsaraDB RDS for MySQL or PolarDB.
DescribeDbInstanceDbsQueries the databases on a specified storage instance.
DescribeStorageInstanceSubDbInfoQueries the sub-database information for a specified storage instance.
DescribeRdsCommodityQueries the sales data about ApsaraDB RDS for MySQL that serves as storage resources.

Account management

APIDescription
CreateInstanceAccountCreates an account for a specified PolarDB-X 1.0 instance.
DescribeInstanceAccountsQueries the accounts of a specified PolarDB-X 1.0 instance.
RemoveInstanceAccountDeletes a management account from a specified PolarDB-X 1.0 instance.

Backup and recovery

APIDescription
StartRestoreStarts a backup-based restore task for a specified PolarDB-X 1.0 instance.
RemoveBackupsSetDeletes a specified backup set.
DescribeBackMenuChecks whether a specified PolarDB-X 1.0 instance supports backup and recovery.
DescribeBackupTimesQueries the point in time to which a specified instance can be restored.
DescribeRestoreOrderQueries the details of the current purchase order for a recovery operation.
DescribeBackupDbsQueries the databases that can be restored for a specified instance.
PutStartBackupSubmits a data backup task for a specified PolarDB-X 1.0 instance.
SetBackupPolicySets the backup policy for a specified PolarDB-X 1.0 instance.
EnableSqlFlashbackMatchSwitchEnables query logging in the binary log of the storage-layer ApsaraDB RDS for MySQL instances to support accurate data recovery during SQL flashback.
DescribeBackupSetsQueries the backup sets for a specified PolarDB-X 1.0 instance.

Network and connection

APIDescription
ReleaseInstanceInternetAddressReleases the public endpoint of a specified PolarDB-X 1.0 instance to ensure instance security.
DescribeInstanceSwitchNetworkChecks whether the network type of a specified instance can be switched.
CreateInstanceInternetAddressCreates a public IP address for a specified PolarDB-X 1.0 instance.
RefreshDrdsAtomUrlRefreshes the connections between a PolarDB-X 1.0 instance and its ApsaraDB RDS for MySQL storage instances after a connection change.

Task management

APIDescription
DescribeSqlFlashbakTask instance.")Queries the SQL flashback tasks for a specified PolarDB-X 1.0 instance.
DescribeDrdsInstanceLevelTasksQueries the pending instance-level tasks for a specified PolarDB-X 1.0 instance.
SubmitSqlFlashbackTaskSubmits an SQL flashback task.
DescribePreCheckResultQueries the precheck result of a specified task.
DescribeDrdsTasksQueries the change tasks for a specified PolarDB-X 1.0 instance.

Table sharding

APIDescription
ValidateShardTaskChecks whether a sharding task is valid.
DescribeExpandLogicTableInfoListQueries the shard key information for logical table expansion.
DatalinkReplicationPrecheckRuns a precheck on a data link replication task.
CreateShardTaskCreates a sharding task.
DescribeShardTaskInfoQueries the details of a specified sharding task.
DeleteShardTasksDeletes a specified sharding task.

Data table management

APIDescription
DescribeTablesQueries the tables in a specified PolarDB-X 1.0 database.
DescribeTableListByTypeQueries tables of a specified type in a PolarDB-X 1.0 database.
DescribeTableQueries the schema of a specified table.
SetupTableConfigures the full table scan setting for a specified table.

Tag and parameter settings

APIDescription
TagResourcesAdds tags to a specified PolarDB-X 1.0 instance.
UntagResourcesRemoves tags from a specified PolarDB-X 1.0 instance.
ListTagResourcesQueries the tags on a specified PolarDB-X 1.0 instance.
DescribeDrdsParamsQueries the parameters of a specified PolarDB-X 1.0 instance.
SetupDrdsParamsConfigures parameters for a specified PolarDB-X 1.0 instance.

Instance version

APIDescription
DescribeDrdsInstanceVersionQueries the version of a specified PolarDB-X 1.0 instance.
RollbackInstanceVersionRolls back the version of a specified PolarDB-X 1.0 instance.
UpgradeInstanceVersionUpgrades the version of a specified PolarDB-X 1.0 instance.

Performance monitoring

APIDescription
DescribeDrdsInstanceMonitorQueries the monitoring data for a specified PolarDB-X 1.0 instance.
DescribeDrdsInstanceDbMonitorQueries the performance monitoring data for a specified PolarDB-X 1.0 database.

Others

APIDescription
DescribeDrdsDBIpWhiteListQueries the IP address whitelist of a specified PolarDB-X 1.0 database.
ModifyDrdsIpWhiteListModifies the IP whitelist of a specified PolarDB-X 1.0 database.
DescribeInstanceSwitchAzoneChecks whether a specified PolarDB-X 1.0 instance supports zone switching.
DescribeDrdsSlowSqlsQueries the slow SQL records for a specified PolarDB-X 1.0 instance.