API overview

更新时间:
复制 MD 格式

The following tables list the API operations that are available for use in ApsaraDB RDS.

Top 10 Popular APIs

API Description
CreateDBInstance Creates an ApsaraDB RDS instance.
DescribeDBInstances Queries the ApsaraDB RDS instances that meet specified conditions or the ApsaraDB RDS instances on which a specified RAM user has permissions.
DescribeDBInstanceAttribute Queries the details about one or more ApsaraDB RDS instances.
DescribeDBInstancePerformance Queries the performance data of an ApsaraDB RDS instance.
DescribeSlowLogRecords Queries the details about the slow query logs of an ApsaraDB RDS instance.
DescribeSlowLogs Queries the summary of the slow query logs of an ApsaraDB RDS instance.
DescribeBackups Queries the data backup files of an ApsaraDB RDS instance.
DescribeResourceUsage Queries the storage usage of an ApsaraDB RDS instance.
CreateAccount Creates an account to manage databases on an ApsaraDB RDS instance.
CreateDatabase Create a database.

Billing

API Description
DescribePrice Retrieves the price of an instance.
DescribeRenewalPrice Queries the renewal fee for an ApsaraDB RDS instance.
TransformDBInstancePayType Changes the billing method of an ApsaraDB RDS instance.
RenewInstance Renews an ApsaraDB RDS instance.

Instances

API Description
CreateDBInstance Creates an ApsaraDB RDS instance.
DeleteDBInstance Releases an ApsaraDB RDS instance.
RestartDBInstance Restarts an instance.
StopDBInstance Suspends an ApsaraDB RDS instance.
StartDBInstance Resumes an ApsaraDB RDS instance.
ModifyDBInstanceSpec Changes the instance type or storage capacity of an ApsaraDB RDS instance. This operation is supported for primary ApsaraDB RDS instances and read-only ApsaraDB RDS instances. This operation is not supported for disaster recovery ApsaraDB RDS instances or temporary ApsaraDB RDS instances.
ModifyDasInstanceConfig Configures automatic storage expansion for an ApsaraDB RDS instance.
DescribeAvailableZones Queries the available resources in the zone in which an ApsaraDB RDS instance resides.
DescribeAvailableClasses Queries the specifications that are supported for an ApsaraDB RDS instance. The specifications include the instance type and the storage capacity.
DescribeDBInstanceAttribute Queries the details about one or more ApsaraDB RDS instances.
GetDBInstanceTopology Queries the topology of an ApsaraDB RDS instance.
DescribeDBInstances Queries the ApsaraDB RDS instances that meet specified conditions or the ApsaraDB RDS instances on which a specified RAM user has permissions.
ListClasses Queries the details about the available instance types.
DescribeDBInstancesByExpireTime Queries the information about the RDS instances that expire on a specified date.
DescribeRegions Queries the regions and zones that are available for use in ApsaraDB RDS.
MigrateToOtherZone Migrates an ApsaraDB RDS instance across zones in the same region.
ModifyDBInstanceDescription Modifies the description of an ApsaraDB RDS instance.
ModifyDBInstanceMaintainTime Modifies the maintenance window of an RDS instance.
ModifyResourceGroup Moves an ApsaraDB RDS instance to a specified resource group.
CheckInstanceExist Checks whether the instance exists.
ModifyHADiagnoseConfig Changes the availability check method of an ApsaraDB RDS instance.
DescribeHADiagnoseConfig Queries the availability check method of an ApsaraDB RDS instance.
DescribeAnalyticdbByPrimaryDBInstance Queries the analytic instances that are associated with an ApsaraDB RDS for MySQL instance.
CheckCloudResourceAuthorized Queries cloud resource permissions.

Upgradation

