All Products
Search
Document Center

PolarDB:List of operations by function

Last Updated:Nov 21, 2024
This product(polardb/2017-08-01) OpenAPI adopts RPC Signature style. See signature details in Description of the signature mechanism. We have packaged SDKs for common programming languages for developers. Developers can directly call the OpenAPI of this product by downloading the SDK without paying attention to the technical details. If the existing SDK cannot meet the usage requirements, you can connect through the signature mechanism. It will take about 5 working days. Therefore, it is recommended to join our DingTalk service group (78410016550) and sign under the guidance of experts.
Before using the API, you need to prepare your identity account and access key (AccessKey) to effectively access the API through client tools (SDK, CLI, etc.). For details see getAccessKey.

Sales management

APITitleDescription
CreateStoragePlanCreateStoragePlanPurchases a storage plan.
DescribeAutoRenewAttributeDescribeAutoRenewAttributeQueries the auto-renewal attributes of a subscription PolarDB cluster.
DescribeClassListDescribeClassListQueries the specifications of a cluster.
DescribeDBClusterAvailableResourcesDescribeDBClusterAvailableResourcesQueries available resources in a PolarDB cluster.
EvaluateRegionResourceEvaluateRegionResourceEvaluates available resources.
ModifyAutoRenewAttributeModifyAutoRenewAttributeModifies the auto-renewal attributes of a subscription PolarDB cluster.
TransformDBClusterPayTypeTransformDBClusterPayTypeChanges the billing method of a PolarDB cluster.

Cluster management

APITitleDescription
CreateDBClusterCreateDBClusterCreate Database Cluster
DeleteDBClusterDeleteDBClusterReleases a pay-as-you-go PolarDB cluster.
DescribeDBClustersDescribeDBClustersQueries PolarDB clusters or the clusters that can be accessed by an authorized RAM user.
DescribeDBClusterAttributeDescribeDBClusterAttributeQueries information about a PolarDB cluster.
DescribeDBClusterServerlessConfDescribeDBClusterServerlessConfQuery serverless configuration.
DescribePolarSQLCollectorPolicyDescribePolarSQLCollectorPolicyQueries whether the SQL Explorer feature is enabled for the cluster.
DescribeRegionsDescribeRegionsQueries the regions and zones that are supported by PolarDB.
DescribeTasksDescribeTasksQueries the status of the tasks that are generated based on API operations, such as the status of instance creation tasks.
DescribeVSwitchesDescribeVSwitchesQueries a vSwitch.
ModifyDBClusterModifyDBClusterModifies the configurations of a PolarDB for MySQL cluster.
ModifyDBClusterDescriptionModifyDBClusterDescriptionModifies the name of a PolarDB cluster.
ModifyDBClusterDeletionModifyDBClusterDeletionEnables or disables the cluster lock feature.
ModifyDBClusterMaintainTimeModifyDBClusterMaintainTimeModifies the maintenance window of a PolarDB cluster.
EnableDBClusterServerlessEnableDBClusterServerlessEnables a stable serverless cluster.
DisableDBClusterServerlessDisableDBClusterServerlessDisables a stable serverless cluster.
ModifyDBClusterServerlessConfModifyDBClusterServerlessConfModifies the configurations of a serverless cluster.
ModifyDBClusterStorageSpaceModifyDBClusterStorageSpaceChanges the storage capacity of a pay-as-you-go cluster of Enterprise Edition or a cluster of Standard Edition.
ManuallyStartDBClusterManuallyStartDBClusterManually starts a cluster.

High-availability deployment architecture

APITitleDescription
ModifyDBClusterPrimaryZoneModifyDBClusterPrimaryZoneChanges the primary zone of a PolarDB cluster.
FailoverDBClusterFailoverDBClusterPerforms a manual failover to promote a read-only node to the primary node in a PolarDB cluster.

Engine versions management

APITitleDescription
DescribeDBClusterVersionDescribeDBClusterVersionQueries the information about the database engine version of a PolarDB for MySQL cluster.
UpgradeDBClusterVersionUpgradeDBClusterVersionUpgrades the kernel version of a PolarDB for MySQL cluster.

Whitelist management

APITitleDescription
DescribeDBClusterAccessWhitelistDescribeDBClusterAccessWhitelistQueries the IP address whitelists and security groups of a PolarDB cluster.
ModifyDBClusterAccessWhitelistModifyDBClusterAccessWhitelistCreates or modifies the whitelists (IP whitelists and security groups) of a specified cluster.

Global IP whitelist template management

