From 1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634 Mon Sep 17 00:00:00 2001 From: Zhineng Li Date: Sun, 12 Jul 2026 17:11:17 +0800 Subject: update APIs 20260712 --- data/en_us/clickhouse/2019-11-11/api-docs.php | 17323 +++++++++++------------- data/en_us/clickhouse/2023-05-22/api-docs.php | 11242 +++++++-------- 2 files changed, 13607 insertions(+), 14958 deletions(-) (limited to 'data/en_us/clickhouse') diff --git a/data/en_us/clickhouse/2019-11-11/api-docs.php b/data/en_us/clickhouse/2019-11-11/api-docs.php index 52e39f8..cf821b8 100644 --- a/data/en_us/clickhouse/2019-11-11/api-docs.php +++ b/data/en_us/clickhouse/2019-11-11/api-docs.php @@ -1,263 +1,164 @@ '1.0', - 'info' => [ - 'style' => 'RPC', - 'product' => 'clickhouse', - 'version' => '2019-11-11', - ], + 'info' => ['style' => 'RPC', 'product' => 'clickhouse', 'version' => '2019-11-11'], 'directories' => [ [ - 'id' => 182889, - 'title' => 'Geographical Management', - 'type' => 'directory', - 'children' => [ - 'DescribeRegions', - ], - ], - [ - 'id' => 165004, - 'title' => 'Cluster Management', - 'type' => 'directory', - 'children' => [ - 'CreateDBInstance', - 'DeleteDBCluster', - 'DescribeDBClusters', - 'DescribeDBClusterAttribute', - 'DescribeDBClusterConfig', - 'ModifyDBClusterConfig', - 'DescribeDBConfig', - 'ModifyDBCluster', - 'ModifyDBClusterDescription', - 'ModifyDBClusterMaintainTime', - 'DescribeAllDataSources', - 'DescribeAllDataSource', - 'DescribeSchemas', - 'DescribeTables', - 'DescribeColumns', - 'RestartInstance', - 'CheckScaleOutBalanced', - 'CreateOSSStorage', - 'DescribeOSSStorage', - 'CheckClickhouseToRDS', - 'DescribeSynDbs', - 'DescribeSynDbTables', - 'DeleteSyndb', - 'DescribeTransferHistory', - 'TransferVersion', - 'CreateServiceLinkedRole', - 'KillProcess', - 'DescribeSlowLogRecords', - 'DescribeDBClusterPerformance', - 'UpgradeMinorVersion', - 'DescribeDBClusterConfigInXML', - 'ModifyDBClusterConfigInXML', - 'CheckModifyConfigNeedRestart', - 'DescribeConfigHistory', - 'DescribeConfigVersionDifference', - 'CreateRDSToClickhouseDb', - 'ModifyDBConfig', - 'ModifyRDSToClickhouseDb', - 'DescribeProcessList', - ], - ], - [ - 'id' => 165006, - 'title' => 'Backup Management', - 'type' => 'directory', - 'children' => [ - 'CreateBackupPolicy', - 'ModifyBackupPolicy', - 'DescribeBackupPolicy', - 'DescribeBackups', - ], - ], - [ - 'id' => 182891, - 'title' => 'Network Management', + 'children' => ['CreatePortsForClickHouse', 'ReleaseClusterPublicConnection', 'AllocateClusterPublicConnection', 'DescribeDBClusterNetInfoItems'], 'type' => 'directory', - 'children' => [ - 'CreatePortsForClickHouse', - 'ReleaseClusterPublicConnection', - 'AllocateClusterPublicConnection', - 'DescribeDBClusterNetInfoItems', - ], + 'title' => 'Network management', ], [ - 'id' => 129255, - 'title' => 'Account Management', + 'children' => ['CreateSQLAccount', 'CreateAccountAndAuthority', 'DescribeAccountAuthority', 'ModifyAccountAuthority'], 'type' => 'directory', - 'children' => [ - 'DescribeAccounts', - 'CreateAccount', - 'CreateSQLAccount', - 'DeleteAccount', - 'ResetAccountPassword', - 'ModifyAccountDescription', - 'CreateAccountAndAuthority', - 'DescribeAccountAuthority', - 'ModifyAccountAuthority', - ], + 'title' => 'Account management', ], [ - 'id' => 182893, - 'title' => 'Safety Management', + 'children' => ['CreateMonitorDataReport', 'CheckMonitorAlert'], 'type' => 'directory', - 'children' => [ - 'DescribeDBClusterAccessWhiteList', - 'ModifyDBClusterAccessWhiteList', - 'CreateMonitorDataReport', - 'CheckMonitorAlert', - ], + 'title' => 'Security management', ], [ - 'id' => 186892, - 'title' => 'Other', - 'type' => 'directory', 'children' => [ - 'CheckServiceLinkedRole', - 'ModifyMinorVersionGreadeType', + 'ModifyMinorVersionGreadeType', 'CancelActiveOperationTasks', 'CancelAppointmentElectZookeeperLeader', 'CancelAppointmentRestartInstanceNodeList', 'CancelRestartInstance', 'ChangeResourceGroup', 'CheckClickhouseToRDS', 'CheckModifyConfigNeedRestart', 'CheckScaleOutBalanced', 'CheckServiceLinkedRole', 'CreateAccount', 'CreateBackupPolicy', 'CreateDBInstance', 'CreateOSSStorage', 'CreateRDSToClickhouseDb', 'CreateSLB', 'CreateServiceLinkedRole', 'DeleteAccount', 'DeleteBackupPolicy', 'DeleteDBCluster', + 'DeleteSLB', 'DeleteSyndb', 'DescribeAccounts', 'DescribeActiveOperationMaintainConf', 'DescribeActiveOperationTasks', 'DescribeAllDataSource', 'DescribeAllDataSources', 'DescribeAutoRenewAttribute', 'DescribeBackupPolicy', 'DescribeBackups', 'DescribeColumns', 'DescribeConfigHistory', 'DescribeConfigVersionDifference', 'DescribeDBClusterAccessWhiteList', 'DescribeDBClusterAttribute', 'DescribeDBClusterConfig', 'DescribeDBClusterConfigInXML', 'DescribeDBClusterNodeInfos', 'DescribeDBClusterPerformance', 'DescribeDBClusterStatusSet', + 'DescribeDBClusters', 'DescribeDBConfig', 'DescribeEventMetaInfo', 'DescribeOSSStorage', 'DescribeProcessList', 'DescribeRegions', 'DescribeSchemas', 'DescribeSlowLogRecords', 'DescribeSlowLogTrend', 'DescribeSynDbTables', 'DescribeSynDbs', 'DescribeTables', 'DescribeTransferHistory', 'DescribeUserEncryptionKeyList', 'ElectZookeeperLeader', 'KillProcess', 'ListTagResources', 'ModifyAccountDescription', 'ModifyActiveOperationMaintainConf', 'ModifyActiveOperationTasks', + 'ModifyAutoRenewAttribute', 'ModifyBackupPolicy', 'ModifyDBCluster', 'ModifyDBClusterAccessWhiteList', 'ModifyDBClusterConfig', 'ModifyDBClusterConfigInXML', 'ModifyDBClusterDescription', 'ModifyDBClusterMaintainTime', 'ModifyDBConfig', 'ModifyRDSToClickhouseDb', 'ResetAccountPassword', 'RestartInstance', 'RestartInstanceNodeList', 'TagResources', 'TransferVersion', 'UntagResources', 'UpgradeMinorVersion', ], - ], - [ - 'id' => 0, - 'title' => '其它', 'type' => 'directory', - 'children' => [ - 'DescribeSlowLogTrend', - 'DescribeDBClusterStatusSet', - 'CreateSLB', - 'DeleteSLB', - 'ChangeResourceGroup', - 'CancelRestartInstance', - 'UntagResources', - 'TagResources', - 'ListTagResources', - 'DeleteBackupPolicy', - 'ModifyActiveOperationTasks', - 'DescribeEventMetaInfo', - 'DescribeActiveOperationTasks', - 'CancelActiveOperationTasks', - 'DescribeActiveOperationMaintainConf', - 'ModifyActiveOperationMaintainConf', - 'DescribeAutoRenewAttribute', - 'ModifyAutoRenewAttribute', - 'DescribeUserEncryptionKeyList', - 'ElectZookeeperLeader', - 'DescribeDBClusterNodeInfos', - 'CancelAppointmentElectZookeeperLeader', - 'RestartInstanceNodeList', - 'CancelAppointmentRestartInstanceNodeList', - ], + 'title' => 'Others', ], ], 'components' => [ 'schemas' => [], ], 'apis' => [ - 'DescribeRegions' => [ - 'summary' => 'Queries the information about all regions and zones of ApsaraDB for ClickHouse clusters.', - 'methods' => [ - 'post', - 'get', + 'AllocateClusterPublicConnection' => [ + 'summary' => 'Allocates a public endpoint for a specified ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'abilityTreeCode' => '19418', + 'abilityTreeNodes' => ['FEATUREclickhouseZHDS8I'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], + ], + [ + 'name' => 'ConnectionStringPrefix', + 'in' => 'query', + 'schema' => ['description' => 'The prefix of the public endpoint. The value is the cluster ID.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'AllocateClusterPublicConnection', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'AllocateClusterPublicConnection'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:AllocateClusterPublicConnection', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\"\\n}","type":"json"}]', + ], + 'CancelActiveOperationTasks' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '19455', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'operationType' => 'none', + 'abilityTreeCode' => '201219', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], 'tenantRelevance' => 'publicInformation', ], - 'parameters' => [], + 'parameters' => [ + [ + 'name' => 'Ids', + 'in' => 'query', + 'schema' => ['description' => 'The O\\&M task IDs. Separate multiple IDs with a comma (,).', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '188****,188****,188****'."\n", 'title' => ''], + ], + ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], - 'Regions' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Region' => [ - 'description' => 'The queried regions.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Zones' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Zone' => [ - 'description' => 'The zones.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'ZoneId' => [ - 'description' => 'The zone ID.'."\n", - 'type' => 'string', - 'example' => 'cn-hangzhou-h', - ], - 'VpcEnabled' => [ - 'description' => 'Indicates whether Virtual Private Cloud (VPC) is supported in the zone. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - ], - ], - ], - ], - ], - 'RegionId' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - ], - ], - ], - ], - ], + 'Ids' => ['description' => 'The IDs of the O\\&M tasks that were canceled. Multiple IDs are separated by a comma (,).', 'type' => 'string', 'example' => '188****,188****,188****'."\n", 'title' => ''], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '94F92113-FF63-5E57-8401-6FE123AD11DD', 'title' => ''], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"Regions\\": {\\n \\"Region\\": [\\n {\\n \\"Zones\\": {\\n \\"Zone\\": [\\n {\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"VpcEnabled\\": true\\n }\\n ]\\n },\\n \\"RegionId\\": \\"cn-hangzhou\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n F5178C10-1407-4987-9133-DE4DC9119F75\\n \\n \\n cn-hangzhou-h\\n true\\n \\n cn-hangzhou\\n \\n","errorExample":""}]', - 'title' => 'DescribeRegions', - ], - 'CreateDBInstance' => [ - 'summary' => 'Creates an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'CancelActiveOperationTasks', + 'summary' => 'Cancels tasks for O&M events.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Ids\\": \\"188****,188****,188****\\\\n\\",\\n \\"RequestId\\": \\"94F92113-FF63-5E57-8401-6FE123AD11DD\\"\\n}","type":"json"}]', + ], + 'CancelAppointmentElectZookeeperLeader' => [ + 'summary' => 'Cancels a scheduled ZooKeeper leader switchover on a community-compatible ClickHouse instance.', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -266,467 +167,279 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'update', 'riskType' => 'none', - 'chargeType' => 'paid', - 'abilityTreeCode' => '19424', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', - ], - 'tenantRelevance' => 'publicInformation', + 'chargeType' => 'free', + 'abilityTreeCode' => '173004', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'ZoneId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The zone ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent zone list.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou-h', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp108z124a8o7****', 'title' => ''], ], [ - 'name' => 'DBClusterVersion', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'The kernel version. Valid values:'."\n" - ."\n" - .'* **21.8.10.19**'."\n" - .'* **22.8.5.29**'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'enumValueTitles' => [ - '22.8.5.29' => '22.8.5.29', - '21.8.10.19' => '21.8.10.19', - ], - 'example' => '21.8.10.19', - ], + 'schema' => ['description' => 'The number of entries to return on each page. Valid values:'."\n" + ."\n" + .'- 30 (default)'."\n" + ."\n" + .'- 50'."\n" + ."\n" + .'- 100', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '30', 'example' => '30', 'title' => ''], ], [ - 'name' => 'DBClusterCategory', + 'name' => 'PageNumber', 'in' => 'query', + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'example' => '1', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The edition of the cluster. Valid values:'."\n" - ."\n" - .'* **Basic**: Single-replica Edition'."\n" - .'* **HighAvailability**: Double-replica Edition'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'enumValueTitles' => [ - 'Basic' => 'Basic', - 'HighAvailability' => 'HighAvailability', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '1F488A93-83FD-540F-9B67-0333AF64E6A0'], ], - 'example' => 'Basic', + 'title' => '', + 'description' => 'Schema of response.', + 'example' => '', ], ], - [ - 'name' => 'DBClusterClass', - 'in' => 'query', - 'schema' => [ - 'description' => 'The specifications of the cluster.'."\n" - ."\n" - .'* Valid values for a Single-replica Edition cluster:'."\n" - ."\n" - .' * **S8**: 8 cores and 32 GB of memory'."\n" - .' * **S16**: 16 cores and 64 GB of memory'."\n" - .' * **S32**: 32 cores and 128 GB of memory'."\n" - .' * **S64**: 64 cores and 256 GB of memory'."\n" - .' * **S104**: 104 cores and 384 GB of memory'."\n" - ."\n" - .'* Valid values for a Double-replica Edition cluster:'."\n" - ."\n" - .' * **C8**: 8 cores and 32 GB of memory'."\n" - .' * **C16**: 16 cores and 64 GB of memory'."\n" - .' * **C32**: 32 cores and 128 GB of memory'."\n" - .' * **C64**: 64 cores and 256 GB of memory'."\n" - .' * **C104**: 104 cores and 384 GB of memory'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'S8', - ], + ], + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'CancelAppointmentElectZookeeperLeader', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1F488A93-83FD-540F-9B67-0333AF64E6A0\\"\\n}","type":"json"}]', + ], + 'CancelAppointmentRestartInstanceNodeList' => [ + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'DBNodeGroupCount', - 'in' => 'query', - 'schema' => [ - 'description' => 'The number of nodes.'."\n" - ."\n" - .'* Valid values when the cluster is of Single-replica Edition: 1 to 48.'."\n" - .'* Valid values when the cluster is of Double-replica Edition: 1 to 24.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '1', - ], + 'AK' => [], ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '173004', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], + ], + 'parameters' => [ [ - 'name' => 'DBNodeStorage', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The storage capacity of a single node. Valid values: 100 to 32000. Unit: GB.'."\n" - ."\n" - .'> This value is a multiple of 100.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '100', - ], + 'schema' => ['description' => 'The region ID of the instance.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'DBClusterNetworkType', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The network type of the cluster. Only Virtual Private Cloud (VPC) is supported.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'VPC', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp108z124a8o7****', 'title' => ''], ], [ - 'name' => 'DBClusterDescription', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'The description of the cluster.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['description' => 'The number of entries per page. Valid values:'."\n" + ."\n" + .'- 30 (default)'."\n" + ."\n" + .'- 50'."\n" + ."\n" + .'- 100', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '30', 'example' => '30', 'title' => ''], ], [ - 'name' => 'PayType', + 'name' => 'PageNumber', 'in' => 'query', + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'example' => '1', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The billing method of the cluster. Valid values:'."\n" - ."\n" - .'* **Postpaid**: The cluster uses the pay-as-you-go billing method.'."\n" - .'* **Prepaid**: The cluster uses the subscription billing method.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'enumValueTitles' => [ - 'Prepaid' => 'Prepaid', - 'Postpaid' => 'Postpaid', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '1F488A93-83FD-540F-9B67-0333AF64E6A0'], ], - 'example' => 'Prepaid', + 'title' => '', + 'description' => 'Schema of response.', + 'example' => '', ], ], - [ - 'name' => 'Period', - 'in' => 'query', - 'schema' => [ - 'description' => 'The unit of the subscription duration for the cluster. Valid values:'."\n" - ."\n" - .'> This parameter is required only when PayType is set to Prepaid.'."\n" - ."\n" - .'* **Year**'."\n" - .'* **Month**'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'Month', - ], - ], - [ - 'name' => 'UsedTime', - 'in' => 'query', - 'schema' => [ - 'description' => 'The subscription duration of the subscription cluster.'."\n" - ."\n" - .'> This parameter is required only when PayType is set to Prepaid.'."\n" - ."\n" - .'* Valid values when Period is set to Year: 1 to 3 (integer)'."\n" - .'* Valid values when Period is set to Month: 1 to 9 (integer)'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - ], - [ - 'name' => 'VPCId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The VPC ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'vpc-bp175iuvg8nxqraf2****', - ], - ], - [ - 'name' => 'VSwitchId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The vSwitch ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'vsw-bp1gzt31twhlo0sa5****', - ], - ], - [ - 'name' => 'ClientToken', - 'in' => 'query', - 'schema' => [ - 'description' => 'The client token that is used to ensure the idempotence of the request. The value is a string and can be up to 64 ASCII characters in length.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'AB', - ], - ], - [ - 'name' => 'DbNodeStorageType', - 'in' => 'query', - 'schema' => [ - 'description' => 'The storage type of the cluster. Valid values:'."\n" - ."\n" - .'* **CloudESSD**: The cluster uses an enhanced SSD (ESSD) of performance level 1 (PL1).'."\n" - .'* **CloudESSD_PL2**: The cluster uses an ESSD of PL2.'."\n" - .'* **CloudESSD_PL3**: The cluster uses an ESSD of PL3.'."\n" - .'* **CloudEfficiency**: The cluster uses an ultra disk.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'CloudESSD_PL2', - ], - ], - [ - 'name' => 'EncryptionKey', - 'in' => 'query', - 'schema' => [ - 'description' => 'You must specify this parameter when EncryptionType is set to CloudDisk.'."\n" - ."\n" - .'The ID of the key that is used to encrypt data on disks. You can obtain the ID of the key from the Key Management Service (KMS) console. You can also create a key.'."\n" - ."\n" - .'> If EncryptionType is empty, you do not need to specify this parameter.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '0d2470df-da7b-4786-b981-9a164dae****', - ], - ], - [ - 'name' => 'EncryptionType', - 'in' => 'query', - 'schema' => [ - 'description' => 'The encryption type. Set the value to **CloudDisk**, which indicates that only disk encryption is supported.'."\n" - ."\n" - .'> If this parameter is not specified, data is not encrypted.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'CloudDisk', - ], - ], - [ - 'name' => 'BackupSetID', - 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the backup set. You can call the [DescribeBackups](~~360339~~) operation to query the backup sets.'."\n" - ."\n" - .'> If you want to restore the data of an ApsaraDB for ClickHouse cluster, this parameter is required.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'b-12af23adsf', - ], - ], - [ - 'name' => 'SourceDBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the source cluster. You can call the [DescribeDBClusters](~~170879~~) operation to query backup set IDs.'."\n" - ."\n" - .'> If you want to restore the data of an ApsaraDB for ClickHouse cluster, this parameter is required.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cc-bp1lxbo89u950****', - ], + ], + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], - [ - 'name' => 'ResourceGroupId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the resource group to which the cluster belongs.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'rg-4690g37929****', - ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'CancelAppointmentRestartInstanceNodeList', + 'summary' => 'Cancels the scheduled restart on the specified ClickHouse nodes.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1F488A93-83FD-540F-9B67-0333AF64E6A0\\"\\n}","type":"json"}]', + ], + 'CancelRestartInstance' => [ + 'summary' => 'Cancels a scheduled restart for a specific community-compatible ApsaraDB for ClickHouse cluster.', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'ZoneIdBak', - 'in' => 'query', - 'schema' => [ - 'description' => 'The secondary zone.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou-k', - ], + 'AK' => [], ], + ], + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'abilityTreeCode' => '173004', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], + ], + 'parameters' => [ [ - 'name' => 'VSwitchBak', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => '备专有网络交换机', - 'description' => 'The vSwitch in the secondary zone for the VPC.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'vsw-bp1gzt31twhlo0sa5****', - ], + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query region IDs.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ - 'name' => 'ZondIdBak2', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The secondary zone 2 of the instance.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou-j', - ], + 'schema' => ['description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all clusters in a specific region. The information includes the cluster IDs.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1t9lbb7a4z7****'], ], [ - 'name' => 'VSwitchBak2', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'title' => '备专有网络交换机2', - 'description' => 'The vSwitch in secondary zone 2 for the VPC.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'vsw-bp1gzt31twhlo0sa5****', - ], + 'schema' => ['description' => 'The number of entries to return on each page. Valid values:'."\n" + ."\n" + .'- 30 (default)'."\n" + ."\n" + .'- 50'."\n" + ."\n" + .'- 100', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '30', 'title' => '', 'example' => '30'], ], [ - 'name' => 'AutoRenew', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => 'Specifies whether to enable auto-renewal.'."\n" - ."\n" - .'> This parameter is valid only if the value of PayType is set to Prepaid.'."\n", - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'title' => '', 'example' => '1'], ], [ - 'name' => 'Tags', + 'name' => 'RestartTime', 'in' => 'query', - 'style' => 'repeatList', - 'schema' => [ - 'title' => '标签信息', - 'type' => 'array', - 'items' => [ - 'title' => '标签信息', - 'type' => 'object', - 'properties' => [ - 'key' => [ - 'title' => '标签键', - 'type' => 'string', - 'example' => 'user123', - ], - 'value' => [ - 'title' => '标签值', - 'type' => 'string', - 'example' => '示例字符串', - ], - ], - ], - 'maxItems' => 20, - 'minItems' => 0, - ], + 'schema' => ['type' => 'string', 'required' => false, 'description' => 'The scheduled restart time. The time must be in the \\`yyyy-MM-ddTHH:mmZ\\` format and in UTC.', 'title' => '', 'example' => '2023-03-22T00:00:50Z'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => 'The results returned.'."\n", + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp1qx68m06981****', - ], - 'OrderId' => [ - 'description' => 'The order ID.'."\n", - 'type' => 'string', - 'example' => '21137950671****', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F34'], ], + 'example' => '', ], ], ], 'errorCodes' => [ 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"DBClusterId\\": \\"cc-bp1qx68m06981****\\",\\n \\"OrderId\\": \\"21137950671****\\"\\n}","errorExample":""},{"type":"xml","example":"\\n F5178C10-1407-4987-9133-DE4DC9119F75\\n cc-bp1qx68m06981****\\n 21137950671****\\n","errorExample":""}]', - 'title' => 'CreateDBInstance', - 'description' => 'Before you call this operation, make sure that you are familiar with the billing methods and [pricing](~~167450~~) of ApsaraDB for ClickHouse.'."\n", - ], - 'DeleteDBCluster' => [ - 'summary' => 'Releases a pay-as-you-go ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'CancelRestartInstance', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:CancelRestartInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F34\\"\\n}","type":"json"}]', + ], + 'ChangeResourceGroup' => [ + 'summary' => 'Changes the resource group of a community-edition compatible ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', - 'abilityTreeCode' => '19428', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', - ], - 'tenantRelevance' => 'tenant', + 'operationType' => 'update', + 'abilityTreeCode' => '163948', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'ResourceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the pay-as-you-go ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['type' => 'string', 'required' => true, 'title' => '', 'description' => 'The resource ID.', 'example' => 'cc-bp1i43033051****'], + ], + [ + 'name' => 'ResourceRegionId', + 'in' => 'query', + 'schema' => ['type' => 'string', 'required' => true, 'title' => '', 'description' => 'The region ID.', 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'ResourceGroupId', + 'in' => 'query', + 'schema' => ['type' => 'string', 'required' => true, 'title' => '', 'description' => 'The ID of the destination resource group.', 'example' => 'rg-4690g37929****'], ], ], 'responses' => [ @@ -734,41 +447,53 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', - ], + 'RequestId' => ['type' => 'string', 'title' => '', 'description' => 'The request ID.', 'example' => 'C342F3DD-1FF7-55E9-A1A1-098DE07CD1A2'], ], - 'description' => '', + 'title' => '', + 'description' => 'The data returned.', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'NoPermission.ChangeResourceGroup', 'errorMessage' => 'You are not authorized to change resourcegroup', 'description' => ''], + ['errorCode' => 'MissingParameter.ResourceRegionId', 'errorMessage' => 'The ResourceRegionId parameters that are required for processing this request are missing', 'description' => ''], + ['errorCode' => 'MissingParameter.ResourceId', 'errorMessage' => 'The ResourceId parameters that are required for processing this request are missing', 'description' => ''], + ['errorCode' => 'MissingParameter.ResourceGroupId', 'errorMessage' => 'The ResourceGroupId parameters that are required for processing this request are missing', 'description' => ''], + ['errorCode' => 'InvalidResourceGroup', 'errorMessage' => 'The specified ResourceGroupId is invalid', 'description' => ''], + ['errorCode' => 'SystemError', 'errorMessage' => 'A system error occurred while processing your request', 'description' => ''], + ['errorCode' => 'ResourceNotFound', 'errorMessage' => ' The specified resource is not found', 'description' => ''], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 05321590-BB65-4720-8CB6-8218E041CDD0\\n","errorExample":""}]', - 'title' => 'DeleteDBCluster', - 'description' => '**Warning** After an ApsaraDB for ClickHouse cluster is deleted, all data in the cluster is deleted and cannot be recovered. Exercise caution when performing this operation.', - ], - 'DescribeDBClusters' => [ - 'methods' => [ - 'post', - 'get', + 'title' => 'ChangeResourceGroup', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ChangeResourceGroup', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C342F3DD-1FF7-55E9-A1A1-098DE07CD1A2\\"\\n}","type":"json"}]', + ], + 'CheckClickhouseToRDS' => [ + 'summary' => 'Call the CheckClickhouseToRDS operation to verify the connectivity between a community-compatible ApsaraDB for ClickHouse cluster and an ApsaraDB RDS for MySQL instance.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -778,1362 +503,59 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '19443', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseMCDGZK', - ], + 'abilityTreeCode' => '43669', + 'abilityTreeNodes' => ['FEATUREclickhouseZ93UXU'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DbClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The ID of the community-compatible ApsaraDB for ClickHouse cluster.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-2zeyy362b5sbm****'], ], [ - 'name' => 'DBClusterIds', + 'name' => 'ClickhousePort', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n" - ."\n" - .'> If you do not specify this parameter, the information about all clusters is queried.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['description' => 'The port number of the ApsaraDB for ClickHouse cluster.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'title' => '', 'example' => '8123'], ], [ - 'name' => 'DBClusterDescription', + 'name' => 'CkUserName', 'in' => 'query', - 'schema' => [ - 'description' => 'The description of the cluster.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['description' => 'The database account for the ApsaraDB for ClickHouse cluster.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'user1'], ], [ - 'name' => 'DBClusterStatus', + 'name' => 'CkPassword', 'in' => 'query', - 'schema' => [ - 'description' => 'The state of the cluster. Valid values:'."\n" - ."\n" - .'* **Preparing**: The cluster is being prepared.'."\n" - .'* **Creating**: The cluster is being created.'."\n" - .'* **Running**: The cluster is running.'."\n" - .'* **Deleting**: The cluster is being deleted.'."\n" - .'* **SCALING_OUT**: The storage capacity of the cluster is being expanded.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'Running', - ], + 'schema' => ['description' => 'The password for the ApsaraDB for ClickHouse database account.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => '123456Aa'], ], [ - 'name' => 'PageSize', + 'name' => 'RdsId', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries to return per page. Valid values:'."\n" - ."\n" - .'* **30** (default)'."\n" - .'* **50**'."\n" - .'* **100**'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', - ], + 'schema' => ['description' => 'The ID of the ApsaraDB RDS instance.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'rm-bp13v4bnwlu8j****'], ], [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => 'The page number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], - ], - [ - 'name' => 'Tag', - 'in' => 'query', - 'style' => 'repeatList', - 'schema' => [ - 'description' => 'The tags.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => 'The tag name.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'department', - ], - 'Value' => [ - 'description' => 'The tag value.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'it', - ], - ], - 'required' => false, - ], - 'required' => false, - 'maxItems' => 21, - ], - ], - [ - 'name' => 'ResourceGroupId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the resource group to which the cluster belongs.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'rg-4690g37929****', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'TotalCount' => [ - 'description' => 'The total number of entries that are returned.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => 'The number of entries returned per page. Valid values:'."\n" - ."\n" - .'* **30** (default)'."\n" - .'* **50**'."\n" - .'* **100**'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], - 'PageNumber' => [ - 'description' => 'The total number of returned pages.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'DBClusters' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'DBCluster' => [ - 'description' => 'The clusters.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'The cluster.'."\n", - 'type' => 'object', - 'properties' => [ - 'VpcId' => [ - 'description' => 'The ID of the virtual private cloud (VPC) in which the cluster is deployed.'."\n", - 'type' => 'string', - 'example' => 'vpc-bp175iuvg8nxqraf2****', - ], - 'DBNodeCount' => [ - 'description' => 'The number of nodes.'."\n" - ."\n" - .'* Valid values when the cluster is of Single-replica Edition: 1 to 48.'."\n" - .'* Valid values when the cluster is of Double-replica Edition: 1 to 24.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2', - ], - 'CreateTime' => [ - 'description' => 'The time when the cluster was created. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format.'."\n", - 'type' => 'string', - 'example' => '2021-10-28T07:24:45Z', - ], - 'PayType' => [ - 'description' => 'The billing method of the cluster. Valid values:'."\n" - ."\n" - .'* **Postpaid**: The cluster uses the pay-as-you-go billing method.'."\n" - .'* **Prepaid**: The cluster uses the subscription billing method.'."\n", - 'type' => 'string', - 'example' => 'Postpaid', - ], - 'Tags' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Tag' => [ - 'description' => 'The tags.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => 'The tag name.'."\n", - 'type' => 'string', - 'example' => 'department', - ], - 'Value' => [ - 'description' => 'The tag value.'."\n", - 'type' => 'string', - 'example' => 'it', - ], - ], - ], - ], - ], - ], - 'StorageType' => [ - 'description' => 'The storage type of the cluster. Valid values:'."\n" - ."\n" - .'* **CloudESSD**: The cluster uses an enhanced SSD (ESSD) of performance level (PL) 1.'."\n" - .'* **CloudESSD_PL2**: The cluster uses an ESSD of PL 2.'."\n" - .'* **CloudESSD_PL3**: The cluster uses an ESSD of PL 3.'."\n" - .'* **CloudEfficiency**: The cluster uses an ultra disk.'."\n", - 'type' => 'string', - 'example' => 'CloudESSD', - ], - 'Port' => [ - 'description' => 'The HTTP port number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '8123', - ], - 'LockMode' => [ - 'description' => 'The lock mode of the cluster. Valid values:'."\n" - ."\n" - .'* **Unlock**: The cluster is not locked.'."\n" - .'* **ManualLock**: The cluster is manually locked.'."\n" - .'* **LockByExpiration**: The cluster is automatically locked due to cluster expiration.'."\n" - .'* **LockByRestoration**: The cluster is automatically locked because the cluster is about to be rolled back.'."\n" - .'* **LockByDiskQuota**: The cluster is automatically locked because the disk space is exhausted.'."\n", - 'type' => 'string', - 'example' => 'Unlock', - ], - 'Bid' => [ - 'description' => 'The site ID. Valid values:'."\n" - ."\n" - .'* **26842**: the China site (aliyun.com)'."\n" - .'* **26888**: the international site (alibabacloud.com)'."\n", - 'type' => 'string', - 'example' => '26842', - ], - 'IsExpired' => [ - 'description' => 'Indicates whether the cluster has expired. Valid values:'."\n" - ."\n" - .'* **true**: The cluster has expired.'."\n" - .'* **false**: The cluster has not expired.'."\n", - 'type' => 'string', - 'example' => 'false', - ], - 'VpcCloudInstanceId' => [ - 'description' => 'The ID of the VPC in which the cluster is deployed.'."\n", - 'type' => 'string', - 'example' => 'vpc-bp175iuvg8nxqraf2****', - ], - 'ScaleOutStatus' => [ - 'description' => 'The status of a data migration task.'."\n", - 'type' => 'object', - 'properties' => [ - 'Progress' => [ - 'description' => 'The progress of the data migration task in percentage.'."\n" - ."\n" - .'> This parameter is returned only when the cluster is in the SCALING_OUT state.'."\n", - 'type' => 'string', - 'example' => '0', - ], - 'Ratio' => [ - 'description' => 'The progress of the data migration task. This value is displayed in the following format: Data volume that has been migrated/Total data volume.'."\n" - ."\n" - .'> This parameter is returned only when the cluster is in the SCALING_OUT state.'."\n", - 'type' => 'string', - 'example' => '0MB/60469MB', - ], - ], - ], - 'ScaleOutDisableWriteWindows' => [ - 'description' => 'The time window during which write operations are stopped for specification changes.'."\n", - 'type' => 'string', - 'example' => '2025-02-08T00:00:00+08:00,2025-02-12T00:00:00+08:00', - ], - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp108z124a8o7****', - ], - 'ConnectionString' => [ - 'description' => 'The VPC endpoint of the cluster.'."\n", - 'type' => 'string', - 'example' => 'cc-bp1fs5o051c61****.clickhouse.ads.aliyuncs.com', - ], - 'CommodityCode' => [ - 'description' => 'The commodity code of the cluster.'."\n", - 'type' => 'string', - 'example' => 'clickhouse_go_public_cn', - ], - 'ExpireTime' => [ - 'description' => 'The time when the cluster expired. The time is in the yyyy-MM-ddTHH:mm:ssZ format.'."\n" - ."\n" - .'> Pay-as-you-go clusters never expire. If the cluster is a pay-as-you-go cluster, an empty string is returned for this parameter.'."\n", - 'type' => 'string', - 'example' => '2011-05-30T12:11:4Z', - ], - 'DBNodeStorage' => [ - 'description' => 'The storage capacity of each node. Valid values: 100 to 32000. Unit: GB.'."\n" - ."\n" - .'> This value is a multiple of 100.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'DBNodeClass' => [ - 'description' => 'The specifications of the cluster.'."\n" - ."\n" - .'* Valid values when the cluster is of Single-replica Edition: -**S4**: 4 CPU cores and 16 GB of memory -**S8**: 8 CPU cores and 32 GB of memory'."\n" - ."\n" - .' * **S16**: 16 CPU cores and 64 GB of memory'."\n" - .' * **S32**: 32 CPU cores and 128 GB of memory'."\n" - .' * **S64**: 64 CPU cores and 256 GB of memory'."\n" - .' * **S104**: 104 CPU cores and 384 GB of memory'."\n" - ."\n" - .'* Valid values when the cluster is of Double-replica Edition: -**C4**: 4 CPU cores and 16 GB of memory -**C8**: 8 CPU cores and 32 GB of memory -**C16**: 16 CPU cores and 64 GB of memory -**C32**: 32 CPU cores and 128 GB of memory -**C64**: 64 CPU cores and 256 GB of memory -**C104**: 104 CPU cores and 384 GB of memory'."\n", - 'type' => 'string', - 'example' => 'C8', - ], - 'AliUid' => [ - 'description' => 'The ID of the Alibaba Cloud account.'."\n", - 'type' => 'string', - 'example' => '140692647406****', - ], - 'LockReason' => [ - 'description' => 'The cause why the cluster was locked.'."\n" - ."\n" - .'> If the value of the LockMode parameter is Unlock, an empty string is returned for this parameter.'."\n", - 'type' => 'string', - 'example' => 'DISK_FULL', - ], - 'RegionId' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'VSwitchId' => [ - 'description' => 'The vSwitch ID.'."\n", - 'type' => 'string', - 'example' => 'vsw-bp1gzt31twhlo0sa5****', - ], - 'DBClusterStatus' => [ - 'description' => 'The state of the cluster. Valid values:'."\n" - ."\n" - .'* **Preparing**: The cluster is being prepared.'."\n" - .'* **Creating**: The cluster is being created.'."\n" - .'* **Running**: The cluster is running.'."\n" - .'* **Deleting**: The cluster is being deleted.'."\n" - .'* **SCALING_OUT**: The storage capacity of the cluster is being expanded.'."\n", - 'type' => 'string', - 'example' => 'Running', - ], - 'DBClusterDescription' => [ - 'description' => 'The description of the cluster.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'DBClusterNetworkType' => [ - 'description' => 'The network type of the cluster. Only VPC is supported.'."\n", - 'type' => 'string', - 'example' => 'VPC', - ], - 'ZoneId' => [ - 'description' => 'The zone ID.'."\n", - 'type' => 'string', - 'example' => 'cn-hangzhou-h', - ], - 'Category' => [ - 'description' => 'The edition of the cluster. Valid values:'."\n" - ."\n" - .'* **Basic**: Single-replica Edition'."\n" - .'* **HighAvailability**: Double-replica Edition'."\n", - 'type' => 'string', - 'example' => 'Basic', - ], - 'ControlVersion' => [ - 'description' => 'The version number of the backend management system of ApsaraDB for ClickHouse. Valid values:'."\n" - ."\n" - .'* **v1**'."\n" - .'* **v2**'."\n", - 'type' => 'string', - 'example' => 'v1', - ], - 'ExtStorageType' => [ - 'description' => 'The extended storage type. Valid values:'."\n" - ."\n" - .'* **CloudSSD**: standard SSD.'."\n" - .'* **CloudESSD**: The cluster uses an enhanced SSD (ESSD) of performance level (PL) 1.'."\n" - .'* **CloudESSD_PL2**: The cluster uses an ESSD of PL 2.'."\n" - .'* **CloudESSD_PL3**: The cluster uses an ESSD of PL 3.'."\n" - .'* **CloudEfficiency**: The cluster uses an ultra disk.'."\n", - 'type' => 'string', - 'example' => 'CloudESSD', - ], - 'ExtStorageSize' => [ - 'description' => 'The extended storage space.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '100GB', - ], - 'ResourceGroupId' => [ - 'description' => 'The ID of the resource group to which the cluster belongs.'."\n", - 'type' => 'string', - 'example' => 'rg-4690g37929****', - ], - 'DbVersion' => [ - 'description' => 'The engine version of the cluster.'."\n", - 'type' => 'string', - 'example' => '23.8', - ], - ], - ], - ], - ], - ], - ], - 'description' => '', - ], - ], - ], - 'errorCodes' => [ - 403 => [ - [ - 'errorCode' => 'Forbidden', - 'errorMessage' => 'User not authorized to operate on the specified resource.', - ], - ], - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PageNumber\\": 1,\\n \\"DBClusters\\": {\\n \\"DBCluster\\": [\\n {\\n \\"VpcId\\": \\"vpc-bp175iuvg8nxqraf2****\\",\\n \\"DBNodeCount\\": 2,\\n \\"CreateTime\\": \\"2021-10-28T07:24:45Z\\",\\n \\"PayType\\": \\"Postpaid\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"Key\\": \\"department\\",\\n \\"Value\\": \\"it\\"\\n }\\n ]\\n },\\n \\"StorageType\\": \\"CloudESSD\\",\\n \\"Port\\": 8123,\\n \\"LockMode\\": \\"Unlock\\",\\n \\"Bid\\": \\"26842\\",\\n \\"IsExpired\\": \\"false\\",\\n \\"VpcCloudInstanceId\\": \\"vpc-bp175iuvg8nxqraf2****\\",\\n \\"ScaleOutStatus\\": {\\n \\"Progress\\": \\"0\\",\\n \\"Ratio\\": \\"0MB/60469MB\\"\\n },\\n \\"ScaleOutDisableWriteWindows\\": \\"2025-02-08T00:00:00+08:00,2025-02-12T00:00:00+08:00\\",\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"ConnectionString\\": \\"cc-bp1fs5o051c61****.clickhouse.ads.aliyuncs.com\\",\\n \\"CommodityCode\\": \\"clickhouse_go_public_cn\\",\\n \\"ExpireTime\\": \\"2011-05-30T12:11:4Z\\",\\n \\"DBNodeStorage\\": 100,\\n \\"DBNodeClass\\": \\"C8\\",\\n \\"AliUid\\": \\"140692647406****\\",\\n \\"LockReason\\": \\"DISK_FULL\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"VSwitchId\\": \\"vsw-bp1gzt31twhlo0sa5****\\",\\n \\"DBClusterStatus\\": \\"Running\\",\\n \\"DBClusterDescription\\": \\"test\\",\\n \\"DBClusterNetworkType\\": \\"VPC\\",\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"Category\\": \\"Basic\\",\\n \\"ControlVersion\\": \\"v1\\",\\n \\"ExtStorageType\\": \\"CloudESSD\\",\\n \\"ExtStorageSize\\": 0,\\n \\"ResourceGroupId\\": \\"rg-4690g37929****\\",\\n \\"DbVersion\\": \\"23.8\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n 30\\n F5178C10-1407-4987-9133-DE4DC9119F75\\n 1\\n \\n vpc-bp175iuvg8nxqraf2****\\n 2\\n 2021-10-28T07:24:45Z\\n Postpaid\\n \\n department\\n it\\n \\n CloudESSD\\n 8123\\n Unlock\\n 26842\\n false\\n vpc-bp175iuvg8nxqraf2****\\n \\n 0\\n 0MB/60469MB\\n \\n cc-bp108z124a8o7****\\n cc-bp1fs5o051c61****.clickhouse.ads.aliyuncs.com\\n clickhouse_go_public_cn\\n 2011-05-30T12:11:4Z\\n 100\\n C8\\n 140692647406****\\n DISK_FULL\\n cn-hangzhou\\n vsw-bp1gzt31twhlo0sa5****\\n Running\\n test\\n VPC\\n cn-hangzhou-h\\n Basic\\n v1\\n \\n","errorExample":""}]', - 'title' => 'DescribeDBClusters', - 'summary' => 'Queries the information about ApsaraDB for ClickHouse clusters in a region.', - ], - 'DescribeDBClusterAttribute' => [ - 'summary' => 'Queries the information about an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], - ], - ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '19439', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseMCDGZK', - ], - ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all the clusters that are deployed in a specific region. The information includes the cluster IDs.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'description' => 'The response parameters.'."\n", - 'type' => 'object', - 'properties' => [ - 'DBCluster' => [ - 'description' => 'The information about the cluster.'."\n", - 'type' => 'object', - 'properties' => [ - 'VpcId' => [ - 'description' => 'The virtual private cloud (VPC) ID.'."\n", - 'type' => 'string', - 'example' => 'vpc-bp10tr8k9qasioaty****', - ], - 'SupportBackup' => [ - 'description' => 'Indicates whether data backup is supported. Valid values:'."\n" - ."\n" - .'* **1**: Data backup is supported.'."\n" - .'* **2**: Data backup is not supported.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'SupportOss' => [ - 'description' => 'Indicates whether tiered storage of hot data and cold data is supported. Valid values:'."\n" - ."\n" - .'* **1**: Tiered storage of hot data and cold data is supported.'."\n" - .'* **2**: Tiered storage of hot data and cold data is not supported.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'EncryptionType' => [ - 'description' => 'The encryption type. Valid values:'."\n" - ."\n" - .'* **CloudDisk**: Disk encryption is enabled.'."\n" - .'* **off**: Data is not encrypted.'."\n", - 'type' => 'string', - 'example' => 'CloudDisk', - ], - 'DBNodeCount' => [ - 'description' => 'The number of nodes.'."\n" - ."\n" - .'* Valid values when the cluster is of Single-replica Edition: 1 to 48.'."\n" - .'* Valid values when the cluster is of Double-replica Edition: 1 to 24.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'MaintainTime' => [ - 'description' => 'The maintenance window of the cluster. The value is in the HH:mmZ-HH:mmZ format. The time is displayed in UTC.'."\n" - ."\n" - .'For example, if you set the maintenance window to 00:00Z-01:00Z, the cluster can be maintained from 08:00 (UTC+8) to 09:00 (UTC+8).'."\n", - 'type' => 'string', - 'example' => '00:00Z-01:00Z', - ], - 'CreateTime' => [ - 'description' => 'The time when the cluster was created. The value is in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.'."\n", - 'type' => 'string', - 'example' => '2021-12-13T11:33:11Z', - ], - 'PayType' => [ - 'description' => 'The billing method of the cluster. Valid values:'."\n" - ."\n" - .'* **Postpaid**: indicates the pay-as-you-go billing method.'."\n" - .'* **Prepaid**: indicates the subscription billing method.'."\n", - 'type' => 'string', - 'example' => 'Prepaid', - ], - 'Tags' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Tag' => [ - 'description' => 'The tags.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => 'The tag name.'."\n", - 'type' => 'string', - 'example' => 'department', - ], - 'Value' => [ - 'description' => 'The tag value.'."\n", - 'type' => 'string', - 'example' => 'it', - ], - ], - ], - ], - ], - ], - 'PublicConnectionString' => [ - 'description' => 'The public endpoint.'."\n", - 'type' => 'string', - 'example' => 'cc-bp1199ya710s7****.public.clickhouse.ads.aliyuncs.com', - ], - 'StorageType' => [ - 'description' => 'The storage type of the cluster. Valid values:'."\n" - ."\n" - .'* **CloudESSD**: The cluster uses an enhanced SSD (ESSD) of performance level (PL) 1.'."\n" - .'* **CloudESSD_PL2**: The cluster uses an ESSD of PL 2.'."\n" - .'* **CloudESSD_PL3**: The cluster uses an ESSD of PL 3.'."\n" - .'* **CloudEfficiency**: The cluster uses an ultra disk.'."\n", - 'type' => 'string', - 'example' => 'CloudESSD', - ], - 'Port' => [ - 'description' => 'The HTTP port number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '8123', - ], - 'LockMode' => [ - 'description' => 'The lock mode of the cluster. Valid values:'."\n" - ."\n" - .'* **Unlock**: The cluster is not locked.'."\n" - .'* **ManualLock**: The cluster is manually locked.'."\n" - .'* **LockByExpiration**: The cluster is automatically locked due to cluster expiration.'."\n" - .'* **LockByRestoration**: The cluster is automatically locked because the cluster is about to be rolled back.'."\n" - .'* **LockByDiskQuota**: The cluster is automatically locked because the disk space is exhausted.'."\n", - 'type' => 'string', - 'example' => 'Unlock', - ], - 'Bid' => [ - 'description' => 'The site ID. Valid values:'."\n" - ."\n" - .'* **26842**: the China site (aliyun.com)'."\n" - .'* **26888**: the international site (alibabacloud.com)'."\n", - 'type' => 'string', - 'example' => '26842', - ], - 'EngineVersion' => [ - 'description' => 'The engine version.'."\n", - 'type' => 'string', - 'example' => '21.8.10.19', - ], - 'IsExpired' => [ - 'description' => 'Indicates whether the cluster has expired. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'string', - 'example' => 'false', - ], - 'ScaleOutStatus' => [ - 'description' => 'The status of the data migration task.'."\n", - 'type' => 'object', - 'properties' => [ - 'Progress' => [ - 'description' => 'The progress of the data migration task in percentage.'."\n" - ."\n" - .'> This parameter is returned only when the cluster is in the SCALING_OUT state.'."\n", - 'type' => 'string', - 'example' => '0', - ], - 'Ratio' => [ - 'description' => 'The progress of the data migration task. This value is displayed in the following format: Data volume that has been migrated/Total data volume.'."\n" - ."\n" - .'> This parameter is returned only when the cluster is in the SCALING_OUT state.'."\n", - 'type' => 'string', - 'example' => '0MB/60469MB', - ], - ], - ], - 'LbKind' => [ - 'type' => 'string', - ], - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp108z124a8o7****', - ], - 'ConnectionString' => [ - 'description' => 'The VPC endpoint of the cluster.'."\n", - 'type' => 'string', - 'example' => 'cc-bp1qx68m06981****.ads.rds.aliyuncs.com', - ], - 'EncryptionKey' => [ - 'description' => 'The Key Management Service (KMS) key that is used to encrypt data.'."\n" - ."\n" - .'> If the value of the EncryptionType parameter is off, an empty string is returned for this parameter.'."\n", - 'type' => 'string', - 'example' => '685f416f-87c9-4554-8d3a-75b6ce25****', - ], - 'DBClusterType' => [ - 'description' => 'The type of the cluster. Valid values:'."\n" - ."\n" - .'* **Common**: a common cluster'."\n" - .'* **Readonly**: a read-only cluster'."\n" - .'* **Guard**: a disaster recovery cluster'."\n", - 'type' => 'string', - 'example' => 'Common', - ], - 'CommodityCode' => [ - 'description' => 'The commodity code of the cluster.'."\n", - 'type' => 'string', - 'example' => 'clickhouse_go_public_cn', - ], - 'ExpireTime' => [ - 'description' => 'The time when the cluster expired. The time is in the yyyy-MM-ddTHH:mm:ssZ format.'."\n" - ."\n" - .'> Pay-as-you-go clusters never expire. If the cluster is a pay-as-you-go cluster, an empty string is returned for this parameter.'."\n", - 'type' => 'string', - 'example' => '2022-11-11T16:00:00Z', - ], - 'DBNodeStorage' => [ - 'description' => 'The storage capacity of a single node of the cluster. Unit: GB.'."\n" - ."\n" - .'Valid values: 100 to 32000.'."\n" - ."\n" - .'> This value is a multiple of 100.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'DBNodeClass' => [ - 'description' => 'The specifications of the cluster.'."\n" - ."\n" - .'* Valid values when the cluster is of Single-replica Edition:'."\n" - ."\n" - .' * **S4-NEW**'."\n" - .' * **S8**'."\n" - .' * **S16**'."\n" - .' * **S32**'."\n" - .' * **S64**'."\n" - .' * **S104**'."\n" - ."\n" - .'* Valid values when the cluster is of Double-replica Edition:'."\n" - ."\n" - .' * **C4-NEW**'."\n" - .' * **C8**'."\n" - .' * **C16**'."\n" - .' * **C32**'."\n" - .' * **C64**'."\n" - .' * **C104**'."\n", - 'type' => 'string', - 'example' => 'C8', - ], - 'AliUid' => [ - 'description' => 'The ID of the Alibaba Cloud account.'."\n", - 'type' => 'string', - 'example' => '140692647406****', - ], - 'LockReason' => [ - 'description' => 'The cause why the cluster was locked.'."\n" - ."\n" - .'> If the value of the LockMode parameter is Unlock, an empty string is returned for this parameter.'."\n", - 'type' => 'string', - 'example' => 'DISK_FULL', - ], - 'RegionId' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'PublicPort' => [ - 'description' => 'The TCP port number in the public endpoint.'."\n", - 'type' => 'string', - 'example' => '3306', - ], - 'VSwitchId' => [ - 'description' => 'The vSwitch ID.'."\n", - 'type' => 'string', - 'example' => 'vsw-bp1n874li1t5y57wi****', - ], - 'DBClusterStatus' => [ - 'description' => 'The cluster state. Valid values:'."\n" - ."\n" - .'* **Preparing**: The cluster is being prepared.'."\n" - .'* **Creating**: The cluster is being created.'."\n" - .'* **Running**: The cluster is running.'."\n" - .'* **Deleting**: The cluster is being deleted.'."\n" - .'* **SCALING_OUT**: The storage capacity of the cluster is being expanded.'."\n", - 'type' => 'string', - 'example' => 'Running', - ], - 'DBClusterNetworkType' => [ - 'description' => 'The network type of the cluster. Only VPC is supported.'."\n", - 'type' => 'string', - 'example' => 'vpc', - ], - 'DBClusterDescription' => [ - 'description' => 'The description of the cluster.'."\n", - 'type' => 'string', - 'example' => 'cc-bp108z124a8o7****', - ], - 'ZoneId' => [ - 'description' => 'The zone ID.'."\n", - 'type' => 'string', - 'example' => 'cn-hangzhou-h', - ], - 'Category' => [ - 'description' => 'The edition of the cluster. Valid values:'."\n" - ."\n" - .'* **Basic**: Single-replica Edition'."\n" - .'* **HighAvailability**: Double-replica Edition'."\n", - 'type' => 'string', - 'example' => 'HighAvailability', - ], - 'Engine' => [ - 'description' => 'The type of the database engine.'."\n", - 'type' => 'string', - 'example' => 'ClickHouse', - ], - 'SupportMysqlPort' => [ - 'description' => 'Indicates whether the cluster supports a MySQL port. Valid values:'."\n" - ."\n" - .'* **true**: A MySQL port is supported.'."\n" - .'* **false**: A MySQL port is not supported.'."\n", - 'type' => 'boolean', - 'example' => 'false', - ], - 'SupportHttpsPort' => [ - 'description' => 'Indicates whether HTTPS ports are supported. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'boolean', - 'example' => 'false', - ], - 'ControlVersion' => [ - 'description' => 'The version of the ApsaraDB for ClickHouse console that is used to manage the cluster. Valid values:'."\n" - ."\n" - .'* **v1**'."\n" - .'* **v2**'."\n", - 'type' => 'string', - 'example' => 'v1', - ], - 'PublicIpAddr' => [ - 'description' => 'The IP address that is used to connect to the cluster over the Internet.'."\n", - 'type' => 'string', - 'example' => '121.40.xx.xx', - ], - 'EngineMinorVersion' => [ - 'description' => 'The current minor version.'."\n", - 'type' => 'string', - 'example' => '1.6.0', - ], - 'EngineLatestMinorVersion' => [ - 'description' => 'The latest minor version to which the cluster can be updated.'."\n", - 'type' => 'string', - 'example' => '1.34.0', - ], - 'MaintainAutoType' => [ - 'description' => 'The update type. If the value of the parameter is **false**, it indicates a manual update.'."\n", - 'type' => 'boolean', - 'example' => 'false', - ], - 'ExtStorageType' => [ - 'description' => 'The extended storage type. Valid values:'."\n" - ."\n" - .'* **CloudESSD**: The cluster uses an enhanced SSD (ESSD) of performance level (PL) 1.'."\n" - .'* **CloudESSD_PL2**: The cluster uses an ESSD of PL 2.'."\n" - .'* **CloudESSD_PL3**: The cluster uses an ESSD of PL 3.'."\n" - .'* **CloudEfficiency**: The cluster uses an ultra disk.'."\n", - 'type' => 'string', - 'example' => 'CloudESSD', - ], - 'ExtStorageSize' => [ - 'description' => 'The extended storage space. Unit: GB.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '500', - ], - 'ResourceGroupId' => [ - 'description' => 'The resource group ID.'."\n", - 'type' => 'string', - 'example' => 'rg-acfmyf65je6****', - ], - 'ZookeeperClass' => [ - 'description' => 'The ZooKeeper specifications.'."\n", - 'type' => 'string', - 'example' => '4 Core 8 GB', - ], - 'AppointmentRestartTime' => [ - 'description' => 'The scheduled restart time. The time follows the ISO 8601 standard in the YYYY-MM-DDThh:mm:ssZ format. The time is displayed in Coordinated Universal Time (UTC).'."\n", - 'type' => 'string', - 'example' => '2023-11-06T12:00:00Z', - ], - 'ZoneIdVswitchMap' => [ - 'description' => 'The list of vSwitch IDs in multi-zone clusters.'."\n", - 'type' => 'object', - 'example' => 'cn-shanghai-f: vsw-zm0n42d5vvuo****', - ], - 'AvailableUpgradeMajorVersion' => [ - 'description' => 'The major engine versions available for upgrades.'."\n", - 'type' => 'object', - 'example' => '{"MajorVersion":"MinorVersion"}', - ], - 'AppointmentRestartNodeTime' => [ - 'type' => 'string', - ], - 'AppointmentRestartNodeList' => [ - 'type' => 'string', - ], - 'AppointmentElectZookeeperTime' => [ - 'type' => 'string', - ], - 'AppointmentElectZookeeperDisableWrite' => [ - 'type' => 'boolean', - ], - 'VpcIpAddr' => [ - 'description' => 'The IP address that is used to connect to the cluster over the VPC.'."\n", - 'type' => 'string', - 'example' => '192.168.xx.xx', - ], - 'VpcCloudInstanceId' => [ - 'description' => 'The ID of the VPC in which the cluster is deployed.'."\n", - 'type' => 'string', - 'example' => 'vpc-bp10tr8k9qasioaty****', - ], - ], - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', - ], - ], - ], - ], - ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - ], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"DBCluster\\": {\\n \\"VpcId\\": \\"vpc-bp10tr8k9qasioaty****\\",\\n \\"SupportBackup\\": 1,\\n \\"SupportOss\\": 1,\\n \\"EncryptionType\\": \\"CloudDisk\\",\\n \\"DBNodeCount\\": 1,\\n \\"MaintainTime\\": \\"00:00Z-01:00Z\\",\\n \\"CreateTime\\": \\"2021-12-13T11:33:11Z\\",\\n \\"PayType\\": \\"Prepaid\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"Key\\": \\"department\\",\\n \\"Value\\": \\"it\\"\\n }\\n ]\\n },\\n \\"PublicConnectionString\\": \\"cc-bp1199ya710s7****.public.clickhouse.ads.aliyuncs.com\\",\\n \\"StorageType\\": \\"CloudESSD\\",\\n \\"Port\\": 8123,\\n \\"LockMode\\": \\"Unlock\\",\\n \\"Bid\\": \\"26842\\",\\n \\"EngineVersion\\": \\"21.8.10.19\\",\\n \\"IsExpired\\": \\"false\\",\\n \\"ScaleOutStatus\\": {\\n \\"Progress\\": \\"0\\",\\n \\"Ratio\\": \\"0MB/60469MB\\"\\n },\\n \\"LbKind\\": \\"\\",\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"ConnectionString\\": \\"cc-bp1qx68m06981****.ads.rds.aliyuncs.com\\",\\n \\"EncryptionKey\\": \\"685f416f-87c9-4554-8d3a-75b6ce25****\\",\\n \\"DBClusterType\\": \\"Common\\",\\n \\"CommodityCode\\": \\"clickhouse_go_public_cn\\",\\n \\"ExpireTime\\": \\"2022-11-11T16:00:00Z\\",\\n \\"DBNodeStorage\\": 100,\\n \\"DBNodeClass\\": \\"C8\\",\\n \\"AliUid\\": \\"140692647406****\\",\\n \\"LockReason\\": \\"DISK_FULL\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"PublicPort\\": \\"3306\\",\\n \\"VSwitchId\\": \\"vsw-bp1n874li1t5y57wi****\\",\\n \\"DBClusterStatus\\": \\"Running\\",\\n \\"DBClusterNetworkType\\": \\"vpc\\",\\n \\"DBClusterDescription\\": \\"cc-bp108z124a8o7****\\",\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"Category\\": \\"HighAvailability\\",\\n \\"Engine\\": \\"ClickHouse\\",\\n \\"SupportMysqlPort\\": false,\\n \\"SupportHttpsPort\\": false,\\n \\"ControlVersion\\": \\"v1\\",\\n \\"PublicIpAddr\\": \\"121.40.xx.xx\\",\\n \\"EngineMinorVersion\\": \\"1.6.0\\",\\n \\"EngineLatestMinorVersion\\": \\"1.34.0\\",\\n \\"MaintainAutoType\\": false,\\n \\"ExtStorageType\\": \\"CloudESSD\\",\\n \\"ExtStorageSize\\": 500,\\n \\"ResourceGroupId\\": \\"rg-acfmyf65je6****\\",\\n \\"ZookeeperClass\\": \\"4 Core 8 GB\\",\\n \\"AppointmentRestartTime\\": \\"2023-11-06T12:00:00Z\\",\\n \\"ZoneIdVswitchMap\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n },\\n \\"AvailableUpgradeMajorVersion\\": {\\n \\"MajorVersion\\": \\"MinorVersion\\"\\n },\\n \\"AppointmentRestartNodeTime\\": \\"2023-11-06T12:00:00Z\\",\\n \\"AppointmentRestartNodeList\\": \\"ck-k1a976p3n********-****-clickhouse-s-0-r-0,ck-k1a976p3n********-****-clickhouse-s-0-r-1\\",\\n \\"AppointmentElectZookeeperTime\\": \\"2023-11-06T12:00:00Z\\",\\n \\"AppointmentElectZookeeperDisableWrite\\": true,\\n \\"VpcIpAddr\\": \\"192.168.xx.xx\\",\\n \\"VpcCloudInstanceId\\": \\"vpc-bp10tr8k9qasioaty****\\"\\n },\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","errorExample":""},{"type":"xml","example":"\\n \\n vpc-bp10tr8k9qasioaty****\\n 1\\n 1\\n CloudDisk\\n 1\\n 00:00Z-01:00Z\\n 2021-12-13T11:33:11Z\\n Prepaid\\n \\n department\\n it\\n \\n cc-bp1199ya710s7****.public.clickhouse.ads.aliyuncs.com\\n CloudESSD\\n 8123\\n Unlock\\n 26842\\n 21.8.10.19\\n false\\n \\n 0\\n 0MB/60469MB\\n \\n vpc-bp10tr8k9qasioaty****\\n cc-bp108z124a8o7****\\n cc-bp1qx68m06981****.ads.rds.aliyuncs.com\\n 685f416f-87c9-4554-8d3a-75b6ce25****\\n Common\\n clickhouse_go_public_cn\\n 2022-11-11T16:00:00Z\\n 100\\n C8\\n 140692647406****\\n DISK_FULL\\n cn-hangzhou\\n 3306\\n vsw-bp1n874li1t5y57wi****\\n Running\\n vpc\\n cc-bp108z124a8o7****\\n cn-hangzhou-h\\n HighAvailability\\n ClickHouse\\n false\\n false\\n v1\\n 121.40.xx.xx\\n 192.168.xx.xx\\n 1.6.0\\n 1.34.0\\n false\\n \\n 05321590-BB65-4720-8CB6-8218E041CDD0\\n","errorExample":""}]', - 'title' => 'DescribeDBClusterAttribute', - ], - 'DescribeDBClusterConfig' => [ - 'summary' => 'Queries information about the parameter settings of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], - ], - ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '19440', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], - ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-wz988vja2mor4****', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '9A23C87D-87DF-4DA0-A50E-CB13F4F7923D', - ], - 'Config' => [ - 'description' => 'The information about the parameter settings of the cluster.'."\n", - 'type' => 'string', - 'example' => '[ { "name": "keep_alive_timeout", "defaultValue": 300, "currentValue": 300, "restart": true, "valueRange": ">0", "desc": "The number of seconds that ClickHouse waits for incoming requests before closing the connection." }, ... ,{ "name": "max_partition_size_to_drop", "defaultValue": 0, "currentValue": 0, "restart": true, "valueRange": ">=0", "desc": "If the size of a MergeTree partition exceeds max_partition_size_to_drop (in bytes), you can’t delete it using a DROP query." } ]', - ], - ], - 'description' => '', - ], - ], - ], - 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9A23C87D-87DF-4DA0-A50E-CB13F4F7923D\\",\\n \\"Config\\": \\"[ { \\\\\\"name\\\\\\": \\\\\\"keep_alive_timeout\\\\\\", \\\\\\"defaultValue\\\\\\": 300, \\\\\\"currentValue\\\\\\": 300, \\\\\\"restart\\\\\\": true, \\\\\\"valueRange\\\\\\": \\\\\\">0\\\\\\", \\\\\\"desc\\\\\\": \\\\\\"The number of seconds that ClickHouse waits for incoming requests before closing the connection.\\\\\\" }, ... ,{ \\\\\\"name\\\\\\": \\\\\\"max_partition_size_to_drop\\\\\\", \\\\\\"defaultValue\\\\\\": 0, \\\\\\"currentValue\\\\\\": 0, \\\\\\"restart\\\\\\": true, \\\\\\"valueRange\\\\\\": \\\\\\">=0\\\\\\", \\\\\\"desc\\\\\\": \\\\\\"If the size of a MergeTree partition exceeds max_partition_size_to_drop (in bytes), you can’t delete it using a DROP query.\\\\\\" } ]\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 9A23C87D-87DF-4DA0-A50E-CB13F4F7923D\\n [ { \\"name\\": \\"keep_alive_timeout\\", \\"defaultValue\\": 300, \\"currentValue\\": 300, \\"restart\\": true, \\"valueRange\\": \\">0\\", \\"desc\\": \\"The number of seconds that ClickHouse waits for incoming requests before closing the connection.\\" }, ... ,{ \\"name\\": \\"max_partition_size_to_drop\\", \\"defaultValue\\": 0, \\"currentValue\\": 0, \\"restart\\": true, \\"valueRange\\": \\">=0\\", \\"desc\\": \\"If the size of a MergeTree partition exceeds max_partition_size_to_drop (in bytes), you can’t delete it using a DROP query.\\" } ]\\n","errorExample":""}]', - 'title' => 'DescribeDBClusterConfig', - ], - 'ModifyDBClusterConfig' => [ - 'summary' => 'Modifies the configurations of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], - ], - ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '19466', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], - ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all the clusters that are deployed in a specific region. The information includes the cluster IDs.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1t9lbb7a4z7****', - ], - ], - [ - 'name' => 'UserConfig', - 'in' => 'query', - 'schema' => [ - 'description' => 'The names of the parameters and the new values that you want to specify for the parameters.'."\n" - ."\n" - .'> You can change the value of a single parameter. The values of parameters that are not specified will not be changed.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '{"keep_alive_timeout":"301"}', - ], - ], - [ - 'name' => 'Reason', - 'in' => 'query', - 'schema' => [ - 'description' => 'The reason for the change.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'description' => 'The response parameters.'."\n", - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'A9AA1E0A-2AEE-5847-87CF-E4FDC0E66052', - ], - ], - ], - ], - ], - 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A9AA1E0A-2AEE-5847-87CF-E4FDC0E66052\\"\\n}","errorExample":""},{"type":"xml","example":"\\n A9AA1E0A-2AEE-5847-87CF-E4FDC0E66052\\n","errorExample":""}]', - 'title' => 'ModifyDBClusterConfig', - ], - 'DescribeDBConfig' => [ - 'summary' => 'Queries configuration information about an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], - ], - ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '19445', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], - ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-t4nw17nh2e4t2****', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'description' => 'The response parameters.'."\n", - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '16060117-92E1-5F3B-BF42-28B172D0F869', - ], - 'Config' => [ - 'description' => 'The configuration information about the cluster.'."\n", - 'type' => 'string', - 'example' => 'test10.37.XX.XX9000defaultdefaultt_organization
id=1SQL_QUERY3133field1String', - ], - ], - ], - ], - ], - 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"16060117-92E1-5F3B-BF42-28B172D0F869\\",\\n \\"Config\\": \\"test10.37.XX.XX9000defaultdefaultt_organization
id=1SQL_QUERY3133field1String\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 16060117-92E1-5F3B-BF42-28B172D0F869\\n <dictionaries><dictionary><name>test</name><source><clickhouse><host>10.37.XX.XX</host><port>9000</port><user>default</user><password></password><db>default</db><table>t_organization</table><where>id=1</where><invalidate_query>SQL_QUERY</invalidate_query></clickhouse></source><lifetime><min>31</min><max>33</max></lifetime><layout><flat></flat></layout><structure><key><attribute><name>field1</name><type>String</type></attribute></key></structure></dictionary></dictionaries>\\n","errorExample":""}]', - 'title' => 'DescribeDBConfig', - ], - 'ModifyDBCluster' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], - ], - ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '19464', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', - ], - ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'title' => '实例ID', - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cc-bp19lo45sy98x****', - ], - ], - [ - 'name' => 'DBNodeGroupCount', - 'in' => 'query', - 'schema' => [ - 'description' => 'The number of nodes in the cluster.'."\n" - ."\n" - .'* If the cluster is of Single-replica Edition, the value must be an integer that ranges from 1 to 48.'."\n" - .'* If the cluster is of Double-replica Edition, the value must be an integer that ranges from 1 to 24.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '1', - ], - ], - [ - 'name' => 'DBNodeStorage', + 'name' => 'RdsPort', 'in' => 'query', - 'schema' => [ - 'description' => 'The storage capacity of a single node of the cluster. Unit: GB.'."\n" - ."\n" - .'Valid values: 100 to 32000.'."\n" - ."\n" - .'> This value is a multiple of 100.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '100', - ], + 'schema' => ['description' => 'The port number of the ApsaraDB RDS instance.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'title' => '', 'example' => '3306'], ], [ - 'name' => 'DBClusterClass', - 'in' => 'query', - 'schema' => [ - 'description' => 'The specifications of the cluster.'."\n" - ."\n" - .'* Valid values when the cluster is of Single-replica Edition:'."\n" - ."\n" - .' * **S8**'."\n" - .' * **S16**'."\n" - .' * **S32**'."\n" - .' * **S64**'."\n" - .' * **S104**'."\n" - ."\n" - .'* Valid values when the cluster is of Double-replica Edition:'."\n" - ."\n" - .' * **C8**'."\n" - .' * **C16**'."\n" - .' * **C32**'."\n" - .' * **C64**'."\n" - .' * **C104**'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'S4-NEW', - ], + 'name' => 'RdsVpcId', + 'in' => 'query', + 'schema' => ['description' => 'The VPC ID of the ApsaraDB RDS instance.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'vpc-wz9mm0qka0winfl47****'], ], [ - 'name' => 'RegionId', + 'name' => 'RdsUserName', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The database account for the ApsaraDB RDS instance.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'user2'], ], [ - 'name' => 'DbNodeStorageType', + 'name' => 'RdsPassword', 'in' => 'query', - 'allowEmptyValue' => true, - 'schema' => [ - 'description' => 'The storage type of the cluster. Valid values:'."\n" - ."\n" - .'* **CloudESSD**: The cluster uses an Enterprise SSD (ESSD) of performance level 1 (PL1).'."\n" - .'* **CloudESSD_PL2**: The cluster uses an ESSD of PL2.'."\n" - .'* **CloudESSD_PL3**: The cluster uses an ESSD of PL3.'."\n" - .'* **CloudEfficiency**: The cluster uses an ultra disk.'."\n" - .'* **CloudSSD**: The cluster uses a standard SSD.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'CloudESSD', - ], + 'schema' => ['description' => 'The password for the ApsaraDB RDS database account.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => '123456Rr'], ], [ - 'name' => 'DisableWriteWindows', + 'name' => 'RdsVpcUrl', 'in' => 'query', - 'schema' => [ - 'description' => 'The time window during which write operations are stopped. Separate the start time and end time with commas (,). Specify the time in the ISO 8601 standard.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => '2024-07-09T20:00:00+08:00,2024-07-09T21:00:00+08:00', - ], + 'schema' => ['description' => 'The internal endpoint of the ApsaraDB RDS instance.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'rm-bp16t9h3999xb0a7****.mysql.rds.aliyuncs.com'], ], ], 'responses' => [ @@ -2141,203 +563,114 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'DBCluster' => [ - 'description' => 'The clusters.'."\n", - 'type' => 'object', - 'properties' => [ - 'dbClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp19lo45sy98x****', - ], - 'orderId' => [ - 'description' => 'The order ID.'."\n", - 'type' => 'string', - 'example' => '21417210003****', - ], - ], - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'BA30A000-3A4D-5B97-9420-E5D0D49F7016', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'A82758F8-E793-5610-BE11-0E46664305C2'], + 'Status' => ['description' => 'Indicates whether a connection can be established. Valid values:'."\n" + ."\n" + .'- **true**: A connection can be established.'."\n" + ."\n" + .'- **false**: A connection cannot be established.', 'type' => 'boolean', 'title' => '', 'example' => 'false'], + 'ErrorCode' => ['description' => '- This parameter is returned only if the connection fails (**Status** is **false**).'."\n" + ."\n" + .'- It indicates the reason for the connection failure.', 'type' => 'string', 'title' => '', 'example' => 'NotSameVpc'], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"DBCluster\\": {\\n \\"dbClusterId\\": \\"cc-bp19lo45sy98x****\\",\\n \\"orderId\\": \\"21417210003****\\"\\n },\\n \\"RequestId\\": \\"BA30A000-3A4D-5B97-9420-E5D0D49F7016\\"\\n}","errorExample":""},{"type":"xml","example":"\\n \\n cc-bp19lo45sy98x****\\n 21417210003****\\n \\n BA30A000-3A4D-5B97-9420-E5D0D49F7016\\n","errorExample":""}]', - 'title' => 'ModifyDBCluster', - 'summary' => 'Upgrades or downgrades an ApsaraDB for ClickHouse cluster.', - ], - 'ModifyDBClusterDescription' => [ - 'summary' => 'Changes the name of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], - ], - ], - 'operationType' => 'write', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '19467', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', + 'title' => 'CheckClickhouseToRDS', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CheckClickhouseToRDS'], ], - 'tenantRelevance' => 'tenant', ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], + 'ramActions' => [ [ - 'name' => 'DBClusterDescription', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster name. When you set the cluster name, take note of the following rules:'."\n" - ."\n" - .'* The cluster name cannot start with http:// or https://.'."\n" - .'* The cluster name must be 2 to 256 characters in length.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'ClusterDescriptionTest', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', - ], + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:CheckClickhouseToRDS', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], - 'description' => '', - ], - ], - ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 05321590-BB65-4720-8CB6-8218E041CDD0\\n","errorExample":""}]', - 'title' => 'ModifyDBClusterDescription', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"A82758F8-E793-5610-BE11-0E46664305C2\\",\\n \\"Status\\": false,\\n \\"ErrorCode\\": \\"NotSameVpc\\"\\n}","type":"json"}]', ], - 'ModifyDBClusterMaintainTime' => [ - 'summary' => 'Modifies the maintenance window of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'CheckModifyConfigNeedRestart' => [ + 'summary' => 'Calls the CheckModifyConfigNeedRestart operation to check whether modifying configuration parameters in XML mode requires a restart for an ApsaraDB for ClickHouse Community-compatible Edition cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '19468', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', - ], - 'tenantRelevance' => 'tenant', + 'operationType' => 'get', + 'abilityTreeCode' => '152285', + 'abilityTreeNodes' => ['FEATUREclickhouseMCDGZK'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all clusters in the specified region, including cluster IDs.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp1tm8zf130ew****', 'title' => ''], ], [ - 'name' => 'MaintainTime', + 'name' => 'Config', 'in' => 'query', - 'schema' => [ - 'description' => 'The maintenance window of the cluster. Specify the time in the HH:mmZ-HH:mmZ format. The time must be in Coordinated Universal Time (UTC).'."\n" - ."\n" - .'For example, a value of 00:00Z-01:00Z indicates that routine maintenance can be performed on the cluster from 08:00 (UTC+8) to 09:00 (UTC+8).'."\n" - ."\n" - .'> You can set the start time and end time of the maintenance window to the time on the hour, and the maintenance window is 1 hour.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '00:00Z-01:00Z', - ], + 'schema' => ['description' => 'The configuration parameters to be modified.', 'type' => 'string', 'required' => true, 'example' => ''."\n" + .''."\n" + .' 400'."\n" + .' 4096'."\n" + .' '."\n" + .' debug'."\n" + .' 1000M'."\n" + .' '."\n" + .' 5368709120'."\n" + .' 201'."\n" + .' 4096'."\n" + .' 0'."\n" + .' 0'."\n" + .' '."\n" + .' 256'."\n" + .' auto'."\n" + .' 100'."\n" + .' 1'."\n" + .' '."\n" + .' 1717986918'."\n" + .'', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => '', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', - ], + 'NeedRestart' => ['description' => 'Indicates whether a restart is required after the configuration parameters are modified. Valid values:'."\n" + .'- **true**: A restart is required.'."\n" + .'- **false**: A restart is not required.', 'type' => 'boolean', 'example' => 'true', 'title' => ''], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '06798FEE-BEF2-5FAF-A30D-728973BBE97C', 'title' => ''], ], - 'description' => '', - ], - ], - ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'example' => '', ], ], ], @@ -2345,228 +678,110 @@ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 05321590-BB65-4720-8CB6-8218E041CDD0\\n","errorExample":""}]', - 'title' => 'ModifyDBClusterMaintainTime', - ], - 'DescribeAllDataSources' => [ - 'summary' => 'Queries the data sources of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'Check whether modifying configuration parameters requires a restart', + 'description' => '>This operation supports only Community-compatible Edition clusters created after December 1, 2021.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:CheckModifyConfigNeedRestart', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"NeedRestart\\": true,\\n \\"RequestId\\": \\"06798FEE-BEF2-5FAF-A30D-728973BBE97C\\"\\n}","type":"json"}]', + ], + 'CheckMonitorAlert' => [ + 'summary' => 'Call the CheckMonitorAlert operation to check whether the alert monitoring feature of Application Real-Time Monitoring Service (ARMS) is enabled for a specified ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', + 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '19433', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '81031', + 'abilityTreeNodes' => ['FEATUREclickhouse1YZKWF'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], - [ - 'name' => 'SchemaName', - 'in' => 'query', - 'schema' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'database', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp13s14l8498l****'], ], [ - 'name' => 'TableName', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The table name.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'table', - ], + 'schema' => ['description' => 'The region ID. Call the [DescribeRegions](~~170875~~) operation to query region IDs.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'The response parameters.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '75EA41D7-025A-50A6-9287-359A91399F1E', - ], - 'Tables' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Table' => [ - 'description' => 'The information about the tables.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'TableName' => [ - 'description' => 'The table name.'."\n", - 'type' => 'string', - 'example' => 'table', - ], - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp108z124a8o7****', - ], - 'SchemaName' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'example' => 'database', - ], - ], - ], - ], - ], - ], - 'Columns' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Column' => [ - 'description' => 'Details of the columns.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => 'The column type.'."\n", - 'type' => 'string', - 'example' => 'String', - ], - 'ColumnName' => [ - 'description' => 'The column name.'."\n", - 'type' => 'string', - 'example' => 'name', - ], - 'TableName' => [ - 'description' => 'The table name.'."\n", - 'type' => 'string', - 'example' => 'table', - ], - 'AutoIncrementColumn' => [ - 'description' => 'Indicates whether the column is an auto-increment column. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp108z124a8o7****', - ], - 'PrimaryKey' => [ - 'description' => 'Indicates whether the column is the primary key of the table. Valid values:'."\n" - ."\n" - .'* **true**: The column is the primary key of the table.'."\n" - .'* **false**: The column is not the primary key of the table.'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'SchemaName' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'example' => 'database', - ], - ], - ], - ], - ], - ], - 'Schemas' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Schema' => [ - 'description' => 'The information about the databases.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp108z124a8o7****', - ], - 'SchemaName' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'example' => 'database', - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '94F92113-FF63-5E57-8401-6FE123AD11DD'], + 'State' => ['description' => 'Indicates whether the alert monitoring feature is enabled. Valid values:'."\n" + ."\n" + .'- **enable**: The feature is enabled.'."\n" + ."\n" + .'- **disable**: The feature is disabled.', 'type' => 'string', 'title' => '', 'example' => 'enable'], + 'Parameter' => ['description' => 'The parameters for alert monitoring.', 'type' => 'string', 'title' => '', 'example' => '{ "monitor":{ "key1":"value1", "key2":"value2" }, "alert":{ "key1":"value1", "key2":"value2" } }'], ], - 'description' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"75EA41D7-025A-50A6-9287-359A91399F1E\\",\\n \\"Tables\\": {\\n \\"Table\\": [\\n {\\n \\"TableName\\": \\"table\\",\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n },\\n \\"Columns\\": {\\n \\"Column\\": [\\n {\\n \\"Type\\": \\"String\\",\\n \\"ColumnName\\": \\"name\\",\\n \\"TableName\\": \\"table\\",\\n \\"AutoIncrementColumn\\": true,\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"PrimaryKey\\": true,\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n },\\n \\"Schemas\\": {\\n \\"Schema\\": [\\n {\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 75EA41D7-025A-50A6-9287-359A91399F1E\\n \\n table\\n cc-bp108z124a8o7****\\n database\\n \\n \\n String\\n name\\n table\\n true\\n cc-bp108z124a8o7****\\n true\\n database\\n \\n \\n cc-bp108z124a8o7****\\n database\\n \\n","errorExample":""}]', - 'title' => 'DescribeAllDataSources', - ], - 'DescribeAllDataSource' => [ - 'summary' => 'Queries a list of databases, tables, and columns in an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"94F92113-FF63-5E57-8401-6FE123AD11DD\\",\\n \\"State\\": \\"enable\\",\\n \\"Parameter\\": \\"{ \\\\\\"monitor\\\\\\":{ \\\\\\"key1\\\\\\":\\\\\\"value1\\\\\\", \\\\\\"key2\\\\\\":\\\\\\"value2\\\\\\" }, \\\\\\"alert\\\\\\":{ \\\\\\"key1\\\\\\":\\\\\\"value1\\\\\\", \\\\\\"key2\\\\\\":\\\\\\"value2\\\\\\" } }\\"\\n}","type":"json"}]', + 'title' => 'CheckMonitorAlert', + 'description' => '> This operation applies only to community-compatible clusters of version 20.8 or later that were created after December 1, 2021.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CheckMonitorAlert'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:CheckMonitorAlert', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + ], + 'CheckScaleOutBalanced' => [ + 'summary' => 'Performs a migration scale-out check on a specified ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2576,44 +791,43 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '19432', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseMCDGZK', - ], + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '19419', + 'abilityTreeNodes' => ['FEATUREclickhouse07PB80'], ], 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the region ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp108z124a8o7****', 'title' => ''], ], [ - 'name' => 'SchemaName', + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => 'The number of entries per page. Valid values:'."\n" + .'- **30** (default)'."\n" + .'- **50**'."\n" + .'- **100**.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '30', 'example' => '30', 'title' => ''], + ], + [ + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'database', - ], + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'example' => '1', 'title' => ''], ], [ - 'name' => 'TableName', + 'name' => 'ScalingType', 'in' => 'query', - 'schema' => [ - 'description' => 'The table name.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'table', - ], + 'schema' => ['description' => 'The specification change type. Valid values:'."\n" + .'- ScaleOut: horizontal scale-out'."\n" + .'- ScaleIn: horizontal scale-in'."\n" + .'- MultiAzUpgrade: upgrade to multi-active zone deployment'."\n" + .'- DiskDownGrade: cloud disk downgrade.', 'type' => 'string', 'required' => false, 'example' => 'ScaleOut', 'title' => ''], ], ], 'responses' => [ @@ -2621,158 +835,89 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', - ], - 'Tables' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Table' => [ - 'description' => 'The information about the tables.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'TableName' => [ - 'description' => 'The table name.'."\n", - 'type' => 'string', - 'example' => 'table', - ], - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp108z124a8o7****', - ], - 'SchemaName' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'example' => 'database', - ], - ], - ], - ], - ], - ], - 'Columns' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Column' => [ - 'description' => 'The information about the columns.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => 'The type of the column.'."\n", - 'type' => 'string', - 'example' => 'String', - ], - 'ColumnName' => [ - 'description' => 'The column name.'."\n", - 'type' => 'string', - 'example' => 'name', - ], - 'TableName' => [ - 'description' => 'The table name.'."\n", - 'type' => 'string', - 'example' => 'table', - ], - 'AutoIncrementColumn' => [ - 'description' => 'Indicates whether the column is an auto-increment column. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp108z124a8o7****', - ], - 'PrimaryKey' => [ - 'description' => 'Indicates whether the column is the primary key of the table. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'SchemaName' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'example' => 'database', - ], - ], - ], - ], - ], - ], - 'Schemas' => [ + 'TotalCount' => ['description' => 'The total number of entries.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'TableDetails' => [ 'type' => 'object', 'itemNode' => true, 'properties' => [ - 'Schema' => [ - 'description' => 'The information about the databases.'."\n", + 'TableDetail' => [ + 'description' => 'The check failure information.', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp108z124a8o7****', - ], - 'SchemaName' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'example' => 'database', - ], + 'TableName' => ['description' => 'The local table name.', 'type' => 'string', 'example' => 'test', 'title' => ''], + 'Cluster' => ['description' => 'The cluster. The value is fixed as **default**.', 'type' => 'string', 'example' => 'default', 'title' => ''], + 'Database' => ['description' => 'The database name.', 'type' => 'string', 'example' => 'db_name', 'title' => ''], + 'Detail' => ['description' => 'The exception details. Valid values:'."\n" + ."\n" + .'- **1**: The unique distributed table is missing.'."\n" + .'- **2**: The corresponding distributed table is not unique.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], ], - ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', 'title' => ''], + 'PageSize' => ['description' => 'The number of entries per page. Valid values:'."\n" + .'- **30** (default)'."\n" + .'- **50**'."\n" + .'- **100**.', 'type' => 'integer', 'format' => 'int32', 'example' => '30', 'title' => ''], + 'PageNumber' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'CheckCode' => ['description' => 'The check result. Valid values:'."\n" + .'- **400**: The check failed.'."\n" + .'- **200**: The check succeeded.', 'type' => 'string', 'example' => '400', 'title' => ''], + 'TimeDuration' => ['description' => 'The time required for the migration scale-out. Unit: minutes.', 'type' => 'string', 'example' => '21', 'title' => ''], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\",\\n \\"Tables\\": {\\n \\"Table\\": [\\n {\\n \\"TableName\\": \\"table\\",\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n },\\n \\"Columns\\": {\\n \\"Column\\": [\\n {\\n \\"Type\\": \\"String\\",\\n \\"ColumnName\\": \\"name\\",\\n \\"TableName\\": \\"table\\",\\n \\"AutoIncrementColumn\\": true,\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"PrimaryKey\\": true,\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n },\\n \\"Schemas\\": {\\n \\"Schema\\": [\\n {\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 05321590-BB65-4720-8CB6-8218E041CDD0\\n \\n table\\n cc-bp108z124a8o7****\\n database\\n \\n \\n String\\n name\\n table\\n true\\n cc-bp108z124a8o7****\\n true\\n database\\n \\n \\n cc-bp108z124a8o7****\\n database\\n \\n","errorExample":""}]', - 'title' => 'DescribeAllDataSource', - ], - 'DescribeSchemas' => [ - 'summary' => 'Queries a list of all databases in an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": 1,\\n \\"TableDetails\\": {\\n \\"TableDetail\\": [\\n {\\n \\"TableName\\": \\"test\\",\\n \\"Cluster\\": \\"default\\",\\n \\"Database\\": \\"db_name\\",\\n \\"Detail\\": 1\\n }\\n ]\\n },\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"CheckCode\\": \\"400\\",\\n \\"TimeDuration\\": \\"21\\"\\n}","type":"json"}]', + 'title' => 'Scale-out check', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:CheckScaleOutBalanced', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + ], + 'CheckServiceLinkedRole' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2782,22 +927,114 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '19456', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseMCDGZK', + 'abilityTreeCode' => '19420', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + ], + 'parameters' => [], + 'responses' => [ + 200 => [ + 'schema' => [ + 'description' => 'list', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The ID of the request.', 'type' => 'string', 'title' => '', 'example' => '66428721-xxxx-xxxx-xxxx-3BD1B67837E0'."\n"], + 'HasServiceLinkedRole' => ['description' => 'Indicates whether the service-linked role exists.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], + ], + 'title' => '', + 'example' => '', + ], + ], + ], + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'CheckServiceLinkedRole', + 'summary' => 'Queries the service-linked role for ApsaraDB for ClickHouse.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:CheckServiceLinkedRole', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"66428721-xxxx-xxxx-xxxx-3BD1B67837E0\\\\n\\",\\n \\"HasServiceLinkedRole\\": true\\n}","type":"json"}]', + ], + 'CreateAccount' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], ], ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'abilityTreeCode' => '19421', + 'abilityTreeNodes' => ['FEATUREclickhouse2H8YOY'], + 'tenantRelevance' => 'tenant', + ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['description' => 'The cluster ID.'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp108z124a8o7****', 'title' => ''], + ], + [ + 'name' => 'AccountName', + 'in' => 'query', + 'schema' => ['description' => 'The name of the database account.'."\n" + ."\n" + .'> '."\n" + ."\n" + .'* The name must be unique in the cluster.'."\n" + ."\n" + .'* The name can contain lowercase letters, digits, and underscores (\\_).'."\n" + .'* The name must start with a lowercase letter and end with a lowercase letter or a digit.'."\n" + .'* The name must be 2 to 64 characters in length.'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'test', 'title' => ''], + ], + [ + 'name' => 'AccountPassword', + 'in' => 'query', + 'schema' => ['description' => 'The password of the database account.'."\n" + ."\n" + .'> '."\n" + ."\n" + .'* The password must contain at least three types of the following characters: uppercase letters, lowercase letters, digits, and special characters.'."\n" + ."\n" + .'* The password can contain the following special characters: ! @ # $ % ^ & \\* ( ) \\_ + - ='."\n" + .'* The password must be 8 to 32 characters in length.'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '123789Ff!', 'title' => ''], + ], + [ + 'name' => 'AccountDescription', + 'in' => 'query', + 'schema' => ['description' => 'The description of the database account.'."\n" + ."\n" + .'> '."\n" + ."\n" + .'* The description cannot start with http:// or https://.'."\n" + ."\n" + .'* The description must be 0 to 256 characters in length.'."\n", 'type' => 'string', 'required' => false, 'example' => 'ceshi', 'title' => ''], ], ], 'responses' => [ @@ -2805,73 +1042,50 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', - ], - 'Items' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Schema' => [ - 'description' => 'The information about the databases of the cluster.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp108z124a8o7****', - ], - 'SchemaName' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'example' => 'database', - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => 'The request ID.'."\n", 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', 'title' => ''], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\",\\n \\"Items\\": {\\n \\"Schema\\": [\\n {\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 05321590-BB65-4720-8CB6-8218E041CDD0\\n \\n cc-bp108z124a8o7****\\n database\\n \\n","errorExample":""}]', - 'title' => 'DescribeSchemas', - ], - 'DescribeTables' => [ - 'summary' => 'Queries the information about tables in a database of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - 'put', + 'title' => 'CreateAccount', + 'summary' => 'Creates a database account for an ApsaraDB for ClickHouse cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateAccount'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateAccount', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 2FED790E-FB61-4721-8C1C-07C627FA5A19\\n","errorExample":""}]', + ], + 'CreateAccountAndAuthority' => [ + 'summary' => 'Creates a database account and grants permissions.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2880,34 +1094,91 @@ 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '19459', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseMCDGZK', - ], + 'operationType' => 'create', + 'abilityTreeCode' => '19422', + 'abilityTreeNodes' => ['FEATUREclickhouseL1079N', 'FEATUREclickhouse2H8YOY'], ], 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp1p816075e21****', 'title' => ''], ], [ - 'name' => 'SchemaName', + 'name' => 'AccountName', 'in' => 'query', - 'schema' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'database', - ], + 'schema' => ['description' => 'The name of the database account.'."\n" + ."\n" + .'- Must be unique within the cluster.'."\n" + ."\n" + .'- Can contain only lowercase letters, digits, and underscores (\\_).'."\n" + ."\n" + .'- Must start with a lowercase letter and end with a lowercase letter or a digit.'."\n" + ."\n" + .'- Must be 2 to 64 characters in length.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'test', 'title' => ''], + ], + [ + 'name' => 'AccountPassword', + 'in' => 'query', + 'schema' => ['description' => 'The password for the database account.'."\n" + ."\n" + .'> - Must contain characters from at least three of the following types: uppercase letters, lowercase letters, digits, and special characters.'."\n" + ."\n" + .'- The supported special characters are `!@#$%^&*()_+-=`.'."\n" + ."\n" + .'- Must be 8 to 32 characters in length.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '123456Aa', 'title' => ''], + ], + [ + 'name' => 'AccountDescription', + 'in' => 'query', + 'schema' => ['description' => 'The description of the database account.'."\n" + ."\n" + .'- Cannot start with `http://` or `https://`.'."\n" + ."\n" + .'- Must be 0 to 256 characters in length.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'ceshi', 'title' => ''], + ], + [ + 'name' => 'DmlAuthority', + 'in' => 'query', + 'schema' => ['description' => 'Specifies the DML permissions for the database account. Valid values:'."\n" + ."\n" + .'- **all**: read, write, and settings permissions.'."\n" + ."\n" + .'- **readOnly,modify**: read and settings permissions.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'all', 'title' => ''], + ], + [ + 'name' => 'DdlAuthority', + 'in' => 'query', + 'schema' => ['description' => 'Specifies whether to grant DDL permissions to the database account. Valid values:'."\n" + ."\n" + .'- **true**: DDL operations are allowed.'."\n" + ."\n" + .'- **false**: DDL operations are denied.', 'type' => 'boolean', 'required' => true, 'docRequired' => true, 'example' => 'true', 'title' => ''], + ], + [ + 'name' => 'AllowDatabases', + 'in' => 'query', + 'schema' => ['description' => 'The databases to which the account has permissions. Separate multiple database names with commas (,).', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'db1', 'title' => ''], + ], + [ + 'name' => 'TotalDatabases', + 'in' => 'query', + 'schema' => ['description' => 'All databases in the cluster. Separate multiple database names with commas (,).', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'db1,db2', 'title' => ''], + ], + [ + 'name' => 'AllowDictionaries', + 'in' => 'query', + 'schema' => ['description' => 'The dictionaries to which the account has permissions. Separate multiple dictionary names with commas (,).', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'dt1', 'title' => ''], + ], + [ + 'name' => 'TotalDictionaries', + 'in' => 'query', + 'schema' => ['description' => 'All dictionaries in the cluster. Separate multiple dictionary names with commas (,).', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'dt1,dt2', 'title' => ''], ], ], 'responses' => [ @@ -2915,126 +1186,105 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', - ], - 'Items' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Table' => [ - 'description' => 'The information about the tables.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'TableName' => [ - 'description' => 'The table name.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp108z124a8o7****', - ], - 'SchemaName' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'example' => 'database', - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', 'title' => ''], ], - 'description' => '', + 'description' => 'The returned data.', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","type":"json"}]', + 'title' => 'CreateAccountAndAuthority', + 'description' => 'This API is available only for cluster versions 21.8 and earlier. For newer versions, use a high-privilege account and SQL statements to modify user permissions.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateAccountAndAuthority'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateAccountAndAuthority', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\",\\n \\"Items\\": {\\n \\"Table\\": [\\n {\\n \\"TableName\\": \\"test\\",\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 05321590-BB65-4720-8CB6-8218E041CDD0\\n \\n test\\n cc-bp108z124a8o7****\\n database\\n \\n","errorExample":""}]', - 'title' => 'DescribeTables', ], - 'DescribeColumns' => [ - 'summary' => 'Queries information about columns.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'CreateBackupPolicy' => [ + 'summary' => 'Creates a backup policy.', + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '19437', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseMCDGZK', - ], + 'operationType' => 'create', + 'abilityTreeCode' => '19423', + 'abilityTreeNodes' => ['FEATUREclickhouseYFBZ0B'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-2zeux3ua25242****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'SchemaName', + 'name' => 'PreferredBackupTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The database name. You can call the [DescribeSchemas](~~350931~~) operation to query database names.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'database', - ], + 'schema' => ['description' => 'The backup time in UTC. The format is HH:mmZ-HH:mmZ.'."\n" + ."\n" + .'Example: 00:00Z-01:00Z. This means that data backup can be performed from 00:00 to 01:00 UTC (08:00 to 09:00 UTC+8).', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '10:00Z-11:00Z'], ], [ - 'name' => 'TableName', + 'name' => 'PreferredBackupPeriod', 'in' => 'query', - 'schema' => [ - 'description' => 'The table name. You can call the [DescribeTables](~~350932~~) operation to query table names.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'table', - ], + 'schema' => ['description' => 'The backup cycle. If you specify multiple days, separate them with commas. Valid values:'."\n" + ."\n" + .'- **Monday**'."\n" + ."\n" + .'- **Tuesday**'."\n" + ."\n" + .'- **Wednesday**'."\n" + ."\n" + .'- **Thursday**'."\n" + ."\n" + .'- **Friday**'."\n" + ."\n" + .'- **Saturday**'."\n" + ."\n" + .'- **Sunday**', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'Monday,Friday'], + ], + [ + 'name' => 'BackupRetentionPeriod', + 'in' => 'query', + 'schema' => ['description' => 'The backup retention period in days. The value must be an integer from 7 to 730. The default value is 7.', 'type' => 'string', 'required' => false, 'default' => '7', 'title' => '', 'example' => '8'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID. Call the [DescribeRegions](~~170875~~) operation to query the region ID.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'cn-hangzhou'], ], ], 'responses' => [ @@ -3042,421 +1292,492 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '66428721-FFEC-5023-B4E5-3BD1B67837E0', - ], - 'Items' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Column' => [ - 'description' => 'Details of the columns.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => 'The column type.'."\n", - 'type' => 'string', - 'example' => 'String', - ], - 'ColumnName' => [ - 'description' => 'The column name.'."\n", - 'type' => 'string', - 'example' => 'name', - ], - 'TableName' => [ - 'description' => 'The table name.'."\n", - 'type' => 'string', - 'example' => 'table', - ], - 'AutoIncrementColumn' => [ - 'description' => 'Indicates whether the column is an auto-increment column. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-2zeux3ua25242****', - ], - 'PrimaryKey' => [ - 'description' => 'Indicates whether the column is the primary key of the table. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'SchemaName' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'example' => 'database', - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"66428721-FFEC-5023-B4E5-3BD1B67837E0\\",\\n \\"Items\\": {\\n \\"Column\\": [\\n {\\n \\"Type\\": \\"String\\",\\n \\"ColumnName\\": \\"name\\",\\n \\"TableName\\": \\"table\\",\\n \\"AutoIncrementColumn\\": true,\\n \\"DBClusterId\\": \\"cc-2zeux3ua25242****\\",\\n \\"PrimaryKey\\": true,\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 66428721-FFEC-5023-B4E5-3BD1B67837E0\\n \\n String\\n name\\n table\\n true\\n cc-2zeux3ua25242****\\n true\\n database\\n \\n","errorExample":""}]', - 'title' => 'DescribeColumns', - ], - 'RestartInstance' => [ - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'CreateBackupPolicy', + 'description' => '> ApsaraDB for ClickHouse supports data backup for clusters that run version 20.3, 20.8, or 21.8.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateBackupPolicy'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","type":"json"}]', + ], + 'CreateDBInstance' => [ + 'summary' => 'Create an Alibaba Cloud ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '38056', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', - ], + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'paid', + 'abilityTreeCode' => '19424', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], + 'tenantRelevance' => 'publicInformation', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) API to query the latest region list.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'ZoneId', + 'in' => 'query', + 'schema' => ['description' => 'The availability zone ID. You can call the [DescribeRegions](~~170875~~) API to query the latest availability zone list.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou-h', 'title' => ''], + ], + [ + 'name' => 'DBClusterVersion', + 'in' => 'query', 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", + 'description' => 'The engine version. Valid values:'."\n" + ."\n" + .'- **21.8.10.19**'."\n" + ."\n" + .'- **22.8.5.29**', + 'enumValueTitles' => ['22.8.5.29' => '22.8.5.29', '21.8.10.19' => '21.8.10.19'], 'type' => 'string', 'required' => true, 'docRequired' => true, - 'example' => 'cn-hangzhou', + 'example' => '22.8.5.29', + 'title' => '', ], ], [ - 'name' => 'DBClusterId', + 'name' => 'DBClusterCategory', 'in' => 'query', 'schema' => [ - 'description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all the clusters that are deployed in a specific region. The information includes the cluster IDs.'."\n", + 'description' => 'The replica configuration. Valid values:'."\n" + ."\n" + .'- **Basic**: single-replica'."\n" + ."\n" + .'- **HighAvailability**: high availability (dual-replica)', + 'enumValueTitles' => ['Basic' => 'Basic', 'HighAvailability' => 'HighAvailability'], 'type' => 'string', 'required' => true, 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', + 'example' => 'Basic', + 'title' => '', ], ], [ - 'name' => 'PageSize', + 'name' => 'DBClusterClass', + 'in' => 'query', + 'schema' => ['description' => 'The instance type.'."\n" + ."\n" + .'- For single-replica clusters, valid values are:'."\n" + ."\n" + .' - **LS20**: Large-storage, 20 cores, 88 GB'."\n" + ."\n" + .' - **LS40**: Large-storage, 40 cores, 176 GB'."\n" + ."\n" + .' - **LS80**: Large-storage, 80 cores, 352 GB'."\n" + ."\n" + .' - **S8**: Standard, 8 cores, 32 GB'."\n" + ."\n" + .' - **S16**: Standard, 16 cores, 64 GB'."\n" + ."\n" + .' - **S32**: Standard, 32 cores, 128 GB'."\n" + ."\n" + .' - **S64**: Standard, 64 cores, 256 GB'."\n" + ."\n" + .' - **S80**: Standard, 80 cores, 384 GB'."\n" + ."\n" + .' - **S104**: Standard, 104 cores, 384 GB'."\n" + ."\n" + .'- For high availability clusters, valid values are:'."\n" + ."\n" + .' - **LC20**: Large-storage, 20 cores, 88 GB'."\n" + ."\n" + .' - **LC40**: Large-storage, 40 cores, 176 GB'."\n" + ."\n" + .' - **LC80**: Large-storage, 80 cores, 352 GB'."\n" + ."\n" + .' - **C8**: Standard, 8 cores, 32 GB'."\n" + ."\n" + .' - **C16**: Standard, 16 cores, 64 GB'."\n" + ."\n" + .' - **C32**: Standard, 32 cores, 128 GB'."\n" + ."\n" + .' - **C64**: Standard, 64 cores, 256 GB'."\n" + ."\n" + .' - **C80**: Standard, 80 cores, 384 GB'."\n" + ."\n" + .' - **C104**: Standard, 104 cores, 384 GB'."\n" + ."\n" + .''."\n" + ."\n" + .'- For single-replica clusters, valid values are:'."\n" + ."\n" + .' - **S8**: 8 cores, 32 GB'."\n" + ."\n" + .' - **S16**: 16 cores, 64 GB'."\n" + ."\n" + .' - **S32**: 32 cores, 128 GB'."\n" + ."\n" + .' - **S64**: 64 cores, 256 GB'."\n" + ."\n" + .' - **S104**: 104 cores, 384 GB'."\n" + ."\n" + .'- For high availability clusters, valid values are:'."\n" + ."\n" + .' - **C8**: 8 cores, 32 GB'."\n" + ."\n" + .' - **C16**: 16 cores, 64 GB'."\n" + ."\n" + .' - **C32**: 32 cores, 128 GB'."\n" + ."\n" + .' - **C64**: 64 cores, 256 GB'."\n" + ."\n" + .' - **C104**: 104 cores, 384 GB'."\n" + ."\n" + .'', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'S8', 'title' => ''], + ], + [ + 'name' => 'DBNodeGroupCount', + 'in' => 'query', + 'schema' => ['description' => 'The number of nodes.'."\n" + ."\n" + .'- For single-replica clusters, the valid range is 1–48.'."\n" + ."\n" + .'- For high availability clusters, the valid range is 1–24.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '1', 'title' => ''], + ], + [ + 'name' => 'DBNodeStorage', + 'in' => 'query', + 'schema' => ['description' => 'The storage capacity per node, in GB. The valid range is 100–32,000.'."\n" + ."\n" + .'> The value must be a multiple of 100.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '100', 'title' => ''], + ], + [ + 'name' => 'DBClusterNetworkType', + 'in' => 'query', + 'schema' => ['description' => 'The network type. Currently, only VPC is supported.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'VPC', 'title' => ''], + ], + [ + 'name' => 'DBClusterDescription', + 'in' => 'query', + 'schema' => ['description' => 'The cluster description.', 'type' => 'string', 'required' => false, 'example' => 'test', 'title' => ''], + ], + [ + 'name' => 'PayType', 'in' => 'query', 'schema' => [ - 'description' => 'The number of entries to return per page. Default value: 30. Valid values:'."\n" + 'description' => 'The billing method. Valid values:'."\n" ."\n" - .'* 30'."\n" - .'* 50'."\n" - .'* 100'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', + .'- **Postpaid**: pay-as-you-go'."\n" + ."\n" + .'- **Prepaid**: subscription', + 'enumValueTitles' => ['Prepaid' => 'Prepaid', 'Postpaid' => 'Postpaid'], + 'type' => 'string', + 'required' => true, + 'docRequired' => true, + 'example' => 'Prepaid', + 'title' => '', ], ], [ - 'name' => 'PageNumber', + 'name' => 'Period', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of pages to return.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => 'The subscription duration unit.'."\n" + .'>This parameter is required only when `PayType` is set to `Prepaid`.>'."\n" + ."\n" + .'- **Year**: Measured in years.'."\n" + ."\n" + .'- **Month**: Measured in months.', 'type' => 'string', 'required' => false, 'example' => 'Month', 'title' => ''], ], [ - 'name' => 'RestartTime', + 'name' => 'UsedTime', 'in' => 'query', - 'allowEmptyValue' => true, + 'schema' => ['description' => 'The subscription duration.'."\n" + .'>This parameter is required only when `PayType` is set to `Prepaid`.>'."\n" + ."\n" + .'- If `Period` is `Year`, the valid range is 1–3.'."\n" + ."\n" + .'- If `Period` is `Month`, the valid range is 1–9.', 'type' => 'string', 'required' => false, 'example' => '1', 'title' => ''], + ], + [ + 'name' => 'VPCId', + 'in' => 'query', + 'schema' => ['description' => 'The VPC ID.', 'type' => 'string', 'required' => true, 'example' => 'vpc-bp175iuvg8nxqraf2****', 'title' => ''], + ], + [ + 'name' => 'VSwitchId', + 'in' => 'query', + 'schema' => ['description' => 'The VSwitch ID.', 'type' => 'string', 'required' => true, 'example' => 'vsw-bp1gzt31twhlo0sa5****', 'title' => ''], + ], + [ + 'name' => 'ClientToken', + 'in' => 'query', + 'schema' => ['description' => 'A client token used to ensure request idempotence. The value must be a string of no more than 64 ASCII characters.', 'type' => 'string', 'required' => false, 'example' => 'AB', 'title' => ''], + ], + [ + 'name' => 'DbNodeStorageType', + 'in' => 'query', + 'schema' => ['description' => 'The storage type. Valid values:'."\n" + ."\n" + .''."\n" + ."\n" + .'- **CloudESSD\\_PL0**: ESSD PL0 cloud disk'."\n" + ."\n" + .''."\n" + ."\n\n" + .'- **CloudESSD**: ESSD PL1 cloud disk'."\n" + ."\n" + .'- **CloudESSD\\_PL2**: ESSD PL2 cloud disk'."\n" + ."\n" + .'- **CloudESSD\\_PL3**: ESSD PL3 cloud disk'."\n" + ."\n" + .'- **CloudEfficiency**: Ultra Disk', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'CloudESSD_PL2', 'title' => ''], + ], + [ + 'name' => 'EncryptionKey', + 'in' => 'query', + 'schema' => ['description' => 'This parameter is required when `EncryptionType` is set to `CloudDisk`.'."\n" + ."\n" + .'The ID of the cloud disk encryption key. You can create and manage keys in the Key Management Service console.'."\n" + ."\n" + .'> If `EncryptionType` is not specified, you do not need to specify this parameter.', 'type' => 'string', 'required' => false, 'example' => '0d2470df-da7b-4786-b981-9a164dae****', 'title' => ''], + ], + [ + 'name' => 'EncryptionType', + 'in' => 'query', + 'schema' => ['description' => 'The encryption type. Only cloud disk encryption is supported. Set this value to **CloudDisk**.'."\n" + ."\n" + .'> If you do not specify this parameter, encryption is disabled.', 'type' => 'string', 'required' => false, 'example' => 'CloudDisk', 'title' => ''], + ], + [ + 'name' => 'BackupSetID', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the backup set. You can call the [DescribeBackups](~~360339~~) API to query backup set IDs.'."\n" + ."\n" + .'> This parameter is required when restoring data to an ApsaraDB for ClickHouse cluster.', 'type' => 'string', 'required' => false, 'example' => 'b-12af23adsf', 'title' => ''], + ], + [ + 'name' => 'SourceDBClusterId', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the source cluster. You can call the [DescribeDBClusters](~~170879~~) API to query cluster IDs.'."\n" + ."\n" + .'> This parameter is required when restoring data to an ApsaraDB for ClickHouse cluster.', 'type' => 'string', 'required' => false, 'example' => 'cc-bp1lxbo89u950****', 'title' => ''], + ], + [ + 'name' => 'ResourceGroupId', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the resource group that contains the cluster.', 'type' => 'string', 'required' => false, 'example' => 'rg-4690g37929****', 'title' => ''], + ], + [ + 'name' => 'ZoneIdBak', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the secondary availability zone.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou-k', 'title' => ''], + ], + [ + 'name' => 'VSwitchBak', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the secondary VSwitch.', 'type' => 'string', 'title' => '', 'required' => false, 'example' => 'vsw-bp1gzt31twhlo0sa5****'], + ], + [ + 'name' => 'ZondIdBak2', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the second standby availability zone.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou-j', 'title' => ''], + ], + [ + 'name' => 'VSwitchBak2', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the second standby VSwitch.', 'type' => 'string', 'title' => '', 'required' => false, 'example' => 'vsw-bp1gzt31twhlo0sa5****'], + ], + [ + 'name' => 'AutoRenew', + 'in' => 'query', + 'schema' => ['description' => 'Specifies whether to enable auto-renewal.'."\n" + ."\n" + .'> This parameter applies only when `PayType` is set to `Prepaid`.', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'title' => ''], + ], + [ + 'name' => 'Tags', + 'in' => 'query', + 'style' => 'repeatList', 'schema' => [ - 'description' => 'The scheduled restart time. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time must be in Coordinated Universal Time (UTC).'."\n" - ."\n" - .'> If this parameter is left empty or the time specified by this parameter is earlier than the current time, the cluster is immediately restarted.'."\n", - 'type' => 'string', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'key' => ['description' => 'The tag key.', 'type' => 'string', 'example' => 'user123', 'title' => '', 'required' => false], + 'value' => ['description' => 'The tag value.', 'type' => 'string', 'example' => 'Example string', 'title' => '', 'required' => false], + ], + 'title' => '', + 'description' => 'A tag.', + 'required' => false, + 'example' => '', + ], + 'maxItems' => 20, + 'minItems' => 0, + 'title' => '', + 'description' => 'The tags to add to the cluster.', 'required' => false, - 'example' => '2023-03-22T00:00:50Z', + 'example' => '', ], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ + 'description' => 'The response data.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], + 'RequestId' => ['description' => 'The unique ID of the request.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', 'title' => ''], + 'DBClusterId' => ['description' => 'The ID of the cluster.', 'type' => 'string', 'example' => 'cc-bp1qx68m06981****', 'title' => ''], + 'OrderId' => ['description' => 'The ID of the order.', 'type' => 'string', 'example' => '21137950671****', 'title' => ''], ], - 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","errorExample":""},{"type":"xml","example":"\\n F5178C10-1407-4987-9133-DE4DC9119F75\\n","errorExample":""}]', - 'title' => 'RestartInstance', - 'summary' => 'Restarts an ApsaraDB for ClickHouse cluster.', - ], - 'CheckScaleOutBalanced' => [ - 'summary' => 'Performs migration and scale-out detection on an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"DBClusterId\\": \\"cc-bp1qx68m06981****\\",\\n \\"OrderId\\": \\"21137950671****\\"\\n}","type":"json"}]', + 'title' => 'CreateDBInstance', + 'description' => 'Before you call this API, make sure that you understand the billing method and [price](~~167450~~) of ApsaraDB for ClickHouse.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateDBInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'translator' => 'machine', + ], + 'CreateMonitorDataReport' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], - ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '19419', - 'abilityTreeNodes' => [ - 'FEATUREclickhouse07PB80', - ], - ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'abilityTreeCode' => '81430', + 'abilityTreeNodes' => ['FEATUREclickhouse1YZKWF'], + ], + 'parameters' => [ [ - 'name' => 'PageSize', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries to return per page. Default value: 30. Valid values:'."\n" - ."\n" - .'* **30**'."\n" - .'* **50**'."\n" - .'* **100**'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp13s14l8498l****'], ], [ - 'name' => 'PageNumber', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of pages to return.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => 'The ID of the region. Call the [DescribeRegions](~~170875~~) operation to query region IDs.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => 'The total number of entries that are returned.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'TableDetails' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'TableDetail' => [ - 'description' => 'The error information returned for a check failure.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'TableName' => [ - 'description' => 'The name of the local table.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'Cluster' => [ - 'description' => 'The cluster. The value is fixed as **default**.'."\n", - 'type' => 'string', - 'example' => 'default', - ], - 'Database' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'example' => 'db_name', - ], - 'Detail' => [ - 'description' => 'The error details. Valid values:'."\n" - ."\n" - .'* **1**: The unique distributed table is missing.'."\n" - .'* **2**: More than one distributed table exists for the local table.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - ], - ], - ], - ], - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], - 'PageSize' => [ - 'description' => 'The number of entries returned per page. Valid values:'."\n" - ."\n" - .'* **30** (default)'."\n" - .'* **50**'."\n" - .'* **100**'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'PageNumber' => [ - 'description' => 'The total number of returned pages.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'CheckCode' => [ - 'description' => 'The check result. Valid values:'."\n" - ."\n" - .'* **400**: The cluster failed the check.'."\n" - .'* **200**: The cluster passed the check.'."\n", - 'type' => 'string', - 'example' => '400', - ], - 'TimeDuration' => [ - 'description' => 'The amount of time that is required for the migration and scale-out. Unit: minutes.'."\n", - 'type' => 'string', - 'example' => '21', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '94F92113-FF63-5E57-8401-6FE123AD11DD'], ], - 'description' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"TableDetails\\": {\\n \\"TableDetail\\": [\\n {\\n \\"TableName\\": \\"test\\",\\n \\"Cluster\\": \\"default\\",\\n \\"Database\\": \\"db_name\\",\\n \\"Detail\\": 1\\n }\\n ]\\n },\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"CheckCode\\": \\"400\\",\\n \\"TimeDuration\\": \\"21\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n \\n test\\n default\\n db_name\\n 1\\n \\n F5178C10-1407-4987-9133-DE4DC9119F75\\n 30\\n 1\\n 400\\n 21\\n","errorExample":""}]', - 'title' => 'CheckScaleOutBalanced', + 'title' => 'CreateMonitorDataReport', + 'summary' => 'Creates a monitoring data report.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateMonitorDataReport'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateMonitorDataReport', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"94F92113-FF63-5E57-8401-6FE123AD11DD\\"\\n}","type":"json"}]', ], 'CreateOSSStorage' => [ - 'summary' => 'Creates a storage task for cold data.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -3467,32 +1788,18 @@ 'systemTags' => [ 'operationType' => 'create', 'abilityTreeCode' => '19425', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseOCIS36', - ], + 'abilityTreeNodes' => ['FEATUREclickhouseOCIS36'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1z3a2hc8dmt****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1z3a2hc8dmt****'], ], ], 'responses' => [ @@ -3500,140 +1807,90 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '1F488A93-83FD-540F-9B67-0333AF64E6A0', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '1F488A93-83FD-540F-9B67-0333AF64E6A0'], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1F488A93-83FD-540F-9B67-0333AF64E6A0\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 1F488A93-83FD-540F-9B67-0333AF64E6A0\\n","errorExample":""}]', 'title' => 'CreateOSSStorage', - 'description' => 'Only an ApsaraDB for ClickHouse cluster of V20.8 or later supports tiered storage of hot data and cold data. If your data is in an ApsaraDB for ClickHouse cluster of a version earlier than V20.8 and you want to use tiered storage of hot data and cold data to store the data, you can migrate the data to an ApsaraDB for ClickHouse cluster of V20.8 or later and use tiered storage of hot data and cold data. For more information about how to migrate data between ApsaraDB for ClickHouse clusters, see [Migrate data between ApsaraDB for ClickHouse clusters](~~276926~~).'."\n", - ], - 'DescribeOSSStorage' => [ - 'summary' => 'Queries the storage of cold data.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', + 'summary' => 'Creates a cold storage space.', + 'description' => 'The tiered storage of hot and cold data feature is supported only by community-compatible clusters that run version 20.8 or later. For clusters that run an earlier version, you must migrate data to a cluster that runs version 20.8 or later before you can configure tiered storage. For more information about data migration, see [Data migration between ApsaraDB for ClickHouse instances](~~276926~~).', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateOSSStorage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1F488A93-83FD-540F-9B67-0333AF64E6A0\\"\\n}","type":"json"}]', + ], + 'CreatePortsForClickHouse' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '19453', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], + 'operationType' => 'create', + 'abilityTreeCode' => '25552', + 'abilityTreeNodes' => ['FEATUREclickhouseZHDS8I'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'PortType', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['description' => 'The port type. The value must be \\`mysql\\_port\\`.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'mysql_port'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID. Call the [DescribeRegions](~~170875~~) operation to query the available region IDs.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'Policy' => [ - 'description' => 'The parameters for tiered storage of hot data and cold data.'."\n", - 'type' => 'string', - 'example' => '[{ "currentValue":"0.1", "defaultValue":"0.1", "desc":"Ratio of free disk space. When the ratio exceeds the value of configuration parameter, ClickHouse start to move data to the cold storage", "name":"move_factor", "restart":true, "valueRange":"(0, 1]" },{ "currentValue":"true", "defaultValue":"true", "desc":"Disables merging of data parts on cold storage", "name":"prefer_not_to_merge", "restart":true, "valueRange":"true|false" }]', - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'aadbb456-ebf7-4ed8-9671-fad9f3846ca4', - ], - 'State' => [ - 'description' => 'The state of tiered storage of hot data and cold data. Valid values:'."\n" - ."\n" - .'* **CREATING**: Tiered storage of hot data and cold data is being enabled.'."\n" - .'* **DISABLE**: Tiered storage of hot data and cold data is not enabled.'."\n" - .'* **ENABLE**: Tiered storage of hot data and cold data is enabled.'."\n", - 'type' => 'string', - 'example' => 'ENABLE', - ], - 'ColdStorage' => [ - 'description' => 'Indicates whether tiered storage of hot data and cold data is supported. Valid values:'."\n" - ."\n" - .'* **true**: Tiered storage of hot data and cold data is supported.'."\n" - .'* **false**: Tiered storage of hot data and cold data is not supported.'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'StorageUsage' => [ - 'description' => 'The space used for tiered storage of hot data and cold data. Unit: GB.'."\n", - 'type' => 'string', - 'example' => '0.00', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], ], - 'description' => '', - ], - ], - ], - 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', + 'example' => '', ], ], ], @@ -3641,19 +1898,33 @@ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"Policy\\": \\"[{ \\\\\\"currentValue\\\\\\":\\\\\\"0.1\\\\\\", \\\\\\"defaultValue\\\\\\":\\\\\\"0.1\\\\\\", \\\\\\"desc\\\\\\":\\\\\\"Ratio of free disk space. When the ratio exceeds the value of configuration parameter, ClickHouse start to move data to the cold storage\\\\\\", \\\\\\"name\\\\\\":\\\\\\"move_factor\\\\\\", \\\\\\"restart\\\\\\":true, \\\\\\"valueRange\\\\\\":\\\\\\"(0, 1]\\\\\\" },{ \\\\\\"currentValue\\\\\\":\\\\\\"true\\\\\\", \\\\\\"defaultValue\\\\\\":\\\\\\"true\\\\\\", \\\\\\"desc\\\\\\":\\\\\\"Disables merging of data parts on cold storage\\\\\\", \\\\\\"name\\\\\\":\\\\\\"prefer_not_to_merge\\\\\\", \\\\\\"restart\\\\\\":true, \\\\\\"valueRange\\\\\\":\\\\\\"true|false\\\\\\" }]\\",\\n \\"RequestId\\": \\"aadbb456-ebf7-4ed8-9671-fad9f3846ca4\\",\\n \\"State\\": \\"ENABLE\\",\\n \\"ColdStorage\\": true,\\n \\"StorageUsage\\": \\"0.00\\"\\n}","errorExample":""},{"type":"xml","example":"\\n [{ \\"currentValue\\":\\"0.1\\", \\"defaultValue\\":\\"0.1\\", \\"desc\\":\\"Ratio of free disk space. When the ratio exceeds the value of configuration parameter, ClickHouse start to move data to the cold storage\\", \\"name\\":\\"move_factor\\", \\"restart\\":true, \\"valueRange\\":\\"(0, 1]\\" },{ \\"currentValue\\":\\"true\\", \\"defaultValue\\":\\"true\\", \\"desc\\":\\"Disables merging of data parts on cold storage\\", \\"name\\":\\"prefer_not_to_merge\\", \\"restart\\":true, \\"valueRange\\":\\"true|false\\" }]\\n aadbb456-ebf7-4ed8-9671-fad9f3846ca4\\n ENABLE\\n true\\n 0.00\\n","errorExample":""}]', - 'title' => 'DescribeOSSStorage', - ], - 'CheckClickhouseToRDS' => [ - 'summary' => 'Checks the connectivity between an ApsaraDB for ClickHouse cluster and an ApsaraDB RDS for MySQL instance.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'CreatePortsForClickHouse', + 'summary' => 'Enables the MySQL or HTTPS port for a specified ApsaraDB for ClickHouse cluster.', + 'description' => '> You must manually enable the MySQL port for community-compatible clusters of version 20.8 or later that were created before December 1, 2021. For clusters created on or after this date, the MySQL port is enabled automatically.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreatePortsForClickHouse'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreatePortsForClickHouse', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","type":"json"}]', + ], + 'CreateRDSToClickhouseDb' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -3662,390 +1933,180 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '43669', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseZ93UXU', - ], + 'operationType' => 'create', + 'abilityTreeCode' => '45979', + 'abilityTreeNodes' => ['FEATUREclickhouseZ93UXU'], ], 'parameters' => [ [ 'name' => 'DbClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-2zeyy362b5sbm****', - ], + 'schema' => ['description' => 'The ID of the ApsaraDB for ClickHouse cluster.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-2ze5zeyl72188****'], ], [ 'name' => 'ClickhousePort', 'in' => 'query', - 'schema' => [ - 'description' => 'The port number of the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '8123', - ], + 'schema' => ['description' => 'The port number of the ApsaraDB for ClickHouse cluster.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'title' => '', 'example' => '8123'], ], [ 'name' => 'CkUserName', 'in' => 'query', - 'schema' => [ - 'description' => 'The account that is used to log on to the database in the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'user1', - ], + 'schema' => ['description' => 'The database account of the ApsaraDB for ClickHouse cluster.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'user1'], ], [ 'name' => 'CkPassword', 'in' => 'query', - 'schema' => [ - 'description' => 'The password of the account that is used to log on to the database in the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '123456Aa', - ], + 'schema' => ['description' => 'The password for the database account of the ApsaraDB for ClickHouse cluster.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => '123456Aa'], ], [ 'name' => 'RdsId', 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'rm-bp13v4bnwlu8j****', - ], + 'schema' => ['description' => 'The ID of the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'rm-8vb989qj9roh0****'], ], [ 'name' => 'RdsPort', 'in' => 'query', - 'schema' => [ - 'description' => 'The port number of the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '3306', - ], + 'schema' => ['description' => 'The port number of the ApsaraDB RDS for MySQL instance.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'title' => '', 'example' => '3306'], ], [ 'name' => 'RdsVpcId', 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the VPC in which the ApsaraDB RDS for MySQL instance is deployed.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'vpc-wz9mm0qka0winfl47****', - ], + 'schema' => ['description' => 'The VPC ID of the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'vpc-2zen93xryil99jsfy****'], ], [ 'name' => 'RdsUserName', 'in' => 'query', - 'schema' => [ - 'description' => 'The account that is used to log on to the database in the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'user2', - ], + 'schema' => ['description' => 'The database account of the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'user2'], ], [ 'name' => 'RdsPassword', 'in' => 'query', - 'schema' => [ - 'description' => 'The password of the account that is used to log on to the database in the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '123456Rr', - ], + 'schema' => ['description' => 'The password for the database account of the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => '123456Rr'], ], [ - 'name' => 'RdsVpcUrl', + 'name' => 'SkipUnsupported', 'in' => 'query', - 'schema' => [ - 'description' => 'The internal endpoint of the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'rm-bp16t9h3999xb0a7****.mysql.rds.aliyuncs.com', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'A82758F8-E793-5610-BE11-0E46664305C2', - ], - 'Status' => [ - 'description' => 'Indicates whether the ApsaraDB for ClickHouse cluster can be connected to the ApsaraDB RDS for MySQL instance.'."\n" - ."\n" - .'* **true**: The ApsaraDB for ClickHouse cluster can be connected to the ApsaraDB RDS for MySQL instance.'."\n" - .'* **false**: The ApsaraDB for ClickHouse cluster cannot be connected to the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'boolean', - 'example' => 'false', - ], - 'ErrorCode' => [ - 'description' => '* When the value **true** is returned for the **Status** parameter, the system does not return the ErrorCode parameter.'."\n" - .'* When the value **false** is returned for the **Status** parameter, the system returns for the ErrorCode parameter the reason why the ApsaraDB for ClickHouse cluster cannot be connected to the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'example' => 'NotSameVpc', - ], - ], - 'description' => '', - ], - ], - ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - ], - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A82758F8-E793-5610-BE11-0E46664305C2\\",\\n \\"Status\\": false,\\n \\"ErrorCode\\": \\"NotSameVpc\\"\\n}","errorExample":""},{"type":"xml","example":"\\n A82758F8-E793-5610-BE11-0E46664305C2\\n false\\n NotSameVpc\\n","errorExample":""}]', - 'title' => 'CheckClickhouseToRDS', - ], - 'DescribeSynDbs' => [ - 'summary' => 'Queries the information about data synchronization between an ApsaraDB for ClickHouse cluster and an ApsaraDB RDS for MySQL instance.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], + 'schema' => ['description' => 'Specifies whether to skip unsupported table schemas. Valid values:'."\n" + ."\n" + .'- **true**: Skip.'."\n" + ."\n" + .'- **false**: Do not skip.', 'type' => 'boolean', 'required' => true, 'title' => '', 'example' => 'true'], ], - ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '44312', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseZ93UXU', - ], - ], - 'parameters' => [ [ - 'name' => 'DbClusterId', + 'name' => 'LimitUpper', 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1ab22b80814****', - ], + 'schema' => ['description' => 'The maximum number of rows to sync per second.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'title' => '', 'example' => '50000'], ], [ - 'name' => 'PageSize', + 'name' => 'SynDbTables', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries per page.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '20', - 'default' => '20', - ], + 'schema' => ['description' => 'The tables to sync.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => '[{"Schema":"recommend","Tables":["mr_platform_cpm","mr_platform_ecpm","p_monitor_record"]}]'], ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => 'The page number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + [ + 'name' => 'RdsVpcUrl', + 'in' => 'query', + 'schema' => ['description' => 'The internal endpoint of the ApsaraDB RDS instance.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'rm-bp16t9h3999xb0a7****.mysql.rds.aliyuncs.com'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => 'The response.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '7655F5F9-1313-5ABA-8516-F6EB79605A5F', - ], - 'SynDbs' => [ - 'description' => 'The information about data synchronization between the ApsaraDB for ClickHouse cluster and an ApsaraDB RDS for MySQL instance.'."\n", + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '66676F54-1994-5DCF-993F-74536649628A'], + 'Status' => ['description' => 'Indicates whether the task was created. Valid values:'."\n" + ."\n" + .'- **1**: The task was created.'."\n" + ."\n" + .'- **0**: The task failed to be created because of duplicate tables. The duplicate tables are returned in the **RepeatedDbs** parameter.'."\n" + ."\n" + .'- **-1**: The task failed to be created. The error message is returned in the **ErrorMsg** parameter.', 'type' => 'integer', 'format' => 'int64', 'title' => '', 'example' => '0'], + 'ErrorMsg' => ['description' => 'The reason for the creation failure. This parameter is returned only if the value of the Status parameter is **-1**.', 'type' => 'string', 'title' => '', 'example' => 'ClickHouse exception, code: 49, host: 100.100.79.102, port: 14540; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n'], + 'RepeatedDbs' => [ + 'description' => 'The duplicate tables in the sync task.', 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'RdsId' => [ - 'description' => 'The ID of the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'example' => 'rm-wz9d11qg1j0h4****', - ], - 'SynDb' => [ - 'description' => 'The name of the database in the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'example' => 'database', - ], - 'SynStatus' => [ - 'description' => 'Indicates whether the data synchronization succeeded. Valid values:'."\n" - ."\n" - .'* **true**: The data synchronization succeeded.'."\n" - .'* **false**: The data synchronization failed.'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'ErrorMsg' => [ - 'description' => '* When the value **true** is returned for the **SynStatus** parameter, the system does not return the ErrorMsg parameter.'."\n" - .'* When the value **false** is returned for the **SynStatus** parameter, the system returns for the ErrorMsg parameter the cause why the data synchronization failed.'."\n", - 'type' => 'string', - 'example' => 'ClickHouse exception, code: 49, host: 100.100.118.132, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n', - ], - 'RdsUserName' => [ - 'description' => 'The database account that is used to log on to the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'RdsVpcUrl' => [ - 'description' => 'The internal endpoint of the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'example' => 'rm-bp16t9h3999xb0a711****.mysql.rds.aliyuncs.com:3306', - ], - ], - ], - ], - 'TotalCount' => [ - 'description' => 'The total number of entries returned.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'PageSize' => [ - 'description' => 'The number of entries per page.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'PageNumber' => [ - 'description' => 'The page number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', + 'items' => ['description' => 'The duplicate tables in the sync task. This parameter is returned only if the value of the **Status** parameter is **0**.', 'type' => 'string', 'title' => '', 'example' => '["mr_platform_cpm","mr_platform_ecpm"]'], + 'title' => '', + 'example' => '', ], ], - 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7655F5F9-1313-5ABA-8516-F6EB79605A5F\\",\\n \\"SynDbs\\": [\\n {\\n \\"RdsId\\": \\"rm-wz9d11qg1j0h4****\\",\\n \\"SynDb\\": \\"database\\",\\n \\"SynStatus\\": true,\\n \\"ErrorMsg\\": \\"ClickHouse exception, code: 49, host: 100.100.118.132, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n\\",\\n \\"RdsUserName\\": \\"test\\",\\n \\"RdsVpcUrl\\": \\"rm-bp16t9h3999xb0a711****.mysql.rds.aliyuncs.com:3306\\"\\n }\\n ],\\n \\"TotalCount\\": 0,\\n \\"PageSize\\": 20,\\n \\"PageNumber\\": 1\\n}","errorExample":""},{"type":"xml","example":"\\n 7655F5F9-1313-5ABA-8516-F6EB79605A5F\\n \\n rm-wz9d11qg1j0h4****\\n database\\n true\\n ClickHouse exception, code: 49, host: 100.100.118.132, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n\\n test\\n rm-bp16t9h3999xb0a711****.mysql.rds.aliyuncs.com:3306\\n \\n","errorExample":""}]', - 'title' => 'DescribeSynDbs', - ], - 'DescribeSynDbTables' => [ - 'summary' => 'Queries information about tables that are synchronized from an ApsaraDB RDS for MySQL instance to an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'CreateRDSToClickhouseDb', + 'summary' => 'You can call the CreateRDSToClickhouseDb operation to create a sync task for an ApsaraDB for ClickHouse Community-Compatible Edition cluster.', + 'description' => '> This operation applies only to ApsaraDB for ClickHouse Community-Compatible Edition clusters.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateRDSToClickhouseDb'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateRDSToClickhouseDb', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"66676F54-1994-5DCF-993F-74536649628A\\",\\n \\"Status\\": 0,\\n \\"ErrorMsg\\": \\"ClickHouse exception, code: 49, host: 100.100.79.102, port: 14540; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n\\",\\n \\"RepeatedDbs\\": [\\n \\"[\\\\\\"mr_platform_cpm\\\\\\",\\\\\\"mr_platform_ecpm\\\\\\"]\\"\\n ]\\n}","type":"json"}]', + ], + 'CreateSLB' => [ + 'summary' => 'Calls the CreateSLB operation to attach a Server Load Balancer (SLB) instance to a specified ApsaraDB for ClickHouse Community-Compatible Edition cluster.', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '46614', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseZ93UXU', - ], + 'operationType' => 'create', + 'abilityTreeCode' => '143538', + 'abilityTreeNodes' => ['FEATUREclickhouseZHDS8I'], ], 'parameters' => [ [ - 'name' => 'DbClusterId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp158i5wvj436****', - ], + 'schema' => ['description' => 'The cluster ID. Call the [DescribeDBClusters](~~170879~~) operation to obtain the cluster ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-uf6bnitmve5n0****'], ], [ - 'name' => 'SynDb', + 'name' => 'Product', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'database', - ], + 'schema' => ['type' => 'string', 'default' => 'clickhouse', 'description' => 'The product code.', 'required' => false, 'title' => '', 'example' => 'clickhouse'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => 'The response parameters.'."\n", + 'description' => 'The returned parameters.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '851D11EA-681C-5B38-A065-C3F90BBD49DE', - ], - 'Tables' => [ - 'description' => 'The queried tables.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'The name of the table in the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '9A23C87D-87DF-4DA0-A50E-CB13F4F7923D'], ], - ], - ], - ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'title' => '', + 'example' => '', ], ], ], @@ -4053,431 +2114,316 @@ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"851D11EA-681C-5B38-A065-C3F90BBD49DE\\",\\n \\"Tables\\": [\\n \\"test\\"\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 851D11EA-681C-5B38-A065-C3F90BBD49DE\\n test\\n","errorExample":""}]', - 'title' => 'DescribeSynDbTables', - ], - 'DeleteSyndb' => [ - 'summary' => 'Deletes a database used for data synchronization.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'CreateSLB', + 'description' => '## Usage notes'."\n" + ."\n" + .'An SLB instance is a network-layer dependency that provides services for external connections and supports failover. It attaches a domain name to the IP addresses of ClickHouse nodes. The SLB instance balances and forwards cluster requests to internal nodes to distribute traffic in a multi-node deployment. It also performs health checks on backend nodes. If a node becomes unavailable, the SLB instance checks its health status and automatically isolates it. This ensures that request traffic is distributed to active nodes.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateSLB', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9A23C87D-87DF-4DA0-A50E-CB13F4F7923D\\"\\n}","type":"json"}]', + ], + 'CreateSQLAccount' => [ + 'summary' => 'Call the CreateSQLAccount operation to create a privileged or standard account for an ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', - 'abilityTreeCode' => '47744', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseZ93UXU', - ], + 'operationType' => 'create', + 'abilityTreeCode' => '152741', + 'abilityTreeNodes' => ['FEATUREclickhouse2H8YOY', 'FEATUREclickhouseL1079N'], ], 'parameters' => [ [ - 'name' => 'DbClusterId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp158i5wvj436****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp1p816075e21****', 'title' => ''], ], [ - 'name' => 'SynDb', + 'name' => 'AccountName', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the database in the ApsaraDB RDS for MySQL instance. The database is used for data synchronization.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'database', - ], + 'schema' => ['description' => 'The name of the database account.'."\n" + ."\n" + .'- The name must be unique.'."\n" + ."\n" + .'- It must consist of lowercase letters, digits, or underscores (\\_).'."\n" + ."\n" + .'- It must start with a lowercase letter and end with a lowercase letter or a digit.'."\n" + ."\n" + .'- It must be 2 to 64 characters in length.', 'type' => 'string', 'required' => true, 'example' => 'test', 'title' => ''], + ], + [ + 'name' => 'AccountPassword', + 'in' => 'query', + 'schema' => ['description' => 'The password for the database account.'."\n" + ."\n" + .'- It must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.'."\n" + ."\n" + .'- The following characters are special characters: !@#$%^&\\*()\\_+-='."\n" + ."\n" + .'- It must be 8 to 32 characters in length.', 'type' => 'string', 'required' => true, 'example' => 'Test1234', 'title' => ''], + ], + [ + 'name' => 'AccountDescription', + 'in' => 'query', + 'schema' => ['description' => 'The description of the database account.'."\n" + ."\n" + .'- It cannot start with http\\:// or https\\://.'."\n" + ."\n" + .'- It can be 0 to 256 characters in length.', 'type' => 'string', 'example' => 'For testing', 'required' => false, 'title' => ''], + ], + [ + 'name' => 'AccountType', + 'in' => 'query', + 'schema' => ['description' => 'The type of the database account. Valid values:'."\n" + ."\n" + .'- **Super**: a privileged account.'."\n" + ."\n" + .'- **Normal**: a standard account.', 'type' => 'string', 'required' => true, 'example' => 'Super', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => 'The response parameters.'."\n", + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '2C7393F1-5FD1-5CEE-A2EA-270A2CF99693', - ], - 'Status' => [ - 'description' => 'Indicates whether the database used for data synchronization was deleted. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'ErrorMsg' => [ - 'description' => '* If the value **true** is returned for the **Status** parameter, the system does not return the ErrorMsg parameter.'."\n" - .'* If the value **false** is returned for the **Status** parameter, the system returns the deletion failure cause for the ErrorMsg parameter.'."\n", - 'type' => 'string', - 'example' => 'ClickHouse exception, code: 49, host: 100.100.xx.xx, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n', - ], - 'ErrorCode' => [ - 'description' => 'The error code.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F76'], ], + 'example' => '', ], ], ], 'errorCodes' => [ 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2C7393F1-5FD1-5CEE-A2EA-270A2CF99693\\",\\n \\"Status\\": true,\\n \\"ErrorMsg\\": \\"ClickHouse exception, code: 49, host: 100.100.xx.xx, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n\\",\\n \\"ErrorCode\\": 0\\n}","errorExample":""},{"type":"xml","example":"\\n 2C7393F1-5FD1-5CEE-A2EA-270A2CF99693\\n true\\n ClickHouse exception, code: 49, host: 100.100.xx.xx, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n\\n 0\\n","errorExample":""}]', - 'title' => 'DeleteSyndb', - ], - 'DescribeTransferHistory' => [ - 'summary' => 'Queries information about data migration from an ApsaraDB for ClickHouse cluster of an earlier version to an ApsaraDB for ClickHouse cluster of a later version', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F76\\"\\n}","type":"json"}]', + 'title' => 'CreateSQLAccount', + 'description' => '> This operation applies only to community-compatible clusters that run version 20.8 or later and were created after December 1, 2021.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '8', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateSQLAccount'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateSQLAccount', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'translator' => 'machine', + ], + 'CreateServiceLinkedRole' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '36715', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseMCDGZK', - ], - ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], + 'operationType' => 'create', + 'abilityTreeCode' => '19426', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'publicInformation', ], + 'parameters' => [], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ - 'HistoryDetails' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'HistoryDetail' => [ - 'description' => 'The migration information.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'SourceDBCluster' => [ - 'description' => 'The ID of the source cluster.'."\n", - 'type' => 'string', - 'example' => 'cc-bp108z124a8o7****', - ], - 'SourceControlVersion' => [ - 'description' => 'The control version of the source cluster.'."\n", - 'type' => 'string', - 'example' => 'v1', - ], - 'TargetDBCluster' => [ - 'description' => 'The ID of the destination cluster.'."\n", - 'type' => 'string', - 'example' => 'cc-bp13zkh9uw523****', - ], - 'TargetControlVersion' => [ - 'description' => 'The control version of the destination cluster.'."\n", - 'type' => 'string', - 'example' => 'v2', - ], - 'Status' => [ - 'description' => 'The status of the data migration task. Valid values:'."\n" - ."\n" - .'* **Finished**: The data migration task is complete.'."\n" - .'* **Processing**: The data migration task is in progress.'."\n", - 'type' => 'string', - 'example' => 'Finished', - ], - 'Progress' => [ - 'description' => 'The progress of the data migration.'."\n", - 'type' => 'string', - 'example' => '100%', - ], - 'DisableWriteWindows' => [ - 'description' => 'The time window during which write operations are stopped.'."\n", - 'type' => 'string', - 'example' => '2025-02-08T00:00:00+08:00,2025-02-12T00:00:00+08:00', - ], - 'UnsyncedBytes' => [ - 'description' => 'The amount of data that is not migrated.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '102400', - ], - 'UnsyncedParts' => [ - 'description' => 'The number of parts that are not migrated.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1000', - ], - 'PartsPerMinute' => [ - 'description' => 'The number of parts that are migrated per minute.'."\n", - 'type' => 'number', - 'format' => 'double', - 'example' => '1.24', - ], - 'BytesPerMinute' => [ - 'description' => 'The amount of data that is migrated per minute.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10240', - ], - 'SubJob' => [ - 'description' => 'The running subtask.'."\n", - 'type' => 'string', - 'example' => 'SubJob', - ], - 'SubJobStatus' => [ - 'description' => 'The subtask status.'."\n", - 'type' => 'string', - 'example' => 'running', - ], - 'SubJobMessage' => [ - 'type' => 'string', - ], - ], - 'description' => '', - ], - ], - ], - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '66428721-FFEC-5023-B4E5-3BD1B67837E0'], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"HistoryDetails\\": {\\n \\"HistoryDetail\\": [\\n {\\n \\"SourceDBCluster\\": \\"cc-bp108z124a8o7****\\",\\n \\"SourceControlVersion\\": \\"v1\\",\\n \\"TargetDBCluster\\": \\"cc-bp13zkh9uw523****\\",\\n \\"TargetControlVersion\\": \\"v2\\",\\n \\"Status\\": \\"Finished\\",\\n \\"Progress\\": \\"100%\\",\\n \\"DisableWriteWindows\\": \\"2025-02-08T00:00:00+08:00,2025-02-12T00:00:00+08:00\\",\\n \\"UnsyncedBytes\\": 102400,\\n \\"UnsyncedParts\\": 1000,\\n \\"PartsPerMinute\\": 1.24,\\n \\"BytesPerMinute\\": 10240,\\n \\"SubJob\\": \\"SubJob\\",\\n \\"SubJobStatus\\": \\"running\\",\\n \\"SubJobMessage\\": \\"\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","errorExample":""},{"type":"xml","example":"\\n \\n cc-bp108z124a8o7****\\n cc-bp13zkh9uw523****\\n Finished\\n 100%\\n \\n 05321590-BB65-4720-8CB6-8218E041CDD0\\n","errorExample":""}]', - 'title' => 'DescribeTransferHistory', - 'description' => '> You can call this operation to query information about only data migration from an ApsaraDB for ClickHouse cluster of an earlier version to an ApsaraDB for ClickHouse cluster of a later version.'."\n", - ], - 'TransferVersion' => [ - 'summary' => 'Migrates the data of a source ApsaraDB for ClickHouse cluster to a destination ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'CreateServiceLinkedRole', + 'summary' => 'Creates a service-linked role.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateServiceLinkedRole', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"66428721-FFEC-5023-B4E5-3BD1B67837E0\\"\\n}","type":"json"}]', + ], + 'DeleteAccount' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '36417', - 'abilityTreeNodes' => [ - 'FEATUREclickhouse07PB80', - ], + 'operationType' => 'delete', + 'abilityTreeCode' => '19427', + 'abilityTreeNodes' => ['FEATUREclickhouse2H8YOY'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the source ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1tm8zf130ew****', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries per page. Valid values:'."\n" - ."\n" - .'* **30** (default)'."\n" - .'* **50**'."\n" - .'* **100**'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => 'The page number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'TargetDbClusterId', + 'name' => 'AccountName', 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the destination ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp14b39djx7zg****', - ], + 'schema' => ['description' => 'The database account.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'test'], ], - [ - 'name' => 'SourceAccount', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The database account that is used to log on to the database in the source ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'test', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], - [ - 'name' => 'TargetAccount', - 'in' => 'query', - 'schema' => [ - 'description' => 'The database account that is used to log on to the database in the destination ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'test01', + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'DeleteAccount', + 'summary' => 'Deletes a database account from an ApsaraDB for ClickHouse cluster.', + 'description' => '> After a database account is deleted, you cannot use it to connect to ApsaraDB for ClickHouse. Proceed with caution.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DeleteAccount'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteAccount', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","type":"json"}]', + ], + 'DeleteBackupPolicy' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'SourcePassword', - 'in' => 'query', - 'schema' => [ - 'description' => 'The password that corresponds to the database account for logging on to the database in the source ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '123456Aa', - ], + 'AK' => [], ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'delete', + 'abilityTreeCode' => '173183', + 'abilityTreeNodes' => ['FEATUREclickhouseYFBZ0B'], + ], + 'parameters' => [ [ - 'name' => 'TargetPassword', + 'name' => 'MaxResults', 'in' => 'query', - 'schema' => [ - 'description' => 'The password that corresponds to the database account for logging on to the database in the destination ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '123456Ff', - ], + 'allowEmptyValue' => true, + 'schema' => ['type' => 'integer', 'format' => 'int32', 'title' => '', 'description' => 'The number of records to return on each page. Valid values: 1 to **100**. Default value: **30**.', 'required' => false, 'example' => '30'], ], [ - 'name' => 'DisableWriteWindows', + 'name' => 'ClientToken', 'in' => 'query', - 'schema' => [ - 'description' => 'The time window during which write operations are stopped.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '2025-02-08T00:00:00+08:00,2025-02-12T00:00:00+08:00', - ], + 'allowEmptyValue' => false, + 'schema' => ['type' => 'string', 'title' => '', 'description' => 'A client token used to ensure the idempotence of the request. The value must be a string that contains a maximum of 64 ASCII characters and cannot contain non-ASCII characters.', 'required' => false, 'example' => 'ETnLKlblzczshOTUbOCz****'], ], [ - 'name' => 'SourceClusterName', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the self-managed ClickHouse cluster. You can execute the `SELECT * FROM system.clusters` statement to query the cluster name.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'default', - ], + 'schema' => ['type' => 'string', 'description' => 'The cluster ID.'."\n" + ."\n" + .'> You can call the [DescribeDBClusters](~~170879~~) operation to query information about all clusters in the destination region, including cluster IDs.', 'required' => false, 'title' => '', 'example' => 'cc-bp1t9lbb7a4z7****'], ], [ - 'name' => 'SourceShards', + 'name' => 'Product', 'in' => 'query', - 'schema' => [ - 'description' => 'The endpoint and TCP port of the self-managed ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '192.168.0.4:9000,192.168.0.5:9000,192.168.0.6:9000', - ], + 'schema' => ['type' => 'string', 'default' => 'clickhouse', 'description' => 'The product name.', 'required' => false, 'title' => '', 'example' => 'clickhouse'], ], ], 'responses' => [ @@ -4485,117 +2431,118 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '7084CDB5-308F-5D0B-8F9B-5F7D83E09738', - ], + 'RequestId' => ['type' => 'string', 'description' => 'The request ID.', 'title' => '', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F34'], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], - 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7084CDB5-308F-5D0B-8F9B-5F7D83E09738\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 7084CDB5-308F-5D0B-8F9B-5F7D83E09738\\n","errorExample":""}]', - 'title' => 'TransferVersion', - 'description' => '## [](#)Prerequisites'."\n" - ."\n" - .'* The IP address of the source ApsaraDB for ClickHouse cluster is added to the IP address whitelist of the destination ApsaraDB for ClickHouse cluster.'."\n" - .'* The IP address of the destination ApsaraDB for ClickHouse cluster is added to the IP address whitelist of the source ApsaraDB for ClickHouse cluster.'."\n" - ."\n" - .'> You can execute the `select * from system.clusters;` statement to query the IP address of an ApsaraDB for ClickHouse cluster.'."\n", - ], - 'CreateServiceLinkedRole' => [ - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DeleteBackupPolicy', + 'summary' => 'Deletes the backup policy for a community-compatible ApsaraDB for ClickHouse cluster.', + 'description' => '> The data backup feature is available only for ApsaraDB for ClickHouse clusters running version 21.8 or later.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F34\\"\\n}","type":"json"}]', + ], + 'DeleteDBCluster' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '19426', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', + 'operationType' => 'delete', + 'abilityTreeCode' => '19428', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the pay-as-you-go cluster.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], - 'tenantRelevance' => 'publicInformation', ], - 'parameters' => [], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '66428721-FFEC-5023-B4E5-3BD1B67837E0', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0'], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"66428721-FFEC-5023-B4E5-3BD1B67837E0\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 66428721-FFEC-5023-B4E5-3BD1B67837E0\\n","errorExample":""}]', - 'title' => 'CreateServiceLinkedRole', - 'summary' => 'Creates a service-linked role.', - ], - 'KillProcess' => [ - 'summary' => 'Terminates an ongoing task.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DeleteDBCluster', + 'summary' => 'Deletes a specified pay-as-you-go ApsaraDB for ClickHouse cluster.', + 'description' => '>'."\n" + ."\n" + .'After a cluster is deleted, all data in the cluster is deleted and cannot be recovered. Proceed with caution.'."\n" + ."\n" + .'>', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DeleteDBCluster'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteDBCluster', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","type":"json"}]', + ], + 'DeleteSLB' => [ + 'summary' => 'Releases a Server Load Balancer (SLB) instance for a specified ApsaraDB for ClickHouse Community-Compatible cluster.', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -4604,75 +2551,32 @@ 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '19460', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', - ], + 'operationType' => 'delete', + 'abilityTreeCode' => '142683', + 'abilityTreeNodes' => ['FEATUREclickhouseZHDS8I'], ], 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to view the cluster ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-uf6bnitmve5n0****'], ], [ - 'name' => 'InitialQueryId', + 'name' => 'Product', 'in' => 'query', - 'schema' => [ - 'description' => 'The query statement or query statements that you want to stop executing. If you want to stop executing multiple query statements, separate the statements with commas (,).'."\n" - ."\n" - .'> If you do not set this parameter, all query statements are stopped by default.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => 'SELECT * FROM `test01` ;', - ], + 'schema' => ['type' => 'string', 'default' => 'clickhouse', 'description' => 'The product code.', 'required' => false, 'title' => '', 'example' => 'clickhouse'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'The returned parameters.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], ], - 'description' => '', - ], - ], - ], - 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', + 'example' => '', ], ], ], @@ -4680,20 +2584,33 @@ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 05321590-BB65-4720-8CB6-8218E041CDD0\\n","errorExample":""}]', - 'title' => 'KillProcess', - ], - 'DescribeSlowLogRecords' => [ - 'summary' => 'Queries the details about slow query logs.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DeleteSLB', + 'description' => '## Usage notes'."\n" + ."\n" + .'After you release the SLB instance, the system performs simple load balancing based on the domain name. Health checks are no longer performed on nodes at the request routing layer. This may cause normal requests to be routed to unavailable nodes, which can result in read and write failures.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteSLB', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\"\\n}","type":"json"}]', + ], + 'DeleteSyndb' => [ + 'summary' => 'Deletes a database synchronization task.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -4702,107 +2619,106 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '19457', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseLESIXD', - ], + 'operationType' => 'delete', + 'abilityTreeCode' => '47744', + 'abilityTreeNodes' => ['FEATUREclickhouseZ93UXU'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DbClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp158i5wvj436****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'SynDb', 'in' => 'query', + 'schema' => ['description' => 'The ApsaraDB RDS for MySQL database.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'database'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all the clusters that are deployed in a specific region. The information includes the cluster IDs.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1z58t881wcx****', + 'description' => 'The response.', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '2C7393F1-5FD1-5CEE-A2EA-270A2CF99693'], + 'Status' => ['description' => 'Indicates whether the deletion was successful. Valid values:'."\n" + ."\n" + .'- **true**: The deletion was successful.'."\n" + ."\n" + .'- **false**: The deletion failed.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], + 'ErrorMsg' => ['description' => '- This parameter is not returned if **Status** is **true**.'."\n" + ."\n" + .'- If **Status** is **false**, this parameter indicates the reason for the failure.', 'type' => 'string', 'title' => '', 'example' => 'ClickHouse exception, code: 49, host: 100.100.xx.xx, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n'], + 'ErrorCode' => ['description' => 'The error code.', 'type' => 'integer', 'format' => 'int64', 'title' => '', 'example' => '0'], + ], + 'title' => '', + 'example' => '', ], ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'DeleteSyndb', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DeleteSyndb'], + ], + ], + 'ramActions' => [ [ - 'name' => 'StartTime', - 'in' => 'query', - 'schema' => [ - 'description' => 'The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-dd hh:mm:ss format. The time must be in Coordinated Universal Time (UTC).'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2022-05-20 16:00:00', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteSyndb', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2C7393F1-5FD1-5CEE-A2EA-270A2CF99693\\",\\n \\"Status\\": true,\\n \\"ErrorMsg\\": \\"ClickHouse exception, code: 49, host: 100.100.xx.xx, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n\\",\\n \\"ErrorCode\\": 0\\n}","type":"json"}]', + ], + 'DescribeAccountAuthority' => [ + 'summary' => 'Queries the permissions of a database account.', + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'EndTime', - 'in' => 'query', - 'schema' => [ - 'description' => 'The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-dd hh:mm:ss format. The time must be in UTC.'."\n" - ."\n" - .'> The end time must be later than the start time. The specified time range that can be specified must be less than seven days.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2022-05-27 16:00:00', - ], + 'AK' => [], ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'abilityTreeCode' => '19430', + 'abilityTreeNodes' => ['FEATUREclickhouseL1079N'], + ], + 'parameters' => [ [ - 'name' => 'PageSize', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries to return per page. Default value: 30. Valid values:'."\n" - ."\n" - .'* **30**'."\n" - .'* **50**'."\n" - .'* **100**'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '99999999', - 'minimum' => '1', - 'example' => '30', - 'isFileTransferUrl' => false, - 'default' => '30', - ], + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the latest region list.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'PageNumber', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The page number. Pages start from page 1. Default value: **1**.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '99999999', - 'minimum' => '1', - 'example' => '1', - 'isFileTransferUrl' => false, - 'default' => '1', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp1p816075e21****', 'title' => ''], ], [ - 'name' => 'QueryDurationMs', - 'in' => 'query', - 'schema' => [ - 'description' => 'The minimum query duration. Minimum value: **1000**. Default value: **1000**. Unit: milliseconds. Queries that last longer than the specified duration are returned in response parameters.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '9999999999', - 'minimum' => '0', - 'example' => '1000', - 'isFileTransferUrl' => false, - 'default' => '1000', - ], + 'name' => 'AccountName', + 'in' => 'query', + 'schema' => ['description' => 'The database account name.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'test', 'title' => ''], ], ], 'responses' => [ @@ -4810,185 +2726,90 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'DF203CC8-5F68-5E3F-8050-3C77DD65731A', + 'DdlAuthority' => ['description' => 'Indicates whether the account has DDL permissions. Valid values:'."\n" + ."\n" + .'- **true**: DDL permissions are granted.'."\n" + ."\n" + .'- **false**: DDL permissions are denied.', 'type' => 'boolean', 'example' => 'true', 'title' => ''], + 'DmlAuthority' => ['description' => 'The DML permission level for the account. Valid values:'."\n" + ."\n" + .'- **all**: read, write, and settings permissions.'."\n" + ."\n" + .'- **readOnly,modify**: read and settings permissions.', 'type' => 'string', 'example' => 'all', 'title' => ''], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', 'title' => ''], + 'TotalDatabases' => [ + 'description' => 'A list of all databases in the cluster.', + 'type' => 'array', + 'items' => ['description' => 'A comma-separated string of all database names, returned as a single element in an array.', 'type' => 'string', 'example' => 'db1,db2', 'title' => ''], + 'title' => '', + 'example' => '', ], - 'SlowLogRecords' => [ - 'description' => 'The details about the slow query logs.'."\n", - 'type' => 'object', - 'properties' => [ - 'TableSchema' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'ResultSet' => [ - 'description' => 'The schema of the table in the database.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => 'The type of the column.'."\n", - 'type' => 'string', - 'example' => 'String', - ], - 'Name' => [ - 'description' => 'The name of the column.'."\n", - 'type' => 'string', - 'example' => 'name', - ], - ], - ], - ], - ], - ], - 'Data' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'ResultSet' => [ - 'description' => 'Details about the slow query logs.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => 'The query status. Valid values:'."\n" - ."\n" - .'* **QueryFinish**: The query is complete.'."\n" - .'* **Processing**: The query is running.'."\n", - 'type' => 'string', - 'example' => 'QueryFinish', - ], - 'QueryStartTime' => [ - 'description' => 'The beginning of the time range to query. The time is in the yyyy-MM-dd hh:mm:ss format. The time is displayed in UTC.'."\n", - 'type' => 'string', - 'example' => '2022-05-22 20:00:01', - ], - 'Query' => [ - 'description' => 'The statement that was executed in the query.'."\n", - 'type' => 'string', - 'example' => 'Select * from table', - ], - 'ReadRows' => [ - 'description' => 'The number of rows read by executing the statement.'."\n", - 'type' => 'string', - 'example' => '10027008', - ], - 'InitialAddress' => [ - 'description' => 'The IP address of the client that initiated the query.'."\n", - 'type' => 'string', - 'example' => '::ffff:100.104.XX.XX', - ], - 'MemoryUsage' => [ - 'description' => 'The peak memory usage for the query. Unit: bytes.'."\n", - 'type' => 'string', - 'example' => '1048576', - ], - 'InitialUser' => [ - 'description' => 'The username that is used to initiate the query.'."\n", - 'type' => 'string', - 'example' => 'test_users', - ], - 'InitialQueryId' => [ - 'description' => 'The query ID.'."\n", - 'type' => 'string', - 'example' => '\'b51496f2-6b0b-4546-aff9-e17951cb9410\'', - ], - 'ReadBytes' => [ - 'description' => 'The size of the data read by executing the statement. Unit: bytes.'."\n", - 'type' => 'string', - 'example' => '1048576', - ], - 'QueryDurationMs' => [ - 'description' => 'The duration of the query. Unit: milliseconds.'."\n", - 'type' => 'string', - 'example' => '2000', - ], - 'ResultBytes' => [ - 'description' => 'The size of the result data. Unit: bytes.'."\n", - 'type' => 'string', - 'example' => '1024', - ], - ], - ], - ], - ], - ], - 'Rows' => [ - 'description' => 'The number of rows in the result set.'."\n", - 'type' => 'string', - 'example' => '1', - ], - 'RowsBeforeLimitAtLeast' => [ - 'description' => 'The number of entries per page.'."\n", - 'type' => 'string', - 'example' => '1', - ], - 'Statistics' => [ - 'description' => 'The statistics of the results.'."\n", - 'type' => 'object', - 'properties' => [ - 'RowsRead' => [ - 'description' => 'The total number of rows that were read.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2016722', - ], - 'ElapsedTime' => [ - 'description' => 'The time consumed by the slow query. Unit: milliseconds.'."\n", - 'type' => 'number', - 'format' => 'float', - 'example' => '21.35', - ], - 'BytesRead' => [ - 'description' => 'The total size of data that were read. Unit: bytes.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '123456', - ], - ], - ], - ], + 'TotalDictionaries' => [ + 'description' => 'A list of all dictionaries in the cluster.', + 'type' => 'array', + 'items' => ['description' => 'A comma-separated string of all dictionary names, returned as a single element in an array.', 'type' => 'string', 'example' => 'dt1,dt2', 'title' => ''], + 'title' => '', + 'example' => '', + ], + 'AllowDictionaries' => [ + 'description' => 'The list of authorized dictionaries.', + 'type' => 'array', + 'items' => ['description' => 'The name of a dictionary.', 'type' => 'string', 'example' => 'dt1', 'title' => ''], + 'title' => '', + 'example' => '', ], + 'AllowDatabases' => [ + 'description' => 'The list of authorized databases.', + 'type' => 'array', + 'items' => ['description' => 'The name of a database.', 'type' => 'string', 'example' => 'db1', 'title' => ''], + 'title' => '', + 'example' => '', + ], + 'AccountName' => ['description' => 'The database account name.', 'type' => 'string', 'example' => 'test', 'title' => ''], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DF203CC8-5F68-5E3F-8050-3C77DD65731A\\",\\n \\"SlowLogRecords\\": {\\n \\"TableSchema\\": {\\n \\"ResultSet\\": [\\n {\\n \\"Type\\": \\"String\\",\\n \\"Name\\": \\"name\\"\\n }\\n ]\\n },\\n \\"Data\\": {\\n \\"ResultSet\\": [\\n {\\n \\"Type\\": \\"QueryFinish\\",\\n \\"QueryStartTime\\": \\"2022-05-22 20:00:01\\",\\n \\"Query\\": \\"Select * from table\\",\\n \\"ReadRows\\": \\"10027008\\",\\n \\"InitialAddress\\": \\"::ffff:100.104.XX.XX\\",\\n \\"MemoryUsage\\": \\"1048576\\",\\n \\"InitialUser\\": \\"test_users\\",\\n \\"InitialQueryId\\": \\"\'b51496f2-6b0b-4546-aff9-e17951cb9410\'\\",\\n \\"ReadBytes\\": \\"1048576\\",\\n \\"QueryDurationMs\\": \\"2000\\",\\n \\"ResultBytes\\": \\"1024\\"\\n }\\n ]\\n },\\n \\"Rows\\": \\"1\\",\\n \\"RowsBeforeLimitAtLeast\\": \\"1\\",\\n \\"Statistics\\": {\\n \\"RowsRead\\": 2016722,\\n \\"ElapsedTime\\": 21.35,\\n \\"BytesRead\\": 123456\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n DF203CC8-5F68-5E3F-8050-3C77DD65731A\\n \\n \\n String\\n name\\n \\n \\n QueryFinish\\n 2022-05-22 20:00:01\\n Select * from table\\n 10027008\\n ::ffff:100.104.XX.XX\\n 1048576\\n test_users\\n \'b51496f2-6b0b-4546-aff9-e17951cb9410\'\\n 1048576\\n 2000\\n 1024\\n \\n 1\\n 1\\n \\n 2016722\\n 21.35\\n 123456\\n \\n \\n","errorExample":""}]', - 'title' => 'DescribeSlowLogRecords', - ], - 'DescribeDBClusterPerformance' => [ - 'summary' => 'Queries performance data about an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DdlAuthority\\": true,\\n \\"DmlAuthority\\": \\"all\\",\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"TotalDatabases\\": [\\n \\"db1,db2\\"\\n ],\\n \\"TotalDictionaries\\": [\\n \\"dt1,dt2\\"\\n ],\\n \\"AllowDictionaries\\": [\\n \\"dt1\\"\\n ],\\n \\"AllowDatabases\\": [\\n \\"db1\\"\\n ],\\n \\"AccountName\\": \\"test\\"\\n}","type":"json"}]', + 'title' => 'DescribeAccountAuthority', + 'description' => 'This API applies only to clusters of v21.8 or earlier. For clusters running a later version, you must use a privileged account and execute SQL statements to modify the permissions of a regular user.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAccountAuthority', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + ], + 'DescribeAccounts' => [ + 'summary' => 'Describes the database accounts of a specified ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -4998,97 +2819,38 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '19442', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseLESIXD', - ], + 'abilityTreeCode' => '19431', + 'abilityTreeNodes' => ['FEATUREclickhouse2H8YOY'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp125e3uu94wo****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'Key', + 'name' => 'AccountName', 'in' => 'query', - 'schema' => [ - 'description' => 'The performance metrics that you want to query. Separate multiple performance metrics with commas (,). You can query up to five performance metrics at a time. You can query the following performance metrics:'."\n" - ."\n" - .'> The **Key** parameter is required.'."\n" - ."\n" - .'* **CPU**:'."\n" - ."\n" - .' * **CPU_USAGE**: the CPU utilization'."\n" - ."\n" - .'* **Memory**:'."\n" - ."\n" - .' * **MEM_USAGE**: the memory usage'."\n" - .' * **MEM_USAGE_SIZE**: the used memory. Unit: MB'."\n" - ."\n" - .'* **Disk**:'."\n" - ."\n" - .' * **DISK_USAGE**: the disk usage'."\n" - .' * **DISK_USAGE_SIZE**: the size of the used disks. Unit: MB'."\n" - .' * **IOPS**: the disk Input/Output Operations per Second (IOPS)'."\n" - ."\n" - .'* **Connection**:'."\n" - ."\n" - .' * **CONN_USAGE**: the database connection usage'."\n" - .' * **CONN_USAGE_COUNT**: the number of database connections used'."\n" - ."\n" - .'* **Write**:'."\n" - ."\n" - .' * **TPS**: the number of rows written per second'."\n" - .' * **INSERT_SIZE**: the amount of data written per second. Unit: MB'."\n" - ."\n" - .'* **Query**:'."\n" - ."\n" - .' * **QPS**: the queries per second'."\n" - .' * **AVG_SEEK**: the average number of random seek calls'."\n" - ."\n" - .'* **WAIT**:'."\n" - ."\n" - .' * **ZK_WAIT**: the average ZooKeeper wait time. Unit: ms'."\n" - .' * **IO_WAIT**: the average I/O wait time. Unit: ms'."\n" - .' * **CPU_WAIT**: the average CPU wait time. Unit: ms'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'MEM_USAGE', - ], + 'schema' => ['description' => 'The name of the database account.'."\n" + ."\n" + .'> If this parameter is not specified, the operation queries information about all database accounts.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'testAccount'], ], [ - 'name' => 'StartTime', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time must be in Coordinated Universal Time (UTC).'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2021-11-27T16:37Z', - ], + 'schema' => ['description' => 'The number of entries to return on each page. Valid values:'."\n" + ."\n" + .'- **30** (default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '30', 'title' => '', 'example' => '30'], ], [ - 'name' => 'EndTime', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => 'The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time must be in UTC.'."\n" - ."\n" - .'> The end time must be later than the start time. The interval cannot be more than 32 days.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2021-11-27T16:38Z', - ], + 'schema' => ['description' => 'The page number. The value must be an integer that is greater than 0 and does not exceed the maximum value of the Integer data type. Default value: **1**.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'title' => '', 'example' => '1'], ], ], 'responses' => [ @@ -5096,175 +2858,270 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'EndTime' => [ - 'description' => 'The end of the time range to query. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time is displayed in Coordinated Universal Time (UTC).', - 'type' => 'string', - 'example' => '2021-11-27T16:38Z', - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'FE242962-6DA3-5FC8-9691-37B62A3210F7', - ], - 'StartTime' => [ - 'description' => 'The beginning of the time range to query. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time is displayed in UTC.', - 'type' => 'string', - 'example' => '2021-11-27T16:37Z', - ], - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp125e3uu94wo****', - ], - 'Performances' => [ - 'description' => 'The values of the queried performance metrics of the cluster.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => 'The name of the performance metric.'."\n", - 'type' => 'string', - 'example' => 'MEM_USAGE', - ], - 'Unit' => [ - 'description' => 'The unit of the performance metric.'."\n", - 'type' => 'string', - 'example' => '%', - ], - 'Series' => [ - 'description' => 'The queried performance pamaters.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Values' => [ - 'description' => 'The values of the performance parameter. Each value of the performance parameter is collected at a point in time.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Point' => [ - 'description' => 'The values of a metric.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'The values of the performance metrics at different points in time.'."\n", - 'type' => 'string', - 'example' => '[ "2021-11-26T16:39:00Z","15.08" ]', - ], - ], - ], - ], - ], - 'Name' => [ - 'description' => 'The name of the list of performance metric values.'."\n", - 'type' => 'string', - 'example' => 'cc-bp125e3uu94wo1s0k16****', - ], - ], + 'TotalCount' => ['description' => 'The total number of entries returned.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '1'], + 'PageSize' => ['description' => 'The number of entries returned per page.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '30'], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], + 'PageNumber' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '1'], + 'Accounts' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Account' => [ + 'description' => 'The list of database accounts.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'AccountStatus' => ['description' => 'The status of the database account. Valid values:'."\n" + ."\n" + .'- **Creating**: The account is being created.'."\n" + ."\n" + .'- **Available**: The account is active.'."\n" + ."\n" + .'- **AuthorityModifying**: The permissions of the account are being modified.'."\n" + ."\n" + .'- **Deleting**: The account is being deleted.'."\n" + ."\n" + .'> Only database accounts that are configured using XML files can be in the **AuthorityModifying** state.', 'type' => 'string', 'title' => '', 'example' => 'Creating'], + 'AccountDescription' => ['description' => 'The description of the database account.', 'type' => 'string', 'title' => '', 'example' => 'test'], + 'AccountType' => ['description' => 'The type of the database account. Valid values:'."\n" + ."\n" + .'- **Super**: a privileged account.'."\n" + ."\n" + .'- **Normal**: a standard account.', 'type' => 'string', 'title' => '', 'example' => 'Super'], + 'AccountName' => ['description' => 'The name of the database account.', 'type' => 'string', 'title' => '', 'example' => 'test'], + 'ConfigType' => ['description' => 'The configuration method of the database account.', 'type' => 'string', 'title' => '', 'example' => 'SQL'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], - 'Name' => [ - 'description' => 'The name of the performance metric value.'."\n", - 'type' => 'string', - 'example' => 'mem_usage', - ], + 'title' => '', + 'example' => '', ], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], + ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"EndTime\\": \\"2021-11-27T16:38Z\\",\\n \\"RequestId\\": \\"FE242962-6DA3-5FC8-9691-37B62A3210F7\\",\\n \\"StartTime\\": \\"2021-11-27T16:37Z\\",\\n \\"DBClusterId\\": \\"cc-bp125e3uu94wo****\\",\\n \\"Performances\\": [\\n {\\n \\"Key\\": \\"MEM_USAGE\\",\\n \\"Unit\\": \\"%\\",\\n \\"Series\\": [\\n {\\n \\"Values\\": [\\n {\\n \\"Point\\": [\\n \\"[ \\\\\\"2021-11-26T16:39:00Z\\\\\\",\\\\\\"15.08\\\\\\" ]\\"\\n ]\\n }\\n ],\\n \\"Name\\": \\"cc-bp125e3uu94wo1s0k16****\\"\\n }\\n ],\\n \\"Name\\": \\"mem_usage\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 2021-11-27T16:38Z\\n FE242962-6DA3-5FC8-9691-37B62A3210F7\\n 2021-11-27T16:37Z\\n cc-bp125e3uu94wo****\\n \\n MEM_USAGE\\n %\\n \\n \\n [ \\"2021-11-26T16:39:00Z\\",\\"15.08\\" ]\\n \\n cc-bp125e3uu94wo1s0k16****\\n \\n mem_usage\\n \\n","errorExample":""}]', - 'title' => 'DescribeDBClusterPerformance', - 'description' => 'You can query the performance data of a specified cluster over a specific time range based on the performance metrics. The data is collected every 30 seconds.'."\n" - ."\n" - .'> You can call this operation only for ApsaraDB for ClickHouse clusters that were created before December 1, 2021.'."\n", + 'title' => 'DescribeAccounts', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeAccounts'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAccounts', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PageNumber\\": 1,\\n \\"Accounts\\": {\\n \\"Account\\": [\\n {\\n \\"AccountStatus\\": \\"Creating\\",\\n \\"AccountDescription\\": \\"test\\",\\n \\"AccountType\\": \\"Super\\",\\n \\"AccountName\\": \\"test\\",\\n \\"ConfigType\\": \\"SQL\\"\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'UpgradeMinorVersion' => [ - 'summary' => 'Updates the minor engine version of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', + 'DescribeActiveOperationMaintainConf' => [ + 'summary' => 'Queries the active Operations and Maintenance (O&M) configuration of a ClickHouse instance.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], + ], + 'parameters' => [], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'HasConfig' => ['description' => 'Indicates whether a configuration is set.'."\n" + ."\n" + .'- 1: A configuration is set.'."\n" + ."\n" + .'- 0: No configuration is set.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '9A23C87D-87DF-4DA0-A50E-CB13F4F7923D', 'title' => ''], + 'Config' => [ + 'type' => 'object', + 'properties' => [ + 'CycleType' => ['description' => 'The cycle type.'."\n" + ."\n" + .'- Month'."\n" + ."\n" + .'- Week', 'type' => 'string', 'example' => 'Week', 'title' => ''], + 'Status' => ['description' => 'The status of the configuration. A value of 1 indicates that the configuration is enabled. A value of 2 indicates that the configuration is disabled.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'ModifiedTime' => ['description' => 'The time when the configuration was last modified.', 'type' => 'string', 'example' => '2025-06-27T07:12:53Z', 'title' => ''], + 'MaintainStartTime' => ['description' => 'The start time of the maintenance window.', 'type' => 'string', 'example' => '18:00Z', 'title' => ''], + 'MaintainEndTime' => ['description' => 'The end time of the maintenance window.', 'type' => 'string', 'example' => '22:00Z', 'title' => ''], + 'CycleTime' => ['description' => 'The day of the cycle.'."\n" + ."\n" + .'- If CycleType is Month, this parameter returns one or more numbers from 1 to 28 that indicate the day of the month. Multiple numbers are separated by commas (,).'."\n" + ."\n" + .'- If CycleType is Week, this parameter returns one or more numbers from 1 to 7 that indicate the day of the week. Multiple numbers are separated by commas (,).', 'type' => 'string', 'example' => '1', 'title' => ''], + 'CreatedTime' => ['description' => 'The time when the configuration was created.', 'type' => 'string', 'example' => '2025-03-18T06:51:11+08:00', 'title' => ''], + ], + 'description' => 'The active O\\&M configuration items.', + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + ], ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeActiveOperationMaintainConf', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HasConfig\\": 1,\\n \\"RequestId\\": \\"9A23C87D-87DF-4DA0-A50E-CB13F4F7923D\\",\\n \\"Config\\": {\\n \\"CycleType\\": \\"Week\\",\\n \\"Status\\": 1,\\n \\"ModifiedTime\\": \\"2025-06-27T07:12:53Z\\",\\n \\"MaintainStartTime\\": \\"18:00Z\\",\\n \\"MaintainEndTime\\": \\"22:00Z\\",\\n \\"CycleTime\\": \\"1\\",\\n \\"CreatedTime\\": \\"2025-03-18T06:51:11+08:00\\"\\n }\\n}","type":"json"}]', + ], + 'DescribeActiveOperationTasks' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '147860', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseN0HBPQ', + 'operationType' => 'get', + 'abilityTreeCode' => '201217', + 'abilityTreeNodes' => ['FEATUREclickhouseMCDGZK'], + ], + 'parameters' => [ + [ + 'name' => 'Region', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'cn-beijing', 'title' => ''], + ], + [ + 'name' => 'TaskType', + 'in' => 'query', + 'schema' => ['description' => 'The task type. Valid values:'."\n" + ."\n" + .'- **rds\\_apsaradb\\_upgrade**: Minor version upgrade.'."\n" + ."\n" + .'- **all**: All task types.', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'all', 'title' => ''], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => 'The number of entries to return on each page. Valid values:'."\n" + ."\n" + .'- **30** (Default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '10', 'default' => '30', 'example' => '30', 'title' => ''], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'default' => '1', 'example' => '1', 'title' => ''], + ], + [ + 'name' => 'ProductId', + 'in' => 'query', + 'schema' => ['description' => 'The product ID.', 'type' => 'string', 'required' => false, 'example' => 'clickhouse', 'title' => ''], ], - ], - 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'DbType', 'in' => 'query', 'schema' => [ - 'description' => 'The cluster ID.'."\n", + 'description' => 'The database type.', + 'enumValueTitles' => [], 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', + 'required' => false, + 'example' => 'clickhouse', + 'title' => '', ], ], [ - 'name' => 'UpgradeImmediately', + 'name' => 'Status', 'in' => 'query', - 'schema' => [ - 'description' => 'Specifies whether to update the minor engine version of the ApsaraDB for ClickHouse cluster immediately. Valid values:'."\n" - ."\n" - .'* **true**: updates the minor engine version of the ApsaraDB for ClickHouse cluster immediately.'."\n" - .'* **false**: updates the minor engine version of the ApsaraDB for ClickHouse cluster at the specified time or within the specified maintenance window.'."\n" - ."\n" - .'> If you want to update the minor engine version of the ApsaraDB for ClickHouse cluster at the specified time, **UpgradeTime** is required.'."\n", - 'type' => 'boolean', - 'required' => true, - 'docRequired' => true, - 'example' => 'false', - ], + 'schema' => ['description' => 'The task status. This parameter is used to filter tasks.'."\n" + ."\n" + .'- **-1:** All tasks.'."\n" + ."\n" + .'- **3:** Tasks to be processed.'."\n" + ."\n" + .'- **4:** Tasks in progress.'."\n" + ."\n" + .'- **5:** Successfully completed tasks.'."\n" + ."\n" + .'- **6:** Failed tasks.'."\n" + ."\n" + .'- **7:** Canceled tasks.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '-1', 'title' => ''], ], [ - 'name' => 'UpgradeVersion', + 'name' => 'InsName', 'in' => 'query', - 'schema' => [ - 'description' => 'The minor engine version to which you want to update.'."\n" - ."\n" - .'> By default, UpgradeVersion is not set and the minor engine version of the ApsaraDB for ClickHouse cluster is updated to the latest version.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '1.37.0', - ], + 'schema' => ['description' => 'The instance name.', 'type' => 'string', 'required' => false, 'example' => 'cc-bp191w*******', 'title' => ''], ], [ - 'name' => 'UpgradeTime', + 'name' => 'AllowChange', 'in' => 'query', - 'schema' => [ - 'description' => 'The update time. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time must be in Coordinated Universal Time (UTC).'."\n" - ."\n" - .'> If you do not set this parameter, the minor engine version of an ApsaraDB for ClickHouse cluster is updated within the specified maintenance window.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '2022-08-07T16:38Z', - ], + 'schema' => ['description' => 'Specifies whether the time can be changed. Valid values:'."\n" + ."\n" + .'- **0**: The time cannot be changed.'."\n" + ."\n" + .'- **1**: The time can be changed.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '-1', 'title' => ''], + ], + [ + 'name' => 'AllowCancel', + 'in' => 'query', + 'schema' => ['description' => 'Specifies whether the task can be canceled. Valid values:'."\n" + ."\n" + .'- **0**: The task cannot be canceled.'."\n" + ."\n" + .'- **1**: The task can be canceled.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '-1', 'title' => ''], + ], + [ + 'name' => 'ChangeLevel', + 'in' => 'query', + 'schema' => ['description' => 'The task level. Valid values:'."\n" + ."\n" + .'- **all** (Default): All levels.'."\n" + ."\n" + .'- **S0**: Returns tasks for fixing exceptions.'."\n" + ."\n" + .'- **S1**: Returns tasks for system O\\&M.', 'type' => 'string', 'required' => false, 'example' => 'all', 'title' => ''], ], ], 'responses' => [ @@ -5272,21 +3129,98 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'FE242962-6DA3-5FC8-9691-37B62A3210F7', + 'PageNumber' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F76', 'title' => ''], + 'PageSize' => ['description' => 'The number of entries returned per page. Valid values:'."\n" + ."\n" + .'- **30** (Default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'example' => '30', 'title' => ''], + 'TotalRecordCount' => ['description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'Items' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Status' => ['description' => 'The running status of the task. Return values:'."\n" + ."\n" + .'- **2**: Waiting for the user to specify a time.'."\n" + ."\n" + .'- **3**: To be processed.'."\n" + ."\n" + .'- **4**: In progress.'."\n" + ."\n" + .'- **5**: Successful.'."\n" + ."\n" + .'- **6**: Failed.'."\n" + ."\n" + .'- **7**: Canceled.', 'type' => 'integer', 'format' => 'int32', 'example' => '2', 'title' => ''], + 'ChangeLevelEn' => ['description' => 'The English name of the change level.', 'type' => 'string', 'example' => 'S1', 'title' => ''], + 'TaskType' => ['description' => 'The O\\&M event task type.', 'type' => 'string', 'example' => 'rds_apsaradb_upgrade', 'title' => ''], + 'InsName' => ['description' => 'The instance ID.', 'type' => 'string', 'example' => 'cc-bp191w*******'."\n", 'title' => ''], + 'Region' => ['description' => 'The region ID.', 'type' => 'string', 'example' => 'cn-beijing', 'title' => ''], + 'ImpactZh' => ['description' => 'The business impact in Chinese.', 'type' => 'string', 'example' => '实例闪断。', 'title' => ''], + 'CreatedTime' => ['description' => 'The creation time. The time is in UTC format (YYYY-MM-DDTHH:mm:ssZ).', 'type' => 'string', 'example' => '2018-05-30T14:30:00Z'."\n", 'title' => ''], + 'SwitchTime' => ['description' => 'The time when the backend initiates the switchover. The time is in UTC format (YYYY-MM-DDTHH:mm:ssZ).', 'type' => 'string', 'example' => '2018-05-30T14:30:00Z'."\n", 'title' => ''], + 'ChangeLevelZh' => ['description' => 'The event level in Chinese.', 'type' => 'string', 'example' => '系统运维'."\n", 'title' => ''], + 'Deadline' => ['description' => 'The latest time to which the task execution time can be adjusted. The time is in UTC format (YYYY-MM-DDTHH:mm:ssZ).', 'type' => 'string', 'example' => '2018-05-30T23:59:59Z'."\n", 'title' => ''], + 'PrepareInterval' => ['description' => 'The preparation time required between the start time and the switchover time. The format is HH:mm:ss.', 'type' => 'string', 'example' => '04:00:00'."\n", 'title' => ''], + 'Impact' => ['description' => 'The event impact.', 'type' => 'string', 'example' => 'TransientDisconnection'."\n", 'title' => ''], + 'TaskTypeZh' => ['description' => 'The task reason in Chinese.', 'type' => 'string', 'example' => '小版本升级'."\n", 'title' => ''], + 'CurrentAVZ' => ['description' => 'The current zone.', 'type' => 'string', 'example' => 'cn-beijing-h'."\n", 'title' => ''], + 'AllowChange' => ['description' => 'Specifies whether the time can be changed. Return values:'."\n" + ."\n" + .'- **-1**: All'."\n" + ."\n" + .'- **0**: No'."\n" + ."\n" + .'- **1**: Yes', 'type' => 'string', 'example' => '-1', 'title' => ''], + 'DbVersion' => ['description' => 'The kernel version of the cluster.', 'type' => 'string', 'example' => '23.8', 'title' => ''], + 'ImpactEn' => ['description' => 'The event impact in English.', 'type' => 'string', 'example' => 'Transient instance disconnection'."\n", 'title' => ''], + 'InsComment' => ['description' => 'The instance description.', 'type' => 'string', 'example' => 'test', 'title' => ''], + 'StartTime' => ['description' => 'The time when the backend executes the task. The time is in UTC format (YYYY-MM-DDTHH:mm:ssZ).', 'type' => 'string', 'example' => '2025-04-22T01:06Z', 'title' => ''], + 'ModifiedTime' => ['description' => 'The modification time. The time is in UTC format (YYYY-MM-DDTHH:mm:ssZ).', 'type' => 'string', 'example' => '2023-11-15T06:17:54Z', 'title' => ''], + 'AllowCancel' => ['description' => 'Specifies whether the task can be canceled. Return values:'."\n" + ."\n" + .'- **-1**: All'."\n" + ."\n" + .'- **0**: No'."\n" + ."\n" + .'- **1**: Yes', 'type' => 'string', 'example' => '-1', 'title' => ''], + 'DbType' => ['description' => 'The database type.', 'type' => 'string', 'example' => 'clickhouse', 'title' => ''], + 'ChangeLevel' => ['description' => 'The event level code.'."\n" + ."\n" + .'- **S1**: System O\\&M.'."\n" + ."\n" + .'- **S0**: Threat fixing.', 'type' => 'string', 'example' => 'S1', 'title' => ''], + 'TaskTypeEn' => ['description' => 'The task type in English.', 'type' => 'string', 'example' => 'Minor version update'."\n", 'title' => ''], + 'ResultInfo' => ['description' => 'The description of the execution result.', 'type' => 'string', 'example' => 'userCancel', 'title' => ''], + 'Id' => ['description' => 'The task ID.', 'type' => 'integer', 'format' => 'int32', 'example' => '11', 'title' => ''], + 'SubInsNames' => [ + 'type' => 'array', + 'items' => ['description' => 'A sub-instance ID.', 'type' => 'string', 'example' => '1', 'title' => ''], + 'description' => 'The sub-instance IDs.', + 'title' => '', + 'example' => '', + ], + 'TaskParams' => ['description' => 'The O\\&M event parameters.', 'type' => 'string', 'example' => '{'."\n" + .' "Action": "UpgradeDBInstance"'."\n" + .'}', 'title' => ''], + ], + 'description' => 'The list of O\\&M tasks.', + 'title' => '', + 'example' => '', + ], + 'description' => 'The list of O\\&M tasks.', + 'title' => '', + 'example' => '', ], ], 'description' => '', - ], - ], - ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'title' => '', + 'example' => '', ], ], ], @@ -5294,20 +3228,31 @@ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FE242962-6DA3-5FC8-9691-37B62A3210F7\\"\\n}","errorExample":""},{"type":"xml","example":"\\n FE242962-6DA3-5FC8-9691-37B62A3210F7\\n","errorExample":""}]', - 'title' => 'UpgradeMinorVersion', - 'description' => '> You can call this operation only for ApsaraDB for ClickHouse clusters that were purchased after December 1, 2021.'."\n", - ], - 'DescribeDBClusterConfigInXML' => [ - 'summary' => 'Queries the values of the configuration parameters in the config.xml file of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeActiveOperationTasks', + 'summary' => 'Queries the active operation tasks of a ClickHouse instance.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeActiveOperationTasks', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PageNumber\\": 1,\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F76\\",\\n \\"PageSize\\": 30,\\n \\"TotalRecordCount\\": 1,\\n \\"Items\\": [\\n {\\n \\"Status\\": 2,\\n \\"ChangeLevelEn\\": \\"S1\\",\\n \\"TaskType\\": \\"rds_apsaradb_upgrade\\",\\n \\"InsName\\": \\"cc-bp191w*******\\\\n\\",\\n \\"Region\\": \\"cn-beijing\\",\\n \\"ImpactZh\\": \\"实例闪断。\\",\\n \\"CreatedTime\\": \\"2018-05-30T14:30:00Z\\\\n\\",\\n \\"SwitchTime\\": \\"2018-05-30T14:30:00Z\\\\n\\",\\n \\"ChangeLevelZh\\": \\"系统运维\\\\n\\",\\n \\"Deadline\\": \\"2018-05-30T23:59:59Z\\\\n\\",\\n \\"PrepareInterval\\": \\"04:00:00\\\\n\\",\\n \\"Impact\\": \\"TransientDisconnection\\\\n\\",\\n \\"TaskTypeZh\\": \\"小版本升级\\\\n\\",\\n \\"CurrentAVZ\\": \\"cn-beijing-h\\\\n\\",\\n \\"AllowChange\\": \\"-1\\",\\n \\"DbVersion\\": \\"23.8\\",\\n \\"ImpactEn\\": \\"Transient instance disconnection\\\\n\\",\\n \\"InsComment\\": \\"test\\",\\n \\"StartTime\\": \\"2025-04-22T01:06Z\\",\\n \\"ModifiedTime\\": \\"2023-11-15T06:17:54Z\\",\\n \\"AllowCancel\\": \\"-1\\",\\n \\"DbType\\": \\"clickhouse\\",\\n \\"ChangeLevel\\": \\"S1\\",\\n \\"TaskTypeEn\\": \\"Minor version update\\\\n\\",\\n \\"ResultInfo\\": \\"userCancel\\",\\n \\"Id\\": 11,\\n \\"SubInsNames\\": [\\n \\"1\\"\\n ],\\n \\"TaskParams\\": \\"{\\\\n \\\\\\"Action\\\\\\": \\\\\\"UpgradeDBInstance\\\\\\"\\\\n}\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'DescribeAllDataSource' => [ + 'summary' => 'Describes all databases, tables, and columns in an instance.', + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -5317,306 +3262,329 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '153858', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], + 'abilityTreeCode' => '19432', + 'abilityTreeNodes' => ['FEATUREclickhouseMCDGZK'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all the clusters that are deployed in a specific region. The information includes the cluster IDs.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['description' => 'The database name.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'database'], + ], + [ + 'name' => 'TableName', + 'in' => 'query', + 'schema' => ['description' => 'The table name.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'table'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'FE042911-2B00-134C-9F42-816871BBAFB8', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0'], + 'Tables' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Table' => [ + 'description' => 'The table information.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'TableName' => ['description' => 'The table name.', 'type' => 'string', 'title' => '', 'example' => 'table'], + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp108z124a8o7****'], + 'SchemaName' => ['description' => 'The database name.', 'type' => 'string', 'title' => '', 'example' => 'database'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], - 'Config' => [ - 'description' => 'The values of the configuration parameters.'."\n", - 'type' => 'string', - 'example' => ''."\n" - .''."\n" - .' 300'."\n" - .' 64'."\n" - .' '."\n" - .' debug'."\n" - .' 1000M'."\n" - .' '."\n" - .' 6871947673'."\n" - .' 100'."\n" - .' 4096'."\n" - .' 0'."\n" - .' 0'."\n" - .'0.9'."\n" - .' 0'."\n" - .' 10000'."\n" - .' '."\n" - .' 256'."\n" - .' 16 1'."\n" - .' '."\n" - .' 4194304'."\n" - .'0'."\n" - .' 3435973836'."\n" - .'', + 'Columns' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Column' => [ + 'description' => 'The column information.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => 'The column type.', 'type' => 'string', 'title' => '', 'example' => 'String'], + 'ColumnName' => ['description' => 'The column name.', 'type' => 'string', 'title' => '', 'example' => 'name'], + 'TableName' => ['description' => 'The table name.', 'type' => 'string', 'title' => '', 'example' => 'table'], + 'AutoIncrementColumn' => ['description' => 'Indicates whether the column is an auto-increment column. Valid values:'."\n" + ."\n" + .'- **true**: The column is an auto-increment column.'."\n" + ."\n" + .'- **false**: The column is not an auto-increment column.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp108z124a8o7****'], + 'PrimaryKey' => ['description' => 'Indicates whether the column is a primary key. Valid values:'."\n" + ."\n" + .'- **true**: The column is a primary key.'."\n" + ."\n" + .'- **false**: The column is not a primary key.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], + 'SchemaName' => ['description' => 'The database name.', 'type' => 'string', 'title' => '', 'example' => 'database'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'Schemas' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Schema' => [ + 'description' => 'The database information.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp108z124a8o7****'], + 'SchemaName' => ['description' => 'The database name.', 'type' => 'string', 'title' => '', 'example' => 'database'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FE042911-2B00-134C-9F42-816871BBAFB8\\",\\n \\"Config\\": \\"\\\\n\\\\n 300\\\\n 64\\\\n \\\\n debug\\\\n 1000M\\\\n \\\\n 6871947673\\\\n 100\\\\n 4096\\\\n 0\\\\n 0\\\\n0.9\\\\n 0\\\\n 10000\\\\n \\\\n 256\\\\n 16 1\\\\n \\\\n 4194304\\\\n0\\\\n 3435973836\\\\n\\"\\n}","errorExample":""},{"type":"xml","example":"\\n FE042911-2B00-134C-9F42-816871BBAFB8\\n <?xml version=\\"1.0\\"?>\\n<yandex>\\n <keep_alive_timeout>300</keep_alive_timeout>\\n <listen_backlog>64</listen_backlog>\\n <logger>\\n <level>debug</level>\\n <size>1000M</size>\\n </logger>\\n <mark_cache_size>6871947673</mark_cache_size>\\n <max_concurrent_queries>100</max_concurrent_queries>\\n <max_connections>4096</max_connections>\\n <max_partition_size_to_drop>0</max_partition_size_to_drop>\\n <max_server_memory_usage>0</max_server_memory_usage>\\n<max_server_memory_usage_to_ram_ratio>0.9</max_server_memory_usage_to_ram_ratio>\\n <max_table_size_to_drop>0</max_table_size_to_drop>\\n <max_thread_pool_size>10000</max_thread_pool_size>\\n <merge_tree>\\n <max_delay_to_insert>256</max_delay_to_insert>\\n <max_part_loading_threads>16</max_part_loading_threads> <zookeeper_session_expiration_check_period>1</zookeeper_session_expiration_check_period>\\n </merge_tree>\\n <total_memory_profiler_step>4194304</total_memory_profiler_step>\\n<total_memory_tracker_sample_probability>0</total_memory_tracker_sample_probability>\\n <uncompressed_cache_size>3435973836</uncompressed_cache_size>\\n</yandex>\\n","errorExample":""}]', - 'title' => 'DescribeDBClusterConfigInXML', - 'description' => '> You can call this operation only for ApsaraDB for ClickHouse clusters that were created after December 1, 2021.'."\n", - ], - 'ModifyDBClusterConfigInXML' => [ - 'summary' => 'Changes the configuration parameters of an ApsaraDB for ClickHouse cluster that runs Community-compatible Edition.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeAllDataSource', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAllDataSource', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\",\\n \\"Tables\\": {\\n \\"Table\\": [\\n {\\n \\"TableName\\": \\"table\\",\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n },\\n \\"Columns\\": {\\n \\"Column\\": [\\n {\\n \\"Type\\": \\"String\\",\\n \\"ColumnName\\": \\"name\\",\\n \\"TableName\\": \\"table\\",\\n \\"AutoIncrementColumn\\": true,\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"PrimaryKey\\": true,\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n },\\n \\"Schemas\\": {\\n \\"Schema\\": [\\n {\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeAllDataSources' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, + 'operationType' => 'write', 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '153825', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], + 'operationType' => 'get', + 'abilityTreeCode' => '19433', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all the clusters that are deployed in a specified region, including the cluster IDs.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], - [ - 'name' => 'Config', - 'in' => 'query', - 'schema' => [ - 'description' => 'The configuration parameters whose settings you want to modify. You can call the [DescribeDBClusterConfigInXML](~~452210~~) operation to query configuration parameters, and modify the settings of the returned configuration parameters.'."\n" - ."\n" - .'> You must specify all configuration parameters even when you want to modify the setting of a single parameter. If a configuration parameter is not specified, the original value of this parameter is retained or the modification fails.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => ''."\n" - .''."\n" - .' 400'."\n" - .' 4096'."\n" - .' '."\n" - .' debug'."\n" - .' 1000M'."\n" - .' '."\n" - .' 5368709120'."\n" - .' 201'."\n" - .' 4096'."\n" - .' 0'."\n" - .' 0'."\n" - .' '."\n" - .' 256'."\n" - .' auto'."\n" - .' 100'."\n" - .' 1'."\n" - .' '."\n" - .' 1717986918'."\n" - .'', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'RegionId', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID of the cluster. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The database name.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'database'], ], [ - 'name' => 'Reason', + 'name' => 'TableName', 'in' => 'query', - 'schema' => [ - 'description' => 'The reason for the modification.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['description' => 'The table name.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'table'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'BDD29EB1-BE76-5CFA-9068-D34B696310BF', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '75EA41D7-025A-50A6-9287-359A91399F1E'], + 'Tables' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Table' => [ + 'description' => 'The table information.', + 'type' => 'array', + 'items' => [ + 'description' => 'All tables that meet the specified criteria.', + 'type' => 'object', + 'properties' => [ + 'TableName' => ['description' => 'The table name.', 'type' => 'string', 'title' => '', 'example' => 'table'], + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp108z124a8o7****'], + 'SchemaName' => ['description' => 'The database name.', 'type' => 'string', 'title' => '', 'example' => 'database'], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'Columns' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Column' => [ + 'description' => 'The column information.', + 'type' => 'array', + 'items' => [ + 'description' => 'The column information.', + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => 'The column type.', 'type' => 'string', 'title' => '', 'example' => 'String'], + 'ColumnName' => ['description' => 'The column name.', 'type' => 'string', 'title' => '', 'example' => 'name'], + 'TableName' => ['description' => 'The table name.', 'type' => 'string', 'title' => '', 'example' => 'table'], + 'AutoIncrementColumn' => ['description' => 'Indicates if the column auto-increments. Valid values:'."\n" + ."\n" + .'- **true**: The column auto-increments.'."\n" + ."\n" + .'- **false**: The column does not auto-increment.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp108z124a8o7****'], + 'PrimaryKey' => ['description' => 'Indicates if the column is a primary key. Valid values:'."\n" + ."\n" + .'- **true**: The column is a primary key.'."\n" + ."\n" + .'- **false**: The column is not a primary key.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], + 'SchemaName' => ['description' => 'The database name.', 'type' => 'string', 'title' => '', 'example' => 'database'], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'Schemas' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Schema' => [ + 'description' => 'The database information.', + 'type' => 'array', + 'items' => [ + 'description' => 'The list of databases.', + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp108z124a8o7****'], + 'SchemaName' => ['description' => 'The database name.', 'type' => 'string', 'title' => '', 'example' => 'database'], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"BDD29EB1-BE76-5CFA-9068-D34B696310BF\\"\\n}","errorExample":""},{"type":"xml","example":"\\n BDD29EB1-BE76-5CFA-9068-D34B696310BF\\n","errorExample":""}]', - 'title' => 'ModifyDBClusterConfigInXML', - 'description' => '> You can call this operation only for ApsaraDB for ClickHouse clusters that were created after December 1, 2021.'."\n", - ], - 'CheckModifyConfigNeedRestart' => [ - 'summary' => 'Queries whether an ApsaraDB for ClickHouse cluster needs to be restarted after you change the values of the configuration parameters in XML mode.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], - ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '152285', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseMCDGZK', + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all the clusters that are deployed in a specific region. The information includes the cluster IDs.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp1tm8zf130ew****', - ], - ], - [ - 'name' => 'Config', - 'in' => 'query', - 'schema' => [ - 'description' => 'The configuration parameters whose settings are modified.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => ''."\n" - .''."\n" - .' 400'."\n" - .' 4096'."\n" - .' '."\n" - .' debug'."\n" - .' 1000M'."\n" - .' '."\n" - .' 5368709120'."\n" - .' 201'."\n" - .' 4096'."\n" - .' 0'."\n" - .' 0'."\n" - .' '."\n" - .' 256'."\n" - .' auto'."\n" - .' 100'."\n" - .' 1'."\n" - .' '."\n" - .' 1717986918'."\n" - .'', - ], - ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", - 'type' => 'object', - 'properties' => [ - 'NeedRestart' => [ - 'description' => 'Indicates whether the cluster was restarted after you modified the configuration parameters. Valid values:'."\n" - ."\n" - .'* **true**: The cluster was restarted.'."\n" - .'* **false**: The cluster was not restarted.'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '06798FEE-BEF2-5FAF-A30D-728973BBE97C', - ], + 'title' => 'DescribeAllDataSources', + 'summary' => 'Queries the details of all data sources.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAllDataSources', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"NeedRestart\\": true,\\n \\"RequestId\\": \\"06798FEE-BEF2-5FAF-A30D-728973BBE97C\\"\\n}","errorExample":""},{"type":"xml","example":"\\n true\\n 06798FEE-BEF2-5FAF-A30D-728973BBE97C\\n","errorExample":""}]', - 'title' => 'CheckModifyConfigNeedRestart', - 'description' => '> You can call this operation only for ApsaraDB for ClickHouse clusters that were created after December 1, 2021.'."\n", + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"75EA41D7-025A-50A6-9287-359A91399F1E\\",\\n \\"Tables\\": {\\n \\"Table\\": [\\n {\\n \\"TableName\\": \\"table\\",\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n },\\n \\"Columns\\": {\\n \\"Column\\": [\\n {\\n \\"Type\\": \\"String\\",\\n \\"ColumnName\\": \\"name\\",\\n \\"TableName\\": \\"table\\",\\n \\"AutoIncrementColumn\\": true,\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"PrimaryKey\\": true,\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n },\\n \\"Schemas\\": {\\n \\"Schema\\": [\\n {\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'DescribeConfigHistory' => [ - 'summary' => 'Queries the change records of the configuration parameters of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeAutoRenewAttribute' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -5626,121 +3594,113 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '145141', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '209424', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all the clusters that are deployed in a specific region. The information includes the cluster IDs.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp1p816075e21****', - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => 'The region ID.', 'title' => '', 'example' => 'cn-beijing'], ], [ - 'name' => 'StartTime', + 'name' => 'DBClusterIds', 'in' => 'query', - 'schema' => [ - 'description' => 'The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in Coordinated Universal Time (UTC).'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '2022-08-11T06:27:00Z', - ], + 'schema' => ['type' => 'string', 'required' => false, 'description' => 'The cluster ID.', 'title' => '', 'example' => 'cc-uf6g4417bo*****'], ], [ - 'name' => 'EndTime', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '2022-08-22T10:06:00Z', - ], + 'schema' => ['type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '30', 'description' => 'The number of entries per page.', 'title' => '', 'example' => '30'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'description' => 'The page number.', 'title' => '', 'example' => '1'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', - ], - 'ConfigHistoryItems' => [ - 'description' => 'The change records of the configuration parameters.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Time' => [ - 'description' => 'The time when the values of the configuration parameters were changed. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.'."\n", - 'type' => 'string', - 'example' => '2022-08-22T10:00:00Z', - ], - 'OwnerId' => [ - 'description' => 'The user ID (UID) of the Alibaba Cloud account.'."\n", - 'type' => 'string', - 'example' => '253460731706911258', - ], - 'Reason' => [ - 'description' => 'The reason for the setting modification of the configuration parameters.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'Success' => [ - 'description' => 'Indicates whether the setting modification of the configuration parameters took effect. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'ChangeId' => [ - 'description' => 'The ID of the change record.'."\n", - 'type' => 'string', - 'example' => '1', + 'RequestId' => ['type' => 'string', 'description' => 'The request ID.', 'title' => '', 'example' => 'D0CEC6AC-7760-409A-A0D5-E*******'], + 'PageNumber' => ['type' => 'integer', 'format' => 'int32', 'description' => 'The page number.', 'title' => '', 'example' => '1'], + 'PageRecordCount' => ['type' => 'integer', 'format' => 'int32', 'description' => 'The number of entries on the current page.', 'title' => '', 'example' => '5'], + 'TotalRecordCount' => ['type' => 'integer', 'format' => 'int32', 'description' => 'The total number of entries.', 'title' => '', 'example' => '51'], + 'Items' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'AutoRenewAttribute' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['type' => 'string', 'description' => 'The cluster ID.', 'title' => '', 'example' => 'cc-2ze57pg09*****'], + 'PeriodUnit' => ['type' => 'string', 'description' => 'The subscription duration unit. Valid values: Month and Year.', 'title' => '', 'example' => 'Year'], + 'Duration' => ['type' => 'integer', 'format' => 'int32', 'description' => 'The subscription duration.', 'title' => '', 'example' => '1'], + 'RenewalStatus' => ['type' => 'string', 'description' => 'The renewal status. Valid values:'."\n" + ."\n" + .'- **AutoRenewal**: The cluster is automatically renewed.'."\n" + ."\n" + .'- **Normal**: The cluster is manually renewed.'."\n" + ."\n" + .'- **NotRenewal**: The cluster is not renewed upon expiration.', 'title' => '', 'example' => 'AutoRenewal'], + 'AutoRenewEnabled' => ['type' => 'boolean', 'description' => 'Indicates whether auto-renewal is enabled. Valid values:'."\n" + ."\n" + .'- **true**: Enabled.'."\n" + ."\n" + .'- **false**: Disabled.', 'title' => '', 'example' => ''], + 'RegionId' => ['type' => 'string', 'description' => 'The region ID.', 'title' => '', 'example' => 'cn-beijing'], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'description' => 'The auto-renewal information.', + 'title' => '', + 'example' => '', ], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'IdempotentParameterMismatch', - 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => 'DescribeAutoRenewAttribute', + 'summary' => 'Queries the auto-renewal status of a ClickHouse Community-Compatible cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAutoRenewAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"ConfigHistoryItems\\": [\\n {\\n \\"Time\\": \\"2022-08-22T10:00:00Z\\",\\n \\"OwnerId\\": \\"253460731706911258\\",\\n \\"Reason\\": \\"test\\",\\n \\"Success\\": true,\\n \\"ChangeId\\": \\"1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\n \\n \\n 253460731706911258\\n test\\n true\\n 1\\n \\n","errorExample":""}]', - 'title' => 'DescribeConfigHistory', - 'description' => '> You can call this operation only for ApsaraDB for ClickHouse clusters that were created after December 1, 2021.'."\n", + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E*******\\",\\n \\"PageNumber\\": 1,\\n \\"PageRecordCount\\": 5,\\n \\"TotalRecordCount\\": 51,\\n \\"Items\\": {\\n \\"AutoRenewAttribute\\": [\\n {\\n \\"DBClusterId\\": \\"cc-2ze57pg09*****\\",\\n \\"PeriodUnit\\": \\"Year\\",\\n \\"Duration\\": 1,\\n \\"RenewalStatus\\": \\"AutoRenewal\\",\\n \\"AutoRenewEnabled\\": false,\\n \\"RegionId\\": \\"cn-beijing\\"\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'DescribeConfigVersionDifference' => [ - 'summary' => 'Queries the values of the configuration parameters of an ApsaraDB for ClickHouse cluster before and after the values of the configuration parameters are changed.', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeBackupPolicy' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -5750,125 +3710,87 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '145140', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], + 'abilityTreeCode' => '19435', + 'abilityTreeNodes' => ['FEATUREclickhouseYFBZ0B'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all the clusters that are deployed in a specific region. The information includes the cluster IDs.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp1tm8zf130ew****', - ], - ], - [ - 'name' => 'ChangeId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the change record. You can call the [DescribeConfigHistory](~~452209~~) operation to query the ID of the change record.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1qx68m06981****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', - ], - 'OldConfigXML' => [ - 'description' => 'The values of the configuration parameters before the values of the configuration parameters are changed.'."\n", - 'type' => 'string', - 'example' => '"'."\n" - .''."\n" - .' 300'."\n" - .' 4096'."\n" - .' '."\n" - .' debug'."\n" - .' 1000M'."\n" - .' '."\n" - .' 5368709120'."\n" - .' 150'."\n" - .' 4096'."\n" - .' 0'."\n" - .' 0'."\n" - .' '."\n" - .' 256'."\n" - .' auto'."\n" - .' 100'."\n" - .' 1'."\n" - .' '."\n" - .' 1717986918'."\n" - .'"', - ], - 'NewConfigXML' => [ - 'description' => 'The values of the configuration parameters after the values of the configuration parameters are changed.'."\n", - 'type' => 'string', - 'example' => '"'."\n" - .''."\n" - .' 400'."\n" - .' 4096'."\n" - .' '."\n" - .' debug'."\n" - .' 1000M'."\n" - .' '."\n" - .' 5368709120'."\n" - .' 201'."\n" - .' 4096'."\n" - .' 0'."\n" - .' 0'."\n" - .' '."\n" - .' 256'."\n" - .' auto'."\n" - .' 100'."\n" - .' 1'."\n" - .' '."\n" - .' 1717986918'."\n" - .'"', - ], + 'PreferredBackupPeriod' => ['description' => 'The backup cycle. Valid values:'."\n" + ."\n" + .'- **Monday**'."\n" + ."\n" + .'- **Tuesday**'."\n" + ."\n" + .'- **Wednesday**'."\n" + ."\n" + .'- **Thursday**'."\n" + ."\n" + .'- **Friday**'."\n" + ."\n" + .'- **Saturday**'."\n" + ."\n" + .'- **Sunday**', 'type' => 'string', 'title' => '', 'example' => 'Monday'], + 'Switch' => ['description' => 'Indicates whether the backup feature is enabled. Valid values:'."\n" + ."\n" + .'- **true**: The backup feature is enabled.'."\n" + ."\n" + .'- **false**: The backup feature is disabled.', 'type' => 'string', 'title' => '', 'example' => 'true'], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], + 'PreferredBackupTime' => ['description' => 'The backup time in UTC.', 'type' => 'string', 'title' => '', 'example' => '15:00Z-16:00Z'], + 'BackupRetentionPeriod' => ['description' => 'The backup retention period. Default value: 7. Valid values: 7 to 730. Unit: day.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '7'], + 'BackupSize' => ['description' => 'The backup size. Unit: MB.', 'type' => 'string', 'title' => '', 'example' => '123124'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'IdempotentParameterMismatch', - 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"OldConfigXML\\": \\"\\\\\\"\\\\n\\\\n 300\\\\n 4096\\\\n \\\\n debug\\\\n 1000M\\\\n \\\\n 5368709120\\\\n 150\\\\n 4096\\\\n 0\\\\n 0\\\\n \\\\n 256\\\\n auto\\\\n 100\\\\n 1\\\\n \\\\n 1717986918\\\\n\\\\\\"\\",\\n \\"NewConfigXML\\": \\"\\\\\\"\\\\n\\\\n 400\\\\n 4096\\\\n \\\\n debug\\\\n 1000M\\\\n \\\\n 5368709120\\\\n 201\\\\n 4096\\\\n 0\\\\n 0\\\\n \\\\n 256\\\\n auto\\\\n 100\\\\n 1\\\\n \\\\n 1717986918\\\\n\\\\\\"\\"\\n}","errorExample":""},{"type":"xml","example":"\\n D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\n \\"<?xml version=\\"1.0\\"?>\\n<yandex>\\n <keep_alive_timeout>300</keep_alive_timeout>\\n <listen_backlog>4096</listen_backlog>\\n <logger>\\n <level>debug</level>\\n <size>1000M</size>\\n </logger>\\n <mark_cache_size>5368709120</mark_cache_size>\\n <max_concurrent_queries>150</max_concurrent_queries>\\n <max_connections>4096</max_connections>\\n <max_partition_size_to_drop>0</max_partition_size_to_drop>\\n <max_table_size_to_drop>0</max_table_size_to_drop>\\n <merge_tree>\\n <max_delay_to_insert>256</max_delay_to_insert>\\n <max_part_loading_threads>auto</max_part_loading_threads>\\n <max_suspicious_broken_parts>100</max_suspicious_broken_parts>\\n <zookeeper_session_expiration_check_period>1</zookeeper_session_expiration_check_period>\\n </merge_tree>\\n <uncompressed_cache_size>1717986918</uncompressed_cache_size>\\n</yandex>\\"\\n \\"<?xml version=\\"1.0\\"?>\\n<yandex>\\n <keep_alive_timeout>400</keep_alive_timeout>\\n <listen_backlog>4096</listen_backlog>\\n <logger>\\n <level>debug</level>\\n <size>1000M</size>\\n </logger>\\n <mark_cache_size>5368709120</mark_cache_size>\\n <max_concurrent_queries>201</max_concurrent_queries>\\n <max_connections>4096</max_connections>\\n <max_partition_size_to_drop>0</max_partition_size_to_drop>\\n <max_table_size_to_drop>0</max_table_size_to_drop>\\n <merge_tree>\\n <max_delay_to_insert>256</max_delay_to_insert>\\n <max_part_loading_threads>auto</max_part_loading_threads>\\n <max_suspicious_broken_parts>100</max_suspicious_broken_parts>\\n <zookeeper_session_expiration_check_period>1</zookeeper_session_expiration_check_period>\\n </merge_tree>\\n <uncompressed_cache_size>1717986918</uncompressed_cache_size>\\n</yandex>\\"\\n","errorExample":""}]', - 'title' => 'DescribeConfigVersionDifference', - 'description' => '> You can call this operation only for ApsaraDB for ClickHouse clusters that were created after December 1, 2021.'."\n", - ], - 'CreateRDSToClickhouseDb' => [ - 'summary' => 'Creates a task to synchronize data from an ApsaraDB RDS for MySQL instance to an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeBackupPolicy', + 'summary' => 'Queries the backup settings for a specified ApsaraDB for ClickHouse cluster.', + 'description' => '> Data backup is supported for ApsaraDB for ClickHouse clusters running version 20.3, 20.8, or 21.8.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PreferredBackupPeriod\\": \\"Monday\\",\\n \\"Switch\\": \\"true\\",\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PreferredBackupTime\\": \\"15:00Z-16:00Z\\",\\n \\"BackupRetentionPeriod\\": 7,\\n \\"BackupSize\\": \\"123124\\"\\n}","type":"json"}]', + ], + 'DescribeBackups' => [ + 'summary' => 'Queries the backup sets of a specified ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -5877,312 +3799,257 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '45979', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseZ93UXU', - ], + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '19436', + 'abilityTreeNodes' => ['FEATUREclickhouseYFBZ0B'], ], 'parameters' => [ [ - 'name' => 'DbClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-2ze5zeyl72188****', - ], - ], - [ - 'name' => 'ClickhousePort', - 'in' => 'query', - 'schema' => [ - 'description' => 'The port number of the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '8123', - ], - ], - [ - 'name' => 'CkUserName', - 'in' => 'query', - 'schema' => [ - 'description' => 'The account that is used to log on to the database in the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'user1', - ], - ], - [ - 'name' => 'CkPassword', - 'in' => 'query', - 'schema' => [ - 'description' => 'The password of the account that is used to log on to the database in the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '123456Aa', - ], - ], - [ - 'name' => 'RdsId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'rm-8vb989qj9roh0****', - ], - ], - [ - 'name' => 'RdsPort', - 'in' => 'query', - 'schema' => [ - 'description' => 'The port number of the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '3306', - ], - ], - [ - 'name' => 'RdsVpcId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the virtual private cloud (VPC) to which the ApsaraDB RDS for MySQL instance belongs.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'vpc-2zen93xryil99jsfy****', - ], - ], - [ - 'name' => 'RdsUserName', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The account that is used to log on to the database in the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'user2', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp1qx68m06981****', 'title' => ''], ], - [ - 'name' => 'RdsPassword', - 'in' => 'query', - 'schema' => [ - 'description' => 'The password of the account that is used to log on to the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '123456Rr', - ], + [ + 'name' => 'BackupId', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the backup task.', 'type' => 'string', 'required' => false, 'example' => '117403****', 'title' => ''], ], [ - 'name' => 'SkipUnsupported', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => 'Specifies whether to ignore the table schemas that do not support synchronization. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'boolean', - 'required' => true, - 'example' => 'true', - ], + 'schema' => ['description' => 'The beginning of the time range to query. Format: yyyy-MM-ddTHH:mmZ (UTC).', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2021-11-21T16:00Z', 'title' => ''], ], [ - 'name' => 'LimitUpper', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The maximum number of rows that can be synchronized per second.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '50000', - ], + 'schema' => ['description' => 'The end of the time range to query. Format: yyyy-MM-ddTHH:mmZ (UTC).', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2021-11-25T16:00Z', 'title' => ''], ], [ - 'name' => 'SynDbTables', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'The tables whose data you want to synchronize.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '[{"Schema":"recommend","Tables":["mr_platform_cpm","mr_platform_ecpm","p_monitor_record"]}]', - ], + 'schema' => ['description' => 'The number of entries per page. Valid values:'."\n" + ."\n" + .'- **30** (default)'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '30', 'default' => '30', 'example' => '30', 'title' => ''], ], [ - 'name' => 'RdsVpcUrl', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => 'The private endpoint of the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'rm-bp16t9h3999xb0a7****.mysql.rds.aliyuncs.com', - ], + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => 'The response parameters.'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '66676F54-1994-5DCF-993F-74536649628A', - ], - 'Status' => [ - 'description' => 'Indicates whether the synchronization task was created. Valid values:'."\n" - ."\n" - .'* **1**: Created.'."\n" - .'* **0**: Creation failed. The tables in the synchronization task are duplicate. The duplicate tables are returned for the **RepeatedDbs** parameter.'."\n" - .'* **-1**: Creation failed. The cause why the creation failed is returned for the **ErrorMsg** parameter.', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'ErrorMsg' => [ - 'description' => 'If the value of the **Status** parameter is -1, the cause of the creation failure is returned.'."\n", - 'type' => 'string', - 'example' => 'ClickHouse exception, code: 49, host: 100.100.79.102, port: 14540; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n', - ], - 'RepeatedDbs' => [ - 'description' => 'Duplicate tables in the synchronization task.'."\n", + 'TotalCount' => ['description' => 'The total number of entries returned.', 'type' => 'string', 'example' => '1', 'title' => ''], + 'PageSize' => ['description' => 'The number of entries per page. Valid values:'."\n" + ."\n" + .'- **30** (default)'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'string', 'example' => '30', 'title' => ''], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', 'title' => ''], + 'PageNumber' => ['description' => 'The page number.', 'type' => 'string', 'example' => '1', 'title' => ''], + 'Items' => [ + 'description' => 'The list of backup sets.', 'type' => 'array', 'items' => [ - 'description' => 'If **0** is returned for the **Status** parameter, duplicate tables are returned.'."\n", - 'type' => 'string', - 'example' => '["mr_platform_cpm","mr_platform_ecpm"]', + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'example' => 'cc-bp1qx68m06981****', 'title' => ''], + 'BackupStatus' => ['description' => 'The backup status. Valid values:'."\n" + ."\n" + .'- **Success**: The backup is complete.'."\n" + .'- **Failure**: The backup failed.', 'type' => 'string', 'example' => 'Success', 'title' => ''], + 'BackupType' => ['description' => 'The backup type. Valid values:'."\n" + ."\n" + .'- **FullBackup**: full backup.'."\n" + .'- **IncrementalBackup**: incremental backup.', 'type' => 'string', 'example' => 'IncrementalBackup', 'title' => ''], + 'BackupStartTime' => ['description' => 'The time when the backup started. Format: yyyy-MM-ddTHH:mmZ (UTC).', 'type' => 'string', 'example' => '2021-11-22T18:28:22Z', 'title' => ''], + 'BackupSize' => ['description' => 'The backup size.'."\n" + .'Unit: MB.', 'type' => 'integer', 'format' => 'int64', 'example' => '131072', 'title' => ''], + 'BackupEndTime' => ['description' => 'The time when the backup ended.'."\n" + .'Format: yyyy-MM-ddTHH:mmZ (UTC).', 'type' => 'string', 'example' => '2021-11-22T18:28:41Z', 'title' => ''], + 'BackupSetInfo' => ['description' => 'The number of nodes in the cluster.'."\n" + ."\n" + .'- Single-replica edition: valid values: 1 to 48.'."\n" + .'- Master-replica cluster: valid values: 1 to 24.', 'type' => 'string', 'example' => '{"shard_count": 4}', 'title' => ''], + 'BackupId' => ['description' => 'The ID of the backup task.', 'type' => 'string', 'example' => '117403****', 'title' => ''], + 'BackupMethod' => ['description' => 'The backup method. The value is **Physical**, which indicates physical backup.', 'type' => 'string', 'example' => 'Physical', 'title' => ''], + 'ExpireDate' => ['description' => 'The expiration time of the backup set.'."\n" + .'Format: yyyy-MM-ddTHH:mmZ (UTC).', 'type' => 'string', 'example' => '2022-07-22T18:28:41Z', 'title' => ''], + 'BackupScheduleType' => ['description' => 'The backup type. Valid values: manual (manual backup) and scheduled (automatic backup).', 'type' => 'string', 'example' => 'manual', 'title' => ''], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"66676F54-1994-5DCF-993F-74536649628A\\",\\n \\"Status\\": 0,\\n \\"ErrorMsg\\": \\"ClickHouse exception, code: 49, host: 100.100.79.102, port: 14540; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n\\",\\n \\"RepeatedDbs\\": [\\n \\"[\\\\\\"mr_platform_cpm\\\\\\",\\\\\\"mr_platform_ecpm\\\\\\"]\\"\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 66676F54-1994-5DCF-993F-74536649628A\\n 0\\n ClickHouse exception, code: 49, host: 100.100.79.102, port: 14540; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n\\n [\\"mr_platform_cpm\\",\\"mr_platform_ecpm\\"]\\n","errorExample":""}]', - 'title' => 'CreateRDSToClickhouseDb', - 'description' => '> This operation is only applicable to ApsaraDB for ClickHouse clusters.'."\n", - ], - 'ModifyDBConfig' => [ - 'summary' => 'Modifies the dictionary configuration of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - 'put', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"1\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"Items\\": [\\n {\\n \\"DBClusterId\\": \\"cc-bp1qx68m06981****\\",\\n \\"BackupStatus\\": \\"Success\\",\\n \\"BackupType\\": \\"IncrementalBackup\\",\\n \\"BackupStartTime\\": \\"2021-11-22T18:28:22Z\\",\\n \\"BackupSize\\": 131072,\\n \\"BackupEndTime\\": \\"2021-11-22T18:28:41Z\\",\\n \\"BackupSetInfo\\": \\"{\\\\\\"shard_count\\\\\\": 4}\\",\\n \\"BackupId\\": \\"117403****\\",\\n \\"BackupMethod\\": \\"Physical\\",\\n \\"ExpireDate\\": \\"2022-07-22T18:28:41Z\\",\\n \\"BackupScheduleType\\": \\"manual\\"\\n }\\n ]\\n}","type":"json"}]', + 'title' => 'Query backup sets', + 'description' => '>Only ApsaraDB for ClickHouse clusters of version 21.8 or later support the data backup feature.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeBackups'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeBackups', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + ], + 'DescribeColumns' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '19469', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], + 'operationType' => 'get', + 'abilityTreeCode' => '19437', + 'abilityTreeNodes' => ['FEATUREclickhouseMCDGZK'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-2zeux3ua25242****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1r59y779o04****', - ], + 'schema' => ['description' => 'The name of the database. You can call the [DescribeSchemas](~~350931~~) operation to query database names.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'database'], ], [ - 'name' => 'Config', + 'name' => 'TableName', 'in' => 'query', - 'schema' => [ - 'description' => 'The dictionary configuration.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '{"name":"test"}', - ], + 'schema' => ['description' => 'The name of the table. You can call the [DescribeTables](~~350932~~) operation to query table names.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'table'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => 'The response parameter.'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'BF3844B6-1B12-57A0-A259-476D2079EE83', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '66428721-FFEC-5023-B4E5-3BD1B67837E0'], + 'Items' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Column' => [ + 'description' => 'The column information.', + 'type' => 'array', + 'items' => [ + 'description' => 'The column information.', + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => 'The column type.', 'type' => 'string', 'title' => '', 'example' => 'String'], + 'ColumnName' => ['description' => 'The column name.', 'type' => 'string', 'title' => '', 'example' => 'name'], + 'TableName' => ['description' => 'The table name.', 'type' => 'string', 'title' => '', 'example' => 'table'], + 'AutoIncrementColumn' => ['description' => 'Indicates whether the column is an auto-increment column. Valid values:'."\n" + ."\n" + .'- **true**: The column is an auto-increment column.'."\n" + ."\n" + .'- **false**: The column is not an auto-increment column.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-2zeux3ua25242****'], + 'PrimaryKey' => ['description' => 'Indicates whether the column is a primary key. Valid values:'."\n" + ."\n" + .'- **true**: The column is a primary key.'."\n" + ."\n" + .'- **false**: The column is not a primary key.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], + 'SchemaName' => ['description' => 'The database name.', 'type' => 'string', 'title' => '', 'example' => 'database'], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"BF3844B6-1B12-57A0-A259-476D2079EE83\\"\\n}","errorExample":""},{"type":"xml","example":"\\n BF3844B6-1B12-57A0-A259-476D2079EE83\\n","errorExample":""}]', - 'title' => 'ModifyDBConfig', - ], - 'ModifyRDSToClickhouseDb' => [ - 'summary' => 'Modifies the synchronization task of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeColumns', + 'summary' => 'You can view columns.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeColumns', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"66428721-FFEC-5023-B4E5-3BD1B67837E0\\",\\n \\"Items\\": {\\n \\"Column\\": [\\n {\\n \\"Type\\": \\"String\\",\\n \\"ColumnName\\": \\"name\\",\\n \\"TableName\\": \\"table\\",\\n \\"AutoIncrementColumn\\": true,\\n \\"DBClusterId\\": \\"cc-2zeux3ua25242****\\",\\n \\"PrimaryKey\\": true,\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeConfigHistory' => [ + 'summary' => 'Call the DescribeConfigHistory operation to view the configuration parameter change history of a community-compatible ApsaraDB for ClickHouse cluster.', + 'methods' => ['get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -6191,214 +4058,303 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '47742', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseZ93UXU', - ], + 'operationType' => 'get', + 'abilityTreeCode' => '145141', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], ], 'parameters' => [ [ - 'name' => 'DbClusterId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp158i5wvj436****', - ], + 'schema' => ['description' => 'The cluster ID. Call the [DescribeDBClusters](~~170879~~) operation to query the information about all clusters in a specific region, including cluster IDs.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-bp1p816075e21****'], ], [ - 'name' => 'ClickhousePort', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The port number of the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '8123', - ], + 'schema' => ['description' => 'The start of the time range to query. Use the yyyy-MM-ddTHH:mm:ssZ format. The time is in UTC.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => '2022-08-11T06:27:00Z'], ], [ - 'name' => 'CkUserName', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The account that is used to log on to the database in the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'user1', - ], + 'schema' => ['description' => 'The end of the time range to query. Use the yyyy-MM-ddTHH:mm:ssZ format. The time is in UTC.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => '2022-08-22T10:06:00Z'], ], - [ - 'name' => 'CkPassword', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The password of the account that is used to log on to the database in the ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '123456Aa', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], + 'ConfigHistoryItems' => [ + 'description' => 'The change history of the configuration parameters.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Time' => ['description' => 'The time when the change was made. Use the yyyy-MM-ddTHH:mm:ssZ format. The time is in UTC.', 'type' => 'string', 'title' => '', 'example' => '2022-08-22T10:00:00Z'], + 'OwnerId' => ['description' => 'The UID of the Alibaba Cloud account.', 'type' => 'string', 'title' => '', 'example' => '253460731706911258'], + 'Reason' => ['description' => 'The reason for the parameter change.', 'type' => 'string', 'title' => '', 'example' => 'test'], + 'Success' => ['description' => 'Indicates whether the parameter change took effect. Valid values:'."\n" + ."\n" + .'- **true**: The change took effect.'."\n" + ."\n" + .'- **false**: The change did not take effect.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], + 'ChangeId' => ['description' => 'The ID of the change record.', 'type' => 'string', 'title' => '', 'example' => '1'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', ], ], - [ - 'name' => 'RdsId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'rm-uf6x3qq4t90ok****', - ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', 'description' => ''], ], - [ - 'name' => 'RdsPort', - 'in' => 'query', - 'schema' => [ - 'description' => 'The port number of the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '3306', + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'DescribeConfigHistory', + 'description' => '> This operation supports only community-compatible clusters that are created after December 1, 2021.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeConfigHistory', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"ConfigHistoryItems\\": [\\n {\\n \\"Time\\": \\"2022-08-22T10:00:00Z\\",\\n \\"OwnerId\\": \\"253460731706911258\\",\\n \\"Reason\\": \\"test\\",\\n \\"Success\\": true,\\n \\"ChangeId\\": \\"1\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'DescribeConfigVersionDifference' => [ + 'methods' => ['get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'RdsVpcId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the virtual private cloud (VPC) to which the ApsaraDB RDS for MySQL instance belongs.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'vpc-bp1v9dtwmqqjhwwg****', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'abilityTreeCode' => '145140', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], + ], + 'parameters' => [ [ - 'name' => 'RdsUserName', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The account that is used to log on to the database in the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'user2', - ], + 'schema' => ['description' => 'The cluster ID. Call the [DescribeDBClusters](~~170879~~) operation to query the IDs of all clusters in the destination region.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-bp1tm8zf130ew****'], ], [ - 'name' => 'RdsPassword', + 'name' => 'ChangeId', 'in' => 'query', - 'schema' => [ - 'description' => 'The password of the account that is used to log on to the database in the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '123456Rr', - ], + 'schema' => ['description' => 'The ID of the change record. Call the [DescribeConfigHistory](~~452209~~) operation to query the IDs of change records.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => '1'], ], - [ - 'name' => 'SkipUnsupported', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'Specifies whether to ignore databases that do not support synchronization. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'boolean', - 'required' => true, - 'example' => 'true', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], + 'OldConfigXML' => ['description' => 'The configuration parameters before the change.', 'type' => 'string', 'title' => '', 'example' => '"'."\n" + .''."\n" + .' 300'."\n" + .' 4096'."\n" + .' '."\n" + .' debug'."\n" + .' 1000M'."\n" + .' '."\n" + .' 5368709120'."\n" + .' 150'."\n" + .' 4096'."\n" + .' 0'."\n" + .' 0'."\n" + .' '."\n" + .' 256'."\n" + .' auto'."\n" + .' 100'."\n" + .' 1'."\n" + .' '."\n" + .' 1717986918'."\n" + .'"'], + 'NewConfigXML' => ['description' => 'The configuration parameters after the change.', 'type' => 'string', 'title' => '', 'example' => '"'."\n" + .''."\n" + .' 400'."\n" + .' 4096'."\n" + .' '."\n" + .' debug'."\n" + .' 1000M'."\n" + .' '."\n" + .' 5368709120'."\n" + .' 201'."\n" + .' 4096'."\n" + .' 0'."\n" + .' 0'."\n" + .' '."\n" + .' 256'."\n" + .' auto'."\n" + .' 100'."\n" + .' 1'."\n" + .' '."\n" + .' 1717986918'."\n" + .'"'], + ], + 'example' => '', ], ], - [ - 'name' => 'LimitUpper', - 'in' => 'query', - 'schema' => [ - 'description' => 'The maximum number of rows that can be synchronized per second.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '50000', + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', 'description' => ''], + ], + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'DescribeConfigVersionDifference', + 'summary' => 'Call the DescribeConfigVersionDifference operation to compare the parameter values of an ApsaraDB for ClickHouse community-compatible cluster before and after a configuration change.', + 'description' => '> This operation applies only to community-compatible clusters that were created after December 1, 2021.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeConfigVersionDifference', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"OldConfigXML\\": \\"\\\\\\"\\\\n\\\\n 300\\\\n 4096\\\\n \\\\n debug\\\\n 1000M\\\\n \\\\n 5368709120\\\\n 150\\\\n 4096\\\\n 0\\\\n 0\\\\n \\\\n 256\\\\n auto\\\\n 100\\\\n 1\\\\n \\\\n 1717986918\\\\n\\\\\\"\\",\\n \\"NewConfigXML\\": \\"\\\\\\"\\\\n\\\\n 400\\\\n 4096\\\\n \\\\n debug\\\\n 1000M\\\\n \\\\n 5368709120\\\\n 201\\\\n 4096\\\\n 0\\\\n 0\\\\n \\\\n 256\\\\n auto\\\\n 100\\\\n 1\\\\n \\\\n 1717986918\\\\n\\\\\\"\\"\\n}","type":"json"}]', + ], + 'DescribeDBClusterAccessWhiteList' => [ + 'summary' => 'Queries the IP address whitelist of a specified ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'RdsSynTables', - 'in' => 'query', - 'schema' => [ - 'description' => 'The table in the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'table', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'abilityTreeCode' => '19438', + 'abilityTreeNodes' => ['FEATUREclickhouseW0KOAC'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ [ - 'name' => 'RdsSynDb', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The database in the ApsaraDB RDS for MySQL instance.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'database', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => 'The response parameters.'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '746CD303-0B82-5E8D-886D-93A9FAF3A876', - ], - 'Status' => [ - 'description' => 'Indicates whether the modification was successful. Valid values:'."\n" - ."\n" - .'* **1**: The modification was successful.'."\n" - .'* **0**: The modification failed.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'ErrorMsg' => [ - 'description' => '* If the value **1** is returned for the **Status** parameter, the system does not return the ErrorMsg parameter.'."\n" - .'* If the value **0** is returned for the **Status** parameter, the ErrorMsg parameter returns the cause for the modification failure.'."\n", - 'type' => 'string', - 'example' => 'ClickHouse exception, code: 49, host: 100.100.118.132, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n', - ], - 'ErrorCode' => [ - 'description' => 'The error code.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', + 'DBClusterAccessWhiteList' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'IPArray' => [ + 'description' => 'The list of whitelist groups.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBClusterIPArrayAttribute' => ['description' => 'The property of the whitelist group.', 'type' => 'string', 'title' => '', 'example' => 'default'], + 'SecurityIPList' => ['description' => 'The list of IP addresses in the whitelist group.', 'type' => 'string', 'title' => '', 'example' => '192.168.xx.xx,192.168.xx.xx'], + 'DBClusterIPArrayName' => ['description' => 'The name of the whitelist group.', 'type' => 'string', 'title' => '', 'example' => 'default'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '905F13A4-5097-4897-A84D-527EC75FFF4F'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"746CD303-0B82-5E8D-886D-93A9FAF3A876\\",\\n \\"Status\\": 1,\\n \\"ErrorMsg\\": \\"ClickHouse exception, code: 49, host: 100.100.118.132, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n\\",\\n \\"ErrorCode\\": 0\\n}","errorExample":""},{"type":"xml","example":"\\n 746CD303-0B82-5E8D-886D-93A9FAF3A876\\n 1\\n ClickHouse exception, code: 49, host: 100.100.118.132, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n\\n 0\\n","errorExample":""}]', - 'title' => 'ModifyRDSToClickhouseDb', - 'description' => '> This operation is applicable only to ApsaraDB for ClickHouse clusters.'."\n", - ], - 'DescribeProcessList' => [ - 'summary' => 'Queries the details of queries that are being executed in an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - 'put', + 'title' => 'DescribeDBClusterAccessWhiteList', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '2500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeDBClusterAccessWhiteList'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterAccessWhiteList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DBClusterAccessWhiteList\\": {\\n \\"IPArray\\": [\\n {\\n \\"DBClusterIPArrayAttribute\\": \\"default\\",\\n \\"SecurityIPList\\": \\"192.168.xx.xx,192.168.xx.xx\\",\\n \\"DBClusterIPArrayName\\": \\"default\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"905F13A4-5097-4897-A84D-527EC75FFF4F\\"\\n}","type":"json"}]', + ], + 'DescribeDBClusterAttribute' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -6408,364 +4364,330 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '19454', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseLESIXD', - ], + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '19439', + 'abilityTreeNodes' => ['FEATUREclickhouseMCDGZK'], ], 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all the clusters that are deployed in a specific region. The information includes the cluster IDs.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1190tj036am****', - ], - ], - [ - 'name' => 'QueryDurationMs', - 'in' => 'query', - 'schema' => [ - 'description' => 'The minimum query duration. The minimum value is **1000**, and the default value is **1000**. Unit: milliseconds. Queries that last longer than this duration are returned in response parameters.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'docRequired' => true, - 'maximum' => '9999999999', - 'minimum' => '0', - 'example' => '500', - 'isFileTransferUrl' => false, - ], - ], - [ - 'name' => 'InitialUser', - 'in' => 'query', - 'schema' => [ - 'description' => 'The account that is used to log on to the database.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'user', - ], - ], - [ - 'name' => 'Keyword', - 'in' => 'query', - 'schema' => [ - 'description' => 'The keyword that is used to query.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'join', - ], - ], - [ - 'name' => 'Order', - 'in' => 'query', - 'schema' => [ - 'description' => 'Sorting by the specified column name. Valid values:'."\n" - ."\n" - .'* elapsed: the cumulative execution time'."\n" - .'* written_rows: the number of written rows'."\n" - .'* read_rows: the number of read rows'."\n" - .'* memory_usage: the memory usage'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'elapsed', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries to return per page. Default value: 30. Valid values:'."\n" - ."\n" - .'* **30**'."\n" - .'* **50**'."\n" - .'* **100**'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '9999999999', - 'minimum' => '0', - 'example' => '30', - 'isFileTransferUrl' => false, - 'default' => '30', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => 'The page number. Pages start from page 1. Default value: 1.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '9999999999', - 'minimum' => '1', - 'example' => '1', - 'isFileTransferUrl' => false, - 'default' => '1', - ], - ], - [ - 'name' => 'InitialQueryId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the query statement.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '6c69d508-f05f-4c74-857c-d982b7e7e79f', - ], + 'schema' => ['description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query the details of all clusters in a region, including their IDs.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp108z124a8o7****', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => 'The response parameters.'."\n", + 'description' => 'The data returned.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'FD61BB0D-788A-5185-A8E3-1B90BA8F6F04', - ], - 'ProcessList' => [ - 'description' => 'The queries.'."\n", + 'DBCluster' => [ + 'description' => 'Details about the cluster.', 'type' => 'object', 'properties' => [ - 'TableSchema' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'ResultSet' => [ - 'description' => 'Details of the columns.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => 'The column type.'."\n", - 'type' => 'string', - 'example' => 'String', - ], - 'Name' => [ - 'description' => 'The column name.'."\n", - 'type' => 'string', - 'example' => 'InitialUser', - ], - ], - ], - ], - ], - ], - 'Data' => [ + 'VpcId' => ['description' => 'The VPC ID.', 'type' => 'string', 'example' => 'vpc-bp10tr8k9qasioaty****', 'title' => ''], + 'SupportBackup' => ['description' => 'Whether the cluster supports data backup. Valid values:'."\n" + ."\n" + .'- `1`: Supported.'."\n" + ."\n" + .'- `2`: Not supported.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'SupportOss' => ['description' => 'Whether the cluster supports tiered storage for hot and cold data. Valid values:'."\n" + ."\n" + .'- `1`: Supported.'."\n" + ."\n" + .'- `2`: Not supported.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'EncryptionType' => ['description' => 'The encryption type. Valid values:'."\n" + ."\n" + .'- `CloudDisk`: disk encryption.'."\n" + ."\n" + .'- `off`: Encryption is disabled.', 'type' => 'string', 'example' => 'CloudDisk', 'title' => ''], + 'DBNodeCount' => ['description' => 'The number of nodes in the cluster.'."\n" + ."\n" + .'- For a single-replica edition, the value range is 1 to 48.'."\n" + ."\n" + .'- For a dual-replica edition, the value range is 1 to 24.', 'type' => 'integer', 'format' => 'int64', 'example' => '1', 'title' => ''], + 'MaintainTime' => ['description' => 'The maintenance window of the cluster. The time is in the `HH:mmZ-HH:mmZ` format and is in UTC.'."\n" + ."\n" + .'For example, `00:00Z-01:00Z` indicates that the maintenance window is from 00:00 to 01:00 (UTC), which corresponds to 08:00 to 09:00 in Beijing time (UTC+8).', 'type' => 'string', 'example' => '00:00Z-01:00Z', 'title' => ''], + 'CreateTime' => ['description' => 'The creation time of the cluster, in `yyyy-MM-ddTHH:mm:ssZ` format (UTC).', 'type' => 'string', 'example' => '2021-12-13T11:33:11Z', 'title' => ''], + 'PayType' => ['description' => 'The billing method. Valid values:'."\n" + ."\n" + .'- `Postpaid`: pay-as-you-go.'."\n" + ."\n" + .'- `Prepaid`: subscription.', 'type' => 'string', 'example' => 'Prepaid', 'title' => ''], + 'Tags' => [ 'type' => 'object', 'itemNode' => true, 'properties' => [ - 'ResultSet' => [ - 'description' => 'The details of the query.'."\n", + 'Tag' => [ + 'description' => 'A list of tags.', 'type' => 'array', 'items' => [ + 'description' => 'A tag object.', 'type' => 'object', 'properties' => [ - 'QueryStartTime' => [ - 'description' => 'The beginning of the time range to query. The value is in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in Coordinated Universal Time (UTC).'."\n", - 'type' => 'string', - 'example' => '2021-02-02T09:14:48Z', - ], - 'Query' => [ - 'description' => 'The SQL statement that is executed in the query.'."\n", - 'type' => 'string', - 'example' => 'select * from test order by score limit 1;', - ], - 'InitialAddress' => [ - 'description' => 'The IP address of the client that initiates the query.'."\n", - 'type' => 'string', - 'example' => '::ffff:10.1.XX.XX', - ], - 'InitialQueryId' => [ - 'description' => 'The query ID.'."\n", - 'type' => 'string', - 'example' => '2dd144fd-4230-4249-b15c-e63f964fbb5a', - ], - 'InitialUser' => [ - 'description' => 'The database account.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'QueryDurationMs' => [ - 'description' => 'The execution duration of the query. Unit: milliseconds.'."\n", - 'type' => 'string', - 'example' => '2000', - ], + 'Key' => ['description' => 'The key of the tag.', 'type' => 'string', 'example' => 'department', 'title' => ''], + 'Value' => ['description' => 'The value of the tag.', 'type' => 'string', 'example' => 'it', 'title' => ''], ], + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], ], + 'description' => 'The tags of the cluster.', + 'title' => '', + 'example' => '', ], - 'Rows' => [ - 'description' => 'The number of rows returned for the query.'."\n", - 'type' => 'string', - 'example' => '1145700', - ], - 'RowsBeforeLimitAtLeast' => [ - 'description' => 'The number of entries returned per page.'."\n", - 'type' => 'string', - 'example' => '1', - ], - 'Statistics' => [ - 'description' => 'The statistics of the results.'."\n", + 'PublicConnectionString' => ['description' => 'The public endpoint.', 'type' => 'string', 'example' => 'cc-bp1199ya710s7****.public.clickhouse.ads.aliyuncs.com', 'title' => ''], + 'StorageType' => ['description' => 'The storage type. Valid values:'."\n" + ."\n" + .''."\n" + ."\n" + .'- `CloudESSD_PL0`: ESSD PL0 disk.'."\n" + ."\n" + .''."\n" + ."\n\n" + .'- `CloudESSD`: ESSD PL1 disk.'."\n" + ."\n" + .'- `CloudESSD_PL2`: ESSD PL2 disk.'."\n" + ."\n" + .'- `CloudESSD_PL3`: ESSD PL3 disk.'."\n" + ."\n" + .'- `CloudEfficiency`: Ultra disk.', 'type' => 'string', 'example' => 'CloudESSD', 'title' => ''], + 'Port' => ['description' => 'The HTTP port.', 'type' => 'integer', 'format' => 'int32', 'example' => '8123', 'title' => ''], + 'LockMode' => ['description' => 'The lock mode of the cluster. Valid values:'."\n" + ."\n" + .'- `Unlock`: The cluster is not locked.'."\n" + ."\n" + .'- `ManualLock`: The cluster is manually locked.'."\n" + ."\n" + .'- `LockByExpiration`: The cluster is automatically locked upon expiration.'."\n" + ."\n" + .'- `LockByRestoration`: The cluster is automatically locked before a rollback.'."\n" + ."\n" + .'- `LockByDiskQuota`: The cluster is automatically locked because the storage is full.', 'type' => 'string', 'example' => 'Unlock', 'title' => ''], + 'Bid' => ['description' => 'The site ID. Valid values:'."\n" + ."\n" + .'- `26842`: China site (aliyun.com).'."\n" + ."\n" + .'- `26888`: international site (alibabacloud.com).', 'type' => 'string', 'example' => '26842', 'title' => ''], + 'EngineVersion' => ['description' => 'The engine version.', 'type' => 'string', 'example' => '21.8.10.19', 'title' => ''], + 'IsExpired' => ['description' => 'Whether the cluster has expired. Valid values:'."\n" + ."\n" + .'- `true`: The cluster has expired.'."\n" + ."\n" + .'- `false`: The cluster has not expired.', 'type' => 'string', 'example' => 'false', 'title' => ''], + 'ScaleOutStatus' => [ + 'description' => 'The data migration status.', 'type' => 'object', 'properties' => [ - 'RowsRead' => [ - 'description' => 'The number of scanned rows.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1000000', - ], - 'ElapsedTime' => [ - 'description' => 'The average response time.'."\n", - 'type' => 'number', - 'format' => 'float', - 'example' => '4156', - ], - 'BytesRead' => [ - 'description' => 'The size of the data that was scanned. Unit: bytes.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '9141300000', - ], + 'Progress' => ['description' => 'The data migration progress, as a percentage.'."\n" + ."\n" + .'> This parameter is returned only when the cluster is in the `SCALING_OUT` state.', 'type' => 'string', 'example' => '0', 'title' => ''], + 'Ratio' => ['description' => 'The data migration progress, displayed as `Amount of data migrated/Total data amount`.'."\n" + ."\n" + .'> This parameter is returned only when the cluster is in the `SCALING_OUT` state.', 'type' => 'string', 'example' => '0MB/60469MB', 'title' => ''], ], + 'title' => '', + 'example' => '', ], + 'LbKind' => ['description' => 'The type of the load balancer.', 'type' => 'string', 'example' => 'clb', 'title' => ''], + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'example' => 'cc-bp108z124a8o7****', 'title' => ''], + 'ConnectionString' => ['description' => 'The VPC endpoint.', 'type' => 'string', 'example' => 'cc-bp1qx68m06981****.ads.rds.aliyuncs.com', 'title' => ''], + 'EncryptionKey' => ['description' => 'The Key Management Service (KMS) key ID.'."\n" + ."\n" + .'> This parameter is empty if `EncryptionType` is set to `off`.', 'type' => 'string', 'example' => '685f416f-87c9-4554-8d3a-75b6ce25****', 'title' => ''], + 'DBClusterType' => ['description' => 'The cluster type. Valid values:'."\n" + ."\n" + .'- `Common`: a standard cluster.'."\n" + ."\n" + .'- `Readonly`: a read-only cluster.'."\n" + ."\n" + .'- `Guard`: a disaster recovery cluster.', 'type' => 'string', 'example' => 'Common', 'title' => ''], + 'CommodityCode' => ['description' => 'The commodity code.', 'type' => 'string', 'example' => 'clickhouse_go_public_cn', 'title' => ''], + 'ExpireTime' => ['description' => 'The expiration time of the cluster, in `yyyy-MM-ddTHH:mm:ssZ` format (UTC).'."\n" + ."\n" + .'> This parameter is empty for pay-as-you-go clusters.', 'type' => 'string', 'example' => '2022-11-11T16:00:00Z', 'title' => ''], + 'DBNodeStorage' => ['description' => 'The storage capacity per node, in GB.'."\n" + ."\n" + .'The value can range from 100 to 32000.'."\n" + ."\n" + .'> The value must be a multiple of 100.', 'type' => 'integer', 'format' => 'int64', 'example' => '100', 'title' => ''], + 'DBNodeClass' => ['description' => 'The instance type of the cluster nodes.'."\n" + ."\n" + .'- Valid values for a single-replica edition:'."\n" + ."\n" + .' - `S4-NEW`'."\n" + ."\n" + .' - `S8`'."\n" + ."\n" + .' - `S16`'."\n" + ."\n" + .' - `S32`'."\n" + ."\n" + .' - `S64`'."\n" + ."\n" + .' - `S104`'."\n" + ."\n" + .'- Valid values for a dual-replica edition:'."\n" + ."\n" + .' - `C4-NEW`'."\n" + ."\n" + .' - `C8`'."\n" + ."\n" + .' - `C16`'."\n" + ."\n" + .' - `C32`'."\n" + ."\n" + .' - `C64`'."\n" + ."\n" + .' - `C104`', 'type' => 'string', 'example' => 'C8', 'title' => ''], + 'AliUid' => ['description' => 'The Alibaba Cloud account ID.', 'type' => 'string', 'example' => '140692647406****', 'title' => ''], + 'LockReason' => ['description' => 'The reason the cluster was locked.'."\n" + ."\n" + .'> This parameter is empty if `LockMode` is set to `Unlock`.', 'type' => 'string', 'example' => 'DISK_FULL', 'title' => ''], + 'RegionId' => ['description' => 'The region ID.', 'type' => 'string', 'example' => 'cn-hangzhou', 'title' => ''], + 'PublicPort' => ['description' => 'The public TCP port.', 'type' => 'string', 'example' => '3306', 'title' => ''], + 'VSwitchId' => ['description' => 'The vSwitch ID.', 'type' => 'string', 'example' => 'vsw-bp1n874li1t5y57wi****', 'title' => ''], + 'DBClusterStatus' => ['description' => 'The cluster status. Valid values:'."\n" + ."\n" + .'- `Preparing`: The cluster is being prepared.'."\n" + ."\n" + .'- `Creating`: The cluster is being created.'."\n" + ."\n" + .'- `Running`: The cluster is running.'."\n" + ."\n" + .'- `Deleting`: The cluster is being deleted.'."\n" + ."\n" + .'- `SCALING_OUT`: The cluster is being scaled out.', 'type' => 'string', 'example' => 'Running', 'title' => ''], + 'DBClusterNetworkType' => ['description' => 'The network type. Only VPC is supported.', 'type' => 'string', 'example' => 'vpc', 'title' => ''], + 'DBClusterDescription' => ['description' => 'The cluster description.', 'type' => 'string', 'example' => 'cc-bp108z124a8o7****', 'title' => ''], + 'ZoneId' => ['description' => 'The zone ID.', 'type' => 'string', 'example' => 'cn-hangzhou-h', 'title' => ''], + 'Category' => ['description' => 'The edition of the cluster. Valid values:'."\n" + ."\n" + .'- `Basic`: single-replica edition.'."\n" + ."\n" + .'- `HighAvailability`: dual-replica edition.', 'type' => 'string', 'example' => 'HighAvailability', 'title' => ''], + 'Engine' => ['description' => 'The database engine.', 'type' => 'string', 'example' => 'ClickHouse', 'title' => ''], + 'SupportMysqlPort' => ['description' => 'Whether the MySQL port is supported. Valid values:'."\n" + ."\n" + .'- `true`: Supported.'."\n" + ."\n" + .'- `false`: Not supported.', 'type' => 'boolean', 'example' => 'false', 'title' => ''], + 'SupportHttpsPort' => ['description' => 'Whether the HTTPS port is supported. Valid values:'."\n" + ."\n" + .'- `true`: Supported.'."\n" + ."\n" + .'- `false`: Not supported.', 'type' => 'boolean', 'example' => 'false', 'title' => ''], + 'ControlVersion' => ['description' => 'The version of the backend management system. Valid values:'."\n" + ."\n" + .'- `v1`'."\n" + ."\n" + .'- `v2`', 'type' => 'string', 'example' => 'v1', 'title' => ''], + 'PublicIpAddr' => ['description' => 'The IP address of the public endpoint.', 'type' => 'string', 'example' => '121.40.xx.xx', 'title' => ''], + 'EngineMinorVersion' => ['description' => 'The engine\'s current minor version.', 'type' => 'string', 'example' => '1.6.0', 'title' => ''], + 'EngineLatestMinorVersion' => ['description' => 'The latest minor version to which the cluster can be upgraded.', 'type' => 'string', 'example' => '1.34.0', 'title' => ''], + 'MaintainAutoType' => ['description' => 'The upgrade method. A value of `false` indicates that upgrades must be performed manually.', 'type' => 'boolean', 'example' => 'false', 'title' => ''], + 'ExtStorageType' => ['description' => 'The extended storage type. Valid values:'."\n" + ."\n" + .''."\n" + ."\n" + .'- `CloudESSD_PL0`: ESSD PL0 disk.'."\n" + ."\n" + .''."\n" + ."\n\n" + .'- `CloudESSD`: ESSD PL1 disk.'."\n" + ."\n" + .'- `CloudESSD_PL2`: ESSD PL2 disk.'."\n" + ."\n" + .'- `CloudESSD_PL3`: ESSD PL3 disk.'."\n" + ."\n" + .'- `CloudEfficiency`: Ultra disk.', 'type' => 'string', 'example' => 'CloudESSD', 'title' => ''], + 'ExtStorageSize' => ['description' => 'The extended storage capacity, in GB.', 'type' => 'integer', 'format' => 'int32', 'example' => '500', 'title' => ''], + 'ResourceGroupId' => ['description' => 'The resource group ID.', 'type' => 'string', 'example' => 'rg-acfmyf65je6****', 'title' => ''], + 'ZookeeperClass' => ['description' => 'The specifications of the ZooKeeper nodes.', 'type' => 'string', 'example' => '4 Core 8 GB', 'title' => ''], + 'AppointmentRestartTime' => ['description' => 'The scheduled restart time. The time is in the `YYYY-MM-DDThh:mm:ssZ` format and is in UTC.', 'type' => 'string', 'example' => '2023-11-06T12:00:00Z', 'title' => ''], + 'ZoneIdVswitchMap' => ['description' => 'A map of zone IDs to vSwitch IDs for a multi-zone cluster.', 'type' => 'object', 'example' => 'cn-shanghai-f: vsw-zm0n42d5vvuo****', 'title' => ''], + 'AvailableUpgradeMajorVersion' => ['description' => 'The available major versions to which the cluster can be upgraded, and their latest minor versions.', 'type' => 'object', 'example' => '{"MajorVersion":"MinorVersion"}', 'title' => ''], + 'AppointmentRestartNodeTime' => ['description' => 'The scheduled time to restart specific nodes. The time is in the `YYYY-MM-DDThh:mm:ssZ` format and is in UTC.', 'type' => 'string', 'example' => '2023-11-06T12:00:00Z', 'title' => ''], + 'AppointmentRestartNodeList' => ['description' => 'A list of nodes that are scheduled for a restart.', 'type' => 'string', 'example' => 'ck-k1a976p3n********-****-clickhouse-s-0-r-0,ck-k1a976p3n********-****-clickhouse-s-0-r-1', 'title' => ''], + 'AppointmentElectZookeeperTime' => ['description' => 'The scheduled time for a primary/secondary switchover. The time is in the `YYYY-MM-DDThh:mm:ssZ` format and is in UTC.', 'type' => 'string', 'example' => '2023-11-06T12:00:00Z', 'title' => ''], + 'AppointmentElectZookeeperDisableWrite' => ['description' => 'Specifies whether to stop write operations during a primary/secondary switchover. Valid values:'."\n" + ."\n" + .'- `true`: Write operations are stopped for the instance during the switchover.'."\n" + ."\n" + .'- `false`: Write operations are not stopped for the instance during the switchover.', 'type' => 'boolean', 'example' => 'true', 'title' => ''], + 'VpcIpAddr' => ['description' => 'The IP address of the VPC endpoint.', 'type' => 'string', 'example' => '192.168.xx.xx', 'title' => ''], + 'VpcCloudInstanceId' => ['description' => 'The VPC ID.', 'type' => 'string', 'example' => 'vpc-bp10tr8k9qasioaty****', 'title' => ''], + 'WebUIStatus' => ['type' => 'string', 'example' => 'active', 'description' => '', 'title' => ''], + 'WebUISnatStatus' => ['type' => 'string', 'example' => 'active', 'description' => '', 'title' => ''], ], + 'title' => '', + 'example' => '', ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', 'title' => ''], ], + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FD61BB0D-788A-5185-A8E3-1B90BA8F6F04\\",\\n \\"ProcessList\\": {\\n \\"TableSchema\\": {\\n \\"ResultSet\\": [\\n {\\n \\"Type\\": \\"String\\",\\n \\"Name\\": \\"InitialUser\\"\\n }\\n ]\\n },\\n \\"Data\\": {\\n \\"ResultSet\\": [\\n {\\n \\"QueryStartTime\\": \\"2021-02-02T09:14:48Z\\",\\n \\"Query\\": \\"select * from test order by score limit 1;\\",\\n \\"InitialAddress\\": \\"::ffff:10.1.XX.XX\\",\\n \\"InitialQueryId\\": \\"2dd144fd-4230-4249-b15c-e63f964fbb5a\\",\\n \\"InitialUser\\": \\"test\\",\\n \\"QueryDurationMs\\": \\"2000\\"\\n }\\n ]\\n },\\n \\"Rows\\": \\"1145700\\",\\n \\"RowsBeforeLimitAtLeast\\": \\"1\\",\\n \\"Statistics\\": {\\n \\"RowsRead\\": 1000000,\\n \\"ElapsedTime\\": 4156,\\n \\"BytesRead\\": 9141300000\\n }\\n }\\n}","type":"json"}]', - 'title' => 'DescribeProcessList', - ], - 'CreateBackupPolicy' => [ - 'summary' => 'Creates a backup policy.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeDBClusterAttribute', + 'summary' => 'Retrieves details for a specific ApsaraDB for ClickHouse cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '2500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeDBClusterAttribute'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterAttribute', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DBCluster\\": {\\n \\"VpcId\\": \\"vpc-bp10tr8k9qasioaty****\\",\\n \\"SupportBackup\\": 1,\\n \\"SupportOss\\": 1,\\n \\"EncryptionType\\": \\"CloudDisk\\",\\n \\"DBNodeCount\\": 1,\\n \\"MaintainTime\\": \\"00:00Z-01:00Z\\",\\n \\"CreateTime\\": \\"2021-12-13T11:33:11Z\\",\\n \\"PayType\\": \\"Prepaid\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"Key\\": \\"department\\",\\n \\"Value\\": \\"it\\"\\n }\\n ]\\n },\\n \\"PublicConnectionString\\": \\"cc-bp1199ya710s7****.public.clickhouse.ads.aliyuncs.com\\",\\n \\"StorageType\\": \\"CloudESSD\\",\\n \\"Port\\": 8123,\\n \\"LockMode\\": \\"Unlock\\",\\n \\"Bid\\": \\"26842\\",\\n \\"EngineVersion\\": \\"21.8.10.19\\",\\n \\"IsExpired\\": \\"false\\",\\n \\"ScaleOutStatus\\": {\\n \\"Progress\\": \\"0\\",\\n \\"Ratio\\": \\"0MB/60469MB\\"\\n },\\n \\"LbKind\\": \\"clb\\",\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"ConnectionString\\": \\"cc-bp1qx68m06981****.ads.rds.aliyuncs.com\\",\\n \\"EncryptionKey\\": \\"685f416f-87c9-4554-8d3a-75b6ce25****\\",\\n \\"DBClusterType\\": \\"Common\\",\\n \\"CommodityCode\\": \\"clickhouse_go_public_cn\\",\\n \\"ExpireTime\\": \\"2022-11-11T16:00:00Z\\",\\n \\"DBNodeStorage\\": 100,\\n \\"DBNodeClass\\": \\"C8\\",\\n \\"AliUid\\": \\"140692647406****\\",\\n \\"LockReason\\": \\"DISK_FULL\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"PublicPort\\": \\"3306\\",\\n \\"VSwitchId\\": \\"vsw-bp1n874li1t5y57wi****\\",\\n \\"DBClusterStatus\\": \\"Running\\",\\n \\"DBClusterNetworkType\\": \\"vpc\\",\\n \\"DBClusterDescription\\": \\"cc-bp108z124a8o7****\\",\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"Category\\": \\"HighAvailability\\",\\n \\"Engine\\": \\"ClickHouse\\",\\n \\"SupportMysqlPort\\": false,\\n \\"SupportHttpsPort\\": false,\\n \\"ControlVersion\\": \\"v1\\",\\n \\"PublicIpAddr\\": \\"121.40.xx.xx\\",\\n \\"EngineMinorVersion\\": \\"1.6.0\\",\\n \\"EngineLatestMinorVersion\\": \\"1.34.0\\",\\n \\"MaintainAutoType\\": false,\\n \\"ExtStorageType\\": \\"CloudESSD\\",\\n \\"ExtStorageSize\\": 500,\\n \\"ResourceGroupId\\": \\"rg-acfmyf65je6****\\",\\n \\"ZookeeperClass\\": \\"4 Core 8 GB\\",\\n \\"AppointmentRestartTime\\": \\"2023-11-06T12:00:00Z\\",\\n \\"ZoneIdVswitchMap\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n },\\n \\"AvailableUpgradeMajorVersion\\": {\\n \\"MajorVersion\\": \\"MinorVersion\\"\\n },\\n \\"AppointmentRestartNodeTime\\": \\"2023-11-06T12:00:00Z\\",\\n \\"AppointmentRestartNodeList\\": \\"ck-k1a976p3n********-****-clickhouse-s-0-r-0,ck-k1a976p3n********-****-clickhouse-s-0-r-1\\",\\n \\"AppointmentElectZookeeperTime\\": \\"2023-11-06T12:00:00Z\\",\\n \\"AppointmentElectZookeeperDisableWrite\\": true,\\n \\"VpcIpAddr\\": \\"192.168.xx.xx\\",\\n \\"VpcCloudInstanceId\\": \\"vpc-bp10tr8k9qasioaty****\\",\\n \\"WebUIStatus\\": \\"active\\",\\n \\"WebUISnatStatus\\": \\"active\\"\\n },\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","type":"json"}]', + ], + 'DescribeDBClusterConfig' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '19423', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseYFBZ0B', - ], + 'operationType' => 'get', + 'abilityTreeCode' => '19440', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], - [ - 'name' => 'PreferredBackupTime', - 'in' => 'query', - 'schema' => [ - 'description' => 'The backup window. Specify the time in the ISO 8601 standard in the HH:mmZ-HH:mmZ format. The time must be in Coordinated Universal Time (UTC).'."\n" - ."\n" - .'For example, if you set the backup window to 00:00Z-01:00Z, the data of the cluster can be backed up from 08:00 (UTC+8) to 09:00 (UTC+8).'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '10:00Z-11:00Z', - ], - ], - [ - 'name' => 'PreferredBackupPeriod', - 'in' => 'query', - 'schema' => [ - 'description' => 'The day of a week when the system regularly backs up data. If you specify multiple days of a week, separate them with commas (,). Valid values:'."\n" - ."\n" - .'* **Monday**'."\n" - .'* **Tuesday**'."\n" - .'* **Wednesday**'."\n" - .'* **Thursday**'."\n" - .'* **Friday**'."\n" - .'* **Saturday**'."\n" - .'* **Sunday**'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'Monday,Friday', - ], - ], - [ - 'name' => 'BackupRetentionPeriod', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The backup retention period. The default retention period is seven days. Valid values: 7 to 730. Unit: day.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '8', - 'default' => '7', - ], + 'schema' => ['description' => 'The region ID. Call the [DescribeRegions](~~170875~~) operation to query the available region IDs.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-wz988vja2mor4****'], ], ], 'responses' => [ @@ -6773,111 +4695,155 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '9A23C87D-87DF-4DA0-A50E-CB13F4F7923D'], + 'Config' => ['description' => 'The parameter configuration of the cluster.', 'type' => 'string', 'title' => '', 'example' => '[ { "name": "keep_alive_timeout", "defaultValue": 300, "currentValue": 300, "restart": true, "valueRange": ">0", "desc": "The number of seconds that ClickHouse waits for incoming requests before closing the connection." }, ... ,{ "name": "max_partition_size_to_drop", "defaultValue": 0, "currentValue": 0, "restart": true, "valueRange": ">=0", "desc": "If the size of a MergeTree partition exceeds max_partition_size_to_drop (in bytes), you can’t delete it using a DROP query." } ]'], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","errorExample":""},{"type":"xml","example":"\\n F5178C10-1407-4987-9133-DE4DC9119F75\\n","errorExample":""}]', - 'title' => 'CreateBackupPolicy', - 'description' => '> This operation is available only for the ApsaraDB for ClickHouse clusters of versions 20.3, 20.8, and 21.8.'."\n", - ], - 'ModifyBackupPolicy' => [ - 'summary' => 'Modifies the backup settings of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeDBClusterConfig', + 'summary' => 'The DescribeDBClusterConfig operation queries the parameter configuration of a community-compatible ClickHouse cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterConfig', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9A23C87D-87DF-4DA0-A50E-CB13F4F7923D\\",\\n \\"Config\\": \\"[ { \\\\\\"name\\\\\\": \\\\\\"keep_alive_timeout\\\\\\", \\\\\\"defaultValue\\\\\\": 300, \\\\\\"currentValue\\\\\\": 300, \\\\\\"restart\\\\\\": true, \\\\\\"valueRange\\\\\\": \\\\\\">0\\\\\\", \\\\\\"desc\\\\\\": \\\\\\"The number of seconds that ClickHouse waits for incoming requests before closing the connection.\\\\\\" }, ... ,{ \\\\\\"name\\\\\\": \\\\\\"max_partition_size_to_drop\\\\\\", \\\\\\"defaultValue\\\\\\": 0, \\\\\\"currentValue\\\\\\": 0, \\\\\\"restart\\\\\\": true, \\\\\\"valueRange\\\\\\": \\\\\\">=0\\\\\\", \\\\\\"desc\\\\\\": \\\\\\"If the size of a MergeTree partition exceeds max_partition_size_to_drop (in bytes), you can’t delete it using a DROP query.\\\\\\" } ]\\"\\n}","type":"json"}]', + ], + 'DescribeDBClusterConfigInXML' => [ + 'summary' => 'You can call the DescribeDBClusterConfigInXML operation to query the configuration parameters of an ApsaraDB for ClickHouse Community-Compatible Edition cluster in XML format.', + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '19463', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseYFBZ0B', - ], + 'operationType' => 'get', + 'abilityTreeCode' => '153858', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1qx68m06981****', - ], + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query region IDs.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'cn-hangzhou'], ], [ - 'name' => 'PreferredBackupTime', + 'name' => 'DBClusterId', 'in' => 'query', + 'schema' => ['description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all clusters in the destination region, including cluster IDs.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The backup window. Specify the time in the ISO 8601 standard in the HH:mmZ-HH:mmZ format. The time must be in Coordinated Universal Time (UTC).'."\n" - ."\n" - .'For example, if you set the backup window to 00:00Z-01:00Z, the data of the cluster can be backed up from 08:00 (UTC+8) to 09:00 (UTC+8).'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '15:00Z-16:00Z', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'FE042911-2B00-134C-9F42-816871BBAFB8'], + 'Config' => ['description' => 'The configuration parameters.', 'type' => 'string', 'title' => '', 'example' => ''."\n" + .''."\n" + .' 300'."\n" + .' 64'."\n" + .' '."\n" + .' debug'."\n" + .' 1000M'."\n" + .' '."\n" + .' 6871947673'."\n" + .' 100'."\n" + .' 4096'."\n" + .' 0'."\n" + .' 0'."\n" + .'0.9'."\n" + .' 0'."\n" + .' 10000'."\n" + .' '."\n" + .' 256'."\n" + .' 16 1'."\n" + .' '."\n" + .' 4194304'."\n" + .'0'."\n" + .' 3435973836'."\n" + .''], + ], + 'example' => '', ], ], - [ - 'name' => 'PreferredBackupPeriod', - 'in' => 'query', - 'schema' => [ - 'description' => 'The day of a week when the system regularly backs up data. If you specify multiple days of a week, separate them with commas (,). Valid values:'."\n" - ."\n" - .'* **Monday**'."\n" - .'* **Tuesday**'."\n" - .'* **Wednesday**'."\n" - .'* **Thursday**'."\n" - .'* **Friday**'."\n" - .'* **Saturday**'."\n" - .'* **Sunday**'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'Monday', + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'DescribeDBClusterConfigInXML', + 'description' => '> This operation supports only Community-Compatible Edition clusters that are created after December 1, 2021.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterConfigInXML', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FE042911-2B00-134C-9F42-816871BBAFB8\\",\\n \\"Config\\": \\"\\\\n\\\\n 300\\\\n 64\\\\n \\\\n debug\\\\n 1000M\\\\n \\\\n 6871947673\\\\n 100\\\\n 4096\\\\n 0\\\\n 0\\\\n0.9\\\\n 0\\\\n 10000\\\\n \\\\n 256\\\\n 16 1\\\\n \\\\n 4194304\\\\n0\\\\n 3435973836\\\\n\\"\\n}","type":"json"}]', + ], + 'DescribeDBClusterNetInfoItems' => [ + 'summary' => 'Queries the network information for a specified ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'get', 'tenantRelevance' => 'tenant'], + 'parameters' => [ [ - 'name' => 'BackupRetentionPeriod', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The retention period for the backup data. Valid values: 7 to 730. Unit: days.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '7', - 'default' => '7', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1qx68m06981****'], ], ], 'responses' => [ @@ -6885,43 +4851,94 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', + 'NetInfoItems' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'NetInfoItem' => [ + 'description' => 'A list of network information.', + 'type' => 'array', + 'items' => [ + 'description' => 'A list of network information.', + 'type' => 'object', + 'properties' => [ + 'VpcId' => ['description' => 'The VPC ID.'."\n" + ."\n" + .'> This parameter is empty if the network type of the endpoint is \\`Public\\`.', 'type' => 'string', 'title' => '', 'example' => 'vpc-bp175iuvg8nxqraf2****'], + 'VSwitchId' => ['description' => 'The vSwitch ID.'."\n" + ."\n" + .'> This parameter is empty if the network type of the endpoint is \\`Public\\`.', 'type' => 'string', 'title' => '', 'example' => 'vsw-bp1gzt31twhlo0sa5****'], + 'ConnectionString' => ['description' => 'The database endpoint.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp1554t789i8e****.clickhouse.ads.aliyuncs.com'], + 'JdbcPort' => ['description' => 'The Java Database Connectivity (JDBC) port number.', 'type' => 'string', 'title' => '', 'example' => '3306'], + 'NetType' => ['description' => 'The network type of the endpoint. Valid values:'."\n" + ."\n" + .'- Public: the public network.'."\n" + ."\n" + .'- VPC: a VPC.', 'type' => 'string', 'title' => '', 'example' => 'VPC'], + 'HttpPort' => ['description' => 'The HTTP port number.', 'type' => 'string', 'title' => '', 'example' => '8123'], + 'IPAddress' => ['description' => 'The IP address.', 'type' => 'string', 'title' => '', 'example' => '10.255.234.251'], + 'HttpsPort' => ['description' => 'The HTTPS port number.', 'type' => 'string', 'title' => '', 'example' => '8443'], + 'MySQLPort' => ['description' => 'The MySQL port number.', 'type' => 'string', 'title' => '', 'example' => '9004'], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'ClusterNetworkType' => ['description' => 'The network type. Only VPC is supported.', 'type' => 'string', 'title' => '', 'example' => 'VPC'], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '9A23C87D-87DF-4DA0-A50E-CB13F4F7923D'], + 'EnableSLB' => ['description' => 'Indicates whether Server Load Balancer (SLB) is enabled in the VPC. Valid values:'."\n" + ."\n" + .'- true: enabled.'."\n" + ."\n" + .'- false: disabled.', 'type' => 'boolean', 'required' => true, 'title' => '', 'example' => 'true'], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","errorExample":""},{"type":"xml","example":"\\n F5178C10-1407-4987-9133-DE4DC9119F75\\n","errorExample":""}]', - 'title' => 'ModifyBackupPolicy', - 'description' => '> This operation is available only for the ApsaraDB for ClickHouse clusters of versions 20.3, 20.8, and 21.8.'."\n", - ], - 'DescribeBackupPolicy' => [ - 'summary' => 'Queries the backup settings of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - 'put', + 'title' => 'DescribeDBClusterNetInfoItems', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeDBClusterNetInfoItems'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterNetInfoItems', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"NetInfoItems\\": {\\n \\"NetInfoItem\\": [\\n {\\n \\"VpcId\\": \\"vpc-bp175iuvg8nxqraf2****\\",\\n \\"VSwitchId\\": \\"vsw-bp1gzt31twhlo0sa5****\\",\\n \\"ConnectionString\\": \\"cc-bp1554t789i8e****.clickhouse.ads.aliyuncs.com\\",\\n \\"JdbcPort\\": \\"3306\\",\\n \\"NetType\\": \\"VPC\\",\\n \\"HttpPort\\": \\"8123\\",\\n \\"IPAddress\\": \\"10.255.234.251\\",\\n \\"HttpsPort\\": \\"8443\\",\\n \\"MySQLPort\\": \\"9004\\"\\n }\\n ]\\n },\\n \\"ClusterNetworkType\\": \\"VPC\\",\\n \\"RequestId\\": \\"9A23C87D-87DF-4DA0-A50E-CB13F4F7923D\\",\\n \\"EnableSLB\\": true\\n}","type":"json"}]', + ], + 'DescribeDBClusterNodeInfos' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -6931,22 +4948,37 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '19435', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseYFBZ0B', - ], + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '173004', + 'abilityTreeNodes' => ['FEATUREclickhouseMCDGZK'], ], 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1qx68m06981****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp108z124a8o7****', 'title' => ''], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => 'The number of entries per page. Valid values:'."\n" + ."\n" + .'- **30** (default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '30', 'example' => '30', 'title' => ''], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'example' => '1', 'title' => ''], ], ], 'responses' => [ @@ -6954,80 +4986,96 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'PreferredBackupPeriod' => [ - 'description' => 'The day of a week when the system regularly backs up data. Valid values:'."\n" - ."\n" - .'* **Monday**'."\n" - .'* **Tuesday**'."\n" - .'* **Wednesday**'."\n" - .'* **Thursday**'."\n" - .'* **Friday**'."\n" - .'* **Saturday**'."\n" - .'* **Sunday**'."\n", - 'type' => 'string', - 'example' => 'Monday', - ], - 'Switch' => [ - 'description' => 'Indicates whether the backup feature is enabled. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'string', - 'example' => 'true', - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], - 'PreferredBackupTime' => [ - 'description' => 'The backup window. The time is displayed in Coordinated Universal Time (UTC).'."\n", - 'type' => 'string', - 'example' => '15:00Z-16:00Z', - ], - 'BackupRetentionPeriod' => [ - 'description' => 'The retention period for the backup data. By default, the backup data is retained for seven days. Valid values: 7 to 730. Unit: day.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '7', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '746CD303-0B82-5E8D-886D-93A9FAF3A876'], + 'NodeInfos' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ShardId' => ['description' => 'The shard ID.', 'type' => 'string', 'example' => '2', 'title' => ''], + 'ReplicaId' => ['description' => 'The node ID.', 'type' => 'string', 'example' => '1', 'title' => ''], + 'NodeName' => ['description' => 'The node name.', 'type' => 'string', 'example' => 'ck-bp108z124a8****', 'title' => ''], + 'NodeIp' => ['description' => 'The IP address of the node.', 'type' => 'string', 'example' => '172.168.0.1', 'title' => ''], + 'FailoverTesting' => ['description' => 'Indicates whether a disaster recovery test is in progress.', 'type' => 'boolean', 'example' => 'true', 'title' => ''], + ], + 'description' => 'The node information.', + 'title' => '', + 'example' => '', + ], + 'description' => 'The information about the ClickHouse nodes.', + 'title' => '', + 'example' => '', ], - 'BackupSize' => [ - 'description' => 'The size of the backup data. Unit: MB.'."\n", - 'type' => 'string', - 'example' => '123124', + 'ZkNodeInfos' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ReplicaId' => ['description' => 'The ZooKeeper node ID.', 'type' => 'string', 'example' => '1', 'title' => ''], + 'NodeName' => ['description' => 'The node name.', 'type' => 'string', 'example' => 'ck-bp108z124a8****'."\n", 'title' => ''], + 'FailoverTesting' => ['description' => 'Indicates whether a disaster recovery test is in progress.', 'type' => 'boolean', 'example' => 'true', 'title' => ''], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'description' => 'The information about the ZooKeeper nodes.', + 'title' => '', + 'example' => '', ], + 'PageNumber' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'PageSize' => ['description' => 'The number of entries per page. Valid values:'."\n" + ."\n" + .'- **30** (default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'example' => '30', 'title' => ''], + 'TotalNodeCount' => ['description' => 'The total number of nodes.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], ], - 'description' => '', + 'title' => '', + 'description' => 'Schema of Response', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"PreferredBackupPeriod\\": \\"Monday\\",\\n \\"Switch\\": \\"true\\",\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PreferredBackupTime\\": \\"15:00Z-16:00Z\\",\\n \\"BackupRetentionPeriod\\": 7,\\n \\"BackupSize\\": \\"123124\\"\\n}","errorExample":""},{"type":"xml","example":"\\n Monday\\n true\\n F5178C10-1407-4987-9133-DE4DC9119F75\\n 15:00Z-16:00Z\\n 7\\n 123124\\n","errorExample":""}]', - 'title' => 'DescribeBackupPolicy', - 'description' => '> This operation is available only for the ApsaraDB for ClickHouse clusters of versions 20.3, 20.8, and 21.8.'."\n", - ], - 'DescribeBackups' => [ - 'summary' => 'Queries the backup sets of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeDBClusterNodeInfos', + 'summary' => 'Queries node information for a ClickHouse Community-Compatible instance.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterNodeInfos', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"746CD303-0B82-5E8D-886D-93A9FAF3A876\\",\\n \\"NodeInfos\\": [\\n {\\n \\"ShardId\\": \\"2\\",\\n \\"ReplicaId\\": \\"1\\",\\n \\"NodeName\\": \\"ck-bp108z124a8****\\",\\n \\"NodeIp\\": \\"172.168.0.1\\",\\n \\"FailoverTesting\\": true\\n }\\n ],\\n \\"ZkNodeInfos\\": [\\n {\\n \\"ReplicaId\\": \\"1\\",\\n \\"NodeName\\": \\"ck-bp108z124a8****\\\\n\\",\\n \\"FailoverTesting\\": true\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalNodeCount\\": 1\\n}","type":"json"}]', + ], + 'DescribeDBClusterPerformance' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -7037,85 +5085,80 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '19436', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseYFBZ0B', - ], + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '19442', + 'abilityTreeNodes' => ['FEATUREclickhouseLESIXD'], + 'tenantRelevance' => 'tenant', ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1qx68m06981****', - ], - ], - [ - 'name' => 'BackupId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The backup task ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '117403****', - ], - ], - [ - 'name' => 'StartTime', - 'in' => 'query', - 'schema' => [ - 'description' => 'The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time must be in UTC.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2021-11-21T16:00Z', - ], + 'parameters' => [ + [ + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp125e3uu94wo****', 'title' => ''], ], [ - 'name' => 'EndTime', + 'name' => 'Key', 'in' => 'query', - 'schema' => [ - 'description' => 'The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time must be in UTC.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2021-11-25T16:00Z', - ], + 'schema' => ['description' => 'The performance metrics that you want to query. Separate multiple metric names with a comma (,). You can query up to five performance metrics at a time. The following performance metrics are supported:'."\n" + ."\n" + .'> **Key** is required.'."\n" + ."\n" + .'- **CPU**:'."\n" + ."\n" + .' - **CPU\\_USAGE**: The CPU utilization.'."\n" + ."\n" + .'- **Memory**:'."\n" + ."\n" + .' - **MEM\\_USAGE**: The memory utilization.'."\n" + ."\n" + .' - **MEM\\_USAGE\\_SIZE**: The memory usage in MB.'."\n" + ."\n" + .'- **Disk**:'."\n" + ."\n" + .' - **DISK\\_USAGE**: The disk utilization.'."\n" + ."\n" + .' - **DISK\\_USAGE\\_SIZE**: The disk usage in MB.'."\n" + ."\n" + .' - **IOPS**: The disk input/output operations per second (IOPS).'."\n" + ."\n" + .'- **Connection**:'."\n" + ."\n" + .' - **CONN\\_USAGE**: The database connection utilization.'."\n" + ."\n" + .' - **CONN\\_USAGE\\_COUNT**: The number of database connections.'."\n" + ."\n" + .'- **Write**:'."\n" + ."\n" + .' - **TPS**: The number of rows written per second (TPS).'."\n" + ."\n" + .' - **INSERT\\_SIZE**: The write size per second in MB.'."\n" + ."\n" + .'- **Query**:'."\n" + ."\n" + .' - **QPS**: The queries per second (QPS).'."\n" + ."\n" + .' - **AVG\\_SEEK**: The number of random SEEK calls.'."\n" + ."\n" + .'- **WAIT**:'."\n" + ."\n" + .' - **ZK\\_WAIT**: The average wait time of ZooKeeper (ZK) in ms.'."\n" + ."\n" + .' - **IO\\_WAIT**: The average I/O wait time in ms.'."\n" + ."\n" + .' - **CPU\\_WAIT**: The average CPU wait time in ms.', 'type' => 'string', 'required' => false, 'example' => 'MEM_USAGE', 'title' => ''], ], [ - 'name' => 'PageSize', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries per page. Valid values:'."\n" - ."\n" - .'* **30** (default)'."\n" - .'* **50**'."\n" - .'* **100**'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '30', - 'example' => '30', - 'default' => '30', - ], + 'schema' => ['description' => 'The beginning of the time range to query. Specify the time in UTC using the `yyyy-MM-ddTHH:mmZ` format.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2021-11-27T16:37Z', 'title' => ''], ], [ - 'name' => 'PageNumber', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The page number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - ], + 'schema' => ['description' => 'The end of the time range to query. Specify the time in UTC using the `yyyy-MM-ddTHH:mmZ` format.'."\n" + ."\n" + .'> The end time must be later than the start time. The maximum time range cannot exceed 32 days.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2021-11-27T16:38Z', 'title' => ''], ], ], 'responses' => [ @@ -7123,110 +5166,67 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => 'The total number of entries returned.'."\n", - 'type' => 'string', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => 'The number of entries per page. Valid values: Valid values:'."\n" - ."\n" - .'* **30** (default)'."\n" - .'* **50**'."\n" - .'* **100**'."\n", - 'type' => 'string', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], - 'PageNumber' => [ - 'description' => 'The page number.'."\n", - 'type' => 'string', - 'example' => '1', - ], - 'Items' => [ - 'description' => 'The backup sets.'."\n", + 'EndTime' => ['description' => 'The end of the time range that was queried. The time is in UTC, formatted as `yyyy-MM-ddTHH:mmZ`.', 'type' => 'string', 'example' => '2021-11-27T16:38Z', 'title' => ''], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => 'FE242962-6DA3-5FC8-9691-37B62A3210F7', 'title' => ''], + 'StartTime' => ['description' => 'The beginning of the time range that was queried. The time is in UTC, formatted as `yyyy-MM-ddTHH:mmZ`.', 'type' => 'string', 'example' => '2021-11-27T16:37Z', 'title' => ''], + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'example' => 'cc-bp125e3uu94wo****', 'title' => ''], + 'Performances' => [ + 'description' => 'The list of performance metrics for the cluster.', 'type' => 'array', 'items' => [ + 'description' => 'The performance metric.', 'type' => 'object', 'properties' => [ - 'DBClusterId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp1qx68m06981****', - ], - 'BackupStatus' => [ - 'description' => 'The backup status. Valid values:'."\n" - ."\n" - .'* **Success**'."\n" - .'* **Failure**'."\n", - 'type' => 'string', - 'example' => 'Success', - ], - 'BackupType' => [ - 'description' => 'The backup type. Valid values:'."\n" - ."\n" - .'* **FullBackup**'."\n" - .'* **IncrementalBackup**'."\n", - 'type' => 'string', - 'example' => 'IncrementalBackup', - ], - 'BackupStartTime' => [ - 'description' => 'The start time of the backup task. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time is displayed in UTC.'."\n", - 'type' => 'string', - 'example' => '2021-11-22T18:28:22Z', - ], - 'BackupSize' => [ - 'description' => 'The size of the backup set. Unit: MB.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '131072', - ], - 'BackupEndTime' => [ - 'description' => 'The end time of the backup task. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time is displayed in UTC.'."\n", - 'type' => 'string', - 'example' => '2021-11-22T18:28:41Z', - ], - 'BackupSetInfo' => [ - 'description' => 'The number of nodes in the cluster.'."\n" - ."\n" - .'* If the cluster is of Single-replica Edition, the value ranges from 1 to 48.'."\n" - .'* If the cluster is of Double-replica Edition, the value ranges from 1 to 24.'."\n", - 'type' => 'string', - 'example' => '{"shard_count":4}', - ], - 'BackupId' => [ - 'description' => 'The backup task ID.'."\n", - 'type' => 'string', - 'example' => '117403****', - ], - 'BackupMethod' => [ - 'description' => 'The backup method. Valid values: Only **Physical** is returned. This value indicates that a physical backup was performed.'."\n", - 'type' => 'string', - 'example' => 'Physical', - ], - 'ExpireDate' => [ - 'description' => 'The time when the backup set expired. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time is displayed in UTC.'."\n", - 'type' => 'string', - 'example' => '2022-07-22T18:28:41Z', + 'Key' => ['description' => 'The name of the performance metric.', 'type' => 'string', 'example' => 'MEM_USAGE', 'title' => ''], + 'Unit' => ['description' => 'The unit of the metric.', 'type' => 'string', 'example' => '%', 'title' => ''], + 'Series' => [ + 'description' => 'The time series data for the metric.', + 'type' => 'array', + 'items' => [ + 'description' => 'The metric information.', + 'type' => 'object', + 'properties' => [ + 'Values' => [ + 'description' => 'The values of the performance metrics, each associated with a sampling timestamp.', + 'type' => 'array', + 'items' => [ + 'description' => 'The metric value.', + 'type' => 'object', + 'properties' => [ + 'Point' => [ + 'description' => 'The value of the performance metric.', + 'type' => 'array', + 'items' => ['description' => 'Detailed time-series data for the performance metric.', 'type' => 'string', 'example' => '[ "2021-11-26T16:39:00Z","15.08" ]', 'title' => ''], + 'title' => '', + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + 'Name' => ['description' => 'The name of the time series.', 'type' => 'string', 'example' => 'cc-bp125e3uu94wo1s0k16****', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', ], + 'Name' => ['description' => 'The name of the performance metric.', 'type' => 'string', 'example' => 'mem_usage', 'title' => ''], ], - 'description' => '', + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], ], 'description' => '', - ], - ], - ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'title' => '', + 'example' => '', ], ], ], @@ -7234,248 +5234,470 @@ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": \\"1\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"Items\\": [\\n {\\n \\"DBClusterId\\": \\"cc-bp1qx68m06981****\\",\\n \\"BackupStatus\\": \\"Success\\",\\n \\"BackupType\\": \\"IncrementalBackup\\",\\n \\"BackupStartTime\\": \\"2021-11-22T18:28:22Z\\",\\n \\"BackupSize\\": 131072,\\n \\"BackupEndTime\\": \\"2021-11-22T18:28:41Z\\",\\n \\"BackupSetInfo\\": \\"{\\\\\\"shard_count\\\\\\": 4}\\",\\n \\"BackupId\\": \\"117403****\\",\\n \\"BackupMethod\\": \\"Physical\\",\\n \\"ExpireDate\\": \\"2022-07-22T18:28:41Z\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n 30\\n F5178C10-1407-4987-9133-DE4DC9119F75\\n 1\\n \\n cc-bp1qx68m06981****\\n Success\\n IncrementalBackup\\n 2021-11-22T18:28:22Z\\n 131072\\n 2021-11-22T18:28:41Z\\n {\\"shard_count\\"：4}\\n 117403****\\n Physical\\n 2022-07-22T18:28:41Z\\n \\n","errorExample":""}]', - 'title' => 'DescribeBackups', - 'description' => '> This operation is available only for ApsaraDB for ClickHouse clusters of version 21.8 and later.'."\n", - ], - 'CreatePortsForClickHouse' => [ - 'summary' => 'Enables the MySQL port for an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeDBClusterPerformance', + 'summary' => 'Views the performance data of an ApsaraDB for ClickHouse Community-Compatible Edition cluster.', + 'description' => 'You can view the performance monitoring data for a specified cluster within a time range based on performance metrics. The data is collected every 30 seconds.'."\n" + ."\n" + .'> This operation supports only ApsaraDB for ClickHouse Community-Compatible Edition clusters that were created before December 1, 2021.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterPerformance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"EndTime\\": \\"2021-11-27T16:38Z\\",\\n \\"RequestId\\": \\"FE242962-6DA3-5FC8-9691-37B62A3210F7\\",\\n \\"StartTime\\": \\"2021-11-27T16:37Z\\",\\n \\"DBClusterId\\": \\"cc-bp125e3uu94wo****\\",\\n \\"Performances\\": [\\n {\\n \\"Key\\": \\"MEM_USAGE\\",\\n \\"Unit\\": \\"%\\",\\n \\"Series\\": [\\n {\\n \\"Values\\": [\\n {\\n \\"Point\\": [\\n \\"[ \\\\\\"2021-11-26T16:39:00Z\\\\\\",\\\\\\"15.08\\\\\\" ]\\"\\n ]\\n }\\n ],\\n \\"Name\\": \\"cc-bp125e3uu94wo1s0k16****\\"\\n }\\n ],\\n \\"Name\\": \\"mem_usage\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'DescribeDBClusterStatusSet' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '25552', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseZHDS8I', - ], + 'operationType' => 'get', + 'abilityTreeCode' => '19444', + 'abilityTreeNodes' => ['FEATUREclickhouseMCDGZK'], + 'tenantRelevance' => 'publicInformation', ], 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], - [ - 'name' => 'PortType', - 'in' => 'query', - 'schema' => [ - 'description' => 'The port type. Set the value to mysql_port.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'mysql_port', - ], - ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.'."\n" + ."\n" + .'> Call the [DescribeRegions](~~170875~~) operation to query the region ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => 'DE309AA1-BD83-5E1F-9945-8A4D336E0829', 'title' => ''], + 'StatusSet' => [ + 'type' => 'array', + 'items' => ['description' => 'The instance status.', 'type' => 'string', 'example' => 'ACTIVATION', 'title' => ''], + 'description' => 'The set of instance statuses.', + 'title' => '', + 'example' => '', ], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'title' => 'DescribeDBClusterStatusSet', + 'summary' => 'This operation queries the status set of a ClickHouse Community-Compatible Edition cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 2FED790E-FB61-4721-8C1C-07C627FA5A19\\n","errorExample":""}]', - 'title' => 'CreatePortsForClickHouse', - 'description' => '> For an ApsaraDB for ClickHouse cluster of V20.8 or later that was created before December 1, 2021, you must manually enable the MySQL port. For an ApsaraDB for ClickHouse cluster of V20.8 or later that was created after December 1, 2021, the MySQL port is automatically enabled.'."\n", + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"DE309AA1-BD83-5E1F-9945-8A4D336E0829\\",\\n \\"StatusSet\\": [\\n \\"ACTIVATION\\"\\n ]\\n}","type":"json"}]', ], - 'ReleaseClusterPublicConnection' => [ - 'summary' => 'Releases the public endpoint of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeDBClusters' => [ + 'summary' => 'Describes ApsaraDB for ClickHouse clusters in a specified region.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '19472', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseZHDS8I', - ], - 'tenantRelevance' => 'tenant', + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '19443', + 'abilityTreeNodes' => ['FEATUREclickhouseMCDGZK'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the region ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'DBClusterIds', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.'."\n" + ."\n" + .'> If you do not specify this parameter, information about all clusters is queried by default.', 'type' => 'string', 'required' => false, 'example' => 'cc-bp108z124a8o7****', 'title' => ''], + ], + [ + 'name' => 'DBClusterDescription', + 'in' => 'query', + 'schema' => ['description' => 'The cluster description.', 'type' => 'string', 'required' => false, 'example' => 'cc-bp108z124a8o7****', 'title' => ''], + ], + [ + 'name' => 'DBClusterStatus', + 'in' => 'query', + 'schema' => ['description' => 'The state of the cluster. Valid values:'."\n" + ."\n" + .'- **Preparing**: The cluster is being prepared.'."\n" + ."\n" + .'- **Creating**: The cluster is being created.'."\n" + ."\n" + .'- **Running**: The cluster is running.'."\n" + ."\n" + .'- **Deleting**: The cluster is being deleted.'."\n" + ."\n" + .'- **SCALING\\_OUT**: The cluster is being scaled out.', 'type' => 'string', 'required' => false, 'example' => 'Running', 'title' => ''], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => 'The number of entries per page. Valid values:'."\n" + ."\n" + .'- **30** (Default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '30', 'example' => '30', 'title' => ''], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'example' => '1', 'title' => ''], + ], + [ + 'name' => 'Tag', 'in' => 'query', + 'style' => 'repeatList', 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', + 'description' => 'The tags.', + 'type' => 'array', + 'items' => [ + 'description' => 'The tag.', + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => 'The key of the tag.', 'type' => 'string', 'required' => false, 'example' => 'department', 'title' => ''], + 'Value' => ['description' => 'The value of the tag.', 'type' => 'string', 'required' => false, 'example' => 'it', 'title' => ''], + ], + 'required' => false, + 'title' => '', + 'example' => '', + ], + 'required' => false, + 'maxItems' => 21, + 'title' => '', + 'example' => '', ], ], + [ + 'name' => 'ResourceGroupId', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the resource group to which the cluster belongs.', 'type' => 'string', 'required' => false, 'example' => 'rg-4690g37929****', 'title' => ''], + ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', + 'TotalCount' => ['description' => 'The total number of entries.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'PageSize' => ['description' => 'The number of entries returned per page. Valid values:'."\n" + ."\n" + .'- **30** (Default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'example' => '30', 'title' => ''], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', 'title' => ''], + 'PageNumber' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'DBClusters' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'DBCluster' => [ + 'description' => 'The list of clusters.', + 'type' => 'array', + 'items' => [ + 'description' => 'The list of clusters.', + 'type' => 'object', + 'properties' => [ + 'VpcId' => ['description' => 'The VPC ID.', 'type' => 'string', 'example' => 'vpc-bp175iuvg8nxqraf2****', 'title' => ''], + 'DBNodeCount' => ['description' => 'The number of nodes.'."\n" + ."\n" + .'- For a single-replica edition cluster, the value is from 1 to 48.'."\n" + ."\n" + .'- For a dual-replica edition cluster, the value is from 1 to 24.', 'type' => 'integer', 'format' => 'int64', 'example' => '2', 'title' => ''], + 'CreateTime' => ['description' => 'The time when the cluster was created. The time is in the yyyy-MM-ddTHH:mm:ssZ format.', 'type' => 'string', 'example' => '2021-10-28T07:24:45Z', 'title' => ''], + 'PayType' => ['description' => 'The billing method. Valid values:'."\n" + ."\n" + .'- **Postpaid**: pay-as-you-go.'."\n" + ."\n" + .'- **Prepaid**: subscription.', 'type' => 'string', 'example' => 'Postpaid', 'title' => ''], + 'Tags' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Tag' => [ + 'description' => 'The list of tags.', + 'type' => 'array', + 'items' => [ + 'description' => 'The tag.', + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => 'The key of the tag.', 'type' => 'string', 'example' => 'department', 'title' => ''], + 'Value' => ['description' => 'The value of the tag.', 'type' => 'string', 'example' => 'it', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'StorageType' => ['description' => 'The storage class. Valid values:'."\n" + ."\n" + .''."\n" + ."\n" + .'- **CloudESSD\\_PL0**: ESSD PL0.'."\n" + ."\n" + .''."\n" + ."\n\n" + .'- **CloudESSD**: ESSD PL1.'."\n" + ."\n" + .'- **CloudESSD\\_PL2**: ESSD PL2.'."\n" + ."\n" + .'- **CloudESSD\\_PL3**: ESSD PL3.'."\n" + ."\n" + .'- **CloudEfficiency**: ultra disk.', 'type' => 'string', 'example' => 'CloudESSD', 'title' => ''], + 'Port' => ['description' => 'The HTTP port.', 'type' => 'integer', 'format' => 'int32', 'example' => '8123', 'title' => ''], + 'LockMode' => ['description' => 'The lock mode of the cluster. Valid values:'."\n" + ."\n" + .'- **Unlock**: The cluster is not locked.'."\n" + ."\n" + .'- **ManualLock**: The cluster is manually locked.'."\n" + ."\n" + .'- **LockByExpiration**: The cluster is automatically locked upon expiration.'."\n" + ."\n" + .'- **LockByRestoration**: The cluster is automatically locked before a rollback.'."\n" + ."\n" + .'- **LockByDiskQuota**: The cluster is automatically locked because the disk is full.', 'type' => 'string', 'example' => 'Unlock', 'title' => ''], + 'Bid' => ['description' => 'The site ID. Valid values:'."\n" + ."\n" + .'- **26842**: Alibaba Cloud China Website (www\\.aliyun.com).'."\n" + ."\n" + .'- **26888**: Alibaba Cloud International Website (www\\.alibabacloud.com).', 'type' => 'string', 'example' => '26842', 'title' => ''], + 'IsExpired' => ['description' => 'Indicates whether the cluster has expired. Valid values:'."\n" + ."\n" + .'- **true**: The cluster has expired.'."\n" + ."\n" + .'- **false**: The cluster has not expired.', 'type' => 'string', 'example' => 'false', 'title' => ''], + 'VpcCloudInstanceId' => ['description' => 'The ID of the VPC instance.', 'type' => 'string', 'example' => 'vpc-bp175iuvg8nxqraf2****', 'title' => ''], + 'ScaleOutStatus' => [ + 'description' => 'The data migration status.', + 'type' => 'object', + 'properties' => [ + 'Progress' => ['description' => 'The data migration progress in percentage.'."\n" + ."\n" + .'> This parameter is returned only when the cluster is in the SCALING\\_OUT state.', 'type' => 'string', 'example' => '0', 'title' => ''], + 'Ratio' => ['description' => 'The data migration progress. The format is \\`Data migrated/Total data\\`.'."\n" + ."\n" + .'> This parameter is returned only when the cluster is in the SCALING\\_OUT state.', 'type' => 'string', 'example' => '0MB/60469MB', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'ScaleOutDisableWriteWindows' => ['description' => 'The write-blocking window for the upgrade or downgrade.', 'type' => 'string', 'example' => '2025-02-08T00:00:00+08:00,2025-02-12T00:00:00+08:00', 'title' => ''], + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'example' => 'cc-bp108z124a8o7****', 'title' => ''], + 'ConnectionString' => ['description' => 'The VPC endpoint.', 'type' => 'string', 'example' => 'cc-bp1fs5o051c61****.clickhouse.ads.aliyuncs.com', 'title' => ''], + 'CommodityCode' => ['description' => 'The commodity code.', 'type' => 'string', 'example' => 'clickhouse_go_public_cn', 'title' => ''], + 'ExpireTime' => ['description' => 'The expiration time of the cluster. The time is in the yyyy-MM-ddTHH:mm:ssZ format.'."\n" + ."\n" + .'> Pay-as-you-go clusters do not expire. This parameter is empty for pay-as-you-go clusters.', 'type' => 'string', 'example' => '2011-05-30T12:11:4Z', 'title' => ''], + 'DBNodeStorage' => ['description' => 'The storage space of a single node. The value ranges from 100 GB to 32,000 GB.'."\n" + ."\n" + .'> The step size is 100 GB.', 'type' => 'integer', 'format' => 'int64', 'example' => '100', 'title' => ''], + 'DBNodeClass' => ['description' => 'The instance type of the cluster.'."\n" + ."\n" + .'- For single-replica edition clusters, valid values are:'."\n" + ."\n" + .' - **LS20**: Large storage, 20 cores, 88 GB memory.'."\n" + ."\n" + .' - **LS40**: Large storage, 40 cores, 176 GB memory.'."\n" + ."\n" + .' - **LS80**: Large storage, 80 cores, 352 GB memory.'."\n" + ."\n" + .' - **S8**: Standard, 8 cores, 32 GB memory.'."\n" + ."\n" + .' - **S16**: Standard, 16 cores, 64 GB memory.'."\n" + ."\n" + .' - **S32**: Standard, 32 cores, 128 GB memory.'."\n" + ."\n" + .' - **S64**: Standard, 64 cores, 256 GB memory.'."\n" + ."\n" + .' - **S80**: Standard, 80 cores, 384 GB memory.'."\n" + ."\n" + .' - **S104**: Standard, 104 cores, 384 GB memory.'."\n" + ."\n" + .'- For dual-replica edition clusters, valid values are:'."\n" + ."\n" + .' - **LC20**: Large storage, 20 cores, 88 GB memory.'."\n" + ."\n" + .' - **LC40**: Large storage, 40 cores, 176 GB memory.'."\n" + ."\n" + .' - **LC80**: Large storage, 80 cores, 352 GB memory.'."\n" + ."\n" + .' - **C8**: Standard, 8 cores, 32 GB memory.'."\n" + ."\n" + .' - **C16**: Standard, 16 cores, 64 GB memory.'."\n" + ."\n" + .' - **C32**: Standard, 32 cores, 128 GB memory.'."\n" + ."\n" + .' - **C64**: Standard, 64 cores, 256 GB memory.'."\n" + ."\n" + .' - **C80**: Standard, 80 cores, 384 GB memory.'."\n" + ."\n" + .' - **C104**: Standard, 104 cores, 384 GB memory.'."\n" + ."\n" + .''."\n" + ."\n" + .'- For single-replica edition clusters, valid values are:'."\n" + .' \\- **S4**: 4 cores, 16 GB memory.'."\n" + .' \\- **S8**: 8 cores, 32 GB memory.'."\n" + ."\n" + .' - **S16**: 16 cores, 64 GB memory.'."\n" + ."\n" + .' - **S32**: 32 cores, 128 GB memory.'."\n" + ."\n" + .' - **S64** : 64 cores, 256 GB memory.'."\n" + ."\n" + .' - **S104**: 104 cores, 384 GB memory.'."\n" + ."\n" + .'- For dual-replica edition clusters, valid values are:'."\n" + .' \\- **C4**: 4 cores, 16 GB memory.'."\n" + .' \\- **C8**: 8 cores, 32 GB memory.'."\n" + .' \\- **C16**: 16 cores, 64 GB memory.'."\n" + .' \\- **C32**: 32 cores, 128 GB memory.'."\n" + .' \\- **C64** : 64 cores, 256 GB memory.'."\n" + .' \\- **C104**: 104 cores, 384 GB memory.'."\n" + ."\n" + .'', 'type' => 'string', 'example' => 'C8', 'title' => ''], + 'AliUid' => ['description' => 'The Alibaba Cloud account ID.', 'type' => 'string', 'example' => '140692647406****', 'title' => ''], + 'LockReason' => ['description' => 'The reason why the cluster was locked.'."\n" + ."\n" + .'> This parameter is empty if the cluster is not locked.', 'type' => 'string', 'example' => 'DISK_FULL', 'title' => ''], + 'RegionId' => ['description' => 'The region ID.', 'type' => 'string', 'example' => 'cn-hangzhou', 'title' => ''], + 'VSwitchId' => ['description' => 'The vSwitch ID.', 'type' => 'string', 'example' => 'vsw-bp1gzt31twhlo0sa5****', 'title' => ''], + 'DBClusterStatus' => ['description' => 'The state of the cluster. Valid values:'."\n" + ."\n" + .'- **Preparing**: The cluster is being prepared.'."\n" + ."\n" + .'- **Creating**: The cluster is being created.'."\n" + ."\n" + .'- **Running**: The cluster is running.'."\n" + ."\n" + .'- **Deleting**: The cluster is being deleted.'."\n" + ."\n" + .'- **SCALING\\_OUT**: The cluster is being scaled out.', 'type' => 'string', 'example' => 'Running', 'title' => ''], + 'DBClusterDescription' => ['description' => 'The cluster description.', 'type' => 'string', 'example' => 'test', 'title' => ''], + 'DBClusterNetworkType' => ['description' => 'The network type. Only VPC is supported.', 'type' => 'string', 'example' => 'VPC', 'title' => ''], + 'ZoneId' => ['description' => 'The zone ID.', 'type' => 'string', 'example' => 'cn-hangzhou-h', 'title' => ''], + 'Category' => ['description' => 'The edition of the cluster. Valid values:'."\n" + ."\n" + .'- **Basic**: Single-replica Edition.'."\n" + ."\n" + .'- **HighAvailability**: Dual-replica Edition.', 'type' => 'string', 'example' => 'Basic', 'title' => ''], + 'ControlVersion' => ['description' => 'The version of the backend management system. Valid values:'."\n" + ."\n" + .'- **v1**'."\n" + ."\n" + .'- **v2**', 'type' => 'string', 'example' => 'v1', 'title' => ''], + 'ExtStorageType' => ['description' => 'The extended storage class. Valid values:'."\n" + ."\n" + .'- **CloudSSD**: standard SSD.'."\n" + ."\n" + .'- **CloudESSD**: ESSD PL1.'."\n" + ."\n" + .'- **CloudESSD\\_PL2**: ESSD PL2.'."\n" + ."\n" + .'- **CloudESSD\\_PL3**: ESSD PL3.'."\n" + ."\n" + .'- **CloudEfficiency**: ultra disk.', 'type' => 'string', 'example' => 'CloudESSD', 'title' => ''], + 'ExtStorageSize' => ['description' => 'The extended storage space.', 'type' => 'integer', 'format' => 'int32', 'example' => '100GB', 'title' => ''], + 'ResourceGroupId' => ['description' => 'The ID of the resource group to which the cluster belongs.', 'type' => 'string', 'example' => 'rg-4690g37929****', 'title' => ''], + 'DbVersion' => ['description' => 'The kernel version of the cluster.', 'type' => 'string', 'example' => '23.8', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 403 => [ + ['errorCode' => 'Forbidden', 'errorMessage' => 'User not authorized to operate on the specified resource.', 'description' => 'The account is not granted permission to manipulate the resource'], ], - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\"\\n}","errorExample":""},{"type":"xml","example":"\\n D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\n","errorExample":""}]', - 'title' => 'ReleaseClusterPublicConnection', - ], - 'AllocateClusterPublicConnection' => [ - 'summary' => 'Creates a public endpoint for an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], - ], - 'operationType' => 'write', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '19418', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseZHDS8I', + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], - 'tenantRelevance' => 'tenant', ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], - [ - 'name' => 'ConnectionStringPrefix', - 'in' => 'query', - 'schema' => [ - 'description' => 'The prefix of the endpoint that is used to connect to the database. Set the value to the cluster ID.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PageNumber\\": 1,\\n \\"DBClusters\\": {\\n \\"DBCluster\\": [\\n {\\n \\"VpcId\\": \\"vpc-bp175iuvg8nxqraf2****\\",\\n \\"DBNodeCount\\": 2,\\n \\"CreateTime\\": \\"2021-10-28T07:24:45Z\\",\\n \\"PayType\\": \\"Postpaid\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"Key\\": \\"department\\",\\n \\"Value\\": \\"it\\"\\n }\\n ]\\n },\\n \\"StorageType\\": \\"CloudESSD\\",\\n \\"Port\\": 8123,\\n \\"LockMode\\": \\"Unlock\\",\\n \\"Bid\\": \\"26842\\",\\n \\"IsExpired\\": \\"false\\",\\n \\"VpcCloudInstanceId\\": \\"vpc-bp175iuvg8nxqraf2****\\",\\n \\"ScaleOutStatus\\": {\\n \\"Progress\\": \\"0\\",\\n \\"Ratio\\": \\"0MB/60469MB\\"\\n },\\n \\"ScaleOutDisableWriteWindows\\": \\"2025-02-08T00:00:00+08:00,2025-02-12T00:00:00+08:00\\",\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"ConnectionString\\": \\"cc-bp1fs5o051c61****.clickhouse.ads.aliyuncs.com\\",\\n \\"CommodityCode\\": \\"clickhouse_go_public_cn\\",\\n \\"ExpireTime\\": \\"2011-05-30T12:11:4Z\\",\\n \\"DBNodeStorage\\": 100,\\n \\"DBNodeClass\\": \\"C8\\",\\n \\"AliUid\\": \\"140692647406****\\",\\n \\"LockReason\\": \\"DISK_FULL\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"VSwitchId\\": \\"vsw-bp1gzt31twhlo0sa5****\\",\\n \\"DBClusterStatus\\": \\"Running\\",\\n \\"DBClusterDescription\\": \\"test\\",\\n \\"DBClusterNetworkType\\": \\"VPC\\",\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"Category\\": \\"Basic\\",\\n \\"ControlVersion\\": \\"v1\\",\\n \\"ExtStorageType\\": \\"CloudESSD\\",\\n \\"ExtStorageSize\\": 0,\\n \\"ResourceGroupId\\": \\"rg-4690g37929****\\",\\n \\"DbVersion\\": \\"23.8\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + 'title' => 'DescribeDBClusters', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '2500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeDBClusters'], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', - ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusters', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], - 'description' => '', - ], - ], - ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\"\\n}","errorExample":""},{"type":"xml","example":"\\n D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\n","errorExample":""}]', - 'title' => 'AllocateClusterPublicConnection', ], - 'DescribeDBClusterNetInfoItems' => [ - 'summary' => 'Queries the network information about an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeDBConfig' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -7485,143 +5707,71 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '19445', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], ], 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query region IDs.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], + ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1qx68m06981****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-t4nw17nh2e4t2****'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => 'The returned data.', 'type' => 'object', 'properties' => [ - 'NetInfoItems' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'NetInfoItem' => [ - 'description' => 'The network information about the cluster.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'VpcId' => [ - 'description' => 'The virtual private cloud (VPC) ID.'."\n" - ."\n" - .'> If the value of the NetType parameter is set to Public, an empty string is returned.'."\n", - 'type' => 'string', - 'example' => 'vpc-bp175iuvg8nxqraf2****', - ], - 'VSwitchId' => [ - 'description' => 'The vSwitch ID.'."\n" - ."\n" - .'> If the value of the NetType parameter is set to Public, an empty string is returned.'."\n", - 'type' => 'string', - 'example' => 'vsw-bp1gzt31twhlo0sa5****', - ], - 'ConnectionString' => [ - 'description' => 'The endpoint that is used to connect to the database.'."\n", - 'type' => 'string', - 'example' => 'cc-bp1554t789i8e****.clickhouse.ads.aliyuncs.com', - ], - 'JdbcPort' => [ - 'description' => 'The port number that is used in Java Database Connectivity (JDBC).'."\n", - 'type' => 'string', - 'example' => '3306', - ], - 'NetType' => [ - 'description' => 'The network type of the endpoint. Valid values:'."\n" - ."\n" - .'* Public: public endpoint'."\n" - .'* VPC: VPC'."\n", - 'type' => 'string', - 'example' => 'VPC', - ], - 'HttpPort' => [ - 'description' => 'The HTTP port number.'."\n", - 'type' => 'string', - 'example' => '8123', - ], - 'IPAddress' => [ - 'description' => 'The IP address.'."\n", - 'type' => 'string', - 'example' => '10.255.234.251', - ], - 'HttpsPort' => [ - 'description' => 'The HTTPS port number.'."\n", - 'type' => 'string', - 'example' => '8443', - ], - 'MySQLPort' => [ - 'description' => 'The port of the MySQL instance.'."\n", - 'type' => 'string', - 'example' => '9004', - ], - ], - ], - ], - ], - ], - 'ClusterNetworkType' => [ - 'description' => 'The network type of the cluster. Only VPC is supported.'."\n", - 'type' => 'string', - 'example' => 'VPC', - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '9A23C87D-87DF-4DA0-A50E-CB13F4F7923D', - ], - 'EnableSLB' => [ - 'description' => 'Indicates whether Server Load Balancer (SLB) is activated in the VPC. Valid values:'."\n" - ."\n" - .'* true'."\n" - .'* false'."\n", - 'type' => 'boolean', - 'required' => true, - 'example' => 'true', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '16060117-92E1-5F3B-BF42-28B172D0F869'], + 'Config' => ['description' => 'The cluster configuration.', 'type' => 'string', 'title' => '', 'example' => 'test10.37.XX.XX9000defaultdefaultt_organization
id=1SQL_QUERY3133field1String'], ], - 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"NetInfoItems\\": {\\n \\"NetInfoItem\\": [\\n {\\n \\"VpcId\\": \\"vpc-bp175iuvg8nxqraf2****\\",\\n \\"VSwitchId\\": \\"vsw-bp1gzt31twhlo0sa5****\\",\\n \\"ConnectionString\\": \\"cc-bp1554t789i8e****.clickhouse.ads.aliyuncs.com\\",\\n \\"JdbcPort\\": \\"3306\\",\\n \\"NetType\\": \\"VPC\\",\\n \\"HttpPort\\": \\"8123\\",\\n \\"IPAddress\\": \\"10.255.234.251\\",\\n \\"HttpsPort\\": \\"8443\\",\\n \\"MySQLPort\\": \\"9004\\"\\n }\\n ]\\n },\\n \\"ClusterNetworkType\\": \\"VPC\\",\\n \\"RequestId\\": \\"9A23C87D-87DF-4DA0-A50E-CB13F4F7923D\\",\\n \\"EnableSLB\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n \\n vpc-bp175iuvg8nxqraf2****\\n vsw-bp1gzt31twhlo0sa5****\\n cc-bp1qx68m06981****.ads.rds.aliyuncs.com\\n 3306\\n VPC\\n 8123\\n 10.255.234.251\\n \\n VPC\\n 9A23C87D-87DF-4DA0-A50E-CB13F4F7923D\\n","errorExample":""}]', - 'title' => 'DescribeDBClusterNetInfoItems', - ], - 'DescribeAccounts' => [ - 'summary' => 'Queries the information about the database accounts of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeDBConfig', + 'summary' => 'The DescribeDBConfig operation queries the configuration of a community-compatible cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBConfig', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"16060117-92E1-5F3B-BF42-28B172D0F869\\",\\n \\"Config\\": \\"test10.37.XX.XX9000defaultdefaultt_organization
id=1SQL_QUERY3133field1String\\"\\n}","type":"json"}]', + ], + 'DescribeEventMetaInfo' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -7631,63 +5781,24 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '19431', - 'abilityTreeNodes' => [ - 'FEATUREclickhouse2H8YOY', - ], + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '201222', + 'abilityTreeNodes' => ['FEATUREclickhouseMCDGZK'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], - [ - 'name' => 'AccountName', - 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the database account.'."\n" - ."\n" - .'> If you do not specify this parameter, the information about all database accounts in the ApsaraDB for ClickHouse cluster is queried by default.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], - ], - [ - 'name' => 'PageSize', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries per page. Valid values:'."\n" - ."\n" - .'* **30** (default)'."\n" - .'* **50**'."\n" - .'* **100**'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', - ], + 'allowEmptyValue' => false, + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-beijing', 'title' => ''], ], [ - 'name' => 'PageNumber', + 'name' => 'SourceCode', 'in' => 'query', - 'schema' => [ - 'description' => 'The page number. Pages start from 1. Default value: **1**.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'allowEmptyValue' => false, + 'schema' => ['description' => 'The codes of O\\&M event types. Separate multiple codes with commas.', 'type' => 'string', 'docRequired' => false, 'required' => false, 'example' => 'Event.EventCode', 'title' => ''], ], ], 'responses' => [ @@ -7695,189 +5806,66 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => 'The total number of entries returned.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => 'The number of entries per page.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], - 'PageNumber' => [ - 'description' => 'The page number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'Accounts' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Account' => [ - 'description' => 'The database accounts.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'AccountStatus' => [ - 'description' => 'The state of the database account. Valid values:'."\n" - ."\n" - .'* **Creating**'."\n" - .'* **Available**'."\n" - .'* **AuthorityModifying**'."\n" - .'* **Deleting**'."\n" - ."\n" - .'> Only XML-configured database accounts can be in the **AuthorityModifying** state.'."\n", - 'type' => 'string', - 'example' => 'Creating', - ], - 'AccountDescription' => [ - 'description' => 'The description of the database account.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'AccountType' => [ - 'description' => 'The type of the database account. Valid values:'."\n" - ."\n" - .'* **Super**: privileged account'."\n" - .'* **Normal**: standard account'."\n", - 'type' => 'string', - 'example' => 'Super', - ], - 'AccountName' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'ConfigType' => [ - 'description' => 'The configuration mode of the database account.'."\n", - 'type' => 'string', - 'example' => 'SQL', - ], - ], - 'description' => '', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '94F92113-FF63-5E57-8401-6FE123AD11DD', 'title' => ''], + 'Items' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Code' => ['description' => 'The code of the O\\&M task.', 'type' => 'string', 'example' => 'Running', 'title' => ''], + 'SourceCode' => ['description' => 'The type of the O\\&M task.', 'type' => 'string', 'example' => 'Task.TaskStatus', 'title' => ''], ], + 'description' => 'The metadata of the O\\&M task.', + 'title' => '', + 'example' => '', ], + 'description' => 'The metadata of O\\&M tasks.', + 'title' => '', + 'example' => '', ], + 'TotalCount' => ['description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], ], - 'description' => '', - ], - ], - ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'title' => '', + 'description' => 'Schema of Response', + 'example' => '', ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => 'DescribeEventMetaInfo', + 'summary' => 'Queries the metadata of Operations and Maintenance (O&M) events for a ClickHouse-compatible cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PageNumber\\": 1,\\n \\"Accounts\\": {\\n \\"Account\\": [\\n {\\n \\"AccountStatus\\": \\"Creating\\",\\n \\"AccountDescription\\": \\"test\\",\\n \\"AccountType\\": \\"Super\\",\\n \\"AccountName\\": \\"test\\",\\n \\"ConfigType\\": \\"SQL\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n 30\\n F5178C10-1407-4987-9133-DE4DC9119F75\\n 1\\n \\n Creating\\n test\\n Super\\n test\\n SQL\\n \\n","errorExample":""}]', - 'title' => 'DescribeAccounts', + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"94F92113-FF63-5E57-8401-6FE123AD11DD\\",\\n \\"Items\\": [\\n {\\n \\"Code\\": \\"Running\\",\\n \\"SourceCode\\": \\"Task.TaskStatus\\"\\n }\\n ],\\n \\"TotalCount\\": 1\\n}","type":"json"}]', ], - 'CreateAccount' => [ - 'summary' => 'Creates a database account for an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeOSSStorage' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '19421', - 'abilityTreeNodes' => [ - 'FEATUREclickhouse2H8YOY', - ], - 'tenantRelevance' => 'tenant', - ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], - [ - 'name' => 'AccountName', - 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the database account.'."\n" - ."\n" - .'> '."\n" - ."\n" - .'* The name must be unique in the cluster.'."\n" - ."\n" - .'* The name can contain lowercase letters, digits, and underscores (\\_).'."\n" - .'* The name must start with a lowercase letter and end with a lowercase letter or a digit.'."\n" - .'* The name must be 2 to 64 characters in length.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'test', - ], - ], + 'operationType' => 'get', + 'abilityTreeCode' => '19453', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], + ], + 'parameters' => [ [ - 'name' => 'AccountPassword', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The password of the database account.'."\n" - ."\n" - .'> '."\n" - ."\n" - .'* The password must contain at least three types of the following characters: uppercase letters, lowercase letters, digits, and special characters.'."\n" - ."\n" - .'* The password can contain the following special characters: ! @ # $ % ^ & \\* ( ) \\_ + - ='."\n" - .'* The password must be 8 to 32 characters in length.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '123789Ff!', - ], + 'schema' => ['description' => 'The region ID. Call the [DescribeRegions](~~170875~~) operation to query the region ID.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ - 'name' => 'AccountDescription', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The description of the database account.'."\n" - ."\n" - .'> '."\n" - ."\n" - .'* The description cannot start with http:// or https://.'."\n" - ."\n" - .'* The description must be 0 to 256 characters in length.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'ceshi', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], ], 'responses' => [ @@ -7885,301 +5873,373 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', - ], + 'Policy' => ['description' => 'The parameters of the tiered storage policy for hot and cold data.', 'type' => 'string', 'title' => '', 'example' => '[{ "currentValue":"0.1", "defaultValue":"0.1", "desc":"Ratio of free disk space. When the ratio exceeds the value of configuration parameter, ClickHouse start to move data to the cold storage", "name":"move_factor", "restart":true, "valueRange":"(0, 1]" },{ "currentValue":"true", "defaultValue":"true", "desc":"Disables merging of data parts on cold storage", "name":"prefer_not_to_merge", "restart":true, "valueRange":"true|false" }]'], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'aadbb456-ebf7-4ed8-9671-fad9f3846ca4'], + 'State' => ['description' => 'The status of tiered storage for hot and cold data. Valid values:'."\n" + ."\n" + .'- **CREATING**: Tiered storage is being enabled.'."\n" + ."\n" + .'- **DISABLE**: Tiered storage is disabled.'."\n" + ."\n" + .'- **ENABLE**: Tiered storage is enabled.', 'type' => 'string', 'title' => '', 'example' => 'ENABLE'], + 'ColdStorage' => ['description' => 'Indicates whether tiered storage for hot and cold data can be enabled. Valid values:'."\n" + ."\n" + .'- **true**: Tiered storage can be enabled.'."\n" + ."\n" + .'- **false**: Tiered storage cannot be enabled.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], + 'StorageUsage' => ['description' => 'The cold storage space used. Unit: GB.', 'type' => 'string', 'title' => '', 'example' => '0.00'], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 2FED790E-FB61-4721-8C1C-07C627FA5A19\\n","errorExample":""}]', - 'title' => 'CreateAccount', - ], - 'CreateSQLAccount' => [ - 'summary' => 'Creates a privileged account or a standard account for an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeOSSStorage', + 'summary' => 'Queries cold storage information.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeOSSStorage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Policy\\": \\"[{ \\\\\\"currentValue\\\\\\":\\\\\\"0.1\\\\\\", \\\\\\"defaultValue\\\\\\":\\\\\\"0.1\\\\\\", \\\\\\"desc\\\\\\":\\\\\\"Ratio of free disk space. When the ratio exceeds the value of configuration parameter, ClickHouse start to move data to the cold storage\\\\\\", \\\\\\"name\\\\\\":\\\\\\"move_factor\\\\\\", \\\\\\"restart\\\\\\":true, \\\\\\"valueRange\\\\\\":\\\\\\"(0, 1]\\\\\\" },{ \\\\\\"currentValue\\\\\\":\\\\\\"true\\\\\\", \\\\\\"defaultValue\\\\\\":\\\\\\"true\\\\\\", \\\\\\"desc\\\\\\":\\\\\\"Disables merging of data parts on cold storage\\\\\\", \\\\\\"name\\\\\\":\\\\\\"prefer_not_to_merge\\\\\\", \\\\\\"restart\\\\\\":true, \\\\\\"valueRange\\\\\\":\\\\\\"true|false\\\\\\" }]\\",\\n \\"RequestId\\": \\"aadbb456-ebf7-4ed8-9671-fad9f3846ca4\\",\\n \\"State\\": \\"ENABLE\\",\\n \\"ColdStorage\\": true,\\n \\"StorageUsage\\": \\"0.00\\"\\n}","type":"json"}]', + ], + 'DescribeProcessList' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '152741', - 'abilityTreeNodes' => [ - 'FEATUREclickhouse2H8YOY', - 'FEATUREclickhouseL1079N', - ], + 'operationType' => 'get', + 'abilityTreeCode' => '19454', + 'abilityTreeNodes' => ['FEATUREclickhouseLESIXD'], ], 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to find the region ID.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], + ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp1p816075e21****', - ], + 'schema' => ['description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to find information about all clusters in the destination region, including the cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1190tj036am****'], ], [ - 'name' => 'AccountName', + 'name' => 'QueryDurationMs', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the database account.'."\n" - ."\n" - .'* The name must be unique in the cluster.'."\n" - .'* The name can contain lowercase letters, digits, or underscores (\\_).'."\n" - .'* The name must start with a lowercase letter and end with a lowercase letter or digit.'."\n" - .'* The name must be 2 to 64 characters in length.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'schema' => ['description' => 'The shortest query duration. The minimum value is **1000**. The default value is **1000**. The unit is milliseconds. The response returns queries that run longer than this duration.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => true, 'maximum' => '9999999999', 'minimum' => '0', 'isFileTransferUrl' => false, 'title' => '', 'example' => '500'], ], [ - 'name' => 'AccountPassword', + 'name' => 'InitialUser', 'in' => 'query', - 'schema' => [ - 'description' => 'The password of the database account.'."\n" - ."\n" - .'* The password must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.'."\n" - .'* Special characters include ! @ # $ % ^ & \\* ( ) \\_ + - ='."\n" - .'* The password must be 8 to 32 characters in length.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'Test1234', - ], + 'schema' => ['description' => 'The database account.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'user'], ], [ - 'name' => 'AccountDescription', + 'name' => 'Keyword', 'in' => 'query', - 'schema' => [ - 'description' => 'The description of the database account.'."\n" - ."\n" - .'* The description cannot start with http:// or https://.'."\n" - .'* The description can be up to 256 characters in length or be an empty string.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'Used for test', - ], + 'schema' => ['description' => 'The keyword for the query.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'join'], ], [ - 'name' => 'AccountType', + 'name' => 'Order', 'in' => 'query', - 'schema' => [ - 'description' => 'The type of the database account. Valid values:'."\n" - ."\n" - .'* **Super**: privileged account.'."\n" - .'* **Normal**: standard account.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'Super', - ], + 'schema' => ['description' => 'The column to use for sorting. Valid values:'."\n" + ."\n" + .'- elapsed: The total running time.'."\n" + ."\n" + .'- written\\_rows: The number of rows written.'."\n" + ."\n" + .'- read\\_rows: The number of rows read.'."\n" + ."\n" + .'- memory\\_usage: The amount of memory used.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'elapsed'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => 'The number of entries to return on each page. Valid values:'."\n" + ."\n" + .'- **30** (Default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '9999999999', 'minimum' => '0', 'isFileTransferUrl' => false, 'default' => '30', 'title' => '', 'example' => '30'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => 'The page number. The value must be greater than 0 and cannot exceed the maximum value of the Integer data type. The default value is 1.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '9999999999', 'minimum' => '1', 'isFileTransferUrl' => false, 'default' => '1', 'title' => '', 'example' => '1'], + ], + [ + 'name' => 'InitialQueryId', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the query.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => '6c69d508-f05f-4c74-857c-d982b7e7e79f'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", + 'description' => 'The returned result.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F76', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'FD61BB0D-788A-5185-A8E3-1B90BA8F6F04'], + 'ProcessList' => [ + 'description' => 'The list of tasks.', + 'type' => 'object', + 'properties' => [ + 'TableSchema' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'ResultSet' => [ + 'description' => 'The details of the columns.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => 'The type of the column.', 'type' => 'string', 'title' => '', 'example' => 'String'], + 'Name' => ['description' => 'The name of the column.', 'type' => 'string', 'title' => '', 'example' => 'InitialUser'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'Data' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'ResultSet' => [ + 'description' => 'The details of the tasks.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'QueryStartTime' => ['description' => 'The time when the query started. The time is in the yyyy-MM-ddTHH:mm:ssZ format and is in UTC.', 'type' => 'string', 'title' => '', 'example' => '2021-02-02T09:14:48Z'], + 'Query' => ['description' => 'The query statement.', 'type' => 'string', 'title' => '', 'example' => 'select * from test order by score limit 1;'], + 'InitialAddress' => ['description' => 'The IP address of the client that initiated the query.', 'type' => 'string', 'title' => '', 'example' => '::ffff:10.1.XX.XX'], + 'InitialQueryId' => ['description' => 'The query ID.', 'type' => 'string', 'title' => '', 'example' => '2dd144fd-4230-4249-b15c-e63f964fbb5a'], + 'InitialUser' => ['description' => 'The database account.', 'type' => 'string', 'title' => '', 'example' => 'test'], + 'QueryDurationMs' => ['description' => 'The query duration in milliseconds.', 'type' => 'string', 'title' => '', 'example' => '2000'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'Rows' => ['description' => 'The number of rows returned for the query.', 'type' => 'string', 'title' => '', 'example' => '1145700'], + 'RowsBeforeLimitAtLeast' => ['description' => 'The page size in rows.', 'type' => 'string', 'title' => '', 'example' => '1'], + 'Statistics' => [ + 'description' => 'The statistics of the query result.', + 'type' => 'object', + 'properties' => [ + 'RowsRead' => ['description' => 'The number of rows scanned.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '1000000'], + 'ElapsedTime' => ['description' => 'The elapsed time.', 'type' => 'number', 'format' => 'float', 'title' => '', 'example' => '4156'], + 'BytesRead' => ['description' => 'The size of the scanned data, in bytes.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '9141300000'], + ], + 'title' => '', + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F76\\"\\n}","errorExample":""},{"type":"xml","example":"\\n F5178C10-1407-4987-9133-DE4DC9119F76\\n","errorExample":""}]', - 'title' => 'CreateSQLAccount', - 'description' => '> This operation is applicable only to ApsaraDB for ClickHouse clusters of V20.8 or later that were created after December 1, 2021,'."\n", - ], - 'DeleteAccount' => [ - 'summary' => 'Deletes a database account of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeProcessList', + 'summary' => 'Call the DescribeProcessList operation to retrieve running queries on an ApsaraDB for ClickHouse Community-Compatible cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeProcessList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FD61BB0D-788A-5185-A8E3-1B90BA8F6F04\\",\\n \\"ProcessList\\": {\\n \\"TableSchema\\": {\\n \\"ResultSet\\": [\\n {\\n \\"Type\\": \\"String\\",\\n \\"Name\\": \\"InitialUser\\"\\n }\\n ]\\n },\\n \\"Data\\": {\\n \\"ResultSet\\": [\\n {\\n \\"QueryStartTime\\": \\"2021-02-02T09:14:48Z\\",\\n \\"Query\\": \\"select * from test order by score limit 1;\\",\\n \\"InitialAddress\\": \\"::ffff:10.1.XX.XX\\",\\n \\"InitialQueryId\\": \\"2dd144fd-4230-4249-b15c-e63f964fbb5a\\",\\n \\"InitialUser\\": \\"test\\",\\n \\"QueryDurationMs\\": \\"2000\\"\\n }\\n ]\\n },\\n \\"Rows\\": \\"1145700\\",\\n \\"RowsBeforeLimitAtLeast\\": \\"1\\",\\n \\"Statistics\\": {\\n \\"RowsRead\\": 1000000,\\n \\"ElapsedTime\\": 4156,\\n \\"BytesRead\\": 9141300000\\n }\\n }\\n}","type":"json"}]', + ], + 'DescribeRegions' => [ + 'summary' => 'Queries the available regions and zones for ApsaraDB for ClickHouse.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', - 'abilityTreeCode' => '19427', - 'abilityTreeNodes' => [ - 'FEATUREclickhouse2H8YOY', - ], - 'tenantRelevance' => 'tenant', - ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], - [ - 'name' => 'AccountName', - 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'test', - ], - ], + 'operationType' => 'get', + 'abilityTreeCode' => '19455', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'publicInformation', ], + 'parameters' => [], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], + 'Regions' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Region' => [ + 'description' => 'A list of regions.', + 'type' => 'array', + 'items' => [ + 'description' => 'The region.', + 'type' => 'object', + 'properties' => [ + 'Zones' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Zone' => [ + 'description' => 'A list of zones.', + 'type' => 'array', + 'items' => [ + 'description' => 'The zone.', + 'type' => 'object', + 'properties' => [ + 'ZoneId' => ['description' => 'The zone ID.', 'type' => 'string', 'title' => '', 'example' => 'cn-hangzhou-h'], + 'VpcEnabled' => ['description' => 'Indicates whether VPC is supported. Valid values:'."\n" + ."\n" + .'- **true**: Supported.'."\n" + ."\n" + .'- **false**: Not supported.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'RegionId' => ['description' => 'The region ID.', 'type' => 'string', 'title' => '', 'example' => 'cn-hangzhou'], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 'title' => 'DescribeRegions', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeRegions'], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 2FED790E-FB61-4721-8C1C-07C627FA5A19\\n","errorExample":""}]', - 'title' => 'DeleteAccount', - 'description' => '> After you delete a database account, you cannot use the account to log on to the ApsaraDB for ClickHouse cluster. Exercise caution when performing this operation.'."\n", + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"Regions\\": {\\n \\"Region\\": [\\n {\\n \\"Zones\\": {\\n \\"Zone\\": [\\n {\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"VpcEnabled\\": true\\n }\\n ]\\n },\\n \\"RegionId\\": \\"cn-hangzhou\\"\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'ResetAccountPassword' => [ - 'summary' => 'Resets the password of a database account for an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSchemas' => [ + 'summary' => 'Queries all databases in an instance.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '19473', - 'abilityTreeNodes' => [ - 'FEATUREclickhouse2H8YOY', - ], - 'tenantRelevance' => 'tenant', + 'operationType' => 'get', + 'abilityTreeCode' => '19456', + 'abilityTreeNodes' => ['FEATUREclickhouseMCDGZK'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], - ], - [ - 'name' => 'AccountName', - 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'test', - ], - ], - [ - 'name' => 'AccountPassword', - 'in' => 'query', - 'schema' => [ - 'description' => 'The new password for the database account.'."\n" - ."\n" - .'> '."\n" - ."\n" - .'* The password must contain at least three types of the following characters: uppercase letters, lowercase letters, digits, and special characters.'."\n" - ."\n" - .'* The password can contain the following special characters: ! @ # $ % ^ & \\* ( ) \\_ + - ='."\n" - .'* The password must be 8 to 32 characters in length.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '123456Ff', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], ], 'responses' => [ @@ -8187,92 +6247,130 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0'], + 'Items' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Schema' => [ + 'description' => 'The database information.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp108z124a8o7****'], + 'SchemaName' => ['description' => 'The database name.', 'type' => 'string', 'title' => '', 'example' => 'database'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 2FED790E-FB61-4721-8C1C-07C627FA5A19\\n","errorExample":""}]', - 'title' => 'ResetAccountPassword', - ], - 'ModifyAccountDescription' => [ - 'summary' => 'Modifies the description of a database account of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeSchemas', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSchemas', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\",\\n \\"Items\\": {\\n \\"Schema\\": [\\n {\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeSlowLogRecords' => [ + 'summary' => 'Queries the details of slow query logs.', + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '19462', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', - ], - 'tenantRelevance' => 'tenant', + 'operationType' => 'get', + 'abilityTreeCode' => '19457', + 'abilityTreeNodes' => ['FEATUREclickhouseLESIXD'], ], 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID. Call the [DescribeRegions](~~170875~~) operation to query the region ID.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], + ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['description' => 'The cluster ID. Call the [DescribeDBClusters](~~170879~~) operation to query information about all clusters in the destination region, including cluster IDs.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1z58t881wcx****'], ], [ - 'name' => 'AccountName', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'test', - ], + 'schema' => ['description' => 'The beginning of the time range to query. The format is \\`yyyy-MM-dd hh:mm:ss\\`. The time is in UTC.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '2022-05-20 16:00:00'], ], [ - 'name' => 'AccountDescription', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The new description of the database account.'."\n" - ."\n" - .'* The value cannot start with http:// or https://.'."\n" - .'* The value must be 0 to 256 characters in length.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'ceshi', - ], + 'schema' => ['description' => 'The end of the time range to query. The format is \\`yyyy-MM-dd hh:mm:ss\\`. The time is in UTC.'."\n" + ."\n" + .'> The end time must be later than the start time. The interval between the start time and the end time cannot exceed 7 days.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '2022-05-27 16:00:00'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => 'The number of entries to return on each page. Valid values:'."\n" + ."\n" + .'- **30** (Default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '99999999', 'minimum' => '1', 'isFileTransferUrl' => false, 'default' => '30', 'title' => '', 'example' => '30'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => 'The page number. The value must be an integer that is greater than 0 and does not exceed the maximum value of the Integer data type. Default value: **1**.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '99999999', 'minimum' => '1', 'isFileTransferUrl' => false, 'default' => '1', 'title' => '', 'example' => '1'], + ], + [ + 'name' => 'QueryDurationMs', + 'in' => 'query', + 'schema' => ['description' => 'The minimum query duration, in milliseconds. The minimum value is **1000**. The default value is **1000**. The response returns information about queries that take longer than the specified duration.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '9999999999', 'minimum' => '0', 'isFileTransferUrl' => false, 'default' => '1000', 'title' => '', 'example' => '1000'], ], ], 'responses' => [ @@ -8280,295 +6378,403 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'DF203CC8-5F68-5E3F-8050-3C77DD65731A'], + 'SlowLogRecords' => [ + 'description' => 'The details of the slow query logs.', + 'type' => 'object', + 'properties' => [ + 'TableSchema' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'ResultSet' => [ + 'description' => 'The structure of the database table.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => 'The column type.', 'type' => 'string', 'title' => '', 'example' => 'String'], + 'Name' => ['description' => 'The column name.', 'type' => 'string', 'title' => '', 'example' => 'name'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'Data' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'ResultSet' => [ + 'description' => 'The list of slow query log entries.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => 'The query status. Valid values:'."\n" + ."\n" + .'- **QueryFinish**: The query is complete.'."\n" + ."\n" + .'- **Processing**: The query is running.', 'type' => 'string', 'title' => '', 'example' => 'QueryFinish'], + 'QueryStartTime' => ['description' => 'The start time of the query. The format is \\`yyyy-MM-dd hh:mm:ss\\`. The time is in UTC.', 'type' => 'string', 'title' => '', 'example' => '2022-05-22 20:00:01'], + 'Query' => ['description' => 'The query statement.', 'type' => 'string', 'title' => '', 'example' => 'Select * from table'], + 'ReadRows' => ['description' => 'The number of rows read for the query.', 'type' => 'string', 'title' => '', 'example' => '10027008'], + 'InitialAddress' => ['description' => 'The IP address of the client that initiated the query.', 'type' => 'string', 'title' => '', 'example' => '::ffff:100.104.XX.XX'], + 'MemoryUsage' => ['description' => 'The peak memory usage for the query, in bytes.', 'type' => 'string', 'title' => '', 'example' => '1048576'], + 'InitialUser' => ['description' => 'The username that was used to initiate the query.', 'type' => 'string', 'title' => '', 'example' => 'test_users'], + 'InitialQueryId' => ['description' => 'The query ID.', 'type' => 'string', 'title' => '', 'example' => '\'b51496f2-6b0b-4546-aff9-e17951cb9410\''], + 'ReadBytes' => ['description' => 'The amount of data read for the query, in bytes.', 'type' => 'string', 'title' => '', 'example' => '1048576'], + 'QueryDurationMs' => ['description' => 'The time consumed by the query, in milliseconds.', 'type' => 'string', 'title' => '', 'example' => '2000'], + 'ResultBytes' => ['description' => 'The size of the result data, in bytes.', 'type' => 'string', 'title' => '', 'example' => '1024'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'Rows' => ['description' => 'The number of rows in the result set.', 'type' => 'string', 'title' => '', 'example' => '1'], + 'RowsBeforeLimitAtLeast' => ['description' => 'The number of entries on each page.', 'type' => 'string', 'title' => '', 'example' => '1'], + 'Statistics' => [ + 'description' => 'The statistics of the query results.', + 'type' => 'object', + 'properties' => [ + 'RowsRead' => ['description' => 'The number of rows read.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '2016722'], + 'ElapsedTime' => ['description' => 'The time elapsed for the slow query, in milliseconds.', 'type' => 'number', 'format' => 'float', 'title' => '', 'example' => '21.35'], + 'BytesRead' => ['description' => 'The amount of data read, in bytes.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '123456'], + ], + 'title' => '', + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', ], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 2FED790E-FB61-4721-8C1C-07C627FA5A19\\n","errorExample":""}]', - 'title' => 'ModifyAccountDescription', - ], - 'CreateAccountAndAuthority' => [ - 'summary' => 'Creates an account and grants permissions to the account.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeSlowLogRecords', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSlowLogRecords', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"DF203CC8-5F68-5E3F-8050-3C77DD65731A\\",\\n \\"SlowLogRecords\\": {\\n \\"TableSchema\\": {\\n \\"ResultSet\\": [\\n {\\n \\"Type\\": \\"String\\",\\n \\"Name\\": \\"name\\"\\n }\\n ]\\n },\\n \\"Data\\": {\\n \\"ResultSet\\": [\\n {\\n \\"Type\\": \\"QueryFinish\\",\\n \\"QueryStartTime\\": \\"2022-05-22 20:00:01\\",\\n \\"Query\\": \\"Select * from table\\",\\n \\"ReadRows\\": \\"10027008\\",\\n \\"InitialAddress\\": \\"::ffff:100.104.XX.XX\\",\\n \\"MemoryUsage\\": \\"1048576\\",\\n \\"InitialUser\\": \\"test_users\\",\\n \\"InitialQueryId\\": \\"\'b51496f2-6b0b-4546-aff9-e17951cb9410\'\\",\\n \\"ReadBytes\\": \\"1048576\\",\\n \\"QueryDurationMs\\": \\"2000\\",\\n \\"ResultBytes\\": \\"1024\\"\\n }\\n ]\\n },\\n \\"Rows\\": \\"1\\",\\n \\"RowsBeforeLimitAtLeast\\": \\"1\\",\\n \\"Statistics\\": {\\n \\"RowsRead\\": 2016722,\\n \\"ElapsedTime\\": 21.35,\\n \\"BytesRead\\": 123456\\n }\\n }\\n}","type":"json"}]', + ], + 'DescribeSlowLogTrend' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '19422', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseL1079N', - 'FEATUREclickhouse2H8YOY', - ], + 'operationType' => 'get', + 'abilityTreeCode' => '19458', + 'abilityTreeNodes' => ['FEATUREclickhouseLESIXD'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID. Call the [DescribeRegions](~~170875~~) operation to query region IDs.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1p816075e21****', - ], + 'schema' => ['description' => 'The cluster ID. Call the [DescribeDBClusters](~~170879~~) operation to query information about all clusters in a specific region, including cluster IDs.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp11xxl475ui8****'], ], [ - 'name' => 'AccountName', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The database account.'."\n" - ."\n" - .'* The name must be unique within the cluster.'."\n" - .'* The name can contain lowercase letters, digits, and underscores (\\_).'."\n" - .'* The name must start with a lowercase letter and end with a lowercase letter or digit.'."\n" - .'* The name must be 2 to 64 characters in length.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'test', - ], + 'schema' => ['description' => 'The beginning of the time range to query. Specify the time in the \\`yyyy-MM-dd hh:mm:ss\\` format. The time is in UTC.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '2022-05-20 16:00:00'], ], [ - 'name' => 'AccountPassword', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The password of your database account.'."\n" - ."\n" - .'> '."\n" - ."\n" - .'* The password contains at least three types of the following characters: uppercase letters, lowercase letters, digits, and special characters.'."\n" - ."\n" - .'* The password can contain the following special characters: ! @ # $ % ^ & \\* ( ) \\_ + - ='."\n" - .'* The password must be 8 to 32 characters in length.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '123456Aa', - ], + 'schema' => ['description' => 'The end of the time range to query. Specify the time in the \\`yyyy-MM-dd hh:mm:ss\\` format. The time is in UTC.'."\n" + ."\n" + .'> The end time must be later than the start time. The time range cannot exceed 7 days.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '2022-05-27 16:00:00'], ], [ - 'name' => 'AccountDescription', + 'name' => 'QueryDurationMs', 'in' => 'query', - 'schema' => [ - 'description' => 'The description of the database account.'."\n" - ."\n" - .'* The description cannot start with http:// or https://.'."\n" - .'* The description must be 0 to 256 characters in length.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'ceshi', - ], + 'schema' => ['description' => 'The execution duration of a slow SQL query, in milliseconds. The minimum value is **1000**. The default value is **1000**. The operation returns slow SQL queries that take longer than this duration to execute.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '9999999999', 'minimum' => '0', 'isFileTransferUrl' => false, 'default' => '1000', 'title' => '', 'example' => '1000'], ], - [ - 'name' => 'DmlAuthority', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'Specifies whether to grant DML permissions to the database account. Valid values:'."\n" - ."\n" - .'* **all**'."\n" - .'* **readOnly,modify**'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'all', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF'], + 'SlowLogTrend' => [ + 'description' => 'The result set of the slow SQL queries.', + 'type' => 'object', + 'properties' => [ + 'TableSchema' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'ResultSet' => [ + 'description' => 'The table schema.', + 'type' => 'array', + 'items' => [ + 'description' => 'The schema of the result table.', + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => 'The column type.', 'type' => 'string', 'title' => '', 'example' => 'UInt64'], + 'Name' => ['description' => 'The column name.', 'type' => 'string', 'title' => '', 'example' => 'query_start_time'], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'Data' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'ResultSet' => [ + 'description' => 'The list of slow SQL queries.', + 'type' => 'array', + 'items' => [ + 'description' => 'The list of slow SQL queries.', + 'type' => 'object', + 'properties' => [ + 'QueryStartTime' => ['description' => 'The start time of the query. The time is in the \\`yyyy-MM-dd hh:mm:ss\\` format. The time is in UTC.', 'type' => 'string', 'title' => '', 'example' => '2022-05-22 20:00:01'], + 'MaxQueryDurationMs' => ['description' => 'The longest execution duration. Unit: milliseconds.', 'type' => 'string', 'title' => '', 'example' => '3000'], + 'MinQueryDurationMs' => ['description' => 'The shortest execution duration. Unit: milliseconds.', 'type' => 'string', 'title' => '', 'example' => '1000'], + 'Count' => ['description' => 'The total execution duration of slow SQL queries. Unit: milliseconds.', 'type' => 'string', 'title' => '', 'example' => '4000'], + 'AvgQueryDurationMs' => ['description' => 'The average execution duration. Unit: milliseconds.', 'type' => 'string', 'title' => '', 'example' => '2000'], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'Rows' => ['description' => 'The number of rows in the result set.', 'type' => 'string', 'title' => '', 'example' => '1'], + 'RowsBeforeLimitAtLeast' => ['description' => 'The minimum number of rows that are returned before the \\`LIMIT\\` clause is applied.', 'type' => 'string', 'title' => '', 'example' => '1'], + 'Statistics' => [ + 'description' => 'The statistics of the query results.', + 'type' => 'object', + 'properties' => [ + 'RowsRead' => ['description' => 'The number of rows read.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '14721'], + 'ElapsedTime' => ['description' => 'The query execution duration. Unit: seconds.', 'type' => 'number', 'format' => 'float', 'title' => '', 'example' => '0.001703578'], + 'BytesRead' => ['description' => 'The amount of data read. Unit: bytes.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '697899'], + ], + 'title' => '', + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], - [ - 'name' => 'DdlAuthority', - 'in' => 'query', - 'schema' => [ - 'description' => 'Specifies whether to grant the DDL permissions to the database account. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'boolean', - 'required' => true, - 'docRequired' => true, - 'example' => 'true', - ], + ], + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], - [ - 'name' => 'AllowDatabases', - 'in' => 'query', - 'schema' => [ - 'description' => 'The databases to which you want to grant permissions. Separate databases with commas (,).'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'db1', + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'DescribeSlowLogTrend', + 'summary' => 'Queries statistics about the slow log trends for a cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSlowLogTrend', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF\\",\\n \\"SlowLogTrend\\": {\\n \\"TableSchema\\": {\\n \\"ResultSet\\": [\\n {\\n \\"Type\\": \\"UInt64\\",\\n \\"Name\\": \\"query_start_time\\"\\n }\\n ]\\n },\\n \\"Data\\": {\\n \\"ResultSet\\": [\\n {\\n \\"QueryStartTime\\": \\"2022-05-22 20:00:01\\",\\n \\"MaxQueryDurationMs\\": \\"3000\\",\\n \\"MinQueryDurationMs\\": \\"1000\\",\\n \\"Count\\": \\"4000\\",\\n \\"AvgQueryDurationMs\\": \\"2000\\"\\n }\\n ]\\n },\\n \\"Rows\\": \\"1\\",\\n \\"RowsBeforeLimitAtLeast\\": \\"1\\",\\n \\"Statistics\\": {\\n \\"RowsRead\\": 14721,\\n \\"ElapsedTime\\": 0.001703578,\\n \\"BytesRead\\": 697899\\n }\\n }\\n}","type":"json"}]', + ], + 'DescribeSynDbTables' => [ + 'summary' => 'Queries synchronized databases and tables.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'TotalDatabases', - 'in' => 'query', - 'schema' => [ - 'description' => 'All databases. Separate databases with commas (,).'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => 'db1,db2', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'abilityTreeCode' => '46614', + 'abilityTreeNodes' => ['FEATUREclickhouseZ93UXU'], + ], + 'parameters' => [ [ - 'name' => 'AllowDictionaries', + 'name' => 'DbClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The dictionaries to which you want to grant permissions. Separate dictionaries with commas (,).'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'dt1', - ], + 'schema' => ['description' => 'The ID of the ApsaraDB for ClickHouse cluster.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp158i5wvj436****'], ], [ - 'name' => 'TotalDictionaries', + 'name' => 'SynDb', 'in' => 'query', - 'schema' => [ - 'description' => 'All dictionaries. Separate dictionaries with commas (,).'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => 'dt1,dt2', - ], + 'schema' => ['description' => 'The name of the ApsaraDB RDS for MySQL database.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'database'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => 'The returned data.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '851D11EA-681C-5B38-A065-C3F90BBD49DE'], + 'Tables' => [ + 'description' => 'The tables.', + 'type' => 'array', + 'items' => ['description' => 'The name of an ApsaraDB RDS for MySQL table.', 'type' => 'string', 'title' => '', 'example' => 'test'], + 'title' => '', + 'example' => '', ], ], - 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'DescribeSynDbTables', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeSynDbTables'], ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSynDbTables', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","errorExample":""},{"type":"xml","example":"\\n F5178C10-1407-4987-9133-DE4DC9119F75\\n","errorExample":""}]', - 'title' => 'CreateAccountAndAuthority', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"851D11EA-681C-5B38-A065-C3F90BBD49DE\\",\\n \\"Tables\\": [\\n \\"test\\"\\n ]\\n}","type":"json"}]', ], - 'DescribeAccountAuthority' => [ - 'summary' => 'Queries the permissions of an account.', - 'methods' => [ - 'post', - 'get', - 'put', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSynDbs' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '19430', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseL1079N', - ], + 'abilityTreeCode' => '44312', + 'abilityTreeNodes' => ['FEATUREclickhouseZ93UXU'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DbClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The ID of the ApsaraDB for ClickHouse cluster.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1ab22b80814****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1p816075e21****', - ], + 'schema' => ['description' => 'The number of records to return on each page.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '20', 'title' => '', 'example' => '20'], ], [ - 'name' => 'AccountName', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'test', - ], + 'schema' => ['description' => 'The current page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'title' => '', 'example' => '1'], ], ], 'responses' => [ @@ -8576,223 +6782,197 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'DdlAuthority' => [ - 'description' => 'Indicates whether the database account has DDL permissions. Valid values:'."\n" - ."\n" - .'* **true**: has DDL permissions.'."\n" - .'* **false**: does not have DDL permissions.'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], - 'DmlAuthority' => [ - 'description' => 'Indicates whether the database account has DML permissions. Valid values:'."\n" - ."\n" - .'* **all**'."\n" - .'* **readOnly,modify**'."\n", - 'type' => 'string', - 'example' => 'all', - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], - 'TotalDatabases' => [ - 'description' => 'All databases.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'All databases.'."\n", - 'type' => 'string', - 'example' => 'db1,db2', - ], - ], - 'TotalDictionaries' => [ - 'description' => 'All dictionaries.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'All dictionaries.'."\n", - 'type' => 'string', - 'example' => 'dt1,dt2', - ], - ], - 'AllowDictionaries' => [ - 'description' => 'Dictionaries to which permissions have been granted.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'Dictionaries to which permissions have been granted.'."\n", - 'type' => 'string', - 'example' => 'dt1', - ], - ], - 'AllowDatabases' => [ - 'description' => 'Databases to which permissions have been granted.'."\n", + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '7655F5F9-1313-5ABA-8516-F6EB79605A5F'], + 'SynDbs' => [ + 'description' => 'The synchronized data.', 'type' => 'array', 'items' => [ - 'description' => 'Databases to which permissions have been granted.'."\n", - 'type' => 'string', - 'example' => 'db1', + 'description' => 'The objects synchronized to ClickHouse.', + 'type' => 'object', + 'properties' => [ + 'RdsId' => ['description' => 'The instance ID of the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'title' => '', 'example' => 'rm-wz9d11qg1j0h4****'], + 'SynDb' => ['description' => 'The database in the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'title' => '', 'example' => 'database'], + 'SynStatus' => ['description' => 'Indicates whether the synchronization was successful. Valid values:'."\n" + ."\n" + .'- **true**: The synchronization was successful.'."\n" + ."\n" + .'- **false**: The synchronization failed.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], + 'ErrorMsg' => ['description' => '- This parameter is not returned if **SynStatus** is **true**.'."\n" + ."\n" + .'- If **SynStatus** is **false**, this parameter indicates the reason for the synchronization failure.', 'type' => 'string', 'title' => '', 'example' => 'ClickHouse exception, code: 49, host: 100.100.118.132, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n'], + 'RdsUserName' => ['description' => 'The database account for the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'title' => '', 'example' => 'test'], + 'RdsVpcUrl' => ['description' => 'The internal endpoint of the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'title' => '', 'example' => 'rm-bp16t9h3999xb0a711****.mysql.rds.aliyuncs.com:3306'], + ], + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], - 'AccountName' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'example' => 'test', - ], + 'TotalCount' => ['description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '0'], + 'PageSize' => ['description' => 'The number of records on each page.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '20'], + 'PageNumber' => ['description' => 'The current page number.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '1'], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"DdlAuthority\\": true,\\n \\"DmlAuthority\\": \\"all\\",\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"TotalDatabases\\": [\\n \\"db1,db2\\"\\n ],\\n \\"TotalDictionaries\\": [\\n \\"dt1,dt2\\"\\n ],\\n \\"AllowDictionaries\\": [\\n \\"dt1\\"\\n ],\\n \\"AllowDatabases\\": [\\n \\"db1\\"\\n ],\\n \\"AccountName\\": \\"test\\"\\n}","errorExample":""},{"type":"xml","example":"\\n true\\n all\\n F5178C10-1407-4987-9133-DE4DC9119F75\\n db1,db2\\n dt1,dt2\\n dt1\\n db1\\n test\\n","errorExample":""}]', - 'title' => 'DescribeAccountAuthority', - ], - 'ModifyAccountAuthority' => [ - 'summary' => 'Modifies the permissions of an account.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeSynDbs', + 'summary' => 'Queries information about synchronized databases.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeSynDbs'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSynDbs', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7655F5F9-1313-5ABA-8516-F6EB79605A5F\\",\\n \\"SynDbs\\": [\\n {\\n \\"RdsId\\": \\"rm-wz9d11qg1j0h4****\\",\\n \\"SynDb\\": \\"database\\",\\n \\"SynStatus\\": true,\\n \\"ErrorMsg\\": \\"ClickHouse exception, code: 49, host: 100.100.118.132, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n\\",\\n \\"RdsUserName\\": \\"test\\",\\n \\"RdsVpcUrl\\": \\"rm-bp16t9h3999xb0a711****.mysql.rds.aliyuncs.com:3306\\"\\n }\\n ],\\n \\"TotalCount\\": 0,\\n \\"PageSize\\": 20,\\n \\"PageNumber\\": 1\\n}","type":"json"}]', + ], + 'DescribeTables' => [ + 'summary' => 'You can call the DescribeTables operation to query tables in a community-compatible cluster.', + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '19461', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseL1079N', - ], + 'operationType' => 'get', + 'abilityTreeCode' => '19459', + 'abilityTreeNodes' => ['FEATUREclickhouseMCDGZK'], ], 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'AccountName', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'test', - ], + 'schema' => ['description' => 'The database name.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'database'], ], - [ - 'name' => 'DmlAuthority', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'Specifies whether to grant DML permissions to the database account. Valid values:'."\n" - ."\n" - .'* **all**'."\n" - .'* **readonly,modify**'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'all', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0'], + 'Items' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Table' => [ + 'description' => 'The table information.', + 'type' => 'array', + 'items' => [ + 'description' => 'A table.', + 'type' => 'object', + 'properties' => [ + 'TableName' => ['description' => 'The table name.', 'type' => 'string', 'title' => '', 'example' => 'test'], + 'DBClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp108z124a8o7****'], + 'SchemaName' => ['description' => 'The database name.', 'type' => 'string', 'title' => '', 'example' => 'database'], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], - [ - 'name' => 'DdlAuthority', - 'in' => 'query', - 'schema' => [ - 'description' => 'Specifies whether to grant DDL permissions to the database account. Valid values:'."\n" - ."\n" - .'* **true**: grants DDL permissions to the database account.'."\n" - .'* **false**: does not grant DDL permissions to the database account.'."\n", - 'type' => 'boolean', - 'required' => true, - 'docRequired' => true, - 'example' => 'true', - ], + ], + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], - [ - 'name' => 'AllowDatabases', - 'in' => 'query', - 'schema' => [ - 'description' => 'The databases to which you want to grant permissions. Separate databases with commas (,).'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'db1', - ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], - [ - 'name' => 'TotalDatabases', - 'in' => 'query', - 'schema' => [ - 'description' => 'All databases. Separate databases with commas (,).'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => 'db1,db2', + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'DescribeTables', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeTables', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\",\\n \\"Items\\": {\\n \\"Table\\": [\\n {\\n \\"TableName\\": \\"test\\",\\n \\"DBClusterId\\": \\"cc-bp108z124a8o7****\\",\\n \\"SchemaName\\": \\"database\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeTransferHistory' => [ + 'summary' => 'View migration history.', + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'AllowDictionaries', - 'in' => 'query', - 'schema' => [ - 'description' => 'The dictionaries to which you want to grant permissions. Separate dictionaries with commas (,).'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'dt1', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '36715', + 'abilityTreeNodes' => ['FEATUREclickhouseMCDGZK'], + ], + 'parameters' => [ [ - 'name' => 'TotalDictionaries', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'All dictionaries. Separate dictionaries with commas (,).'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => 'dt1,dt2', - ], + 'schema' => ['description' => 'The ID of the cluster.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp108z124a8o7****', 'title' => ''], ], ], 'responses' => [ @@ -8800,53 +6980,91 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', + 'HistoryDetails' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'HistoryDetail' => [ + 'description' => 'Details of the data migration.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'SourceDBCluster' => ['description' => 'The source cluster ID.', 'type' => 'string', 'example' => 'cc-bp108z124a8o7****', 'title' => ''], + 'SourceControlVersion' => ['description' => 'The control version of the source cluster.', 'type' => 'string', 'example' => 'v1', 'title' => ''], + 'TargetDBCluster' => ['description' => 'The target cluster ID.', 'type' => 'string', 'example' => 'cc-bp13zkh9uw523****', 'title' => ''], + 'TargetControlVersion' => ['description' => 'The control version of the target cluster.', 'type' => 'string', 'example' => 'v2', 'title' => ''], + 'Status' => ['description' => 'The data migration status. Valid values:'."\n" + ."\n" + .'- **Finished**: Completed.'."\n" + ."\n" + .'- **Processing**: In progress.', 'type' => 'string', 'example' => 'Finished', 'title' => ''], + 'Progress' => ['description' => 'The data migration progress.', 'type' => 'string', 'example' => '100%', 'title' => ''], + 'DisableWriteWindows' => ['description' => 'The write suspension window.', 'type' => 'string', 'example' => '2025-02-08T00:00:00+08:00,2025-02-12T00:00:00+08:00', 'title' => ''], + 'UnsyncedBytes' => ['description' => 'The amount of unsynchronized data, in bytes.', 'type' => 'integer', 'format' => 'int64', 'example' => '102400', 'title' => ''], + 'UnsyncedParts' => ['description' => 'The number of unsynchronized parts.', 'type' => 'integer', 'format' => 'int64', 'example' => '1000', 'title' => ''], + 'PartsPerMinute' => ['description' => 'The number of parts migrated per minute.', 'type' => 'number', 'format' => 'double', 'example' => '1.24', 'title' => ''], + 'BytesPerMinute' => ['description' => 'The amount of data migrated per minute, in bytes.', 'type' => 'integer', 'format' => 'int64', 'example' => '10240', 'title' => ''], + 'SubJob' => ['description' => 'The active sub-job.', 'type' => 'string', 'example' => 'SubJob', 'title' => ''], + 'SubJobStatus' => ['description' => 'The status of the sub-job.', 'type' => 'string', 'example' => 'running', 'title' => ''], + 'SubJobMessage' => ['description' => 'The message returned by the sub-job.', 'type' => 'string', 'example' => 'Code: 210. DB::NetException: Connection refused (ck-****-****-clickhouse-s-0-r-0.ck-****-****-clickhouse-headless.ck-****.svc.cluster.local:3003). (NETWORK_ERROR) (version 22.8.5.29)', 'title' => ''], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', 'title' => ''], ], 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - ], 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 05321590-BB65-4720-8CB6-8218E041CDD0\\n","errorExample":""}]', - 'title' => 'ModifyAccountAuthority', - ], - 'DescribeDBClusterAccessWhiteList' => [ - 'summary' => 'Queries the IP address whitelist of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HistoryDetails\\": {\\n \\"HistoryDetail\\": [\\n {\\n \\"SourceDBCluster\\": \\"cc-bp108z124a8o7****\\",\\n \\"SourceControlVersion\\": \\"v1\\",\\n \\"TargetDBCluster\\": \\"cc-bp13zkh9uw523****\\",\\n \\"TargetControlVersion\\": \\"v2\\",\\n \\"Status\\": \\"Finished\\",\\n \\"Progress\\": \\"100%\\",\\n \\"DisableWriteWindows\\": \\"2025-02-08T00:00:00+08:00,2025-02-12T00:00:00+08:00\\",\\n \\"UnsyncedBytes\\": 102400,\\n \\"UnsyncedParts\\": 1000,\\n \\"PartsPerMinute\\": 1.24,\\n \\"BytesPerMinute\\": 10240,\\n \\"SubJob\\": \\"SubJob\\",\\n \\"SubJobStatus\\": \\"running\\",\\n \\"SubJobMessage\\": \\"Code: 210. DB::NetException: Connection refused (ck-****-****-clickhouse-s-0-r-0.ck-****-****-clickhouse-headless.ck-****.svc.cluster.local:3003). (NETWORK_ERROR) (version 22.8.5.29)\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","type":"json"}]', + 'title' => 'DescribeTransferHistory', + 'description' => '> This API operation is used only to query data migrations between Alibaba Cloud ClickHouse clusters during version upgrades.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeTransferHistory', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + ], + 'DescribeUserEncryptionKeyList' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -8856,23 +7074,30 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '19438', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseW0KOAC', - ], - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '220406', + 'abilityTreeNodes' => ['FEATUREclickhouseY04H6E'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => 'The page number.', 'type' => 'string', 'required' => false, 'example' => '1', 'title' => ''], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => 'The number of entries per page. Valid values:'."\n" + ."\n" + .'- **30** (default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'string', 'required' => false, 'example' => '30', 'title' => ''], ], ], 'responses' => [ @@ -8880,51 +7105,26 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'DBClusterAccessWhiteList' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'IPArray' => [ - 'description' => 'The details about the IP address whitelist.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'DBClusterIPArrayAttribute' => [ - 'description' => 'The attribute of the IP address whitelist.'."\n", - 'type' => 'string', - 'example' => 'default', - ], - 'SecurityIPList' => [ - 'description' => 'The IP addresses in the IP address whitelist.'."\n", - 'type' => 'string', - 'example' => '192.168.xx.xx,192.168.xx.xx', - ], - 'DBClusterIPArrayName' => [ - 'description' => 'The name of the IP address whitelist.'."\n", - 'type' => 'string', - 'example' => 'default', - ], - ], - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', 'title' => ''], + 'KmsKeys' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'KeyId' => ['description' => 'The key ID.', 'type' => 'string', 'example' => '0275bd3f-fdbb-4d8c-846b-71b211******'."\n", 'title' => ''], ], + 'description' => 'The list of KMS keys.', + 'title' => '', + 'example' => '', ], - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '905F13A4-5097-4897-A84D-527EC75FFF4F', + 'description' => 'The list of KMS keys.', + 'title' => '', + 'example' => '', ], ], 'description' => '', - ], - ], - ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'title' => '', + 'example' => '', ], ], ], @@ -8932,103 +7132,71 @@ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"DBClusterAccessWhiteList\\": {\\n \\"IPArray\\": [\\n {\\n \\"DBClusterIPArrayAttribute\\": \\"default\\",\\n \\"SecurityIPList\\": \\"192.168.xx.xx,192.168.xx.xx\\",\\n \\"DBClusterIPArrayName\\": \\"default\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"905F13A4-5097-4897-A84D-527EC75FFF4F\\"\\n}","errorExample":""},{"type":"xml","example":"\\n \\n default\\n 192.168.xx.xx,192.168.xx.xx\\n default\\n \\n 905F13A4-5097-4897-A84D-527EC75FFF4F\\n","errorExample":""}]', - 'title' => 'DescribeDBClusterAccessWhiteList', - ], - 'ModifyDBClusterAccessWhiteList' => [ - 'summary' => 'Modifies the IP address whitelist of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'DescribeUserEncryptionKeyList', + 'summary' => 'Retrieves a list of your KMS keys.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"KmsKeys\\": [\\n {\\n \\"KeyId\\": \\"0275bd3f-fdbb-4d8c-846b-71b211******\\\\n\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'ElectZookeeperLeader' => [ + 'summary' => 'Switches the ZooKeeper leader for a community-compatible ClickHouse instance.', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', - 'abilityTreeCode' => '19465', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseW0KOAC', - ], - 'tenantRelevance' => 'tenant', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '173004', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], ], 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.'."\n" + ."\n" + .'> Call the [DescribeRegions](~~170875~~) operation to query the region ID.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1qx68m06981****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp108z124a8o7****', 'title' => ''], ], [ - 'name' => 'SecurityIps', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'The IP addresses in the IP address whitelist. You can specify IP addresses in the following formats:'."\n" - ."\n" - .'* IP address. For example, you can set SecurityIps to 192.168.0.1. This allows you to use this IP address to access your ApsaraDB for ClickHouse cluster.'."\n" - .'* CIDR block. For example, you can set SecurityIps to 192.168.0.0/24. This allows you to use the IP addresses from 192.168.0.1 to 192.168.0.255 to access your ApsaraDB for ClickHouse cluster.'."\n" - ."\n" - .'> '."\n" - ."\n" - .'* Do not set SecurityIps to 0.0.0.0.'."\n" - ."\n" - .'* If you set SecurityIps to 127.0.0.1, all IP addresses are blocked from accessing your ApsaraDB for ClickHouse cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '192.168.xx.xx', - ], + 'schema' => ['description' => 'The number of entries to return on each page. Valid values:'."\n" + ."\n" + .'- **30** (Default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '30', 'example' => '30', 'title' => ''], ], [ - 'name' => 'DBClusterIPArrayName', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the IP address whitelist that you want to modify.'."\n" - ."\n" - .'> If you do not specify this parameter, the default IP address whitelist is modified.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'default', - ], + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'example' => '1', 'title' => ''], ], [ - 'name' => 'DBClusterIPArrayAttribute', + 'name' => 'DisableWrite', 'in' => 'query', - 'schema' => [ - 'description' => 'The attribute of the IP address whitelist. By default, this parameter is **empty**.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'NULL', - ], + 'schema' => ['description' => 'Specifies whether to disable writes.', 'type' => 'boolean', 'required' => false, 'example' => 'true', 'title' => ''], ], [ - 'name' => 'ModifyMode', + 'name' => 'ElectTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The method that is used to modify the IP address whitelist. Valid values:'."\n" - ."\n" - .'* **Cover**: overwrites the original IP address whitelist.'."\n" - .'* **Append**: appends the specified IP addresses to the original IP address whitelist.'."\n" - .'* **Delete**: deletes the original IP address whitelist.'."\n" - ."\n" - .'> If you do not specify this parameter, the default value of Cover is used.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'Cover', - ], + 'schema' => ['description' => 'The time to perform the leader switchover.', 'type' => 'string', 'required' => false, 'example' => '2025-12-12T07:28:00Z', 'title' => ''], ], ], 'responses' => [ @@ -9036,119 +7204,119 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF'], ], - 'description' => '', + 'title' => '', + 'description' => 'Response information.', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\"\\n}","errorExample":""},{"type":"xml","example":"\\n D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\n","errorExample":""}]', - 'title' => 'ModifyDBClusterAccessWhiteList', - ], - 'CreateMonitorDataReport' => [ - 'summary' => 'Creates a monitoring data report for an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'ElectZookeeperLeader', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF\\"\\n}","type":"json"}]', + ], + 'KillProcess' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '81430', - 'abilityTreeNodes' => [ - 'FEATUREclickhouse1YZKWF', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '19460', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], ], 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID. Call the [DescribeRegions](~~170875~~) operation to query the region ID.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], + ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp13s14l8498l****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'RegionId', + 'name' => 'InitialQueryId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The search statement to stop. To stop multiple statements, separate them with commas (,).'."\n" + ."\n" + .'> If you do not specify this parameter, all search statements are stopped by default.', 'type' => 'string', 'required' => false, 'docRequired' => false, 'title' => '', 'example' => 'SELECT * FROM `test01` ;'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '94F92113-FF63-5E57-8401-6FE123AD11DD', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"94F92113-FF63-5E57-8401-6FE123AD11DD\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 94F92113-FF63-5E57-8401-6FE123AD11DD\\n","errorExample":""}]', - 'title' => 'CreateMonitorDataReport', - ], - 'CheckMonitorAlert' => [ - 'summary' => 'Checks whether the monitoring and alerting feature that is provided by Application Real-Time Monitoring Service (ARMS) is enabled for an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'KillProcess', + 'summary' => 'Stops ongoing tasks.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:KillProcess', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","type":"json"}]', + ], + 'ListTagResources' => [ + 'summary' => 'Lists the tags that are attached to ApsaraDB for ClickHouse clusters.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -9157,32 +7325,82 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '81031', - 'abilityTreeNodes' => [ - 'FEATUREclickhouse1YZKWF', - ], + 'operationType' => 'list', + 'abilityTreeCode' => '166149', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.'."\n" + ."\n" + .'> You can call the [DescribeRegions](~~170875~~) operation to query region IDs.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'ResourceType', + 'in' => 'query', + 'schema' => ['description' => 'The resource type. Set the value to **DBCLUSTER**.', 'type' => 'string', 'required' => true, 'example' => 'DBCLUSTER', 'title' => ''], + ], + [ + 'name' => 'NextToken', + 'in' => 'query', + 'schema' => ['description' => 'The token that is used to retrieve the next page of results. You do not need to specify this parameter for the first query. If a query does not return all results, a NextToken value is returned. You can use this token in a subsequent query to retrieve the next page of results.', 'type' => 'string', 'required' => false, 'example' => '212db86sca4384811e0b5e8707ec21345', 'title' => ''], + ], + [ + 'name' => 'ResourceId', 'in' => 'query', + 'style' => 'repeatList', 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp13s14l8498l****', + 'type' => 'array', + 'items' => ['description' => ''."\n" + ."\n" + .'The cluster ID. You can specify from **1** to **50** cluster IDs.'."\n" + ."\n" + .''."\n" + ."\n" + .''."\n" + ."\n" + .'The ID of the cluster. You can specify N cluster IDs. The value of N is an integer from **1 to 50**.'."\n" + ."\n" + .''."\n" + ."\n" + .'> - You can call the [DescribeDBClusters](~~170879~~) operation to query the information about all clusters in a region, including cluster IDs.'."\n" + ."\n" + .'- If you specify the **Tag.N.Key** parameter, you can leave this parameter empty.', 'type' => 'string', 'required' => false, 'example' => 'cc-bp1t9lbb7a4z7****', 'title' => ''], + 'required' => false, + 'maxItems' => 51, + 'description' => 'The resource ID.', + 'title' => '', + 'example' => '', ], ], [ - 'name' => 'RegionId', + 'name' => 'Tag', 'in' => 'query', + 'style' => 'repeatList', 'schema' => [ - 'description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => 'The tag key. You can specify from 1 to **20** tag keys.'."\n" + ."\n" + .'> If you specify the **ResourceId.N** parameter, you can leave this parameter empty.', 'type' => 'string', 'required' => false, 'example' => 'testkey1', 'title' => ''], + 'Value' => ['description' => 'The value of the tag. You can specify from 1 to **20** tag values.'."\n" + ."\n" + .'> You can leave this parameter empty.', 'type' => 'string', 'required' => false, 'example' => 'testvalue1', 'title' => ''], + ], + 'required' => false, + 'description' => 'The list of tags.', + 'title' => '', + 'example' => '', + ], 'required' => false, - 'example' => 'cn-hangzhou', + 'maxItems' => 21, + 'description' => 'The list of tags.', + 'title' => '', + 'example' => '', ], ], ], @@ -9190,123 +7408,180 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '94F92113-FF63-5E57-8401-6FE123AD11DD', - ], - 'State' => [ - 'description' => 'Indicates whether the monitoring and alerting feature is enabled. Valid values:'."\n" - ."\n" - .'* **enable**: The monitoring and alerting feature is enabled.'."\n" - .'* **disable**: The monitoring and alerting feature is disabled.'."\n", - 'type' => 'string', - 'example' => 'enable', - ], - 'Parameter' => [ - 'description' => 'The parameters that are used to configure the monitoring and alerting feature.'."\n", - 'type' => 'string', - 'example' => '{ "monitor":{ "key1":"value1", "key2":"value2" }, "alert":{ "key1":"value1", "key2":"value2" } }', + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => '184DE106-CB2C-4DD2-B57F-396652E6C8F8'], + 'NextToken' => ['description' => 'The token that is used to retrieve the next page of results. This parameter is returned only if the results are not fully returned in the current request. You can use this token in a subsequent request to retrieve the next page of results.', 'type' => 'string', 'example' => '212db86sca4384811e0b5e8707ec21345', 'title' => ''], + 'TagResources' => [ + 'description' => 'Information about the clusters and their tags.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'TagValue' => ['description' => 'The value of the tag.', 'type' => 'string', 'example' => 'testvalue1', 'title' => ''], + 'TagKey' => ['description' => 'The tag key.', 'type' => 'string', 'example' => 'testkey1', 'title' => ''], + 'ResourceType' => ['description' => 'The resource type. The value is **DBCLUSTER**.', 'type' => 'string', 'example' => 'DBCLUSTER', 'title' => ''], + 'ResourceId' => ['description' => ''."\n" + ."\n" + .'The cluster ID.'."\n" + ."\n" + .''."\n" + ."\n" + .''."\n" + ."\n" + .'', 'type' => 'string', 'example' => 'cc-bp1t9lbb7a4z7****', 'title' => ''], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', ], ], - ], - ], - ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'example' => '', ], ], ], 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"94F92113-FF63-5E57-8401-6FE123AD11DD\\",\\n \\"State\\": \\"enable\\",\\n \\"Parameter\\": \\"{ \\\\\\"monitor\\\\\\":{ \\\\\\"key1\\\\\\":\\\\\\"value1\\\\\\", \\\\\\"key2\\\\\\":\\\\\\"value2\\\\\\" }, \\\\\\"alert\\\\\\":{ \\\\\\"key1\\\\\\":\\\\\\"value1\\\\\\", \\\\\\"key2\\\\\\":\\\\\\"value2\\\\\\" } }\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 94F92113-FF63-5E57-8401-6FE123AD11DD\\n enable\\n { \\"monitor\\":{ \\"key1\\":\\"value1\\", \\"key2\\":\\"value2\\" }, \\"alert\\":{ \\"key1\\":\\"value1\\", \\"key2\\":\\"value2\\" } }\\n","errorExample":""}]', - 'title' => 'CheckMonitorAlert', - ], - 'CheckServiceLinkedRole' => [ - 'methods' => [ - 'post', - 'get', - 'put', + 'enable' => false, + 'eventNames' => [], ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'ListTagResources', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"184DE106-CB2C-4DD2-B57F-396652E6C8F8\\",\\n \\"NextToken\\": \\"212db86sca4384811e0b5e8707ec21345\\",\\n \\"TagResources\\": [\\n {\\n \\"TagValue\\": \\"testvalue1\\",\\n \\"TagKey\\": \\"testkey1\\",\\n \\"ResourceType\\": \\"DBCLUSTER\\",\\n \\"ResourceId\\": \\"cc-bp1t9lbb7a4z7****\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'ModifyAccountAuthority' => [ + 'summary' => 'Modifies the permissions of a database account.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '19420', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', + 'operationType' => 'update', + 'abilityTreeCode' => '19461', + 'abilityTreeNodes' => ['FEATUREclickhouseL1079N'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp108z124a8o7****', 'title' => ''], + ], + [ + 'name' => 'AccountName', + 'in' => 'query', + 'schema' => ['description' => 'The database account.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'test', 'title' => ''], + ], + [ + 'name' => 'DmlAuthority', + 'in' => 'query', + 'schema' => ['description' => 'The DML permissions granted to the database account. Valid values:'."\n" + ."\n" + .'- **all**: Grants read, write, and modify permissions.'."\n" + ."\n" + .'- **readonly,modify**: Grants read and modify permissions.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'all', 'title' => ''], + ], + [ + 'name' => 'DdlAuthority', + 'in' => 'query', + 'schema' => ['description' => 'Specifies whether to grant DDL permissions to the database account. Valid values:'."\n" + ."\n" + .'- **true**: Allows DDL operations.'."\n" + ."\n" + .'- **false**: Denies DDL operations.', 'type' => 'boolean', 'required' => true, 'docRequired' => true, 'example' => 'true', 'title' => ''], + ], + [ + 'name' => 'AllowDatabases', + 'in' => 'query', + 'schema' => ['description' => 'The list of databases to authorize. Separate multiple database names with commas (,).', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'db1', 'title' => ''], + ], + [ + 'name' => 'TotalDatabases', + 'in' => 'query', + 'schema' => ['description' => 'All databases in the cluster. Separate multiple database names with commas (,).', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'db1,db2', 'title' => ''], + ], + [ + 'name' => 'AllowDictionaries', + 'in' => 'query', + 'schema' => ['description' => 'The list of dictionaries to authorize. Separate multiple dictionary names with commas (,).', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'dt1', 'title' => ''], + ], + [ + 'name' => 'TotalDictionaries', + 'in' => 'query', + 'schema' => ['description' => 'All dictionaries in the cluster. Separate multiple dictionary names with commas (,).', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'dt1,dt2', 'title' => ''], ], ], - 'parameters' => [], 'responses' => [ 200 => [ 'schema' => [ - 'description' => 'list'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'xxx', - ], - 'HasServiceLinkedRole' => [ - 'description' => 'Indicates whether a service-linked role is created for ApsaraDB for ClickHouse.'."\n", - 'type' => 'boolean', - 'example' => 'xxxx', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', 'title' => ''], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"66428721-xxxx-xxxx-xxxx-3BD1B67837E0\\\\n\\",\\n \\"HasServiceLinkedRole\\": true\\n}","type":"json"}]', - 'title' => 'CheckServiceLinkedRole', - 'summary' => 'Queries the service-linked role of ApsaraDB for ClickHouse.', - ], - 'ModifyMinorVersionGreadeType' => [ - 'summary' => 'Modifies the type of a minor version update in ApsaraDB for ClickHouse.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","type":"json"}]', + 'title' => 'ModifyAccountAuthority', + 'description' => 'This API operation applies only to cluster versions 21.8 and earlier. For cluster versions later than 21.8, you must use a high-privilege account to run SQL statements to modify the permissions of standard users.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyAccountAuthority'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyAccountAuthority', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + ], + 'ModifyAccountDescription' => [ + 'summary' => 'Modifies the description of a database account in an ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -9316,34 +7591,29 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', - 'abilityTreeCode' => '147864', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseN0HBPQ', - ], + 'abilityTreeCode' => '19462', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1qx68m06981****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'MaintainAutoType', + 'name' => 'AccountName', 'in' => 'query', - 'schema' => [ - 'description' => 'The update type. If you set the parameter to **false**, you perform the manual update.'."\n", - 'type' => 'boolean', - 'required' => true, - 'docRequired' => true, - 'example' => 'false', - ], + 'schema' => ['description' => 'The database account.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'test'], + ], + [ + 'name' => 'AccountDescription', + 'in' => 'query', + 'schema' => ['description' => 'The new description of the database account.'."\n" + ."\n" + .'- The description cannot start with http\\:// or https\\://.'."\n" + ."\n" + .'- The description must be 0 to 256 characters in length.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'ceshi'], ], ], 'responses' => [ @@ -9351,112 +7621,99 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.', - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\"\\n}","type":"json"}]', - 'title' => 'ModifyMinorVersionGreadeType', - ], - 'DescribeSlowLogTrend' => [ - 'methods' => [ - 'post', - 'get', - 'put', + 'title' => 'ModifyAccountDescription', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyAccountDescription'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyAccountDescription', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","type":"json"}]', + ], + 'ModifyActiveOperationMaintainConf' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '19458', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseLESIXD', - ], - ], + 'systemTags' => ['operationType' => 'none', 'tenantRelevance' => 'publicInformation'], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'CycleType', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The recurrence cycle. Valid values:'."\n" + ."\n" + .'- Month: monthly'."\n" + ."\n" + .'- Week: weekly', 'type' => 'string', 'required' => false, 'example' => 'Week', 'title' => ''], ], [ - 'name' => 'DBClusterId', + 'name' => 'CycleTime', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp11xxl475ui8****', - ], + 'schema' => ['description' => 'The day of the recurrence cycle.'."\n" + ."\n" + .'- If CycleType is set to Month, this parameter specifies the day of the month. Valid values are 1 to 28. Use a comma (,) to separate multiple days.'."\n" + ."\n" + .'- If CycleType is set to Week, this parameter specifies the day of the week. Valid values are 1 to 7. Use a comma (,) to separate multiple days.', 'type' => 'string', 'required' => false, 'example' => '1', 'title' => ''], ], [ - 'name' => 'StartTime', + 'name' => 'MaintainStartTime', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2022-05-20 16:00:00', - ], + 'schema' => ['description' => 'The start time of the maintenance window. Use the HH:mmZ format. The time is in UTC.', 'type' => 'string', 'required' => false, 'example' => '07:00Z', 'title' => ''], ], [ - 'name' => 'EndTime', + 'name' => 'MaintainEndTime', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2022-05-27 16:00:00', - ], + 'schema' => ['description' => 'The end time of the maintenance window. Use the HH:mmZ format. The time is in UTC.', 'type' => 'string', 'required' => false, 'example' => '20:00Z', 'title' => ''], ], [ - 'name' => 'QueryDurationMs', + 'name' => 'Status', 'in' => 'query', 'schema' => [ - 'description' => 'The execution duration of slow SQL queries. Minimum value: **1000**. Default value: **1000**. Unit: milliseconds. Slow SQL queries that last longer than the specified duration are returned in response parameters.'."\n", + 'description' => 'Specifies whether the configuration is enabled. Valid values:'."\n" + ."\n" + .'- **1**: Enabled.'."\n" + ."\n" + .'- **2**: Disabled.', + 'enumValueTitles' => [], 'type' => 'integer', 'format' => 'int32', 'required' => false, - 'maximum' => '9999999999', - 'minimum' => '0', - 'example' => '1000', - 'isFileTransferUrl' => false, - 'default' => '1000', + 'enum' => ['1', '2'], + 'example' => '1', + 'title' => '', ], ], ], @@ -9465,133 +7722,75 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => '7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF', - ], - 'SlowLogTrend' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'TableSchema' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'ResultSet' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'UInt64', - ], - 'Name' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'query_start_time', - ], - ], - ], - ], - ], - ], - 'Data' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'ResultSet' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'QueryStartTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2022-05-22 20:00:01', - ], - 'MaxQueryDurationMs' => [ - 'description' => '', - 'type' => 'string', - 'example' => '3000', - ], - 'MinQueryDurationMs' => [ - 'description' => '', - 'type' => 'string', - 'example' => '1000', - ], - 'Count' => [ - 'description' => '', - 'type' => 'string', - 'example' => '4000', - ], - 'AvgQueryDurationMs' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2000', - ], - ], - ], - ], - ], - ], - 'Rows' => [ - 'description' => '', - 'type' => 'string', - 'example' => '1', - ], - 'RowsBeforeLimitAtLeast' => [ - 'description' => '', - 'type' => 'string', - 'example' => '1', - ], - 'Statistics' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'RowsRead' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '14721', - ], - 'ElapsedTime' => [ - 'description' => '', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.001703578', - ], - 'BytesRead' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '697899', - ], - ], - ], - ], - ], + 'RequestId' => ['description' => 'The ID of the request.', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', 'title' => ''], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], - 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'ModifyActiveOperationMaintainConf', + 'summary' => 'Modifies the configuration of active O&M tasks on a community-compatible ClickHouse cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","type":"json"}]', + ], + 'ModifyActiveOperationTasks' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'abilityTreeCode' => '201218', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], + 'tenantRelevance' => 'publicInformation', + ], + 'parameters' => [ + [ + 'name' => 'Ids', + 'in' => 'query', + 'schema' => ['description' => 'The O\\&M task IDs. Separate multiple IDs with commas (,).', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '188****,188****,188****', 'title' => ''], + ], + [ + 'name' => 'SwitchTime', + 'in' => 'query', + 'schema' => ['description' => 'The time to initiate the switch operation. The time is in UTC and the format is YYYY-MM-DDTHH:mm:ssZ.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2023-01-09T05:00:00Z', 'title' => ''], + ], + [ + 'name' => 'ImmediateStart', + 'in' => 'query', + 'schema' => ['description' => 'Specifies whether to immediately execute the O\\&M task. Valid values:'."\n" + ."\n" + .'- **1**: Execute immediately.'."\n" + ."\n" + .'- **0**: Execute at the specified time.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '0', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'Ids' => ['description' => 'The O\\&M event IDs. Multiple IDs are separated by commas (,).', 'type' => 'string', 'example' => '188****,188****,188****', 'title' => ''], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '617242AA-04D8-5AF0-8C0C-6E53DDA8C3C3', 'title' => ''], + ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], @@ -9599,45 +7798,63 @@ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF\\",\\n \\"SlowLogTrend\\": {\\n \\"TableSchema\\": {\\n \\"ResultSet\\": [\\n {\\n \\"Type\\": \\"UInt64\\",\\n \\"Name\\": \\"query_start_time\\"\\n }\\n ]\\n },\\n \\"Data\\": {\\n \\"ResultSet\\": [\\n {\\n \\"QueryStartTime\\": \\"2022-05-22 20:00:01\\",\\n \\"MaxQueryDurationMs\\": \\"3000\\",\\n \\"MinQueryDurationMs\\": \\"1000\\",\\n \\"Count\\": \\"4000\\",\\n \\"AvgQueryDurationMs\\": \\"2000\\"\\n }\\n ]\\n },\\n \\"Rows\\": \\"1\\",\\n \\"RowsBeforeLimitAtLeast\\": \\"1\\",\\n \\"Statistics\\": {\\n \\"RowsRead\\": 14721,\\n \\"ElapsedTime\\": 0.001703578,\\n \\"BytesRead\\": 697899\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF\\n \\n \\n UInt64\\n query_start_time\\n \\n \\n 2022-05-22 20:00:01\\n 3000\\n 1000\\n 4000\\n 2000\\n \\n 1\\n 1\\n \\n 14721\\n 0.001703578\\n 697899\\n \\n \\n","errorExample":""}]', - 'title' => 'DescribeSlowLogTrend', - 'summary' => 'Queries the trend of slow query logs for an ApsaraDB for ClickHouse cluster.', - ], - 'DescribeDBClusterStatusSet' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'ModifyActiveOperationTasks', + 'summary' => 'Modifies the switch time for operations and maintenance (O&M) events on a ClickHouse Community-compatible cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Ids\\": \\"188****,188****,188****\\",\\n \\"RequestId\\": \\"617242AA-04D8-5AF0-8C0C-6E53DDA8C3C3\\"\\n}","type":"json"}]', + ], + 'ModifyAutoRenewAttribute' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '19444', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseMCDGZK', - ], - 'tenantRelevance' => 'publicInformation', - ], + 'systemTags' => ['operationType' => 'update', 'riskType' => 'high', 'chargeType' => 'paid'], 'parameters' => [ + [ + 'name' => 'DBClusterIds', + 'in' => 'query', + 'schema' => ['type' => 'string', 'required' => true, 'description' => 'The cluster ID. To specify multiple cluster IDs, separate them with commas (,).', 'title' => '', 'example' => 'cc-bp1uy5ff6*****'], + ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => 'The region ID.', 'title' => '', 'example' => 'cn-beijing'], + ], + [ + 'name' => 'RenewalStatus', + 'in' => 'query', + 'schema' => ['type' => 'string', 'required' => false, 'default' => 'AutoRenewal', 'description' => 'The renewal method. Valid values:'."\n" + ."\n" + .'- **AutoRenewal**: Auto-renewal.'."\n" + ."\n" + .'- **Normal**: Manual renewal.'."\n" + ."\n" + .'- **NotRenewal**: The cluster is not renewed after it expires.', 'title' => '', 'example' => 'AutoRenewal'], + ], + [ + 'name' => 'Duration', + 'in' => 'query', + 'schema' => ['type' => 'string', 'required' => false, 'default' => '1', 'description' => 'The renewal duration. The default value is **1**.'."\n" + ."\n" + .'- If you set \\`PeriodUnit\\` to **Month**, valid values are integers from 1 to 11.'."\n" + ."\n" + .'- If you set \\`PeriodUnit\\` to **Year**, valid values are 1, 2, 3, and 5.'."\n" + ."\n" + .'> A longer subscription period offers a better price. For example, a one-year subscription is more cost-effective than a 10-month or 11-month subscription.', 'title' => '', 'example' => '1'], + ], + [ + 'name' => 'PeriodUnit', + 'in' => 'query', + 'schema' => ['type' => 'string', 'required' => false, 'default' => 'Month', 'description' => 'The unit of the renewal duration specified by the \\`Duration\\` parameter. Valid values: Month and Year.', 'title' => '', 'example' => 'Year'], ], ], 'responses' => [ @@ -9645,35 +7862,45 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'DE309AA1-BD83-5E1F-9945-8A4D336E0829', - ], - 'StatusSet' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'ACTIVATION', - ], - ], + 'RequestId' => ['type' => 'string', 'description' => 'The request ID.', 'title' => '', 'example' => '7B94AB34-6875-56D2-92B4-0C2******'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"DE309AA1-BD83-5E1F-9945-8A4D336E0829\\",\\n \\"StatusSet\\": [\\n \\"ACTIVATION\\"\\n ]\\n}","type":"json"}]', - ], - 'CreateSLB' => [ - 'summary' => 'Mounts a Server Load Balancer (SLB) instance to an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => 'ModifyAutoRenewAttribute', + 'summary' => 'Modifies the auto-renewal status of a ClickHouse Community-Compatible cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyAutoRenewAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7B94AB34-6875-56D2-92B4-0C2******\\"\\n}","type":"json"}]', + ], + 'ModifyBackupPolicy' => [ + 'summary' => 'Modifies the backup settings of a specified ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -9682,374 +7909,436 @@ 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '143538', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseZHDS8I', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '19463', + 'abilityTreeNodes' => ['FEATUREclickhouseYFBZ0B'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to obtain the cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-uf6bnitmve5n0****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1qx68m06981****'], ], [ - 'name' => 'Product', + 'name' => 'PreferredBackupTime', 'in' => 'query', - 'schema' => [ - 'type' => 'string', - 'default' => 'clickhouse', - ], + 'schema' => ['description' => 'The backup time in UTC. The format is HH:mmZ-HH:mmZ.'."\n" + ."\n" + .'Example: 00:00Z-01:00Z. This means that data backup can be performed from 00:00 to 01:00 UTC. This corresponds to 08:00 to 09:00 UTC+8.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '15:00Z-16:00Z'], + ], + [ + 'name' => 'PreferredBackupPeriod', + 'in' => 'query', + 'schema' => ['description' => 'The backup cycle. If you specify multiple values, separate them with commas. Valid values:'."\n" + ."\n" + .'- **Monday**'."\n" + ."\n" + .'- **Tuesday**'."\n" + ."\n" + .'- **Wednesday**'."\n" + ."\n" + .'- **Thursday**'."\n" + ."\n" + .'- **Friday**'."\n" + ."\n" + .'- **Saturday**'."\n" + ."\n" + .'- **Sunday**', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'Monday'], + ], + [ + 'name' => 'BackupRetentionPeriod', + 'in' => 'query', + 'schema' => ['description' => 'The number of days to retain data backups. Valid values: 7 to 730.', 'type' => 'string', 'required' => false, 'default' => '7', 'title' => '', 'example' => '7'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => 'The response parameters.'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '9A23C87D-87DF-4DA0-A50E-CB13F4F7923D', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], + ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9A23C87D-87DF-4DA0-A50E-CB13F4F7923D\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 9A23C87D-87DF-4DA0-A50E-CB13F4F7923D\\n","errorExample":""}]', - 'title' => 'CreateSLB', - 'description' => '## [](#)Description'."\n" - ."\n" - .'An ApsaraDB for ClickHouse cluster is dependent on an SLB instance at the network layer. You can bind a domain name to the IP address of an ApsaraDB for ClickHouse node to provide external connectivity service and provide failover capabilities. The SLB instance forwards requests to the nodes in the ApsaraDB for ClickHouse cluster and balances the request traffic among the nodes. The SLB instance checks the availability of backend nodes. If the SLB instance detects that a node is unavailable by checking the health status of all nodes, the SLB instance automatically isolates the unavailable node. This ensures that the request traffic is balanced among available nodes.'."\n", - ], - 'DeleteSLB' => [ - 'summary' => 'Removes a Server Load Balancer (SLB) instance from an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'ModifyBackupPolicy', + 'description' => '> Data backup is supported for ApsaraDB for ClickHouse clusters that run version 20.3, 20.8, or 21.8.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyBackupPolicy'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","type":"json"}]', + ], + 'ModifyDBCluster' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', - 'abilityTreeCode' => '142683', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseZHDS8I', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '19464', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID. You can call the [DescribeDBClusters](~~170879~~) operation to view cluster IDs.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-uf6bnitmve5n0****', - ], + 'schema' => ['title' => '', 'description' => 'The cluster ID.', 'type' => 'string', 'required' => false, 'example' => 'cc-bp19lo45sy98x****'], ], [ - 'name' => 'Product', + 'name' => 'DBNodeGroupCount', 'in' => 'query', - 'schema' => [ - 'type' => 'string', - 'default' => 'clickhouse', - ], + 'schema' => ['description' => 'The number of nodes.'."\n" + ."\n" + .'- For single-replica editions, the valid values are integers from 1 to 48.'."\n" + ."\n" + .'- For dual-replica editions, the valid values are integers from 1 to 24.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '1'], + ], + [ + 'name' => 'DBNodeStorage', + 'in' => 'query', + 'schema' => ['description' => 'The storage space of a single node. Unit: GB.'."\n" + ."\n" + .'Valid values: 100 to 32000.'."\n" + ."\n" + .'> The step size is 100 GB.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '100'], + ], + [ + 'name' => 'DBClusterClass', + 'in' => 'query', + 'schema' => ['description' => 'The cluster specifications.'."\n" + ."\n" + .'- For single-replica editions, valid values are:'."\n" + ."\n" + .' - **S8**'."\n" + ."\n" + .' - **S16**'."\n" + ."\n" + .' - **S32**'."\n" + ."\n" + .' - **S64**'."\n" + ."\n" + .' - **S104**'."\n" + ."\n" + .'- For dual-replica editions, valid values are:'."\n" + ."\n" + .' - **C8**'."\n" + ."\n" + .' - **C16**'."\n" + ."\n" + .' - **C32**'."\n" + ."\n" + .' - **C64**'."\n" + ."\n" + .' - **C104**', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'S8'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the region ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'DbNodeStorageType', + 'in' => 'query', + 'allowEmptyValue' => true, + 'schema' => ['description' => 'The storage class. Valid values:'."\n" + ."\n" + .'- **CloudESSD**: ESSD PL1 disk.'."\n" + ."\n" + .'- **CloudESSD\\_PL2**: ESSD PL2 disk.'."\n" + ."\n" + .'- **CloudESSD\\_PL3**: ESSD PL3 disk.'."\n" + ."\n" + .'- **CloudEfficiency**: ultra disk.'."\n" + ."\n" + .'- **CloudSSD**: standard SSD.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'CloudESSD'], + ], + [ + 'name' => 'DisableWriteWindows', + 'in' => 'query', + 'schema' => ['description' => 'The write-inaccessible window. Separate the start time and the end time with a comma. Use the ISO 8601 format for the time.', 'type' => 'string', 'required' => false, 'docRequired' => false, 'title' => '', 'example' => '2024-07-09T20:00:00+08:00,2024-07-09T21:00:00+08:00'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', + 'DBCluster' => [ + 'description' => 'The cluster.', + 'type' => 'object', + 'properties' => [ + 'dbClusterId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp19lo45sy98x****'], + 'orderId' => ['description' => 'The order ID.', 'type' => 'string', 'title' => '', 'example' => '21417210003****'], + ], + 'title' => '', + 'example' => '', ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'BA30A000-3A4D-5B97-9420-E5D0D49F7016'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], + ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\"\\n}","errorExample":""},{"type":"xml","example":"\\n D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\n","errorExample":""}]', - 'title' => 'DeleteSLB', - 'description' => '## [](#)Description'."\n" - ."\n" - .'After an SLB instance is released, simple load balancing is performed on inbound traffic based on the domain name. The health status of all nodes is no longer checked. As a result, unavailable nodes may fail to be detected, and normal requests may be routed to the unavailable nodes. This causes the failures of some read and write requests.'."\n", - ], - 'ChangeResourceGroup' => [ - 'summary' => '资源转组', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'ModifyDBCluster', + 'summary' => 'Modifies the specifications of a cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBCluster', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DBCluster\\": {\\n \\"dbClusterId\\": \\"cc-bp19lo45sy98x****\\",\\n \\"orderId\\": \\"21417210003****\\"\\n },\\n \\"RequestId\\": \\"BA30A000-3A4D-5B97-9420-E5D0D49F7016\\"\\n}","type":"json"}]', + ], + 'ModifyDBClusterAccessWhiteList' => [ + 'summary' => 'Modifies the IP address whitelist for a specified ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', - 'abilityTreeCode' => '163948', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '19465', + 'abilityTreeNodes' => ['FEATUREclickhouseW0KOAC'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'ResourceId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'title' => '资源Id', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp1i43033051****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1qx68m06981****'], ], [ - 'name' => 'ResourceRegionId', + 'name' => 'SecurityIps', 'in' => 'query', - 'schema' => [ - 'title' => '地域Id', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The IP address whitelist. The following formats are supported:'."\n" + ."\n" + .'- IP address: For example, 192.168.0.1. This allows the specified IP address to access the ApsaraDB for ClickHouse cluster.'."\n" + ."\n" + .'- CIDR block: For example, 192.168.0.0/24. This allows IP addresses from 192.168.0.1 to 192.168.0.255 to access the ApsaraDB for ClickHouse cluster.'."\n" + ."\n" + .'> * Do not enter 0.0.0.0.'."\n" + ."\n" + .'- Set this parameter to 127.0.0.1 to block access from all IP addresses.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '192.168.xx.xx'], ], [ - 'name' => 'ResourceGroupId', + 'name' => 'DBClusterIPArrayName', 'in' => 'query', - 'schema' => [ - 'title' => '目标资源组', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'rg-4690g37929****', - ], + 'schema' => ['description' => 'The name of the whitelist group to modify.'."\n" + ."\n" + .'> If you do not specify this parameter, the whitelist of the default group is modified.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'default'], + ], + [ + 'name' => 'DBClusterIPArrayAttribute', + 'in' => 'query', + 'schema' => ['description' => 'The attribute of the whitelist group. The default value is **empty**.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'NULL'], + ], + [ + 'name' => 'ModifyMode', + 'in' => 'query', + 'schema' => ['description' => 'The modification method. Valid values:'."\n" + ."\n" + .'- **Cover**: Overwrites the whitelist.'."\n" + ."\n" + .'- **Append**: Adds IP addresses to the whitelist.'."\n" + ."\n" + .'- **Delete**: Removes IP addresses from the whitelist.'."\n" + ."\n" + .'> If you do not specify this parameter, the Cover method is used by default.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'Cover'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '', - 'type' => 'string', - 'example' => 'C342F3DD-1FF7-55E9-A1A1-098DE07CD1A2', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'NoPermission.ChangeResourceGroup', - 'errorMessage' => 'You are not authorized to change resourcegroup', - ], - [ - 'errorCode' => 'MissingParameter.ResourceRegionId', - 'errorMessage' => 'The ResourceRegionId parameters that are required for processing this request are missing', - ], - [ - 'errorCode' => 'MissingParameter.ResourceId', - 'errorMessage' => 'The ResourceId parameters that are required for processing this request are missing', - ], - [ - 'errorCode' => 'MissingParameter.ResourceGroupId', - 'errorMessage' => 'The ResourceGroupId parameters that are required for processing this request are missing', - ], - [ - 'errorCode' => 'InvalidResourceGroup', - 'errorMessage' => 'The specified ResourceGroupId is invalid', - ], - [ - 'errorCode' => 'SystemError', - 'errorMessage' => 'A system error occurred while processing your request', - ], - [ - 'errorCode' => 'ResourceNotFound', - 'errorMessage' => ' The specified resource is not found', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C342F3DD-1FF7-55E9-A1A1-098DE07CD1A2\\"\\n}","type":"json"}]', - ], - 'CancelRestartInstance' => [ - 'summary' => 'Cancels the scheduled restart time of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', + 'title' => 'ModifyDBClusterAccessWhiteList', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyDBClusterAccessWhiteList'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBClusterAccessWhiteList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\"\\n}","type":"json"}]', + ], + 'ModifyDBClusterConfig' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', - 'abilityTreeCode' => '173004', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', - ], + 'abilityTreeCode' => '19466', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The ID of the region. You can call the [DescribeRegions](~~170875~~) operation to query the most recent list of regions.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp1t9lbb7a4z7****', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries to return per page. Default value: 30. Valid values:'."\n" - ."\n" - .'* 30'."\n" - .'* 50'."\n" - .'* 100'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', - ], + 'schema' => ['description' => 'The ID of the cluster. You can call the [DescribeDBClusters](~~170879~~) operation to query information about all clusters in a specific region. This information includes the cluster IDs.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1t9lbb7a4z7****'], ], [ - 'name' => 'PageNumber', + 'name' => 'UserConfig', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of pages.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => 'The configuration parameters to modify.'."\n" + ."\n" + .'> You can modify a single configuration parameter. Parameters that are not specified in the request are not affected.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '{"keep_alive_timeout":"301"}'], ], [ - 'name' => 'RestartTime', + 'name' => 'Reason', 'in' => 'query', - 'schema' => [ - 'type' => 'string', - 'required' => false, - ], + 'schema' => ['description' => 'The reason for the modification.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'test'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => 'The returned data.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '', - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F34', - ], + 'RequestId' => ['description' => 'The ID of the request.', 'type' => 'string', 'title' => '', 'example' => 'A9AA1E0A-2AEE-5847-87CF-E4FDC0E66052'], ], + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F34\\"\\n}","errorExample":""},{"type":"xml","example":"\\n F5178C10-1407-4987-9133-DE4DC9119F34\\n","errorExample":""}]', - 'title' => 'CancelRestartInstance', - ], - 'UntagResources' => [ - 'summary' => 'Removes tags from ApsaraDB for ClickHouse clusters.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'ModifyDBClusterConfig', + 'summary' => 'Modifies the configuration of a cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBClusterConfig', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"A9AA1E0A-2AEE-5847-87CF-E4FDC0E66052\\"\\n}","type":"json"}]', + ], + 'ModifyDBClusterConfigInXML' => [ + 'summary' => 'Modifies the configuration parameters of a specified community-compatible ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -10059,104 +8348,43 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '166003', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '153825', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n" - ."\n" - .'> You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'ResourceId', + 'name' => 'DBClusterId', 'in' => 'query', - 'style' => 'repeatList', - 'schema' => [ - 'type' => 'array', - 'items' => [ - 'description' => 'The ID of the cluster from which you want to remove tags. You can remove tags from N clusters. N is an integer. Valid values of N: **1 to 50**.'."\n" - ."\n" - .'> You can call the [DescribeDBClusters](~~170879~~) operation to query the information about all the clusters that are deployed in a specified region, including the cluster IDs.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cc-bp1t9lbb7a4z7****', - ], - 'required' => true, - 'maxItems' => 51, - 'description' => '', - ], + 'schema' => ['description' => 'The cluster ID. Call the [DescribeDBClusters](~~170879~~) operation to query the IDs of all clusters in a region.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'ResourceType', + 'name' => 'Config', 'in' => 'query', - 'schema' => [ - 'description' => 'The type of the resource. Set the value to **CLUSTER**.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'CLUSTER', - ], + 'schema' => ['description' => 'The configuration parameters to modify. Call the [DescribeDBClusterConfigInXML](~~452210~~) operation to query the current configuration parameters. Then, modify the returned parameters.'."\n" + ."\n" + .'> When you modify a parameter, you must include all other configuration parameters in the request. If a parameter is not included, it retains its initial value or the modification fails.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => ' debug 1000M 64 4096 300 100 0 10000 0.9 4194304 0 system query_log
ENGINE = MergeTree PARTITION BY event_date ORDER BY event_time TTL event_time + INTERVAL 15 DAY 7500 system query_thread_log
ENGINE = MergeTree PARTITION BY event_date ORDER BY event_time TTL event_time + INTERVAL 15 DAY 7500 0 0 256 100 1 16 6871947673 3435973836'."\n"], ], [ - 'name' => 'All', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'Specifies whether to remove all tags from the cluster. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false** (default)'."\n" - ."\n" - .'> This parameter is valid only when **TagKey.N** is left empty.'."\n", - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 'schema' => ['description' => 'The region ID. Call the [DescribeRegions](~~170875~~) operation to query available region IDs.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'cn-hangzhou'], ], [ - 'name' => 'TagKey', + 'name' => 'Reason', 'in' => 'query', - 'style' => 'repeatList', - 'schema' => [ - 'type' => 'array', - 'items' => [ - 'description' => 'The key of the tag to remove from the resource. You can remove N tag keys. N is an integer. Valid values of N: **1 to 20**.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'testkey1', - ], - 'required' => false, - 'maxItems' => 21, - 'description' => '', - ], + 'schema' => ['description' => 'The reason for the modification.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'test'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'description' => 'The response schema.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'ABC71772-F3A1-59CA-B811-4A5B0E0B72F8', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'BDD29EB1-BE76-5CFA-9068-D34B696310BF'], ], + 'example' => '', ], ], ], @@ -10164,413 +8392,483 @@ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"ABC71772-F3A1-59CA-B811-4A5B0E0B72F8\\"\\n}","errorExample":""},{"type":"xml","example":"\\n ABC71772-F3A1-59CA-B811-4A5B0E0B72F8\\n","errorExample":""}]', - 'title' => 'UntagResources', - ], - 'TagResources' => [ - 'summary' => 'Creates tags for ApsaraDB for ClickHouse clusters and adds the tags to the ApsaraDB for ClickHouse clusters.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'ModifyDBClusterConfigInXML', + 'description' => '> This operation supports only community-compatible clusters created after December 1, 2021.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBClusterConfigInXML', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"BDD29EB1-BE76-5CFA-9068-D34B696310BF\\"\\n}","type":"json"}]', + ], + 'ModifyDBClusterDescription' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '166002', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '19467', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the region.'."\n" - ."\n" - .'> You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'ResourceId', + 'name' => 'DBClusterDescription', 'in' => 'query', - 'style' => 'repeatList', + 'schema' => ['description' => 'The cluster description. The description must meet the following requirements:'."\n" + ."\n" + .'- It cannot start with http\\:// or https\\://.'."\n" + ."\n" + .'- It must be 2 to 256 characters in length.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'ClusterDescriptionTest'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'type' => 'array', - 'items' => [ - 'description' => 'The ID of the cluster to which you want to add tags. You can add tags to N clusters. N is an integer. Valid values of N: **1 to 50**.'."\n" - ."\n" - .'> You can call the [DescribeDBClusters](~~170879~~) operation to query the information about all the clusters that are deployed in a specified region, including the cluster IDs.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cc-bp1t9lbb7a4z7****', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0'], ], - 'required' => true, - 'maxItems' => 51, 'description' => '', + 'title' => '', + 'example' => '', + ], + ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'ModifyDBClusterDescription', + 'summary' => 'Changes the description of a specified ApsaraDB for ClickHouse cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBClusterDescription', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","type":"json"}]', + ], + 'ModifyDBClusterMaintainTime' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'ResourceType', + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'abilityTreeCode' => '19468', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The type of the resource. Set the value to **CLUSTER**.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'CLUSTER', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'Tag', + 'name' => 'MaintainTime', 'in' => 'query', - 'style' => 'repeatList', - 'schema' => [ - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => 'The key of the tag to add to the resource. You can add N tag keys. N is an integer. Valid values of N: **1 to 20**.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'testkey1', - ], - 'Value' => [ - 'description' => 'The value of the tag to add to the resource. You can add N tag values. N is an integer. Valid values of N: **1 to 20**.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'testvalue1', - ], - ], - 'required' => false, - 'description' => '', - ], - 'required' => true, - 'maxItems' => 21, - 'description' => '', - ], + 'schema' => ['description' => 'The maintenance window of the cluster. The format is HH:mmZ-HH:mmZ.'."\n" + ."\n" + .'Example: 00:00Z-01:00Z. This means that routine maintenance can be performed from 00:00 to 01:00 (UTC), which is 08:00 to 09:00 (UTC+8).'."\n" + ."\n" + .'> The maintenance window must start on the hour and last for one hour.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '00:00Z-01:00Z'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '863D51B7-5321-41D8-A0B6-A088B0450EFD', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], + ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"863D51B7-5321-41D8-A0B6-A088B0450EFD\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 863D51B7-5321-41D8-A0B6-A088B0450EFD\\n","errorExample":""}]', - 'title' => 'TagResources', - ], - 'ListTagResources' => [ - 'summary' => 'Queries the tags that are added to ApsaraDB for ClickHouse clusters.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'ModifyDBClusterMaintainTime', + 'summary' => 'Modifies the maintenance window for a specified ApsaraDB for ClickHouse cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyDBClusterMaintainTime'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBClusterMaintainTime', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\"\\n}","type":"json"}]', + ], + 'ModifyDBConfig' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', - 'abilityTreeCode' => '166149', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '19469', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n" - ."\n" - .'> You can call the [DescribeRegions](~~170875~~) operation to query the most recent region list.'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The ID of the region. Call the [DescribeRegions](~~170875~~) operation to query the IDs of available regions.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ - 'name' => 'ResourceType', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'The type of the resource. Set the value to **CLUSTER**.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'CLUSTER', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1r59y779o04****'], ], [ - 'name' => 'NextToken', + 'name' => 'Config', 'in' => 'query', + 'schema' => ['description' => 'The dictionary configuration items.'."\n" + ."\n" + .'> The value of the Config parameter overwrites the existing configuration. To delete a dictionary configuration, remove it from the request.'."\n" + ."\n" + .'Call the [DescribeDBConfig](~~2360627~~) operation to query the dictionary configuration of the target instance.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'title' => '', 'example' => 'test_dictionary10.0.0.03003TestUsertestPassworddefaultdictTestTable01
active=1SELECT max(value) FROM dictTestTable01200600idUInt64valueString'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The pagination token that is used in the next request to retrieve a new page of results. You do not need to specify this parameter for the first request. You must specify the token that is obtained from the previous query as the value of NextToken.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '212db86sca4384811e0b5e8707ec21345', + 'description' => 'The response data.', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'BF3844B6-1B12-57A0-A259-476D2079EE83'], + ], + 'title' => '', + 'example' => '', ], ], - [ - 'name' => 'ResourceId', - 'in' => 'query', - 'style' => 'repeatList', - 'schema' => [ - 'type' => 'array', - 'items' => [ - 'description' => 'The cluster ID. You can specify N cluster IDs at a time. N is an integer. Valid values of N: **1 to 50**.'."\n" - ."\n" - .'> '."\n" - ."\n" - .'* You can call the [DescribeDBClusters](~~170879~~) operation to query the information about all the clusters that are deployed in a specified region, including the cluster IDs.'."\n" - ."\n" - .'* If you specify **Tag.N.Key**, this parameter can be left empty.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cc-bp1t9lbb7a4z7****', + ], + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'ModifyDBConfig', + 'summary' => 'The ModifyDBConfig operation modifies the dictionary configuration of a community-compatible cluster.', + 'description' => '>'."\n" + ."\n" + .'This API applies only to clusters with a kernel version of 20.8 or earlier.'."\n" + ."\n" + .'>', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBConfig', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], - 'required' => false, - 'maxItems' => 51, - 'description' => '', ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"BF3844B6-1B12-57A0-A259-476D2079EE83\\"\\n}","type":"json"}]', + ], + 'ModifyMinorVersionGreadeType' => [ + 'summary' => 'Modifies the upgrade type for a ClickHouse minor version to automatic or manual.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'abilityTreeCode' => '147864', + 'abilityTreeNodes' => ['FEATUREclickhouseN0HBPQ'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1qx68m06981****'], + ], [ - 'name' => 'Tag', + 'name' => 'MaintainAutoType', 'in' => 'query', - 'style' => 'repeatList', - 'schema' => [ - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => 'The key of the tag that is added to the resource. You can specify N tag keys at a time. N is an integer. Valid values of N: **1 to 20**.'."\n" - ."\n" - .'> If you specify **ResourceId.N**, this parameter can be left empty.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'testkey1', - ], - 'Value' => [ - 'description' => 'The value of the tag that is added to the resource. You can specify N tag values at a time. N is an integer. Valid values of N: **1 to 20**.'."\n" - ."\n" - .'> This parameter can be left empty.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'testvalue1', - ], - ], - 'required' => false, - 'description' => '', - ], - 'required' => false, - 'maxItems' => 21, - 'description' => '', - ], + 'schema' => ['description' => 'The upgrade type. Set this parameter to **false** for manual upgrades.', 'type' => 'boolean', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'false'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '184DE106-CB2C-4DD2-B57F-396652E6C8F8', - ], - 'NextToken' => [ - 'description' => 'A pagination token. It can be used in the next request to retrieve a new page of results. If not all results are returned in one query, you can pass in the NextToken value returned for the query to perform the next query.'."\n", - 'type' => 'string', - 'example' => '212db86sca4384811e0b5e8707ec21345', - ], - 'TagResources' => [ - 'description' => 'The tags that are added to clusters.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'TagValue' => [ - 'description' => 'The value of the tag that is added to the resource.'."\n", - 'type' => 'string', - 'example' => 'testvalue1', - ], - 'TagKey' => [ - 'description' => 'The key of the tag that is added to the resource.'."\n", - 'type' => 'string', - 'example' => 'testkey1', - ], - 'ResourceType' => [ - 'description' => 'The type of the resource. Only **CLUSTER** is returned.'."\n", - 'type' => 'string', - 'example' => 'CLUSTER', - ], - 'ResourceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp1t9lbb7a4z7****', - ], - ], - 'description' => '', - ], - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], + ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"184DE106-CB2C-4DD2-B57F-396652E6C8F8\\",\\n \\"NextToken\\": \\"212db86sca4384811e0b5e8707ec21345\\",\\n \\"TagResources\\": [\\n {\\n \\"TagValue\\": \\"testvalue1\\",\\n \\"TagKey\\": \\"testkey1\\",\\n \\"ResourceType\\": \\"DBCLUSTER\\",\\n \\"ResourceId\\": \\"cc-bp1t9lbb7a4z7****\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 184DE106-CB2C-4DD2-B57F-396652E6C8F8\\n 212db86sca4384811e0b5e8707ec21345\\n \\n testvalue1\\n testkey1\\n CLUSTER\\n cc-bp1t9lbb7a4z7****\\n \\n","errorExample":""}]', - 'title' => 'ListTagResources', - ], - 'DeleteBackupPolicy' => [ - 'summary' => '删除备份策略', - 'methods' => [ - 'post', - 'get', + 'title' => 'ModifyMinorVersionGreadeType', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyMinorVersionGreadeType'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyMinorVersionGreadeType', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\"\\n}","type":"json"}]', + ], + 'ModifyRDSToClickhouseDb' => [ + 'summary' => 'Modifies the sync task of a community-compatible ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', - 'abilityTreeCode' => '173183', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseYFBZ0B', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '47742', + 'abilityTreeNodes' => ['FEATUREclickhouseZ93UXU'], ], 'parameters' => [ [ - 'name' => 'MaxResults', + 'name' => 'DbClusterId', 'in' => 'query', - 'allowEmptyValue' => true, - 'schema' => [ - 'title' => '本次读取的最大数据记录数量', - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - ], + 'schema' => ['description' => 'The ID of the ApsaraDB for ClickHouse cluster.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp158i5wvj436****'], ], [ - 'name' => 'ClientToken', + 'name' => 'ClickhousePort', 'in' => 'query', - 'allowEmptyValue' => false, - 'schema' => [ - 'title' => '幂等参数', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'ETnLKlblzczshOTUbOCz****', - ], + 'schema' => ['description' => 'The port number of the ApsaraDB for ClickHouse cluster.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'title' => '', 'example' => '8123'], ], [ - 'name' => 'DBClusterId', + 'name' => 'CkUserName', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'cc-bp1t9lbb7a4z7****', - ], + 'schema' => ['description' => 'The database account of the ApsaraDB for ClickHouse cluster.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'user1'], ], [ - 'name' => 'Product', + 'name' => 'CkPassword', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'clickhouse', - 'default' => 'clickhouse', - ], + 'schema' => ['description' => 'The password of the ApsaraDB for ClickHouse database account.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => '123456Aa'], + ], + [ + 'name' => 'RdsId', + 'in' => 'query', + 'schema' => ['description' => 'The instance ID of the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'rm-uf6x3qq4t90ok****'], + ], + [ + 'name' => 'RdsPort', + 'in' => 'query', + 'schema' => ['description' => 'The port number of the ApsaraDB RDS for MySQL instance.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'title' => '', 'example' => '3306'], + ], + [ + 'name' => 'RdsVpcId', + 'in' => 'query', + 'schema' => ['description' => 'The VPC ID of the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'vpc-bp1v9dtwmqqjhwwg****'], + ], + [ + 'name' => 'RdsUserName', + 'in' => 'query', + 'schema' => ['description' => 'The database account of the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'user2'], + ], + [ + 'name' => 'RdsPassword', + 'in' => 'query', + 'schema' => ['description' => 'The password of the ApsaraDB RDS for MySQL database account.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => '123456Rr'], + ], + [ + 'name' => 'SkipUnsupported', + 'in' => 'query', + 'schema' => ['description' => 'Specifies whether to ignore databases that do not support synchronization. Valid values:'."\n" + ."\n" + .'- **true**: Ignore the databases.'."\n" + ."\n" + .'- **false**: Do not ignore the databases.', 'type' => 'boolean', 'required' => true, 'title' => '', 'example' => 'true'], + ], + [ + 'name' => 'LimitUpper', + 'in' => 'query', + 'schema' => ['description' => 'The maximum number of rows to sync per second.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'title' => '', 'example' => '50000'], + ], + [ + 'name' => 'RdsSynTables', + 'in' => 'query', + 'schema' => ['description' => 'The tables in the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'table'], + ], + [ + 'name' => 'RdsSynDb', + 'in' => 'query', + 'schema' => ['description' => 'The database in the ApsaraDB RDS for MySQL instance.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'database'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => 'The returned result.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F34', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '746CD303-0B82-5E8D-886D-93A9FAF3A876'], + 'Status' => ['description' => 'Indicates whether the modification was successful. Valid values:'."\n" + ."\n" + .'- **1**: The modification was successful.'."\n" + ."\n" + .'- **0**: The modification failed.', 'type' => 'integer', 'format' => 'int64', 'title' => '', 'example' => '1'], + 'ErrorMsg' => ['description' => '- This parameter is not returned if **Status** is **1**.'."\n" + ."\n" + .'- If **Status** is **0**, this parameter indicates the reason why the modification failed.', 'type' => 'string', 'title' => '', 'example' => 'ClickHouse exception, code: 49, host: 100.100.118.132, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n'], + 'ErrorCode' => ['description' => 'The error code.', 'type' => 'integer', 'format' => 'int64', 'title' => '', 'example' => '0'], ], + 'title' => '', + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F34\\"\\n}","errorExample":""},{"type":"xml","example":"\\n F5178C10-1407-4987-9133-DE4DC9119F34\\n","errorExample":""}]', - ], - 'ModifyActiveOperationTasks' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'ModifyRDSToClickhouseDb', + 'description' => '> This operation applies only to community-compatible ApsaraDB for ClickHouse clusters.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyRDSToClickhouseDb'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyRDSToClickhouseDb', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"746CD303-0B82-5E8D-886D-93A9FAF3A876\\",\\n \\"Status\\": 1,\\n \\"ErrorMsg\\": \\"ClickHouse exception, code: 49, host: 100.100.118.132, port: 49670; Code: 49, e.displayText() = DB::Exception: Logical error: there is no global context (version 20.8.17.25)n\\",\\n \\"ErrorCode\\": 0\\n}","type":"json"}]', + ], + 'ReleaseClusterPublicConnection' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -10580,45 +8878,15 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', - 'abilityTreeCode' => '201218', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', - ], - 'tenantRelevance' => 'publicInformation', + 'abilityTreeCode' => '19472', + 'abilityTreeNodes' => ['FEATUREclickhouseZHDS8I'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'Ids', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '188****,188****,188****', - ], - ], - [ - 'name' => 'SwitchTime', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2023-01-09T05:00:00Z', - ], - ], - [ - 'name' => 'ImmediateStart', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '0', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], ], 'responses' => [ @@ -10626,135 +8894,133 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'Ids' => [ - 'description' => '', - 'type' => 'string', - 'example' => '188****,188****,188****', - ], - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => '617242AA-04D8-5AF0-8C0C-6E53DDA8C3C3', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], + ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Ids\\": \\"188****,188****,188****\\",\\n \\"RequestId\\": \\"617242AA-04D8-5AF0-8C0C-6E53DDA8C3C3\\"\\n}","type":"json"}]', - ], - 'DescribeEventMetaInfo' => [ - 'summary' => 'DescribeEventMetaInfo', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'ReleaseClusterPublicConnection', + 'summary' => 'Releases the public endpoint of a specified ApsaraDB for ClickHouse cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ReleaseClusterPublicConnection'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ReleaseClusterPublicConnection', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\"\\n}","type":"json"}]', + ], + 'ResetAccountPassword' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '201222', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseMCDGZK', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '19473', + 'abilityTreeNodes' => ['FEATUREclickhouse2H8YOY'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'allowEmptyValue' => false, - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-beijing', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'SourceCode', + 'name' => 'AccountName', 'in' => 'query', - 'allowEmptyValue' => false, - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => 'Event.EventCode', - ], + 'schema' => ['description' => 'The database account.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'test'], + ], + [ + 'name' => 'AccountPassword', + 'in' => 'query', + 'schema' => ['description' => 'The new password for the database account.'."\n" + ."\n" + .'> - The password must contain characters from at least three of the following types: uppercase letters, lowercase letters, digits, and special characters.'."\n" + ."\n" + .'- The special characters are !@#$%^&\\*()\\_+-='."\n" + ."\n" + .'- The password must be 8 to 32 characters in length.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '123456Ff'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => '94F92113-FF63-5E57-8401-6FE123AD11DD', - ], - 'Items' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Code' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'Running', - ], - 'SourceCode' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'Task.TaskStatus', - ], - ], - ], - ], - 'TotalCount' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'ResetAccountPassword', + 'summary' => 'Resets the password of a database account in a specified ApsaraDB for ClickHouse cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ResetAccountPassword'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ResetAccountPassword', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"94F92113-FF63-5E57-8401-6FE123AD11DD\\",\\n \\"Items\\": [\\n {\\n \\"Code\\": \\"Running\\",\\n \\"SourceCode\\": \\"Task.TaskStatus\\"\\n }\\n ],\\n \\"TotalCount\\": 1\\n}","type":"json"}]', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","type":"json"}]', ], - 'DescribeActiveOperationTasks' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'RestartInstance' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -10763,369 +9029,156 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '201217', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseMCDGZK', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '38056', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], ], 'parameters' => [ [ - 'name' => 'Region', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => 'cn-beijing', - ], + 'schema' => ['description' => 'The region ID. Call the [DescribeRegions](~~170875~~) operation to query available region IDs.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ - 'name' => 'TaskType', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => 'all', - ], + 'schema' => ['description' => 'The cluster ID. Call the [DescribeDBClusters](~~170879~~) operation to query information about all clusters in the destination region, including cluster IDs.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '10', - 'example' => '30', - 'default' => '30', - ], + 'schema' => ['description' => 'The number of entries per page. Valid values:'."\n" + ."\n" + .'- 30 (default)'."\n" + ."\n" + .'- 50'."\n" + ."\n" + .'- 100', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '30', 'title' => '', 'example' => '30'], ], [ 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], - ], - [ - 'name' => 'ProductId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'clickhouse', - ], - ], - [ - 'name' => 'DbType', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [], - 'example' => 'clickhouse', - ], - ], - [ - 'name' => 'Status', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '-1', - ], - ], - [ - 'name' => 'InsName', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'cc-bp191w*******', - ], - ], - [ - 'name' => 'AllowChange', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '-1', - ], - ], - [ - 'name' => 'AllowCancel', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '-1', - ], + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'title' => '', 'example' => '1'], ], [ - 'name' => 'ChangeLevel', + 'name' => 'RestartTime', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'all', - ], + 'allowEmptyValue' => true, + 'schema' => ['description' => 'The scheduled restart time. The time must be in the yyyy-MM-ddTHH:mmZ format and in UTC.'."\n" + ."\n" + .'> If this parameter is empty or specifies a time earlier than the current time, the cluster is restarted immediately.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => '2023-03-22T00:00:50Z'], ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ - 'PageNumber' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F76', - ], - 'PageSize' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'TotalRecordCount' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'Items' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Status' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'ChangeLevelEn' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'S1', - ], - 'TaskType' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'rds_apsaradb_upgrade', - ], - 'InsName' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'cc-bp191w*******'."\n", - ], - 'Region' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'cn-beijing', - ], - 'ImpactZh' => [ - 'description' => '', - 'type' => 'string', - 'example' => '', - ], - 'CreatedTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2018-05-30T14:30:00Z'."\n", - ], - 'SwitchTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2018-05-30T14:30:00Z'."\n", - ], - 'ChangeLevelZh' => [ - 'description' => '', - 'type' => 'string', - 'example' => '', - ], - 'Deadline' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2018-05-30T23:59:59Z'."\n", - ], - 'PrepareInterval' => [ - 'description' => '', - 'type' => 'string', - 'example' => '04:00:00'."\n", - ], - 'Impact' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'TransientDisconnection'."\n", - ], - 'TaskTypeZh' => [ - 'description' => '', - 'type' => 'string', - 'example' => '', - ], - 'CurrentAVZ' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'cn-beijing-h'."\n", - ], - 'AllowChange' => [ - 'description' => '', - 'type' => 'string', - 'example' => '-1', - ], - 'DbVersion' => [ - 'description' => '', - 'type' => 'string', - 'example' => '23.8', - ], - 'ImpactEn' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'Transient instance disconnection'."\n", - ], - 'InsComment' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'test', - ], - 'StartTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2025-04-22T01:06Z', - ], - 'ModifiedTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2023-11-15T06:17:54Z', - ], - 'AllowCancel' => [ - 'description' => '', - 'type' => 'string', - 'example' => '-1', - ], - 'DbType' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'clickhouse', - ], - 'ChangeLevel' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'S1', - ], - 'TaskTypeEn' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'Minor version update'."\n", - ], - 'ResultInfo' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'userCancel', - ], - 'Id' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '11', - ], - 'SubInsNames' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'string', - 'example' => '1', - ], - ], - 'TaskParams' => [ - 'description' => '', - 'type' => 'string', - 'example' => '{'."\n" - .' "Action": "UpgradeDBInstance"'."\n" - .'}', - ], - ], - ], - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PageNumber\\": 1,\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F76\\",\\n \\"PageSize\\": 30,\\n \\"TotalRecordCount\\": 1,\\n \\"Items\\": [\\n {\\n \\"Status\\": 2,\\n \\"ChangeLevelEn\\": \\"S1\\",\\n \\"TaskType\\": \\"rds_apsaradb_upgrade\\",\\n \\"InsName\\": \\"cc-bp191w*******\\\\n\\",\\n \\"Region\\": \\"cn-beijing\\",\\n \\"ImpactZh\\": \\"实例闪断。\\",\\n \\"CreatedTime\\": \\"2018-05-30T14:30:00Z\\\\n\\",\\n \\"SwitchTime\\": \\"2018-05-30T14:30:00Z\\\\n\\",\\n \\"ChangeLevelZh\\": \\"系统运维\\\\n\\",\\n \\"Deadline\\": \\"2018-05-30T23:59:59Z\\\\n\\",\\n \\"PrepareInterval\\": \\"04:00:00\\\\n\\",\\n \\"Impact\\": \\"TransientDisconnection\\\\n\\",\\n \\"TaskTypeZh\\": \\"小版本升级\\\\n\\",\\n \\"CurrentAVZ\\": \\"cn-beijing-h\\\\n\\",\\n \\"AllowChange\\": \\"-1\\",\\n \\"DbVersion\\": \\"23.8\\",\\n \\"ImpactEn\\": \\"Transient instance disconnection\\\\n\\",\\n \\"InsComment\\": \\"test\\",\\n \\"StartTime\\": \\"2025-04-22T01:06Z\\",\\n \\"ModifiedTime\\": \\"2023-11-15T06:17:54Z\\",\\n \\"AllowCancel\\": \\"-1\\",\\n \\"DbType\\": \\"clickhouse\\",\\n \\"ChangeLevel\\": \\"S1\\",\\n \\"TaskTypeEn\\": \\"Minor version update\\\\n\\",\\n \\"ResultInfo\\": \\"userCancel\\",\\n \\"Id\\": 11,\\n \\"SubInsNames\\": [\\n \\"1\\"\\n ],\\n \\"TaskParams\\": \\"{\\\\n \\\\\\"Action\\\\\\": \\\\\\"UpgradeDBInstance\\\\\\"\\\\n}\\"\\n }\\n ]\\n}","type":"json"}]', - ], - 'CancelActiveOperationTasks' => [ - 'summary' => '取消运维事件任务', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'RestartInstance', + 'summary' => 'Restarts a specified ApsaraDB for ClickHouse cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:RestartInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","type":"json"}]', + ], + 'RestartInstanceNodeList' => [ + 'summary' => 'Batch restart nodes of a ClickHouse Community-compatible Edition instance.', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', - 'abilityTreeCode' => '201219', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', - ], - 'tenantRelevance' => 'publicInformation', + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '173004', + 'abilityTreeNodes' => ['FEATUREclickhouseXSQ0JG'], ], 'parameters' => [ [ - 'name' => 'Ids', + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cc-bp108z124a8o7****', 'title' => ''], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => 'The number of entries to return on each page. Valid values:'."\n" + ."\n" + .'- **30** (default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '30', 'example' => '30', 'title' => ''], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'example' => '1', 'title' => ''], + ], + [ + 'name' => 'RestartTime', + 'in' => 'query', + 'schema' => ['description' => 'The scheduled restart time. The time is in the yyyy-MM-ddTHH:mmZ format and is in UTC.'."\n" + ."\n" + .'> If this parameter is left empty or set to a time earlier than the current time, the cluster restarts immediately.', 'type' => 'string', 'required' => false, 'example' => '2023-03-22T00:00:50Z', 'title' => ''], + ], + [ + 'name' => 'NodeList', 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '188****,188****,188****'."\n", + 'type' => 'array', + 'items' => ['description' => 'The name of the node to restart.', 'type' => 'string', 'required' => false, 'example' => 'ck-uf6*****-2**-clickhouse-s-0-r-0', 'title' => ''], + 'description' => 'The list of nodes to restart.', + 'required' => false, + 'title' => '', + 'example' => '', ], ], ], @@ -11134,204 +9187,139 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'Ids' => [ - 'description' => '', - 'type' => 'string', - 'example' => '188****,188****,188****'."\n", - ], - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => '94F92113-FF63-5E57-8401-6FE123AD11DD', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '36E3AB2E-E0DA-5C7B-8E29-89EE44926515'], ], + 'title' => '', + 'description' => 'Schema of response.', + 'example' => '', ], ], ], + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Ids\\": \\"188****,188****,188****\\\\n\\",\\n \\"RequestId\\": \\"94F92113-FF63-5E57-8401-6FE123AD11DD\\"\\n}","type":"json"}]', - ], - 'DescribeActiveOperationMaintainConf' => [ - 'summary' => '主动运维', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'RestartInstanceNodeList', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'security' => [ + 'ramActions' => [ [ - 'AK' => [], - ], - ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', - ], - ], - 'parameters' => [], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'HasConfig' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => '9A23C87D-87DF-4DA0-A50E-CB13F4F7923D', - ], - 'Config' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'CycleType' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'Week', - ], - 'Status' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'ModifiedTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2025-06-27T07:12:53Z', - ], - 'MaintainStartTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '18:00Z', - ], - 'MaintainEndTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '22:00Z', - ], - 'CycleTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '1', - ], - 'CreatedTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2025-03-18T06:51:11+08:00', - ], - ], - ], + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:RestartInstanceNodeList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HasConfig\\": 1,\\n \\"RequestId\\": \\"9A23C87D-87DF-4DA0-A50E-CB13F4F7923D\\",\\n \\"Config\\": {\\n \\"CycleType\\": \\"Week\\",\\n \\"Status\\": 1,\\n \\"ModifiedTime\\": \\"2025-06-27T07:12:53Z\\",\\n \\"MaintainStartTime\\": \\"18:00Z\\",\\n \\"MaintainEndTime\\": \\"22:00Z\\",\\n \\"CycleTime\\": \\"1\\",\\n \\"CreatedTime\\": \\"2025-03-18T06:51:11+08:00\\"\\n }\\n}","type":"json"}]', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"36E3AB2E-E0DA-5C7B-8E29-89EE44926515\\"\\n}","type":"json"}]', ], - 'ModifyActiveOperationMaintainConf' => [ - 'summary' => '修改主动运维设置', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'TagResources' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', - 'tenantRelevance' => 'publicInformation', + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '166002', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ - 'name' => 'CycleType', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'Week', - ], - ], - [ - 'name' => 'CycleTime', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['description' => 'The region ID.'."\n" + ."\n" + .'> Call the [DescribeRegions](~~170875~~) operation to query region IDs.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'MaintainStartTime', + 'name' => 'ResourceId', 'in' => 'query', + 'style' => 'repeatList', 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => '07:00Z', + 'type' => 'array', + 'items' => ['description' => ''."\n" + ."\n" + .'The ID of the ApsaraDB for ClickHouse Community-compatible Edition cluster to which you want to attach tags. You can specify up to **50** cluster IDs.'."\n" + ."\n" + .''."\n" + ."\n" + .''."\n" + ."\n" + .'The ID of the cluster to which you want to attach tags. You can specify up to **50** cluster IDs.'."\n" + ."\n" + .''."\n" + ."\n" + .'> Call the [DescribeDBClusters](~~170879~~) operation to query information about all clusters in the destination region, including cluster IDs.', 'type' => 'string', 'required' => false, 'example' => 'cc-bp1t9lbb7a4z7****', 'title' => ''], + 'required' => true, + 'maxItems' => 51, + 'description' => 'The resource ID.', + 'title' => '', + 'example' => '', ], ], [ - 'name' => 'MaintainEndTime', + 'name' => 'ResourceType', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => '20:00Z', - ], + 'schema' => ['description' => 'The resource type. The value must be **DBCLUSTER**.', 'type' => 'string', 'required' => true, 'example' => 'DBCLUSTER', 'title' => ''], ], [ - 'name' => 'Status', + 'name' => 'Tag', 'in' => 'query', + 'style' => 'repeatList', 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'enumValueTitles' => [], - 'example' => '1', - 'enum' => [ - '1', - '2', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => 'The tag key. You can add up to **20** tag keys.', 'type' => 'string', 'required' => false, 'example' => 'testkey1', 'title' => ''], + 'Value' => ['description' => 'The value of the tag key. You can add up to **20** tag values.', 'type' => 'string', 'required' => false, 'example' => 'testvalue1', 'title' => ''], + ], + 'required' => false, + 'description' => 'The custom tag.', + 'title' => '', + 'example' => '', ], + 'required' => true, + 'maxItems' => 21, + 'description' => 'The list of tags.', + 'title' => '', + 'example' => '', ], ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => '863D51B7-5321-41D8-A0B6-A088B0450EFD'], ], + 'example' => '', ], ], ], @@ -11339,17 +9327,18 @@ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","type":"json"}]', - ], - 'DescribeAutoRenewAttribute' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'TagResources', + 'summary' => 'Creates and attaches tags to one or more ApsaraDB for ClickHouse clusters.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"863D51B7-5321-41D8-A0B6-A088B0450EFD\\"\\n}","type":"json"}]', + ], + 'TransferVersion' => [ + 'methods' => ['post', 'get', 'put'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -11358,58 +9347,79 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '209424', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '36417', + 'abilityTreeNodes' => ['FEATUREclickhouse07PB80'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-beijing', - ], + 'schema' => ['description' => 'The ID of the region. Call the [DescribeRegions](~~170875~~) operation to query the most recent list of regions.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DBClusterIds', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'cc-uf6g4417bo*****', - ], + 'schema' => ['description' => 'The ID of the source cluster.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp1tm8zf130ew****'], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', - ], + 'schema' => ['description' => 'The number of entries to return on each page. Valid values:'."\n" + ."\n" + .'- **30** (Default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '30', 'title' => '', 'example' => '30'], ], [ 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'default' => '1', 'title' => '', 'example' => '1'], + ], + [ + 'name' => 'TargetDbClusterId', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the destination cluster.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-bp14b39djx7zg****'], + ], + [ + 'name' => 'SourceAccount', + 'in' => 'query', + 'schema' => ['description' => 'The source account.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'test'], + ], + [ + 'name' => 'TargetAccount', + 'in' => 'query', + 'schema' => ['description' => 'The destination account.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'test01'], + ], + [ + 'name' => 'SourcePassword', + 'in' => 'query', + 'schema' => ['description' => 'The password of the source account.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => '123456Aa'], + ], + [ + 'name' => 'TargetPassword', + 'in' => 'query', + 'schema' => ['description' => 'The password of the destination account.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => '123456Ff'], + ], + [ + 'name' => 'DisableWriteWindows', + 'in' => 'query', + 'schema' => ['description' => 'The time windows during which writes are disabled.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => '2025-02-08T00:00:00+08:00,2025-02-12T00:00:00+08:00'], + ], + [ + 'name' => 'SourceClusterName', + 'in' => 'query', + 'schema' => ['description' => 'The name of the self-managed ClickHouse cluster.'."\n" + .'To obtain the name, execute `SELECT * FROM system.clusters`.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'default'], + ], + [ + 'name' => 'SourceShards', + 'in' => 'query', + 'schema' => ['description' => 'The addresses and TCP ports of the shards in the self-managed ClickHouse cluster.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => '192.168.0.4:9000,192.168.0.5:9000,192.168.0.6:9000'], ], ], 'responses' => [ @@ -11417,239 +9427,208 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E*******', - ], - 'PageNumber' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageRecordCount' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'TotalRecordCount' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '51', - ], - 'Items' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'AutoRenewAttribute' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'DBClusterId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'cc-2ze57pg09*****', - ], - 'PeriodUnit' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'Year', - ], - 'Duration' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'RenewalStatus' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'AutoRenewal', - ], - 'AutoRenewEnabled' => [ - 'description' => '', - 'type' => 'boolean', - ], - 'RegionId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'cn-beijing', - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => '7084CDB5-308F-5D0B-8F9B-5F7D83E09738'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => 'An error occurred while processing your request.'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E*******\\",\\n \\"PageNumber\\": 1,\\n \\"PageRecordCount\\": 5,\\n \\"TotalRecordCount\\": 51,\\n \\"Items\\": {\\n \\"AutoRenewAttribute\\": [\\n {\\n \\"DBClusterId\\": \\"cc-2ze57pg09*****\\",\\n \\"PeriodUnit\\": \\"Year\\",\\n \\"Duration\\": 1,\\n \\"RenewalStatus\\": \\"AutoRenewal\\",\\n \\"AutoRenewEnabled\\": true,\\n \\"RegionId\\": \\"cn-beijing\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - ], - 'ModifyAutoRenewAttribute' => [ - 'methods' => [ - 'post', - 'get', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'schemes' => [ - 'http', - 'https', + 'title' => 'TransferVersion', + 'summary' => 'Migration between versions.', + 'description' => '## Prerequisites'."\n" + ."\n" + .'- Add the IP addresses of the source cluster to the whitelist of the destination cluster.'."\n" + ."\n" + .'- Add the IP addresses of the destination cluster to the whitelist of the source cluster.'."\n" + ."\n" + .'> You can execute the `select * from system.clusters;` statement to retrieve the IP addresses of an ApsaraDB for ClickHouse cluster.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:TransferVersion', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7084CDB5-308F-5D0B-8F9B-5F7D83E09738\\"\\n}","type":"json"}]', + ], + 'UntagResources' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', - 'riskType' => 'high', - 'chargeType' => 'paid', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '166003', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ - 'name' => 'DBClusterIds', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp1uy5ff6*****', - ], + 'schema' => ['description' => 'The region ID.'."\n" + ."\n" + .'> Call the [DescribeRegions](~~170875~~) operation to query region IDs.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'RegionId', + 'name' => 'ResourceId', 'in' => 'query', + 'style' => 'repeatList', 'schema' => [ - 'description' => '', - 'type' => 'string', + 'type' => 'array', + 'items' => ['description' => ''."\n" + ."\n" + .'The ID of the cluster from which you want to remove tags. You can specify from **1** to **50** cluster IDs.'."\n" + ."\n" + .''."\n" + ."\n" + .''."\n" + ."\n" + .'The ID of the cluster from which to remove tags. You can remove tags from N clusters, where N is an integer that ranges from **1 to 50**.'."\n" + ."\n" + .''."\n" + ."\n" + .'> Call the [DescribeDBClusters](~~170879~~) operation to query information about all clusters in the destination region, including cluster IDs.', 'type' => 'string', 'required' => false, 'example' => 'cc-bp1t9lbb7a4z7****', 'title' => ''], 'required' => true, - 'example' => 'cn-beijing', + 'maxItems' => 51, + 'description' => 'The resource ID.', + 'title' => '', + 'example' => '', ], ], [ - 'name' => 'RenewalStatus', + 'name' => 'ResourceType', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'AutoRenewal', - 'default' => 'AutoRenewal', - ], + 'schema' => ['description' => 'The resource type. Set the value to **DBCLUSTER**.', 'type' => 'string', 'required' => true, 'example' => 'DBCLUSTER', 'title' => ''], ], [ - 'name' => 'Duration', + 'name' => 'All', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => 'Specifies whether to remove all tags from the cluster. Valid values:'."\n" + ."\n" + .'- **true**'."\n" + ."\n" + .'- **false** (default)'."\n" + ."\n" + .'> This parameter is valid only when the **TagKey.N** parameter is empty.', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'title' => ''], ], [ - 'name' => 'PeriodUnit', + 'name' => 'TagKey', 'in' => 'query', + 'style' => 'repeatList', 'schema' => [ - 'description' => '', - 'type' => 'string', + 'type' => 'array', + 'items' => ['description' => 'The tag key. You can specify from 1 to **20** tag keys.', 'type' => 'string', 'required' => false, 'example' => 'testkey1', 'title' => ''], 'required' => false, - 'example' => 'Year', - 'default' => 'Month', + 'maxItems' => 21, + 'description' => 'The tag key.', + 'title' => '', + 'example' => '', ], ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'The response parameters.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => '7B94AB34-6875-56D2-92B4-0C2******', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'ABC71772-F3A1-59CA-B811-4A5B0E0B72F8'], ], + 'example' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => 'UntagResources', + 'summary' => 'Removes tags from ApsaraDB for ClickHouse clusters.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7B94AB34-6875-56D2-92B4-0C2******\\"\\n}","type":"json"}]', + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"ABC71772-F3A1-59CA-B811-4A5B0E0B72F8\\"\\n}","type":"json"}]', ], - 'DescribeUserEncryptionKeyList' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'UpgradeMinorVersion' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '220406', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseY04H6E', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '147860', + 'abilityTreeNodes' => ['FEATUREclickhouseN0HBPQ'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'cc-bp108z124a8o7****'], ], [ - 'name' => 'PageNumber', + 'name' => 'UpgradeImmediately', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['description' => 'Specifies whether to upgrade the minor engine version immediately. Valid values:'."\n" + ."\n" + .'- **true**: The minor engine version is upgraded immediately.'."\n" + ."\n" + .'- **false**: The minor engine version is upgraded at a specified time or within the maintenance window.'."\n" + ."\n" + .'> The **UpgradeTime** parameter is required if you want to upgrade the minor engine version at a specified time.', 'type' => 'boolean', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => 'false'], ], [ - 'name' => 'PageSize', + 'name' => 'UpgradeVersion', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => '30', - ], + 'schema' => ['description' => 'The minor engine version to which you want to upgrade.'."\n" + ."\n" + .'> If you do not specify this parameter, the cluster is upgraded to the latest minor engine version.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => '1.37.0'], + ], + [ + 'name' => 'UpgradeTime', + 'in' => 'query', + 'schema' => ['description' => 'The time to perform the upgrade. Specify the time in the yyyy-MM-ddTHH:mmZ format. The time must be in UTC.'."\n" + ."\n" + .'> If you do not specify this parameter, the ApsaraDB for ClickHouse cluster is upgraded within the maintenance window.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => '2022-08-07T16:38Z'], ], ], 'responses' => [ @@ -11657,829 +9636,1221 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', - ], - 'KmsKeys' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'KeyId' => [ - 'description' => '', - 'type' => 'string', - 'example' => '0275bd3f-fdbb-4d8c-846b-71b211******'."\n", - ], - ], - ], - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'FE242962-6DA3-5FC8-9691-37B62A3210F7'], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => 'The DBClusterId provided does not exist in our records.'], + ], + ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"KmsKeys\\": [\\n {\\n \\"KeyId\\": \\"0275bd3f-fdbb-4d8c-846b-71b211******\\\\n\\"\\n }\\n ]\\n}","type":"json"}]', + 'title' => 'UpgradeMinorVersion', + 'summary' => 'The UpgradeMinorVersion operation upgrades the minor engine version of a specified community-compatible ApsaraDB for ClickHouse cluster.', + 'description' => '> Minor engine version upgrades are supported only for community-compatible clusters that are purchased after December 1, 2021.', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'UpgradeMinorVersion'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:UpgradeMinorVersion', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FE242962-6DA3-5FC8-9691-37B62A3210F7\\"\\n}","type":"json"}]', ], - 'ElectZookeeperLeader' => [ - 'summary' => 'Zookeeper主动切主', - 'methods' => [ - 'post', + ], + 'endpoints' => [ + ['regionId' => 'cn-huhehaote', 'regionName' => 'China (Hohhot)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-huhehaote.aliyuncs.com', 'endpoint' => 'clickhouse.cn-huhehaote.aliyuncs.com', 'vpc' => ''], + ['regionId' => 'ap-southeast-3', 'regionName' => 'Malaysia (Kuala Lumpur)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => ''], + ['regionId' => 'cn-wulanchabu', 'regionName' => 'China (Ulanqab)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-wulanchabu.aliyuncs.com'], + ['regionId' => 'cn-beijing', 'regionName' => 'China (Beijing)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-beijing.aliyuncs.com'], + ['regionId' => 'cn-qingdao', 'regionName' => 'China (Qingdao)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-qingdao.aliyuncs.com', 'endpoint' => 'clickhouse.cn-qingdao.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-qingdao.aliyuncs.com'], + ['regionId' => 'cn-shanghai', 'regionName' => 'China (Shanghai)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-shanghai.aliyuncs.com'], + ['regionId' => 'cn-hongkong', 'regionName' => 'China (Hong Kong)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-hongkong.aliyuncs.com', 'endpoint' => 'clickhouse.cn-hongkong.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-hongkong.aliyuncs.com'], + ['regionId' => 'cn-zhangjiakou', 'regionName' => 'China (Zhangjiakou)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-zhangjiakou.aliyuncs.com', 'endpoint' => 'clickhouse.cn-zhangjiakou.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-zhangjiakou.aliyuncs.com'], + ['regionId' => 'cn-shenzhen', 'regionName' => 'China (Shenzhen)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-shenzhen.aliyuncs.com', 'endpoint' => 'clickhouse.cn-shenzhen.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-shenzhen.aliyuncs.com'], + ['regionId' => 'ap-northeast-1', 'regionName' => 'Japan (Tokyo)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.ap-northeast-1.aliyuncs.com', 'endpoint' => 'clickhouse.ap-northeast-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.ap-northeast-1.aliyuncs.com'], + ['regionId' => 'cn-chengdu', 'regionName' => 'China (Chengdu)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-chengdu.aliyuncs.com', 'endpoint' => 'clickhouse.cn-chengdu.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-chengdu.aliyuncs.com'], + ['regionId' => 'cn-guangzhou', 'regionName' => 'China (Guangzhou)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-guangzhou.aliyuncs.com', 'endpoint' => 'clickhouse.cn-guangzhou.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-guangzhou.aliyuncs.com'], + ['regionId' => 'ap-southeast-1', 'regionName' => 'Singapore', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.ap-southeast-1.aliyuncs.com', 'endpoint' => 'clickhouse.ap-southeast-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.ap-southeast-1.aliyuncs.com'], + ['regionId' => 'ap-southeast-5', 'regionName' => 'Indonesia (Jakarta)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.ap-southeast-5.aliyuncs.com', 'endpoint' => 'clickhouse.ap-southeast-5.aliyuncs.com', 'vpc' => 'clickhouse-vpc.ap-southeast-5.aliyuncs.com'], + ['regionId' => 'ap-southeast-6', 'regionName' => 'Philippines (Manila)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.ap-southeast-6.aliyuncs.com', 'endpoint' => 'clickhouse.ap-southeast-6.aliyuncs.com', 'vpc' => 'clickhouse-vpc.ap-southeast-6.aliyuncs.com'], + ['regionId' => 'cn-hangzhou', 'regionName' => 'China (Hangzhou)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-hangzhou.aliyuncs.com'], + ['regionId' => 'us-east-1', 'regionName' => 'US (Virginia)', 'areaId' => 'europeAmerica', 'areaName' => 'Europe & Americas', 'public' => 'clickhouse.us-east-1.aliyuncs.com', 'endpoint' => 'clickhouse.us-east-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.us-east-1.aliyuncs.com'], + ['regionId' => 'eu-west-1', 'regionName' => 'UK (London)', 'areaId' => 'europeAmerica', 'areaName' => 'Europe & Americas', 'public' => 'clickhouse.eu-west-1.aliyuncs.com', 'endpoint' => 'clickhouse.eu-west-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.eu-west-1.aliyuncs.com'], + ['regionId' => 'us-west-1', 'regionName' => 'US (Silicon Valley)', 'areaId' => 'europeAmerica', 'areaName' => 'Europe & Americas', 'public' => 'clickhouse.us-west-1.aliyuncs.com', 'endpoint' => 'clickhouse.us-west-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.us-west-1.aliyuncs.com'], + ['regionId' => 'eu-central-1', 'regionName' => 'Germany (Frankfurt)', 'areaId' => 'europeAmerica', 'areaName' => 'Europe & Americas', 'public' => 'clickhouse.eu-central-1.aliyuncs.com', 'endpoint' => 'clickhouse.eu-central-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.eu-central-1.aliyuncs.com'], + ['regionId' => 'me-central-1', 'regionName' => 'Saudi Arabia (Riyadh)', 'areaId' => 'middleEast', 'areaName' => 'Middle East', 'public' => 'clickhouse.me-central-1.aliyuncs.com', 'endpoint' => 'clickhouse.me-central-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.me-central-1.aliyuncs.com'], + ['regionId' => 'me-east-1', 'regionName' => 'UAE (Dubai)', 'areaId' => 'middleEast', 'areaName' => 'Middle East', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => ''], + ['regionId' => 'cn-hangzhou-finance', 'regionName' => 'China East 1 Finance', 'areaId' => 'industryCloud', 'areaName' => 'Industry Cloud', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-hangzhou-finance.aliyuncs.com'], + ['regionId' => 'cn-shenzhen-finance-1', 'regionName' => 'China South 1 Finance', 'areaId' => 'industryCloud', 'areaName' => 'Industry Cloud', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-shenzhen-finance-1.aliyuncs.com'], + ['regionId' => 'cn-shanghai-finance-1', 'regionName' => 'China East 2 Finance', 'areaId' => 'industryCloud', 'areaName' => 'Industry Cloud', 'public' => 'clickhouse.cn-shanghai-finance-1.aliyuncs.com', 'endpoint' => 'clickhouse.cn-shanghai-finance-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-shanghai-finance-1.aliyuncs.com'], + ['regionId' => 'cn-beijing-finance-1', 'regionName' => 'China North 2 Finance (Preview)', 'areaId' => 'industryCloud', 'areaName' => 'Industry Cloud', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => ''], + ['regionId' => 'cn-north-2-gov-1', 'regionName' => 'Beijing Government Cloud', 'areaId' => 'industryCloud', 'areaName' => 'Industry Cloud', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => ''], + ], + 'errorCodes' => [ + ['code' => 'Abs.InvalidAccount.NotFound', 'message' => 'Account is not found.', 'http_code' => 404, 'description' => 'No corresponding account found.'], + ['code' => 'ACTION_UNAUTHORIZED', 'message' => 'The account balance is insufficient, and the opening of the public network needs to rely on load balancing service, which requires that the account balance must be greater than 100 yuan.', 'http_code' => 403, 'description' => 'The account balance is insufficient, and the opening of the public network needs to rely on load balancing service, which requires that the account balance must be greater than 100 yuan.'], + ['code' => 'COMMODITY.INVALID_COMPONENT', 'message' => 'Invalid component for commodity.', 'http_code' => 500, 'description' => 'The order configuration parameters do not meet the verification conditions, please re-match the product.'], + ['code' => 'DescribeLorneLogException', 'message' => 'Cannot find taskDetail in Lorne.', 'http_code' => 500, 'description' => 'The task details of the corresponding SLS were not found.'], + ['code' => 'Forbidden', 'message' => 'User not authorized to operate on the specified resource.', 'http_code' => 403, 'description' => 'The account is not granted permission to manipulate the resource'], + ['code' => 'InsufficientResourceCapacity', 'message' => 'The resource is out of usage.', 'http_code' => 403, 'description' => 'The resource is out of usage.'], + ['code' => 'InternalError', 'message' => 'An error occurred while processing your request.', 'http_code' => 500, 'description' => 'An error occurred while processing your request.'], + ['code' => 'InternalFailure', 'message' => 'The request processing has failed due to some unknown error, exception or failure.', 'http_code' => 500, 'description' => 'An internal system error occurred with this request.'], + ['code' => 'InvalidAccountName.NotFound', 'message' => 'Specified account name does not exist.', 'http_code' => 404, 'description' => 'The specified account name does not exist.'], + ['code' => 'InvalidBackupRetentionPeriod.Malformed', 'message' => 'The specified parameter "BackupRetentionPeriod" is not valid.', 'http_code' => 400, 'description' => 'The request parameter BackupRetentionPeriod is invalid.'], + ['code' => 'InvalidDBCluster.NotFound', 'message' => 'The DBClusterId provided does not exist in our records.', 'http_code' => 404, 'description' => 'The DBClusterId provided does not exist in our records.'], + ['code' => 'InvalidDBClusterId.NotFound', 'message' => 'The DBClusterId provided does not exist in our records.', 'http_code' => 404, 'description' => 'The passed instance ID does not exist.'], + ['code' => 'InvalidDBInstance.NotFound', 'message' => 'The DBClusterId provided does not exist in our records.', 'http_code' => 404, 'description' => 'The passed instance ID does not exist.'], + ['code' => 'InvalidDBInstanceId.NotFound', 'message' => 'The DBInstanceId provided does not exist in our records.', 'http_code' => 404, 'description' => 'No valid instance found'], + ['code' => 'InvalidPageNumber.Malformed', 'message' => 'The specified parameter "PageNumber" is not valid.', 'http_code' => 400, 'description' => 'The specified parameter PageNumber is invalid.'], + ['code' => 'InvalidPageSize.Malformed', 'message' => 'The specified parameter "PageSize" is not valid.', 'http_code' => 400, 'description' => 'The specified parameter "PageSize" is not valid.'], + ['code' => 'InvalidParameter.DBClusterVersion', 'message' => 'The version is invalid. Check whether the DBClusterVersion, MinorVersion, and MajorVersion parameters are correct.', 'http_code' => 400, 'description' => 'The version is invalid. Check whether the DBClusterVersion, MinorVersion, and MajorVersion parameters are correct.'], + ['code' => 'InvalidParameter.DBNodeStorage', 'message' => 'The specified parameter "DBNodeStorage" is not valid.', 'http_code' => 400, 'description' => 'The specified parameter "DBNodeStorage" is invalid.'], + ['code' => 'InvalidRegionId.Malformed', 'message' => 'The specified parameter "RegionId" is not valid.', 'http_code' => 400, 'description' => 'The specified parameter RegionId is invalid.'], + ['code' => 'InvalidSecurityIPs.Exceeded', 'message' => 'The specified parameter "SecurityIps" count is exceeded 200.', 'http_code' => 400, 'description' => 'The total number of security group IP addresses exceeds 200.'], + ['code' => 'InvalidVPC.NotFound', 'message' => 'VPC or VSwitch is not valid.', 'http_code' => 404, 'description' => 'The VPC ID passed in does not exist.'], + ['code' => 'InvalidVpcId.Malformed', 'message' => 'The specified parameter "VpcId" is not valid.', 'http_code' => 400, 'description' => ''], + ['code' => 'ModifyServerConfigFailed', 'message' => 'Failed to modify server config.', 'http_code' => 500, 'description' => 'Failed to modify instance configuration.'], + ['code' => 'OperationDenied.CKNotConnected', 'message' => 'Connect to ClickHouse Cluster Failed.', 'http_code' => 403, 'description' => 'Failed to connect to ClickHouse. Check the ClickHouse status, whitelist, and connectivity.'], + ['code' => 'OperationDenied.VirtualWarehouseShardsAlign', 'message' => 'The operation is not permitted due to virtualWarehouse shards align.', 'http_code' => 403, 'description' => 'The operation is not permitted due to virtualWarehouse shards align.'], + ['code' => 'PRICE.PRICING_PLAN_RESULT_NOT_FOUND', 'message' => 'Cannot find pricing plan for the commodity.', 'http_code' => 500, 'description' => 'Pricing plan not found.'], + ['code' => 'ServiceUnavailable', 'message' => 'An error occurred while processing your request.', 'http_code' => 503, 'description' => 'An error occurred while processing your request.'], + ['code' => 'UNAVAILABLE', 'message' => 'Service Unavailable.', 'http_code' => 502, 'description' => 'Service not available.'], + ['code' => 'UNKNOWN', 'message' => 'Unknown error.', 'http_code' => 500, 'description' => 'Unknown error.'], + ['code' => 'UserNotInBuyWhiteList', 'message' => 'ClickHouse is at the canary release stage. Please apply for use by submitting a ticket.', 'http_code' => 500, 'description' => 'ClickHouse is at the canary release stage. Please apply for use by submitting a ticket.'], + ['code' => 'InvalidSpecification', 'message' => 'Specification parameter is not valid.', 'http_code' => 400, 'description' => 'The specification parameter is invalid.'], + ['code' => 'InvalidDBInstanceStatus', 'message' => 'The specified instance state does\'t support this operation.', 'http_code' => 400, 'description' => 'The instance state does not allow the current operation.'], + ['code' => 'OperationDenied.OrderProcessing', 'message' => 'The operation is not permitted due to there is an order in processing of cluster.', 'http_code' => 400, 'description' => 'There is an outstanding order, please try again later.'], + ['code' => 'OperationDenied.NothingChanged', 'message' => 'The instance operation changes the specification, but the incoming specification is the same as the current specification without any changes.', 'http_code' => 400, 'description' => 'The instance operation changes the specification, but the incoming specification is the same as the current specification without any changes.'], + ['code' => 'StorageTypeDoNotSupportBackup', 'message' => 'Current StorageType Does Not Support Backup.', 'http_code' => 400, 'description' => 'The current storage type does not support backup'], + ], + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '-1', 'countWindow' => 1, 'regionId' => '*'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeSynDbTables'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyAccountDescription'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateMonitorDataReport'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CheckClickhouseToRDS'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreatePortsForClickHouse'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CheckMonitorAlert'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DeleteDBCluster'], + ['threshold' => '8', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateSQLAccount'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ReleaseClusterPublicConnection'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateAccount'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyBackupPolicy'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyAccountAuthority'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeSynDbs'], + ['threshold' => '2500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeDBClusterAttribute'], + ['threshold' => '2500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeDBClusters'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateBackupPolicy'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyDBClusterMaintainTime'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeBackups'], + ['threshold' => '2500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeDBClusterAccessWhiteList'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeRegions'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DeleteAccount'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DeleteSyndb'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ResetAccountPassword'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeAccounts'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateRDSToClickhouseDb'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'UpgradeMinorVersion'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'AllocateClusterPublicConnection'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeDBClusterNetInfoItems'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyMinorVersionGreadeType'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyDBClusterAccessWhiteList'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyRDSToClickhouseDb'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateAccountAndAuthority'], + ], + ], + 'ram' => [ + 'productCode' => 'ClickHouse', + 'productName' => 'ApsaraDB for ClickHouse', + 'ramCodes' => ['clickhouse'], + 'ramLevel' => 'RESOURCE', + 'ramConditions' => [ + [ + 'name' => 'clickhouse:EncryptionType', + 'schema' => ['type' => 'Array', 'description' => '加密类型'], + ], + ], + 'ramActions' => [ + [ + 'apiName' => 'ModifyActiveOperationMaintainConf', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyActiveOperationMaintainConf', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], ], - 'schemes' => [ - 'https', + [ + 'apiName' => 'DescribeAutoRenewAttribute', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAutoRenewAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'ChangeResourceGroup', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ChangeResourceGroup', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'DescribeColumns', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeColumns', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeSynDbTables', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSynDbTables', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'RestartInstance', + 'description' => '', 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '173004', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', + 'ramAction' => [ + 'action' => 'clickhouse:RestartInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', + [ + 'apiName' => 'DeleteDBCluster', + 'description' => '', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteDBCluster', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', + ], + [ + 'apiName' => 'ModifyBackupPolicy', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', + ], + [ + 'apiName' => 'DeleteSyndb', + 'description' => '', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteSyndb', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteSLB', + 'description' => '', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteSLB', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CheckScaleOutBalanced', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:CheckScaleOutBalanced', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteBackupPolicy', + 'description' => '', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeSynDbs', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSynDbs', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ModifyMinorVersionGreadeType', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyMinorVersionGreadeType', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ResetAccountPassword', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ResetAccountPassword', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ModifyDBClusterAccessWhiteList', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBClusterAccessWhiteList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeAccounts', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAccounts', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ModifyDBConfig', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBConfig', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeUserEncryptionKeyList', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeUserEncryptionKeyList', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CancelActiveOperationTasks', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:CancelActiveOperationTasks', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeSlowLogRecords', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSlowLogRecords', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeTransferHistory', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeTransferHistory', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'CreateAccount', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateAccount', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeAllDataSource', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAllDataSource', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeAccountAuthority', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAccountAuthority', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeActiveOperationMaintainConf', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeActiveOperationMaintainConf', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CreateServiceLinkedRole', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateServiceLinkedRole', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', + ], + [ + 'apiName' => 'ModifyDBClusterDescription', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBClusterDescription', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - [ - 'name' => 'DisableWrite', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', + ], + [ + 'apiName' => 'ReleaseClusterPublicConnection', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ReleaseClusterPublicConnection', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - [ - 'name' => 'ElectTime', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => '2025-12-12T07:28:00Z', + ], + [ + 'apiName' => 'CreatePortsForClickHouse', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreatePortsForClickHouse', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '=', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '', - 'type' => 'string', - 'example' => '7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF', - ], - ], + [ + 'apiName' => 'CheckServiceLinkedRole', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:CheckServiceLinkedRole', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], ], - 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', + [ + 'apiName' => 'CheckClickhouseToRDS', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:CheckClickhouseToRDS', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', + ], + [ + 'apiName' => 'CreateSLB', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateSLB', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + [ + 'apiName' => 'DescribeDBClusterConfigInXML', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterConfigInXML', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + [ + 'apiName' => 'CreateOSSStorage', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateOSSStorage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF\\"\\n}","type":"json"}]', - ], - 'DescribeDBClusterNodeInfos' => [ - 'summary' => '获取实例节点信息', - 'methods' => [ - 'get', - 'post', + [ + 'apiName' => 'DescribeDBClusterPerformance', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterPerformance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], ], - 'schemes' => [ - 'https', + [ + 'apiName' => 'CreateSQLAccount', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateSQLAccount', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'KillProcess', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:KillProcess', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'DescribeSchemas', + 'description' => '', 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '173004', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseMCDGZK', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSchemas', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', + [ + 'apiName' => 'DescribeBackups', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeBackups', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', + ], + [ + 'apiName' => 'ModifyRDSToClickhouseDb', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyRDSToClickhouseDb', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', + ], + [ + 'apiName' => 'DescribeProcessList', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeProcessList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', + ], + [ + 'apiName' => 'ModifyDBClusterMaintainTime', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBClusterMaintainTime', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '', - 'type' => 'string', - 'example' => '746CD303-0B82-5E8D-886D-93A9FAF3A876', - ], - 'NodeInfos' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'ShardId' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2', - ], - 'ReplicaId' => [ - 'description' => '', - 'type' => 'string', - 'example' => '1', - ], - 'NodeName' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'ck-bp108z124a8****', - ], - 'NodeIp' => [ - 'description' => '', - 'type' => 'string', - 'example' => '172.168.0.1', - ], - 'FailoverTesting' => [ - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - ], - ], - ], - 'ZkNodeInfos' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'ReplicaId' => [ - 'description' => '', - 'type' => 'string', - 'example' => '1', - ], - 'NodeName' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'ck-bp108z124a8****'."\n", - ], - 'FailoverTesting' => [ - 'description' => '', - 'type' => 'boolean', - 'example' => 'true', - ], - ], - ], - ], - 'PageNumber' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'TotalNodeCount' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - ], + [ + 'apiName' => 'ModifyDBCluster', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBCluster', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', + [ + 'apiName' => 'DescribeOSSStorage', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeOSSStorage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', + ], + [ + 'apiName' => 'UntagResources', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:UntagResources', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + [ + 'apiName' => 'ModifyActiveOperationTasks', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyActiveOperationTasks', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"746CD303-0B82-5E8D-886D-93A9FAF3A876\\",\\n \\"NodeInfos\\": [\\n {\\n \\"ShardId\\": \\"2\\",\\n \\"ReplicaId\\": \\"1\\",\\n \\"NodeName\\": \\"ck-bp108z124a8****\\",\\n \\"NodeIp\\": \\"172.168.0.1\\",\\n \\"FailoverTesting\\": true\\n }\\n ],\\n \\"ZkNodeInfos\\": [\\n {\\n \\"ReplicaId\\": \\"1\\",\\n \\"NodeName\\": \\"ck-bp108z124a8****\\\\n\\",\\n \\"FailoverTesting\\": true\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalNodeCount\\": 1\\n}","type":"json"}]', - ], - 'CancelAppointmentElectZookeeperLeader' => [ - 'summary' => '取消预约Zookeeper切主', - 'methods' => [ - 'post', + [ + 'apiName' => 'CheckModifyConfigNeedRestart', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:CheckModifyConfigNeedRestart', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], ], - 'schemes' => [ - 'https', + [ + 'apiName' => 'CreateAccountAndAuthority', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateAccountAndAuthority', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'CancelRestartInstance', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:CancelRestartInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'RestartInstanceNodeList', + 'description' => '', 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '173004', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', + 'ramAction' => [ + 'action' => 'clickhouse:RestartInstanceNodeList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', + [ + 'apiName' => 'CreateDBInstance', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateDBInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', + ], + [ + 'apiName' => 'DeleteAccount', + 'description' => '', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteAccount', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', + ], + [ + 'apiName' => 'DescribeTables', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeTables', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', + ], + [ + 'apiName' => 'DescribeDBClusterAttribute', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterAttribute', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '', - 'type' => 'string', - 'example' => '1F488A93-83FD-540F-9B67-0333AF64E6A0', - ], - ], + [ + 'apiName' => 'ListTagResources', + 'description' => '', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'clickhouse:ListTagResources', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeDBClusterNodeInfos', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterNodeInfos', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], ], - 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', + [ + 'apiName' => 'DescribeActiveOperationTasks', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeActiveOperationTasks', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', + ], + [ + 'apiName' => 'CheckMonitorAlert', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:CheckMonitorAlert', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1F488A93-83FD-540F-9B67-0333AF64E6A0\\"\\n}","type":"json"}]', - ], - 'RestartInstanceNodeList' => [ - 'summary' => '批量重启实例节点', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'DescribeAllDataSources', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAllDataSources', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '173004', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', + [ + 'apiName' => 'DescribeDBClusterConfig', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterConfig', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', + [ + 'apiName' => 'DescribeBackupPolicy', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', + ], + [ + 'apiName' => 'DescribeDBClusters', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusters', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', + ], + [ + 'apiName' => 'ModifyAccountDescription', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyAccountDescription', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', + ], + [ + 'apiName' => 'TagResources', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:TagResources', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'RestartTime', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => '2023-03-22T00:00:50Z', + ], + [ + 'apiName' => 'DescribeDBConfig', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBConfig', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'NodeList', - 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'ck-uf6*****-2**-clickhouse-s-0-r-0', - ], - 'required' => false, + ], + [ + 'apiName' => 'CreateRDSToClickhouseDb', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateRDSToClickhouseDb', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '', - 'type' => 'string', - 'example' => '36E3AB2E-E0DA-5C7B-8E29-89EE44926515', - ], - ], + [ + 'apiName' => 'CreateBackupPolicy', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], ], - 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', + [ + 'apiName' => 'AllocateClusterPublicConnection', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:AllocateClusterPublicConnection', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', + ], + [ + 'apiName' => 'ModifyDBClusterConfig', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBClusterConfig', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"36E3AB2E-E0DA-5C7B-8E29-89EE44926515\\"\\n}","type":"json"}]', - ], - 'CancelAppointmentRestartInstanceNodeList' => [ - 'summary' => '取消预约重启节点列表', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'CreateMonitorDataReport', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateMonitorDataReport', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'UpgradeMinorVersion', + 'description' => '', 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '173004', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseXSQ0JG', + 'ramAction' => [ + 'action' => 'clickhouse:UpgradeMinorVersion', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', + [ + 'apiName' => 'ModifyAutoRenewAttribute', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyAutoRenewAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cc-bp108z124a8o7****', + ], + [ + 'apiName' => 'ModifyDBClusterConfigInXML', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBClusterConfigInXML', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', + ], + [ + 'apiName' => 'DescribeSlowLogTrend', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSlowLogTrend', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', + ], + [ + 'apiName' => 'ModifyAccountAuthority', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyAccountAuthority', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '', - 'type' => 'string', - 'example' => '1F488A93-83FD-540F-9B67-0333AF64E6A0', - ], - ], + [ + 'apiName' => 'DescribeConfigVersionDifference', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeConfigVersionDifference', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], ], - 'errorCodes' => [ - 500 => [ - [ - 'errorCode' => 'InternalError', - 'errorMessage' => 'An error occurred while processing your request.', + [ + 'apiName' => 'DescribeDBClusterAccessWhiteList', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterAccessWhiteList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'An error occurred while processing your request.', + ], + [ + 'apiName' => 'DescribeConfigHistory', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeConfigHistory', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + [ + 'apiName' => 'DescribeDBClusterNetInfoItems', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBClusterNetInfoItems', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + [ + 'apiName' => 'TransferVersion', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:TransferVersion', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1F488A93-83FD-540F-9B67-0333AF64E6A0\\"\\n}","type":"json"}]', - ], - ], - 'endpoints' => [ - [ - 'regionId' => 'cn-qingdao', - 'endpoint' => 'clickhouse.cn-qingdao.aliyuncs.com', - ], - [ - 'regionId' => 'cn-beijing', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'cn-zhangjiakou', - 'endpoint' => 'clickhouse.cn-zhangjiakou.aliyuncs.com', - ], - [ - 'regionId' => 'cn-huhehaote', - 'endpoint' => 'clickhouse.cn-huhehaote.aliyuncs.com', - ], - [ - 'regionId' => 'cn-wulanchabu', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'cn-hangzhou', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'cn-shanghai', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'cn-shenzhen', - 'endpoint' => 'clickhouse.cn-shenzhen.aliyuncs.com', - ], - [ - 'regionId' => 'cn-guangzhou', - 'endpoint' => 'clickhouse.cn-guangzhou.aliyuncs.com', - ], - [ - 'regionId' => 'cn-chengdu', - 'endpoint' => 'clickhouse.cn-chengdu.aliyuncs.com', - ], - [ - 'regionId' => 'cn-hongkong', - 'endpoint' => 'clickhouse.cn-hongkong.aliyuncs.com', - ], - [ - 'regionId' => 'ap-northeast-1', - 'endpoint' => 'clickhouse.ap-northeast-1.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-1', - 'endpoint' => 'clickhouse.ap-southeast-1.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-3', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-5', - 'endpoint' => 'clickhouse.ap-southeast-5.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-6', - 'endpoint' => 'clickhouse.ap-southeast-6.aliyuncs.com', - ], - [ - 'regionId' => 'eu-central-1', - 'endpoint' => 'clickhouse.eu-central-1.aliyuncs.com', - ], - [ - 'regionId' => 'eu-west-1', - 'endpoint' => 'clickhouse.eu-west-1.aliyuncs.com', - ], - [ - 'regionId' => 'us-west-1', - 'endpoint' => 'clickhouse.us-west-1.aliyuncs.com', - ], - [ - 'regionId' => 'us-east-1', - 'endpoint' => 'clickhouse.us-east-1.aliyuncs.com', - ], - [ - 'regionId' => 'me-central-1', - 'endpoint' => 'clickhouse.me-central-1.aliyuncs.com', - ], - [ - 'regionId' => 'me-east-1', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'cn-north-2-gov-1', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'cn-beijing-finance-1', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'cn-shenzhen-finance-1', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'cn-shanghai-finance-1', - 'endpoint' => 'clickhouse.cn-shanghai-finance-1.aliyuncs.com', ], - [ - 'regionId' => 'cn-hangzhou-finance', - 'endpoint' => 'clickhouse.aliyuncs.com', + 'resourceTypes' => [ + ['validationType' => 'always', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ['validationType' => 'always', 'resourceType' => 'DBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:dbcluster/*'], ], ], ]; diff --git a/data/en_us/clickhouse/2023-05-22/api-docs.php b/data/en_us/clickhouse/2023-05-22/api-docs.php index 4a7e3cc..5876e76 100644 --- a/data/en_us/clickhouse/2023-05-22/api-docs.php +++ b/data/en_us/clickhouse/2023-05-22/api-docs.php @@ -1,137 +1,35 @@ '1.0', - 'info' => [ - 'style' => 'RPC', - 'product' => 'clickhouse', - 'version' => '2023-05-22', - ], + 'info' => ['style' => 'RPC', 'product' => 'clickhouse', 'version' => '2023-05-22'], 'directories' => [ [ - 'id' => 222452, - 'title' => null, - 'type' => 'directory', - 'children' => [ - 'CreateDBInstance', - 'DeleteDBInstance', - 'StartDBInstance', - 'RestartDBInstance', - 'StopDBInstance', - 'ModifyDBInstanceClass', - 'ModifyDBInstanceAttribute', - 'DescribeDBInstances', - 'DescribeDBInstanceAttribute', - 'UpgradeMinorVersion', - ], - ], - [ - 'id' => 222463, - 'title' => null, - 'type' => 'directory', - 'children' => [ - 'CreateAccount', - 'DeleteAccount', - 'ResetAccountPassword', - 'ModifyAccountDescription', - 'ModifyAccountAuthority', - 'DescribeAccounts', - 'DescribeAccountAuthority', - ], - ], - [ - 'id' => 222471, - 'title' => null, - 'type' => 'directory', - 'children' => [ - 'CreateDB', - 'DeleteDB', - 'DescribeDBInstanceDataSources', - ], - ], - [ - 'id' => 222475, - 'title' => null, + 'children' => ['CreateDB', 'DeleteDB', 'DescribeDBInstanceDataSources'], 'type' => 'directory', - 'children' => [ - 'CreateEndpoint', - 'DeleteEndpoint', - 'ModifyDBInstanceConnectionString', - 'ModifySecurityIPList', - 'DescribeSecurityIPList', - 'DescribeEndpoints', - ], - ], - [ - 'id' => 222482, - 'title' => null, - 'type' => 'directory', - 'children' => [ - 'DescribeProcessList', - 'KillProcess', - 'DescribeSlowLogTrend', - 'DescribeSlowLogRecords', - ], - ], - [ - 'id' => 222487, - 'title' => null, - 'type' => 'directory', - 'children' => [ - 'ModifyBackupPolicy', - 'DescribeBackupPolicy', - 'DeleteBackupPolicy', - 'CreateBackupPolicy', - 'DescribeBackups', - ], + 'title' => 'Database management', ], [ - 'id' => 222493, - 'title' => null, + 'children' => ['DescribeProcessList', 'KillProcess', 'DescribeSlowLogTrend'], 'type' => 'directory', - 'children' => [ - 'ModifyDBInstanceConfig', - 'DescribeDBInstanceConfigChangeLog', - 'DescribeDBInstanceConfig', - ], + 'title' => 'Task and log management', ], [ - 'id' => 222497, - 'title' => null, - 'type' => 'directory', 'children' => [ - 'ChangeResourceGroup', + 'AttachWhitelistTemplateToInstance', 'ChangeResourceGroup', 'CreateAccount', 'CreateBackupPolicy', 'CreateDBInstance', 'CreateEndpoint', 'CreateLangfuseOrg', 'CreateLangfuseOrgMember', 'CreateLangfuseProject', 'CreateLangfuseUser', 'CreateWhitelistTemplate', 'DeleteAccount', 'DeleteBackupPolicy', 'DeleteDBInstance', 'DeleteEndpoint', 'DeleteLangfuseInstance', 'DeleteLangfuseOrg', 'DeleteLangfuseOrgMembership', 'DeleteLangfuseProject', 'DeleteLangfuseUser', + 'DeleteWhitelistTemplate', 'DescribeAccountAuthority', 'DescribeAccounts', 'DescribeBackupPolicy', 'DescribeBackups', 'DescribeDBInstanceAttribute', 'DescribeDBInstanceConfig', 'DescribeDBInstanceConfigChangeLog', 'DescribeDBInstances', 'DescribeEndpoints', 'DescribeLangfuseEndpoints', 'DescribeLangfuseOrgMemberships', 'DescribeLangfuseOrgs', 'DescribeLangfuseProjectMemberships', 'DescribeLangfuseProjects', 'DescribeLangfuseSecurityIPList', 'DescribeLangfuseUser', 'DescribeLangfuseUsers', 'DescribeRegions', 'DescribeSecurityIPList', + 'DescribeSlowLogRecords', 'DetachWhitelistTemplateToInstance', 'GetWhitelistTemplate', 'ListClickHouseDBTimezones', 'ListInstanceLinkedWhitelistTemplates', 'ListWhitelistTemplates', 'ModifyAccountAuthority', 'ModifyAccountDescription', 'ModifyBackupPolicy', 'ModifyDBInstanceAttribute', 'ModifyDBInstanceClass', 'ModifyDBInstanceConfig', 'ModifyDBInstanceConnectionString', 'ModifyLangfuseOrgMembership', 'ModifyLangfuseProjectMembership', 'ModifySecurityIPList', 'ResetAccountPassword', 'ResetLangfuseUserPassword', 'RestartDBInstance', 'StartDBInstance', + 'StopDBInstance', 'UpdateWhitelistTemplate', 'UpgradeMinorVersion', ], - ], - [ - 'id' => 0, 'title' => 'Others', 'type' => 'directory', - 'children' => [ - 'ListClickHouseDBTimezones', - 'DeleteWhitelistTemplate', - 'CreateWhitelistTemplate', - 'DetachWhitelistTemplateToInstance', - 'UpdateWhitelistTemplate', - 'GetWhitelistTemplate', - 'AttachWhitelistTemplateToInstance', - 'ListWhitelistTemplates', - 'ListInstanceLinkedWhitelistTemplates', - ], ], ], 'components' => [ 'schemas' => [], ], 'apis' => [ - 'CreateDBInstance' => [ - 'summary' => 'Creates an ApsaraDB for ClickHouse cluster that runs Enterprise Edition.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'AttachWhitelistTemplateToInstance' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -140,390 +38,413 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'update', 'riskType' => 'none', - 'chargeType' => 'paid', - 'abilityTreeCode' => '182031', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseN0HBPQ', - ], + 'chargeType' => 'free', + 'abilityTreeCode' => '185639', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ - [ - 'name' => 'ClientToken', - 'in' => 'query', - 'allowEmptyValue' => false, - 'schema' => [ - 'title' => '幂等参数', - 'description' => 'The client token that is used to ensure the idempotence of the request. You can use the client to generate the token. Make sure that the token is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'AB', - ], - ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - 'title' => '地域id', - ], + 'schema' => ['description' => 'Region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'ZoneId', + 'name' => 'TemplateId', 'in' => 'query', - 'schema' => [ - 'description' => 'The zone ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou-h', - 'title' => '可用区', - ], + 'schema' => ['description' => 'The ID of the whitelist template.', 'type' => 'string', 'required' => true, 'example' => '98a6d3db05984dca', 'title' => ''], ], [ - 'name' => 'VpcId', + 'name' => 'DBInstanceId', 'in' => 'query', + 'schema' => ['description' => 'The ClickHouse instance ID. Separate multiple instance IDs with commas. A maximum of 20 instances can be attached at a time.', 'type' => 'string', 'required' => true, 'example' => 'cc-nkhdbf1d,cc-nkhdbf1s', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The virtual private cloud (VPC) ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'vpc-uf6xmupdn7v6ui9f****', - 'title' => 'VPC ID。', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'Request ID.', 'type' => 'string', 'example' => '1234567890', 'title' => ''], + 'Data' => [ + 'title' => '', + 'type' => 'object', + 'properties' => [ + 'Status' => ['description' => 'The status of the operation. A value of `ok` indicates success.', 'type' => 'string', 'example' => 'ok', 'title' => ''], + 'AttachFailList' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The name of the instance.', 'type' => 'string', 'example' => 'my-database', 'title' => ''], + 'Reason' => ['description' => 'The reason for the attachment failure.', 'type' => 'string', 'example' => '处理异常', 'title' => ''], + ], + 'description' => 'Details of the attachment failure for the instance.', + 'title' => '', + 'example' => '', + ], + 'description' => 'Instances that failed to be attached.', + 'title' => '', + 'example' => '', + ], + 'AttachSuccessedList' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The name of the instance.', 'type' => 'string', 'example' => 'my-database', 'title' => ''], + 'Templates' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'TemplateId' => ['description' => 'The ID of the whitelist template.', 'type' => 'string', 'example' => 'g-asdfwem', 'title' => ''], + 'TemplateName' => ['description' => 'The name of the whitelist template.', 'type' => 'string', 'example' => 'demo_template', 'title' => ''], + 'SecurityIPList' => ['description' => 'The IP address whitelist.', 'type' => 'string', 'example' => '192.168.1.1,10.0.0.1', 'title' => ''], + 'DbInstances' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The ID of the instance.', 'type' => 'string', 'example' => 'asdfwef', 'title' => ''], + ], + 'description' => 'The details of the instance.', + 'title' => '', + 'example' => '', + ], + 'description' => 'The list of attached instances.', + 'title' => '', + 'example' => '', + ], + ], + 'description' => 'The details of the template.', + 'title' => '', + 'example' => '', + ], + 'description' => 'The list of whitelist templates.', + 'title' => '', + 'example' => '', + ], + ], + 'description' => 'Details about the instances to which the template was successfully attached.', + 'title' => '', + 'example' => '', + ], + 'description' => 'Instances to which the template was successfully attached.', + 'title' => '', + 'example' => '', + ], + ], + 'description' => 'The returned data.', + 'example' => '', + ], + ], + 'description' => 'Schema of response.', + 'title' => '', + 'example' => '', ], ], - [ - 'name' => 'VswitchId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The vSwitch ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'vsw-uf632qye9oqt4x4sr****', - 'title' => '交换机ID。', + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Invalid parameter.', 'description' => ''], + ['errorCode' => 'InvalidWhitelistTemplateId', 'errorMessage' => 'Invalid Whitelist templateId.', 'description' => ''], + ['errorCode' => 'InvalidWhitelistTemplate.IllegalPermission', 'errorMessage' => 'No permission to operate the whitelist template.', 'description' => ''], + ['errorCode' => 'InvalidDBInstanceId.TooManyItems', 'errorMessage' => 'The number of DBInstanceId should be no more than 20.', 'description' => ''], + ['errorCode' => 'InvalidParameter.DBInstanceId', 'errorMessage' => 'The specified parameter DBInstanceId is not valid.', 'description' => ''], + ['errorCode' => 'InvalidAttachTemplate.QuotaExceeded', 'errorMessage' => 'Exceed the upper limit of the template that the instance can bind.', 'description' => ''], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'AttachWhitelistTemplateToInstance', + 'summary' => 'Attaches a whitelist template to instances.', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:AttachWhitelistTemplateToInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1234567890\\",\\n \\"Data\\": {\\n \\"Status\\": \\"ok\\",\\n \\"AttachFailList\\": [\\n {\\n \\"DBInstanceId\\": \\"my-database\\",\\n \\"Reason\\": \\"处理异常\\"\\n }\\n ],\\n \\"AttachSuccessedList\\": [\\n {\\n \\"DBInstanceId\\": \\"my-database\\",\\n \\"Templates\\": [\\n {\\n \\"TemplateId\\": \\"g-asdfwem\\",\\n \\"TemplateName\\": \\"demo_template\\",\\n \\"SecurityIPList\\": \\"192.168.1.1,10.0.0.1\\",\\n \\"DbInstances\\": [\\n {\\n \\"DBInstanceId\\": \\"asdfwef\\"\\n }\\n ]\\n }\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'ChangeResourceGroup' => [ + 'summary' => 'Changes the resource group of a ClickHouse Enterprise instance.', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'DBInstanceDescription', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster description.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'Used for test', - 'title' => '集群说明。', - ], + 'AK' => [], ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '163948', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + ], + 'parameters' => [ [ - 'name' => 'EngineVersion', + 'name' => 'ResourceType', 'in' => 'query', 'schema' => [ - 'description' => 'The engine version.'."\n", 'type' => 'string', 'required' => false, - 'example' => '23.8', - 'title' => '引擎版本。', + 'default' => 'EnterpriseDBCluster', + 'title' => '', + 'description' => 'The resource type.', + 'enumValueTitles' => [], + 'example' => 'EnterpriseDBCluster', ], ], [ - 'name' => 'ScaleMin', + 'name' => 'ResourceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The minimum capacity for auto scaling.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '8', - 'title' => 'serverless弹性伸缩最小值。', - ], + 'schema' => ['type' => 'string', 'required' => true, 'title' => '', 'description' => 'The resource ID.', 'example' => 'cc-bp1i43033051****'], ], [ - 'name' => 'ScaleMax', + 'name' => 'ResourceRegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The maximum capacity for auto scaling.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '32', - 'title' => 'serverless弹性伸缩最大值。', - ], + 'schema' => ['type' => 'string', 'required' => true, 'title' => '', 'description' => 'The region ID.', 'example' => 'cn-hangzhou'], ], [ - 'name' => 'Engine', + 'name' => 'ResourceGroupId', 'in' => 'query', + 'schema' => ['type' => 'string', 'required' => true, 'title' => '', 'description' => 'The ID of the destination resource group.', 'example' => 'rg-4690g37929****'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The engine type.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'clickhouse', - 'enum' => [ - 'clickhouse', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['type' => 'string', 'title' => '', 'description' => 'The ID of the request.', 'example' => 'C342F3DD-1FF7-55E9-A1A1-098D*******'], ], - 'title' => '引擎类型。', + 'title' => '', + 'description' => 'The response schema.', + 'example' => '', ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'NoPermission.ChangeResourceGroup', 'errorMessage' => 'You are not authorized to change resourcegroup', 'description' => ''], + ['errorCode' => 'MissingParameter.ResourceRegionId', 'errorMessage' => 'The ResourceRegionId parameters that are required for processing this request are missing', 'description' => ''], + ['errorCode' => 'MissingParameter.ResourceId', 'errorMessage' => 'The ResourceId parameters that are required for processing this request are missing', 'description' => ''], + ['errorCode' => 'MissingParameter.ResourceGroupId', 'errorMessage' => 'The ResourceGroupId parameters that are required for processing this request are missing', 'description' => ''], + ['errorCode' => 'InvalidResourceGroup', 'errorMessage' => 'The specified ResourceGroupId is invalid', 'description' => ''], + ['errorCode' => 'SystemError', 'errorMessage' => 'A system error occurred while processing your request', 'description' => ''], + ['errorCode' => 'ResourceNotFound', 'errorMessage' => ' The specified resource is not found', 'description' => ''], + ], + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'ChangeResourceGroup', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C342F3DD-1FF7-55E9-A1A1-098D*******\\"\\n}","type":"json"}]', + ], + 'CreateAccount' => [ + 'summary' => 'Creates a database account for an ApsaraDB for ClickHouse Enterprise Edition cluster.', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'MultiZone', - 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'description' => 'The configurations of multi-zone deployment.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'ZoneId' => [ - 'description' => 'The zone ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou-h', - 'title' => '可用区ID。', - ], - 'VSwitchIds' => [ - 'description' => 'The vSwitch IDs.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'The vSwitch ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'vsw-8vb05l07h3sdayqhe****', - 'title' => '交换机ID。', - ], - 'required' => false, - 'title' => '交换机ID。', - ], - ], - 'required' => false, - 'description' => '', - 'title' => '多可用区配置。', - ], - 'required' => false, - 'title' => '多可用区配置。', - ], + 'AK' => [], ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185272', + 'abilityTreeNodes' => ['FEATUREclickhouseL1079N'], + ], + 'parameters' => [ [ - 'name' => 'DeploySchema', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The deployment status of the cluster.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'multi_az', - 'title' => '集群可用区部署状态。', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], ], [ - 'name' => 'SourceDBInstanceId', + 'name' => 'AccountType', 'in' => 'query', 'schema' => [ - 'description' => 'The cluster ID.'."\n", + 'description' => 'The type of the database account. Valid values:'."\n" + ."\n" + .'- **NormalAccount**: standard account'."\n" + ."\n" + .'- **SuperAccount**: privileged account', 'type' => 'string', - 'required' => false, - 'example' => 'cc-2ze1*********', - 'title' => '集群例ID。', + 'required' => true, + 'enum' => ['SuperAccount', 'NormalAccount'], + 'example' => 'NormalAccount', + 'title' => '', ], ], [ - 'name' => 'BackupSetId', + 'name' => 'Account', 'in' => 'query', - 'schema' => [ - 'description' => 'The backup set ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '1', - 'title' => '备份集ID。', - ], + 'schema' => ['description' => 'The name of the account.', 'type' => 'string', 'required' => true, 'example' => 'test1', 'title' => ''], ], [ - 'name' => 'ResourceGroupId', + 'name' => 'Password', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => 'rg-*****', - 'title' => '集群所属的资源组ID。', - ], + 'schema' => ['description' => 'The password of the database account. The password must meet the following requirements:'."\n" + ."\n" + .'- The password must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.'."\n" + ."\n" + .'- The following special characters are supported: ! @ # $ % ^ & \\* ( ) \\_ + - ='."\n" + ."\n" + .'- The password must be 8 to 32 characters in length.', 'type' => 'string', 'required' => true, 'example' => 'a1b2c3d4@', 'title' => ''], ], [ - 'name' => 'NodeScaleMax', + 'name' => 'DmlAuthSetting', 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'title' => 'serverless节点弹性伸缩最大值。取值范围4-32，且必须大于最小值', - 'type' => 'integer', - 'format' => 'int32', - 'maximum' => '128', - 'minimum' => '4', - 'example' => '4', - ], - ], - [ - 'name' => 'NodeScaleMin', - 'in' => 'query', - 'schema' => [ - 'title' => 'serverless节点弹性伸缩最小值。取值范围4-32', - 'type' => 'integer', - 'format' => 'int32', - 'maximum' => '128', - 'minimum' => '4', - 'example' => '32', - ], - ], - [ - 'name' => 'NodeCount', - 'in' => 'query', - 'schema' => [ - 'title' => '节点个数，取值范围2-16', - 'type' => 'integer', - 'format' => 'int32', - 'maximum' => '64', - 'minimum' => '2', - 'example' => '2', - ], - ], - [ - 'name' => 'StorageQuota', - 'in' => 'query', - 'schema' => [ - 'title' => '存储预购量（GB）', - 'type' => 'integer', - 'format' => 'int64', - 'minimum' => '0', - 'example' => '100', - ], - ], - [ - 'name' => 'StorageType', - 'in' => 'query', - 'schema' => [ - 'title' => '存储类型。', - 'type' => 'string', - 'example' => 'OSS', - 'enum' => [ - 'oss', - 'ESSD_L1', - 'ESSD_L2', - 'ESSD_L3', - 'SSD', - 'ESSD_L0', + 'description' => 'The information about permissions.', + 'type' => 'object', + 'properties' => [ + 'DmlAuthority' => [ + 'description' => 'Specifies whether to grant the DML permissions to the database account. Valid values:'."\n" + ."\n" + .'- **0**: The account has the permissions to read data from the database, write data to the database, and modify the settings of the database.'."\n" + ."\n" + .'- **1**: The account only has the permissions to read data from the database.'."\n" + ."\n" + .'- **2**: The account only has the permissions to read data from the database and modify the settings of the database.', + 'type' => 'integer', + 'format' => 'int32', + 'enum' => ['0', '1', '2'], + 'required' => false, + 'example' => '0', + 'title' => '', + ], + 'DdlAuthority' => ['description' => 'Specifies whether to grant the DDL permissions to the database account. Valid values:'."\n" + ."\n" + .'- **true**: The account has the permissions to execute DDL statements.'."\n" + ."\n" + .'- **false**: The account does not have the permissions to execute DDL statements.', 'type' => 'boolean', 'required' => false, 'example' => 'true', 'title' => ''], + 'AllowDictionaries' => [ + 'description' => 'The dictionaries on which you want to grant permissions. Separate multiple dictionaries with commas (,).', + 'type' => 'array', + 'items' => ['description' => 'The dictionary on which you want to grant permissions. Separate multiple dictionaries with commas (,).', 'type' => 'string', 'required' => false, 'example' => 'dc1,dc2', 'title' => ''], + 'required' => false, + 'title' => '', + 'example' => '', + ], + 'AllowDatabases' => [ + 'description' => 'The databases on which you want to grant permissions. Separate multiple databases with commas (,).', + 'type' => 'array', + 'items' => ['description' => 'The database on which you want to grant permissions. Separate multiple databases with commas (,).', 'type' => 'string', 'required' => false, 'example' => 'db1,db2', 'title' => ''], + 'required' => false, + 'title' => '', + 'example' => '', + ], ], + 'required' => false, + 'title' => '', + 'example' => '', ], ], [ - 'name' => 'DBTimeZone', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => '数据库内核时区设置，应为IANA时区标识符。', - 'type' => 'string', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'Category', + 'name' => 'Product', 'in' => 'query', - 'schema' => [ - 'type' => 'string', - 'default' => 'enterprise', - ], + 'schema' => ['description' => 'The code of the cloud service.', 'type' => 'string', 'default' => 'clickhouse', 'required' => false, 'example' => 'clickhouse', 'title' => ''], ], [ - 'name' => 'Tags', + 'name' => 'Description', 'in' => 'query', - 'style' => 'repeatList', - 'schema' => [ - 'title' => '标签列表', - 'type' => 'array', - 'items' => [ - 'title' => '标签列表。', - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'title' => '实例标签键。', - 'type' => 'string', - 'example' => 'user_123', - ], - 'Value' => [ - 'title' => '实例标签值。', - 'type' => 'string', - 'example' => '示例字符串', - ], - ], - ], - 'maxItems' => 20, - 'minItems' => 0, - ], + 'schema' => ['description' => 'The description of the account.', 'type' => 'string', 'example' => 'For testing', 'required' => false, 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", + 'description' => 'The response parameters.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA****'], 'Data' => [ - 'description' => 'The response parameters.'."\n", + 'description' => 'The data returned.', 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - 'title' => '集群ID。', - ], - 'OrderId' => [ - 'description' => 'The order ID.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '21154955706****', - 'title' => '订单ID。', - ], - 'ConnectionString' => [ - 'description' => 'The endpoint.'."\n", - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****-clickhouse.clickhouseserver.rds.aliyuncs.com', - 'title' => '连接地址。', - ], + 'DBInstanceId' => ['description' => 'The cluster ID.', 'type' => 'string', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'Account' => ['description' => 'The name of the database account.', 'type' => 'string', 'example' => 'test1', 'title' => ''], ], - 'title' => '返回结果。', + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'IdempotentParameterMismatch', - 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', - ], + ['errorCode' => 'InvalidAccountType.Malformed', 'errorMessage' => 'The specified parameter "AccountType" is not valid.', 'description' => ''], + ['errorCode' => 'InvalidAccountName.Malformed', 'errorMessage' => 'The specified parameter "Account" is not valid.', 'description' => ''], + ['errorCode' => 'InvalidAccountPassword.Malformed', 'errorMessage' => 'The specified parameter "Password" is not valid.', 'description' => ''], + ], + 403 => [ + ['errorCode' => 'InvalidDBInstanceState.NotSupport', 'errorMessage' => 'The specified instance state does\'t support this operation.', 'description' => ''], + ], + [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'The passed instance ID does not exist.'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"OrderId\\": 0,\\n \\"ConnectionString\\": \\"cc-bp100p4q1g9z3****-clickhouse.clickhouseserver.rds.aliyuncs.com\\"\\n }\\n}","type":"json"}]', - 'title' => 'CreateDBInstance', - ], - 'DeleteDBInstance' => [ - 'summary' => 'Releases an ApsaraDB for ClickHouse cluster that runs Enterprise Edition.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA****\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Account\\": \\"test1\\"\\n }\\n}","type":"json"}]', + 'title' => 'CreateAccount', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateAccount', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'translator' => 'manual', + ], + 'CreateBackupPolicy' => [ + 'summary' => 'Creates a backup policy for a specified ClickHouse Enterprise Edition cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -532,218 +453,361 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', + 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185379', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '206399', + 'abilityTreeNodes' => ['FEATUREclickhouseIL81EM'], ], 'parameters' => [ + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-2ze0eb0w182xh8549', 'title' => ''], + ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'DBInstanceId', + 'name' => 'PreferredBackupTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The ID of the destination cluster.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], + 'schema' => ['description' => 'The UTC time range to perform the backup. For example, `12:00Z-13:00Z` means that the backup starts between 12:00 and 13:00 UTC.', 'type' => 'string', 'required' => true, 'example' => '10:00Z-11:00Z', 'title' => ''], + ], + [ + 'name' => 'PreferredBackupPeriod', + 'in' => 'query', + 'schema' => ['description' => 'The backup cycle. Specify the days of the week for backups. Separate multiple days with commas (`,`).', 'type' => 'string', 'required' => true, 'example' => 'Monday,Friday', 'title' => ''], + ], + [ + 'name' => 'BackupRetentionPeriod', + 'in' => 'query', + 'schema' => ['description' => 'The number of days to retain backups.', 'type' => 'string', 'required' => false, 'example' => '8', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => 'The returned data.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', - ], - 'Data' => [ - 'description' => 'The data returned.'."\n", - 'type' => 'object', - 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - ], - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], ], + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'StorageTypeDoNotSupportBackup', 'errorMessage' => 'Current StorageType Does Not Support Backup.', 'description' => 'The current storage type does not support backup'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\"\\n }\\n}","type":"json"}]', - 'title' => 'DeleteDBInstance', - ], - 'StartDBInstance' => [ - 'summary' => 'Starts an ApsaraDB for ClickHouse Enterprise Edition cluster.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', + 'title' => 'CreateBackupPolicy', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:CreateBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","type":"json"}]', + ], + 'CreateDB' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '189351', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185311', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-bp100p4q1g9z3****'], + ], + [ + 'name' => 'DBName', + 'in' => 'query', + 'schema' => ['description' => 'The name of the database. The name must meet the following requirements:'."\n" + ."\n" + .'- Consist of lowercase letters, digits, underscores (\\_), and hyphens (-).'."\n" + ."\n" + .'- Start with a lowercase letter and end with a lowercase letter or a digit.'."\n" + ."\n" + .'- Be up to 64 characters in length.'."\n" + ."\n" + .'>'."\n" + ."\n" + .'An underscore (\\_) is counted as two characters.'."\n" + ."\n" + .'>', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'testdb001'], + ], + [ + 'name' => 'Comment', + 'in' => 'query', + 'schema' => ['description' => 'The description of the database.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'test'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F76', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => '94F92113-FF63-5E57-8401-6FE123AD11DD'], 'Data' => [ - 'description' => 'The data returned.'."\n", + 'description' => 'The returned data.', 'type' => 'object', 'properties' => [ - 'TaskId' => [ - 'description' => 'The task ID.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100000837', - ], - 'DBInstanceID' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'DBInstanceName' => [ - 'description' => 'The cluster name.'."\n", - 'type' => 'string', - 'example' => 'test1', - ], + 'DBInstanceId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp100p4q1g9z3****'], + 'DBName' => ['description' => 'The database name.', 'type' => 'string', 'title' => '', 'example' => 'testdb001'], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'InvalidDBInstanceState.NotSupport', 'errorMessage' => 'The specified instance state does\'t support this operation.', 'description' => ''], + ], + [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'The passed instance ID does not exist.'], + ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F76\\",\\n \\"Data\\": {\\n \\"TaskId\\": 100000837,\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"企业版集群测试\\"\\n }\\n}","type":"json"}]', - 'title' => 'StartDBInstance', - ], - 'RestartDBInstance' => [ - 'summary' => 'Restarts an ApsaraDB for ClickHouse Enterprise Edition cluster.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', + 'title' => 'CreateDB', + 'summary' => 'Creates a database.', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateDB', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"94F92113-FF63-5E57-8401-6FE123AD11DD\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"DBName\\": \\"testdb001\\"\\n }\\n}","type":"json"}]', + ], + 'CreateDBInstance' => [ + 'summary' => 'To create a ClickHouse Enterprise Edition cluster, call the `CreateDBInstance` API.', + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '192305', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'paid', + 'abilityTreeCode' => '182031', + 'abilityTreeNodes' => ['FEATUREclickhouseN0HBPQ'], ], 'parameters' => [ + [ + 'name' => 'ClientToken', + 'in' => 'query', + 'allowEmptyValue' => false, + 'schema' => ['description' => 'A client-provided token to ensure request idempotence. It must be unique across requests, contain only ASCII characters, and not exceed 64 characters in length.', 'type' => 'string', 'example' => 'AB', 'title' => '', 'required' => false], + ], [ 'name' => 'RegionId', 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'ZoneId', + 'in' => 'query', + 'schema' => ['description' => 'The zone ID.', 'type' => 'string', 'example' => 'cn-hangzhou-h', 'title' => '', 'required' => false], + ], + [ + 'name' => 'VpcId', + 'in' => 'query', + 'schema' => ['description' => 'The VPC ID.', 'type' => 'string', 'example' => 'vpc-uf6xmupdn7v6ui9f****', 'title' => '', 'required' => false], + ], + [ + 'name' => 'VswitchId', + 'in' => 'query', + 'schema' => ['description' => 'The vSwitch ID.', 'type' => 'string', 'example' => 'vsw-uf632qye9oqt4x4sr****', 'title' => '', 'required' => false], + ], + [ + 'name' => 'DBInstanceDescription', + 'in' => 'query', + 'schema' => ['description' => 'The description of the instance.', 'type' => 'string', 'example' => 'Cluster test', 'title' => '', 'required' => false], + ], + [ + 'name' => 'EngineVersion', + 'in' => 'query', + 'schema' => ['description' => 'The engine version.', 'type' => 'string', 'example' => '23.8', 'title' => '', 'required' => false], + ], + [ + 'name' => 'ScaleMin', + 'in' => 'query', + 'schema' => ['description' => 'This parameter is deprecated. Use the `NodeCount`, `NodeScaleMin`, and `NodeScaleMax` parameters to configure elastic scaling.', 'type' => 'string', 'required' => false, 'example' => '8', 'title' => ''], + ], + [ + 'name' => 'ScaleMax', + 'in' => 'query', + 'schema' => ['description' => 'This parameter is deprecated. Use the `NodeCount`, `NodeScaleMin`, and `NodeScaleMax` parameters to configure elastic scaling.', 'type' => 'string', 'required' => false, 'example' => '32', 'title' => ''], + ], + [ + 'name' => 'Engine', + 'in' => 'query', 'schema' => [ - 'description' => 'The region ID.'."\n", + 'description' => 'The engine type.', 'type' => 'string', + 'example' => 'clickhouse', + 'enum' => ['clickhouse'], + 'title' => '', 'required' => false, - 'example' => 'cn-hangzhou', ], ], [ - 'name' => 'DBInstanceId', + 'name' => 'MultiZone', 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', + 'description' => 'The multi-zone configuration.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ZoneId' => ['description' => 'The zone ID.', 'type' => 'string', 'example' => 'cn-hangzhou-h', 'title' => '', 'required' => false], + 'VSwitchIds' => [ + 'description' => 'The vSwitch IDs.', + 'type' => 'array', + 'items' => ['description' => 'The vSwitch ID.', 'type' => 'string', 'example' => 'vsw-8vb05l07h3sdayqhe****', 'title' => '', 'required' => false], + 'required' => false, + 'title' => '', + 'example' => '', + ], + ], + 'required' => false, + 'description' => 'The configuration for a single zone.', + 'title' => '', + 'example' => '', + ], + 'required' => false, + 'title' => '', + 'example' => '', + ], + ], + [ + 'name' => 'DeploySchema', + 'in' => 'query', + 'schema' => ['description' => 'The deployment mode of the instance.', 'type' => 'string', 'example' => 'multi_az', 'title' => '', 'required' => false], + ], + [ + 'name' => 'SourceDBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the source instance. This parameter is required when restoring from a backup.', 'type' => 'string', 'example' => 'cc-2ze1*********', 'title' => '', 'required' => false], + ], + [ + 'name' => 'BackupSetId', + 'in' => 'query', + 'schema' => ['description' => 'The backup set ID.', 'type' => 'string', 'example' => '1', 'title' => '', 'required' => false], + ], + [ + 'name' => 'ResourceGroupId', + 'in' => 'query', + 'schema' => ['description' => 'The ID of the resource group to which the instance belongs.', 'type' => 'string', 'example' => 'rg-*****', 'title' => '', 'required' => false], + ], + [ + 'name' => 'NodeScaleMax', + 'in' => 'query', + 'schema' => ['description' => 'The maximum number of nodes for serverless elastic scaling. Valid values: 4 to 32. The value must be greater than the `NodeScaleMin` parameter.', 'type' => 'integer', 'format' => 'int32', 'maximum' => '128', 'minimum' => '4', 'example' => '4', 'title' => '', 'required' => false], + ], + [ + 'name' => 'NodeScaleMin', + 'in' => 'query', + 'schema' => ['description' => 'The minimum number of nodes for serverless elastic scaling. Valid values: 4 to 32.', 'type' => 'integer', 'format' => 'int32', 'maximum' => '128', 'minimum' => '4', 'example' => '32', 'title' => '', 'required' => false], + ], + [ + 'name' => 'NodeCount', + 'in' => 'query', + 'schema' => ['description' => 'The number of nodes. Valid values: 2 to 16. This parameter is required when you configure an elastic scaling range by using the `NodeScaleMin` and `NodeScaleMax` parameters.', 'type' => 'integer', 'format' => 'int32', 'maximum' => '64', 'minimum' => '2', 'example' => '2', 'title' => '', 'required' => false], + ], + [ + 'name' => 'DBTimeZone', + 'in' => 'query', + 'schema' => ['description' => 'The time zone of the database, which must be an IANA time zone identifier.', 'type' => 'string', 'title' => '', 'required' => false, 'example' => 'Asia/Shanghai'], + ], + [ + 'name' => 'Category', + 'in' => 'query', + 'schema' => ['description' => 'The edition of the instance. Valid value:'."\n" + ."\n" + .'- `enterprise`: Enterprise Edition', 'type' => 'string', 'default' => 'enterprise', 'required' => false, 'example' => 'enterprise', 'title' => ''], + ], + [ + 'name' => 'Tags', + 'in' => 'query', + 'style' => 'repeatList', + 'schema' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => 'The key of the tag.', 'type' => 'string', 'example' => 'user_123', 'title' => '', 'required' => false], + 'Value' => ['description' => 'The value of the tag.', 'type' => 'string', 'example' => 'example string', 'title' => '', 'required' => false], + ], + 'title' => '', + 'description' => 'A tag.', + 'required' => false, + 'example' => '', + ], + 'maxItems' => 20, + 'minItems' => 0, + 'title' => '', + 'description' => 'The tags to add to the instance.', + 'required' => false, + 'example' => '', ], ], ], @@ -751,155 +815,145 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'description' => 'The response schema.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], 'Data' => [ - 'description' => 'The data returned.'."\n", + 'description' => 'The data returned.', 'type' => 'object', 'properties' => [ - 'TaskId' => [ - 'description' => 'The task ID.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100001080', - ], - 'DBInstanceID' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'DBInstanceName' => [ - 'description' => 'The cluster name.'."\n", - 'type' => 'string', - 'example' => 'test1', - ], + 'DBInstanceId' => ['description' => 'The cluster ID.', 'type' => 'string', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'OrderId' => ['description' => 'The order ID.', 'type' => 'integer', 'format' => 'int64', 'example' => '21154955706****', 'title' => ''], + 'ConnectionString' => ['description' => 'The endpoint.', 'type' => 'string', 'example' => 'cc-bp100p4q1g9z3****-clickhouse.clickhouseserver.rds.aliyuncs.com', 'title' => ''], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', 'description' => ''], + ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"Data\\": {\\n \\"TaskId\\": 100001080,\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"企业版集群测试\\"\\n }\\n}","type":"json"}]', - 'title' => 'RestartDBInstance', - ], - 'StopDBInstance' => [ - 'summary' => 'Stops an ApsaraDB for ClickHouse Enterprise Edition cluster.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"OrderId\\": 0,\\n \\"ConnectionString\\": \\"cc-bp100p4q1g9z3****-clickhouse.clickhouseserver.rds.aliyuncs.com\\"\\n }\\n}","type":"json"}]', + 'title' => 'CreateDBInstance', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateDBInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'translator' => 'manual', + ], + 'CreateEndpoint' => [ + 'summary' => 'Creates a public endpoint that provides a public address to access a cluster.', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '189348', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185384', + 'abilityTreeNodes' => ['FEATUREclickhouseZHDS8I'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + ], + [ + 'name' => 'DBInstanceNetType', + 'in' => 'query', 'schema' => [ - 'description' => 'The cluster ID.'."\n", + 'description' => 'The network type. Set this value to Public to create a public endpoint.', 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', + 'enum' => ['Public'], + 'required' => false, + 'example' => 'Public', + 'title' => '', ], ], + [ + 'name' => 'ConnectionPrefix', + 'in' => 'query', + 'schema' => ['description' => 'The prefix for the connection string.', 'type' => 'string', 'required' => false, 'example' => 'cc-bp100p4q1g9z3****-clickhouse.clickhouseserver.rds.aliyuncs.com', 'title' => ''], + ], + [ + 'name' => 'ComputingGroupId', + 'in' => 'query', + 'schema' => ['description' => 'The computing group ID.', 'type' => 'string', 'required' => false, 'example' => 'cc-bp100p4q1g9z3****-clickhouse', 'title' => ''], + ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'description' => 'The returned data.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', - ], - 'Data' => [ - 'description' => 'The data returned.'."\n", - 'type' => 'object', - 'properties' => [ - 'TaskId' => [ - 'description' => 'The task ID.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100000785', - ], - 'DBInstanceID' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'DBInstanceName' => [ - 'description' => 'The cluster name.'."\n", - 'type' => 'string', - 'example' => 'test1', - ], - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\",\\n \\"Data\\": {\\n \\"TaskId\\": 100000785,\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"企业版集群测试\\"\\n }\\n}","type":"json"}]', - 'title' => 'StopDBInstance', - ], - 'ModifyDBInstanceClass' => [ - 'summary' => 'Modifies the elastic scaling settings of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","type":"json"}]', + 'title' => 'CreateEndpoint', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateEndpoint', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + ], + 'CreateLangfuseOrg' => [ + 'summary' => 'Creates a Langfuse organization.', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -910,220 +964,162 @@ 'systemTags' => [ 'operationType' => 'update', 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '188578', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'chargeType' => 'paid', + 'abilityTreeCode' => '182031', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - 'title' => '地域ID。', - ], + 'schema' => ['title' => '', 'description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-xxxxxxx', - 'title' => '集群ID。', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'ScaleMin', + 'name' => 'Name', 'in' => 'query', - 'schema' => [ - 'description' => 'The minimum capacity for elastic scaling.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '2', - 'title' => '（参数废弃）serverless弹性伸缩最小值。', - ], + 'schema' => ['description' => 'The name of the Langfuse organization.', 'type' => 'string', 'required' => true, 'example' => 'org_name', 'title' => ''], ], [ - 'name' => 'ScaleMax', + 'name' => 'OwnerEmail', 'in' => 'query', + 'schema' => ['description' => 'The email address of the Langfuse organization owner.', 'type' => 'string', 'required' => true, 'example' => 'john@company.com', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The maximum capacity for elastic scaling.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '32', - 'title' => '（参数废弃）serverless弹性伸缩最大值。', + 'title' => '', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], + 'Data' => [ + 'title' => '', + 'description' => 'The response data.', + 'type' => 'object', + 'properties' => [ + 'OrganizationId' => ['title' => '', 'description' => 'The Langfuse organization ID.', 'type' => 'string', 'example' => 'cmrbhzx930005jw****'], + 'Name' => ['description' => 'The name of the Langfuse organization.', 'type' => 'string', 'example' => 'org_name', 'title' => ''], + 'CreatedAt' => ['description' => 'The time when the Langfuse organization was created.', 'type' => 'string', 'example' => '2026-06-25T09:28:30.949Z', 'title' => ''], + ], + 'example' => '', + ], + ], + 'example' => '', ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', 'description' => ''], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => 'Create a langfuse organization', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"Data\\": {\\n \\"OrganizationId\\": \\"cmrbhzx930005jw****\\",\\n \\"Name\\": \\"org_name\\",\\n \\"CreatedAt\\": \\"2026-06-25T09:28:30.949Z\\"\\n }\\n}","type":"json"}]', + ], + 'CreateLangfuseOrgMember' => [ + 'summary' => 'Adds a user to a Langfuse organization.', + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'NodeScaleMax', - 'in' => 'query', - 'schema' => [ - 'title' => 'serverless节点弹性伸缩最大值。取值范围4-32，且必须大于最小值', - 'type' => 'integer', - 'format' => 'int32', - 'maximum' => '128', - 'minimum' => '4', - 'example' => '4', - ], + 'AK' => [], ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ [ - 'name' => 'NodeScaleMin', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => 'serverless节点弹性伸缩最小值。取值范围4-32', - 'type' => 'integer', - 'format' => 'int32', - 'maximum' => '128', - 'minimum' => '4', - 'example' => '32', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'NodeCount', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'title' => '节点个数，取值范围2-16', - 'type' => 'integer', - 'format' => 'int32', - 'maximum' => '64', - 'minimum' => '1', - 'example' => '2', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'StorageQuota', + 'name' => 'OrganizationId', 'in' => 'query', - 'schema' => [ - 'type' => 'integer', - 'format' => 'int64', - 'minimum' => '0', - 'example' => '100', - ], + 'schema' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], ], [ - 'name' => 'StorageType', + 'name' => 'Email', 'in' => 'query', - 'schema' => [ - 'title' => '存储类型。', - 'type' => 'string', - 'example' => 'OSS', - 'enum' => [ - 'oss', - 'ESSD_L1', - 'ESSD_L2', - 'ESSD_L3', - 'SSD', - 'ESSD_L0', - ], - ], + 'schema' => ['description' => 'The email address of the user.', 'type' => 'string', 'required' => true, 'example' => 'john@company.com', 'title' => ''], ], [ - 'name' => 'ComputingGroupId', + 'name' => 'Role', 'in' => 'query', - 'schema' => [ - 'title' => '计算组id', - 'type' => 'string', - ], + 'schema' => ['description' => 'The role of the user in the organization.', 'type' => 'string', 'required' => true, 'example' => 'VIEWER', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'title' => '', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'xxx-xxx-xxx', - ], + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], 'Data' => [ - 'description' => 'The returned result.'."\n", + 'description' => 'The information about the user added to the Langfuse organization.', 'type' => 'object', 'properties' => [ - 'TaskId' => [ - 'description' => 'The task ID.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10000****', - 'title' => '任务ID。', - ], - 'ScaleMin' => [ - 'description' => 'The minimum capacity for elastic scaling.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2', - 'title' => 'serverless弹性伸缩最小值。', - ], - 'ScaleMax' => [ - 'description' => 'The maximum capacity for elastic scaling.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '32', - 'title' => 'serverless弹性伸缩最大值。', - ], - 'DBInstanceID' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => 'cc-xxxxxxx'."\n", - 'title' => '集群ID。', - ], - 'DBInstanceName' => [ - 'description' => 'The cluster name.'."\n", - 'type' => 'string', - 'example' => 'cc-xxxxxxx'."\n", - 'title' => '集群名称。', - ], - 'ComputingGroupId' => [ - 'type' => 'string', - ], + 'Role' => ['description' => 'The role of the user in the organization.', 'type' => 'string', 'example' => 'VIEWER', 'title' => ''], + 'Email' => ['description' => 'The email address of the user.', 'type' => 'string', 'example' => 'john@company.com', 'title' => ''], ], - 'title' => '返回数据。', + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidSpecification', - 'errorMessage' => 'Specification parameter is not valid.', - ], + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\",\\n \\"Data\\": {\\n \\"TaskId\\": 0,\\n \\"ScaleMin\\": 2,\\n \\"ScaleMax\\": 32,\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"cc-xxxxxxx\\\\n\\",\\n \\"ComputingGroupId\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => 'ModifyDBInstanceClass', + 'title' => 'Add a user to a langfuse organization', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\",\\n \\"Data\\": {\\n \\"Role\\": \\"VIEWER\\",\\n \\"Email\\": \\"john@company.com\\"\\n }\\n}","type":"json"}]', ], - 'ModifyDBInstanceAttribute' => [ - 'summary' => 'Modifies the configurations of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', - ], + 'CreateLangfuseProject' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -1135,953 +1131,544 @@ 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-xxxxx', - ], - ], - [ - 'name' => 'AttributeType', - 'in' => 'query', - 'schema' => [ - 'description' => 'The configuration that you want to modify.'."\n" - ."\n" - .'* MaintainTime: the O\\&M time'."\n" - .'* DBInstanceDescription: the cluster name'."\n", - 'type' => 'string', - 'required' => true, - 'enumValueTitles' => [], - 'example' => 'DBInstanceDescription', - 'enum' => [ - 'MaintainTime', - 'DBInstanceDescription', - ], - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'AttributeValue', + 'name' => 'OrganizationId', 'in' => 'query', - 'schema' => [ - 'description' => 'The new value of the configuration.', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'schema' => ['description' => 'The organization ID to which the Langfuse project belongs.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], ], [ - 'name' => 'Product', + 'name' => 'Name', 'in' => 'query', - 'schema' => [ - 'description' => 'The code of the cloud service.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'clickhouse', - 'default' => 'clickhouse', - ], + 'schema' => ['description' => 'The Langfuse project name.', 'type' => 'string', 'required' => true, 'example' => 'project_name', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '', + 'title' => '', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.', - 'type' => 'string', - 'example' => 'xxx-xxx-xxx', + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => '2C7393F1-5FD1-5CEE-A2EA-270A2CF99693'], + 'Data' => [ + 'description' => 'The returned result.', + 'type' => 'object', + 'properties' => [ + 'OrganizationId' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], + 'ProjectId' => ['description' => 'The Langfuse project ID.', 'type' => 'string', 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], + 'Name' => ['description' => 'The Langfuse project name.', 'type' => 'string', 'example' => 'project_name', 'title' => ''], + 'CreatedAt' => ['description' => 'The time when the Langfuse project was created.', 'type' => 'string', 'example' => '2026-06-24T10:14:33Z', 'title' => ''], + ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], + ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\"\\n}","type":"json"}]', - 'title' => 'ModifyDBInstanceAttribute', + 'title' => 'Create a langfuse project', + 'summary' => 'Creates a Langfuse project.', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2C7393F1-5FD1-5CEE-A2EA-270A2CF99693\\",\\n \\"Data\\": {\\n \\"OrganizationId\\": \\"cmrbhzx930005jw2q****\\",\\n \\"ProjectId\\": \\"cmrbhzx930005jw2q****\\",\\n \\"Name\\": \\"project_name\\",\\n \\"CreatedAt\\": \\"2026-06-24T10:14:33Z\\"\\n }\\n}","type":"json"}]', ], - 'DescribeDBInstances' => [ - 'summary' => 'Queries a list of ApsaraDB for ClickHouse clusters.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', - ], + 'CreateLangfuseUser' => [ + 'summary' => 'Creates a Langfuse user.', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'update', 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '183135', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'chargeType' => 'paid', + 'abilityTreeCode' => '182031', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['title' => '', 'description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DBInstanceIds', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster IDs. Separate multiple cluster IDs with commas (,).'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cc-xxxxx,cx-xxxx', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'DBInstanceStatus', + 'name' => 'Email', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster status.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'active', - ], + 'schema' => ['description' => 'The email address of the user.', 'type' => 'string', 'required' => true, 'example' => 'john@company.com', 'title' => ''], ], [ - 'name' => 'Description', + 'name' => 'Name', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster description.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['description' => 'The username.', 'type' => 'string', 'required' => true, 'example' => 'john', 'title' => ''], ], [ - 'name' => 'PageSize', + 'name' => 'Password', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries per page.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', - ], + 'schema' => ['description' => 'The password of the user account. The password must meet the following requirements:'."\n" + ."\n" + .'- Contains at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.'."\n" + ."\n" + .'- The following special characters are supported: !@#$%^&*()_+-='."\n" + ."\n" + .'- The password must be 8 to 32 characters in length.', 'type' => 'string', 'required' => true, 'example' => '2F9e9@******', 'title' => ''], ], [ - 'name' => 'PageNumber', + 'name' => 'OrganizationId', 'in' => 'query', - 'schema' => [ - 'description' => 'The page number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'required' => false, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], ], [ - 'name' => 'ResourceGroupId', + 'name' => 'OrgRole', 'in' => 'query', - 'schema' => [ - 'description' => 'The resource group ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'rg-4690g37929****', - ], + 'schema' => ['description' => 'The role of the user in the organization.', 'type' => 'string', 'required' => false, 'example' => 'VIEWER', 'title' => ''], ], - [ - 'name' => 'Tags', - 'in' => 'query', - 'style' => 'repeatList', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'title' => '标签信息。', - 'type' => 'array', - 'items' => [ - 'title' => '标签信息。', - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'title' => '标签键。', - 'type' => 'string', - 'example' => 'user_123', - ], - 'Value' => [ - 'title' => '标签值。', - 'type' => 'string', - 'example' => '示例值', + 'title' => '', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], + 'Data' => [ + 'title' => '', + 'description' => 'The response data.', + 'type' => 'object', + 'properties' => [ + 'Email' => ['description' => 'The email address of the user.', 'type' => 'string', 'example' => 'john@company.com', 'title' => ''], + 'Name' => ['description' => 'The username.', 'type' => 'string', 'example' => 'john', 'title' => ''], + 'CreatedAt' => ['description' => 'The time when the user was created.', 'type' => 'string', 'example' => '2026-03-04T10:20:33Z', 'title' => ''], + 'Membership' => [ + 'description' => 'The role of the user.', + 'type' => 'object', + 'properties' => [ + 'OrganizationId' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], + 'Role' => ['description' => 'The role of the user in the organization.', 'type' => 'string', 'example' => 'VIEWER', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], ], + 'example' => '', ], ], - 'maxItems' => 20, + 'example' => '', ], ], ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', 'description' => ''], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => 'Create a langfuse user', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"Data\\": {\\n \\"Email\\": \\"john@company.com\\",\\n \\"Name\\": \\"john\\",\\n \\"CreatedAt\\": \\"2026-03-04T10:20:33Z\\",\\n \\"Membership\\": {\\n \\"OrganizationId\\": \\"cmrbhzx930005jw2q****\\",\\n \\"Role\\": \\"VIEWER\\"\\n }\\n }\\n}","type":"json"}]', + ], + 'CreateWhitelistTemplate' => [ + 'summary' => 'Creates a whitelist template.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185639', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'publicInformation', + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'TemplateName', + 'in' => 'query', + 'schema' => ['description' => 'The name of the whitelist template.', 'type' => 'string', 'required' => true, 'example' => 'InvoiceTemplate', 'title' => ''], + ], + [ + 'name' => 'SecurityIPList', + 'in' => 'formData', + 'schema' => ['description' => 'The IP addresses in the whitelist. Separate multiple IP addresses with commas (,). You can add up to 100 IP addresses.', 'type' => 'string', 'required' => true, 'example' => '192.168.1.1,10.0.0.1', 'title' => ''], + ], + ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", 'type' => 'object', 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '1234567890', 'title' => ''], 'Data' => [ - 'description' => 'The returned result.'."\n", + 'title' => '', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => 'The total number of entries returned.'."\n", - 'type' => 'string', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => 'The number of entries per page.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'PageNumber' => [ - 'description' => 'The page number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'DBInstances' => [ - 'description' => 'The clusters.'."\n", + 'Templates' => [ 'type' => 'array', 'items' => [ - 'description' => 'The cluster.'."\n", 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-xxxxxxx', - ], - 'Description' => [ - 'description' => 'The cluster description.'."\n", - 'type' => 'string', - 'example' => 'test_desc', - ], - 'Engine' => [ - 'description' => 'The engine type.'."\n", - 'type' => 'string', - 'example' => 'clickhouse', - ], - 'EngineVersion' => [ - 'description' => 'The engine version.'."\n", - 'type' => 'string', - 'example' => '22.8', - ], - 'AliUid' => [ - 'description' => 'The user ID.'."\n", - 'type' => 'string', - 'example' => '1294****', - ], - 'Bid' => [ - 'description' => 'The channel ID.'."\n", - 'type' => 'string', - 'example' => '186681****', - ], - 'RegionId' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'ZoneId' => [ - 'description' => 'The zone ID.'."\n", - 'type' => 'string', - 'example' => 'cn-hangzhou-i', - ], - 'ChargeType' => [ - 'description' => 'The billing method. Valid values:'."\n" - ."\n" - .'* PrePaid: subscription'."\n" - .'* PostPaid: pay-as-you-go'."\n", - 'type' => 'string', - 'example' => 'PostPaid', - ], - 'Status' => [ - 'description' => 'The cluster status.'."\n", - 'type' => 'string', - 'example' => 'active', - ], - 'VpcId' => [ - 'description' => 'The virtual private cloud (VPC) ID.'."\n", - 'type' => 'string', - 'example' => 'vpc-uf6kg****', - ], - 'VSwitchId' => [ - 'description' => 'The vSwitch ID.'."\n", - 'type' => 'string', - 'example' => 'vsw-8vb5mw****', - ], - 'ScaleMin' => [ - 'description' => 'The minimum capacity for elastic scaling.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'ScaleMax' => [ - 'description' => 'The maximum capacity for elastic scaling.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '13', - ], - 'ExpireTime' => [ - 'description' => 'The time when the cluster expires.'."\n", - 'type' => 'string', - 'example' => '2024-02-16 11:51:06', - ], - 'LockMode' => [ - 'description' => 'The lock mode.'."\n", - 'type' => 'string', - 'example' => '0', - ], - 'LockReason' => [ - 'description' => 'The reason why the cluster was locked.'."\n", - 'type' => 'string', - 'example' => 'null', - ], - 'MaintainStartTime' => [ - 'description' => 'The start time of the maintenance window.'."\n", - 'type' => 'string', - 'example' => '00:00Z', - ], - 'MaintainEndTime' => [ - 'description' => 'The end time of the maintenance window.'."\n", - 'type' => 'string', - 'example' => '04:00:00Z', - ], - 'DeletionProtection' => [ - 'description' => 'Indicates whether the release protection feature is enabled for the cluster.'."\n", - 'type' => 'string', - 'example' => 'False', - ], - 'ResourceGroupId' => [ - 'description' => 'The resource group ID.'."\n", - 'type' => 'string', - 'example' => 'rg-acfmzy****', - ], - 'CreateTime' => [ - 'description' => 'The time when the cluster was created.'."\n", - 'type' => 'string', - 'example' => '2022-12-04 21:16:15', - ], - 'Tags' => [ - 'description' => 'The tags.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'The tag.'."\n", - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => 'The tag key.'."\n", - 'type' => 'string', - 'example' => 'tag', - ], - 'Value' => [ - 'description' => 'The tag value.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - ], - ], - ], - 'StorageType' => [ - 'title' => '实例存储类型', - 'type' => 'string', - 'example' => 'oss', - ], + 'TemplateId' => ['description' => 'The ID of the whitelist template.', 'type' => 'string', 'example' => 'g-asdfwem', 'title' => ''], + 'TemplateName' => ['description' => 'The name of the whitelist template.', 'type' => 'string', 'example' => 'demo_template', 'title' => ''], + 'SecurityIPList' => ['description' => 'The list of IP addresses in the whitelist.', 'type' => 'string', 'example' => '192.168.1.1,10.0.0.1', 'title' => ''], ], + 'title' => '', + 'description' => 'The details of the template.', + 'example' => '', ], + 'title' => '', + 'description' => 'The list of whitelist templates.', + 'example' => '', ], ], - ], - 'RequestId' => [ - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'xxx-xxx-xxx', + 'description' => 'The returned data.', + 'example' => '', ], ], + 'title' => '', + 'description' => 'Schema of response.', + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidSecurityIPs.Malformed', 'errorMessage' => 'Specified IPList is not valid.', 'description' => ''], + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Invalid parameter.', 'description' => ''], + ['errorCode' => 'InvalidWhitelistTemplateName.Duplicated', 'errorMessage' => 'Whitelist template name duplicated.', 'description' => ''], + ['errorCode' => 'InvalidSecurityIPList.QuotaExceeded', 'errorMessage' => 'Specified security IP list is not valid: Exceeding the allowed amount of IP address in the list.', 'description' => ''], + ['errorCode' => 'InvalidSecurityIPList.Format', 'errorMessage' => 'Specified security IP list format is not valid.', 'description' => ''], + ['errorCode' => 'InvalidWhitelistTemplateName.CreateLimit', 'errorMessage' => 'Created Whitelist template name exceeded limit.', 'description' => ''], + ['errorCode' => 'InvalidIpWhitelistTemplateName.Malformed', 'errorMessage' => 'The templateName is not valid.', 'description' => ''], + ['errorCode' => 'InvalidSecurityIPList.Duplicate', 'errorMessage' => 'Specified security IP list is not valid: Duplicate IP address in the list', 'description' => ''], + ['errorCode' => 'InvalidUser.NotFound', 'errorMessage' => 'Specified user does not exist.', 'description' => ''], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Data\\": {\\n \\"TotalCount\\": \\"1\\",\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"DBInstances\\": [\\n {\\n \\"DBInstanceId\\": \\"cc-xxxxxxx\\",\\n \\"Description\\": \\"test_desc\\",\\n \\"Engine\\": \\"clickhouse\\",\\n \\"EngineVersion\\": \\"22.8\\",\\n \\"AliUid\\": \\"1294****\\",\\n \\"Bid\\": \\"186681****\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"ZoneId\\": \\"cn-hangzhou-i\\",\\n \\"ChargeType\\": \\"PostPaid\\",\\n \\"Status\\": \\"active\\",\\n \\"VpcId\\": \\"vpc-uf6kg****\\",\\n \\"VSwitchId\\": \\"vsw-8vb5mw****\\",\\n \\"ScaleMin\\": 1,\\n \\"ScaleMax\\": 13,\\n \\"ExpireTime\\": \\"2024-02-16 11:51:06\\",\\n \\"LockMode\\": \\"0\\",\\n \\"LockReason\\": \\"null\\",\\n \\"MaintainStartTime\\": \\"00:00Z\\",\\n \\"MaintainEndTime\\": \\"04:00:00Z\\",\\n \\"DeletionProtection\\": \\"False\\",\\n \\"ResourceGroupId\\": \\"rg-acfmzy****\\",\\n \\"CreateTime\\": \\"2022-12-04 21:16:15\\",\\n \\"Tags\\": [\\n {\\n \\"Key\\": \\"tag\\",\\n \\"Value\\": \\"test\\"\\n }\\n ],\\n \\"StorageType\\": \\"oss\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"xxx-xxx-xxx\\"\\n}","type":"json"}]', - 'title' => 'DescribeDBInstances', - ], - 'DescribeDBInstanceAttribute' => [ - 'summary' => 'Queries the details of an ApsaraDB for ClickHouse cluster that runs Enterprise Edition.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', + 'title' => 'CreateWhitelistTemplate', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateWhitelistTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1234567890\\",\\n \\"Data\\": {\\n \\"Templates\\": [\\n {\\n \\"TemplateId\\": \\"g-asdfwem\\",\\n \\"TemplateName\\": \\"demo_template\\",\\n \\"SecurityIPList\\": \\"192.168.1.1,10.0.0.1\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DeleteAccount' => [ + 'summary' => 'Deletes a database account from an ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '183134', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'operationType' => 'delete', + 'abilityTreeCode' => '185273', + 'abilityTreeNodes' => ['FEATUREclickhouse2H8YOY'], ], 'parameters' => [ [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - 'title' => '集群ID。', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + ], + [ + 'name' => 'Account', + 'in' => 'query', + 'schema' => ['description' => 'The destination database account.'."\n", 'type' => 'string', 'required' => true, 'example' => 'test', 'title' => ''], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n" - ."\n" - .'Valid values:'."\n" - ."\n" - .'* cn-beijing'."\n", - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'cn-beijing' => 'cn-beijing', - ], - 'example' => 'cn-hangzhou', - 'title' => '地域ID。', - ], + 'schema' => ['description' => 'The region ID.'."\n", 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'Product', + 'in' => 'query', + 'schema' => ['description' => 'The code of the cloud service.'."\n", 'type' => 'string', 'required' => false, 'example' => 'clickhouse', 'default' => 'clickhouse', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.'."\n", 'type' => 'string', 'example' => '21D06907-CEA5-561D-B6B1-198BCCE99ED1'], 'Data' => [ - 'description' => 'The result returned.'."\n", + 'description' => 'The data returned.'."\n", 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - 'title' => '集群ID。', - ], - 'Description' => [ - 'description' => 'The cluster description.'."\n", - 'type' => 'string', - 'example' => 'Used for test', - 'title' => '集群描述。', - ], - 'Engine' => [ - 'description' => 'The engine type.'."\n", - 'type' => 'string', - 'example' => 'clickhouse', - 'title' => '引擎类型。', - ], - 'EngineVersion' => [ - 'description' => 'The engine version.'."\n", - 'type' => 'string', - 'example' => '23.8', - 'title' => '引擎版本。', - ], - 'AliUid' => [ - 'description' => 'The ID of the Alibaba Cloud account.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '140692647406****', - 'title' => '阿里云账号ID。', - ], - 'Bid' => [ - 'description' => 'The channel ID.'."\n", - 'type' => 'string', - 'example' => 'PD39050615820269****', - 'title' => '渠道ID。', - ], - 'RegionId' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'example' => 'cn-hangzhou', - 'title' => '地域ID。', - ], - 'DeploySchema' => [ - 'description' => 'The deployment mode of the cluster. Valid values: single_az and multi_az.'."\n" - ."\n" - .'* single_az: indicates that the server nodes are deployed in the primary zone. The ID of the primary zone is specified by the ZoneID parameter.'."\n" - .'* multi_az: indicates that the server nodes are deployed in multiple zones. The information about the zones is specified by the MultiZones parameter.'."\n" - ."\n" - .'The keeper nodes are deployed in multiple zones.'."\n", - 'type' => 'string', - 'example' => 'single_az', - 'title' => '集群可用区部署状态，支持single_az和multi_az两种类型。'."\n" - ."\n" - .'- single_az：server部署到主可用区ZoneId。'."\n" - .'- multi_az：server部署到多可用区MultiZones。'."\n" - ."\n" - .'keeper始终部署到多可用区MultiZones。', - ], - 'MultiZones' => [ - 'description' => 'The information about the zones.'."\n", - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'VSwitchIds' => [ - 'description' => 'The vSwitch IDs.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'The vSwitch ID.'."\n", - 'type' => 'string', - 'example' => 'vsw-bj9kpwhcb9iekphje1ljz', - 'title' => '交换机ID。', - ], - 'title' => '交换机ID。', - ], - 'ZoneId' => [ - 'description' => 'The zone ID.'."\n", - 'type' => 'string', - 'example' => 'cn-hangzhou-h', - 'title' => '可用区ID。', - ], - ], - 'description' => '', - 'title' => '多可用信息。', - ], - 'title' => '多可用信息。', - ], - 'ChargeType' => [ - 'description' => 'The billing method. Enterprise Edition clusters use the pay-as-you-go billing method.'."\n", - 'type' => 'string', - 'example' => 'PrePaid', - 'title' => '付费方式。 '."\n" - .'企业版集群的付费方式都是按量付费方式。', - ], - 'Status' => [ - 'description' => 'The cluster status.'."\n", - 'type' => 'string', - 'example' => 'active', - 'title' => '实例状态。', - ], - 'VpcId' => [ - 'description' => 'The virtual private cloud (VPC) ID.'."\n", - 'type' => 'string', - 'example' => 'vpc-wz9duj8xd6r1gzhsg*****', - 'title' => 'VPC ID。', - ], - 'VSwitchId' => [ - 'description' => 'The vSwitch ID.'."\n", - 'type' => 'string', - 'example' => 'vsw-uf67ij56zm9x4uc6hmilg', - 'title' => '交换机ID。', - ], - 'ScaleMin' => [ - 'description' => 'The minimum capacity for elastic scaling.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '8', - 'title' => 'serverless弹性伸缩最小值。', - ], - 'ScaleMax' => [ - 'description' => 'The maximum capacity for elastic scaling.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '32', - 'title' => 'serverless弹性伸缩最大值。', - ], - 'StorageSize' => [ - 'description' => 'The size of the storage space. Unit: GB.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '12', - 'title' => '存储空间大小。单位：GB', - ], - 'StorageType' => [ - 'description' => 'The storage type.'."\n", - 'type' => 'string', - 'example' => '100', - 'title' => '存储类型。', - ], - 'ObjectStoreSize' => [ - 'description' => 'The size of the object storage space.'."\n", - 'type' => 'string', - 'example' => '13', - 'title' => '对象存储大小。', - ], - 'ExpireTime' => [ - 'description' => 'The time when the cluster expires. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format.'."\n" - ."\n" - .'> Pay-as-you-go clusters never expire. If the cluster is a pay-as-you-go cluster, an empty string is returned for this parameter.'."\n", - 'type' => 'string', - 'example' => '2024-04-17T08:14:48Z', - 'title' => '集群的到期时间，格式：yyyy-MM-ddTHH:mm:ssZ。'."\n" - .'>按量付费集群无到期时间，返回值为空。', - ], - 'LockMode' => [ - 'description' => 'The lock mode of the cluster.'."\n", - 'type' => 'string', - 'example' => '0', - 'title' => '集群的锁定模式。', - ], - 'LockReason' => [ - 'description' => 'The reason why the cluster was locked.'."\n", - 'type' => 'string', - 'example' => 'nolock', - 'title' => '锁定原因。', - ], - 'MaintainStartTime' => [ - 'description' => 'The start time of the maintenance window.'."\n", - 'type' => 'string', - 'example' => '12:00', - 'title' => '可维护时间开始时间。', - ], - 'MaintainEndTime' => [ - 'description' => 'The end time of the maintenance window.'."\n", - 'type' => 'string', - 'example' => '21:00', - 'title' => '可维护时间结束时间。', - ], - 'DeletionProtection' => [ - 'description' => 'Indicates whether the release protection feature is enabled for the cluster.'."\n", - 'type' => 'boolean', - 'example' => '0/1', - 'title' => '是否已开启释放保护功能。', - ], - 'ResourceGroupId' => [ - 'description' => 'The resource ID.'."\n", - 'type' => 'string', - 'example' => 'rg-acfmzygvt54****', - 'title' => '资源ID。', - ], - 'Tags' => [ - 'description' => 'The details of the tags.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'The details of the tag.'."\n", - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => 'The key of the tag.'."\n", - 'type' => 'string', - 'example' => 'id', - 'title' => '标签的名称。', - ], - 'Value' => [ - 'description' => 'The value of the tag.'."\n", - 'type' => 'string', - 'example' => 'ck', - 'title' => '标签的值。', - ], - ], - 'title' => '标签信息。', - ], - 'title' => '标签信息。', - ], - 'Nodes' => [ - 'description' => 'The nodes.'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'The node.'."\n", - 'type' => 'object', - 'properties' => [ - 'ZoneId' => [ - 'description' => 'The zone ID.'."\n", - 'type' => 'string', - 'example' => 'cn-hangzhou-h', - 'title' => '可用区ID。', - ], - 'NodeStatus' => [ - 'description' => 'The node status.'."\n", - 'type' => 'string', - 'example' => 'active', - 'title' => '节点运行状态。', - ], - ], - 'title' => '节点信息。', - ], - 'title' => '节点信息。', - ], - 'CreateTime' => [ - 'description' => 'The time when the cluster was created. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format.'."\n", - 'type' => 'string', - 'example' => '2023-09-14T08:14:48Z', - 'title' => '集群的创建时间，格式：yyyy-MM-ddTHH:mm:ssZ。', - ], - 'EngineMinorVersion' => [ - 'description' => 'The minor engine version of the cluster.'."\n", - 'type' => 'string', - 'example' => '23.8.1.41495_6', - 'title' => '集群引擎的小版本号。', - ], - 'LatestEngineMinorVersion' => [ - 'description' => 'The latest minor engine version.'."\n", - 'type' => 'string', - 'example' => '23.8.1.41495_6', - 'title' => '最新内核小版本号。', - ], - 'DisabledPorts' => [ - 'description' => 'The disabled database ports. Multiple database ports are separated by commas (,).'."\n", - 'type' => 'string', - 'example' => '9001,8123', - 'title' => '禁用指定数据库端口，支持传入英文逗号（,）隔开的多个端口。', - ], - 'ZoneId' => [ - 'description' => 'The zone ID.'."\n", - 'type' => 'string', - 'example' => 'cn-hangzhou-h', - 'title' => '可用区ID。', - ], - 'StorageQuota' => [ - 'title' => '存储预购量（GB）。', - 'type' => 'string', - 'example' => '100', - ], - 'NodeScaleMax' => [ - 'title' => 'Serverless节点弹性最大值。', - 'type' => 'string', - 'example' => '32', - ], - 'NodeScaleMin' => [ - 'title' => 'Serverless节点弹性最小值。', - 'type' => 'string', - 'example' => '4', - ], - 'NodeCount' => [ - 'title' => '节点数量。', - 'type' => 'string', - 'example' => '2', - ], - 'Category' => [ - 'title' => '类型，取值说明：'."\n" - ."\n" - .'- enterprise 企业版', - 'type' => 'string', - 'example' => 'enterprise', - ], - 'ClickObserveServiceStatus' => [ - 'title' => 'ClickObserve服务状态', - 'type' => 'string', - 'example' => 'activation', - ], + 'DBInstanceId' => ['description' => 'The cluster ID.'."\n", 'type' => 'string', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'Account' => ['description' => 'The name of the account.'."\n", 'type' => 'string', 'example' => 'test1', 'title' => ''], ], - 'title' => '返回结果。', + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'InvalidDBInstanceState.NotSupport', 'errorMessage' => 'The specified instance state does\'t support this operation.', 'description' => ''], + ], + [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'The passed instance ID does not exist.'], + ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Description\\": \\"集群测试\\",\\n \\"Engine\\": \\"clickhouse\\",\\n \\"EngineVersion\\": \\"23.8\\",\\n \\"AliUid\\": 0,\\n \\"Bid\\": \\"PD39050615820269****\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"DeploySchema\\": \\"single_az\\",\\n \\"MultiZones\\": [\\n {\\n \\"VSwitchIds\\": [\\n \\"vsw-bj9kpwhcb9iekphje1ljz\\"\\n ],\\n \\"ZoneId\\": \\"cn-hangzhou-h\\"\\n }\\n ],\\n \\"ChargeType\\": \\"POSTPAY\\",\\n \\"Status\\": \\"ACTIVATION\\",\\n \\"VpcId\\": \\"vpc-wz9duj8xd6r1gzhsg*****\\",\\n \\"VSwitchId\\": \\"vsw-uf67ij56zm9x4uc6hmilg\\",\\n \\"ScaleMin\\": 8,\\n \\"ScaleMax\\": 32,\\n \\"StorageSize\\": 12,\\n \\"StorageType\\": \\"100\\",\\n \\"ObjectStoreSize\\": \\"13\\",\\n \\"ExpireTime\\": \\"2024-04-17T08:14:48Z\\",\\n \\"LockMode\\": \\"0\\",\\n \\"LockReason\\": \\"nolock\\",\\n \\"MaintainStartTime\\": \\"11:00Z\\",\\n \\"MaintainEndTime\\": \\"12:00Z\\",\\n \\"DeletionProtection\\": true,\\n \\"ResourceGroupId\\": \\"rg-acfmzygvt54****\\",\\n \\"Tags\\": [\\n {\\n \\"Key\\": \\"id\\",\\n \\"Value\\": \\"ck\\"\\n }\\n ],\\n \\"Nodes\\": [\\n {\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"NodeStatus\\": \\"active\\"\\n }\\n ],\\n \\"CreateTime\\": \\"2023-09-14T08:14:48Z\\",\\n \\"EngineMinorVersion\\": \\"23.8.1.41495_6\\",\\n \\"LatestEngineMinorVersion\\": \\"23.8.1.41495_6\\",\\n \\"DisabledPorts\\": \\"9001,8123\\",\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"StorageQuota\\": \\"100\\",\\n \\"NodeScaleMax\\": \\"32\\",\\n \\"NodeScaleMin\\": \\"4\\",\\n \\"NodeCount\\": \\"2\\",\\n \\"Category\\": \\"enterprise\\",\\n \\"ClickObserveServiceStatus\\": \\"activation\\"\\n }\\n}","type":"json"}]', - 'title' => 'DescribeDBInstanceAttribute', - ], - 'UpgradeMinorVersion' => [ - 'summary' => 'Updates the minor engine version of an ApsaraDB for ClickHouse cluster that runs Enterprise Edition.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'title' => 'DeleteAccount', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteAccount', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"21D06907-CEA5-561D-B6B1-198BCCE99ED1\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Account\\": \\"test1\\"\\n }\\n}","type":"json"}]', + ], + 'DeleteBackupPolicy' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '196979', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseN0HBPQ', - ], - 'tenantRelevance' => 'tenant', + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '206399', + 'abilityTreeNodes' => ['FEATUREclickhouseN8BUWF'], ], 'parameters' => [ [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'title' => '实例ID', - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp1jyis8p15we****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-xxxxx'], ], [ - 'name' => 'SwitchTimeMode', + 'name' => 'RegionId', 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cn-hangzhou'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'title' => '切换模式', - 'description' => 'Specifies whether to update the minor engine version of the cluster immediately. Valid values:'."\n" - ."\n" - .'* **Immediate**: The system immediately performs the update.'."\n" - .'* **MaintainTime**: The system performs the update during the specified maintenance window.'."\n" - .'* **SpecifyTime**: The system performs the update at a specified time.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'Immediate', - 'default' => 'Immediate', - 'enum' => [ - 'Immediate', - 'MaintainTime', - 'SpecifyTime', + 'title' => 'Schema of Response', + 'description' => 'The response that is returned.', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => '60DDD29D-E5A8-563C-88FB-06D3A1F1C609'], + ], + 'example' => '', + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'DeleteBackupPolicy', + 'summary' => 'Deletes the backup policy for a ClickHouse Enterprise Edition cluster.', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"60DDD29D-E5A8-563C-88FB-06D3A1F1C609\\"\\n}","type":"json"}]', + ], + 'DeleteDB' => [ + 'summary' => 'Call this operation to delete a database.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'SwitchTime', + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185312', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => '指定时间点切换时，指定切换时间点。', - 'description' => 'The update time. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.'."\n" - ."\n" - .'> If you set SwitchTimeMode to SpecifyTime, you must configure this parameter to specify the update time.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '2023-01-09T05:00:00Z', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ - 'name' => 'TargetMinorVersion', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'title' => '目标内核小版本，默认升级到最新。', - 'description' => 'The minor engine version to which you want to update.'."\n" - ."\n" - .'> By default, TargetMinorVersion is not set and the minor engine version of the cluster is updated to the latest version.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '23.8.1.41495_6', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-bp100p4q1g9z3****'], ], [ - 'name' => 'RegionId', + 'name' => 'DBName', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The name of the target database.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'testdb001'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'FE242962-6DA3-5FC8-9691-37B62A3210F7', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => '06798FEE-BEF2-5FAF-A30D-728973BBE97C'], 'Data' => [ - 'description' => 'The returned result.'."\n", + 'description' => 'The returned data.', 'type' => 'object', 'properties' => [ - 'DBInstanceName' => [ - 'description' => 'The instance ID.'."\n", - 'type' => 'string', - 'example' => 'cc-uf6x229yeq166****', - ], + 'DBInstanceId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp100p4q1g9z3****'], + 'DBName' => ['description' => 'The database name.', 'type' => 'string', 'title' => '', 'example' => 'testdb001'], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'InvalidDBInstanceState.NotSupport', 'errorMessage' => 'The specified instance state does\'t support this operation.', 'description' => ''], + ], + [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'The passed instance ID does not exist.'], + ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FE242962-6DA3-5FC8-9691-37B62A3210F7\\",\\n \\"Data\\": {\\n \\"DBInstanceName\\": \\"cc-uf6x229yeq166****\\"\\n }\\n}","type":"json"}]', - 'title' => 'UpgradeMinorVersion', - ], - 'CreateAccount' => [ - 'summary' => 'Creates a database account for an ApsaraDB for ClickHouse Enterprise Edition cluster.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', + 'title' => 'DeleteDB', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteDB', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"06798FEE-BEF2-5FAF-A30D-728973BBE97C\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"DBName\\": \\"testdb001\\"\\n }\\n}","type":"json"}]', + ], + 'DeleteDBInstance' => [ + 'summary' => 'The DeleteDBInstance operation releases an ApsaraDB for ClickHouse Enterprise Edition cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -2090,237 +1677,173 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185272', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseL1079N', - ], + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'DBInstanceId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => 'cn-hangzhou'], ], [ - 'name' => 'AccountType', + 'name' => 'DBInstanceId', 'in' => 'query', + 'schema' => ['description' => 'The ID of the target cluster.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-bp100p4q1g9z3****'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The type of the database account. Valid values:'."\n" - ."\n" - .'* **NormalAccount**: standard account'."\n" - .'* **SuperAccount**: privileged account'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'NormalAccount', - 'enum' => [ - 'SuperAccount', - 'NormalAccount', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], + 'Data' => [ + 'description' => 'The returned data.', + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp100p4q1g9z3****'], + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', + ], + ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'The passed instance ID does not exist.'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'DeleteDBInstance', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteDBInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\"\\n }\\n}","type":"json"}]', + ], + 'DeleteEndpoint' => [ + 'summary' => 'Deletes a public endpoint.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'Account', + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185385', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the account.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'test1', - ], + 'schema' => ['description' => 'The ID of the region.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'Password', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The password of the database account. The password must meet the following requirements:'."\n" - ."\n" - .'- The password must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.'."\n" - .'- The following special characters are supported: ! @ # $ % ^ & * ( ) _ + - ='."\n" - .'- The password must be 8 to 32 characters in length.', - 'type' => 'string', - 'required' => true, - 'example' => 'a1b2c3d4@', - ], - ], - [ - 'name' => 'DmlAuthSetting', - 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'description' => 'The information about permissions.'."\n", - 'type' => 'object', - 'properties' => [ - 'DmlAuthority' => [ - 'description' => 'Specifies whether to grant the DML permissions to the database account. Valid values:'."\n" - ."\n" - .'* **0**: The account has the permissions to read data from the database, write data to the database, and modify the settings of the database.'."\n" - .'* **1**: The account only has the permissions to read data from the database.'."\n" - .'* **2**: The account only has the permissions to read data from the database and modify the settings of the database.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '0', - 'enum' => [ - '0', - '1', - '2', - ], - ], - 'DdlAuthority' => [ - 'description' => 'Specifies whether to grant the DDL permissions to the database account. Valid values:'."\n" - ."\n" - .'* **true**: The account has the permissions to execute DDL statements.'."\n" - .'* **false**: The account does not have the permissions to execute DDL statements.'."\n", - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'AllowDictionaries' => [ - 'description' => 'The dictionaries on which you want to grant permissions. Separate multiple dictionaries with commas (,).'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'The dictionary on which you want to grant permissions. Separate multiple dictionaries with commas (,).'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'dc1,dc2', - ], - 'required' => false, - ], - 'AllowDatabases' => [ - 'description' => 'The databases on which you want to grant permissions. Separate multiple databases with commas (,).'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'The database on which you want to grant permissions. Separate multiple databases with commas (,).'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'db1,db2', - ], - 'required' => false, - ], - ], - 'required' => false, - ], + 'schema' => ['description' => 'The ID of the cluster.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], ], [ - 'name' => 'RegionId', + 'name' => 'ConnectionString', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The connection string of the public endpoint to delete.', 'type' => 'string', 'required' => false, 'example' => 'cc-bp100p4q1g9z3****-clickhouse.clickhouseserver.rds.aliyuncs.com', 'title' => ''], ], [ - 'name' => 'Product', + 'name' => 'DBInstanceNetType', 'in' => 'query', 'schema' => [ - 'description' => 'The code of the cloud service.'."\n", + 'description' => 'The network type of the endpoint. Valid values:'."\n" + ."\n" + .'- VPC: a virtual private cloud (VPC) network.'."\n" + ."\n" + .'- Public: a public network.', + 'enumValueTitles' => ['Vpc' => '', 'Public' => ''], 'type' => 'string', 'required' => false, - 'example' => 'clickhouse', - 'default' => 'clickhouse', + 'example' => 'Public', + 'title' => '', ], ], [ - 'name' => 'Description', + 'name' => 'ComputingGroupId', 'in' => 'query', - 'schema' => [ - 'description' => 'The description of the account.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'Used for account', - ], + 'schema' => ['description' => 'The ID of the computing group.', 'type' => 'string', 'required' => false, 'example' => 'cc-2ze34****-clickhouse', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'description' => 'The response object.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', - ], - 'Data' => [ - 'description' => 'The data returned.'."\n", - 'type' => 'object', - 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'Account' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'example' => 'test1', - ], - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The ID of the request.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], ], + 'example' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidAccountType.Malformed', - 'errorMessage' => 'The specified parameter "AccountType" is not valid.', - ], - [ - 'errorCode' => 'InvalidAccountName.Malformed', - 'errorMessage' => 'The specified parameter "Account" is not valid.', - ], - [ - 'errorCode' => 'InvalidAccountPassword.Malformed', - 'errorMessage' => 'The specified parameter "Password" is not valid.', - ], - ], - 403 => [ - [ - 'errorCode' => 'InvalidDBInstanceState.NotSupport', - 'errorMessage' => 'The specified instance state does\'t support this operation.', - ], - ], - [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', - ], + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'The passed instance ID does not exist.'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA****\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Account\\": \\"test1\\"\\n }\\n}","type":"json"}]', - 'title' => 'CreateAccount', - ], - 'DeleteAccount' => [ - 'summary' => 'Deletes a database account from an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","type":"json"}]', + 'title' => 'DeleteEndpoint', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteEndpoint', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + ], + 'DeleteLangfuseInstance' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -2330,120 +1853,65 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'delete', - 'abilityTreeCode' => '185273', - 'abilityTreeNodes' => [ - 'FEATUREclickhouse2H8YOY', - ], + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ - [ - 'name' => 'DBInstanceId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], - ], - [ - 'name' => 'Account', - 'in' => 'query', - 'schema' => [ - 'description' => 'The destination database account.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], - ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'Product', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The code of the cloud service.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'clickhouse', - 'default' => 'clickhouse', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', + 'title' => '', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '21D06907-CEA5-561D-B6B1-198BCCE99ED1', - ], + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], 'Data' => [ - 'description' => 'The data returned.'."\n", + 'description' => 'The response data.', 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'Account' => [ - 'description' => 'The name of the account.'."\n", - 'type' => 'string', - 'example' => 'test1', - ], + 'DBInstanceId' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'example' => 'lfs-****', 'title' => ''], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], 'errorCodes' => [ - 403 => [ - [ - 'errorCode' => 'InvalidDBInstanceState.NotSupport', - 'errorMessage' => 'The specified instance state does\'t support this operation.', - ], - ], - [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', - ], + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"21D06907-CEA5-561D-B6B1-198BCCE99ED1\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Account\\": \\"test1\\"\\n }\\n}","type":"json"}]', - 'title' => 'DeleteAccount', + 'title' => 'Release a langfuse instance', + 'summary' => 'Releases a Langfuse instance.', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"lfs-****\\"\\n }\\n}","type":"json"}]', ], - 'ResetAccountPassword' => [ - 'summary' => 'Resets the password of a database account for an ApsaraDB for ClickHouse Enterprise Edition cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'DeleteLangfuseOrg' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -2455,134 +1923,69 @@ 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185276', - 'abilityTreeNodes' => [ - 'FEATUREclickhouse2H8YOY', - ], + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ - [ - 'name' => 'DBInstanceId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], - ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'Account', - 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'test1', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'Password', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The password of the database account. The password must meet the following requirements:'."\n" - ."\n" - .'- The password must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.'."\n" - .'- The following special characters are supported: ! @ # $ % ^ & * ( ) _ + - ='."\n" - .'- The password must be 8 to 32 characters in length.', - 'type' => 'string', - 'required' => true, - 'example' => '123456Aa', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'Product', + 'name' => 'OrganizationId', 'in' => 'query', - 'schema' => [ - 'description' => 'The service name.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'clickhouse', - 'default' => 'clickhouse', - ], + 'schema' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', + 'title' => '', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '5A6A077A-577C-536E-AC13-8E715D7A34C8', - ], + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F76'], 'Data' => [ - 'description' => 'The result returned.'."\n", + 'description' => 'The response result.', 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'Account' => [ - 'description' => 'The name of the account.'."\n", - 'type' => 'string', - 'example' => 'test1', - ], + 'DBInstanceId' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'example' => 'lfs-****', 'title' => ''], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], 'errorCodes' => [ - 403 => [ - [ - 'errorCode' => 'InvalidDBInstanceState.NotSupport', - 'errorMessage' => 'The specified instance state does\'t support this operation.', - ], - ], - [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', - ], + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"5A6A077A-577C-536E-AC13-8E715D7A34C8\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Account\\": \\"test1\\"\\n }\\n}","type":"json"}]', - 'title' => 'ResetAccountPassword', + 'title' => 'Delete a langfuse organization', + 'summary' => 'Deletes a Langfuse organization.', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F76\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"lfs-****\\"\\n }\\n}","type":"json"}]', ], - 'ModifyAccountDescription' => [ - 'summary' => 'Modifies the description of a database account.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'DeleteLangfuseOrgMembership' => [ + 'summary' => 'Removes a user from a Langfuse organization.', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -2594,119 +1997,73 @@ 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185303', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-xxxxxxx', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'Account', + 'name' => 'OrganizationId', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the account.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'testuser', - ], + 'schema' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], ], [ - 'name' => 'Description', + 'name' => 'Email', 'in' => 'query', - 'schema' => [ - 'description' => 'The description of the account.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'schema' => ['description' => 'The email address of the user.', 'type' => 'string', 'required' => true, 'example' => 'john@company.com', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'title' => '', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'xxx-xxx-xxx', - ], + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0'], 'Data' => [ - 'description' => 'The returned data.'."\n", + 'description' => 'The response result.', 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-xxxxx', - ], - 'Account' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'example' => 'testuser', - ], + 'Email' => ['description' => 'The email address of the user.', 'type' => 'string', 'example' => 'john@company.com', 'title' => ''], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], 'errorCodes' => [ - 403 => [ - [ - 'errorCode' => 'InvalidDBInstanceState.NotSupport', - 'errorMessage' => 'The specified instance state does\'t support this operation.', - ], - ], - [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', - ], + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7FFC9EBE-5023-5D5D-A5F0-1607E0F2****\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp1anv7jo84t****\\",\\n \\"Account\\": \\"testuser\\"\\n }\\n}","type":"json"}]', - 'title' => 'ModifyAccountDescription', + 'title' => 'Remove a user from a langfuse organization', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\",\\n \\"Data\\": {\\n \\"Email\\": \\"john@company.com\\"\\n }\\n}","type":"json"}]', ], - 'ModifyAccountAuthority' => [ - 'summary' => 'Modifies the permissions of a database account.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'DeleteLangfuseProject' => [ + 'summary' => 'Deletes a Langfuse project.', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -2718,168 +2075,64 @@ 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185304', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'Account', + 'name' => 'OrganizationId', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'test1', - ], + 'schema' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], ], [ - 'name' => 'DmlAuthSetting', + 'name' => 'ProjectId', 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'description' => 'The information about permissions.'."\n", - 'type' => 'object', - 'properties' => [ - 'DmlAuthority' => [ - 'description' => 'Specifies whether to grant the DML permissions to the database account. Valid values:'."\n" - ."\n" - .'* **0**: The account has the permissions to read data from the database, write data to the database, and modify the settings of the database.'."\n" - .'* **1**: The account only has the permissions to read data from the database.'."\n" - .'* **2**: The account only has the permissions to read data from the database and modify the settings of the database.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '0', - 'enum' => [ - '0', - '1', - '2', - ], - ], - 'DdlAuthority' => [ - 'description' => 'Specifies whether to grant the DDL permissions to the database account. Valid values:'."\n" - ."\n" - .'* **true**: The account has the permissions to execute DDL statements.'."\n" - .'* **false**: The account does not have the permissions to execute DDL statements.'."\n", - 'type' => 'boolean', - 'required' => true, - 'example' => 'true', - ], - 'AllowDictionaries' => [ - 'description' => 'The dictionaries on which you want to grant permissions. Separate multiple dictionaries with commas (,).'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'The dictionary on which you want to grant permissions. Separate multiple dictionaries with commas (,).'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'db1,db2', - ], - 'required' => false, - ], - 'AllowDatabases' => [ - 'description' => 'The databases on which you want to grant permissions. Separate multiple databases with commas (,).'."\n", - 'type' => 'array', - 'items' => [ - 'description' => 'The database on which you want to grant permissions. Separate multiple databases with commas (,).'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'db1,db2', - ], - 'required' => false, - ], - ], - 'required' => true, - ], + 'schema' => ['description' => 'The Langfuse project ID.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', + 'title' => '', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0', - ], - 'Data' => [ - 'description' => 'The result returned.'."\n", - 'type' => 'object', - 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'Account' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'example' => 'test1', - ], - ], - ], + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], ], + 'example' => '', ], ], ], 'errorCodes' => [ - 403 => [ - [ - 'errorCode' => 'InvalidDBInstanceState.NotSupport', - 'errorMessage' => 'The specified instance state does\'t support this operation.', - ], - ], - [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', - ], + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Account\\": \\"test1\\"\\n }\\n}","type":"json"}]', - 'title' => 'ModifyAccountAuthority', + 'title' => 'Delete a langfuse project', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","type":"json"}]', ], - 'DescribeAccounts' => [ - 'summary' => 'Queries database accounts for an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'DeleteLangfuseUser' => [ + 'summary' => 'Deletes a Langfuse user.', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -2888,181 +2141,186 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185288', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'PageNumber', + 'name' => 'Email', 'in' => 'query', + 'schema' => ['description' => 'The email address of the user.', 'type' => 'string', 'required' => true, 'example' => 'john@company.com', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The page number.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '1', + 'title' => '', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], + 'Data' => [ + 'description' => 'The response result.', + 'type' => 'object', + 'properties' => [ + 'Email' => ['description' => 'The email address of the user.', 'type' => 'string', 'example' => 'john@company.com', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', ], ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'Delete a langfuse user', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"Data\\": {\\n \\"Email\\": \\"john@company.com\\"\\n }\\n}","type":"json"}]', + ], + 'DeleteWhitelistTemplate' => [ + 'summary' => 'Deletes a whitelist template.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185639', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + ], + 'parameters' => [ [ - 'name' => 'PageSize', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries per page. Valid values:'."\n" - ."\n" - .'* **30** (default)'."\n" - .'* **50**'."\n" - .'* **100**'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '30', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'Product', + 'name' => 'TemplateId', 'in' => 'query', - 'schema' => [ - 'description' => 'The code of the cloud service.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'clickhouse', - 'default' => 'clickhouse', - ], + 'schema' => ['description' => 'The whitelist template ID.', 'type' => 'string', 'required' => true, 'example' => '98a6d3db05984dca', 'title' => ''], + ], + [ + 'name' => 'TemplateName', + 'in' => 'query', + 'schema' => ['description' => 'The name of the whitelist template.', 'type' => 'string', 'example' => '98a6d3db05984dca', 'title' => '', 'required' => false], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '1234567890', 'title' => ''], 'Data' => [ - 'description' => 'The result returned.'."\n", + 'title' => '', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => 'The total number of entries returned.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageNumber' => [ - 'description' => 'The page number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => 'The number of entries per page. Valid values:'."\n" - ."\n" - .'* **30** (default)'."\n" - .'* **50**'."\n" - .'* **100**'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'Accounts' => [ - 'description' => 'The database accounts.'."\n", + 'Templates' => [ 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'Account' => [ - 'description' => 'The username of the database account.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'Description' => [ - 'description' => 'The description.'."\n", - 'type' => 'string', - 'example' => 'Used for test', - ], - 'AccountType' => [ - 'description' => 'The type of the database account. Valid values:'."\n" - ."\n" - .'* **1**: standard account'."\n" - .'* **6**: privileged account'."\n", - 'type' => 'string', - 'example' => 'NormalAccount', - ], - 'Status' => [ - 'description' => 'The state of the database account. Valid values:'."\n" - ."\n" - .'* **0**: The database account is being created.'."\n" - .'* **1**: The database account is in use.'."\n" - .'* **3**: The database account is being deleted.'."\n", - 'type' => 'string', - 'example' => '1', + 'TemplateId' => ['description' => 'The whitelist template ID.', 'type' => 'string', 'example' => 'g-asdfwem', 'title' => ''], + 'SecurityIPList' => ['description' => 'The IP whitelist.', 'type' => 'string', 'example' => '192.168.1.1,10.0.0.1', 'title' => ''], + 'DbInstances' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DbInstanceName' => ['description' => 'The ID of the instance.', 'type' => 'string', 'example' => 'asdfwef', 'title' => ''], + ], + 'description' => 'Details of an associated instance.', + 'title' => '', + 'example' => '', + ], + 'description' => 'The instances associated with the template.', + 'title' => '', + 'example' => '', ], ], - 'description' => '', + 'description' => 'Details of a whitelist template.', + 'title' => '', + 'example' => '', ], + 'description' => 'The whitelist templates.', + 'title' => '', + 'example' => '', ], ], + 'description' => 'The data returned from the call.', + 'example' => '', ], ], + 'description' => 'The response data.', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records. ', - ], + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Invalid parameter.', 'description' => ''], + ['errorCode' => 'InvalidWhitelistTemplateId', 'errorMessage' => 'Invalid Whitelist templateId.', 'description' => ''], + ['errorCode' => 'InvalidWhitelistTemplate.IllegalPermission', 'errorMessage' => 'No permission to operate the whitelist template.', 'description' => ''], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"Data\\": {\\n \\"TotalCount\\": 1,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"Accounts\\": [\\n {\\n \\"Account\\": \\"test\\",\\n \\"Description\\": \\"测试使用\\",\\n \\"AccountType\\": \\"1\\",\\n \\"Status\\": \\"1\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => 'DescribeAccounts', + 'title' => 'DeleteWhitelistTemplate', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteWhitelistTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1234567890\\",\\n \\"Data\\": {\\n \\"Templates\\": [\\n {\\n \\"TemplateId\\": \\"g-asdfwem\\",\\n \\"SecurityIPList\\": \\"192.168.1.1,10.0.0.1\\",\\n \\"DbInstances\\": [\\n {\\n \\"DbInstanceName\\": \\"asdfwef\\"\\n }\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', ], 'DescribeAccountAuthority' => [ - 'summary' => 'Queries the permissions of a database account.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -3075,161 +2333,122 @@ 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '185309', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-bp100p4q1g9z3****'], ], [ 'name' => 'Account', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'test1', - ], + 'schema' => ['description' => 'The name of the database account.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'test1'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'description' => 'The details of the response.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC911****'], 'Data' => [ - 'description' => 'The returned result.'."\n", + 'description' => 'The returned data.', 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'Account' => [ - 'description' => 'The name of the database account.'."\n", - 'type' => 'string', - 'example' => 'test1', - ], - 'DmlAuthority' => [ - 'description' => 'Indicates whether the DML permissions are granted to the database account. Valid values:'."\n" - ."\n" - .'* 0: The account has the permissions to read data from the database, write data to the database, and modify the settings of the database.'."\n" - .'* 1: The account only has the permissions to read data from the database.'."\n" - .'* 2: The account only has the permissions to read data from the database and modify the settings of the database.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'DdlAuthority' => [ - 'description' => 'Indicates whether the DDL permissions are granted to the database account. Valid values:'."\n" - ."\n" - .'* **true**: The account has the permissions to execute DDL statements.'."\n" - .'* **false**: The account does not have the permissions to execute DDL statements.'."\n", - 'type' => 'boolean', - 'example' => 'true', - ], + 'DBInstanceId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp100p4q1g9z3****'], + 'Account' => ['description' => 'The name of the database account.', 'type' => 'string', 'title' => '', 'example' => 'test1'], + 'DmlAuthority' => ['description' => 'The DML permissions that are granted to the database account. Valid values:'."\n" + ."\n" + .'- 0: Read, write, and change settings queries are allowed.'."\n" + ."\n" + .'- 1: Only read data queries are allowed.'."\n" + ."\n" + .'- 2: Read data and change settings queries are allowed.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '0'], + 'DdlAuthority' => ['description' => 'Indicates whether DDL permissions are granted to the database account. Valid values:'."\n" + ."\n" + .'- **true**: DDL operations are allowed.'."\n" + ."\n" + .'- **false**: DDL operations are prohibited.', 'type' => 'boolean', 'title' => '', 'example' => 'true'], 'AllowDatabases' => [ - 'description' => 'The databases on which permissions are granted.'."\n", + 'description' => 'A list of authorized databases.', 'type' => 'array', - 'items' => [ - 'description' => 'The database on which permissions are granted.'."\n", - 'type' => 'string', - 'example' => 'db1', - ], + 'items' => ['description' => 'A list of authorized databases.', 'type' => 'string', 'title' => '', 'example' => 'db1'], + 'title' => '', + 'example' => '', ], 'AllowDictionaries' => [ - 'description' => 'The dictionaries on which permissions are granted.'."\n", + 'description' => 'A list of authorized dictionaries.', 'type' => 'array', - 'items' => [ - 'description' => 'The dictionary on which permissions are granted.'."\n", - 'type' => 'string', - 'example' => 'dt1', - ], + 'items' => ['description' => 'A list of authorized dictionaries.', 'type' => 'string', 'title' => '', 'example' => 'dt1'], + 'title' => '', + 'example' => '', ], 'TotalDatabases' => [ - 'description' => 'All databases.'."\n", + 'description' => 'A list of all databases.', 'type' => 'array', - 'items' => [ - 'description' => 'The databases.'."\n", - 'type' => 'string', - 'example' => 'db1,db2', - ], + 'items' => ['description' => 'A list of all databases.', 'type' => 'string', 'title' => '', 'example' => 'db1,db2'], + 'title' => '', + 'example' => '', ], 'TotalDictionaries' => [ - 'description' => 'The database.'."\n", + 'description' => 'The database.', 'type' => 'array', - 'items' => [ - 'description' => 'The dictionary of a database. The value is in the db.dict format.'."\n", - 'type' => 'string', - 'example' => 'test1.range_key_dict', - ], + 'items' => ['description' => 'A dictionary in a database. The format is db.dict.', 'type' => 'string', 'title' => '', 'example' => 'test1.range_key_dict'], + 'title' => '', + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], 'errorCodes' => [ 404 => [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidAccountName.NotFound', - 'errorMessage' => 'Specified account name does not exist.', - ], + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'The passed instance ID does not exist.'], + ['errorCode' => 'InvalidAccountName.NotFound', 'errorMessage' => 'Specified account name does not exist.', 'description' => 'The specified account name does not exist.'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC911****\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Account\\": \\"test1\\",\\n \\"DmlAuthority\\": 0,\\n \\"DdlAuthority\\": true,\\n \\"AllowDatabases\\": [\\n \\"db1\\"\\n ],\\n \\"AllowDictionaries\\": [\\n \\"dt1\\"\\n ],\\n \\"TotalDatabases\\": [\\n \\"db1,db2\\"\\n ],\\n \\"TotalDictionaries\\": [\\n \\"test1.range_key_dict\\"\\n ]\\n }\\n}","type":"json"}]', 'title' => 'DescribeAccountAuthority', - ], - 'CreateDB' => [ - 'summary' => 'Creates an ApsaraDB for ClickHouse database.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'summary' => 'Call the DescribeAccountAuthority operation to query the permissions of an account.', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAccountAuthority', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC911****\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Account\\": \\"test1\\",\\n \\"DmlAuthority\\": 0,\\n \\"DdlAuthority\\": true,\\n \\"AllowDatabases\\": [\\n \\"db1\\"\\n ],\\n \\"AllowDictionaries\\": [\\n \\"dt1\\"\\n ],\\n \\"TotalDatabases\\": [\\n \\"db1,db2\\"\\n ],\\n \\"TotalDictionaries\\": [\\n \\"test1.range_key_dict\\"\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeAccounts' => [ + 'summary' => 'Queries database accounts for an ApsaraDB for ClickHouse cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -3238,60 +2457,44 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185311', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '185288', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], ], [ - 'name' => 'DBName', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => 'The database name. The name must meet the following requirements:'."\n" - ."\n" - .'* The name can contain lowercase letters, digits, underscores (\\_), and hyphens (-).'."\n" - .'* The name must start with a lowercase letter and end with a lowercase letter or digit.'."\n" - .'* The name can be up to 64 characters in length.'."\n" - ."\n" - .'> An underscore (\\_) is counted as two characters.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'testdb001', - ], + 'schema' => ['description' => 'The page number.', 'type' => 'string', 'required' => false, 'example' => '1', 'title' => ''], ], [ - 'name' => 'Comment', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'Database remark information.', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['description' => 'The number of entries per page. Valid values:'."\n" + ."\n" + .'- **30** (default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'string', 'required' => false, 'example' => '30', 'title' => ''], + ], + [ + 'name' => 'Product', + 'in' => 'query', + 'schema' => ['description' => 'The code of the cloud service.', 'type' => 'string', 'default' => 'clickhouse', 'required' => false, 'example' => 'clickhouse', 'title' => ''], ], ], 'responses' => [ @@ -3301,65 +2504,170 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '94F92113-FF63-5E57-8401-6FE123AD11DD', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], 'Data' => [ - 'description' => 'The data returned.'."\n", + 'description' => 'The result returned.', 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'DBName' => [ - 'description' => 'The name of the database.'."\n", - 'type' => 'string', - 'example' => 'testdb001', + 'TotalCount' => ['description' => 'The total number of entries returned.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'PageNumber' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'PageSize' => ['description' => 'The number of entries per page. Valid values:'."\n" + ."\n" + .'- **30** (default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'example' => '30', 'title' => ''], + 'Accounts' => [ + 'description' => 'The database accounts.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Account' => ['description' => 'The username of the database account.', 'type' => 'string', 'example' => 'test', 'title' => ''], + 'Description' => ['description' => 'The description.', 'type' => 'string', 'example' => 'For testing', 'title' => ''], + 'AccountType' => ['description' => 'The type of the database account. Valid values:'."\n" + ."\n" + .'- **1**: standard account'."\n" + ."\n" + .'- **6**: privileged account', 'type' => 'string', 'example' => '1', 'title' => ''], + 'Status' => ['description' => 'The state of the database account. Valid values:'."\n" + ."\n" + .'- **0**: The database account is being created.'."\n" + ."\n" + .'- **1**: The database account is in use.'."\n" + ."\n" + .'- **3**: The database account is being deleted.', 'type' => 'string', 'example' => '1', 'title' => ''], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], 'errorCodes' => [ - 403 => [ - [ - 'errorCode' => 'InvalidDBInstanceState.NotSupport', - 'errorMessage' => 'The specified instance state does\'t support this operation.', + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records. ', 'description' => ''], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"Data\\": {\\n \\"TotalCount\\": 1,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"Accounts\\": [\\n {\\n \\"Account\\": \\"test\\",\\n \\"Description\\": \\"For testing\\",\\n \\"AccountType\\": \\"1\\",\\n \\"Status\\": \\"1\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + 'title' => 'DescribeAccounts', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAccounts', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], ], ], + ], + 'translator' => 'manual', + ], + 'DescribeBackupPolicy' => [ + 'summary' => 'Queries the backup policy of a ClickHouse Enterprise Edition cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], + 'security' => [ [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', - ], + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '206399', + 'abilityTreeNodes' => ['FEATUREclickhouseIL81EM'], + ], + 'parameters' => [ + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'The data returned.', + 'type' => 'object', + 'properties' => [ + 'PreferredBackupPeriod' => ['description' => 'The backup cycle. Valid values:'."\n" + ."\n" + .'- **Monday**'."\n" + .'- **Tuesday**'."\n" + .'- **Wednesday**'."\n" + .'- **Thursday**'."\n" + .'- **Friday**'."\n" + .'- **Saturday**'."\n" + .'- **Sunday**', 'type' => 'string', 'example' => 'Monday', 'title' => ''], + 'Switch' => ['description' => 'Indicates whether the backup feature is enabled. Valid values:'."\n" + ."\n" + .'- **true**: The backup feature is enabled.'."\n" + .'- **false**: The backup feature is disabled.', 'type' => 'string', 'example' => 'true', 'title' => ''], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', 'title' => ''], + 'PreferredBackupTime' => ['description' => 'The backup time. The time is in UTC.', 'type' => 'string', 'example' => '15:00Z-16:00Z', 'title' => ''], + 'BackupRetentionPeriod' => ['description' => 'The number of days for which the backup files are retained.', 'type' => 'integer', 'format' => 'int32', 'example' => '7', 'title' => ''], + 'BackupSize' => ['description' => 'The size of the backup file. Unit: MB.', 'type' => 'string', 'example' => '123124', 'title' => ''], + ], + 'example' => '', + ], + ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"94F92113-FF63-5E57-8401-6FE123AD11DD\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"DBName\\": \\"testdb001\\"\\n }\\n}","type":"json"}]', - 'title' => 'CreateDB', - ], - 'DeleteDB' => [ - 'summary' => 'Deletes an ApsaraDB for ClickHouse database.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'title' => 'DescribeBackupPolicy', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PreferredBackupPeriod\\": \\"Monday\\",\\n \\"Switch\\": \\"true\\",\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PreferredBackupTime\\": \\"15:00Z-16:00Z\\",\\n \\"BackupRetentionPeriod\\": 7,\\n \\"BackupSize\\": \\"123124\\"\\n}","type":"json"}]', + ], + 'DescribeBackups' => [ + 'summary' => 'Queries the backup sets of a ClickHouse Enterprise Edition cluster.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -3368,111 +2676,120 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', + 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185312', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '206399', + 'abilityTreeNodes' => ['FEATUREclickhouseIL81EM'], ], 'parameters' => [ + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-bp1v9kq45u0o80cvh'], + ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID. You can call the [DescribeRegions](~~170875~~) operation to query the region ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cn-beijing'], ], [ - 'name' => 'DBInstanceId', + 'name' => 'BackupId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], + 'schema' => ['description' => 'The backup record ID.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => '117403****'], ], [ - 'name' => 'DBName', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the destination database.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'testdb001', - ], + 'schema' => ['description' => 'The beginning of the time range to query. The time is in UTC.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '2021-11-21T16:00Z'], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => 'The end of the time range to query. The time is in UTC.', 'type' => 'string', 'required' => true, 'docRequired' => true, 'title' => '', 'example' => '2021-11-25T16:00Z'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => 'The number of entries to return on each page.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '30', 'default' => '30', 'title' => '', 'example' => '30'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'title' => '', 'example' => '1'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => 'The response.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.', - 'type' => 'string', - 'example' => '06798FEE-BEF2-5FAF-A30D-728973BBE97C', - ], - 'Data' => [ - 'description' => 'The data returned.'."\n", - 'type' => 'object', - 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'DBName' => [ - 'description' => 'The name of the database.'."\n", - 'type' => 'string', - 'example' => 'testdb001', - ], + 'TotalCount' => ['description' => 'The total number of backups.', 'type' => 'string', 'title' => '', 'example' => '1'], + 'PageSize' => ['description' => 'The number of entries returned per page.', 'type' => 'string', 'title' => '', 'example' => '30'], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'title' => '', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], + 'PageNumber' => ['description' => 'The page number.', 'type' => 'string', 'title' => '', 'example' => '1'], + 'Items' => [ + 'description' => 'The list of backup sets.', + 'type' => 'array', + 'items' => [ + 'description' => 'The list of backup sets.', + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The cluster ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp179i5956tih2m93'], + 'BackupStatus' => ['description' => 'The status of the backup set.', 'type' => 'string', 'title' => '', 'example' => 'Success'], + 'BackupType' => ['description' => 'The backup type.'."\n" + .'Valid values:'."\n" + ."\n" + .'- **FullBackup**: full backup.'."\n" + ."\n" + .'- **IncrementalBackup**: incremental backup.', 'type' => 'string', 'title' => '', 'example' => 'IncrementalBackup'], + 'BackupStartTime' => ['description' => 'The start time of the backup.', 'type' => 'string', 'title' => '', 'example' => '2021-11-22T18:28:22Z'], + 'BackupSize' => ['description' => 'The size of the backup file in MB.', 'type' => 'integer', 'format' => 'int64', 'title' => '', 'example' => '131072'], + 'BackupEndTime' => ['description' => 'The end time of the backup. The time is in UTC.', 'type' => 'string', 'title' => '', 'example' => '2021-11-22T18:28:41Z'], + 'BackupSetInfo' => ['description' => 'The information about the backup set.', 'type' => 'string', 'title' => '', 'example' => '{"shard_count": 4}'], + 'BackupId' => ['description' => 'The backup record ID.', 'type' => 'string', 'title' => '', 'example' => '117403****'], + 'BackupMethod' => ['description' => 'The backup method.', 'type' => 'string', 'title' => '', 'example' => 'Physical'], + 'ExpireDate' => ['description' => 'The expiration time of the backup set.', 'type' => 'string', 'title' => '', 'example' => '2022-07-22T18:28:41Z'], + ], + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'errorCodes' => [ - 403 => [ - [ - 'errorCode' => 'InvalidDBInstanceState.NotSupport', - 'errorMessage' => 'The specified instance state does\'t support this operation.', - ], - ], - [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', - ], - ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"06798FEE-BEF2-5FAF-A30D-728973BBE97C\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"DBName\\": \\"testdb001\\"\\n }\\n}","type":"json"}]', - 'title' => 'DeleteDB', - ], - 'DescribeDBInstanceDataSources' => [ - 'summary' => 'Queries the schema of a database or a table.', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', + 'title' => 'DescribeBackups', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeBackups', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"1\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"Items\\": [\\n {\\n \\"DBInstanceId\\": \\"cc-bp179i5956tih2m93\\",\\n \\"BackupStatus\\": \\"Success\\",\\n \\"BackupType\\": \\"IncrementalBackup\\",\\n \\"BackupStartTime\\": \\"2021-11-22T18:28:22Z\\",\\n \\"BackupSize\\": 131072,\\n \\"BackupEndTime\\": \\"2021-11-22T18:28:41Z\\",\\n \\"BackupSetInfo\\": \\"{\\\\\\"shard_count\\\\\\": 4}\\",\\n \\"BackupId\\": \\"117403****\\",\\n \\"BackupMethod\\": \\"Physical\\",\\n \\"ExpireDate\\": \\"2022-07-22T18:28:41Z\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'DescribeDBInstanceAttribute' => [ + 'summary' => 'Call DescribeDBInstanceAttribute to query the details of an ApsaraDB for ClickHouse enterprise edition cluster.', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -3484,50 +2801,25 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185313', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '183134', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], - ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], - ], - [ - 'name' => 'DBName', - 'in' => 'query', - 'schema' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'dbtest', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], ], [ - 'name' => 'TableName', + 'name' => 'RegionId', 'in' => 'query', 'schema' => [ - 'description' => 'The table name.'."\n", + 'description' => 'The region ID. You can call the [~~DescribeRegions~~](cdb.doc.dita#doc-api-clickhouse-DescribeRegions) operation to query the most recent region list.', + 'enumValueTitles' => ['cn-beijing' => 'cn-beijing'], 'type' => 'string', + 'example' => 'cn-hangzhou', + 'title' => '', 'required' => false, - 'example' => 'tableTest', ], ], ], @@ -3535,773 +2827,824 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", + 'description' => 'The response parameters.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F543E6CC-6868-523D-8D28-0E92CF977ED2', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], 'Data' => [ - 'description' => 'The returned result.'."\n", + 'description' => 'The returned data.', 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'Schemas' => [ - 'description' => 'The account.'."\n", - 'type' => 'string', - 'example' => 'default', - ], - 'Tables' => [ - 'description' => 'The tables.'."\n", + 'DBInstanceId' => ['description' => 'The cluster ID.', 'type' => 'string', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'Description' => ['description' => 'The cluster description.', 'type' => 'string', 'example' => 'cluster test', 'title' => ''], + 'Engine' => ['description' => 'The engine.', 'type' => 'string', 'example' => 'clickhouse', 'title' => ''], + 'EngineVersion' => ['description' => 'The engine version.', 'type' => 'string', 'example' => '23.8', 'title' => ''], + 'AliUid' => ['description' => 'The Alibaba Cloud account ID.', 'type' => 'integer', 'format' => 'int64', 'example' => '140692647406****', 'title' => ''], + 'Bid' => ['description' => 'The channel ID.', 'type' => 'string', 'example' => 'PD39050615820269****', 'title' => ''], + 'RegionId' => ['description' => 'The region ID.', 'type' => 'string', 'example' => 'cn-hangzhou', 'title' => ''], + 'DeploySchema' => ['description' => 'The deployment architecture of the cluster. Valid values: `single_az` and `multi_az`.'."\n" + ."\n" + .'- `single_az`: The nodes are deployed in the primary zone specified by `ZoneId`.'."\n" + ."\n" + .'- `multi_az`: The nodes are deployed across the zones specified in `MultiZones`.'."\n" + ."\n" + .'Keeper nodes are always deployed across the zones specified in `MultiZones`.', 'type' => 'string', 'example' => 'single_az', 'title' => ''], + 'MultiZones' => [ + 'description' => 'The zones for a multi-zone deployment.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'VSwitchIds' => [ + 'description' => 'An array of vSwitch IDs.', + 'type' => 'array', + 'items' => ['description' => 'The vSwitch ID.', 'type' => 'string', 'example' => 'vsw-bj9kpwhcb9iekphje1ljz', 'title' => ''], + 'title' => '', + 'example' => '', + ], + 'ZoneId' => ['description' => 'The zone ID.', 'type' => 'string', 'example' => 'cn-hangzhou-h', 'title' => ''], + ], + 'description' => 'Details of a zone.', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + 'ChargeType' => ['description' => 'The billing method of the cluster.'."\n" + .'enterprise edition clusters are billed on a pay-as-you-go basis.', 'type' => 'string', 'example' => 'POSTPAY', 'title' => ''], + 'Status' => ['description' => 'The status of the instance.', 'type' => 'string', 'example' => 'ACTIVATION', 'title' => ''], + 'VpcId' => ['description' => 'The VPC ID.', 'type' => 'string', 'example' => 'vpc-wz9duj8xd6r1gzhsg*****', 'title' => ''], + 'VSwitchId' => ['description' => 'The vSwitch ID.', 'type' => 'string', 'example' => 'vsw-uf67ij56zm9x4uc6hmilg', 'title' => ''], + 'ScaleMin' => ['description' => 'The minimum value for serverless auto scaling.', 'type' => 'integer', 'format' => 'int32', 'example' => '8', 'title' => ''], + 'ScaleMax' => ['description' => 'The maximum value for serverless auto scaling.', 'type' => 'integer', 'format' => 'int32', 'example' => '32', 'title' => ''], + 'StorageSize' => ['description' => 'The storage space, in GB.', 'type' => 'integer', 'format' => 'int32', 'example' => '12', 'title' => ''], + 'StorageType' => ['description' => 'The storage type.', 'type' => 'string', 'example' => '100', 'title' => ''], + 'ObjectStoreSize' => ['description' => 'The storage capacity of Object Storage Service (OSS).', 'type' => 'string', 'example' => '13', 'title' => ''], + 'ExpireTime' => ['description' => 'The expiration time of the cluster, in `YYYY-MM-DDTHH:mm:ssZ` format.'."\n" + ."\n" + .'> Pay-as-you-go clusters do not expire. An empty string is returned.', 'type' => 'string', 'example' => '2024-04-17T08:14:48Z', 'title' => ''], + 'LockMode' => ['description' => 'The lock mode of the cluster.', 'type' => 'string', 'example' => '0', 'title' => ''], + 'LockReason' => ['description' => 'The reason for the lock.', 'type' => 'string', 'example' => 'nolock', 'title' => ''], + 'MaintainStartTime' => ['description' => 'The start time of the maintenance window.', 'type' => 'string', 'example' => '11:00Z', 'title' => ''], + 'MaintainEndTime' => ['description' => 'The end time of the maintenance window.', 'type' => 'string', 'example' => '12:00Z', 'title' => ''], + 'DeletionProtection' => ['description' => 'Whether deletion protection is enabled.', 'type' => 'boolean', 'example' => '0/1', 'title' => ''], + 'ResourceGroupId' => ['description' => 'The resource group ID.', 'type' => 'string', 'example' => 'rg-acfmzygvt54****', 'title' => ''], + 'Tags' => [ + 'description' => 'The cluster tags.', 'type' => 'array', 'items' => [ - 'description' => 'The table.'."\n", - 'type' => 'string', - 'example' => 'table_test', + 'description' => 'Details of a tag.', + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => 'The tag key.', 'type' => 'string', 'example' => 'id', 'title' => ''], + 'Value' => ['description' => 'The tag value.', 'type' => 'string', 'example' => 'ck', 'title' => ''], + ], + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], - 'Columns' => [ - 'description' => 'The columns.'."\n", + 'Nodes' => [ + 'description' => 'The cluster nodes.', 'type' => 'array', 'items' => [ - 'description' => 'The column.'."\n", + 'description' => 'Details of a node.', 'type' => 'object', 'properties' => [ - 'DBName' => [ - 'description' => 'The database name.'."\n", - 'type' => 'string', - 'example' => 'dbtest', - ], - 'Type' => [ - 'description' => 'The type of the stored data.'."\n", - 'type' => 'string', - 'example' => 'UInt64', - ], - 'TableName' => [ - 'description' => 'The table name.'."\n", - 'type' => 'string', - 'example' => 'tableTest', - ], - 'ColumnName' => [ - 'description' => 'The column name.'."\n", - 'type' => 'string', - 'example' => 'c31', - ], - 'PrimaryKey' => [ - 'description' => 'Indicates whether the column is the primary key of the table. Valid values:'."\n" - ."\n" - .'* **true**'."\n" - .'* **false**'."\n", - 'type' => 'string', - 'example' => 'false', - ], - 'Comment' => [ - 'description' => 'The description of the database account.'."\n", - 'type' => 'string', - 'example' => 'Used for test', - ], + 'ZoneId' => ['description' => 'The zone ID.', 'type' => 'string', 'example' => 'cn-hangzhou-h', 'title' => ''], + 'NodeStatus' => ['description' => 'The status of the node.', 'type' => 'string', 'example' => 'active', 'title' => ''], ], + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', + ], + 'CreateTime' => ['description' => 'The creation time of the cluster, in `YYYY-MM-DDTHH:mm:ssZ` format.', 'type' => 'string', 'example' => '2023-09-14T08:14:48Z', 'title' => ''], + 'EngineMinorVersion' => ['description' => 'The minor version of the cluster engine.', 'type' => 'string', 'example' => '23.8.1.41495_6', 'title' => ''], + 'LatestEngineMinorVersion' => ['description' => 'The latest minor version of the cluster engine.', 'type' => 'string', 'example' => '23.8.1.41495_6', 'title' => ''], + 'DisabledPorts' => ['description' => 'A comma-separated list of disabled database ports.', 'type' => 'string', 'example' => '9001,8123', 'title' => ''], + 'ZoneId' => ['description' => 'The zone ID.', 'type' => 'string', 'example' => 'cn-hangzhou-h', 'title' => ''], + 'StorageQuota' => ['description' => 'The provisioned storage, in GB.', 'type' => 'string', 'example' => '100', 'title' => ''], + 'NodeScaleMax' => ['description' => 'The maximum number of nodes for auto scaling of a serverless cluster.', 'type' => 'string', 'example' => '32', 'title' => ''], + 'NodeScaleMin' => ['description' => 'The minimum number of nodes for auto scaling of a serverless cluster.', 'type' => 'string', 'example' => '4', 'title' => ''], + 'NodeCount' => ['description' => 'The number of nodes.', 'type' => 'string', 'example' => '2', 'title' => ''], + 'Category' => ['description' => 'The edition of the cluster. Valid value:'."\n" + ."\n" + .'- `enterprise`: enterprise edition', 'type' => 'string', 'example' => 'enterprise', 'title' => ''], + 'ClickObserveServiceStatus' => ['description' => 'The status of the ClickObserve service.', 'type' => 'string', 'example' => 'activation', 'title' => ''], + 'LangfuseInstanceIds' => [ + 'type' => 'array', + 'items' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'example' => 'lfs-2ze172q******', 'title' => ''], + 'description' => 'A list of Langfuse instance IDs.', + 'title' => '', + 'example' => '', ], + 'WebUISnatStatus' => ['type' => 'string', 'example' => 'active', 'description' => '', 'title' => ''], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound ', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', - ], - ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F543E6CC-6868-523D-8D28-0E92CF977ED2\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Schemas\\": \\"default\\",\\n \\"Tables\\": [\\n \\"table_test\\"\\n ],\\n \\"Columns\\": [\\n {\\n \\"DBName\\": \\"dbtest\\",\\n \\"Type\\": \\"UInt64\\",\\n \\"TableName\\": \\"tableTest\\",\\n \\"ColumnName\\": \\"c31\\",\\n \\"PrimaryKey\\": \\"false\\",\\n \\"Comment\\": \\"测试\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => 'DescribeDBInstanceDataSources', - ], - 'CreateEndpoint' => [ - 'summary' => 'Applies for a public endpoint.', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', + 'title' => 'DescribeDBInstanceAttribute', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBInstanceAttribute', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Description\\": \\"cluster test\\",\\n \\"Engine\\": \\"clickhouse\\",\\n \\"EngineVersion\\": \\"23.8\\",\\n \\"AliUid\\": 0,\\n \\"Bid\\": \\"PD39050615820269****\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"DeploySchema\\": \\"single_az\\",\\n \\"MultiZones\\": [\\n {\\n \\"VSwitchIds\\": [\\n \\"vsw-bj9kpwhcb9iekphje1ljz\\"\\n ],\\n \\"ZoneId\\": \\"cn-hangzhou-h\\"\\n }\\n ],\\n \\"ChargeType\\": \\"POSTPAY\\",\\n \\"Status\\": \\"ACTIVATION\\",\\n \\"VpcId\\": \\"vpc-wz9duj8xd6r1gzhsg*****\\",\\n \\"VSwitchId\\": \\"vsw-uf67ij56zm9x4uc6hmilg\\",\\n \\"ScaleMin\\": 8,\\n \\"ScaleMax\\": 32,\\n \\"StorageSize\\": 12,\\n \\"StorageType\\": \\"100\\",\\n \\"ObjectStoreSize\\": \\"13\\",\\n \\"ExpireTime\\": \\"2024-04-17T08:14:48Z\\",\\n \\"LockMode\\": \\"0\\",\\n \\"LockReason\\": \\"nolock\\",\\n \\"MaintainStartTime\\": \\"11:00Z\\",\\n \\"MaintainEndTime\\": \\"12:00Z\\",\\n \\"DeletionProtection\\": true,\\n \\"ResourceGroupId\\": \\"rg-acfmzygvt54****\\",\\n \\"Tags\\": [\\n {\\n \\"Key\\": \\"id\\",\\n \\"Value\\": \\"ck\\"\\n }\\n ],\\n \\"Nodes\\": [\\n {\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"NodeStatus\\": \\"active\\"\\n }\\n ],\\n \\"CreateTime\\": \\"2023-09-14T08:14:48Z\\",\\n \\"EngineMinorVersion\\": \\"23.8.1.41495_6\\",\\n \\"LatestEngineMinorVersion\\": \\"23.8.1.41495_6\\",\\n \\"DisabledPorts\\": \\"9001,8123\\",\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"StorageQuota\\": \\"100\\",\\n \\"NodeScaleMax\\": \\"32\\",\\n \\"NodeScaleMin\\": \\"4\\",\\n \\"NodeCount\\": \\"2\\",\\n \\"Category\\": \\"enterprise\\",\\n \\"ClickObserveServiceStatus\\": \\"activation\\",\\n \\"LangfuseInstanceIds\\": [\\n \\"lfs-2ze172q******\\"\\n ],\\n \\"WebUISnatStatus\\": \\"active\\"\\n }\\n}","type":"json"}]', + ], + 'DescribeDBInstanceConfig' => [ + 'methods' => ['get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185384', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseZHDS8I', - ], + 'abilityTreeCode' => '204414', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The instance ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-wz9go4x*****'], ], [ - 'name' => 'DBInstanceId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], - ], - [ - 'name' => 'DBInstanceNetType', - 'in' => 'query', - 'schema' => [ - 'description' => 'The network type.'."\n" - ."\n" - .'Valid values:'."\n" - ."\n" - .'* Public'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'Public', - 'enum' => [ - 'Public', - ], - ], - ], - [ - 'name' => 'ConnectionPrefix', - 'in' => 'query', - 'schema' => [ - 'description' => 'The prefix of the new endpoint. The prefix of the ConnectionString parameter.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cc-bp100p4q1g9z3****-clickhouse.clickhouseserver.rds.aliyuncs.com', - ], - ], - [ - 'name' => 'ComputingGroupId', - 'in' => 'query', - 'schema' => [ - 'type' => 'string', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'title' => '', + 'description' => 'The response schema', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', + 'RequestId' => ['title' => '', 'description' => 'The ID of the request', 'type' => 'string', 'example' => '66428721-xxxx-xxxx-xxxx-3BD1B67837E0'."\n"], + 'Data' => [ + 'description' => 'The returned results.', + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The instance ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-bp100p4q1g9z3****'], + 'Params' => [ + 'description' => 'The user parameters.', + 'type' => 'array', + 'items' => [ + 'description' => 'The user parameters.', + 'type' => 'object', + 'properties' => [ + 'IsDynamic' => ['description' => 'Indicates whether the parameter takes effect dynamically (without requiring a restart).', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '1'], + 'IsUserModifiable' => ['description' => 'Indicates whether the parameter can be modified by users.', 'type' => 'integer', 'format' => 'int32', 'title' => '', 'example' => '1'], + 'DefaultValue' => ['description' => 'The default value of the parameter.', 'type' => 'string', 'title' => '', 'example' => '1'], + 'Name' => ['description' => 'The parameter name.', 'type' => 'string', 'title' => '', 'example' => 'max_concurrent_queries'], + 'Optional' => ['description' => 'The valid values of the parameter.', 'type' => 'string', 'title' => '', 'example' => '[0-100]'], + 'Comment' => ['description' => 'The parameter description.', 'type' => 'string', 'title' => '', 'example' => 'Maximum number of concurrently executed queries. Zero means unlimited.'], + 'ParamRelyRule' => ['description' => 'The parameter dependencies.', 'type' => 'string', 'title' => '', 'example' => '0'], + 'Value' => ['description' => 'The value of the parameter.', 'type' => 'string', 'title' => '', 'example' => '100'], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","type":"json"}]', - 'title' => 'CreateEndpoint', - ], - 'DeleteEndpoint' => [ - 'summary' => 'Releases a public endpoint.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'title' => 'DescribeDBInstanceConfig', + 'summary' => 'Queries the parameter configuration of an instance', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBInstanceConfig', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"66428721-xxxx-xxxx-xxxx-3BD1B67837E0\\\\n\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Params\\": [\\n {\\n \\"IsDynamic\\": 1,\\n \\"IsUserModifiable\\": 1,\\n \\"DefaultValue\\": \\"1\\",\\n \\"Name\\": \\"max_concurrent_queries\\",\\n \\"Optional\\": \\"[0-100]\\",\\n \\"Comment\\": \\"Maximum number of concurrently executed queries. Zero means unlimited.\\",\\n \\"ParamRelyRule\\": \\"0\\",\\n \\"Value\\": \\"100\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeDBInstanceConfigChangeLog' => [ + 'summary' => 'Queries the parameter configuration records of an instance', + 'methods' => ['get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '185385', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'operationType' => 'none', + 'abilityTreeCode' => '206401', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], ], 'parameters' => [ + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The instance ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-uf6lkzf*****', 'title' => ''], + ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-shanghai', 'title' => ''], ], [ - 'name' => 'DBInstanceId', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], + 'schema' => ['description' => 'The start time of the query. Format: yyyy-MM-dd hh:mm:ss.', 'type' => 'string', 'required' => true, 'example' => '2025-01-01 10:00:00', 'title' => ''], ], [ - 'name' => 'ConnectionString', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => 'The prefix of the endpoint, which indicates the prefix of the value of the ConnectionString parameter.', - 'type' => 'string', - 'required' => false, - 'example' => 'cc-bp100p4q1g9z3****-clickhouse.clickhouseserver.rds.aliyuncs.com', - ], + 'schema' => ['description' => 'The end time of the query. Format: yyyy-MM-dd hh:mm:ss.', 'type' => 'string', 'required' => true, 'example' => '2025-01-01 10:00:00'."\n", 'title' => ''], ], [ - 'name' => 'DBInstanceNetType', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'type' => 'string', - 'required' => false, - ], + 'schema' => ['description' => 'The number of entries to return per page. Default value: 30. Valid values:'."\n" + ."\n" + .'- **30** (default)'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', 'default' => '30', 'title' => ''], ], [ - 'name' => 'ComputingGroupId', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'type' => 'string', - ], + 'schema' => ['description' => 'The page number to return.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', 'default' => '1', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', + 'title' => '', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => '780DE414-*********-88BE-A2E21B862B57'], + 'Data' => [ + 'description' => 'The result set.', + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The instance ID.', 'type' => 'string', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'ParamChangeLogs' => [ + 'description' => 'The parameter change records.', + 'type' => 'array', + 'items' => [ + 'description' => 'The parameter change record.', + 'type' => 'object', + 'properties' => [ + 'ID' => ['description' => 'The operation ID.', 'type' => 'integer', 'format' => 'int64', 'example' => '1', 'title' => ''], + 'Name' => ['description' => 'The name of the parameter.', 'type' => 'string', 'example' => 'max_concurrent_queries', 'title' => ''], + 'OldValue' => ['description' => 'The old parameter value.', 'type' => 'string', 'example' => '50', 'title' => ''], + 'NewValue' => ['description' => 'The new parameter value.', 'type' => 'string', 'example' => '100', 'title' => ''], + 'Applied' => ['description' => 'Indicates whether the configuration takes effect:'."\n" + ."\n" + .'- true: The execution plan takes effect.'."\n" + .'- false: The execution plan does not take effect.', 'type' => 'boolean', 'title' => '', 'example' => ''], + 'GmtCreated' => ['description' => 'The time when the change was created.', 'type' => 'string', 'example' => '2025-06-25 13:46:06', 'title' => ''], + 'GmtModified' => ['description' => 'The time when the change was modified.', 'type' => 'string', 'example' => '2025-06-25 13:46:06'."\n", 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', - ], - ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","type":"json"}]', - 'title' => 'DeleteEndpoint', - ], - 'ModifyDBInstanceConnectionString' => [ - 'summary' => 'Modifies the endpoint of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', + 'title' => ' ', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBInstanceConfigChangeLog', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"780DE414-*********-88BE-A2E21B862B57\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"ParamChangeLogs\\": [\\n {\\n \\"ID\\": 1,\\n \\"Name\\": \\"max_concurrent_queries\\",\\n \\"OldValue\\": \\"50\\",\\n \\"NewValue\\": \\"100\\",\\n \\"Applied\\": false,\\n \\"GmtCreated\\": \\"2025-06-25 13:46:06\\",\\n \\"GmtModified\\": \\"2025-06-25 13:46:06\\\\n\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeDBInstanceDataSources' => [ + 'summary' => 'Queries the schema of a database or a table.', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'high', + 'operationType' => 'get', + 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '186649', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '185313', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-xxxxx', - ], - ], - [ - 'name' => 'ConnectionString', - 'in' => 'query', - 'schema' => [ - 'description' => 'The endpoint of the cluster.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cc-2ze34****-clickhouse..clickhouseserver.pre.rds.aliyuncs.com', - ], - ], - [ - 'name' => 'ConnectionStringPrefix', - 'in' => 'query', - 'schema' => [ - 'description' => 'The prefix of the endpoint that is used to connect to the database.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cc-****-clickhouse', - ], - ], - [ - 'name' => 'DisablePorts', - 'in' => 'query', - 'schema' => [ - 'description' => '* The database ports that you want to disable. Separate multiple ports with commas (,).'."\n" - ."\n" - .'* This parameter is supported only for clusters whose minor engine version is 24.10.1.11098\\_1 or later.'."\n" - ."\n" - .' **'."\n" - ."\n" - .' **Note** If you create a cluster whose minor engine version is earlier than 24.10.1.11098\\_1 and you update the minor engine version to 24.10.1.11098\\_1 or later, the cluster still does not support this parameter.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '9001,8123', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], ], [ - 'name' => 'DBInstanceNetType', + 'name' => 'DBName', 'in' => 'query', - 'schema' => [ - 'type' => 'string', - 'required' => false, - 'enum' => [ - 'Public', - ], - ], + 'schema' => ['description' => 'The database name.', 'type' => 'string', 'required' => false, 'example' => 'dbtest', 'title' => ''], ], [ - 'name' => 'ComputingGroupId', + 'name' => 'TableName', 'in' => 'query', - 'schema' => [ - 'type' => 'string', - ], + 'schema' => ['description' => 'The table name.', 'type' => 'string', 'required' => false, 'example' => 'tableTest', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'xxx-xxx-xxx', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'F543E6CC-6868-523D-8D28-0E92CF977ED2'], 'Data' => [ - 'description' => 'The data returned.'."\n", + 'description' => 'The returned result.', 'type' => 'object', 'properties' => [ - 'DBInstanceID' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => 'cc-xxxxx', - ], - 'ConnectionString' => [ - 'description' => 'The endpoint of the cluster.'."\n", - 'type' => 'string', - 'example' => 'cc-2ze34****-clickhouse..clickhouseserver.pre.rds.aliyuncs.com', - ], - 'DBInstanceName' => [ - 'description' => 'The cluster name.'."\n", - 'type' => 'string', - 'example' => 'cc-xxxxx', + 'DBInstanceId' => ['description' => 'The cluster ID.', 'type' => 'string', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'Schemas' => ['description' => 'The account.', 'type' => 'string', 'example' => 'default', 'title' => ''], + 'Tables' => [ + 'description' => 'The tables.', + 'type' => 'array', + 'items' => ['description' => 'The table.', 'type' => 'string', 'example' => 'table_test', 'title' => ''], + 'title' => '', + 'example' => '', ], - 'DisabledPorts' => [ - 'description' => 'The disabled database ports.'."\n", - 'type' => 'string', - 'example' => '9001,8123', + 'Columns' => [ + 'description' => 'The columns.', + 'type' => 'array', + 'items' => [ + 'description' => 'The column.', + 'type' => 'object', + 'properties' => [ + 'DBName' => ['description' => 'The database name.', 'type' => 'string', 'example' => 'dbtest', 'title' => ''], + 'Type' => ['description' => 'The type of the stored data.', 'type' => 'string', 'example' => 'UInt64', 'title' => ''], + 'TableName' => ['description' => 'The table name.', 'type' => 'string', 'example' => 'tableTest', 'title' => ''], + 'ColumnName' => ['description' => 'The column name.', 'type' => 'string', 'example' => 'c31', 'title' => ''], + 'PrimaryKey' => ['description' => 'Indicates whether the column is the primary key of the table. Valid values:'."\n" + ."\n" + .'- **true**'."\n" + ."\n" + .'- **false**', 'type' => 'string', 'example' => 'false', 'title' => ''], + 'Comment' => ['description' => 'The description of the database account.', 'type' => 'string', 'example' => 'Test', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound ', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => ''], + ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"ConnectionString\\": \\"cc-2ze34****-clickhouse..clickhouseserver.pre.rds.aliyuncs.com\\",\\n \\"DBInstanceName\\": \\"cc-xxxxx\\",\\n \\"DisabledPorts\\": \\"9001,8123\\"\\n }\\n}","type":"json"}]', - 'title' => 'ModifyDBInstanceConnectionString', - ], - 'ModifySecurityIPList' => [ - 'summary' => 'Modifies the whitelist settings of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F543E6CC-6868-523D-8D28-0E92CF977ED2\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Schemas\\": \\"default\\",\\n \\"Tables\\": [\\n \\"table_test\\"\\n ],\\n \\"Columns\\": [\\n {\\n \\"DBName\\": \\"dbtest\\",\\n \\"Type\\": \\"UInt64\\",\\n \\"TableName\\": \\"tableTest\\",\\n \\"ColumnName\\": \\"c31\\",\\n \\"PrimaryKey\\": \\"false\\",\\n \\"Comment\\": \\"Test\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + 'title' => 'DescribeDBInstanceDataSources', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBInstanceDataSources', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'translator' => 'manual', + ], + 'DescribeDBInstances' => [ + 'summary' => 'Call the DescribeDBInstances API to query a list of DB instances.', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185639', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '183135', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'DBInstanceId', + 'name' => 'DBInstanceIds', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-xxxxx', - ], + 'schema' => ['description' => 'A comma-separated list of instance IDs.', 'type' => 'string', 'required' => false, 'example' => 'cc-xxxxx,cx-xxxx', 'title' => ''], ], [ - 'name' => 'GroupName', + 'name' => 'VpcIds', 'in' => 'query', - 'schema' => [ - 'description' => 'The name of the whitelist whose settings you want to modify.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['description' => 'A comma-separated list of VPC IDs.', 'type' => 'string', 'example' => 'vpc-2ze4ee9z******,vpc-2ze4ee9z5l******', 'title' => '', 'required' => false], ], [ - 'name' => 'SecurityIPList', + 'name' => 'DBInstanceStatus', 'in' => 'query', - 'schema' => [ - 'description' => 'The IP addresses and CIDR blocks in the whitelist.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '192.168.0.0/24,172.16.0.0/24', - ], + 'schema' => ['description' => 'The instance status.', 'type' => 'string', 'required' => false, 'example' => 'active', 'title' => ''], ], [ - 'name' => 'ModifyMode', + 'name' => 'Description', 'in' => 'query', - 'schema' => [ - 'description' => 'The modification mode.'."\n" - ."\n" - .'* 0: overwrites the original IP addresses and CIDR blocks in the whitelist.'."\n" - .'* 1: adds the IP addresses and CIDR blocks to the whitelist.'."\n" - .'* 2: removes the IP addresses and CIDR blocks from the whitelist.'."\n" - ."\n" - .'> We recommend that you set the value to 0.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '0', - ], + 'schema' => ['description' => 'The instance description.', 'type' => 'string', 'required' => false, 'example' => 'test', 'title' => ''], ], - ], - 'responses' => [ + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => 'The number of entries per page.', 'type' => 'integer', 'format' => 'int32', 'default' => '30', 'required' => false, 'example' => '30', 'title' => ''], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'default' => '1', 'required' => false, 'example' => '1', 'title' => ''], + ], + [ + 'name' => 'ResourceGroupId', + 'in' => 'query', + 'schema' => ['description' => 'The resource group ID.', 'type' => 'string', 'required' => false, 'example' => 'rg-4690g37929****', 'title' => ''], + ], + [ + 'name' => 'Tags', + 'in' => 'query', + 'style' => 'repeatList', + 'schema' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => 'The tag key.', 'type' => 'string', 'example' => 'user_123', 'title' => '', 'required' => false], + 'Value' => ['description' => 'The tag value.', 'type' => 'string', 'example' => 'example value', 'title' => '', 'required' => false], + ], + 'title' => '', + 'description' => 'A tag, which is a key-value pair.', + 'required' => false, + 'example' => '', + ], + 'maxItems' => 20, + 'title' => '', + 'description' => 'The tags for filtering instances.', + 'required' => false, + 'example' => 'DescribeDBInstances', + ], + ], + ], + 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'description' => 'The details of the response.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'xxx-xxx-xxx', - ], 'Data' => [ - 'description' => 'The returned result.'."\n", + 'description' => 'The response data.', 'type' => 'object', 'properties' => [ - 'GroupName' => [ - 'description' => 'The name of the whitelist.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'SecurityIPType' => [ - 'description' => 'The IP address type.'."\n", - 'type' => 'string', - 'example' => 'ipv4', - ], - 'GroupTag' => [ - 'description' => 'The tag of the whitelist.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'TaskId' => [ - 'description' => 'The task ID.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'SecurityIPList' => [ - 'description' => 'The IP addresses and CIDR blocks in the whitelist.'."\n", - 'type' => 'string', - 'example' => '192.168.0.0/24,172.16.0.0/24', - ], - 'DBInstanceID' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => 'cc-xxxx', - ], - 'WhitelistNetType' => [ - 'description' => 'The network type of the whitelist.'."\n", - 'type' => 'string', - 'example' => 'mix', - ], - 'DBInstanceName' => [ - 'description' => 'The cluster name.'."\n", - 'type' => 'string', - 'example' => 'cc-xxxx', + 'TotalCount' => ['description' => 'The total number of entries.', 'type' => 'string', 'example' => '1', 'title' => ''], + 'PageSize' => ['description' => 'The number of entries per page.', 'type' => 'integer', 'format' => 'int32', 'example' => '30', 'title' => ''], + 'PageNumber' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'DBInstances' => [ + 'description' => 'The list of instance details.', + 'type' => 'array', + 'items' => [ + 'description' => 'Details of an instance.', + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The instance ID.', 'type' => 'string', 'example' => 'cc-xxxxxxx', 'title' => ''], + 'Description' => ['description' => 'The instance description.', 'type' => 'string', 'example' => 'test_desc', 'title' => ''], + 'Engine' => ['description' => 'The engine.', 'type' => 'string', 'example' => 'clickhouse', 'title' => ''], + 'EngineVersion' => ['description' => 'The engine version.', 'type' => 'string', 'example' => '22.8', 'title' => ''], + 'AliUid' => ['description' => 'The account ID.', 'type' => 'string', 'example' => '1294****', 'title' => ''], + 'Bid' => ['description' => 'The channel ID.', 'type' => 'string', 'example' => '186681****', 'title' => ''], + 'RegionId' => ['description' => 'The region ID.', 'type' => 'string', 'example' => 'cn-hangzhou', 'title' => ''], + 'ZoneId' => ['description' => 'The zone ID.', 'type' => 'string', 'example' => 'cn-hangzhou-i', 'title' => ''], + 'ChargeType' => ['description' => 'The billing method for the instance. Valid values:'."\n" + ."\n" + .'- `PrePaid`: subscription.'."\n" + ."\n" + .'- `PostPaid`: pay-as-you-go.', 'type' => 'string', 'example' => 'PostPaid', 'title' => ''], + 'Status' => ['description' => 'The instance status.', 'type' => 'string', 'example' => 'active', 'title' => ''], + 'VpcId' => ['description' => 'The VPC ID.', 'type' => 'string', 'example' => 'vpc-uf6kg****', 'title' => ''], + 'VSwitchId' => ['description' => 'The vSwitch ID.', 'type' => 'string', 'example' => 'vsw-8vb5mw****', 'title' => ''], + 'ScaleMin' => ['description' => 'The minimum compute capacity for serverless elastic scaling.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'ScaleMax' => ['description' => 'The maximum compute capacity for serverless elastic scaling.', 'type' => 'integer', 'format' => 'int32', 'example' => '13', 'title' => ''], + 'ExpireTime' => ['description' => 'The expiration time.', 'type' => 'string', 'example' => '2024-02-16 11:51:06', 'title' => ''], + 'LockMode' => ['description' => 'The lock mode.', 'type' => 'string', 'example' => '0', 'title' => ''], + 'LockReason' => ['description' => 'The reason for the lock.', 'type' => 'string', 'example' => 'null', 'title' => ''], + 'MaintainStartTime' => ['description' => 'The maintenance window start time.', 'type' => 'string', 'example' => '00:00Z', 'title' => ''], + 'MaintainEndTime' => ['description' => 'The maintenance window end time.', 'type' => 'string', 'example' => '04:00:00Z', 'title' => ''], + 'DeletionProtection' => ['description' => 'Indicates whether deletion protection is enabled.', 'type' => 'string', 'example' => 'False', 'title' => ''], + 'ResourceGroupId' => ['description' => 'The resource group ID.', 'type' => 'string', 'example' => 'rg-acfmzy****', 'title' => ''], + 'CreateTime' => ['description' => 'The instance creation time.', 'type' => 'string', 'example' => '2022-12-04 21:16:15', 'title' => ''], + 'Tags' => [ + 'description' => 'The tags attached to the instance.', + 'type' => 'array', + 'items' => [ + 'description' => 'A tag.', + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => 'The tag key.', 'type' => 'string', 'example' => 'tag', 'title' => ''], + 'Value' => ['description' => 'The tag value.', 'type' => 'string', 'example' => 'test', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + 'StorageType' => ['description' => 'The instance storage type.', 'type' => 'string', 'example' => 'oss', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => 'xxx-xxx-xxx', 'title' => ''], ], + 'example' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records. ', - ], - ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\",\\n \\"Data\\": {\\n \\"GroupName\\": \\"test\\",\\n \\"SecurityIPType\\": \\"ipv4\\",\\n \\"GroupTag\\": \\"test\\",\\n \\"TaskId\\": 1,\\n \\"SecurityIPList\\": \\"192.168.0.0/24,172.16.0.0/24\\",\\n \\"DBInstanceID\\": 0,\\n \\"WhitelistNetType\\": \\"mix\\",\\n \\"DBInstanceName\\": \\"cc-xxxx\\"\\n }\\n}","type":"json"}]', - 'title' => 'ModifySecurityIPList', - ], - 'DescribeSecurityIPList' => [ - 'summary' => 'Queries the whitelist of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Data\\": {\\n \\"TotalCount\\": \\"1\\",\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"DBInstances\\": [\\n {\\n \\"DBInstanceId\\": \\"cc-xxxxxxx\\",\\n \\"Description\\": \\"test_desc\\",\\n \\"Engine\\": \\"clickhouse\\",\\n \\"EngineVersion\\": \\"22.8\\",\\n \\"AliUid\\": \\"1294****\\",\\n \\"Bid\\": \\"186681****\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"ZoneId\\": \\"cn-hangzhou-i\\",\\n \\"ChargeType\\": \\"PostPaid\\",\\n \\"Status\\": \\"active\\",\\n \\"VpcId\\": \\"vpc-uf6kg****\\",\\n \\"VSwitchId\\": \\"vsw-8vb5mw****\\",\\n \\"ScaleMin\\": 1,\\n \\"ScaleMax\\": 13,\\n \\"ExpireTime\\": \\"2024-02-16 11:51:06\\",\\n \\"LockMode\\": \\"0\\",\\n \\"LockReason\\": \\"null\\",\\n \\"MaintainStartTime\\": \\"00:00Z\\",\\n \\"MaintainEndTime\\": \\"04:00:00Z\\",\\n \\"DeletionProtection\\": \\"False\\",\\n \\"ResourceGroupId\\": \\"rg-acfmzy****\\",\\n \\"CreateTime\\": \\"2022-12-04 21:16:15\\",\\n \\"Tags\\": [\\n {\\n \\"Key\\": \\"tag\\",\\n \\"Value\\": \\"test\\"\\n }\\n ],\\n \\"StorageType\\": \\"oss\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"xxx-xxx-xxx\\"\\n}","type":"json"}]', + 'title' => 'DescribeDBInstances', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBInstances', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + ], + 'DescribeEndpoints' => [ + 'summary' => 'To retrieve the cluster endpoints, call DescribeEndpoints.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '185650', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185373', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-xxxxx', 'title' => ''], + ], + [ + 'name' => 'ComputingGroupId', + 'in' => 'query', + 'schema' => ['description' => 'The computing group ID.', 'type' => 'string', 'example' => 'cc-*****-clickhouse', 'title' => '', 'required' => false], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'description' => 'The response parameters.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'xxx-xxx-xxx'], 'Data' => [ - 'description' => 'The data returned.'."\n", + 'description' => 'The response data.', 'type' => 'object', 'properties' => [ - 'DBInstanceID' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'DBInstanceName' => [ - 'description' => 'The cluster name.'."\n", - 'type' => 'string', - 'example' => 'TestCluster', - ], - 'GroupItems' => [ - 'description' => 'The details about the whitelists.'."\n", + 'InstanceNetworkType' => ['description' => 'The network type of the instance. Valid values:'."\n" + ."\n" + .'- **VPC**'."\n" + ."\n" + .'- **PUBLIC**: Internet.', 'type' => 'string', 'example' => 'VPC', 'title' => ''], + 'Endpoints' => [ + 'description' => 'The endpoints.', 'type' => 'array', 'items' => [ - 'description' => 'The details about the whitelist.'."\n", + 'description' => 'The details of an endpoint.', 'type' => 'object', 'properties' => [ - 'GroupName' => [ - 'description' => 'The name of the whitelist.'."\n", - 'type' => 'string', - 'example' => 'default', - ], - 'SecurityIPType' => [ - 'description' => 'The IP address type.'."\n", - 'type' => 'string', - 'example' => 'ipv4', - ], - 'GroupTag' => [ - 'description' => 'The tag of the whitelist.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'SecurityIPList' => [ - 'description' => 'The IP addresses and CIDR blocks in the whitelist.'."\n", - 'type' => 'string', - 'example' => '127.0.XX.XX', - ], - 'WhitelistNetType' => [ - 'description' => 'The network type of the whitelist.'."\n", - 'type' => 'string', - 'example' => 'mix', + 'NetType' => ['description' => 'The network type of the endpoint. Valid values:'."\n" + ."\n" + .'- VPC'."\n" + ."\n" + .'- PUBLIC: Internet.', 'type' => 'string', 'example' => 'VPC', 'title' => ''], + 'Status' => ['description' => 'The status of the endpoint.', 'type' => 'string', 'example' => 'active', 'title' => ''], + 'ConnectionString' => ['description' => 'The instance connection string.', 'type' => 'string', 'example' => 'cc-****-clickhouse.clickhouseserver.pre.rds.aliyuncs.com', 'title' => ''], + 'VpcId' => ['description' => 'The VPC ID.', 'type' => 'string', 'example' => 'vpc-uf61z****', 'title' => ''], + 'VSwitchId' => ['description' => 'The vSwitch ID.', 'type' => 'string', 'example' => 'vsw-0xi8829****', 'title' => ''], + 'VpcInstanceId' => ['description' => 'The VPC instance ID.', 'type' => 'string', 'example' => 'vpc-uf61z****', 'title' => ''], + 'Ports' => [ + 'description' => 'The ports.', + 'type' => 'array', + 'items' => [ + 'description' => 'The details of a port.', + 'type' => 'object', + 'properties' => [ + 'Protocol' => ['description' => 'The protocol type. Valid values:'."\n" + ."\n" + .'- HttpPort: HTTP port.'."\n" + ."\n" + .'- HttpsPort: HTTPS port.'."\n" + ."\n" + .'- TcpPort: TCP port.', 'type' => 'string', 'example' => 'HttpPort', 'title' => ''], + 'Port' => ['description' => 'The port number. The value varies based on the protocol type. For example:'."\n" + ."\n" + .'- HttpPort: 8123'."\n" + ."\n" + .'- HttpsPort: 8443'."\n" + ."\n" + .'- TcpPort: 9000', 'type' => 'integer', 'format' => 'int32', 'example' => '8123', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', ], + 'IPAddress' => ['description' => 'The IP address.', 'type' => 'string', 'example' => '172.30.XX.XX', 'title' => ''], + 'ComputingGroupId' => ['description' => 'The computing group ID.', 'type' => 'string', 'example' => 'cc-ad321**-clickhouse', 'title' => ''], + 'EndpointName' => ['description' => 'The endpoint name.', 'type' => 'string', 'example' => 'cc-*****-clickhouse', 'title' => ''], ], + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'The passed instance ID does not exist.'], + ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"集群测试\\",\\n \\"GroupItems\\": [\\n {\\n \\"GroupName\\": \\"default\\",\\n \\"SecurityIPType\\": \\"ipv4\\",\\n \\"GroupTag\\": \\"test\\",\\n \\"SecurityIPList\\": \\"127.0.XX.XX\\",\\n \\"WhitelistNetType\\": \\"mix\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => 'DescribeSecurityIPList', - ], - 'DescribeEndpoints' => [ - 'summary' => 'Queries the endpoint of an ApsaraDB for ClickHouse cluster.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\",\\n \\"Data\\": {\\n \\"InstanceNetworkType\\": \\"VPC\\",\\n \\"Endpoints\\": [\\n {\\n \\"NetType\\": \\"VPC\\",\\n \\"Status\\": \\"active\\",\\n \\"ConnectionString\\": \\"cc-****-clickhouse.clickhouseserver.pre.rds.aliyuncs.com\\",\\n \\"VpcId\\": \\"vpc-uf61z****\\",\\n \\"VSwitchId\\": \\"vsw-0xi8829****\\",\\n \\"VpcInstanceId\\": \\"vpc-uf61z****\\",\\n \\"Ports\\": [\\n {\\n \\"Protocol\\": \\"HttpPort\\",\\n \\"Port\\": 8123\\n }\\n ],\\n \\"IPAddress\\": \\"172.30.XX.XX\\",\\n \\"ComputingGroupId\\": \\"cc-ad321**-clickhouse\\",\\n \\"EndpointName\\": \\"cc-*****-clickhouse\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + 'title' => 'DescribeEndpoints', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeEndpoints', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + ], + 'DescribeLangfuseEndpoints' => [ + 'summary' => 'Queries the access endpoint of a Langfuse instance.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -4310,190 +3653,110 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '185373', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-xxxxx', - ], - ], - [ - 'name' => 'ComputingGroupId', - 'in' => 'query', - 'schema' => [ - 'title' => '计算组ID。', - 'type' => 'string', - 'example' => 'cc-*****-clickhouse', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'title' => '', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'xxx-xxx-xxx', - ], + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], 'Data' => [ - 'description' => 'The returned result.'."\n", + 'description' => 'The returned data.', 'type' => 'object', 'properties' => [ - 'InstanceNetworkType' => [ - 'description' => 'The network type of the cluster. Valid values:'."\n" - ."\n" - .'* **VPC**'."\n" - .'* **PUBLIC**'."\n", - 'type' => 'string', - 'example' => 'VPC', - ], + 'InstanceNetworkType' => ['description' => 'The network type of the instance. Valid values:'."\n" + ."\n" + .'* **VPC**: virtual private cloud (VPC).', 'type' => 'string', 'example' => 'VPC', 'title' => ''], 'Endpoints' => [ - 'description' => 'The details of the endpoints.'."\n", + 'description' => 'The list of endpoints.', 'type' => 'array', 'items' => [ - 'description' => 'The details of the endpoint.'."\n", + 'description' => 'The list of endpoints.', 'type' => 'object', 'properties' => [ - 'NetType' => [ - 'description' => 'The network type of the endpoint. Valid values:'."\n" - ."\n" - .'* VPC'."\n" - .'* PUBLIC'."\n", - 'type' => 'string', - 'example' => 'VPC', - ], - 'Status' => [ - 'description' => 'The state of the cluster.'."\n", - 'type' => 'string', - 'example' => 'active', - ], - 'ConnectionString' => [ - 'description' => 'The endpoint of the cluster.'."\n", - 'type' => 'string', - 'example' => 'cc-****-clickhouse.clickhouseserver.pre.rds.aliyuncs.com', - ], - 'VpcId' => [ - 'description' => 'The ID of the virtual private cloud (VPC).'."\n", - 'type' => 'string', - 'example' => 'vpc-uf61z****', - ], - 'VSwitchId' => [ - 'description' => 'The vSwitch ID.'."\n", - 'type' => 'string', - 'example' => 'vsw-0xi8829****', - ], - 'VpcInstanceId' => [ - 'description' => 'The VPC ID.'."\n", - 'type' => 'string', - 'example' => 'vpc-uf61z****', - ], + 'NetType' => ['description' => 'The network type of the endpoint. Valid values:'."\n" + ."\n" + .'- VPC: VPC.'."\n" + .'- PUBLIC: Internet.', 'type' => 'string', 'example' => 'VPC', 'title' => ''], + 'ConnectionString' => ['description' => 'The endpoint of the instance.', 'type' => 'string', 'example' => 'lfs-2zeejcvmzn1******.com', 'title' => ''], + 'VpcId' => ['description' => 'VPC ID。', 'type' => 'string', 'example' => 'vpc-uf61z****', 'title' => ''], + 'VSwitchId' => ['description' => 'The vSwitch ID.', 'type' => 'string', 'example' => 'vsw-0xi8829****', 'title' => ''], 'Ports' => [ - 'description' => 'The details of the ports.'."\n", + 'description' => 'The port details.', 'type' => 'array', 'items' => [ - 'description' => 'The details of the port.'."\n", + 'description' => 'The port details.', 'type' => 'object', 'properties' => [ - 'Protocol' => [ - 'description' => 'The protocol type. Valid values:'."\n" - ."\n" - .'* HttpPort'."\n" - .'* HttpsPort'."\n" - .'* TcpPort'."\n", - 'type' => 'string', - 'example' => 'HttpPort', - ], - 'Port' => [ - 'description' => 'The port used to connect to the cluster. Valid values:'."\n" - ."\n" - .'* 8123: This value is returned when the value of Protocol is HttpPort.'."\n" - .'* 8443: This value is returned when the value of Protocol is HttpsPort.'."\n" - .'* 9000: This value is returned when the value of Protocol is TcpPort.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '8123', - ], + 'Protocol' => ['description' => 'The protocol type. Valid values:'."\n" + ."\n" + .'- http: HTTP port.', 'type' => 'string', 'example' => 'http', 'title' => ''], + 'Port' => ['description' => 'The access port. Valid values:'."\n" + ."\n" + .'- http: 3000', 'type' => 'integer', 'format' => 'int32', 'example' => '3000', 'title' => ''], ], + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], - 'IPAddress' => [ - 'description' => 'The IP address.'."\n", - 'type' => 'string', - 'example' => '172.30.XX.XX', - ], - 'ComputingGroupId' => [ - 'title' => '计算组id', - 'type' => 'string', - 'example' => 'cc-ad321**-clickhouse', - ], - 'EndpointName' => [ - 'title' => '连接串名称', - 'type' => 'string', - 'example' => 'cc-*****-clickhouse', - ], + 'IPAddress' => ['description' => 'The IP address.', 'type' => 'string', 'example' => '172.30.****.****', 'title' => ''], + 'EndpointName' => ['title' => '', 'description' => 'The endpoint name.', 'type' => 'string', 'example' => 'lfs-2zeejcvmzn1******'], ], + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], 'errorCodes' => [ 404 => [ - [ - 'errorCode' => 'InvalidDBInstanceId.NotFound', - 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', - ], + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\",\\n \\"Data\\": {\\n \\"InstanceNetworkType\\": \\"VPC\\",\\n \\"Endpoints\\": [\\n {\\n \\"NetType\\": \\"VPC\\",\\n \\"Status\\": \\"active\\",\\n \\"ConnectionString\\": \\"cc-****-clickhouse.clickhouseserver.pre.rds.aliyuncs.com\\",\\n \\"VpcId\\": \\"vpc-uf61z****\\",\\n \\"VSwitchId\\": \\"vsw-0xi8829****\\",\\n \\"VpcInstanceId\\": \\"vpc-uf61z****\\",\\n \\"Ports\\": [\\n {\\n \\"Protocol\\": \\"HttpPort\\",\\n \\"Port\\": 8123\\n }\\n ],\\n \\"IPAddress\\": \\"172.30.XX.XX\\",\\n \\"ComputingGroupId\\": \\"cc-ad321**-clickhouse\\",\\n \\"EndpointName\\": \\"cc-*****-clickhouse\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => 'DescribeEndpoints', + 'title' => 'Query langfuse instance access endpoint', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"Data\\": {\\n \\"InstanceNetworkType\\": \\"VPC\\",\\n \\"Endpoints\\": [\\n {\\n \\"NetType\\": \\"VPC\\",\\n \\"ConnectionString\\": \\"lfs-2zeejcvmzn1******.com\\",\\n \\"VpcId\\": \\"vpc-uf61z****\\",\\n \\"VSwitchId\\": \\"vsw-0xi8829****\\",\\n \\"Ports\\": [\\n {\\n \\"Protocol\\": \\"http\\",\\n \\"Port\\": 3000\\n }\\n ],\\n \\"IPAddress\\": \\"172.30.****.****\\",\\n \\"EndpointName\\": \\"lfs-2zeejcvmzn1******\\"\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'DescribeProcessList' => [ - 'summary' => 'Views running queries.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', - ], + 'DescribeLangfuseOrgMemberships' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -4505,1591 +3768,1158 @@ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '186631', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-xxxxx', - ], - ], - [ - 'name' => 'QueryDurationMs', - 'in' => 'query', - 'schema' => [ - 'description' => 'The execution duration of slow SQL queries. Minimum value: 1000. Unit: milliseconds.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '1000', - ], - ], - [ - 'name' => 'InitialUser', - 'in' => 'query', - 'schema' => [ - 'description' => 'The user who executes the query statement.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'testuser', - ], - ], - [ - 'name' => 'Keyword', - 'in' => 'query', - 'schema' => [ - 'description' => 'The keyword of the query statement.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'SELECT', - ], - ], - [ - 'name' => 'InitialQueryId', - 'in' => 'query', - 'schema' => [ - 'description' => 'The query ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - ], - [ - 'name' => 'QueryOrder', - 'in' => 'query', - 'schema' => [ - 'description' => 'Specifies the columns by which the query results are sorted in descending order.'."\n" - ."\n" - .'* 0: The query results are sorted by the query_duration_ms column.'."\n" - .'* 1: The query results are sorted by the query_duration_ms and query_start_time columns.'."\n" - .'* 2: The query results are sorted by the query_duration_ms, query_start_time, and user columns.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => 'id', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'PageSize', + 'name' => 'OrganizationId', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries per page.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - ], + 'schema' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], ], [ 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => 'The page number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['description' => 'The page number of the page to return.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1', 'title' => ''], ], [ - 'name' => 'ComputingGroupId', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'type' => 'string', - ], + 'schema' => ['description' => 'The number of entries per page.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '30', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'title' => '', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'xxx-xxx-xxx', - ], + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1F488A93-83FD-540F-9B67-0333AF64E6A0'], 'Data' => [ - 'description' => 'The data returned.'."\n", + 'description' => 'The returned result.', 'type' => 'object', 'properties' => [ - 'DBInstanceID' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => 'cc-xxxx', - ], - 'DBInstanceName' => [ - 'description' => 'The cluster name.'."\n", - 'type' => 'string', - 'example' => 'test', - ], - 'TotalCount' => [ - 'description' => 'The total number of entries returned.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'ResultSet' => [ - 'description' => 'The result sets.'."\n", + 'Memberships' => [ + 'description' => 'The list of user roles in the organization.', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'InitialQueryId' => [ - 'description' => 'The query ID.'."\n", - 'type' => 'string', - 'example' => '\'79f7e40b-87e2-4ef4-b6df-21889a3a030e\'', - ], - 'QueryStartTime' => [ - 'description' => 'The beginning of the time range to query. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.'."\n", - 'type' => 'string', - 'example' => '2023-07-23T10:13:23Z', - ], - 'InitialAddress' => [ - 'description' => 'The address to which the query statement is sent.'."\n", - 'type' => 'string', - 'example' => '0:0:0:0:0:ffff:1edd65ea', - ], - 'Query' => [ - 'description' => 'The query statement that is running.'."\n", - 'type' => 'string', - 'example' => 'select * from test', - ], - 'InitialUser' => [ - 'description' => 'The user who executes the query statement.'."\n", - 'type' => 'string', - 'example' => 'bany', - ], - 'QueryDurationMs' => [ - 'description' => 'The minimum query duration. Minimum value: **1000**. Unit: milliseconds.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1000', - ], + 'Email' => ['description' => 'The email address of the user.', 'type' => 'string', 'example' => 'john@company.com', 'title' => ''], + 'Name' => ['description' => 'The username.', 'type' => 'string', 'example' => 'john', 'title' => ''], + 'Role' => ['description' => 'The role of the user.', 'type' => 'string', 'example' => 'VIEWER', 'title' => ''], + 'CreatedAt' => ['description' => 'The time when the user was created.', 'type' => 'string', 'example' => '2026-06-24T10:14:33Z', 'title' => ''], ], 'description' => '', + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], + 'TotalCount' => ['description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int64', 'example' => '3', 'title' => ''], + 'PageNumber' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int64', 'example' => '1', 'title' => ''], + 'PageSize' => ['description' => 'The number of entries per page.', 'type' => 'integer', 'format' => 'int64', 'example' => '20', 'title' => ''], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], + ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"测试使用\\",\\n \\"TotalCount\\": 1,\\n \\"ResultSet\\": [\\n {\\n \\"InitialQueryId\\": \\"\'79f7e40b-87e2-4ef4-b6df-21889a3a030e\'\\",\\n \\"QueryStartTime\\": \\"2023-07-23T10:13:23Z\\",\\n \\"InitialAddress\\": \\"0:0:0:0:0:ffff:1edd65ea\\",\\n \\"Query\\": \\"select * from test\\",\\n \\"InitialUser\\": \\"bany\\",\\n \\"QueryDurationMs\\": 1000\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => 'DescribeProcessList', + 'title' => 'Query langfuse organization member information', + 'summary' => 'Queries the member information of a Langfuse organization.', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1F488A93-83FD-540F-9B67-0333AF64E6A0\\",\\n \\"Data\\": {\\n \\"Memberships\\": [\\n {\\n \\"Email\\": \\"john@company.com\\",\\n \\"Name\\": \\"john\\",\\n \\"Role\\": \\"VIEWER\\",\\n \\"CreatedAt\\": \\"2026-06-24T10:14:33Z\\"\\n }\\n ],\\n \\"TotalCount\\": 3,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 20\\n }\\n}","type":"json"}]', ], - 'KillProcess' => [ - 'summary' => 'Terminates an ongoing query.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', - ], + 'DescribeLangfuseOrgs' => [ + 'summary' => '', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '186648', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '183135', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => '', 'example' => 'cn-hangzhou', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-xxxxxxx', - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => '', 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'InitialQueryId', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'The query ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['type' => 'integer', 'format' => 'int32', 'default' => '30', 'description' => '', 'required' => false, 'example' => '30', 'title' => ''], ], [ - 'name' => 'ComputingGroupId', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'type' => 'string', - ], + 'schema' => ['type' => 'integer', 'format' => 'int32', 'default' => '1', 'description' => '', 'required' => false, 'example' => '1', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'xxx-xxx-xxx', - ], 'Data' => [ - 'description' => 'The data returned.'."\n", 'type' => 'object', 'properties' => [ - 'DBInstanceID' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => 'cc-xxxxxxx', - ], - 'DBInstanceName' => [ - 'description' => 'The cluster name.'."\n", - 'type' => 'string', - 'example' => 'cc-xxxxxxx'."\n", - ], - 'Count' => [ - 'description' => 'The number of queries that are terminated.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', + 'TotalCount' => ['type' => 'integer', 'format' => 'int64', 'description' => '', 'example' => '17', 'title' => ''], + 'PageSize' => ['type' => 'integer', 'format' => 'int32', 'description' => '', 'example' => '20', 'title' => ''], + 'PageNumber' => ['type' => 'integer', 'format' => 'int32', 'description' => '', 'example' => '1', 'title' => ''], + 'Organizations' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'OrganizationId' => ['type' => 'string', 'description' => '', 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], + 'Name' => ['type' => 'string', 'description' => '', 'example' => 'org_name', 'title' => ''], + 'CreatedAt' => ['type' => 'string', 'description' => '', 'example' => '2026-06-11T10:27:23Z', 'title' => ''], + 'UpdatedAt' => ['type' => 'string', 'description' => '', 'example' => '2026-06-09T10:27:55', 'title' => ''], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'RequestId' => ['type' => 'string', 'description' => '', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', 'title' => ''], ], + 'title' => '', + 'description' => '', + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"cc-xxxxxxx\\\\n\\",\\n \\"Count\\": 1\\n }\\n}","type":"json"}]', - 'title' => 'KillProcess', + 'title' => '', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Data\\": {\\n \\"TotalCount\\": 17,\\n \\"PageSize\\": 20,\\n \\"PageNumber\\": 1,\\n \\"Organizations\\": [\\n {\\n \\"OrganizationId\\": \\"cmrbhzx930005jw2q****\\",\\n \\"Name\\": \\"org_name\\",\\n \\"CreatedAt\\": \\"2026-06-11T10:27:23Z\\",\\n \\"UpdatedAt\\": \\"2026-06-09T10:27:55\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\"\\n}","type":"json"}]', ], - 'DescribeSlowLogTrend' => [ - 'summary' => 'Queries the trend of slow query logs.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', - ], + 'DescribeLangfuseProjectMemberships' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '186604', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], - ], - [ - 'name' => 'StartTime', - 'in' => 'query', - 'schema' => [ - 'description' => 'The start of the time range to query. Specify the time in the yyyy-MM-dd hh:mm:ss format. The time must be in UTC.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '2023-04-13 17:48:00', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'EndTime', + 'name' => 'OrganizationId', 'in' => 'query', - 'schema' => [ - 'description' => 'The end of the time range to query. Specify the time in the yyyy-MM-dd hh:mm:ss format. The time must be in UTC.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '2023-06-07 10:03:00', - ], + 'schema' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], ], [ - 'name' => 'QueryDurationMs', + 'name' => 'ProjectId', 'in' => 'query', - 'schema' => [ - 'description' => 'The execution duration of slow SQL queries. Minimum value: **1000**. Unit: milliseconds.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '3000', - ], + 'schema' => ['description' => 'The Langfuse project ID.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], ], [ - 'name' => 'Product', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'The code of the cloud service.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'clickhouse', - 'default' => 'clickhouse', - ], + 'schema' => ['description' => 'The number of entries per page.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '30', 'title' => ''], ], [ - 'name' => 'ComputingGroupId', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'type' => 'string', - ], + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", + 'title' => '', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => '7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF', - ], + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'A82758F8-E793-5610-BE11-0E46664305C2'], 'Data' => [ - 'description' => 'The returned result.'."\n", + 'description' => 'The returned data.', 'type' => 'object', 'properties' => [ - 'DBInstanceID' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'DBInstanceName' => [ - 'description' => 'The cluster name.'."\n", - 'type' => 'string', - 'example' => 'clusterTest', - ], - 'ResultSet' => [ - 'description' => 'The result sets.'."\n", + 'PageSize' => ['description' => 'The number of entries per page.', 'type' => 'integer', 'format' => 'int64', 'example' => '30', 'title' => ''], + 'PageNumber' => ['description' => 'The current page number.', 'type' => 'integer', 'format' => 'int64', 'example' => '1', 'title' => ''], + 'TotalCount' => ['description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int64', 'example' => '4', 'title' => ''], + 'Memberships' => [ + 'description' => 'The list of user roles in the Langfuse project.', 'type' => 'array', 'items' => [ - 'description' => 'The result set.'."\n", 'type' => 'object', 'properties' => [ - 'QueryStartTime' => [ - 'description' => 'The beginning of the time range to query. The time is in the yyyy-MM-dd hh:mm:ss format. The time is displayed in UTC.'."\n", - 'type' => 'string', - 'example' => '2023-04-13 17:48:00', - ], - 'MaxQueryDurationMs' => [ - 'description' => 'The maximum execution duration of slow SQL queries. Minimum value: **1000**. Unit: milliseconds.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '3000', - ], - 'Cnt' => [ - 'description' => 'The total number of SQL queries within the specified time range.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'MinQueryDurationMs' => [ - 'description' => 'The minimum execution duration of slow SQL queries. Minimum value: **1000**. Unit: milliseconds.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1000', - ], - 'AvgQueryDurationMs' => [ - 'description' => 'The average execution duration of slow SQL queries. Minimum value: **1000**. Unit: milliseconds.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2000', - ], + 'Name' => ['description' => 'The username.', 'type' => 'string', 'example' => 'john', 'title' => ''], + 'Email' => ['description' => 'The email address of the user.', 'type' => 'string', 'example' => 'john@company.com', 'title' => ''], + 'ProjectRole' => ['description' => 'The role of the user in the Langfuse project.', 'type' => 'string', 'example' => 'VIEWER', 'title' => ''], + 'OrgRole' => ['description' => 'The role of the user in the Langfuse organization.', 'type' => 'string', 'example' => 'ADMIN', 'title' => ''], ], + 'description' => '', + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], + ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"集群测试\\",\\n \\"ResultSet\\": [\\n {\\n \\"QueryStartTime\\": \\"2023-04-13 17:48:00\\",\\n \\"MaxQueryDurationMs\\": 3000,\\n \\"Cnt\\": 1,\\n \\"MinQueryDurationMs\\": 1000,\\n \\"AvgQueryDurationMs\\": 2000\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => 'DescribeSlowLogTrend', + 'title' => 'Query langfuse project user roles', + 'summary' => 'Queries user roles in a Langfuse project.', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"A82758F8-E793-5610-BE11-0E46664305C2\\",\\n \\"Data\\": {\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"TotalCount\\": 4,\\n \\"Memberships\\": [\\n {\\n \\"Name\\": \\"john\\",\\n \\"Email\\": \\"john@company.com\\",\\n \\"ProjectRole\\": \\"VIEWER\\",\\n \\"OrgRole\\": \\"ADMIN\\"\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'DescribeSlowLogRecords' => [ - 'summary' => 'Queries the details of slow query logs.', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', - ], + 'DescribeLangfuseProjects' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '186629', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'StartTime', + 'name' => 'OrganizationId', 'in' => 'query', - 'schema' => [ - 'description' => 'The beginning of the time range to query. Specify the time in the yyyy-MM-dd hh:mm:ss format. The time must be in UTC.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '2023-09-11 16:00:00', - ], + 'schema' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], ], - [ - 'name' => 'EndTime', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'The end of the time range to query. Specify the time in the yyyy-MM-dd hh:mm:ss format. The time must be in UTC.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '2023-09-15 16:00:00', + 'title' => '', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], + 'Data' => [ + 'description' => 'The returned result.', + 'type' => 'object', + 'properties' => [ + 'PageSize' => ['description' => 'The number of records per page.', 'type' => 'integer', 'format' => 'int64', 'example' => '30', 'title' => ''], + 'PageNumber' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int64', 'example' => '1', 'title' => ''], + 'TotalCount' => ['description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int64', 'example' => '1', 'title' => ''], + 'Projects' => [ + 'description' => 'The list of Langfuse projects.', + 'type' => 'array', + 'items' => [ + 'description' => 'The list of Langfuse projects.', + 'type' => 'object', + 'properties' => [ + 'ProjectId' => ['description' => 'The Langfuse project ID.', 'type' => 'string', 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], + 'Name' => ['description' => 'The Langfuse project name.', 'type' => 'string', 'example' => 'project_name', 'title' => ''], + 'OrganizationId' => ['description' => 'The organization ID to which the Langfuse project belongs.', 'type' => 'string', 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], + 'UpdatedAt' => ['description' => 'The time when the Langfuse project was last updated.', 'type' => 'string', 'example' => '2026-06-09T10:27:35', 'title' => ''], + 'CreatedAt' => ['description' => 'The time when the Langfuse project was created.', 'type' => 'string', 'example' => '2026-05-27T08:23:45Z', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', ], ], - [ - 'name' => 'QueryDurationMs', - 'in' => 'query', - 'schema' => [ - 'description' => 'The execution duration of slow SQL queries. Minimum value: **1000**. Unit: milliseconds.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '3000', - ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'Query langfuse project list', + 'summary' => 'Queries the list of Langfuse projects.', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"Data\\": {\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"TotalCount\\": 1,\\n \\"Projects\\": [\\n {\\n \\"ProjectId\\": \\"cmrbhzx930005jw2q****\\",\\n \\"Name\\": \\"project_name\\",\\n \\"OrganizationId\\": \\"cmrbhzx930005jw2q****\\",\\n \\"UpdatedAt\\": \\"2026-06-09T10:27:35\\",\\n \\"CreatedAt\\": \\"2026-05-27T08:23:45Z\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeLangfuseSecurityIPList' => [ + 'summary' => 'Queries the Langfuse whitelist.', + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => 'The number of entries per page. Valid values:'."\n" - ."\n" - .'* 30 (default)'."\n" - .'* 50'."\n" - .'* 100'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185650', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ [ - 'name' => 'PageNumber', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'The page number.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'ComputingGroupId', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'type' => 'string', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'The response parameters.'."\n", + 'title' => '', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'DF203CC8-5F68-5E3F-8050-3C77DD65731A', - ], + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], 'Data' => [ - 'description' => 'The data returned.'."\n", + 'description' => 'The returned result.', 'type' => 'object', 'properties' => [ - 'DBInstanceID' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => 'cc-bp100p4q1g9z32****', - ], - 'DBInstanceName' => [ - 'description' => 'The cluster name.'."\n", - 'type' => 'string', - 'example' => 'TestCluster', - ], - 'TotalCount' => [ - 'description' => 'The total number of entries returned.'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'ResultSet' => [ - 'description' => 'The result sets.'."\n", + 'DBInstanceID' => ['description' => 'The instance ID.', 'type' => 'integer', 'format' => 'int32', 'example' => 'lfs-****', 'title' => ''], + 'DBInstanceName' => ['description' => 'The instance name.', 'type' => 'string', 'example' => 'lfs-****', 'title' => ''], + 'GroupItems' => [ + 'description' => 'The whitelist group list.', 'type' => 'array', 'items' => [ - 'description' => 'The result set.'."\n", + 'description' => 'The whitelist group list.', 'type' => 'object', 'properties' => [ - 'QueryStartTime' => [ - 'description' => 'The beginning of the time range to query. The time is in the yyyy-MM-dd hh:mm:ss format. The time is displayed in UTC.'."\n", - 'type' => 'string', - 'example' => '2023-09-11 16:00:00', - ], - 'InitialQueryId' => [ - 'description' => 'The query ID.'."\n", - 'type' => 'string', - 'example' => '\'ae915a3ad30e77e67a7215d05b658cc6\'', - ], - 'ReadRows' => [ - 'description' => 'The number of read rows.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], - 'InitialAddress' => [ - 'description' => 'The address to which the query statement is sent.'."\n", - 'type' => 'string', - 'example' => '0:0:0:0:0:ffff:1edd65ea', - ], - 'Query' => [ - 'description' => 'The query statement that is running.'."\n", - 'type' => 'string', - 'example' => 'select * from test', - ], - 'MemoryUsage' => [ - 'description' => 'The peak memory usage for the query. Unit: bytes.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4941696', - ], - 'Type' => [ - 'description' => 'The type of the slow query logs.'."\n", - 'type' => 'string', - 'example' => 'ExceptionWhileProcessing', - ], - 'ReadBytes' => [ - 'description' => 'The size of the data that is scanned. Unit: bytes.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4507128020832', - ], - 'InitialUser' => [ - 'description' => 'The user who executes the query statement.'."\n", - 'type' => 'string', - 'example' => 'bany', - ], - 'QueryDurationMs' => [ - 'description' => 'The execution duration of slow SQL queries. Minimum value: **1000**. Unit: milliseconds.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '3000', - ], - 'ResultBytes' => [ - 'description' => 'The size of the result data. Unit: bytes.'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], + 'GroupName' => ['description' => 'The name of the whitelist group.', 'type' => 'string', 'example' => 'default', 'title' => ''], + 'SecurityIPType' => ['description' => 'The IP address type. The value is fixed to IPv4. IPv6 is not supported.', 'type' => 'string', 'example' => 'ipv4', 'title' => ''], + 'GroupTag' => ['description' => 'The group tag.', 'type' => 'string', 'example' => 'test', 'title' => ''], + 'SecurityIPList' => ['description' => 'The list of IP addresses in the whitelist group.', 'type' => 'string', 'example' => '127.0.XX.XX', 'title' => ''], + 'WhitelistNetType' => ['description' => 'The network type of the whitelist.', 'type' => 'string', 'example' => 'mix', 'title' => ''], ], + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"DF203CC8-5F68-5E3F-8050-3C77DD65731A\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"集群测试\\",\\n \\"TotalCount\\": 1,\\n \\"ResultSet\\": [\\n {\\n \\"QueryStartTime\\": \\"2023-09-11 16:00:00\\",\\n \\"InitialQueryId\\": \\"\'ae915a3ad30e77e67a7215d05b658cc6\'\\",\\n \\"ReadRows\\": 10,\\n \\"InitialAddress\\": \\"0:0:0:0:0:ffff:1edd65ea\\",\\n \\"Query\\": \\"select * from test\\",\\n \\"MemoryUsage\\": 4941696,\\n \\"Type\\": \\"ExceptionWhileProcessing\\",\\n \\"ReadBytes\\": 4507128020832,\\n \\"InitialUser\\": \\"bany\\",\\n \\"QueryDurationMs\\": 3000,\\n \\"ResultBytes\\": 10\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => 'DescribeSlowLogRecords', + 'title' => 'Query langfuse whitelist', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"lfs-****\\",\\n \\"GroupItems\\": [\\n {\\n \\"GroupName\\": \\"default\\",\\n \\"SecurityIPType\\": \\"ipv4\\",\\n \\"GroupTag\\": \\"test\\",\\n \\"SecurityIPList\\": \\"127.0.XX.XX\\",\\n \\"WhitelistNetType\\": \\"mix\\"\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'ModifyBackupPolicy' => [ - 'summary' => 'Modifies the backup policy of an ApsaraDB for ClickHouse cluster that runs Enterprise Edition.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'DescribeLangfuseUser' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '206399', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseIL81EM', - ], + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'DBInstanceId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-xxxxx', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-beijing', - ], - ], - [ - 'name' => 'PreferredBackupTime', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => '15:00Z-16:00Z', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'PreferredBackupPeriod', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'Monday', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'BackupRetentionPeriod', + 'name' => 'Email', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => '7', - ], + 'schema' => ['description' => 'The email address of the user.', 'type' => 'string', 'required' => true, 'example' => 'john@company.com', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', + 'title' => '', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], + 'Data' => [ + 'description' => 'The returned result.', + 'type' => 'object', + 'properties' => [ + 'Email' => ['description' => 'The email address of the user.', 'type' => 'string', 'example' => 'john@company.com', 'title' => ''], + 'Name' => ['description' => 'The username.', 'type' => 'string', 'example' => 'john', 'title' => ''], + 'CreatedAt' => ['description' => 'The time when the user was created.', 'type' => 'string', 'example' => '2026-06-01T10:03:05Z', 'title' => ''], + 'UpdatedAt' => ['description' => 'The time when the user was last updated.', 'type' => 'string', 'example' => '2026-06-01T10:03:05Z', 'title' => ''], + 'Memberships' => [ + 'description' => 'The role information of the user.', + 'type' => 'array', + 'items' => [ + 'description' => 'The role information of the user.', + 'type' => 'object', + 'properties' => [ + 'OrgRole' => ['description' => 'The role of the user within the organization.', 'type' => 'string', 'example' => 'ADMIN', 'title' => ''], + 'OrganizationId' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], + 'OrganizationName' => ['description' => 'The Langfuse organization name.', 'type' => 'string', 'example' => 'org_name', 'title' => ''], + 'Projects' => [ + 'description' => 'The list of Langfuse projects.', + 'type' => 'array', + 'items' => [ + 'description' => 'The list of Langfuse projects.', + 'type' => 'object', + 'properties' => [ + 'ProjectRole' => ['description' => 'The role of the user within the project.', 'type' => 'string', 'example' => 'VIEWER', 'title' => ''], + 'ProjectName' => ['description' => 'The Langfuse project name.', 'type' => 'string', 'example' => 'project_name', 'title' => ''], + 'ProjectId' => ['description' => 'The Langfuse project ID.', 'type' => 'string', 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], + ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","type":"json"}]', - 'title' => 'ModifyBackupPolicy', + 'title' => 'Query langfuse user details', + 'summary' => 'Queries the details of a Langfuse user.', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\",\\n \\"Data\\": {\\n \\"Email\\": \\"john@company.com\\",\\n \\"Name\\": \\"john\\",\\n \\"CreatedAt\\": \\"2026-06-01T10:03:05Z\\",\\n \\"UpdatedAt\\": \\"2026-06-01T10:03:05Z\\",\\n \\"Memberships\\": [\\n {\\n \\"OrgRole\\": \\"ADMIN\\",\\n \\"OrganizationId\\": \\"cmrbhzx930005jw2q****\\",\\n \\"OrganizationName\\": \\"org_name\\",\\n \\"Projects\\": [\\n {\\n \\"ProjectRole\\": \\"VIEWER\\",\\n \\"ProjectName\\": \\"project_name\\",\\n \\"ProjectId\\": \\"cmrbhzx930005jw2q****\\"\\n }\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'DescribeBackupPolicy' => [ - 'summary' => 'View the backup policy of an ApsaraDB for ClickHouse cluster that runs Enterprise Edition.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'DescribeLangfuseUsers' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '206399', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseIL81EM', - ], + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp100p4q1g9z3****', - ], + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], ], [ - 'name' => 'RegionId', + 'name' => 'Email', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The email address of the user.', 'type' => 'string', 'required' => false, 'example' => 'john@company.com', 'title' => ''], + ], + [ + 'name' => 'Name', + 'in' => 'query', + 'schema' => ['description' => 'The username.', 'type' => 'string', 'required' => false, 'example' => 'john', 'title' => ''], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => 'The number of entries per page.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '30', 'title' => ''], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', + 'title' => '', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'PreferredBackupPeriod' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'Monday', - ], - 'Switch' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'true', - ], - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], - 'PreferredBackupTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '15:00Z-16:00Z', - ], - 'BackupRetentionPeriod' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '7', - ], - 'BackupSize' => [ - 'description' => '', - 'type' => 'string', - 'example' => '123124', + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'C342F3DD-1FF7-55E9-A1A1-098DE07CD1A2'], + 'Data' => [ + 'description' => 'The returned result.', + 'type' => 'object', + 'properties' => [ + 'PageSize' => ['description' => 'The number of entries per page.', 'type' => 'integer', 'format' => 'int64', 'example' => '30', 'title' => ''], + 'PageNumber' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int64', 'example' => '1', 'title' => ''], + 'TotalCount' => ['description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int64', 'example' => '10', 'title' => ''], + 'Users' => [ + 'description' => 'The list of users.', + 'type' => 'array', + 'items' => [ + 'description' => 'The list of users.', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => 'The username.', 'type' => 'string', 'example' => 'john', 'title' => ''], + 'Email' => ['description' => 'The email address of the user.', 'type' => 'string', 'example' => 'john@company.com', 'title' => ''], + 'CreatedAt' => ['description' => 'The time when the user was created.', 'type' => 'string', 'example' => '2026-06-01T10:03:05Z', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], + ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PreferredBackupPeriod\\": \\"Monday\\",\\n \\"Switch\\": \\"true\\",\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PreferredBackupTime\\": \\"15:00Z-16:00Z\\",\\n \\"BackupRetentionPeriod\\": 7,\\n \\"BackupSize\\": \\"123124\\"\\n}","type":"json"}]', - 'title' => 'DescribeBackupPolicy', + 'title' => 'Query langfuse user list', + 'summary' => 'Queries the list of Langfuse users.', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C342F3DD-1FF7-55E9-A1A1-098DE07CD1A2\\",\\n \\"Data\\": {\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"TotalCount\\": 10,\\n \\"Users\\": [\\n {\\n \\"Name\\": \\"john\\",\\n \\"Email\\": \\"john@company.com\\",\\n \\"CreatedAt\\": \\"2026-06-01T10:03:05Z\\"\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'DeleteBackupPolicy' => [ - 'summary' => 'Deletes the backup policy of an ApsaraDB for ClickHouse cluster that runs Enterprise Edition.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'DescribeProcessList' => [ + 'summary' => 'Describes currently running queries.', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '206399', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseN8BUWF', - ], + 'abilityTreeCode' => '186631', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ - 'name' => 'DBInstanceId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-xxxxx', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing', 'title' => ''], ], [ - 'name' => 'RegionId', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-xxxxx', 'title' => ''], ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '', - 'type' => 'string', - 'example' => '60DDD29D-E5A8-563C-88FB-06D3A1F1C609', - ], - ], - ], + [ + 'name' => 'QueryDurationMs', + 'in' => 'query', + 'schema' => ['description' => 'The minimum query execution duration, in milliseconds (ms). Only queries that run for this duration or longer are returned. The minimum value is 1,000.', 'type' => 'string', 'required' => false, 'example' => '1000', 'title' => ''], ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"60DDD29D-E5A8-563C-88FB-06D3A1F1C609\\"\\n}","type":"json"}]', - 'title' => 'DeleteBackupPolicy', - ], - 'CreateBackupPolicy' => [ - 'summary' => 'Creates a backup policy for a specified ApsaraDB for ClickHouse cluster that runs Enterprise Edition.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], - 'security' => [ [ - 'AK' => [], + 'name' => 'InitialUser', + 'in' => 'query', + 'schema' => ['description' => 'The query user.', 'type' => 'string', 'required' => false, 'example' => 'testuser', 'title' => ''], ], - ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '206399', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseIL81EM', + [ + 'name' => 'Keyword', + 'in' => 'query', + 'schema' => ['description' => 'The keyword in the query statement.', 'type' => 'string', 'required' => false, 'example' => 'SELECT', 'title' => ''], ], - ], - 'parameters' => [ [ - 'name' => 'DBInstanceId', + 'name' => 'InitialQueryId', 'in' => 'query', - 'schema' => [ - 'description' => 'The cluster ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cc-2ze0eb0w182xh8549', - ], + 'schema' => ['description' => 'The query ID.', 'type' => 'string', 'required' => false, 'example' => '1', 'title' => ''], ], [ - 'name' => 'RegionId', + 'name' => 'QueryOrder', 'in' => 'query', - 'schema' => [ - 'description' => 'The region ID.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The criteria by which to sort the results. The results are sorted in descending order. Valid values:'."\n" + ."\n" + .'- 0: Sorts by `query_duration_ms`.'."\n" + ."\n" + .'- 1: Sorts by `query_duration_ms` and `query_start_time`.'."\n" + ."\n" + .'- 2: Sorts by `query_duration_ms`, `query_start_time`, and `user`.', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '0', 'title' => ''], ], [ - 'name' => 'PreferredBackupTime', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'The backup time window within which the backup task is performed. The time is displayed in `UTC`. For example, `12:00Z-13:00Z` indicates that the backup time window ranges from `12:00` (UTC) to `13:00` `(UTC)`.'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '10:00Z-11:00Z', - ], + 'schema' => ['description' => 'The number of entries to return on each page.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', 'title' => ''], ], [ - 'name' => 'PreferredBackupPeriod', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => 'The backup cycle, which indicates the day of the week when the system regularly backs up data. Separate multiple dates with commas (`,`).'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'Monday,Friday', - ], + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', 'title' => ''], ], [ - 'name' => 'BackupRetentionPeriod', + 'name' => 'ComputingGroupId', 'in' => 'query', - 'schema' => [ - 'description' => 'The number of days for which you can retain the backup data.'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '8', - ], + 'schema' => ['description' => 'The computing group ID.', 'type' => 'string', 'required' => false, 'example' => 'cc-gs5j3sua77******-clickhouse', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response'."\n", + 'description' => 'The response object.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'The request ID.'."\n", - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'xxx-xxx-xxx'], + 'Data' => [ + 'description' => 'The data object.', + 'type' => 'object', + 'properties' => [ + 'DBInstanceID' => ['description' => 'The cluster ID.', 'type' => 'integer', 'format' => 'int32', 'example' => 'cc-xxxx', 'title' => ''], + 'DBInstanceName' => ['description' => 'The cluster name.', 'type' => 'string', 'example' => 'For testing', 'title' => ''], + 'TotalCount' => ['description' => 'The total number of entries that match the filter criteria.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'ResultSet' => [ + 'description' => 'The result set.', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'InitialQueryId' => ['description' => 'The query ID.', 'type' => 'string', 'example' => '\'79f7e40b-87e2-4ef4-b6df-21889a3a030e\'', 'title' => ''], + 'QueryStartTime' => ['description' => 'The start time of the query. The time is in UTC and follows the `yyyy-MM-ddTHH:mm:ssZ` format.', 'type' => 'string', 'example' => '2023-07-23T10:13:23Z', 'title' => ''], + 'InitialAddress' => ['description' => 'The address from which the query was initiated.', 'type' => 'string', 'example' => '0:0:0:0:0:ffff:1edd65ea', 'title' => ''], + 'Query' => ['description' => 'The query statement.', 'type' => 'string', 'example' => 'select * from test', 'title' => ''], + 'InitialUser' => ['description' => 'The user who initiated the query.', 'type' => 'string', 'example' => 'bany', 'title' => ''], + 'QueryDurationMs' => ['description' => 'The execution duration of the query, in milliseconds (ms).', 'type' => 'integer', 'format' => 'int64', 'example' => '1000', 'title' => ''], + ], + 'description' => 'The details of a query.', + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', + ], + ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","type":"json"}]', - 'title' => 'CreateBackupPolicy', - ], - 'DescribeBackups' => [ - 'summary' => 'Queries the backup sets of an ApsaraDB for ClickHouse cluster that runs Enterprise Edition.', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"For testing\\",\\n \\"TotalCount\\": 1,\\n \\"ResultSet\\": [\\n {\\n \\"InitialQueryId\\": \\"\'79f7e40b-87e2-4ef4-b6df-21889a3a030e\'\\",\\n \\"QueryStartTime\\": \\"2023-07-23T10:13:23Z\\",\\n \\"InitialAddress\\": \\"0:0:0:0:0:ffff:1edd65ea\\",\\n \\"Query\\": \\"select * from test\\",\\n \\"InitialUser\\": \\"bany\\",\\n \\"QueryDurationMs\\": 1000\\n }\\n ]\\n }\\n}","type":"json"}]', + 'title' => 'DescribeProcessList', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeProcessList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'translator' => 'machine', + ], + 'DescribeRegions' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '206399', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseIL81EM', - ], - ], - 'parameters' => [ - [ - 'name' => 'DBInstanceId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp1v9kq45u0o80cvh', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-beijing', - ], - ], - [ - 'name' => 'BackupId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => '117403****', - ], - ], - [ - 'name' => 'StartTime', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2021-11-21T16:00Z', - ], - ], - [ - 'name' => 'EndTime', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2021-11-25T16:00Z', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '30', - 'example' => '30', - 'default' => '30', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - ], - ], + 'abilityTreeCode' => '19455', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'publicInformation', ], + 'parameters' => [], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '', - 'type' => 'string', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '', - 'type' => 'string', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', - ], - 'PageNumber' => [ - 'description' => '', - 'type' => 'string', - 'example' => '1', - ], - 'Items' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'DBInstanceId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'cc-bp179i5956tih2m93', - ], - 'BackupStatus' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'Success', - ], - 'BackupType' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'IncrementalBackup', - ], - 'BackupStartTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2021-11-22T18:28:22Z', - ], - 'BackupSize' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '131072', - ], - 'BackupEndTime' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2021-11-22T18:28:41Z', - ], - 'BackupSetInfo' => [ - 'description' => '', - 'type' => 'string', - 'example' => '{"shard_count"：4}', - ], - 'BackupId' => [ - 'description' => '', - 'type' => 'string', - 'example' => '117403****', - ], - 'BackupMethod' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'Physical', - ], - 'ExpireDate' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2022-07-22T18:28:41Z', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75', 'title' => ''], + 'Regions' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Region' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Zones' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Zone' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ZoneId' => ['description' => 'The zone ID.', 'type' => 'string', 'example' => 'cn-beijing-k', 'title' => ''], + 'VpcEnabled' => ['description' => 'Indicates whether the zone supports deployments in a VPC.'."\n" + ."\n" + .'- **true**: The zone supports VPC deployments.'."\n" + ."\n" + .'- **false**: The zone does not support VPC deployments.', 'type' => 'boolean', 'example' => 'true', 'title' => ''], + ], + 'description' => 'The details of a zone.', + 'title' => '', + 'example' => '', + ], + 'description' => 'An array of zones.', + 'title' => '', + 'example' => '', + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'RegionId' => ['description' => 'The region ID.', 'type' => 'string', 'example' => 'cn-beijing', 'title' => ''], + ], + 'description' => 'The details of a region.', + 'title' => '', + 'example' => '', ], + 'description' => 'An array of regions.', + 'title' => '', + 'example' => '', ], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], + 'description' => '', + 'title' => '', + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"1\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"Items\\": [\\n {\\n \\"DBInstanceId\\": \\"cc-bp179i5956tih2m93\\",\\n \\"BackupStatus\\": \\"Success\\",\\n \\"BackupType\\": \\"IncrementalBackup\\",\\n \\"BackupStartTime\\": \\"2021-11-22T18:28:22Z\\",\\n \\"BackupSize\\": 131072,\\n \\"BackupEndTime\\": \\"2021-11-22T18:28:41Z\\",\\n \\"BackupSetInfo\\": \\"{\\\\\\"shard_count\\\\\\": 4}\\",\\n \\"BackupId\\": \\"117403****\\",\\n \\"BackupMethod\\": \\"Physical\\",\\n \\"ExpireDate\\": \\"2022-07-22T18:28:41Z\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => 'DescribeBackups', + 'title' => 'DescribeRegions', + 'summary' => 'Returns information about the available regions and zones for ApsaraDB for ClickHouse.', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"Regions\\": {\\n \\"Region\\": [\\n {\\n \\"Zones\\": {\\n \\"Zone\\": [\\n {\\n \\"ZoneId\\": \\"cn-beijing-k\\",\\n \\"VpcEnabled\\": true\\n }\\n ]\\n },\\n \\"RegionId\\": \\"cn-beijing\\"\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'ModifyDBInstanceConfig' => [ - 'summary' => '修改实例参数配置', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'DescribeSecurityIPList' => [ + 'summary' => 'Queries a whitelist.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '206399', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], + 'operationType' => 'get', + 'abilityTreeCode' => '185650', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ - [ - 'name' => 'DBInstanceId', - 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-uf6lkzf*****', - ], - ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'Parameters', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => false, - 'example' => '{"max_concurrent_queries":"100"}', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => 'The response schema.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => '05321590-BB65-4720-8C***********', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], 'Data' => [ - 'description' => '', + 'description' => 'The data returned.', 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'cc-uf6lkzf*****'."\n", + 'DBInstanceID' => ['description' => 'The cluster ID.', 'type' => 'integer', 'format' => 'int32', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'DBInstanceName' => ['description' => 'The cluster name.', 'type' => 'string', 'example' => 'Cluster test', 'title' => ''], + 'GroupItems' => [ + 'description' => 'The whitelist groups.', + 'type' => 'array', + 'items' => [ + 'description' => 'A whitelist group.', + 'type' => 'object', + 'properties' => [ + 'GroupName' => ['description' => 'The name of the whitelist group.', 'type' => 'string', 'example' => 'default', 'title' => ''], + 'SecurityIPType' => ['description' => 'The IP address type.', 'type' => 'string', 'example' => 'ipv4', 'title' => ''], + 'GroupTag' => ['description' => 'The group tag.', 'type' => 'string', 'example' => 'test', 'title' => ''], + 'SecurityIPList' => ['description' => 'The IP addresses in the whitelist group.', 'type' => 'string', 'example' => '127.0.XX.XX', 'title' => ''], + 'WhitelistNetType' => ['description' => 'The network type of the whitelist.', 'type' => 'string', 'example' => 'mix', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + 'title' => '', + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8C***********\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-uf6lkzf*****\\\\n\\"\\n }\\n}","type":"json"}]', - ], - 'DescribeDBInstanceConfigChangeLog' => [ - 'summary' => '查询实例参数配置记录', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"Cluster test\\",\\n \\"GroupItems\\": [\\n {\\n \\"GroupName\\": \\"default\\",\\n \\"SecurityIPType\\": \\"ipv4\\",\\n \\"GroupTag\\": \\"test\\",\\n \\"SecurityIPList\\": \\"127.0.XX.XX\\",\\n \\"WhitelistNetType\\": \\"mix\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + 'title' => 'DescribeSecurityIPList', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSecurityIPList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'translator' => 'machine', + ], + 'DescribeSlowLogRecords' => [ + 'summary' => 'Call DescribeSlowLogRecords to query slow log records.', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', - 'abilityTreeCode' => '206401', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '186629', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ - 'name' => 'DBInstanceId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-uf6lkzf*****', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'RegionId', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-shanghai', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], ], [ 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => '2025-01-01 10:00:00', - ], + 'schema' => ['description' => 'The start time of the query. The time must be in UTC and in `yyyy-MM-dd HH:mm:ss` format.', 'type' => 'string', 'required' => false, 'example' => '2023-09-11 16:00:00', 'title' => ''], ], [ 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => '2025-01-01 10:00:00'."\n", - ], + 'schema' => ['description' => 'The end time of the query. The time must be in UTC and in `yyyy-MM-dd HH:mm:ss` format.', 'type' => 'string', 'required' => false, 'example' => '2023-09-15 16:00:00', 'title' => ''], + ], + [ + 'name' => 'QueryDurationMs', + 'in' => 'query', + 'schema' => ['description' => 'The minimum duration, in milliseconds, for a slow SQL query to be returned. The minimum value is **1000**.', 'type' => 'string', 'required' => false, 'example' => '3000', 'title' => ''], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', - ], + 'schema' => ['description' => 'The number of entries per page. Valid values:'."\n" + ."\n" + .'- 30 (default)'."\n" + ."\n" + .'- 50'."\n" + ."\n" + .'- 100', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', 'title' => ''], ], [ 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', 'title' => ''], + ], + [ + 'name' => 'ComputingGroupId', + 'in' => 'query', + 'schema' => ['description' => 'The computing group ID.', 'type' => 'string', 'required' => false, 'example' => 'cc-wz9v6y29y3******-clickhouse', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => 'The response schema.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => '780DE414-*********-88BE-A2E21B862B57', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'DF203CC8-5F68-5E3F-8050-3C77DD65731A'], 'Data' => [ - 'description' => '', + 'description' => 'The result.', 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'ParamChangeLogs' => [ - 'description' => '', + 'DBInstanceID' => ['description' => 'The cluster ID.', 'type' => 'integer', 'format' => 'int32', 'example' => 'cc-bp100p4q1g9z32****', 'title' => ''], + 'DBInstanceName' => ['description' => 'The cluster name.', 'type' => 'string', 'example' => 'Cluster test', 'title' => ''], + 'TotalCount' => ['description' => 'The total number of records.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'ResultSet' => [ + 'description' => 'The list of slow log records.', 'type' => 'array', 'items' => [ - 'description' => '', + 'description' => 'The details of a slow log record.', 'type' => 'object', 'properties' => [ - 'ID' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'Name' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'max_concurrent_queries', - ], - 'OldValue' => [ - 'description' => '', - 'type' => 'string', - 'example' => '50', - ], - 'NewValue' => [ - 'description' => '', - 'type' => 'string', - 'example' => '100', - ], - 'Applied' => [ - 'description' => '', - 'type' => 'boolean', - ], - 'GmtCreated' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2025-06-25 13:46:06', - ], - 'GmtModified' => [ - 'description' => '', - 'type' => 'string', - 'example' => '2025-06-25 13:46:06'."\n", - ], + 'QueryStartTime' => ['description' => 'The start time of the query. The time is in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.', 'type' => 'string', 'example' => '2023-09-11 16:00:00', 'title' => ''], + 'InitialQueryId' => ['description' => 'The query ID.', 'type' => 'string', 'example' => '\'ae915a3ad30e77e67a7215d05b658cc6\'', 'title' => ''], + 'ReadRows' => ['description' => 'The number of rows read.', 'type' => 'integer', 'format' => 'int64', 'example' => '10', 'title' => ''], + 'InitialAddress' => ['description' => 'The IP address from which the query was initiated.', 'type' => 'string', 'example' => '0:0:0:0:0:ffff:1edd65ea', 'title' => ''], + 'Query' => ['description' => 'The statement that was being executed.', 'type' => 'string', 'example' => 'select * from test', 'title' => ''], + 'MemoryUsage' => ['description' => 'The peak memory usage for the query. Unit: bytes.', 'type' => 'integer', 'format' => 'int64', 'example' => '4941696', 'title' => ''], + 'Type' => ['description' => 'The type of the slow query log.', 'type' => 'string', 'example' => 'ExceptionWhileProcessing', 'title' => ''], + 'ReadBytes' => ['description' => 'The size of the scanned data. Unit: bytes.', 'type' => 'integer', 'format' => 'int64', 'example' => '4507128020832', 'title' => ''], + 'InitialUser' => ['description' => 'The user who initiated the query.', 'type' => 'string', 'example' => 'bany', 'title' => ''], + 'QueryDurationMs' => ['description' => 'The execution duration of the slow query. The minimum value is **1000**. Unit: milliseconds.', 'type' => 'integer', 'format' => 'int64', 'example' => '3000', 'title' => ''], + 'ResultBytes' => ['description' => 'The size of the result data. Unit: bytes.', 'type' => 'integer', 'format' => 'int64', 'example' => '10', 'title' => ''], ], + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"780DE414-*********-88BE-A2E21B862B57\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"ParamChangeLogs\\": [\\n {\\n \\"ID\\": 1,\\n \\"Name\\": \\"max_concurrent_queries\\",\\n \\"OldValue\\": \\"50\\",\\n \\"NewValue\\": \\"100\\",\\n \\"Applied\\": true,\\n \\"GmtCreated\\": \\"2025-06-25 13:46:06\\",\\n \\"GmtModified\\": \\"2025-06-25 13:46:06\\\\n\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - ], - 'DescribeDBInstanceConfig' => [ - 'summary' => '查询实例参数配置', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"DF203CC8-5F68-5E3F-8050-3C77DD65731A\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"Cluster test\\",\\n \\"TotalCount\\": 1,\\n \\"ResultSet\\": [\\n {\\n \\"QueryStartTime\\": \\"2023-09-11 16:00:00\\",\\n \\"InitialQueryId\\": \\"\'ae915a3ad30e77e67a7215d05b658cc6\'\\",\\n \\"ReadRows\\": 10,\\n \\"InitialAddress\\": \\"0:0:0:0:0:ffff:1edd65ea\\",\\n \\"Query\\": \\"select * from test\\",\\n \\"MemoryUsage\\": 4941696,\\n \\"Type\\": \\"ExceptionWhileProcessing\\",\\n \\"ReadBytes\\": 4507128020832,\\n \\"InitialUser\\": \\"bany\\",\\n \\"QueryDurationMs\\": 3000,\\n \\"ResultBytes\\": 10\\n }\\n ]\\n }\\n}","type":"json"}]', + 'title' => 'DescribeSlowLogRecords', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSlowLogRecords', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'translator' => 'machine', + ], + 'DescribeSlowLogTrend' => [ + 'summary' => 'Queries the slow log trend.', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -6098,134 +4928,118 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '204414', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], + 'abilityTreeCode' => '186604', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], + ], [ 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-wz9go4x*****', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], ], [ - 'name' => 'RegionId', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The start of the time range to query. The time is in UTC and uses the yyyy-MM-dd hh:mm:ss format.', 'type' => 'string', 'required' => false, 'example' => '2023-04-13 17:48:00', 'title' => ''], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => 'The end of the time range to query. The time is in UTC and uses the yyyy-MM-dd hh:mm:ss format.', 'type' => 'string', 'required' => false, 'example' => '2023-06-07 10:03:00', 'title' => ''], + ], + [ + 'name' => 'QueryDurationMs', + 'in' => 'query', + 'schema' => ['description' => 'The minimum execution duration of a slow SQL query, in milliseconds. The minimum value is **1000**.', 'type' => 'string', 'required' => false, 'example' => '3000', 'title' => ''], + ], + [ + 'name' => 'Product', + 'in' => 'query', + 'schema' => ['description' => 'The product code.', 'type' => 'string', 'default' => 'clickhouse', 'required' => false, 'example' => 'clickhouse', 'title' => ''], + ], + [ + 'name' => 'ComputingGroupId', + 'in' => 'query', + 'schema' => ['description' => 'The computing group ID.', 'type' => 'string', 'required' => false, 'example' => 'cc-bp100p4q1g9z3****-clickhouse', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => 'The response object.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => '66428721-xxxx-xxxx-xxxx-3BD1B67837E0'."\n", - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => '7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF'], 'Data' => [ - 'description' => '', + 'description' => 'The data returned.', 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'cc-bp100p4q1g9z3****', - ], - 'Params' => [ - 'description' => '', + 'DBInstanceID' => ['description' => 'The cluster ID.', 'type' => 'integer', 'format' => 'int32', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'DBInstanceName' => ['description' => 'The cluster name.', 'type' => 'string', 'example' => 'Cluster test', 'title' => ''], + 'ResultSet' => [ + 'description' => 'The result set.', 'type' => 'array', 'items' => [ - 'description' => '', + 'description' => 'An array of data points for the slow log trend.', 'type' => 'object', 'properties' => [ - 'IsDynamic' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'IsUserModifiable' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'DefaultValue' => [ - 'description' => '', - 'type' => 'string', - 'example' => '1', - ], - 'Name' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'max_concurrent_queries', - ], - 'Optional' => [ - 'description' => '', - 'type' => 'string', - 'example' => '[0-100]', - ], - 'Comment' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'Maximum number of concurrently executed queries. Zero means unlimited.', - ], - 'ParamRelyRule' => [ - 'description' => '', - 'type' => 'string', - 'example' => '0', - ], - 'Value' => [ - 'description' => '', - 'type' => 'string', - 'example' => '100', - ], + 'QueryStartTime' => ['description' => 'The start of the time interval for the data point. The time is in UTC and uses the yyyy-MM-dd hh:mm:ss format.', 'type' => 'string', 'example' => '2023-04-13 17:48:00', 'title' => ''], + 'MaxQueryDurationMs' => ['description' => 'The maximum execution duration, in milliseconds, of slow SQL queries within the time interval.', 'type' => 'integer', 'format' => 'int64', 'example' => '3000', 'title' => ''], + 'Cnt' => ['description' => 'The number of slow SQL queries in the time interval.', 'type' => 'integer', 'format' => 'int64', 'example' => '1', 'title' => ''], + 'MinQueryDurationMs' => ['description' => 'The minimum execution duration, in milliseconds, of slow SQL queries within the time interval.', 'type' => 'integer', 'format' => 'int64', 'example' => '1000', 'title' => ''], + 'AvgQueryDurationMs' => ['description' => 'The average execution duration, in milliseconds, of slow SQL queries within the time interval.', 'type' => 'integer', 'format' => 'int64', 'example' => '2000', 'title' => ''], ], + 'title' => '', + 'example' => '', ], + 'title' => '', + 'example' => '', ], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"66428721-xxxx-xxxx-xxxx-3BD1B67837E0\\\\n\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Params\\": [\\n {\\n \\"IsDynamic\\": 1,\\n \\"IsUserModifiable\\": 1,\\n \\"DefaultValue\\": \\"1\\",\\n \\"Name\\": \\"max_concurrent_queries\\",\\n \\"Optional\\": \\"[0-100]\\",\\n \\"Comment\\": \\"Maximum number of concurrently executed queries. Zero means unlimited.\\",\\n \\"ParamRelyRule\\": \\"0\\",\\n \\"Value\\": \\"100\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - ], - 'ChangeResourceGroup' => [ - 'summary' => '资源转组', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"Cluster test\\",\\n \\"ResultSet\\": [\\n {\\n \\"QueryStartTime\\": \\"2023-04-13 17:48:00\\",\\n \\"MaxQueryDurationMs\\": 3000,\\n \\"Cnt\\": 1,\\n \\"MinQueryDurationMs\\": 1000,\\n \\"AvgQueryDurationMs\\": 2000\\n }\\n ]\\n }\\n}","type":"json"}]', + 'title' => 'DescribeSlowLogTrend', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSlowLogTrend', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'translator' => 'machine', + ], + 'DetachWhitelistTemplateToInstance' => [ + 'summary' => 'Disassociate a whitelist template from an instance.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -6237,124 +5051,146 @@ 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '163948', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '185639', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ - 'name' => 'ResourceType', - 'in' => 'query', - 'schema' => [ - 'title' => '资源类型', - 'description' => '', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [], - 'example' => 'EnterpriseDBCluster', - 'default' => 'EnterpriseDBCluster', - ], - ], - [ - 'name' => 'ResourceId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => '资源Id', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-bp1i43033051****', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'ResourceRegionId', + 'name' => 'TemplateId', 'in' => 'query', - 'schema' => [ - 'title' => '地域Id', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The whitelist template ID.', 'type' => 'string', 'required' => true, 'example' => '98a6d3db05984dca', 'title' => ''], ], [ - 'name' => 'ResourceGroupId', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'title' => '目标资源组', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'rg-4690g37929****', - ], + 'schema' => ['description' => 'The IDs of the ClickHouse instances, separated by commas. You can specify up to 20 IDs.', 'type' => 'string', 'required' => true, 'example' => 'cc-nkhdbf1d,cc-nkhdbf1s', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => 'C342F3DD-1FF7-55E9-A1A1-098D*******', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '1234567890', 'title' => ''], + 'Data' => [ + 'title' => '', + 'type' => 'object', + 'properties' => [ + 'Status' => ['description' => 'The status of the operation. A value of `ok` indicates success.', 'type' => 'string', 'example' => 'ok', 'title' => ''], + 'DetachFailList' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The instance ID.', 'type' => 'string', 'example' => 'my-database', 'title' => ''], + 'Reason' => ['description' => 'The reason the detach operation failed.', 'type' => 'string', 'example' => '处理异常', 'title' => ''], + ], + 'description' => 'Details of an instance that failed to detach.', + 'title' => '', + 'example' => '', + ], + 'description' => 'A list of instances that failed to detach.', + 'title' => '', + 'example' => '', + ], + 'DetachSuccessedList' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The instance ID.', 'type' => 'string', 'example' => 'my-database', 'title' => ''], + 'Templates' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'TemplateId' => ['description' => 'The whitelist template ID.', 'type' => 'string', 'example' => 'g-asdfwem', 'title' => ''], + 'TemplateName' => ['description' => 'The whitelist template name.', 'type' => 'string', 'example' => 'demo_template', 'title' => ''], + 'SecurityIPList' => ['description' => 'The IP whitelist.', 'type' => 'string', 'example' => '192.168.1.1,10.0.0.1', 'title' => ''], + 'DbInstances' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The instance ID.', 'type' => 'string', 'example' => 'asdfwef', 'title' => ''], + ], + 'description' => 'Details of an associated instance.', + 'title' => '', + 'example' => '', + ], + 'description' => 'A list of associated instances.', + 'title' => '', + 'example' => '', + ], + ], + 'description' => 'Details of a whitelist template.', + 'title' => '', + 'example' => '', + ], + 'description' => 'A list of whitelist templates.', + 'title' => '', + 'example' => '', + ], + ], + 'description' => 'Details of a successfully detached instance.', + 'title' => '', + 'example' => '', + ], + 'description' => 'A list of successfully detached instances.', + 'title' => '', + 'example' => '', + ], + ], + 'description' => 'The returned data.', + 'example' => '', ], ], + 'description' => 'The response.', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'NoPermission.ChangeResourceGroup', - 'errorMessage' => 'You are not authorized to change resourcegroup', - ], - [ - 'errorCode' => 'MissingParameter.ResourceRegionId', - 'errorMessage' => 'The ResourceRegionId parameters that are required for processing this request are missing', - ], - [ - 'errorCode' => 'MissingParameter.ResourceId', - 'errorMessage' => 'The ResourceId parameters that are required for processing this request are missing', - ], - [ - 'errorCode' => 'MissingParameter.ResourceGroupId', - 'errorMessage' => 'The ResourceGroupId parameters that are required for processing this request are missing', - ], - [ - 'errorCode' => 'InvalidResourceGroup', - 'errorMessage' => 'The specified ResourceGroupId is invalid', - ], - [ - 'errorCode' => 'SystemError', - 'errorMessage' => 'A system error occurred while processing your request', - ], - [ - 'errorCode' => 'ResourceNotFound', - 'errorMessage' => ' The specified resource is not found', - ], + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Invalid parameter.', 'description' => ''], + ['errorCode' => 'InvalidWhitelistTemplateId', 'errorMessage' => 'Invalid Whitelist templateId.', 'description' => ''], + ['errorCode' => 'InvalidWhitelistTemplate.IllegalPermission', 'errorMessage' => 'No permission to operate the whitelist template.', 'description' => ''], + ['errorCode' => 'InvalidDBInstanceId.TooManyItems', 'errorMessage' => 'The number of DBInstanceId should be no more than 20.', 'description' => ''], + ['errorCode' => 'InvalidParameter.DBInstanceId', 'errorMessage' => 'The specified parameter DBInstanceId is not valid.', 'description' => ''], ], ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C342F3DD-1FF7-55E9-A1A1-098D*******\\"\\n}","type":"json"}]', - ], - 'ListClickHouseDBTimezones' => [ - 'summary' => '列举ClickHouse时区参数枚举值', - 'path' => '', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', + 'title' => 'DetachWhitelistTemplateToInstance', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:DetachWhitelistTemplateToInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1234567890\\",\\n \\"Data\\": {\\n \\"Status\\": \\"ok\\",\\n \\"DetachFailList\\": [\\n {\\n \\"DBInstanceId\\": \\"my-database\\",\\n \\"Reason\\": \\"处理异常\\"\\n }\\n ],\\n \\"DetachSuccessedList\\": [\\n {\\n \\"DBInstanceId\\": \\"my-database\\",\\n \\"Templates\\": [\\n {\\n \\"TemplateId\\": \\"g-asdfwem\\",\\n \\"TemplateName\\": \\"demo_template\\",\\n \\"SecurityIPList\\": \\"192.168.1.1,10.0.0.1\\",\\n \\"DbInstances\\": [\\n {\\n \\"DBInstanceId\\": \\"asdfwef\\"\\n }\\n ]\\n }\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'GetWhitelistTemplate' => [ + 'summary' => 'Queries the details of a whitelist template.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -6363,92 +5199,110 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseFBPCH8', - ], + 'abilityTreeCode' => '185639', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ - 'name' => 'PageSize', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '10', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'PageNumber', + 'name' => 'TemplateId', 'in' => 'query', - 'schema' => [ - 'description' => '', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => 'The ID of the whitelist template.', 'type' => 'string', 'required' => true, 'example' => '98a6d3db05984dca', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC', - ], - 'TimeZones' => [ - 'description' => '', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'ZoneId' => [ - 'description' => '', - 'type' => 'string', - 'example' => 'Asia/Shanghai', + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '1234567890', 'title' => ''], + 'Data' => [ + 'title' => '', + 'type' => 'object', + 'properties' => [ + 'Templates' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'TemplateId' => ['description' => 'The ID of the whitelist template.', 'type' => 'string', 'example' => 'g-asdfwem', 'title' => ''], + 'TemplateName' => ['description' => 'The name of the whitelist template.', 'type' => 'string', 'example' => 'demo_template', 'title' => ''], + 'SecurityIPList' => ['description' => 'The IP whitelist.', 'type' => 'string', 'example' => '192.168.1.1,10.0.0.1', 'title' => ''], + 'DbInstances' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The instance ID.', 'type' => 'string', 'example' => 'cc-asdfwef', 'title' => ''], + ], + 'description' => 'The details of an instance.', + 'title' => '', + 'example' => '', + ], + 'description' => 'The list of associated instances.', + 'title' => '', + 'example' => '', + ], + ], + 'description' => 'The details of a whitelist template.', + 'title' => '', + 'example' => '', ], + 'description' => 'The list of whitelist templates.', + 'title' => '', + 'example' => '', ], ], + 'description' => 'The whitelist template details.', + 'example' => '', ], ], + 'description' => 'The response object.', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'IdempotentParameterMismatch', - 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', - ], + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Invalid parameter.', 'description' => ''], + ['errorCode' => 'InvalidWhitelistTemplateId', 'errorMessage' => 'Invalid Whitelist templateId.', 'description' => ''], + ['errorCode' => 'InvalidWhitelistTemplate.IllegalPermission', 'errorMessage' => 'No permission to operate the whitelist template.', 'description' => ''], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"TimeZones\\": [\\n {\\n \\"ZoneId\\": \\"Asia/Shanghai\\"\\n }\\n ]\\n}","type":"json"}]', - ], - 'DeleteWhitelistTemplate' => [ - 'summary' => '删除白名单模板', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'schemes' => [ - 'https', + 'title' => 'GetWhitelistTemplate', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:GetWhitelistTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1234567890\\",\\n \\"Data\\": {\\n \\"Templates\\": [\\n {\\n \\"TemplateId\\": \\"g-asdfwem\\",\\n \\"TemplateName\\": \\"demo_template\\",\\n \\"SecurityIPList\\": \\"192.168.1.1,10.0.0.1\\",\\n \\"DbInstances\\": [\\n {\\n \\"DBInstanceId\\": \\"cc-asdfwef\\"\\n }\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'KillProcess' => [ + 'summary' => 'Terminates a running task.', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -6457,489 +5311,381 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', + 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185639', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '186648', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'TemplateId', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'title' => '白名单模板Id', - 'type' => 'string', - 'required' => true, - 'example' => '98a6d3db05984dca', - ], + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-xxxxxxx', 'title' => ''], ], [ - 'name' => 'TemplateName', + 'name' => 'InitialQueryId', 'in' => 'query', - 'schema' => [ - 'title' => '白名单模板Id', - 'type' => 'string', - 'example' => '98a6d3db05984dca', - ], + 'schema' => ['description' => 'The query ID.', 'type' => 'string', 'required' => false, 'example' => '1', 'title' => ''], + ], + [ + 'name' => 'ComputingGroupId', + 'in' => 'query', + 'schema' => ['description' => 'The computing group ID.', 'type' => 'string', 'required' => false, 'example' => 'cc-gs5j3sua77******-clickhouse', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', + 'description' => 'The response parameters.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'type' => 'string', - 'example' => '1234567890', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'xxx-xxx-xxx'], 'Data' => [ - 'title' => '', + 'description' => 'The response data.', 'type' => 'object', 'properties' => [ - 'Templates' => [ - 'title' => '白名单模板列表', - 'type' => 'array', - 'items' => [ - 'title' => '模板详情', - 'type' => 'object', - 'properties' => [ - 'TemplateId' => [ - 'title' => '白名单模板ID', - 'type' => 'string', - 'example' => 'g-asdfwem', - ], - 'SecurityIPList' => [ - 'title' => 'ip白名单列表', - 'type' => 'string', - 'example' => '192.168.1.1,10.0.0.1', - ], - 'DbInstances' => [ - 'title' => '关联的实例列表', - 'type' => 'array', - 'items' => [ - 'title' => '实例详情', - 'type' => 'object', - 'properties' => [ - 'DbInstanceName' => [ - 'title' => '实例ID', - 'type' => 'string', - 'example' => 'asdfwef', - ], - ], - ], - ], - ], - ], - ], + 'DBInstanceID' => ['description' => 'The cluster ID.', 'type' => 'integer', 'format' => 'int32', 'example' => 'cc-xxxxxxx', 'title' => ''], + 'DBInstanceName' => ['description' => 'The cluster name.', 'type' => 'string', 'example' => 'cc-xxxxxxx'."\n", 'title' => ''], + 'Count' => ['description' => 'The number of terminated tasks.', 'type' => 'integer', 'format' => 'int64', 'example' => '1', 'title' => ''], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidParameter', - 'errorMessage' => 'Invalid parameter.', - ], - [ - 'errorCode' => 'InvalidWhitelistTemplateId', - 'errorMessage' => 'Invalid Whitelist templateId.', - ], - [ - 'errorCode' => 'InvalidWhitelistTemplate.IllegalPermission', - 'errorMessage' => 'No permission to operate the whitelist template.', - ], - ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => null, - ], - 'CreateWhitelistTemplate' => [ - 'summary' => '新增白名单模板', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"cc-xxxxxxx\\\\n\\",\\n \\"Count\\": 1\\n }\\n}","type":"json"}]', + 'title' => 'KillProcess', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:KillProcess', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + ], + 'ListClickHouseDBTimezones' => [ + 'summary' => 'Lists the available time zones for ClickHouse.', + 'path' => '', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185639', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], - 'tenantRelevance' => 'publicInformation', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => 'RegionId', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The number of records on each page. Valid values:'."\n" + ."\n" + .'- **30** (default)'."\n" + ."\n" + .'- **50**'."\n" + ."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'default' => '10', 'required' => false, 'example' => '30', 'title' => ''], ], [ - 'name' => 'TemplateName', + 'name' => 'PageNumber', 'in' => 'query', + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'default' => '1', 'required' => false, 'example' => '1', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'title' => '白名单模板名称', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'InvoiceTemplate', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'Id of the request', 'type' => 'string', 'title' => '', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], + 'TimeZones' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ZoneId' => ['description' => 'The enumeration value for the time zone.', 'type' => 'string', 'example' => 'Asia/Shanghai', 'title' => ''], + ], + 'description' => '', + 'title' => '', + 'example' => '', + ], + 'description' => 'The list of time zones that ClickHouse supports.', + 'title' => '', + 'example' => '', + ], + ], + 'title' => '', + 'description' => 'Schema of Response', + 'example' => '', ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', 'description' => ''], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => 'ListClickHouseDBTimezones', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"TimeZones\\": [\\n {\\n \\"ZoneId\\": \\"Asia/Shanghai\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'ListInstanceLinkedWhitelistTemplates' => [ + 'summary' => 'Lists the IP address whitelist templates linked to an instance.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'SecurityIPList', - 'in' => 'formData', - 'schema' => [ - 'title' => '白名单列表. 逗号分隔，数量不超过100个。', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => '192.168.1.1,10.0.0.1', - ], + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185639', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The instance ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-exadfas', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => '1234567890', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '1234567890', 'title' => ''], 'Data' => [ - 'title' => '', - 'description' => '', 'type' => 'object', 'properties' => [ 'Templates' => [ - 'title' => '白名单模板列表', - 'description' => '', 'type' => 'array', 'items' => [ - 'title' => '模板详情', - 'description' => '', 'type' => 'object', 'properties' => [ - 'TemplateId' => [ - 'title' => '白名单模板ID', - 'description' => '', - 'type' => 'string', - 'example' => 'g-asdfwem', - ], - 'TemplateName' => [ - 'title' => '白名单模板名称', - 'description' => '', - 'type' => 'string', - 'example' => 'demo_template', - ], - 'SecurityIPList' => [ - 'title' => 'ip白名单列表', - 'description' => '', - 'type' => 'string', - 'example' => '192.168.1.1,10.0.0.1', - ], + 'TemplateId' => ['description' => 'The IP address whitelist template ID.', 'type' => 'string', 'example' => 'g-asdfwem', 'title' => ''], + 'TemplateName' => ['description' => 'The IP address whitelist template name.', 'type' => 'string', 'example' => 'demo_template', 'title' => ''], + 'SecurityIPList' => ['description' => 'The comma-separated IP addresses in the whitelist.', 'type' => 'string', 'example' => '192.168.1.1,10.0.0.1', 'title' => ''], ], + 'description' => 'An IP address whitelist template.', + 'title' => '', + 'example' => '', ], + 'description' => 'A list of IP address whitelist templates.', + 'title' => '', + 'example' => '', ], ], + 'description' => 'The response data.', + 'title' => '', + 'example' => '', ], ], + 'description' => 'The response object.', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidSecurityIPs.Malformed', - 'errorMessage' => 'Specified IPList is not valid.', - ], - [ - 'errorCode' => 'InvalidParameter', - 'errorMessage' => 'Invalid parameter.', - ], - [ - 'errorCode' => 'InvalidWhitelistTemplateName.Duplicated', - 'errorMessage' => 'Whitelist template name duplicated.', - ], - [ - 'errorCode' => 'InvalidSecurityIPList.QuotaExceeded', - 'errorMessage' => 'Specified security IP list is not valid: Exceeding the allowed amount of IP address in the list.', - ], - [ - 'errorCode' => 'InvalidSecurityIPList.Format', - 'errorMessage' => 'Specified security IP list format is not valid.', - ], - [ - 'errorCode' => 'InvalidWhitelistTemplateName.CreateLimit', - 'errorMessage' => 'Created Whitelist template name exceeded limit.', - ], - [ - 'errorCode' => 'InvalidIpWhitelistTemplateName.Malformed', - 'errorMessage' => 'The templateName is not valid.', - ], - [ - 'errorCode' => 'InvalidSecurityIPList.Duplicate', - 'errorMessage' => 'Specified security IP list is not valid: Duplicate IP address in the list', - ], - [ - 'errorCode' => 'InvalidUser.NotFound', - 'errorMessage' => 'Specified user does not exist.', - ], + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Invalid parameter.', 'description' => ''], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], + 'title' => 'ListInstanceLinkedWhitelistTemplates', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:ListInstanceLinkedWhitelistTemplates', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1234567890\\",\\n \\"Data\\": {\\n \\"Templates\\": [\\n {\\n \\"TemplateId\\": \\"g-asdfwem\\",\\n \\"TemplateName\\": \\"demo_template\\",\\n \\"SecurityIPList\\": \\"192.168.1.1,10.0.0.1\\"\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'DetachWhitelistTemplateToInstance' => [ - 'summary' => '取消白名单模板和实例关联关系', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'ListWhitelistTemplates' => [ + 'summary' => 'Queries the whitelist templates associated with an instance.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '185639', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'TemplateId', + 'name' => 'TemplateName', 'in' => 'query', - 'schema' => [ - 'title' => '白名单模板Id', - 'type' => 'string', - 'required' => true, - 'example' => '98a6d3db05984dca', - ], + 'schema' => ['description' => 'The whitelist template name. Fuzzy search is supported.', 'type' => 'string', 'example' => 'default', 'title' => '', 'required' => false], ], [ - 'name' => 'DBInstanceId', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'title' => '数据库实例名。逗号分隔，一次关联变更不超过20个', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-nkhdbf1d,cc-nkhdbf1s', - ], + 'schema' => ['description' => 'The page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'default' => '1', 'title' => '', 'required' => false], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => 'The number of entries per page.', 'type' => 'integer', 'format' => 'int32', 'example' => '25', 'default' => '25', 'title' => '', 'required' => false], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'type' => 'string', - 'example' => '1234567890', - ], + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '1234567890', 'title' => ''], 'Data' => [ - 'title' => '', 'type' => 'object', 'properties' => [ - 'Status' => [ - 'title' => '操作状态。ok', - 'type' => 'string', - 'example' => 'ok', - ], - 'DetachFailList' => [ - 'title' => '解绑失败实例', - 'type' => 'array', - 'items' => [ - 'title' => '实例解绑失败详情', - 'type' => 'object', - 'properties' => [ - 'DBInstanceId' => [ - 'title' => '实例名称', - 'type' => 'string', - 'example' => 'my-database', - ], - 'Reason' => [ - 'title' => '解绑失败原因', - 'type' => 'string', - 'example' => '处理异常', - ], - ], - ], - ], - 'DetachSuccessedList' => [ - 'title' => '绑定成功模板', + 'TotalCount' => ['description' => 'The total number of templates.', 'type' => 'integer', 'format' => 'int32', 'example' => '30', 'title' => ''], + 'PageSize' => ['description' => 'The number of entries per page.', 'type' => 'integer', 'format' => 'int32', 'example' => '20', 'title' => ''], + 'CurrPageNumbers' => ['description' => 'The current page number.', 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'TotalPageNumbers' => ['description' => 'The total number of pages.', 'type' => 'integer', 'format' => 'int32', 'example' => '2', 'title' => ''], + 'HasPrev' => ['description' => 'Whether a previous page exists.', 'type' => 'boolean', 'example' => 'false', 'title' => ''], + 'HasNext' => ['description' => 'Whether a next page exists.', 'type' => 'boolean', 'example' => 'true', 'title' => ''], + 'Templates' => [ 'type' => 'array', 'items' => [ - 'title' => '实例绑定成功详情', 'type' => 'object', 'properties' => [ - 'DBInstanceId' => [ - 'title' => '实例名称', - 'type' => 'string', - 'example' => 'my-database', - ], - 'Templates' => [ - 'title' => '白名单模板列表', + 'TemplateId' => ['description' => 'The whitelist template ID.', 'type' => 'string', 'example' => 'g-asdfwem', 'title' => ''], + 'TemplateName' => ['description' => 'The whitelist template name.', 'type' => 'string', 'example' => 'g-asdfwem', 'title' => ''], + 'SecurityIPList' => ['description' => 'The IP address whitelist.', 'type' => 'string', 'example' => '192.168.1.1,10.0.0.1', 'title' => ''], + 'DbInstances' => [ 'type' => 'array', 'items' => [ - 'title' => '模板详情', 'type' => 'object', 'properties' => [ - 'TemplateId' => [ - 'title' => '白名单模板ID', - 'type' => 'string', - 'example' => 'g-asdfwem', - ], - 'TemplateName' => [ - 'title' => '白名单模板名称', - 'type' => 'string', - 'example' => 'demo_template', - ], - 'SecurityIPList' => [ - 'title' => 'ip白名单列表', - 'type' => 'string', - 'example' => '192.168.1.1,10.0.0.1', - ], - 'DbInstances' => [ - 'title' => '关联的实例列表', - 'type' => 'array', - 'items' => [ - 'title' => '实例详情', - 'type' => 'object', - 'properties' => [ - 'DBInstanceId' => [ - 'title' => '实例ID', - 'type' => 'string', - 'example' => 'asdfwef', - ], - ], - ], - ], + 'DBInstanceId' => ['description' => 'The instance ID.', 'type' => 'string', 'example' => 'cc-asdfwef', 'title' => ''], ], + 'description' => 'The details of an associated instance.', + 'title' => '', + 'example' => '', ], + 'description' => 'The list of associated instances.', + 'title' => '', + 'example' => '', ], ], + 'description' => 'The details of a whitelist template.', + 'title' => '', + 'example' => '', ], + 'description' => 'The list of whitelist templates.', + 'title' => '', + 'example' => '', ], ], + 'description' => 'The query results.', + 'title' => '', + 'example' => '', ], ], + 'description' => 'The data returned.', + 'title' => '', + 'example' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidParameter', - 'errorMessage' => 'Invalid parameter.', - ], - [ - 'errorCode' => 'InvalidWhitelistTemplateId', - 'errorMessage' => 'Invalid Whitelist templateId.', - ], - [ - 'errorCode' => 'InvalidWhitelistTemplate.IllegalPermission', - 'errorMessage' => 'No permission to operate the whitelist template.', - ], - [ - 'errorCode' => 'InvalidDBInstanceId.TooManyItems', - 'errorMessage' => 'The number of DBInstanceId should be no more than 20.', - ], - [ - 'errorCode' => 'InvalidParameter.DBInstanceId', - 'errorMessage' => 'The specified parameter DBInstanceId is not valid.', - ], + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Invalid parameter.', 'description' => ''], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - ], - 'UpdateWhitelistTemplate' => [ - 'summary' => '更新白名单模板', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'title' => 'ListWhitelistTemplates', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:ListWhitelistTemplates', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1234567890\\",\\n \\"Data\\": {\\n \\"TotalCount\\": 30,\\n \\"PageSize\\": 20,\\n \\"CurrPageNumbers\\": 1,\\n \\"TotalPageNumbers\\": 2,\\n \\"HasPrev\\": false,\\n \\"HasNext\\": true,\\n \\"Templates\\": [\\n {\\n \\"TemplateId\\": \\"g-asdfwem\\",\\n \\"TemplateName\\": \\"g-asdfwem\\",\\n \\"SecurityIPList\\": \\"192.168.1.1,10.0.0.1\\",\\n \\"DbInstances\\": [\\n {\\n \\"DBInstanceId\\": \\"cc-asdfwef\\"\\n }\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'ModifyAccountAuthority' => [ + 'summary' => 'Modifies the permissions of a database account.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -6951,50 +5697,70 @@ 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185639', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '185304', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.'."\n", 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'TemplateId', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'title' => '白名单模板Id', - 'type' => 'string', - 'required' => true, - 'example' => '98a6d3db05984dca', - ], + 'schema' => ['description' => 'The cluster ID.'."\n", 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], ], [ - 'name' => 'TemplateName', + 'name' => 'Account', 'in' => 'query', - 'schema' => [ - 'title' => '白名单模板Id', - 'type' => 'string', - 'required' => true, - 'example' => '98a6d3db05984dca', - ], + 'schema' => ['description' => 'The name of the database account.'."\n", 'type' => 'string', 'required' => true, 'example' => 'test1', 'title' => ''], ], [ - 'name' => 'SecurityIPList', + 'name' => 'DmlAuthSetting', 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'title' => '白名单列表. 逗号分隔，数量不超过100个。', - 'type' => 'string', + 'description' => 'The information about permissions.'."\n", + 'type' => 'object', + 'properties' => [ + 'DmlAuthority' => [ + 'description' => 'Specifies whether to grant the DML permissions to the database account. Valid values:'."\n" + ."\n" + .'* **0**: The account has the permissions to read data from the database, write data to the database, and modify the settings of the database.'."\n" + .'* **1**: The account only has the permissions to read data from the database.'."\n" + .'* **2**: The account only has the permissions to read data from the database and modify the settings of the database.'."\n", + 'type' => 'integer', + 'format' => 'int32', + 'required' => true, + 'example' => '0', + 'enum' => ['0', '1', '2'], + 'title' => '', + ], + 'DdlAuthority' => ['description' => 'Specifies whether to grant the DDL permissions to the database account. Valid values:'."\n" + ."\n" + .'* **true**: The account has the permissions to execute DDL statements.'."\n" + .'* **false**: The account does not have the permissions to execute DDL statements.'."\n", 'type' => 'boolean', 'required' => true, 'example' => 'true', 'title' => ''], + 'AllowDictionaries' => [ + 'description' => 'The dictionaries on which you want to grant permissions. Separate multiple dictionaries with commas (,).'."\n", + 'type' => 'array', + 'items' => ['description' => 'The dictionary on which you want to grant permissions. Separate multiple dictionaries with commas (,).'."\n", 'type' => 'string', 'required' => false, 'example' => 'db1,db2', 'title' => ''], + 'required' => false, + 'title' => '', + 'example' => '', + ], + 'AllowDatabases' => [ + 'description' => 'The databases on which you want to grant permissions. Separate multiple databases with commas (,).'."\n", + 'type' => 'array', + 'items' => ['description' => 'The database on which you want to grant permissions. Separate multiple databases with commas (,).'."\n", 'type' => 'string', 'required' => false, 'example' => 'db1,db2', 'title' => ''], + 'required' => false, + 'title' => '', + 'example' => '', + ], + ], 'required' => true, - 'example' => '192.168.1.1,10.0.0.1', + 'title' => '', + 'example' => '', ], ], ], @@ -7002,231 +5768,151 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'type' => 'string', - 'example' => '1234567890', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.'."\n", 'type' => 'string', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0'], 'Data' => [ - 'title' => '', + 'description' => 'The result returned.'."\n", 'type' => 'object', 'properties' => [ - 'Templates' => [ - 'title' => '白名单模板列表', - 'type' => 'array', - 'items' => [ - 'title' => '模板详情', - 'type' => 'object', - 'properties' => [ - 'TemplateId' => [ - 'title' => '白名单模板ID', - 'type' => 'string', - 'example' => 'g-asdfwem', - ], - 'SecurityIPList' => [ - 'title' => 'ip白名单列表', - 'type' => 'string', - 'example' => '192.168.1.1,10.0.0.1', - ], - 'DbInstances' => [ - 'title' => '关联的实例列表', - 'type' => 'array', - 'items' => [ - 'title' => '实例详情', - 'type' => 'object', - 'properties' => [ - 'DbInstanceName' => [ - 'title' => '实例ID', - 'type' => 'string', - 'example' => 'asdfwef', - ], - ], - ], - ], - ], - ], - ], + 'DBInstanceId' => ['description' => 'The cluster ID.'."\n", 'type' => 'string', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'Account' => ['description' => 'The name of the database account.'."\n", 'type' => 'string', 'example' => 'test1', 'title' => ''], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidSecurityIPs.Malformed', - 'errorMessage' => 'Specified IPList is not valid.', - ], - [ - 'errorCode' => 'InvalidParameter', - 'errorMessage' => 'Invalid parameter.', - ], - [ - 'errorCode' => 'InvalidWhitelistTemplateId', - 'errorMessage' => 'Invalid Whitelist templateId.', - ], - [ - 'errorCode' => 'InvalidSecurityIPList.QuotaExceeded', - 'errorMessage' => 'Specified security IP list is not valid: Exceeding the allowed amount of IP address in the list.', - ], - [ - 'errorCode' => 'InvalidWhitelistTemplate.IllegalPermission', - 'errorMessage' => 'No permission to operate the whitelist template.', - ], + 403 => [ + ['errorCode' => 'InvalidDBInstanceState.NotSupport', 'errorMessage' => 'The specified instance state does\'t support this operation.', 'description' => ''], + ], + [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'The passed instance ID does not exist.'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - ], - 'GetWhitelistTemplate' => [ - 'summary' => '查询白名单模板详情', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'title' => 'ModifyAccountAuthority', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyAccountAuthority', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Account\\": \\"test1\\"\\n }\\n}","type":"json"}]', + ], + 'ModifyAccountDescription' => [ + 'summary' => 'Modifies the description of a database account.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185639', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '185303', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.'."\n", 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], ], [ - 'name' => 'TemplateId', + 'name' => 'DBInstanceId', 'in' => 'query', - 'schema' => [ - 'title' => '白名单模板Id', - 'type' => 'string', - 'required' => true, - 'example' => '98a6d3db05984dca', - ], + 'schema' => ['description' => 'The cluster ID.'."\n", 'type' => 'string', 'required' => true, 'example' => 'cc-bp1anv7jo84t****', 'title' => ''], + ], + [ + 'name' => 'Account', + 'in' => 'query', + 'schema' => ['description' => 'The name of the account.'."\n", 'type' => 'string', 'required' => true, 'example' => 'testuser', 'title' => ''], + ], + [ + 'name' => 'Description', + 'in' => 'query', + 'schema' => ['description' => 'The description of the account.'."\n", 'type' => 'string', 'required' => true, 'example' => 'test', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', + 'description' => 'The response parameters.'."\n", 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'type' => 'string', - 'example' => '1234567890', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.'."\n", 'type' => 'string', 'example' => '7FFC9EBE-5023-5D5D-A5F0-1607E0F2****'], 'Data' => [ - 'title' => '', + 'description' => 'The returned data.'."\n", 'type' => 'object', 'properties' => [ - 'Templates' => [ - 'title' => '白名单模板列表', - 'type' => 'array', - 'items' => [ - 'title' => '模板详情', - 'type' => 'object', - 'properties' => [ - 'TemplateId' => [ - 'title' => '白名单模板ID', - 'type' => 'string', - 'example' => 'g-asdfwem', - ], - 'TemplateName' => [ - 'title' => '白名单模板名称', - 'type' => 'string', - 'example' => 'demo_template', - ], - 'SecurityIPList' => [ - 'title' => 'ip白名单列表', - 'type' => 'string', - 'example' => '192.168.1.1,10.0.0.1', - ], - 'DbInstances' => [ - 'title' => '关联的实例列表', - 'type' => 'array', - 'items' => [ - 'title' => '实例详情', - 'type' => 'object', - 'properties' => [ - 'DBInstanceId' => [ - 'title' => '实例ID', - 'type' => 'string', - 'example' => 'cc-asdfwef', - ], - ], - ], - ], - ], - ], - ], + 'DBInstanceId' => ['description' => 'The cluster ID.'."\n", 'type' => 'string', 'example' => 'cc-bp1anv7jo84t****', 'title' => ''], + 'Account' => ['description' => 'The name of the database account.'."\n", 'type' => 'string', 'example' => 'testuser', 'title' => ''], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidParameter', - 'errorMessage' => 'Invalid parameter.', - ], - [ - 'errorCode' => 'InvalidWhitelistTemplateId', - 'errorMessage' => 'Invalid Whitelist templateId.', - ], - [ - 'errorCode' => 'InvalidWhitelistTemplate.IllegalPermission', - 'errorMessage' => 'No permission to operate the whitelist template.', - ], + 403 => [ + ['errorCode' => 'InvalidDBInstanceState.NotSupport', 'errorMessage' => 'The specified instance state does\'t support this operation.', 'description' => ''], + ], + [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'The passed instance ID does not exist.'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - ], - 'AttachWhitelistTemplateToInstance' => [ - 'summary' => '白名单模板关联实例', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'title' => 'ModifyAccountDescription', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyAccountDescription', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7FFC9EBE-5023-5D5D-A5F0-1607E0F2****\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp1anv7jo84t****\\",\\n \\"Account\\": \\"testuser\\"\\n }\\n}","type":"json"}]', + ], + 'ModifyBackupPolicy' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -7235,271 +5921,291 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185639', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '206399', + 'abilityTreeNodes' => ['FEATUREclickhouseIL81EM'], ], 'parameters' => [ + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-xxxxx', 'title' => ''], + ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => 'RegionId', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-beijing', 'title' => ''], ], [ - 'name' => 'TemplateId', + 'name' => 'PreferredBackupTime', 'in' => 'query', - 'schema' => [ - 'title' => '白名单模板Id', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => '98a6d3db05984dca', - ], + 'schema' => ['description' => 'The backup time.', 'type' => 'string', 'required' => true, 'example' => '15:00Z-16:00Z', 'title' => ''], ], [ - 'name' => 'DBInstanceId', + 'name' => 'PreferredBackupPeriod', 'in' => 'query', - 'schema' => [ - 'title' => '数据库实例。逗号分隔，一次关联变更不超过20个', - 'description' => '', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-nkhdbf1d,cc-nkhdbf1s', - ], + 'schema' => ['description' => 'The backup cycle.', 'type' => 'string', 'required' => true, 'example' => 'Monday', 'title' => ''], + ], + [ + 'name' => 'BackupRetentionPeriod', + 'in' => 'query', + 'schema' => ['description' => 'The number of days to retain backups.', 'type' => 'string', 'required' => false, 'example' => '7', 'title' => ''], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => 'The response.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => '1234567890', - ], - 'Data' => [ - 'title' => '', - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'Status' => [ - 'title' => '操作状态。ok', - 'description' => '', - 'type' => 'string', - 'example' => 'ok', - ], - 'AttachFailList' => [ - 'title' => '解绑失败实例', - 'description' => '', - 'type' => 'array', - 'items' => [ - 'title' => '实例解绑失败详情', - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'DBInstanceId' => [ - 'title' => '实例名称', - 'description' => '', - 'type' => 'string', - 'example' => 'my-database', - ], - 'Reason' => [ - 'title' => '解绑失败原因', - 'description' => '', - 'type' => 'string', - 'example' => '处理异常', - ], - ], - ], - ], - 'AttachSuccessedList' => [ - 'title' => '绑定成功模板', - 'description' => '', - 'type' => 'array', - 'items' => [ - 'title' => '实例绑定成功详情', - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'DBInstanceId' => [ - 'title' => '实例名称', - 'description' => '', - 'type' => 'string', - 'example' => 'my-database', - ], - 'Templates' => [ - 'title' => '白名单模板列表', - 'description' => '', - 'type' => 'array', - 'items' => [ - 'title' => '模板详情', - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'TemplateId' => [ - 'title' => '白名单模板ID', - 'description' => '', - 'type' => 'string', - 'example' => 'g-asdfwem', - ], - 'TemplateName' => [ - 'title' => '白名单模板名称', - 'description' => '', - 'type' => 'string', - 'example' => 'demo_template', - ], - 'SecurityIPList' => [ - 'title' => 'ip白名单列表', - 'description' => '', - 'type' => 'string', - 'example' => '192.168.1.1,10.0.0.1', - ], - 'DbInstances' => [ - 'title' => '关联的实例列表', - 'description' => '', - 'type' => 'array', - 'items' => [ - 'title' => '实例详情', - 'description' => '', - 'type' => 'object', - 'properties' => [ - 'DBInstanceId' => [ - 'title' => '实例ID', - 'description' => '', - 'type' => 'string', - 'example' => 'asdfwef', - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], ], + 'example' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidParameter', - 'errorMessage' => 'Invalid parameter.', - ], - [ - 'errorCode' => 'InvalidWhitelistTemplateId', - 'errorMessage' => 'Invalid Whitelist templateId.', - ], - [ - 'errorCode' => 'InvalidWhitelistTemplate.IllegalPermission', - 'errorMessage' => 'No permission to operate the whitelist template.', - ], - [ - 'errorCode' => 'InvalidDBInstanceId.TooManyItems', - 'errorMessage' => 'The number of DBInstanceId should be no more than 20.', - ], - [ - 'errorCode' => 'InvalidParameter.DBInstanceId', - 'errorMessage' => 'The specified parameter DBInstanceId is not valid.', - ], - [ - 'errorCode' => 'InvalidAttachTemplate.QuotaExceeded', - 'errorMessage' => 'Exceed the upper limit of the template that the instance can bind.', - ], + ['errorCode' => 'StorageTypeDoNotSupportBackup', 'errorMessage' => 'Current StorageType Does Not Support Backup.', 'description' => 'The current storage type does not support backup'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1234567890\\",\\n \\"Data\\": {\\n \\"Status\\": \\"ok\\",\\n \\"AttachFailList\\": [\\n {\\n \\"DBInstanceId\\": \\"my-database\\",\\n \\"Reason\\": \\"处理异常\\"\\n }\\n ],\\n \\"AttachSuccessedList\\": [\\n {\\n \\"DBInstanceId\\": \\"my-database\\",\\n \\"Templates\\": [\\n {\\n \\"TemplateId\\": \\"g-asdfwem\\",\\n \\"TemplateName\\": \\"demo_template\\",\\n \\"SecurityIPList\\": \\"192.168.1.1,10.0.0.1\\",\\n \\"DbInstances\\": [\\n {\\n \\"DBInstanceId\\": \\"asdfwef\\"\\n }\\n ]\\n }\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', - ], - 'ListWhitelistTemplates' => [ - 'summary' => '查询白名单模板清单', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'title' => 'ModifyBackupPolicy', + 'summary' => 'Modifies the backup policy of an ApsaraDB for ClickHouse cluster.', + 'description' => '> Data backup is supported only for ApsaraDB for ClickHouse clusters that run version 20.3, 20.8, or 21.8.', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\"\\n}","type":"json"}]', + ], + 'ModifyDBInstanceAttribute' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '185639', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], - ], + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-xxxxx'], + ], + [ + 'name' => 'AttributeType', + 'in' => 'query', 'schema' => [ - 'title' => 'RegionId', + 'description' => 'The type of attribute to modify. Valid values:'."\n" + ."\n" + .'- MaintainTime: Modify the O\\&M window.'."\n" + ."\n" + .'- DBInstanceDescription: Modify the instance name.', 'type' => 'string', 'required' => true, - 'example' => 'cn-hangzhou', + 'enumValueTitles' => [], + 'enum' => ['MaintainTime', 'DBInstanceDescription'], + 'title' => '', + 'example' => 'DBInstanceDescription', ], ], [ - 'name' => 'TemplateName', + 'name' => 'AttributeValue', 'in' => 'query', + 'schema' => ['description' => 'The new value for the attribute.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'test'], + ], + [ + 'name' => 'Product', + 'in' => 'query', + 'schema' => ['description' => 'The product code.', 'type' => 'string', 'required' => false, 'default' => 'clickhouse', 'title' => '', 'example' => 'clickhouse'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'title' => '模板名称，支持模糊查询', - 'type' => 'string', - 'example' => 'default', + 'title' => 'Schema of Response', + 'description' => 'The details of the returned parameters.', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'xxx-xxx-xxx'], + ], + 'example' => '', + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'ModifyDBInstanceAttribute', + 'summary' => 'You can call the ModifyDBInstanceAttribute operation to modify the configuration of a cluster.', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBInstanceAttribute', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\"\\n}","type":"json"}]', + ], + 'ModifyDBInstanceClass' => [ + 'summary' => 'Use `ModifyDBInstanceClass` to modify the scaling configuration of a cluster.', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'PageNumber', + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '188578', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'example' => 'cn-hangzhou', 'title' => '', 'required' => false], + ], + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-gs5j3sua77*******', 'title' => ''], + ], + [ + 'name' => 'ScaleMin', + 'in' => 'query', + 'schema' => ['description' => 'The minimum capacity for serverless autoscaling.', 'type' => 'integer', 'format' => 'int64', 'example' => '8', 'title' => '', 'required' => false], + ], + [ + 'name' => 'ScaleMax', + 'in' => 'query', + 'schema' => ['description' => 'The maximum capacity for serverless autoscaling.', 'type' => 'integer', 'format' => 'int64', 'example' => '32', 'title' => '', 'required' => false], + ], + [ + 'name' => 'NodeScaleMax', + 'in' => 'query', + 'schema' => ['description' => 'The maximum capacity per node for serverless autoscaling. Valid values: 4 to 32. This value must be greater than the minimum value.', 'type' => 'integer', 'format' => 'int32', 'maximum' => '128', 'minimum' => '4', 'example' => '4', 'title' => '', 'required' => false], + ], + [ + 'name' => 'NodeScaleMin', + 'in' => 'query', + 'schema' => ['description' => 'The minimum capacity per node for serverless autoscaling. Valid values: 4 to 32.', 'type' => 'integer', 'format' => 'int32', 'maximum' => '128', 'minimum' => '4', 'example' => '32', 'title' => '', 'required' => false], + ], + [ + 'name' => 'NodeCount', + 'in' => 'query', + 'schema' => ['description' => 'The number of nodes. Valid values: 2 to 16.', 'type' => 'integer', 'format' => 'int32', 'maximum' => '64', 'minimum' => '1', 'example' => '2', 'title' => '', 'required' => false], + ], + [ + 'name' => 'StorageQuota', + 'in' => 'query', + 'schema' => ['description' => 'The pre-purchased storage capacity in GB.', 'type' => 'integer', 'format' => 'int64', 'minimum' => '0', 'example' => '100', 'required' => false, 'title' => ''], + ], + [ + 'name' => 'StorageType', 'in' => 'query', 'schema' => [ - 'title' => '页码', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - 'default' => '1', + 'description' => 'The storage type.', + 'type' => 'string', + 'example' => 'OSS', + 'enum' => ['oss', 'ESSD_L1', 'ESSD_L2', 'ESSD_L3', 'SSD', 'ESSD_L0'], + 'title' => '', + 'required' => false, ], ], [ - 'name' => 'PageSize', + 'name' => 'ComputingGroupId', 'in' => 'query', + 'schema' => ['description' => 'The compute group ID.', 'type' => 'string', 'title' => '', 'required' => false, 'example' => 'cc-gs5j3sua77*******-clickhouse'], + ], + [ + 'name' => 'AutoScaleConfig', + 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'title' => '每页记录数量', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '25', - 'default' => '25', + 'type' => 'object', + 'properties' => [ + 'Status' => [ + 'description' => 'Specifies whether to enable or disable autoscaling. Valid values: `enable` and `disable`.', + 'type' => 'string', + 'required' => false, + 'example' => 'enable', + 'enum' => ['enable', 'disable'], + 'title' => '', + ], + 'BurstNum' => ['description' => 'The number of burstable nodes for autoscaling.', 'type' => 'integer', 'format' => 'int32', 'maximum' => '64', 'minimum' => '1', 'example' => '2', 'title' => '', 'required' => false], + 'VSwitchInfos' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ZoneId' => ['description' => 'The zone ID.', 'type' => 'string', 'example' => 'cn-beijing-XXX', 'title' => '', 'required' => false], + 'VSwitchIds' => [ + 'type' => 'array', + 'items' => ['description' => 'A VSwitch ID.', 'type' => 'string', 'example' => 'vsw-XXXXX', 'title' => '', 'required' => false], + 'description' => 'The VSwitch IDs.', + 'title' => '', + 'example' => '', + 'required' => false, + ], + ], + 'description' => '', + 'title' => '', + 'example' => '', + 'required' => false, + ], + 'minItems' => 0, + 'description' => 'Information about the VSwitches.', + 'title' => '', + 'example' => '', + 'required' => false, + ], + ], + 'description' => 'The autoscaling configuration for the compute group.', + 'title' => '', + 'example' => '', + 'required' => false, ], ], ], @@ -7507,331 +6213,1903 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', + 'description' => 'The response object.', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'type' => 'string', - 'example' => '1234567890', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'xxx-xxx-xxx'], 'Data' => [ - 'title' => '白名单模板清单结果', + 'description' => 'The response data.', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'title' => '总数', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'PageSize' => [ - 'title' => '分页数量', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'CurrPageNumbers' => [ - 'title' => '当前页码', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'TotalPageNumbers' => [ - 'title' => '总页码', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'HasPrev' => [ - 'title' => '是否有前一页', - 'type' => 'boolean', - 'example' => 'false', - ], - 'HasNext' => [ - 'title' => '是否有后一页', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Templates' => [ - 'title' => '白名单模板列表', - 'type' => 'array', - 'items' => [ - 'title' => '模板详情', - 'type' => 'object', - 'properties' => [ - 'TemplateId' => [ - 'title' => '白名单模板ID', - 'type' => 'string', - 'example' => 'g-asdfwem', - ], - 'TemplateName' => [ - 'title' => '白名单模板ID', - 'type' => 'string', - 'example' => 'g-asdfwem', - ], - 'SecurityIPList' => [ - 'title' => 'ip白名单列表', - 'type' => 'string', - 'example' => '192.168.1.1,10.0.0.1', - ], - 'DbInstances' => [ - 'title' => '关联的实例列表', - 'type' => 'array', - 'items' => [ - 'title' => '实例详情', - 'type' => 'object', - 'properties' => [ - 'DBInstanceId' => [ - 'title' => '实例ID', - 'type' => 'string', - 'example' => 'cc-asdfwef', - ], - ], - ], - ], - ], - ], - ], + 'TaskId' => ['description' => 'The task ID.', 'type' => 'integer', 'format' => 'int64', 'example' => '10000****', 'title' => ''], + 'ScaleMin' => ['description' => 'The minimum capacity for serverless autoscaling.', 'type' => 'integer', 'format' => 'int64', 'example' => '2', 'title' => ''], + 'ScaleMax' => ['description' => 'The maximum capacity for serverless autoscaling.', 'type' => 'integer', 'format' => 'int64', 'example' => '32', 'title' => ''], + 'DBInstanceID' => ['description' => 'The cluster ID.', 'type' => 'integer', 'format' => 'int64', 'example' => 'cc-gs5j3sua77*******', 'title' => ''], + 'DBInstanceName' => ['description' => 'The cluster name.', 'type' => 'string', 'example' => 'cc-gs5j3sua77*******', 'title' => ''], + 'ComputingGroupId' => ['description' => 'The compute group ID.', 'type' => 'string', 'example' => 'cc-gs5j3sua77*******-clickhouse', 'title' => ''], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidParameter', - 'errorMessage' => 'Invalid parameter.', - ], + ['errorCode' => 'InvalidSpecification', 'errorMessage' => 'Specification parameter is not valid.', 'description' => 'The specification parameter is invalid.'], + ['errorCode' => 'InvalidDBInstanceStatus', 'errorMessage' => 'The specified instance state does\'t support this operation.', 'description' => 'The instance state does not allow the current operation.'], + ['errorCode' => 'OperationDenied.OrderProcessing', 'errorMessage' => 'The operation is not permitted due to there is an order in processing of cluster.', 'description' => 'There is an outstanding order, please try again later.'], + ['errorCode' => 'OperationDenied.NothingChanged', 'errorMessage' => 'The instance operation changes the specification, but the incoming specification is the same as the current specification without any changes.', 'description' => 'The instance operation changes the specification, but the incoming specification is the same as the current specification without any changes.'], + ['errorCode' => 'ForbiddenRegisterAutoScaleConfig', 'errorMessage' => 'Can\'t register autoScale config', 'description' => ''], + ['errorCode' => 'InvalidAutoScaleConfig', 'errorMessage' => 'The autoScale config is invalid, param error', 'description' => ''], + ['errorCode' => 'UnsupportedAutoScaleZone', 'errorMessage' => 'ZoneId is null or the specified zone is not supported for autoScale', 'description' => ''], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - ], - 'ListInstanceLinkedWhitelistTemplates' => [ - 'summary' => '查询实例关联的白名单模板清单', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\",\\n \\"Data\\": {\\n \\"TaskId\\": 0,\\n \\"ScaleMin\\": 2,\\n \\"ScaleMax\\": 32,\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"cc-gs5j3sua77*******\\",\\n \\"ComputingGroupId\\": \\"cc-gs5j3sua77*******-clickhouse\\"\\n }\\n}","type":"json"}]', + 'title' => 'ModifyDBInstanceClass', + 'description' => 'Before you call this API, make sure that you understand the billing method and [pricing](~~167450~~) of ApsaraDB for ClickHouse.', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBInstanceClass', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], ], + ], + 'ModifyDBInstanceConfig' => [ + 'summary' => 'Modifies the parameter settings for a DB instance.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185639', - 'abilityTreeNodes' => [ - 'FEATUREclickhouseCVENTL', - ], + 'abilityTreeCode' => '206399', + 'abilityTreeNodes' => ['FEATUREclickhouseFBPCH8'], ], 'parameters' => [ + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The instance ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cc-uf6lkzf*****'], + ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'title' => '', 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DBInstanceId', + 'name' => 'Parameters', 'in' => 'query', - 'schema' => [ - 'title' => '实例名称', - 'type' => 'string', - 'required' => true, - 'example' => 'cc-exadfas', - ], + 'schema' => ['description' => 'The API data parameter settings in JSON format.', 'type' => 'string', 'required' => false, 'title' => '', 'example' => '{"max_concurrent_queries":"100"}'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', + 'title' => '', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'type' => 'string', - 'example' => '1234567890', - ], + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => '05321590-BB65-4720-8C***********'], 'Data' => [ - 'title' => '白名单模板清单结果', + 'description' => 'The returned data.', 'type' => 'object', 'properties' => [ - 'Templates' => [ - 'title' => '白名单模板列表', - 'type' => 'array', - 'items' => [ - 'title' => '模板详情', - 'type' => 'object', - 'properties' => [ - 'TemplateId' => [ - 'title' => '白名单模板ID', - 'type' => 'string', - 'example' => 'g-asdfwem', - ], - 'TemplateName' => [ - 'title' => '白名单模板名称', - 'type' => 'string', - 'example' => 'demo_template', - ], - 'SecurityIPList' => [ - 'title' => 'ip白名单列表', - 'type' => 'string', - 'example' => '192.168.1.1,10.0.0.1', - ], - ], - ], - ], + 'DBInstanceId' => ['description' => 'The instance ID.', 'type' => 'string', 'title' => '', 'example' => 'cc-uf6lkzf*****'."\n"], ], + 'title' => '', + 'example' => '', ], ], + 'example' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidParameter', - 'errorMessage' => 'Invalid parameter.', - ], - ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], + 'title' => 'ModifyDBInstanceConfig', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBInstanceConfig', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8C***********\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-uf6lkzf*****\\\\n\\"\\n }\\n}","type":"json"}]', ], - ], - 'endpoints' => [ - [ - 'regionId' => 'cn-qingdao', - 'endpoint' => 'clickhouse.cn-qingdao.aliyuncs.com', - ], - [ - 'regionId' => 'cn-beijing', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'cn-zhangjiakou', - 'endpoint' => 'clickhouse.cn-zhangjiakou.aliyuncs.com', - ], - [ - 'regionId' => 'cn-huhehaote', - 'endpoint' => 'clickhouse.cn-huhehaote.aliyuncs.com', - ], - [ - 'regionId' => 'cn-wulanchabu', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'cn-hangzhou', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'cn-shanghai', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'cn-shenzhen', - 'endpoint' => 'clickhouse.cn-shenzhen.aliyuncs.com', - ], - [ - 'regionId' => 'cn-guangzhou', - 'endpoint' => 'clickhouse.cn-guangzhou.aliyuncs.com', - ], - [ - 'regionId' => 'cn-chengdu', - 'endpoint' => 'clickhouse.cn-chengdu.aliyuncs.com', - ], - [ - 'regionId' => 'cn-hongkong', - 'endpoint' => 'clickhouse.cn-hongkong.aliyuncs.com', - ], - [ - 'regionId' => 'ap-northeast-1', - 'endpoint' => 'clickhouse.ap-northeast-1.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-1', - 'endpoint' => 'clickhouse.ap-southeast-1.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-3', - 'endpoint' => 'clickhouse.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-5', - 'endpoint' => 'clickhouse.ap-southeast-5.aliyuncs.com', + 'ModifyDBInstanceConnectionString' => [ + 'summary' => 'Modifies the connection string of a cluster.', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'high', + 'chargeType' => 'free', + 'abilityTreeCode' => '186649', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-xxxxx', 'title' => ''], + ], + [ + 'name' => 'ConnectionString', + 'in' => 'query', + 'schema' => ['description' => 'The connection string.', 'type' => 'string', 'required' => false, 'example' => 'cc-2ze34****-clickhouse..clickhouseserver.pre.rds.aliyuncs.com', 'title' => ''], + ], + [ + 'name' => 'ConnectionStringPrefix', + 'in' => 'query', + 'schema' => ['description' => 'The connection string prefix.', 'type' => 'string', 'required' => false, 'example' => 'cc-****-clickhouse', 'title' => ''], + ], + [ + 'name' => 'DisablePorts', + 'in' => 'query', + 'schema' => ['description' => '- The database ports to disable. You can specify multiple ports, separated by commas.'."\n" + ."\n" + .'- This parameter is supported only for clusters with a kernel version of 24.10.1.11098\\_1 or later.'."\n" + ."\n\n" + .' >'."\n" + ."\n" + .' This parameter is not supported for clusters that were upgraded to kernel version 24.10.1.11098\\_1 or later from an earlier version.'."\n" + ."\n" + .' >', 'type' => 'string', 'required' => false, 'example' => '9001,8123', 'title' => ''], + ], + [ + 'name' => 'DBInstanceNetType', + 'in' => 'query', + 'schema' => [ + 'description' => 'The network type. Valid values:'."\n" + ."\n" + .'- `Vpc`: VPC'."\n" + ."\n" + .'- `Public`: public network', + 'enumValueTitles' => ['Vpc' => 'VPC', 'Public' => 'public network'], + 'type' => 'string', + 'enum' => ['Public'], + 'required' => false, + 'example' => 'Public', + 'title' => '', + ], + ], + [ + 'name' => 'ComputingGroupId', + 'in' => 'query', + 'schema' => ['description' => 'The computing group ID.', 'type' => 'string', 'required' => false, 'example' => 'cc-2ze34****-clickhouse', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'The response parameters.', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'xxx-xxx-xxx'], + 'Data' => [ + 'description' => 'The returned data.', + 'type' => 'object', + 'properties' => [ + 'DBInstanceID' => ['description' => 'The cluster ID.', 'type' => 'integer', 'format' => 'int32', 'example' => 'cc-xxxxx', 'title' => ''], + 'ConnectionString' => ['description' => 'The connection string.', 'type' => 'string', 'example' => 'cc-2ze34****-clickhouse..clickhouseserver.pre.rds.aliyuncs.com', 'title' => ''], + 'DBInstanceName' => ['description' => 'The cluster name.', 'type' => 'string', 'example' => 'cc-xxxxx', 'title' => ''], + 'DisabledPorts' => ['description' => 'The disabled database ports.', 'type' => 'string', 'example' => '9001,8123', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\",\\n \\"Data\\": {\\n \\"DBInstanceID\\": 0,\\n \\"ConnectionString\\": \\"cc-2ze34****-clickhouse..clickhouseserver.pre.rds.aliyuncs.com\\",\\n \\"DBInstanceName\\": \\"cc-xxxxx\\",\\n \\"DisabledPorts\\": \\"9001,8123\\"\\n }\\n}","type":"json"}]', + 'title' => 'ModifyDBInstanceConnectionString', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBInstanceConnectionString', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + ], ], - [ - 'regionId' => 'ap-southeast-6', - 'endpoint' => 'clickhouse.ap-southeast-6.aliyuncs.com', + 'ModifyLangfuseOrgMembership' => [ + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], + ], + [ + 'name' => 'OrganizationId', + 'in' => 'query', + 'schema' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], + ], + [ + 'name' => 'Email', + 'in' => 'query', + 'schema' => ['description' => 'The email address of the user.', 'type' => 'string', 'required' => true, 'example' => 'john@company.com', 'title' => ''], + ], + [ + 'name' => 'Role', + 'in' => 'query', + 'schema' => ['description' => 'The role of the user in the organization.', 'type' => 'string', 'required' => true, 'example' => 'ADMIN', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => '', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], + 'Data' => [ + 'description' => 'The response data.', + 'type' => 'object', + 'properties' => [ + 'Role' => ['description' => 'The role of the user in the organization.', 'type' => 'string', 'example' => 'ADMIN', 'title' => ''], + 'Email' => ['description' => 'The email address of the user.', 'type' => 'string', 'example' => 'john@company.com', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', + ], + ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'Modify user permissions in a langfuse organization', + 'summary' => 'Modifies the permissions of a user in a Langfuse organization.', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"Data\\": {\\n \\"Role\\": \\"ADMIN\\",\\n \\"Email\\": \\"john@company.com\\"\\n }\\n}","type":"json"}]', ], - [ - 'regionId' => 'eu-central-1', - 'endpoint' => 'clickhouse.eu-central-1.aliyuncs.com', + 'ModifyLangfuseProjectMembership' => [ + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185379', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], + ], + [ + 'name' => 'OrganizationId', + 'in' => 'query', + 'schema' => ['description' => 'The Langfuse organization ID.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], + ], + [ + 'name' => 'ProjectId', + 'in' => 'query', + 'schema' => ['description' => 'The Langfuse project ID.', 'type' => 'string', 'required' => true, 'example' => 'cmrbhzx930005jw2q****', 'title' => ''], + ], + [ + 'name' => 'Email', + 'in' => 'query', + 'schema' => ['description' => 'The email address of the user.', 'type' => 'string', 'required' => true, 'example' => 'john@company.com', 'title' => ''], + ], + [ + 'name' => 'Role', + 'in' => 'query', + 'schema' => ['description' => 'The role of the user in the project.', 'type' => 'string', 'required' => true, 'example' => 'VIEWER', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => '', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => '05321590-BB65-4720-8CB6-8218E041CDD0'], + 'Data' => [ + 'description' => 'The returned data.', + 'type' => 'object', + 'properties' => [ + 'Role' => ['description' => 'The role of the user in the project.', 'type' => 'string', 'example' => 'VIEWER', 'title' => ''], + 'Email' => ['description' => 'The email address of the user.', 'type' => 'string', 'example' => 'john@company.com', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', + ], + ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'No valid instance found'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'Modify user permissions in a langfuse project', + 'summary' => 'Modifies the permissions of a user in a Langfuse project.', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"05321590-BB65-4720-8CB6-8218E041CDD0\\",\\n \\"Data\\": {\\n \\"Role\\": \\"VIEWER\\",\\n \\"Email\\": \\"john@company.com\\"\\n }\\n}","type":"json"}]', ], - [ - 'regionId' => 'eu-west-1', - 'endpoint' => 'clickhouse.eu-west-1.aliyuncs.com', + 'ModifySecurityIPList' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185639', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.'."\n", 'type' => 'string', 'required' => false, 'example' => 'cn-beijing', 'title' => ''], + ], + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.'."\n", 'type' => 'string', 'required' => true, 'example' => 'cc-xxxxx', 'title' => ''], + ], + [ + 'name' => 'GroupName', + 'in' => 'query', + 'schema' => ['description' => 'The name of the whitelist whose settings you want to modify.'."\n", 'type' => 'string', 'required' => false, 'example' => 'test', 'title' => ''], + ], + [ + 'name' => 'SecurityIPList', + 'in' => 'query', + 'schema' => ['description' => 'The IP addresses and CIDR blocks in the whitelist.'."\n", 'type' => 'string', 'required' => false, 'example' => '192.168.0.0/24,172.16.0.0/24', 'title' => ''], + ], + [ + 'name' => 'ModifyMode', + 'in' => 'query', + 'schema' => ['description' => 'The modification mode.'."\n" + ."\n" + .'* 0: overwrites the original IP addresses and CIDR blocks in the whitelist.'."\n" + .'* 1: adds the IP addresses and CIDR blocks to the whitelist.'."\n" + .'* 2: removes the IP addresses and CIDR blocks from the whitelist.'."\n" + ."\n" + .'> We recommend that you set the value to 0.'."\n", 'type' => 'string', 'required' => false, 'example' => '0', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'The response parameters.'."\n", + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.'."\n", 'type' => 'string', 'example' => 'xxx-xxx-xxx'], + 'Data' => [ + 'description' => 'The returned result.'."\n", + 'type' => 'object', + 'properties' => [ + 'GroupName' => ['description' => 'The name of the whitelist.'."\n", 'type' => 'string', 'example' => 'test', 'title' => ''], + 'SecurityIPType' => ['description' => 'The IP address type.'."\n", 'type' => 'string', 'example' => 'ipv4', 'title' => ''], + 'GroupTag' => ['description' => 'The tag of the whitelist.'."\n", 'type' => 'string', 'example' => 'test', 'title' => ''], + 'TaskId' => ['description' => 'The task ID.'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '1', 'title' => ''], + 'SecurityIPList' => ['description' => 'The IP addresses and CIDR blocks in the whitelist.'."\n", 'type' => 'string', 'example' => '192.168.0.0/24,172.16.0.0/24', 'title' => ''], + 'DBInstanceID' => ['description' => 'The cluster ID.'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => 'cc-xxxx', 'title' => ''], + 'WhitelistNetType' => ['description' => 'The network type of the whitelist.'."\n", 'type' => 'string', 'example' => 'mix', 'title' => ''], + 'DBInstanceName' => ['description' => 'The cluster name.'."\n", 'type' => 'string', 'example' => 'cc-xxxx', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', + ], + ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records. ', 'description' => ''], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'ModifySecurityIPList', + 'summary' => 'Modifies the whitelist settings of an ApsaraDB for ClickHouse cluster.', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifySecurityIPList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxx-xxx-xxx\\",\\n \\"Data\\": {\\n \\"GroupName\\": \\"test\\",\\n \\"SecurityIPType\\": \\"ipv4\\",\\n \\"GroupTag\\": \\"test\\",\\n \\"TaskId\\": 1,\\n \\"SecurityIPList\\": \\"192.168.0.0/24,172.16.0.0/24\\",\\n \\"DBInstanceID\\": 0,\\n \\"WhitelistNetType\\": \\"mix\\",\\n \\"DBInstanceName\\": \\"cc-xxxx\\"\\n }\\n}","type":"json"}]', + 'operationType' => 'readAndWrite', ], - [ - 'regionId' => 'us-west-1', - 'endpoint' => 'clickhouse.us-west-1.aliyuncs.com', + 'ResetAccountPassword' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185276', + 'abilityTreeNodes' => ['FEATUREclickhouse2H8YOY'], + ], + 'parameters' => [ + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.'."\n", 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.'."\n", 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'Account', + 'in' => 'query', + 'schema' => ['description' => 'The name of the database account.'."\n", 'type' => 'string', 'required' => true, 'example' => 'test1', 'title' => ''], + ], + [ + 'name' => 'Password', + 'in' => 'query', + 'schema' => ['description' => 'The password of the database account. The password must meet the following requirements:'."\n" + ."\n" + .'- The password must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.'."\n" + .'- The following special characters are supported: ! @ # $ % ^ & * ( ) _ + - ='."\n" + .'- The password must be 8 to 32 characters in length.', 'type' => 'string', 'required' => true, 'example' => '123456Aa', 'title' => ''], + ], + [ + 'name' => 'Product', + 'in' => 'query', + 'schema' => ['description' => 'The service name.'."\n", 'type' => 'string', 'required' => false, 'example' => 'clickhouse', 'default' => 'clickhouse', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.'."\n", 'type' => 'string', 'example' => '5A6A077A-577C-536E-AC13-8E715D7A34C8'], + 'Data' => [ + 'description' => 'The result returned.'."\n", + 'type' => 'object', + 'properties' => [ + 'DBInstanceId' => ['description' => 'The cluster ID.'."\n", 'type' => 'string', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'Account' => ['description' => 'The name of the account.'."\n", 'type' => 'string', 'example' => 'test1', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', + ], + ], + ], + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'InvalidDBInstanceState.NotSupport', 'errorMessage' => 'The specified instance state does\'t support this operation.', 'description' => ''], + ], + [ + ['errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The DBInstanceId provided does not exist in our records.', 'description' => 'The passed instance ID does not exist.'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'ResetAccountPassword', + 'summary' => 'Resets the password of a database account for an ApsaraDB for ClickHouse Enterprise Edition cluster.', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ResetAccountPassword', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"5A6A077A-577C-536E-AC13-8E715D7A34C8\\",\\n \\"Data\\": {\\n \\"DBInstanceId\\": \\"cc-bp100p4q1g9z3****\\",\\n \\"Account\\": \\"test1\\"\\n }\\n}","type":"json"}]', + ], + 'ResetLangfuseUserPassword' => [ + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'paid', + 'abilityTreeCode' => '182031', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The Langfuse instance ID.', 'type' => 'string', 'required' => true, 'example' => 'lfs-****', 'title' => ''], + ], + [ + 'name' => 'Email', + 'in' => 'query', + 'schema' => ['description' => 'The email address of the user.', 'type' => 'string', 'required' => true, 'example' => 'john@company.com', 'title' => ''], + ], + [ + 'name' => 'NewPassword', + 'in' => 'query', + 'schema' => ['description' => 'The new user password. The password must meet the following rules:'."\n" + ."\n" + .'The password must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.'."\n" + ."\n" + .'The supported special characters are !@#$%^&*()_+-=.'."\n" + ."\n" + .'The password must be 8 to 32 characters in length.', 'type' => 'string', 'required' => true, 'example' => '2F9e9@******', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => '', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => '', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F75'], + 'Data' => [ + 'title' => '', + 'description' => 'The response result.', + 'type' => 'object', + 'properties' => [ + 'Email' => ['description' => 'The email address of the user.', 'type' => 'string', 'example' => 'john@company.com', 'title' => ''], + ], + 'example' => '', + ], + ], + 'example' => '', + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', 'description' => ''], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => 'Reset langfuse user password', + 'summary' => 'Resets the password of a Langfuse user.', + 'changeSet' => [], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F75\\",\\n \\"Data\\": {\\n \\"Email\\": \\"john@company.com\\"\\n }\\n}","type":"json"}]', ], - [ - 'regionId' => 'us-east-1', - 'endpoint' => 'clickhouse.us-east-1.aliyuncs.com', + 'RestartDBInstance' => [ + 'summary' => 'Restarts an ApsaraDB for ClickHouse Enterprise Edition cluster.', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'abilityTreeCode' => '192305', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'The response parameters.', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC'], + 'Data' => [ + 'description' => 'The data returned.', + 'type' => 'object', + 'properties' => [ + 'TaskId' => ['description' => 'The task ID.', 'type' => 'integer', 'format' => 'int64', 'example' => '100001080', 'title' => ''], + 'DBInstanceID' => ['description' => 'The cluster ID.', 'type' => 'integer', 'format' => 'int64', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'DBInstanceName' => ['description' => 'The cluster name.', 'type' => 'string', 'example' => 'Enterprise edition cluster test', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC\\",\\n \\"Data\\": {\\n \\"TaskId\\": 100001080,\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"Enterprise edition cluster test\\"\\n }\\n}","type":"json"}]', + 'title' => 'RestartDBInstance', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:RestartDBInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + ], + 'translator' => 'manual', ], - [ - 'regionId' => 'me-central-1', - 'endpoint' => 'clickhouse.me-central-1.aliyuncs.com', + 'StartDBInstance' => [ + 'summary' => 'Starts an ApsaraDB for ClickHouse Enterprise Edition cluster.', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'abilityTreeCode' => '189351', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'The response parameters.', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => 'F5178C10-1407-4987-9133-DE4DC9119F76'], + 'Data' => [ + 'description' => 'The data returned.', + 'type' => 'object', + 'properties' => [ + 'TaskId' => ['description' => 'The task ID.', 'type' => 'integer', 'format' => 'int64', 'example' => '100000837', 'title' => ''], + 'DBInstanceID' => ['description' => 'The cluster ID.', 'type' => 'integer', 'format' => 'int64', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'DBInstanceName' => ['description' => 'The cluster name.', 'type' => 'string', 'example' => 'Enterprise edition cluster test', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F5178C10-1407-4987-9133-DE4DC9119F76\\",\\n \\"Data\\": {\\n \\"TaskId\\": 100000837,\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"Enterprise edition cluster test\\"\\n }\\n}","type":"json"}]', + 'title' => 'StartDBInstance', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:StartDBInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + ], + 'translator' => 'manual', ], - [ - 'regionId' => 'me-east-1', - 'endpoint' => 'clickhouse.aliyuncs.com', + 'StopDBInstance' => [ + 'summary' => 'Stops an ApsaraDB for ClickHouse Enterprise Edition cluster.', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'abilityTreeCode' => '189348', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['description' => 'The cluster ID.', 'type' => 'string', 'required' => true, 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'The response parameters.', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], + 'Data' => [ + 'description' => 'The data returned.', + 'type' => 'object', + 'properties' => [ + 'TaskId' => ['description' => 'The task ID.', 'type' => 'integer', 'format' => 'int64', 'example' => '100000785', 'title' => ''], + 'DBInstanceID' => ['description' => 'The cluster ID.', 'type' => 'integer', 'format' => 'int64', 'example' => 'cc-bp100p4q1g9z3****', 'title' => ''], + 'DBInstanceName' => ['description' => 'The cluster name.', 'type' => 'string', 'example' => 'Enterprise edition cluster test', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\",\\n \\"Data\\": {\\n \\"TaskId\\": 100000785,\\n \\"DBInstanceID\\": 0,\\n \\"DBInstanceName\\": \\"Enterprise edition cluster test\\"\\n }\\n}","type":"json"}]', + 'title' => 'StopDBInstance', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:StopDBInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + ], + 'translator' => 'manual', ], - [ - 'regionId' => 'cn-north-2-gov-1', - 'endpoint' => 'clickhouse.aliyuncs.com', + 'UpdateWhitelistTemplate' => [ + 'summary' => 'Updates a whitelist template.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '185639', + 'abilityTreeNodes' => ['FEATUREclickhouseCVENTL'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', 'title' => ''], + ], + [ + 'name' => 'TemplateId', + 'in' => 'query', + 'schema' => ['description' => 'The whitelist template ID.', 'type' => 'string', 'required' => true, 'example' => '98a6d3db05984dca', 'title' => ''], + ], + [ + 'name' => 'TemplateName', + 'in' => 'query', + 'schema' => ['description' => 'The whitelist template name.', 'type' => 'string', 'required' => true, 'example' => '98a6d3db05984dca', 'title' => ''], + ], + [ + 'name' => 'SecurityIPList', + 'in' => 'query', + 'schema' => ['description' => 'The IP address whitelist. You can add up to 100 IP addresses, separated by commas.', 'type' => 'string', 'required' => true, 'example' => '192.168.1.1,10.0.0.1', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => 'The request ID.', 'type' => 'string', 'example' => '1234567890', 'title' => ''], + 'Data' => [ + 'title' => '', + 'type' => 'object', + 'properties' => [ + 'Templates' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'TemplateId' => ['description' => 'The whitelist template ID.', 'type' => 'string', 'example' => 'g-asdfwem', 'title' => ''], + 'SecurityIPList' => ['description' => 'The IP address whitelist.', 'type' => 'string', 'example' => '192.168.1.1,10.0.0.1', 'title' => ''], + 'DbInstances' => [ + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DbInstanceName' => ['description' => 'The instance ID.', 'type' => 'string', 'example' => 'asdfwef', 'title' => ''], + ], + 'description' => 'The details of an instance.', + 'title' => '', + 'example' => '', + ], + 'description' => 'The list of associated instances.', + 'title' => '', + 'example' => '', + ], + ], + 'description' => 'The details of a template.', + 'title' => '', + 'example' => '', + ], + 'description' => 'The list of whitelist templates.', + 'title' => '', + 'example' => '', + ], + ], + 'description' => 'The details of the whitelist template.', + 'example' => '', + ], + ], + 'description' => 'The returned data.', + 'title' => '', + 'example' => '', + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidSecurityIPs.Malformed', 'errorMessage' => 'Specified IPList is not valid.', 'description' => ''], + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Invalid parameter.', 'description' => ''], + ['errorCode' => 'InvalidWhitelistTemplateId', 'errorMessage' => 'Invalid Whitelist templateId.', 'description' => ''], + ['errorCode' => 'InvalidSecurityIPList.QuotaExceeded', 'errorMessage' => 'Specified security IP list is not valid: Exceeding the allowed amount of IP address in the list.', 'description' => ''], + ['errorCode' => 'InvalidWhitelistTemplate.IllegalPermission', 'errorMessage' => 'No permission to operate the whitelist template.', 'description' => ''], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'UpdateWhitelistTemplate', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:UpdateWhitelistTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1234567890\\",\\n \\"Data\\": {\\n \\"Templates\\": [\\n {\\n \\"TemplateId\\": \\"g-asdfwem\\",\\n \\"SecurityIPList\\": \\"192.168.1.1,10.0.0.1\\",\\n \\"DbInstances\\": [\\n {\\n \\"DbInstanceName\\": \\"asdfwef\\"\\n }\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', ], - [ - 'regionId' => 'cn-beijing-finance-1', - 'endpoint' => 'clickhouse.aliyuncs.com', + 'UpgradeMinorVersion' => [ + 'summary' => 'Updates the minor engine version of an ApsaraDB for ClickHouse cluster that runs Enterprise Edition.', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'abilityTreeCode' => '196979', + 'abilityTreeNodes' => ['FEATUREclickhouseN0HBPQ'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'DBInstanceId', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The cluster ID.'."\n", 'type' => 'string', 'required' => true, 'example' => 'cc-bp1jyis8p15we****'], + ], + [ + 'name' => 'SwitchTimeMode', + 'in' => 'query', + 'schema' => [ + 'title' => '', + 'description' => 'Specifies whether to update the minor engine version of the cluster immediately. Valid values:'."\n" + ."\n" + .'* **Immediate**: The system immediately performs the update.'."\n" + .'* **MaintainTime**: The system performs the update during the specified maintenance window.'."\n" + .'* **SpecifyTime**: The system performs the update at a specified time.'."\n", + 'type' => 'string', + 'required' => false, + 'example' => 'Immediate', + 'default' => 'Immediate', + 'enum' => ['Immediate', 'MaintainTime', 'SpecifyTime'], + ], + ], + [ + 'name' => 'SwitchTime', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The update time. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.'."\n" + ."\n" + .'> If you set SwitchTimeMode to SpecifyTime, you must configure this parameter to specify the update time.'."\n", 'type' => 'string', 'required' => false, 'example' => '2023-01-09T05:00:00Z'], + ], + [ + 'name' => 'TargetMinorVersion', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => 'The minor engine version to which you want to update.'."\n" + ."\n" + .'> By default, TargetMinorVersion is not set and the minor engine version of the cluster is updated to the latest version.'."\n", 'type' => 'string', 'required' => false, 'example' => '23.8.1.41495_6'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'The region ID.'."\n", 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', 'title' => ''], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response'."\n", + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => 'The request ID.'."\n", 'type' => 'string', 'example' => 'FE242962-6DA3-5FC8-9691-37B62A3210F7'], + 'Data' => [ + 'description' => 'The returned result.'."\n", + 'type' => 'object', + 'properties' => [ + 'DBInstanceName' => ['description' => 'The instance ID.'."\n", 'type' => 'string', 'example' => 'cc-uf6x229yeq166****', 'title' => ''], + ], + 'title' => '', + 'example' => '', + ], + ], + 'example' => '', + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => 'UpgradeMinorVersion', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:UpgradeMinorVersion', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FE242962-6DA3-5FC8-9691-37B62A3210F7\\",\\n \\"Data\\": {\\n \\"DBInstanceName\\": \\"cc-uf6x229yeq166****\\"\\n }\\n}","type":"json"}]', ], - [ - 'regionId' => 'cn-shenzhen-finance-1', - 'endpoint' => 'clickhouse.aliyuncs.com', + ], + 'endpoints' => [ + ['regionId' => 'cn-huhehaote', 'regionName' => 'China (Hohhot)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-huhehaote.aliyuncs.com', 'endpoint' => 'clickhouse.cn-huhehaote.aliyuncs.com', 'vpc' => ''], + ['regionId' => 'ap-southeast-3', 'regionName' => 'Malaysia (Kuala Lumpur)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => ''], + ['regionId' => 'cn-wulanchabu', 'regionName' => 'China (Ulanqab)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-wulanchabu.aliyuncs.com'], + ['regionId' => 'cn-beijing', 'regionName' => 'China (Beijing)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-beijing.aliyuncs.com'], + ['regionId' => 'cn-qingdao', 'regionName' => 'China (Qingdao)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-qingdao.aliyuncs.com', 'endpoint' => 'clickhouse.cn-qingdao.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-qingdao.aliyuncs.com'], + ['regionId' => 'cn-shanghai', 'regionName' => 'China (Shanghai)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-shanghai.aliyuncs.com'], + ['regionId' => 'cn-hongkong', 'regionName' => 'China (Hong Kong)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-hongkong.aliyuncs.com', 'endpoint' => 'clickhouse.cn-hongkong.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-hongkong.aliyuncs.com'], + ['regionId' => 'cn-zhangjiakou', 'regionName' => 'China (Zhangjiakou)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-zhangjiakou.aliyuncs.com', 'endpoint' => 'clickhouse.cn-zhangjiakou.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-zhangjiakou.aliyuncs.com'], + ['regionId' => 'cn-shenzhen', 'regionName' => 'China (Shenzhen)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-shenzhen.aliyuncs.com', 'endpoint' => 'clickhouse.cn-shenzhen.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-shenzhen.aliyuncs.com'], + ['regionId' => 'ap-northeast-1', 'regionName' => 'Japan (Tokyo)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.ap-northeast-1.aliyuncs.com', 'endpoint' => 'clickhouse.ap-northeast-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.ap-northeast-1.aliyuncs.com'], + ['regionId' => 'cn-chengdu', 'regionName' => 'China (Chengdu)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-chengdu.aliyuncs.com', 'endpoint' => 'clickhouse.cn-chengdu.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-chengdu.aliyuncs.com'], + ['regionId' => 'cn-guangzhou', 'regionName' => 'China (Guangzhou)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.cn-guangzhou.aliyuncs.com', 'endpoint' => 'clickhouse.cn-guangzhou.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-guangzhou.aliyuncs.com'], + ['regionId' => 'ap-southeast-1', 'regionName' => 'Singapore', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.ap-southeast-1.aliyuncs.com', 'endpoint' => 'clickhouse.ap-southeast-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.ap-southeast-1.aliyuncs.com'], + ['regionId' => 'ap-southeast-5', 'regionName' => 'Indonesia (Jakarta)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.ap-southeast-5.aliyuncs.com', 'endpoint' => 'clickhouse.ap-southeast-5.aliyuncs.com', 'vpc' => 'clickhouse-vpc.ap-southeast-5.aliyuncs.com'], + ['regionId' => 'ap-southeast-6', 'regionName' => 'Philippines (Manila)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.ap-southeast-6.aliyuncs.com', 'endpoint' => 'clickhouse.ap-southeast-6.aliyuncs.com', 'vpc' => 'clickhouse-vpc.ap-southeast-6.aliyuncs.com'], + ['regionId' => 'cn-hangzhou', 'regionName' => 'China (Hangzhou)', 'areaId' => 'asiaPacific', 'areaName' => 'Asia Pacific', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-hangzhou.aliyuncs.com'], + ['regionId' => 'us-east-1', 'regionName' => 'US (Virginia)', 'areaId' => 'europeAmerica', 'areaName' => 'Europe & Americas', 'public' => 'clickhouse.us-east-1.aliyuncs.com', 'endpoint' => 'clickhouse.us-east-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.us-east-1.aliyuncs.com'], + ['regionId' => 'eu-west-1', 'regionName' => 'UK (London)', 'areaId' => 'europeAmerica', 'areaName' => 'Europe & Americas', 'public' => 'clickhouse.eu-west-1.aliyuncs.com', 'endpoint' => 'clickhouse.eu-west-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.eu-west-1.aliyuncs.com'], + ['regionId' => 'us-west-1', 'regionName' => 'US (Silicon Valley)', 'areaId' => 'europeAmerica', 'areaName' => 'Europe & Americas', 'public' => 'clickhouse.us-west-1.aliyuncs.com', 'endpoint' => 'clickhouse.us-west-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.us-west-1.aliyuncs.com'], + ['regionId' => 'eu-central-1', 'regionName' => 'Germany (Frankfurt)', 'areaId' => 'europeAmerica', 'areaName' => 'Europe & Americas', 'public' => 'clickhouse.eu-central-1.aliyuncs.com', 'endpoint' => 'clickhouse.eu-central-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.eu-central-1.aliyuncs.com'], + ['regionId' => 'me-central-1', 'regionName' => 'Saudi Arabia (Riyadh)', 'areaId' => 'middleEast', 'areaName' => 'Middle East', 'public' => 'clickhouse.me-central-1.aliyuncs.com', 'endpoint' => 'clickhouse.me-central-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.me-central-1.aliyuncs.com'], + ['regionId' => 'me-east-1', 'regionName' => 'UAE (Dubai)', 'areaId' => 'middleEast', 'areaName' => 'Middle East', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => ''], + ['regionId' => 'cn-hangzhou-finance', 'regionName' => 'China East 1 Finance', 'areaId' => 'industryCloud', 'areaName' => 'Industry Cloud', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-hangzhou-finance.aliyuncs.com'], + ['regionId' => 'cn-shenzhen-finance-1', 'regionName' => 'China South 1 Finance', 'areaId' => 'industryCloud', 'areaName' => 'Industry Cloud', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-shenzhen-finance-1.aliyuncs.com'], + ['regionId' => 'cn-shanghai-finance-1', 'regionName' => 'China East 2 Finance', 'areaId' => 'industryCloud', 'areaName' => 'Industry Cloud', 'public' => 'clickhouse.cn-shanghai-finance-1.aliyuncs.com', 'endpoint' => 'clickhouse.cn-shanghai-finance-1.aliyuncs.com', 'vpc' => 'clickhouse-vpc.cn-shanghai-finance-1.aliyuncs.com'], + ['regionId' => 'cn-beijing-finance-1', 'regionName' => 'China North 2 Finance (Preview)', 'areaId' => 'industryCloud', 'areaName' => 'Industry Cloud', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => ''], + ['regionId' => 'cn-north-2-gov-1', 'regionName' => 'Beijing Government Cloud', 'areaId' => 'industryCloud', 'areaName' => 'Industry Cloud', 'public' => 'clickhouse.aliyuncs.com', 'endpoint' => 'clickhouse.aliyuncs.com', 'vpc' => ''], + ], + 'errorCodes' => [ + ['code' => 'Abs.InvalidAccount.NotFound', 'message' => 'Account is not found.', 'http_code' => 404, 'description' => 'No corresponding account found.'], + ['code' => 'ACTION_UNAUTHORIZED', 'message' => 'The account balance is insufficient, and the opening of the public network needs to rely on load balancing service, which requires that the account balance must be greater than 100 yuan.', 'http_code' => 403, 'description' => 'The account balance is insufficient, and the opening of the public network needs to rely on load balancing service, which requires that the account balance must be greater than 100 yuan.'], + ['code' => 'COMMODITY.INVALID_COMPONENT', 'message' => 'Invalid component for commodity.', 'http_code' => 500, 'description' => 'The order configuration parameters do not meet the verification conditions, please re-match the product.'], + ['code' => 'DescribeLorneLogException', 'message' => 'Cannot find taskDetail in Lorne.', 'http_code' => 500, 'description' => 'The task details of the corresponding SLS were not found.'], + ['code' => 'Forbidden', 'message' => 'User not authorized to operate on the specified resource.', 'http_code' => 403, 'description' => 'The account is not granted permission to manipulate the resource'], + ['code' => 'InsufficientResourceCapacity', 'message' => 'The resource is out of usage.', 'http_code' => 403, 'description' => 'The resource is out of usage.'], + ['code' => 'InternalError', 'message' => 'An error occurred while processing your request.', 'http_code' => 500, 'description' => 'An error occurred while processing your request.'], + ['code' => 'InternalFailure', 'message' => 'The request processing has failed due to some unknown error, exception or failure.', 'http_code' => 500, 'description' => 'An internal system error occurred with this request.'], + ['code' => 'InvalidAccountName.NotFound', 'message' => 'Specified account name does not exist.', 'http_code' => 404, 'description' => 'The specified account name does not exist.'], + ['code' => 'InvalidBackupRetentionPeriod.Malformed', 'message' => 'The specified parameter "BackupRetentionPeriod" is not valid.', 'http_code' => 400, 'description' => 'The request parameter BackupRetentionPeriod is invalid.'], + ['code' => 'InvalidDBCluster.NotFound', 'message' => 'The DBClusterId provided does not exist in our records.', 'http_code' => 404, 'description' => 'The DBClusterId provided does not exist in our records.'], + ['code' => 'InvalidDBClusterId.NotFound', 'message' => 'The DBClusterId provided does not exist in our records.', 'http_code' => 404, 'description' => 'The passed instance ID does not exist.'], + ['code' => 'InvalidDBInstance.NotFound', 'message' => 'The DBClusterId provided does not exist in our records.', 'http_code' => 404, 'description' => 'The passed instance ID does not exist.'], + ['code' => 'InvalidDBInstanceId.NotFound', 'message' => 'The DBInstanceId provided does not exist in our records.', 'http_code' => 404, 'description' => 'No valid instance found'], + ['code' => 'InvalidPageNumber.Malformed', 'message' => 'The specified parameter "PageNumber" is not valid.', 'http_code' => 400, 'description' => 'The specified parameter PageNumber is invalid.'], + ['code' => 'InvalidPageSize.Malformed', 'message' => 'The specified parameter "PageSize" is not valid.', 'http_code' => 400, 'description' => 'The specified parameter "PageSize" is not valid.'], + ['code' => 'InvalidParameter.DBClusterVersion', 'message' => 'The version is invalid. Check whether the DBClusterVersion, MinorVersion, and MajorVersion parameters are correct.', 'http_code' => 400, 'description' => 'The version is invalid. Check whether the DBClusterVersion, MinorVersion, and MajorVersion parameters are correct.'], + ['code' => 'InvalidParameter.DBNodeStorage', 'message' => 'The specified parameter "DBNodeStorage" is not valid.', 'http_code' => 400, 'description' => 'The specified parameter "DBNodeStorage" is invalid.'], + ['code' => 'InvalidRegionId.Malformed', 'message' => 'The specified parameter "RegionId" is not valid.', 'http_code' => 400, 'description' => 'The specified parameter RegionId is invalid.'], + ['code' => 'InvalidSecurityIPs.Exceeded', 'message' => 'The specified parameter "SecurityIps" count is exceeded 200.', 'http_code' => 400, 'description' => 'The total number of security group IP addresses exceeds 200.'], + ['code' => 'InvalidVPC.NotFound', 'message' => 'VPC or VSwitch is not valid.', 'http_code' => 404, 'description' => 'The VPC ID passed in does not exist.'], + ['code' => 'InvalidVpcId.Malformed', 'message' => 'The specified parameter "VpcId" is not valid.', 'http_code' => 400, 'description' => ''], + ['code' => 'ModifyServerConfigFailed', 'message' => 'Failed to modify server config.', 'http_code' => 500, 'description' => 'Failed to modify instance configuration.'], + ['code' => 'OperationDenied.CKNotConnected', 'message' => 'Connect to ClickHouse Cluster Failed.', 'http_code' => 403, 'description' => 'Failed to connect to ClickHouse. Check the ClickHouse status, whitelist, and connectivity.'], + ['code' => 'OperationDenied.VirtualWarehouseShardsAlign', 'message' => 'The operation is not permitted due to virtualWarehouse shards align.', 'http_code' => 403, 'description' => 'The operation is not permitted due to virtualWarehouse shards align.'], + ['code' => 'PRICE.PRICING_PLAN_RESULT_NOT_FOUND', 'message' => 'Cannot find pricing plan for the commodity.', 'http_code' => 500, 'description' => 'Pricing plan not found.'], + ['code' => 'ServiceUnavailable', 'message' => 'An error occurred while processing your request.', 'http_code' => 503, 'description' => 'An error occurred while processing your request.'], + ['code' => 'UNAVAILABLE', 'message' => 'Service Unavailable.', 'http_code' => 502, 'description' => 'Service not available.'], + ['code' => 'UNKNOWN', 'message' => 'Unknown error.', 'http_code' => 500, 'description' => 'Unknown error.'], + ['code' => 'UserNotInBuyWhiteList', 'message' => 'ClickHouse is at the canary release stage. Please apply for use by submitting a ticket.', 'http_code' => 500, 'description' => 'ClickHouse is at the canary release stage. Please apply for use by submitting a ticket.'], + ['code' => 'InvalidSpecification', 'message' => 'Specification parameter is not valid.', 'http_code' => 400, 'description' => 'The specification parameter is invalid.'], + ['code' => 'InvalidDBInstanceStatus', 'message' => 'The specified instance state does\'t support this operation.', 'http_code' => 400, 'description' => 'The instance state does not allow the current operation.'], + ['code' => 'OperationDenied.OrderProcessing', 'message' => 'The operation is not permitted due to there is an order in processing of cluster.', 'http_code' => 400, 'description' => 'There is an outstanding order, please try again later.'], + ['code' => 'OperationDenied.NothingChanged', 'message' => 'The instance operation changes the specification, but the incoming specification is the same as the current specification without any changes.', 'http_code' => 400, 'description' => 'The instance operation changes the specification, but the incoming specification is the same as the current specification without any changes.'], + ['code' => 'StorageTypeDoNotSupportBackup', 'message' => 'Current StorageType Does Not Support Backup.', 'http_code' => 400, 'description' => 'The current storage type does not support backup'], + ], + 'changeSet' => [], + 'ram' => [ + 'productCode' => 'ClickHouse', + 'productName' => 'ApsaraDB for ClickHouse', + 'ramCodes' => ['clickhouse'], + 'ramLevel' => 'RESOURCE', + 'ramConditions' => [ + [ + 'name' => 'clickhouse:EncryptionType', + 'schema' => ['type' => 'Array', 'description' => '加密类型'], + ], ], - [ - 'regionId' => 'cn-shanghai-finance-1', - 'endpoint' => 'clickhouse.cn-shanghai-finance-1.aliyuncs.com', + 'ramActions' => [ + [ + 'apiName' => 'DescribeDBInstanceAttribute', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBInstanceAttribute', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeDBInstanceConfigChangeLog', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBInstanceConfigChangeLog', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'StopDBInstance', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:StopDBInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteWhitelistTemplate', + 'description' => '', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteWhitelistTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ModifyDBInstanceConnectionString', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBInstanceConnectionString', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeDBInstanceDataSources', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBInstanceDataSources', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'CreateDB', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateDB', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'ModifySecurityIPList', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifySecurityIPList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'ModifyAccountAuthority', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyAccountAuthority', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeAccountAuthority', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAccountAuthority', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'ChangeResourceGroup', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ChangeResourceGroup', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'UpgradeMinorVersion', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:UpgradeMinorVersion', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'ListInstanceLinkedWhitelistTemplates', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:ListInstanceLinkedWhitelistTemplates', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ListClickHouseDBTimezones', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:ListClickHouseDBTimezones', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeSlowLogTrend', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSlowLogTrend', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'ModifyBackupPolicy', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteEndpoint', + 'description' => '', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteEndpoint', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DetachWhitelistTemplateToInstance', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:DetachWhitelistTemplateToInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeAccounts', + 'description' => '', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeAccounts', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteBackupPolicy', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'ResetAccountPassword', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ResetAccountPassword', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'KillProcess', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:KillProcess', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'ModifyDBInstanceClass', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBInstanceClass', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'CreateDBInstance', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateDBInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DeleteDB', + 'description' => '', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteDB', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'ListWhitelistTemplates', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:ListWhitelistTemplates', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CreateEndpoint', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateEndpoint', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeBackups', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeBackups', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'RestartDBInstance', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:RestartDBInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeDBInstances', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBInstances', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'StartDBInstance', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:StartDBInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeSlowLogRecords', + 'description' => '', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSlowLogRecords', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'CreateBackupPolicy', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:CreateBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeEndpoints', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeEndpoints', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeRegions', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeRegions', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeBackupPolicy', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeBackupPolicy', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'CreateWhitelistTemplate', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateWhitelistTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ModifyAccountDescription', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyAccountDescription', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeProcessList', + 'description' => '', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeProcessList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeSecurityIPList', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeSecurityIPList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'GetWhitelistTemplate', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:GetWhitelistTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ModifyDBInstanceAttribute', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBInstanceAttribute', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeDBInstanceConfig', + 'description' => '', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'clickhouse:DescribeDBInstanceConfig', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'ModifyDBInstanceConfig', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'clickhouse:ModifyDBInstanceConfig', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'CreateAccount', + 'description' => '', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'clickhouse:CreateAccount', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'AttachWhitelistTemplateToInstance', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:AttachWhitelistTemplateToInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DeleteAccount', + 'description' => '', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteAccount', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteDBInstance', + 'description' => '', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'clickhouse:DeleteDBInstance', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], + ], + ], + ], + [ + 'apiName' => 'UpdateWhitelistTemplate', + 'description' => '', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'clickhouse:UpdateWhitelistTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ClickHouse', 'resourceType' => 'All Resource', 'arn' => '*'], + ], + ], + ], ], - [ - 'regionId' => 'cn-hangzhou-finance', - 'endpoint' => 'clickhouse.aliyuncs.com', + 'resourceTypes' => [ + ['validationType' => 'always', 'resourceType' => 'EnterpriseDBCluster', 'arn' => 'acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}'], ], ], ]; -- cgit v1.2.3