API Description
UpgradeDBInstanceEngineVersion Upgrades the major engine version of an ApsaraDB RDS instance.
UpgradeDBInstanceKernelVersion Updates the minor engine version of an ApsaraDB RDS instance.
ModifyDBInstanceAutoUpgradeMinorVersion Changes the method that is used to update the minor engine version of an ApsaraDB RDS instance.
UpgradeDBInstanceMajorVersionPrecheck Checks the compatibility between a new major engine version and an ApsaraDB RDS for PostgreSQL instance before an upgrade.
DescribeUpgradeMajorVersionPrecheckTask Queries the check report for a major engine version upgrade of an ApsaraDB RDS for PostgreSQL instance.
UpgradeDBInstanceMajorVersion Upgrades the major engine version of an ApsaraDB RDS for PostgreSQL instance.
DescribeUpgradeMajorVersionTasks Queries the tasks that are created to upgrade the major engine version of an ApsaraDB RDS for PostgreSQL instance.

Networks and endpoints

API Description
AllocateInstancePublicConnection Applies for a public endpoint for an ApsaraDB RDS instance.
DescribeDBInstanceNetInfo Queries the details about all endpoints of an ApsaraDB RDS instance.
ModifyDBInstanceConnectionString Changes the endpoint and the port number of an ApsaraDB RDS instance.
ModifyDBInstanceNetworkExpireTime Modifies the validity period of an endpoint of an ApsaraDB RDS instance.
SwitchDBInstanceNetType Switches an ApsaraDB RDS instance between the internal endpoint and the public endpoint.
ReleaseInstancePublicConnection Releases the public endpoint of an ApsaraDB RDS instance.
ModifyDBInstanceNetworkType Changes the network type of an ApsaraDB RDS instance.
SwitchDBInstanceVpc Changes the virtual private cloud (VPC) or vSwitch of an ApsaraDB RDS instance.
DescribeVSwitches Queries the details about a vSwitch that is created in a VPC.

Primary/secondary high availability and data replication

API Description
ModifyDBInstanceHAConfig Changes the high-availability mode and data replication mode of an ApsaraDB RDS instance.
DescribeDBInstanceHAConfig Queries the high-availability mode and data replication mode of an ApsaraDB RDS instance.
SwitchDBInstanceHA Switches workloads over between a primary RDS instance and its secondary RDS instance.
ModifyHASwitchConfig Enables or disables the automatic primary/secondary switchover feature for an ApsaraDB RDS instance.
DescribeHASwitchConfig Queries the settings of the automatic primary/secondary switchover feature for an ApsaraDB RDS instance.

Event history

API Description
DescribeEvents Queries the events of an ApsaraDB RDS instance.
DescribeActionEventPolicy Queries the status of the event history feature for an ApsaraDB RDS instance.
ModifyActionEventPolicy Enables or disables the event history feature for an ApsaraDB RDS instance.

Notifications

API Description
QueryNotify Queries the notifications of an ApsaraDB RDS instance.
ModifyActionEventPolicy Enables or disables the event history feature for an ApsaraDB RDS instance.

CloudDBA database performance optimization

API Description
CreateDiagnosticReport Creates a diagnostic report.
DescribeDiagnosticReportList Queries a list of diagnostic reports.

Accounts

API Description
CreateAccount You can create an account to manage the database.
DeleteAccount Deletes an account from an ApsaraDB RDS instance.
ResetAccountPassword Reset your account password.
LockAccount Locks an account of an ApsaraDB RDS for PostgreSQL instance.
UnlockAccount Unlocks an account of an ApsaraDB RDS for PostgreSQL instance.
DescribeAccounts Queries the details about the accounts that are created on an ApsaraDB RDS instance.
ModifyAccountDescription Modifies the description of an account of an ApsaraDB RDS instance.
DescribeInstanceKeywords Queries the reserved keywords of an ApsaraDB RDS instance. The reserved keywords cannot be used for the usernames of accounts or the names of databases.
ModifyPGHbaConfig Modifies the pg_hba.conf file of an ApsaraDB RDS for PostgreSQL instance.
DescribePGHbaConfig Queries the configuration of the pg_hba.conf file of an ApsaraDB RDS for PostgreSQL instance.
DescribeModifyPGHbaConfigLog Queries the details about the modifications to the pg_hba.conf file of an ApsaraDB RDS for PostgreSQL instance.
GrantAccountPrivilege Grant database access to an account.
GrantOperatorPermission Grant permissions to the service account.
RevokeOperatorPermission Revoke the permissions of a service account.
RevokeAccountPrivilege Removes the permissions on a database of an ApsaraDB RDS instance from an account.
ResetAccount Reset permissions for a privileged account.

