API overview

更新时间:
复制 MD 格式

API standard and pre-built SDKs in multi-language

The OpenAPI specification of this product (clickhouse/2023-05-22) follows the RPC standard. Alibaba Cloud provides pre-built SDKs for popular programming languages to abstract low-level complexities such as request signing. This enables developers to call APIs using language-specific syntax without dealing with HTTP details directly.

Custom signature

If your specific needs, such as a customized signature, are not supported by the SDK, manually sign requests using the signature mechanism. Note that manual signing requires significant effort (usually about 5 business days). For support, join our DingTalk group (ID: 147535001692).

Before you begin

An Alibaba Cloud account has full administrative privileges. A compromised AccessKey pair exposes all associated resources to unauthorized access, posing a significant security risk. To call APIs securely, create a Resource Access Management (RAM) user with API access only, configure its AccessKey pairs, and implement the principle of least privilege (PoLP) through RAM policies. Use the Alibaba Cloud account only when its permissions are explicitly required for specific scenarios.

Database Management

API

Title

Description

CreateDB CreateDB Creates a database.
DeleteDB DeleteDB Call this operation to delete a database.

Task and log management

API

Title

Description

DescribeProcessList DescribeProcessList Describes currently running queries.
KillProcess KillProcess Terminates a running task.
DescribeSlowLogTrend DescribeSlowLogTrend Queries the slow log trend.
DescribeSlowLogRecords DescribeSlowLogRecords Call DescribeSlowLogRecords to query slow log records.

Others

API

Title

Description

AttachWhitelistTemplateToInstance AttachWhitelistTemplateToInstance Attaches a whitelist template to instances.
ChangeResourceGroup ChangeResourceGroup Changes the resource group of a ClickHouse Enterprise instance.
CreateAccount CreateAccount Creates a database account for an ApsaraDB for ClickHouse Enterprise Edition cluster.
CreateBackupPolicy CreateBackupPolicy Creates a backup policy for a specified ClickHouse Enterprise Edition cluster.
CreateDBInstance CreateDBInstance To create a ClickHouse Enterprise Edition cluster, call the `CreateDBInstance` API.
CreateEndpoint CreateEndpoint Creates a public endpoint that provides a public address to access a cluster.
CreateWhitelistTemplate CreateWhitelistTemplate Creates a whitelist template.
DeleteAccount DeleteAccount Deletes a database account from an ApsaraDB for ClickHouse cluster.
DeleteBackupPolicy DeleteBackupPolicy Deletes the backup policy for a ClickHouse Enterprise Edition cluster.
DeleteDBInstance DeleteDBInstance The DeleteDBInstance operation releases an ApsaraDB for ClickHouse Enterprise Edition cluster.
DeleteEndpoint DeleteEndpoint Deletes a public endpoint.
DeleteWhitelistTemplate DeleteWhitelistTemplate Deletes a whitelist template.
DescribeAccountAuthority DescribeAccountAuthority Call the DescribeAccountAuthority operation to query the permissions of an account.
DescribeAccounts DescribeAccounts Queries database accounts for an ApsaraDB for ClickHouse cluster.
DescribeBackupPolicy DescribeBackupPolicy Queries the backup policy of a ClickHouse Enterprise Edition cluster.
DescribeBackups DescribeBackups Queries the backup sets of a ClickHouse Enterprise Edition cluster.
DescribeDBInstanceAttribute DescribeDBInstanceAttribute Call DescribeDBInstanceAttribute to query the details of an ApsaraDB for ClickHouse enterprise edition cluster.
DescribeDBInstanceConfig DescribeDBInstanceConfig Queries the parameter configuration of an instance
DescribeDBInstanceDataSources DescribeDBInstanceDataSources Queries the schema of a database or a table.
DescribeDBInstances DescribeDBInstances Call the DescribeDBInstances API to query a list of DB instances.
DescribeEndpoints DescribeEndpoints To retrieve the cluster endpoints, call DescribeEndpoints.
DescribeRegions DescribeRegions Returns information about the available regions and zones for ApsaraDB for ClickHouse.
DescribeSecurityIPList DescribeSecurityIPList Queries a whitelist.
DetachWhitelistTemplateToInstance DetachWhitelistTemplateToInstance Disassociate a whitelist template from an instance.
GetWhitelistTemplate GetWhitelistTemplate Queries the details of a whitelist template.
ListClickHouseDBTimezones ListClickHouseDBTimezones Lists the available time zones for ClickHouse.
ListInstanceLinkedWhitelistTemplates ListInstanceLinkedWhitelistTemplates Lists the IP address whitelist templates linked to an instance.
ListWhitelistTemplates ListWhitelistTemplates Queries the whitelist templates associated with an instance.
ModifyAccountAuthority ModifyAccountAuthority Modifies the permissions of a database account.
ModifyAccountDescription ModifyAccountDescription Modifies the description of a database account.
ModifyBackupPolicy ModifyBackupPolicy Modifies the backup policy of an ApsaraDB for ClickHouse cluster.
ModifyDBInstanceAttribute ModifyDBInstanceAttribute You can call the ModifyDBInstanceAttribute operation to modify the configuration of a cluster.
ModifyDBInstanceClass ModifyDBInstanceClass Call the ModifyDBInstanceClass API to modify the scaling configuration of a cluster.
ModifyDBInstanceConfig ModifyDBInstanceConfig Modifies the parameter settings for a DB instance.
ModifyDBInstanceConnectionString ModifyDBInstanceConnectionString Modifies the connection string of a cluster.
ModifySecurityIPList ModifySecurityIPList Modifies the whitelist settings of an ApsaraDB for ClickHouse cluster.
ResetAccountPassword ResetAccountPassword Resets the password of a database account for an ApsaraDB for ClickHouse Enterprise Edition cluster.
RestartDBInstance RestartDBInstance Restarts an ApsaraDB for ClickHouse Enterprise Edition cluster.
StartDBInstance StartDBInstance Starts an ApsaraDB for ClickHouse Enterprise Edition cluster.
StopDBInstance StopDBInstance Stops an ApsaraDB for ClickHouse Enterprise Edition cluster.
UpdateWhitelistTemplate UpdateWhitelistTemplate Updates a whitelist template.
UpgradeMinorVersion UpgradeMinorVersion Updates the minor engine version of an ApsaraDB for ClickHouse cluster that runs Enterprise Edition.