APITitleDescription
CreateGlobalSecurityIPGroupCreateGlobalSecurityIPGroupCreates a global IP whitelist template.
DeleteGlobalSecurityIPGroupDeleteGlobalSecurityIPGroupDeletes a global IP whitelist template.
DescribeGlobalSecurityIPGroupDescribeGlobalSecurityIPGroupQueries global IP whitelist templates.
DescribeGlobalSecurityIPGroupRelationDescribeGlobalSecurityIPGroupRelationQueries the relationship between a cluster and a global IP whitelist template.
ModifyGlobalSecurityIPGroupModifyGlobalSecurityIPGroupModifies an IP whitelist template.
ModifyGlobalSecurityIPGroupNameModifyGlobalSecurityIPGroupNameModifies the name of a global IP whitelist template.
ModifyGlobalSecurityIPGroupRelationModifyGlobalSecurityIPGroupRelationModifies the relationship between a cluster and a global IP whitelist template.

SSL encryption

APITitleDescription
DescribeDBClusterSSLDescribeDBClusterSSLQueries the Secure Sockets Layer (SSL) settings of a PolarDB cluster.
ModifyDBClusterSSLModifyDBClusterSSLEnables or disables the SSL encryption feature for a PolarDB cluster, or updates the CA certificate of the cluster.

TDE

APITitleDescription
CheckKMSAuthorizedCheckKMSAuthorizedQueries whether a user is authorized to use Key Management Service (KMS).
DescribeDBClusterTDEDescribeDBClusterTDEQueries the transparent data encryption (TDE) settings of a PolarDB cluster.
DescribeUserEncryptionKeyListDescribeUserEncryptionKeyListQueries the Key Management Service (KMS)-managed customer master keys (CMKs) that are used to encrypt data in a PolarDB cluster.
ModifyDBClusterTDEModifyDBClusterTDEEnables the transparent data encryption (TDE) feature for a PolarDB cluster.

Node management

APITitleDescription
CreateDBNodesCreateDBNodesAdds a read-only node to a PolarDB cluster.
DeleteDBNodesDeleteDBNodesDeletes a read-only node from a PolarDB cluster.
ModifyDBNodeClassModifyDBNodeClassChanges the node specifications of a PolarDB cluster.
ModifyDBNodesClassModifyDBNodesClassChanges the specifications of a node in a PolarDB cluster.
ModifyDBNodeHotReplicaModeModifyDBNodeHotReplicaModeEnables or disables the failover with hot replica feature for a node in a cluster.
RestartDBNodeRestartDBNodeRestarts a node in a PolarDB cluster.
TempModifyDBNodeTempModifyDBNodeTemporarily changes the node configurations.
TempModifyDBNodeTempModifyDBNode

Cluster parameters management

APITitleDescription
CreateParameterGroupCreateParameterGroupCreates a parameter template.
DescribeDBClusterParametersDescribeDBClusterParametersQueries the parameters of a PolarDB cluster.
DescribeDBNodesParametersDescribeDBNodesParametersQueries the parameters of a specified node in a cluster.
DescribeParameterTemplatesDescribeParameterTemplatesQueries the default parameters in a cluster.
DescribeParameterGroupsDescribeParameterGroupsQueries parameter templates that are available in a specified region.
DescribeParameterGroupDescribeParameterGroupQueries the information about a parameter template.
DeleteParameterGroupDeleteParameterGroupDeletes a parameter template from a PolarDB cluster.
ModifyDBClusterAndNodesParametersModifyDBClusterAndNodesParametersModifies cluster parameters and applies them to specified nodes.
ModifyDBClusterParametersModifyDBClusterParametersModifies the parameters of a specified PolarDB cluster or applies existing parameter templates to a specified cluster.
ModifyDBNodesParametersModifyDBNodesParametersModifies the parameter settings of a node and applies the new settings to another specified node.

Connection points management

APITitleDescription
CreateDBClusterEndpointCreateDBClusterEndpointCreates a custom cluster endpoint for a PolarDB cluster.
CreateDBEndpointAddressCreateDBEndpointAddressCreates a public endpoint for the primary endpoint, the default cluster endpoint, or a custom cluster endpoint.
DescribeDBClusterEndpointsDescribeDBClusterEndpointsQueries the endpoints of a PolarDB cluster.
ModifyDBClusterEndpointModifyDBClusterEndpointModifies the attributes of a specified PolarDB cluster endpoint. For example, you can modify the following attributes for the specified cluster endpoint: read/write mode, consistency level, transaction splitting, primary node accepts read requests, and connection pool. You can also call the operation to specify whether newly added nodes are automatically associated with the specified cluster endpoint.
ModifyDBEndpointAddressModifyDBEndpointAddressModifies the endpoints of a PolarDB cluster, including the primary endpoint, default cluster endpoint, custom cluster endpoint, and private domain name.
DeleteDBClusterEndpointDeleteDBClusterEndpointReleases a custom cluster endpoint of a PolarDB cluster.
DeleteDBEndpointAddressDeleteDBEndpointAddressReleases the public endpoints of a PolarDB cluster, including the primary endpoint, default cluster endpoint, and custom cluster endpoint.