Databases

API Description
CreateDatabase Creates a database on an ApsaraDB RDS instance.
DeleteDatabase Deletes a database from an ApsaraDB RDS instance.
ModifyDBDescription You can modify the database description.
CopyDatabaseBetweenInstances Replicates databases across RDS instances.
DescribeDatabases Queries the details about the databases that are created on an ApsaraDB RDS instance.
CheckDBNameAvailable Check the availability of the database name.
DescribeCollationTimeZones Queries the character set collations and time zones that are available for use in ApsaraDB RDS.
DescribeCharacterSetName Queries the character sets that are supported by an ApsaraDB RDS instance.

Read-only instances

API Description
CreateReadOnlyDBInstance Creates a read-only ApsaraDB RDS instance for a primary ApsaraDB RDS instance.
DescribeReadDBInstanceDelay Queries the latency at which a read-only ApsaraDB RDS instance replicates data from its primary ApsaraDB RDS instance.
ModifyReadonlyInstanceDelayReplicationTime Changes the latency at which a read-only ApsaraDB RDS instance replicates data from its ApsaraDB primary RDS instance.

Cluster instances

API Description
CreateDBNodes Adds nodes to a cluster instance.
DeleteDBNodes Deletes nodes from a cluster instance.
DescribeDBInstanceEndpoints Queries the endpoint information of an instance.
CreateDBInstanceEndpoint Creates an endpoint for an instance.
DeleteDBInstanceEndpoint Deletes an endpoint of an instance.
ModifyDBInstanceEndpoint Modifies the endpoint information of an instance.
CreateDBInstanceEndpointAddress Creates a public endpoint for an instance.
DeleteDBInstanceEndpointAddress Deletes a public endpoint of an instance.
ModifyDBInstanceEndpointAddress Modifies the endpoint of an instance.

Shared proxy (being phased-out)

API Description
AllocateReadWriteSplittingConnection Applies for a read/write splitting endpoint for an ApsaraDB RDS instance.
ReleaseReadWriteSplittingConnection Releases the read/write splitting endpoint of an ApsaraDB RDS instance.
CalculateDBInstanceWeight Queries the weight allocation value for the system.
ModifyReadWriteSplittingConnection Changes the latency threshold of the read/write splitting link and the read weights of a primary ApsaraDB RDS instance and its read-only ApsaraDB RDS instances.
DescribeDBInstanceProxyConfiguration Query the database proxy settings.

Dedicated proxy (read/write splitting)