Logs management

APITitleDescription
DescribeSlowLogRecordsDescribeSlowLogRecordsSlow Log Details
DescribeSlowLogsDescribeSlowLogsQueries the statistics about the slow query logs of a PolarDB cluster.
DescribeDBClusterAuditLogCollectorDescribeDBClusterAuditLogCollectorQueries the SQL collection features of a PolarDB cluster, such as audit logs and SQL Explorer and Audit.
ModifyDBClusterAuditLogCollectorModifyDBClusterAuditLogCollectorEnables or disables SQL collector for a PolarDB cluster. Features related to SQL collector include audit log and SQL Explorer. By default, when you call this operation to enable SQL collector for a PolarDB cluster in a region that supports DAS Enterprise Edition, the latest DAS Enterprise Edition supported by the region is enabled. For information about the database engines and regions supported by each DAS Enterprise edition, see the "Supported databases and regions" section of the "Editions and supported features" topic.

Account management

APITitleDescription
CreateAccountCreateAccountCreates a database account for a PolarDB cluster.
CheckAccountNameCheckAccountNameChecks whether an account name is valid or unique in a cluster.
DescribeAccountsDescribeAccountsQueries information about a database account of a PolarDB cluster.
ModifyAccountDescriptionModifyAccountDescriptionModifies the description of a database account of a PolarDB cluster.
GrantAccountPrivilegeGrantAccountPrivilegeGrants a standard account the permissions to access one or more databases in a PolarDB cluster.
RevokeAccountPrivilegeRevokeAccountPrivilegeRevokes access permissions on one or more databases for a standard account of a PolarDB cluster.
ResetAccountResetAccountResets the permissions of a privileged account for a PolarDB cluster.
DeleteAccountDeleteAccountDeletes a database account for a PolarDB cluster.
ModifyAccountPasswordModifyAccountPasswordChanges the password of a database account for a specified PolarDB cluster.

Database management

APITitleDescription
CreateDatabaseCreateDatabaseCreates a database for a PolarDB cluster.
DeleteDatabaseDeleteDatabaseDeletes a database from a PolarDB cluster.
DescribeDatabasesDescribeDatabasesQueries the information about databases in a PolarDB cluster.
DescribeCharacterSetNameDescribeCharacterSetNameQueries character sets that are supported by a PolarDB for MySQL cluster.
CheckDBNameCheckDBNameChecks whether a database name is valid or whether the name is already used by another database in the current cluster.
DescribeDBInitializeVariableDescribeDBInitializeVariableQueries attributes such as character sets and collations supported by a database in a PolarDB cluster.
ModifyDBDescriptionModifyDBDescriptionModifies the description of a database in a PolarDB for MySQL cluster.

Global Database Network (GDN) management

APITitleDescription
CreateGlobalDatabaseNetworkCreateGlobalDatabaseNetworkCreates a global database network (GDN).
DeleteGlobalDatabaseNetworkDeleteGlobalDatabaseNetworkDeletes a global database network (GDN).
DescribeGlobalDatabaseNetworkDescribeGlobalDatabaseNetworkQueries the information about a Global Database Network (GDN).
DescribeGlobalDatabaseNetworksDescribeGlobalDatabaseNetworksQueries the information about all Global Database Networks (GDNs) that belong to an account.
ModifyGlobalDatabaseNetworkModifyGlobalDatabaseNetworkModifies a global database network (GDN).
RemoveDBClusterFromGDNRemoveDBClusterFromGDNRemoves secondary clusters from a Global Database Network (GDN).
SwitchOverGlobalDatabaseNetworkSwitchOverGlobalDatabaseNetworkSwitches over the primary and secondary clusters in a global database network (GDN).
ResetGlobalDatabaseNetworkResetGlobalDatabaseNetworkRebuilds a secondary cluster in a Global Database Network (GDN).

Backup management