API Description
ModifyDBProxy Enables or disables the dedicated proxy feature for an ApsaraDB RDS instance.
UpgradeDBProxyInstanceKernelVersion Upgrades the dedicated proxy version of an ApsaraDB RDS instance.
ModifyDBProxyInstance Changes the number of dedicated proxies that are enabled on an ApsaraDB RDS instance.
ModifyDBProxyEndpoint Modifies an endpoint that is used to connect to the dedicated proxy of an ApsaraDB RDS instance. You can use a proxy endpoint to perform read/write splitting, transaction splitting, and connection pooling.
DescribeDBProxy Queries the details about the dedicated proxy of an ApsaraDB RDS instance.
DescribeDBProxyEndpoint Queries the endpoints that are used to connect to the dedicated proxy of an ApsaraDB RDS instance.
DescribeDBProxyPerformance Queries the performance data of the dedicated proxy of an ApsaraDB RDS instance.
CreateDBProxyEndpointAddress Creates an endpoint that is used to connect to the dedicated proxy of an ApsaraDB RDS instance.
ModifyDBProxyEndpointAddress Modifies an endpoint that is used to connect to the dedicated proxy of an ApsaraDB RDS instance.
DeleteDBProxyEndpointAddress Deletes an endpoint that is used to connect to the dedicated proxy of an ApsaraDB RDS instance.
ModifyDbProxyInstanceSsl Configures SSL encryption for an endpoint that is used to connect to the dedicated proxy of an ApsaraDB RDS instance.
GetDbProxyInstanceSsl Queries the SSL encryption settings of an endpoint that is used to connect to the dedicated proxy of an ApsaraDB RDS instance.

Security and encryption

API Description
DescribeSecurityGroupConfiguration Queries the details about the Elastic Compute Service (ECS) security groups that are associated with an ApsaraDB RDS instance.
ModifySecurityGroupConfiguration Modifies the ECS security groups that are associated with an ApsaraDB RDS instance.
DescribeDBInstanceIPArrayList Queries the IP address whitelists of an ApsaraDB RDS instance.
ModifySecurityIps Modifies an IP address whitelist of an ApsaraDB RDS instance.
DescribeDBInstanceSSL Queries the settings of the SSL encryption feature for an ApsaraDB RDS instance.
ModifyDBInstanceSSL Modifies the SSL link of an ApsaraDB RDS instance.
DescribeDBInstanceTDE Queries the status of the Transparent Data Encryption (TDE) feature for an ApsaraDB RDS instance.
ModifyDBInstanceTDE Enables the TDE feature for an ApsaraDB RDS instance.
MigrateSecurityIPMode The whitelist is switched from General mode to High-security mode.
DescribeDBInstanceIpHostname Queries the hostname of the ECS instance on which an ApsaraDB RDS instance runs.
DescribeDTCSecurityIpHostsForSQLServer Queries the distributed transaction whitelists of an ApsaraDB RDS instance.
ModifyDTCSecurityIpHostsForSQLServer Configures a distributed transaction whitelist for an ApsaraDB RDS instance.
DescribeDBInstanceEncryptionKey Queries the status of the disk encryption feature for an ApsaraDB RDS instance and the key that is used for disk encryption.
CreateServiceLinkedRole Creates a service-linked role.
ModifyDBInstanceDeletionProtection Enables or disables the release protection feature for an ApsaraDB RDS instance.

Logs

API Description
ModifySQLCollectorPolicy Enables or disables the SQL Explorer (SQL Audit) feature for an ApsaraDB RDS instance.
DescribeSQLCollectorPolicy Queries the status of the SQL Explorer (SQL Audit) feature for an ApsaraDB RDS instance.
DescribeSQLLogRecords Queries the audit logs that are generated by the SQL Explorer (SQL Audit) feature for an ApsaraDB RDS instance.
DescribeSQLLogFiles Queries the audit log files that are generated by the SQL Explorer (SQL Audit) feature for an ApsaraDB RDS instance.
ModifySQLCollectorRetention Modifies the retention period of the audit log files that are generated by the SQL Explorer feature for an ApsaraDB RDS instance.
DescribeSQLCollectorRetention Queries the retention period of the audit log files that are generated by the SQL Explorer feature for an ApsaraDB RDS instance.
DescribeSlowLogs Queries the summary of the slow query logs of an ApsaraDB RDS instance.
DescribeSlowLogRecords Queries the details about the slow query logs of an ApsaraDB RDS instance.
DescribeErrorLogs Queries the error logs of an ApsaraDB RDS instance over a specific time range.
PurgeDBInstanceLog Deletes or compresses the logs of an ApsaraDB RDS instance.
DescribeSQLLogReports Queries the SQL log report of an ApsaraDB RDS instance.
DescribeSQLLogReportList Queries the SQL log reports of an ApsaraDB RDS instance.

Backups

API Description
CreateBackup You can create a backup set.
DescribeBackups Retrieves a list of backup sets.
DescribeDetachedBackups View the backup sets for deleted instances.
DescribeBackupPolicy Queries the backup settings of an ApsaraDB RDS instance.
ModifyBackupPolicy You can modify the backup settings.
DeleteBackup Delete data backup files.
DescribeBackupTasks Queries the backup tasks of an ApsaraDB RDS instance.
DescribeBinlogFiles You can query binary logs.

Restoration

API Description
RecoveryDBInstance Recover the database.
CloneDBInstance Restores the data of an ApsaraDB RDS instance to a new RDS instance. The new RDS instance is called a cloned instance.
CreateTempDBInstance You can create a temporary instance.
DescribeLocalAvailableRecoveryTime Queries the time range within which you can restore data using a backup file of an ApsaraDB RDS instance.
RestoreTable Restores one or more databases or tables of an ApsaraDB RDS instance to the original ApsaraDB RDS instance.
DescribeMetaList Queries information about the databases and tables that can be restored from a data backup file.

Cross-region backup and restoration

API Description
CheckCreateDdrDBInstance Checks whether the data of an ApsaraDB RDS instance can be restored using a cross-region data backup file.
CreateDdrInstance Restores the data of an ApsaraDB RDS instance to a new ApsaraDB RDS instance that resides in a different region than the region in which the original ApsaraDB RDS instance resides.
RestoreDdrTable Restores the data of an ApsaraDB RDS instance to an existing RDS instance that resides in a different region than the region in which the original ApsaraDB RDS instance resides.
ModifyInstanceCrossBackupPolicy Modifies the cross-region backup settings of an ApsaraDB RDS instance.
DescribeInstanceCrossBackupPolicy Queries the cross-region backup settings of an ApsaraDB RDS instance.
DescribeCrossBackupMetaList Queries information about the databases and tables whose data is included in a cross-region backup file.
DescribeCrossRegionBackups Queries the cross-region data backup files of an ApsaraDB RDS instance.
DescribeCrossRegionLogBackupFiles Queries the cross-region log backup files of an ApsaraDB RDS instance.
DescribeAvailableCrossRegion Queries the available destination regions to which the cross-region backup files from a specific source region can be replicated.
DescribeAvailableRecoveryTime Queries the time range within which you can restore data using a cross-region backup file.
DescribeCrossRegionBackupDBInstance Queries the ApsaraDB RDS instances for which the cross-region backup feature is enabled in a region and the cross-region backup settings of these instances.

Monitoring

API Description
DescribeResourceUsage Queries the storage usage of an ApsaraDB RDS instance.
DescribeDBInstancePerformance Queries the performance data of an ApsaraDB RDS instance.
DescribeDBInstanceMonitor The frequency of monitoring.
ModifyDBInstanceMonitor Change the monitoring frequency.
DescribeAvailableMetrics Queries all enhanced monitoring metrics that are available to an ApsaraDB RDS for PostgreSQL instance.
ModifyDBInstanceMetrics Modifies the enhanced monitoring metrics that are displayed for an ApsaraDB RDS for PostgreSQL instance
DescribeDBInstanceMetrics Queries the enhanced monitoring metrics that are enabled for an ApsaraDB RDS for PostgreSQL instance.

Parameters