APITitleDescription
CreateBackupCreateBackupCreates a full snapshot backup for a PolarDB cluster.
DescribeBackupsDescribeBackupsQueries the backup details of a PolarDB cluster.
DescribeBackupTasksDescribeBackupTasksQueries the details of backup tasks of a cluster.
DescribeBackupLogsDescribeBackupLogsQueries backup logs and the URLs to download the backup logs.
DescribeDetachedBackupsDescribeDetachedBackupsQueries the information about the backup sets in a released PolarDB cluster.
DescribeDBClustersWithBackupsDescribeDBClustersWithBackupsQueries the information about PolarDB clusters that contain backup sets in a region.
DeleteBackupDeleteBackupDeletes the backup sets of a PolarDB cluster.
Backup policyBackup policy
DescribeBackupPolicyDescribeBackupPolicyQueries the automatic backup policy of a PolarDB cluster.
DescribeLogBackupPolicyDescribeLogBackupPolicyQueries the retention policy of log backups in a PolarDB cluster.
ModifyBackupPolicyModifyBackupPolicyModifies the automatic backup policy of a PolarDB cluster.
ModifyLogBackupPolicyModifyLogBackupPolicyModifies the retention policy of the log backups in a PolarDB cluster.

Restore management

APITitleDescription
DescribeMetaListDescribeMetaListQueries the details of the databases or tables that can be restored.
RestoreTableRestoreTableRestores PolarDB databases and tables.

Data migration from RDS

APITitleDescription
DescribeDBClusterMigrationDescribeDBClusterMigrationThe ID of the synchronous task.
ModifyDBClusterMigrationModifyDBClusterMigrationSwitches or rolls back the task that migrates data from an ApsaraDB for RDS instance to a PolarDB cluster.
CloseDBClusterMigrationCloseDBClusterMigrationCancels or completes the migration task that upgrades an RDS cluster to a PolarDB cluster.

Tag management

APITitleDescription
TagResourcesTagResourcesCreates tags for a PolarDB cluster.
UntagResourcesUntagResourcesUnbinds tags from PolarDB clusters.
ListTagResourcesListTagResourcesQueries the tags that are added to one or more PolarDB clusters, or the PolarDB clusters to which one or more tags are added.

Pending events management

APITitleDescription
DescribePendingMaintenanceActionDescribePendingMaintenanceActionQueries the information about a pending event.
DescribePendingMaintenanceActionsDescribePendingMaintenanceActionsQueries the numbers of pending events of different task types.
ModifyPendingMaintenanceActionModifyPendingMaintenanceActionModifies the switching time of a pending event.

Scheduled tasks management

APITitleDescription
DescribeScheduleTasksDescribeScheduleTasksQueries the details of all scheduled tasks.
CancelScheduleTasksCancelScheduleTasksCancels scheduled tasks that are not yet started.

Masking rules management

APITitleDescription
DescribeMaskingRulesDescribeMaskingRulesQueries the data masking rules of a PolarDB cluster or the information about a specified masking rule.
ModifyMaskingRulesModifyMaskingRulesModifies or adds a data masking rule.
DeleteMaskingRulesDeleteMaskingRulesDeletes a data masking rule.

Monitoring management

APITitleDescription
DescribeDBNodePerformanceDescribeDBNodePerformanceQueries the performance data of a node in a PolarDB cluster.
DescribeDBClusterPerformanceDescribeDBClusterPerformanceQueries the performance data of a PolarDB cluster.
DescribeDBProxyPerformanceDescribeDBProxyPerformanceQueries the performance data of PolarProxy.
DescribeDBClusterMonitorDescribeDBClusterMonitorQueries the interval at which the monitoring data of a PolarDB cluster is collected.
ModifyDBClusterMonitorModifyDBClusterMonitorModifies the interval at which the monitoring data of a PolarDB cluster is collected.

PolarDB for AI

APITitleDescription
DescribeAITaskStatusDescribeAITaskStatusQueries the status of the PolarDB for AI feature.
OpenAITaskOpenAITaskEnables the PolarDB for AI feature for a cluster.
CloseAITask CloseAITaskDisables the PolarDB for AI feature for a cluster.

DBLink

APITitleDescription
CreateDBLinkCreateDBLinkCreates a database link.
RestartDBLinkRestartDBLinkRestarts database links.
DeleteDBLinkDeleteDBLinkDeletes a database link from a PolarDB for Oracle cluster.
DescribeDBLinksDescribeDBLinksQueries the database links of a PolarDB for Oracle cluster.

Connection diagnosis

APITitleDescription
DescribeDBClusterConnectivityDescribeDBClusterConnectivityQueries whether the source IP address can access a cluster.

Others

APITitleDescription
DescribeDasConfigDescribeDasConfigQueries the configurations of a cluster in Database Autonomy Service (DAS).