API Description
DescribeParameters Queries the parameter settings of an ApsaraDB RDS instance.
ModifyParameter Modifies the parameters of an ApsaraDB RDS instance.
DescribeModifyParameterLog Queries the parameter modification logs of an ApsaraDB RDS instance.
DescribeParameterTemplates Queries the parameter templates that are available to an ApsaraDB RDS instance.
CreateParameterGroup Creates a parameter template.
ModifyParameterGroup Modifies a parameter template.
CloneParameterGroup Replicates a parameter template to the current region or to another region.
DescribeParameterGroups Queries the available parameter templates in a region.
DescribeParameterGroup Queries the details about a parameter template.
DeleteParameterGroup Deletes a parameter template.

Data migration

API Description
ImportDatabaseBetweenInstances You can migrate data from other RDS instances.
CancelImport Cancels a data migration task of an ApsaraDB RDS for SQL Server instance.

Migration of MySQL backup files to the cloud

API Description
ImportUserBackupFile Imports backup data from a self-managed MySQL database to ApsaraDB RDS.
UpdateUserBackupFile Modifies the description and retention period of a user backup.
ListUserBackupFiles Queries the details of all user backups that are imported to ApsaraDB RDS.
DeleteUserBackupFile Deletes a specified user backup.

Cloud migration of backup files (SQL Server)

API Description
CreateMigrateTask Restores the data of a backup file from an Object Storage Service (OSS) bucket to an ApsaraDB RDS instance.
DescribeMigrateTasks Queries the backup data migration tasks of an ApsaraDB RDS instance.
DescribeOssDownloads Queries the backup files that are included in a backup data migration task of an ApsaraDB RDS instance.
CreateOnlineDatabaseTask Opens the database that is included in a backup data migration task of an ApsaraDB RDS for SQL Server instance.
DescribeMigrateTaskById Queries a single task that is used to migrate the backup data of an ApsaraDB RDS for SQL Server instance to an OSS bucket.
TerminateMigrateTask Cancels a data migration task of an ApsaraDB RDS instance.

SQL Server Active Directory domain

API Description
ModifyADInfo Modifies the AD domain information about an ApsaraDB RDS for SQL Server instance.
DeleteADSetting Deletes the AD domain information about an ApsaraDB RDS for SQL Server instance.
DescribeADInfo Queries the AD domain information of about ApsaraDB RDS for SQL Server instance.

SQL Server cluster management

API Description
AllocateReadWriteSplittingConnection Applies for a read/write splitting endpoint for an ApsaraDB RDS instance.
ReleaseReadWriteSplittingConnection Releases the read/write splitting endpoint of an ApsaraDB RDS instance.
CalculateDBInstanceWeight Queries the system-assigned read weights.
ModifyReadWriteSplittingConnection Changes the latency threshold of the read/write splitting link and the read weights of a primary ApsaraDB RDS instance and its read-only ApsaraDB RDS instances.

Cloud migration to an ApsaraDB RDS for PostgreSQL instance

API Description
CreateCloudMigrationPrecheckTask Creates an assessment task for cloud migration to an ApsaraDB RDS for PostgreSQL instance.
DescribeCloudMigrationPrecheckResult View the one-click cloud migration pre-check report.
CreateCloudMigrationTask Creates a cloud migration task for an ApsaraDB RDS for PostgreSQL instance.
ActivateMigrationTargetInstance Switches workloads over from the source PostgreSQL instance to the destination ApsaraDB RDS for PostgreSQL instance.
DescribeCloudMigrationResult Queries the details about a cloud migration task for an ApsaraDB RDS for PostgreSQL instance.

Global active database cluster

API Description
DescribeGadInstances Queries a list of global active database clusters or the details of a specified cluster.
CreateGADInstance Creates a global active database cluster.
CreateGadInstanceMember Adds a unit node to a global active database cluster.
DeleteGadInstance Deletes a global active database cluster.
DetachGadInstanceMemer Removes a unit node from a global active database cluster.

Tags

API Description
TagResources Creates and adds tags to one or more ApsaraDB RDS instances.
UntagResources Removes tags from one or more ApsaraDB RDS instances.
ListTagResources Queries the tags that are added to one or more ApsaraDB RDS instances.