diff options
| author | Zhineng Li <im@zhineng.li> | 2026-07-12 17:11:17 +0800 |
|---|---|---|
| committer | Zhineng Li <im@zhineng.li> | 2026-07-12 17:11:17 +0800 |
| commit | 1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634 (patch) | |
| tree | 5f0857666365b7e40cdaa3733ebe1f3ba9e13c67 /data/zh_cn/adb/2021-12-01 | |
| parent | 7347bac4ab7e136157fc94777e6cf87ef9e08599 (diff) | |
| download | afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.tar.gz afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.zip | |
update APIs 20260712
Diffstat (limited to 'data/zh_cn/adb/2021-12-01')
| -rw-r--r-- | data/zh_cn/adb/2021-12-01/api-docs.php | 61376 |
1 files changed, 25370 insertions, 36006 deletions
diff --git a/data/zh_cn/adb/2021-12-01/api-docs.php b/data/zh_cn/adb/2021-12-01/api-docs.php index 228c1f1..2c12715 100644 --- a/data/zh_cn/adb/2021-12-01/api-docs.php +++ b/data/zh_cn/adb/2021-12-01/api-docs.php @@ -1,365 +1,117 @@ <?php return [ 'version' => '1.0', - 'info' => [ - 'style' => 'RPC', - 'product' => 'adb', - 'version' => '2021-12-01', - ], + 'info' => ['style' => 'RPC', 'product' => 'adb', 'version' => '2021-12-01'], 'directories' => [ [ - 'id' => 181281, - 'title' => '地域管理', + 'children' => ['DescribeKernelVersion', 'UpgradeKernelVersion', 'DescribeDBClusterStatus', 'DescribeClusterAccessWhiteList', 'ModifyClusterAccessWhiteList', 'ModifyClickhouseEngine'], 'type' => 'directory', - 'children' => [ - 'DescribeRegions', - ], - ], - [ - 'id' => 181282, 'title' => '集群管理', - 'type' => 'directory', - 'children' => [ - 'DescribeDBClusters', - 'CreateDBCluster', - 'ModifyDBCluster', - 'DeleteDBCluster', - 'DescribeDBClusterAttribute', - 'DescribeKernelVersion', - 'UpgradeKernelVersion', - 'DescribeDBClusterStatus', - 'ModifyDBClusterDescription', - 'DescribeClusterAccessWhiteList', - 'ModifyClusterAccessWhiteList', - 'ModifyClickhouseEngine', - ], + 'id' => 333061, ], [ - 'id' => 181284, - 'title' => '资源组管理', + 'children' => ['DescribeResourceGroupSpec', 'BindDBResourceGroupWithUser', 'UnbindDBResourceGroupWithUser', 'DescribeComputeResourceUsage'], 'type' => 'directory', - 'children' => [ - 'DescribeResourceGroupSpec', - 'CreateDBResourceGroup', - 'DescribeDBResourceGroup', - 'ModifyDBResourceGroup', - 'DeleteDBResourceGroup', - 'BindDBResourceGroupWithUser', - 'UnbindDBResourceGroupWithUser', - 'DescribeComputeResourceUsage', - 'DescribeUserQuota', - ], + 'title' => '资源组管理', + 'id' => 333074, ], [ - 'id' => 181285, - 'title' => '资源弹性计划', + 'children' => ['CreateElasticPlan', 'DescribeElasticPlans', 'ModifyElasticPlan', 'EnableElasticPlan', 'DisableElasticPlan', 'DeleteElasticPlan', 'DescribeElasticPlanJobs', 'DescribeElasticPlanAttribute', 'DescribeElasticPlanSpecifications'], 'type' => 'directory', - 'children' => [ - 'CreateElasticPlan', - 'DescribeElasticPlans', - 'ModifyElasticPlan', - 'EnableElasticPlan', - 'DisableElasticPlan', - 'DeleteElasticPlan', - 'DescribeElasticPlanJobs', - 'DescribeElasticPlanAttribute', - 'DescribeElasticPlanSpecifications', - ], + 'title' => '资源弹性计划', + 'id' => 333084, ], [ - 'id' => 181295, - 'title' => 'SQL审计', + 'children' => ['DescribeAuditLogRecords', 'DescribeSparkAuditLogRecords'], 'type' => 'directory', - 'children' => [ - 'DescribeAuditLogRecords', - 'ModifyAuditLogConfig', - 'DescribeSparkAuditLogRecords', - ], + 'title' => 'SQL审计', + 'id' => 333094, ], [ - 'id' => 196276, - 'title' => '网络管理', + 'children' => ['DescribeClusterNetInfo', 'AllocateClusterPublicConnection', 'ReleaseClusterPublicConnection', 'AttachUserENI', 'DetachUserENI', 'ModifyUserEniVswitchOptions', 'ModifyDBClusterVip', 'DownloadInstanceCACertificate'], 'type' => 'directory', - 'children' => [ - 'DescribeClusterNetInfo', - 'AllocateClusterPublicConnection', - 'ReleaseClusterPublicConnection', - 'AttachUserENI', - 'DetachUserENI', - 'ModifyUserEniVswitchOptions', - 'ModifyDBClusterVip', - 'ModifyDBClusterSSL', - 'DescribeDBClusterSSL', - 'DownloadInstanceCACertificate', - ], + 'title' => '网络管理', + 'id' => 333276, ], [ - 'id' => 181296, - 'title' => '账号管理', + 'children' => ['CheckBindRamUser', 'BindAccount', 'UnbindAccount', 'ModifyAccountPrivileges', 'DescribeAccountPrivileges', 'DescribeEnabledPrivileges', 'DescribeAccountAllPrivileges', 'DescribeAccountPrivilegeObjects', 'DescribeOperatorPermission'], 'type' => 'directory', - 'children' => [ - 'DescribeAccounts', - 'CreateAccount', - 'DeleteAccount', - 'ModifyAccountDescription', - 'ResetAccountPassword', - 'CheckBindRamUser', - 'BindAccount', - 'UnbindAccount', - 'ModifyAccountPrivileges', - 'DescribeAccountPrivileges', - 'DescribeEnabledPrivileges', - 'DescribeAccountAllPrivileges', - 'DescribeAccountPrivilegeObjects', - 'DescribeOperatorPermission', - 'RevokeOperatorPermission', - 'GrantOperatorPermission', - ], + 'title' => '账号管理', + 'id' => 333098, ], [ - 'id' => 196277, - 'title' => '备份恢复', + 'children' => ['DeleteBackups'], 'type' => 'directory', - 'children' => [ - 'DescribeBackupPolicy', - 'ModifyBackupPolicy', - 'DescribeBackups', - 'CreateBackup', - 'DeleteBackups', - ], + 'title' => '备份恢复', + 'id' => 333288, ], [ - 'id' => 181298, - 'title' => '监控信息', + 'children' => ['DescribeExecutorDetection', 'DescribeWorkerDetection', 'DescribeControllerDetection', 'DescribeBadSqlDetection', 'DescribeAbnormalPatternDetection', 'DescribeInclinedNodes', 'DescribeDBClusterHealthStatus', 'DescribeClusterResourceUsage', 'DescribeClusterResourceDetail', 'DescribeStorageResourceUsage', 'DescribeJobResourceUsage', 'DescribePerformanceViews', 'CreatePerformanceView', 'ModifyPerformanceView', 'DescribePerformanceViewAttribute', 'DeletePerformanceView', 'ExistRunningSQLEngine'], 'type' => 'directory', - 'children' => [ - 'DescribeHistoryTasks', - 'DescribeHistoryTasksStat', - 'DescribeExecutorDetection', - 'DescribeWorkerDetection', - 'DescribeControllerDetection', - 'DescribeBadSqlDetection', - 'DescribeAbnormalPatternDetection', - 'DescribeInclinedNodes', - 'DescribeDBClusterHealthStatus', - 'DescribeDBClusterPerformance', - 'DescribeClusterResourceUsage', - 'DescribeClusterResourceDetail', - 'DescribeStorageResourceUsage', - 'DescribeJobResourceUsage', - 'DescribePerformanceViews', - 'CreatePerformanceView', - 'ModifyPerformanceView', - 'DescribePerformanceViewAttribute', - 'DeletePerformanceView', - 'ExistRunningSQLEngine', - ], + 'title' => '监控信息', + 'id' => 333115, ], [ - 'id' => 181300, - 'title' => 'Spark开发', - 'type' => 'directory', 'children' => [ - 'ExecuteSparkWarehouseBatchSQL', - 'CancelSparkWarehouseBatchSQL', - 'ListSparkWarehouseBatchSQL', - 'GetSparkWarehouseBatchSQL', - 'StartSparkReplSession', - 'GetSparkReplStatement', - 'ExecuteSparkReplStatement', - 'CancelSparkReplStatement', - 'GetSparkReplSession', - 'DescribeSparkAppType', - 'PreloadSparkAppMetrics', - 'GetSparkAppMetrics', - 'ListSparkLogAnalyzeTasks', - 'SubmitSparkLogAnalyzeTask', - 'KillSparkLogAnalyzeTask', - 'GetSparkLogAnalyzeTask', - 'SetSparkAppLogRootPath', - 'GetSparkConfigLogPath', - 'StartSparkSQLEngine', - 'KillSparkSQLEngine', - 'GetSparkSQLEngineState', - 'DescribeSparkCodeOutput', - 'DescribeSparkCodeLog', - 'DescribeSparkCodeWebUi', - 'ListSparkTemplateFileIds', - 'GetSparkAppWebUiAddress', - 'ListSparkAppAttempts', - 'CreateSparkTemplate', - 'DeleteSparkTemplate', - 'GetSparkTemplateFolderTree', - 'GetSparkTemplateFullTree', - 'GetSparkTemplateFileContent', - 'UpdateSparkTemplateFile', - 'DeleteSparkTemplateFile', - 'GetSparkAppAttemptLog', - 'ListSparkApps', - 'GetSparkAppInfo', - 'GetSparkAppState', - 'GetSparkAppLog', - 'SubmitSparkApp', - 'KillSparkApp', - 'CreateOssSubDirectory', + 'ExecuteSparkWarehouseBatchSQL', 'CancelSparkWarehouseBatchSQL', 'ListSparkWarehouseBatchSQL', 'GetSparkWarehouseBatchSQL', 'StartSparkReplSession', 'GetSparkReplStatement', 'ExecuteSparkReplStatement', 'CancelSparkReplStatement', 'GetSparkReplSession', 'DescribeSparkAppType', 'PreloadSparkAppMetrics', 'GetSparkAppMetrics', 'ListSparkLogAnalyzeTasks', 'SubmitSparkLogAnalyzeTask', 'KillSparkLogAnalyzeTask', 'GetSparkLogAnalyzeTask', 'SetSparkAppLogRootPath', 'GetSparkConfigLogPath', 'StartSparkSQLEngine', 'KillSparkSQLEngine', + 'GetSparkSQLEngineState', 'DescribeSparkCodeOutput', 'DescribeSparkCodeLog', 'DescribeSparkCodeWebUi', 'ListSparkTemplateFileIds', 'GetSparkAppWebUiAddress', 'ListSparkAppAttempts', 'CreateSparkTemplate', 'DeleteSparkTemplate', 'GetSparkTemplateFolderTree', 'GetSparkTemplateFullTree', 'GetSparkTemplateFileContent', 'UpdateSparkTemplateFile', 'DeleteSparkTemplateFile', 'GetSparkAppAttemptLog', 'ListSparkApps', 'GetSparkAppInfo', 'GetSparkAppState', 'GetSparkAppLog', 'SubmitSparkApp', + 'KillSparkApp', 'CreateOssSubDirectory', ], + 'type' => 'directory', + 'title' => 'Spark开发', + 'id' => 333136, ], [ - 'id' => 181301, - 'title' => '数据管理', - 'type' => 'directory', 'children' => [ - 'DescribeViewJobs', - 'DescribeTableDetail', - 'GetCreateTableSQL', - 'DescribeTableStatistics', - 'DescribeAdbMySqlTableMeta', - 'DescribeAdbMySqlIndexes', - 'DescribeMvRecommendSubTasks', - 'DescribeMVRecommendResults', - 'DescribeMvRecommendTasks', - 'CreateMaterializedViewRecommend', - 'ModifyMaterializedView', - 'ModifyMaterializedViewRecommend', - 'DeleteMaterializedViewRecommend', - 'DescribeInclinedTables', - 'DescribeAdbMySqlColumns', - 'DescribeAdbMySqlTables', - 'DescribeAdbMySqlSchemas', - 'DescribeTableAccessCount', - 'GetViewDDL', - 'GetViewObjects', - 'GetDatabaseObjects', - 'GetTable', - 'GetTableColumns', - 'GetTableDDL', - 'GetTableObjects', - 'CheckSampleDataSet', - 'DescribeSchemas', - 'DescribeAllDataSource', - 'DescribeTables', - 'DescribeColumns', - 'LoadSampleDataSet', + 'DescribeViewJobs', 'DescribeTableDetail', 'GetCreateTableSQL', 'DescribeTableStatistics', 'DescribeAdbMySqlTableMeta', 'DescribeAdbMySqlIndexes', 'DescribeMvRecommendSubTasks', 'DescribeMVRecommendResults', 'DescribeMvRecommendTasks', 'CreateMaterializedViewRecommend', 'ModifyMaterializedView', 'ModifyMaterializedViewRecommend', 'DeleteMaterializedViewRecommend', 'DescribeInclinedTables', 'DescribeAdbMySqlColumns', 'DescribeAdbMySqlTables', 'DescribeAdbMySqlSchemas', 'DescribeTableAccessCount', 'GetViewDDL', 'GetViewObjects', + 'GetDatabaseObjects', 'GetTableDDL', 'GetTableObjects', 'CheckSampleDataSet', 'DescribeSchemas', 'DescribeAllDataSource', 'DescribeTables', 'DescribeColumns', 'LoadSampleDataSet', ], + 'type' => 'directory', + 'title' => '数据管理', + 'id' => 333179, ], [ - 'id' => 181302, - 'title' => '诊断优化', + 'children' => ['GetADBSparkNecessaryRAMPermissions', 'KillProcess', 'DescribeAdviceServiceEnabled', 'DescribeSparkSQLDiagnosisList', 'DescribeSparkSQLDiagnosisAttribute', 'DescribeOversizeNonPartitionTableInfos', 'DescribeTablePartitionDiagnose', 'DescribeSparkAppDiagnosisInfo', 'EnableAdviceService', 'DescribeAppliedAdvices', 'DisableAdviceService', 'BatchApplyAdviceByIdList', 'ApplyAdviceById', 'DescribeAvailableAdvices', 'DescribeSqlPattern', 'DescribeSQLPatterns', 'DescribePatternPerformance'], 'type' => 'directory', - 'children' => [ - 'GetADBSparkNecessaryRAMPermissions', - 'KillProcess', - 'DescribeAdviceServiceEnabled', - 'DescribeSparkSQLDiagnosisList', - 'DescribeSparkSQLDiagnosisAttribute', - 'DescribeOversizeNonPartitionTableInfos', - 'DescribeTablePartitionDiagnose', - 'DescribeSparkAppDiagnosisInfo', - 'EnableAdviceService', - 'DescribeAppliedAdvices', - 'DisableAdviceService', - 'BatchApplyAdviceByIdList', - 'ApplyAdviceById', - 'DescribeAvailableAdvices', - 'DescribeDiagnosisSQLInfo', - 'DescribeDiagnosisDimensions', - 'DownloadDiagnosisRecords', - 'DescribeDiagnosisRecords', - 'DescribeDownloadRecords', - 'DescribeSqlPattern', - 'DescribeSQLPatterns', - 'DescribePatternPerformance', - ], + 'title' => '诊断优化', + 'id' => 333211, ], [ - 'id' => 190405, - 'title' => '空间分析', + 'children' => ['DescribeDBClusterSpaceSummary', 'DescribeExcessivePrimaryKeys'], 'type' => 'directory', - 'children' => [ - 'DescribeDBClusterSpaceSummary', - 'DescribeExcessivePrimaryKeys', - ], + 'title' => '空间分析', + 'id' => 333273, ], [ - 'id' => 181303, - 'title' => '运维管理', + 'children' => ['DescribeAutoRenewalAttribute', 'ModifyAutoRenewalAttribute'], 'type' => 'directory', - 'children' => [ - 'ModifyDBClusterMaintainTime', - 'ModifyDBClusterResourceGroup', - 'ListTagResources', - 'DescribeAutoRenewalAttribute', - 'ModifyAutoRenewalAttribute', - ], + 'title' => '运维管理', + 'id' => 333234, ], [ - 'id' => 186177, - 'title' => '数据管道', - 'type' => 'directory', 'children' => [ - 'DescribeApsResourceGroups', - 'DescribeApsJobDetail', - 'CreateApsWebhook', - 'DeleteApsWebhook', - 'UpdateApsWebhook', - 'ListApsWebhook', - 'CreateApsKafkaHudiJob', - 'ListApsLifecycleStrategy', - 'GetApsManagedDatabases', - 'CreateApsSlsADBJob', - 'ListApsOptimizationTasks', - 'ListApsOptimizationStrategy', - 'DescribeAPSADBInstances', - 'ModifyApsSlsADBJob', - 'DescribeApsMigrationWorkloads', - 'DescribeApsHiveWorkload', - 'CreateApsCopyWorkload', - 'DescribeApsDatasource', - 'CreateAPSJob', - 'StartApsJob', - 'SuspendApsJob', - 'ModifyApsJob', - 'DeleteApsJob', - 'CreateApsDatasoure', - 'ModifyApsDatasoure', - 'ModifyApsWorkloadName', - 'DescribeApsDatasources', - 'CreateApsHiveJob', - 'DescribeApsProgress', - 'DeleteApsDatasoure', - 'DescribeApsJobs', - 'DescribeApsActionLogs', + 'DescribeApsResourceGroups', 'DescribeApsJobDetail', 'CreateApsWebhook', 'DeleteApsWebhook', 'UpdateApsWebhook', 'ListApsWebhook', 'CreateApsKafkaHudiJob', 'CreateApsSlsADBJob', 'DescribeAPSADBInstances', 'ModifyApsSlsADBJob', 'DescribeApsMigrationWorkloads', 'DescribeApsHiveWorkload', 'CreateApsCopyWorkload', 'DescribeApsDatasource', 'CreateAPSJob', 'StartApsJob', 'SuspendApsJob', 'ModifyApsJob', 'DeleteApsJob', 'CreateApsDatasoure', + 'ModifyApsDatasoure', 'ModifyApsWorkloadName', 'DescribeApsDatasources', 'CreateApsHiveJob', 'DescribeApsProgress', 'DeleteApsDatasoure', 'DescribeApsJobs', 'DescribeApsActionLogs', ], + 'type' => 'directory', + 'title' => '数据管道', + 'id' => 333240, ], [ - 'id' => 361662, - 'title' => '湖存储', + 'children' => ['UpdateLakeStorage', 'ListLakeStorages', 'GetLakeStorage', 'CreateLakeStorage', 'DeleteLakeStorage', 'ModifyLakeCacheSize', 'DescribeLakeCacheSize'], 'type' => 'directory', - 'children' => [ - 'UpdateLakeStorage', - 'ListLakeStorages', - 'GetLakeStorage', - 'CreateLakeStorage', - 'DeleteLakeStorage', - 'ModifyLakeCacheSize', - 'DescribeLakeCacheSize', - ], + 'title' => '湖存储', + 'id' => 333307, ], [ - 'id' => 199647, - 'title' => '其他', - 'type' => 'directory', 'children' => [ - 'DescribeCompactionServiceSwitch', - 'ModifyEssdCacheConfig', - 'DescribeEssdCacheConfig', - 'ModifyCompactionServiceSwitch', - 'SubmitResultExportJob', - 'ListResultExportJobHistory', - 'DescribeSQLWebSocketDomain', - 'ConfigureResultExport', - 'DescribeResultExportConfig', - 'ModifySqlTemplatePosition', + 'DescribeCompactionServiceSwitch', 'ModifyEssdCacheConfig', 'DescribeEssdCacheConfig', 'ModifyCompactionServiceSwitch', 'SubmitResultExportJob', 'ListResultExportJobHistory', 'DescribeSQLWebSocketDomain', 'ConfigureResultExport', 'DescribeResultExportConfig', 'ModifySqlTemplatePosition', 'CheckFormationSchemaExists', 'CreateAccount', 'CreateBackup', 'CreateDBCluster', 'CreateDBResourceGroup', 'CreateFormationCrawler', 'CreateSemanticView', 'DeleteAccount', 'DeleteDBCluster', 'DeleteDBResourceGroup', + 'DeleteFormationCrawler', 'DeleteSemanticView', 'DescribeAccounts', 'DescribeBackupPolicy', 'DescribeBackups', 'DescribeDBClusterAttribute', 'DescribeDBClusterPerformance', 'DescribeDBClusterSSL', 'DescribeDBClusters', 'DescribeDBResourceGroup', 'DescribeDiagnosisDimensions', 'DescribeDiagnosisRecords', 'DescribeDiagnosisSQLInfo', 'DescribeDownloadRecords', 'DescribeHistoryTasks', 'DescribeHistoryTasksStat', 'DescribeProcessList', 'DescribeRegions', 'DescribeUserQuota', 'DownloadDiagnosisRecords', + 'GenerateSqlBySemanticSql', 'GetFormationCrawler', 'GetSemanticView', 'GetTable', 'GetTableColumns', 'GrantOperatorPermission', 'ListSemanticViewNames', 'ListTagResources', 'ModifyAccountDescription', 'ModifyAuditLogConfig', 'ModifyBackupPolicy', 'ModifyDBCluster', 'ModifyDBClusterDescription', 'ModifyDBClusterMaintainTime', 'ModifyDBClusterResourceGroup', 'ModifyDBClusterSSL', 'ModifyDBResourceGroup', 'QueryFormationInstsByTaskID', 'QueryFormationTaskByID', 'QueryFormationTasksByType', + 'RenameSemanticView', 'ReplaceSemanticView', 'ResetAccountPassword', 'RevokeOperatorPermission', 'RunMaterializedViewRecommend', 'SearchSemanticViews', 'StartFormationCrawler', 'StopFormationCrawler', 'UpdateFormationCrawler', 'UpdateFormationCrawlerScheduleState', ], + 'type' => 'directory', + 'title' => '其他', + 'id' => 333294, ], ], 'components' => [ @@ -368,23 +120,10 @@ 'title' => 'A short description of struct', 'type' => 'object', 'properties' => [ - 'DiagnosisType' => [ - 'title' => '诊断信息类型', - 'type' => 'string', - 'example' => 'APPLICATION', - ], - 'DiagnosisCode' => [ - 'title' => '诊断Code', - 'type' => 'string', - ], - 'DiagnosisCodeLabel' => [ - 'title' => '诊断原因', - 'type' => 'string', - ], - 'DiagnosisMsg' => [ - 'title' => '诊断建议', - 'type' => 'string', - ], + 'DiagnosisType' => ['title' => '诊断信息类型', 'type' => 'string', 'example' => 'APPLICATION'], + 'DiagnosisCode' => ['title' => '诊断Code', 'type' => 'string'], + 'DiagnosisCodeLabel' => ['title' => '诊断原因', 'type' => 'string'], + 'DiagnosisMsg' => ['title' => '诊断建议', 'type' => 'string'], ], ], 'ColDetailModel' => [ @@ -392,72 +131,17 @@ 'description' => '列元数据信息。', 'type' => 'object', 'properties' => [ - 'ColumnName' => [ - 'title' => '逻辑列名', - 'description' => '逻辑列名。', - 'type' => 'string', - 'example' => 'example', - ], - 'Type' => [ - 'title' => '数据类型', - 'description' => '数据类型。', - 'type' => 'string', - 'example' => 'string', - ], - 'Description' => [ - 'title' => '描述', - 'description' => '描述。', - 'type' => 'string', - 'example' => 'description', - ], - 'SchemaName' => [ - 'title' => '逻辑库名', - 'description' => '逻辑库名。', - 'type' => 'string', - 'example' => 'schemaName', - ], - 'TableName' => [ - 'title' => '逻辑表名', - 'description' => '逻辑表名。', - 'type' => 'string', - 'example' => 'tableName', - ], - 'CreateTime' => [ - 'title' => '创建时间(UTC)', - 'description' => '创建时间(UTC)。', - 'type' => 'string', - 'example' => '2023-01-05\'T\'13:17:55\'Z\'', - ], - 'UpdateTime' => [ - 'title' => '更新时间(UTC)', - 'description' => '更新时间(UTC)。', - 'type' => 'string', - 'example' => '2023-01-05\'T\'13:17:55\'Z\'', - ], - 'PartitionKey' => [ - 'title' => '是否是分区键', - 'description' => '是否是分区键。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Nullable' => [ - 'title' => '是否可以为null', - 'description' => '是否可以为null。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'PrimaryKey' => [ - 'title' => '是否是主键', - 'description' => '是否是主键。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'DistributeKey' => [ - 'title' => '是否是分布键', - 'description' => '是否是分布键。', - 'type' => 'boolean', - 'example' => 'false', - ], + 'ColumnName' => ['title' => '逻辑列名', 'description' => '逻辑列名。', 'type' => 'string', 'example' => 'example'], + 'Type' => ['title' => '数据类型', 'description' => '数据类型。', 'type' => 'string', 'example' => 'string'], + 'Description' => ['title' => '描述', 'description' => '描述。', 'type' => 'string', 'example' => 'description'], + 'SchemaName' => ['title' => '逻辑库名', 'description' => '逻辑库名。', 'type' => 'string', 'example' => 'schemaName'], + 'TableName' => ['title' => '逻辑表名', 'description' => '逻辑表名。', 'type' => 'string', 'example' => 'tableName'], + 'CreateTime' => ['title' => '创建时间(UTC)', 'description' => '创建时间(UTC)。', 'type' => 'string', 'example' => '2023-01-05\'T\'13:17:55\'Z\''], + 'UpdateTime' => ['title' => '更新时间(UTC)', 'description' => '更新时间(UTC)。', 'type' => 'string', 'example' => '2023-01-05\'T\'13:17:55\'Z\''], + 'PartitionKey' => ['title' => '是否是分区键', 'description' => '是否是分区键。', 'type' => 'boolean', 'example' => 'true'], + 'Nullable' => ['title' => '是否可以为null', 'description' => '是否可以为null。', 'type' => 'boolean', 'example' => 'false'], + 'PrimaryKey' => ['title' => '是否是主键', 'description' => '是否是主键。', 'type' => 'boolean', 'example' => 'true'], + 'DistributeKey' => ['title' => '是否是分布键', 'description' => '是否是分布键。', 'type' => 'boolean', 'example' => 'false'], ], ], 'CstoreIndexModel' => [ @@ -465,71 +149,30 @@ 'description' => '索引元信息。', 'type' => 'object', 'properties' => [ - 'DatabaseName' => [ - 'title' => 'databaseName', - 'description' => '逻辑库名。', - 'type' => 'string', - 'example' => 'exampleDatabase', - ], - 'PhysicalTableName' => [ - 'title' => 'physicalTableName', - 'description' => '物理表名。', - 'type' => 'string', - 'example' => 'physicalDatabase', - ], - 'IndexName' => [ - 'title' => 'indexName', - 'description' => '索引名。', - 'type' => 'string', - 'example' => 'indexName', - ], - 'IndexType' => [ - 'title' => 'indexType', - 'description' => '索引类型。', - 'type' => 'string', - 'example' => 'NORMAL', - ], + 'DatabaseName' => ['title' => 'databaseName', 'description' => '逻辑库名。', 'type' => 'string', 'example' => 'exampleDatabase'], + 'PhysicalTableName' => ['title' => 'physicalTableName', 'description' => '物理表名。', 'type' => 'string', 'example' => 'physicalDatabase'], + 'IndexName' => ['title' => 'indexName', 'description' => '索引名。', 'type' => 'string', 'example' => 'indexName'], + 'IndexType' => ['title' => 'indexType', 'description' => '索引类型。', 'type' => 'string', 'example' => 'NORMAL'], 'IndexColumns' => [ 'title' => 'indexColumns', 'description' => '索引列。', 'type' => 'array', - 'items' => [ - 'description' => '索引列信息。', - '$ref' => '#/components/schemas/FieldSchemaModel', - ], + 'items' => ['description' => '索引列信息。', '$ref' => '#/components/schemas/FieldSchemaModel'], ], 'ColumnOrds' => [ 'title' => 'columnOrds', 'description' => '索引列顺序。', 'type' => 'array', - 'items' => [ - 'description' => 'Clustered索引每个列的排序方式与索引列（IndexColumns）一致。', - 'type' => 'string', - 'example' => 'ASC/DESC', - ], + 'items' => ['description' => 'Clustered索引每个列的排序方式与索引列（IndexColumns）一致。', 'type' => 'string', 'example' => 'ASC/DESC'], ], 'Options' => [ 'title' => 'options', 'description' => '属性。', 'type' => 'object', - 'additionalProperties' => [ - 'description' => 'ANN/FULLTEXT的属性信息。', - 'type' => 'string', - 'example' => 'key:value', - ], - ], - 'CreateTime' => [ - 'title' => 'createTime', - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2023-01-05 13:17:55', - ], - 'UpdateTime' => [ - 'title' => 'updateTime', - 'description' => '更新时间。', - 'type' => 'string', - 'example' => '2023-01-05 13:17:55', + 'additionalProperties' => ['description' => 'ANN/FULLTEXT的属性信息。', 'type' => 'string', 'example' => 'key:value'], ], + 'CreateTime' => ['title' => 'createTime', 'description' => '创建时间。', 'type' => 'string', 'example' => '2023-01-05 13:17:55'], + 'UpdateTime' => ['title' => 'updateTime', 'description' => '更新时间。', 'type' => 'string', 'example' => '2023-01-05 13:17:55'], ], ], 'DatabaseSummaryModel' => [ @@ -537,48 +180,15 @@ 'description' => '数据库概要信息。', 'type' => 'object', 'properties' => [ - 'Owner' => [ - 'title' => '所有者', - 'description' => '所有者。', - 'type' => 'string', - 'example' => 'abc', - ], - 'SchemaName' => [ - 'title' => '逻辑库名', - 'description' => '逻辑库名。', - 'type' => 'string', - 'example' => 'testSchema', - ], - 'Description' => [ - 'title' => '描述', - 'description' => '描述。', - 'type' => 'string', - 'example' => 'description', - ], - 'CreateTime' => [ - 'title' => '创建时间', - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2023-01-05 13:17:55', - ], - 'UpdateTime' => [ - 'title' => '更新时间', - 'description' => '更新时间。', - 'type' => 'string', - 'example' => '2023-01-05 13:17:55', - ], - 'CreatedBySource' => [ - 'type' => 'string', - ], - 'CreatedByUser' => [ - 'type' => 'string', - ], - 'DbType' => [ - 'type' => 'string', - ], - 'Location' => [ - 'type' => 'string', - ], + 'Owner' => ['title' => '所有者', 'description' => '所有者。', 'type' => 'string', 'example' => 'abc'], + 'SchemaName' => ['title' => '逻辑库名', 'description' => '逻辑库名。', 'type' => 'string', 'example' => 'testSchema'], + 'Description' => ['title' => '描述', 'description' => '描述。', 'type' => 'string', 'example' => 'description'], + 'CreateTime' => ['title' => '创建时间', 'description' => '创建时间。', 'type' => 'string', 'example' => '2023-01-05 13:17:55'], + 'UpdateTime' => ['title' => '更新时间', 'description' => '更新时间。', 'type' => 'string', 'example' => '2023-01-05 13:17:55'], + 'CreatedBySource' => ['type' => 'string', 'description' => ''], + 'CreatedByUser' => ['type' => 'string', 'description' => ''], + 'DbType' => ['type' => 'string', 'description' => ''], + 'Location' => ['type' => 'string', 'description' => ''], ], ], 'Detail' => [ @@ -586,111 +196,22 @@ 'description' => 'Spark应用的详细信息。', 'type' => 'object', 'properties' => [ - 'DurationInMillis' => [ - 'title' => '执行时间(毫秒)', - 'description' => 'Spark应用执行耗时，单位毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'LogRootPath' => [ - 'title' => '日志文件存储地址', - 'description' => '日志文件存储路径。', - 'type' => 'string', - 'example' => 'oss://<bucket-name>/logs/driver', - ], - 'DBClusterId' => [ - 'title' => '执行的集群ID', - 'description' => '执行Spark应用的集群ID。', - 'type' => 'string', - 'example' => 'amv-bp11q28kvl688****', - ], - 'Data' => [ - 'title' => '用户配置内容', - 'description' => 'Spark应用的配置内容。', - 'type' => 'string', - 'example' => '{ "name": "SparkPi", "file": "local:///tmp/spark-examples.jar", "className": "org.apache.spark.examples.SparkPi", "args": [ "1000000" ], "conf": { "spark.driver.resourceSpec": "small", "spark.executor.instances": 1, "spark.executor.resourceSpec": "small" } }', - ], - 'EstimateExecutionCpuTimeInSeconds' => [ - 'title' => '估算作业执行消耗CPU时间', - 'description' => '执行Spark应用消耗CPU的时长，单位毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'LastUpdatedTimeInMillis' => [ - 'title' => '最后一次更新状态的时间戳', - 'description' => '最近一次更新Spark应用的时间，Unix时间戳，单位毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1651213645200', - ], - 'RunningStartTimeInMillis' => [ - 'title' => '作业开始运行的时间戳', - 'description' => '作业开始运行的时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '36000', - ], - 'LastAttemptId' => [ - 'title' => '如配置了重试, 此为最后一次重试的作业ID', - 'description' => 'Spark应用最近一次重试的ID。', - 'type' => 'string', - 'example' => 's202204291426hzpre60****-0003', - ], - 'TerminatedTimeInMillis' => [ - 'title' => '终止执行的时间戳', - 'description' => 'Spark应用终止执行的时间，Unix时间戳，单位毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1651213645300', - ], - 'ResourceProvisioningDurationInMillis' => [ - 'title' => ' 应用资源拉起时间耗时', - 'description' => ' 应用资源拉起时间耗时', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '36000', - ], - 'ExecutionDurationInMillis' => [ - 'title' => '执行时间耗时', - 'description' => '执行时间耗时', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '36000', - ], - 'WebUiAddress' => [ - 'title' => 'Spark WEB UI地址', - 'description' => 'Web UI地址。', - 'type' => 'string', - 'example' => 'https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****', - ], - 'SubmittedTimeInMillis' => [ - 'title' => '用户提交到平台的时间戳', - 'description' => 'Spark应用的提交时间，Unix时间戳，单位毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1651213645000', - ], - 'StartedTimeInMillis' => [ - 'title' => '开始创建应用的时间戳', - 'description' => 'Spark应用的创建时间，Unix时间戳，单位毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1651213645010', - ], - 'AppType' => [ - 'title' => 'Spark App类型', - 'description' => 'Spark App类型', - 'type' => 'string', - 'example' => 'BATCH', - ], - 'ResourceGroupName' => [ - 'title' => '资源组名称', - 'description' => 'Job型资源组名称。', - 'type' => 'string', - 'example' => 'spark-rg', - ], + 'DurationInMillis' => ['title' => '执行时间(毫秒)', 'description' => 'Spark应用执行耗时，单位毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'LogRootPath' => ['title' => '日志文件存储地址', 'description' => '日志文件存储路径。', 'type' => 'string', 'example' => 'oss://<bucket-name>/logs/driver'], + 'DBClusterId' => ['title' => '执行的集群ID', 'description' => '执行Spark应用的集群ID。', 'type' => 'string', 'example' => 'amv-bp11q28kvl688****'], + 'Data' => ['title' => '用户配置内容', 'description' => 'Spark应用的配置内容。', 'type' => 'string', 'example' => '{ "name": "SparkPi", "file": "local:///tmp/spark-examples.jar", "className": "org.apache.spark.examples.SparkPi", "args": [ "1000000" ], "conf": { "spark.driver.resourceSpec": "small", "spark.executor.instances": 1, "spark.executor.resourceSpec": "small" } }'], + 'EstimateExecutionCpuTimeInSeconds' => ['title' => '估算作业执行消耗CPU时间', 'description' => '执行Spark应用消耗CPU的时长，单位毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'LastUpdatedTimeInMillis' => ['title' => '最后一次更新状态的时间戳', 'description' => '最近一次更新Spark应用的时间，Unix时间戳，单位毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '1651213645200'], + 'RunningStartTimeInMillis' => ['title' => '作业开始运行的时间戳', 'description' => '作业开始运行的时间戳', 'type' => 'integer', 'format' => 'int64', 'example' => '36000'], + 'LastAttemptId' => ['title' => '如配置了重试, 此为最后一次重试的作业ID', 'description' => 'Spark应用最近一次重试的ID。', 'type' => 'string', 'example' => 's202204291426hzpre60****-0003'], + 'TerminatedTimeInMillis' => ['title' => '终止执行的时间戳', 'description' => 'Spark应用终止执行的时间，Unix时间戳，单位毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '1651213645300'], + 'ResourceProvisioningDurationInMillis' => ['title' => ' 应用资源拉起时间耗时', 'description' => ' 应用资源拉起时间耗时', 'type' => 'integer', 'format' => 'int64', 'example' => '36000'], + 'ExecutionDurationInMillis' => ['title' => '执行时间耗时', 'description' => '执行时间耗时', 'type' => 'integer', 'format' => 'int64', 'example' => '36000'], + 'WebUiAddress' => ['title' => 'Spark WEB UI地址', 'description' => 'Web UI地址。', 'type' => 'string', 'example' => 'https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****'], + 'SubmittedTimeInMillis' => ['title' => '用户提交到平台的时间戳', 'description' => 'Spark应用的提交时间，Unix时间戳，单位毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '1651213645000'], + 'StartedTimeInMillis' => ['title' => '开始创建应用的时间戳', 'description' => 'Spark应用的创建时间，Unix时间戳，单位毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '1651213645010'], + 'AppType' => ['title' => 'Spark App类型', 'description' => 'Spark App类型', 'type' => 'string', 'example' => 'BATCH'], + 'ResourceGroupName' => ['title' => '资源组名称', 'description' => 'Job型资源组名称。', 'type' => 'string', 'example' => 'spark-rg'], ], ], 'FieldSchemaModel' => [ @@ -698,274 +219,167 @@ 'description' => '列信息。', 'type' => 'object', 'properties' => [ - 'Name' => [ - 'title' => 'name', - 'description' => '列名。', - 'type' => 'string', - 'example' => 'name', - ], - 'Type' => [ - 'title' => 'type', - 'description' => '列类型。', - 'type' => 'string', - 'example' => 'long', - ], - 'Comment' => [ - 'title' => 'comment', - 'description' => '列描述。', - 'type' => 'string', - 'example' => 'comment', - ], - 'DatabaseName' => [ - 'title' => 'databaseName', - 'description' => '逻辑库名。', - 'type' => 'string', - 'example' => 'databaseName', - ], - 'TableName' => [ - 'title' => 'tableName', - 'description' => '逻辑表名。', - 'type' => 'string', - 'example' => 'tableName', - ], - 'MappedName' => [ - 'title' => 'mappedName', - 'description' => '映射名。', - 'type' => 'string', - 'example' => 'mappedName', - ], - 'DataType' => [ - 'title' => 'dataType', - 'description' => '列数据类型。', - 'type' => 'string', - 'example' => 'long', - ], - 'CreateTime' => [ - 'title' => 'createTime', - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2023-01-05 13:17:55', - ], - 'UpdateTime' => [ - 'title' => 'updateTime', - 'description' => '更新时间。', - 'type' => 'string', - 'example' => '2023-01-05 13:17:55', - ], - 'PkPosition' => [ - 'title' => 'pkPosition', - 'description' => '主键位置。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '-1', - ], - 'IsPartitionKey' => [ - 'title' => 'isPartitionKey', - 'description' => '是否是分区键。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'OrdinalPosition' => [ - 'title' => 'ordinalPosition', - 'description' => '列位置。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '-1', - ], - 'ColumnRawName' => [ - 'title' => 'columnRawName', - 'description' => '列原始名。', - 'type' => 'string', - 'example' => 'ColumnRawName', - ], - 'PhysicalColumnName' => [ - 'title' => 'physicalColumnName', - 'description' => '物理列名。', - 'type' => 'string', - 'example' => 'PhysicalColumnName', - ], - 'Nullable' => [ - 'title' => 'nullable', - 'description' => '是否为可空。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'AutoIncrement' => [ - 'title' => 'autoIncrement', - 'description' => '是否自增。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Precision' => [ - 'title' => 'precision', - 'description' => '精度。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'Scale' => [ - 'title' => 'scale', - 'description' => '规模。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'Primarykey' => [ - 'title' => 'primarykey', - 'description' => '是否是主键。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'DefaultValue' => [ - 'title' => 'defaultValue', - 'description' => '默认值。', - 'type' => 'string', - 'example' => 'default', - ], - 'Tokenizer' => [ - 'title' => 'tokenizer', - 'description' => '令牌。', - 'type' => 'string', - 'example' => 'tokenizer', - ], - 'Encode' => [ - 'title' => 'encode', - 'description' => '加密方式。', - 'type' => 'string', - 'example' => 'encode', - ], - 'Compression' => [ - 'title' => 'compression', - 'description' => '压缩方式。', - 'type' => 'string', - 'example' => 'compression', - ], - 'Delimiter' => [ - 'title' => 'delimiter', - 'description' => '分隔符。', - 'type' => 'string', - 'example' => 'delimiter', - ], - 'ValueType' => [ - 'title' => 'valueType', - 'description' => '值类型。', - 'type' => 'string', - 'example' => 'valueType', - ], - 'CompressFloatUseShort' => [ - 'title' => 'compressFloatUseShort', - 'description' => '是否用short压缩float。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'OnUpdate' => [ - 'title' => 'onUpdate', - 'description' => '触发更新条件。', - 'type' => 'string', - 'example' => 'onUpdate', - ], + 'Name' => ['title' => 'name', 'description' => '列名。', 'type' => 'string', 'example' => 'name'], + 'Type' => ['title' => 'type', 'description' => '列类型。', 'type' => 'string', 'example' => 'long'], + 'Comment' => ['title' => 'comment', 'description' => '列描述。', 'type' => 'string', 'example' => 'comment'], + 'DatabaseName' => ['title' => 'databaseName', 'description' => '逻辑库名。', 'type' => 'string', 'example' => 'databaseName'], + 'TableName' => ['title' => 'tableName', 'description' => '逻辑表名。', 'type' => 'string', 'example' => 'tableName'], + 'MappedName' => ['title' => 'mappedName', 'description' => '映射名。', 'type' => 'string', 'example' => 'mappedName'], + 'DataType' => ['title' => 'dataType', 'description' => '列数据类型。', 'type' => 'string', 'example' => 'long'], + 'CreateTime' => ['title' => 'createTime', 'description' => '创建时间。', 'type' => 'string', 'example' => '2023-01-05 13:17:55'], + 'UpdateTime' => ['title' => 'updateTime', 'description' => '更新时间。', 'type' => 'string', 'example' => '2023-01-05 13:17:55'], + 'PkPosition' => ['title' => 'pkPosition', 'description' => '主键位置。', 'type' => 'integer', 'format' => 'int64', 'example' => '-1'], + 'IsPartitionKey' => ['title' => 'isPartitionKey', 'description' => '是否是分区键。', 'type' => 'boolean', 'example' => 'false'], + 'OrdinalPosition' => ['title' => 'ordinalPosition', 'description' => '列位置。', 'type' => 'integer', 'format' => 'int64', 'example' => '-1'], + 'ColumnRawName' => ['title' => 'columnRawName', 'description' => '列原始名。', 'type' => 'string', 'example' => 'ColumnRawName'], + 'PhysicalColumnName' => ['title' => 'physicalColumnName', 'description' => '物理列名。', 'type' => 'string', 'example' => 'PhysicalColumnName'], + 'Nullable' => ['title' => 'nullable', 'description' => '是否为可空。', 'type' => 'boolean', 'example' => 'true'], + 'AutoIncrement' => ['title' => 'autoIncrement', 'description' => '是否自增。', 'type' => 'boolean', 'example' => 'true'], + 'Precision' => ['title' => 'precision', 'description' => '精度。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'Scale' => ['title' => 'scale', 'description' => '规模。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'Primarykey' => ['title' => 'primarykey', 'description' => '是否是主键。', 'type' => 'boolean', 'example' => 'true'], + 'DefaultValue' => ['title' => 'defaultValue', 'description' => '默认值。', 'type' => 'string', 'example' => 'default'], + 'Tokenizer' => ['title' => 'tokenizer', 'description' => '令牌。', 'type' => 'string', 'example' => 'tokenizer'], + 'Encode' => ['title' => 'encode', 'description' => '加密方式。', 'type' => 'string', 'example' => 'encode'], + 'Compression' => ['title' => 'compression', 'description' => '压缩方式。', 'type' => 'string', 'example' => 'compression'], + 'Delimiter' => ['title' => 'delimiter', 'description' => '分隔符。', 'type' => 'string', 'example' => 'delimiter'], + 'ValueType' => ['title' => 'valueType', 'description' => '值类型。', 'type' => 'string', 'example' => 'valueType'], + 'CompressFloatUseShort' => ['title' => 'compressFloatUseShort', 'description' => '是否用short压缩float。', 'type' => 'boolean', 'example' => 'false'], + 'OnUpdate' => ['title' => 'onUpdate', 'description' => '触发更新条件。', 'type' => 'string', 'example' => 'onUpdate'], ], ], - 'Filters' => [ - 'title' => 'A short description of struct', - 'description' => '筛选信息的过滤器', + 'LogAnalyzeResult' => [ + 'title' => 'Spark日志分析结果', + 'description' => 'Spark日志分析结果', 'type' => 'object', 'properties' => [ - 'AppNameRegex' => [ - 'title' => '用于过滤应用名称的正则表达式', - 'type' => 'string', - ], - 'AppIdRegex' => [ - 'title' => '应用ID的过滤规则', - 'type' => 'string', - ], - 'AppType' => [ - 'title' => '应用的类型', - 'type' => 'string', - ], - 'AppState' => [ - 'title' => '应用处于的状态', - 'type' => 'string', - ], - 'SubmitTimeRange' => [ - 'title' => '应用提交时间范围', - 'type' => 'object', - 'properties' => [ - 'MinTimeInMills' => [ - 'title' => '筛选下限', - 'type' => 'integer', - 'format' => 'int64', - 'minimum' => '0', - ], - 'MaxTimeInMills' => [ - 'title' => '筛选上限', - 'type' => 'integer', - 'format' => 'int64', - 'minimum' => '0', - ], - ], - ], - 'TermiatedTimeRange' => [ - 'title' => '应用终止时间范围', - 'type' => 'object', - 'properties' => [ - 'MinTimeInMills' => [ - 'title' => '筛选下限', - 'type' => 'integer', - 'format' => 'int64', - 'minimum' => '0', - ], - 'MaxTimeInMills' => [ - 'title' => '筛选上限', - 'type' => 'integer', - 'format' => 'int64', - 'minimum' => '0', + 'AppErrorCode' => ['title' => '错误码信息', 'description' => 'Spark日志分析后如果有可分析错误, 此处显示错误类型.', 'type' => 'string', 'example' => 'EXCEEDED_QUOTA'], + 'AppErrorLog' => ['title' => '错误日志', 'description' => 'Spark日志分析任务中找到的报错日志', 'type' => 'string', 'example' => 'exception: cpu is exceeded limits 12/10'], + 'AppErrorAdvice' => ['title' => '针对错误的建议', 'description' => '针对自动分析出的错误日志, 给出的建议解决方案内容.', 'type' => 'string', 'example' => 'Please increase cpu quota for your resource group'], + ], + ], + 'open_struct_MvBaseTableDetailModel' => [ + 'description' => '物化视图基表详细信息。', + 'type' => 'object', + 'properties' => [ + 'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'test'], + 'DataVolumn' => ['description' => '数据量。', 'type' => 'string', 'example' => '321233'], + 'EnableBinlog' => ['description' => '表是否开启binlog。', 'type' => 'boolean', 'example' => 'true'], + 'SchemaName' => ['description' => '数据库名。', 'type' => 'string', 'example' => 'adb_demo'], + ], + ], + 'open_struct_MvDetailModel' => [ + 'description' => '物化视图概要数据。', + 'type' => 'object', + 'properties' => [ + 'FirstRefreshTime' => ['description' => '首次刷新时间。', 'type' => 'string', 'example' => '2025-01-01 09:00:00'], + 'QueryRewriteEnabled' => ['description' => '当前物化视图是否启用查询改写。', 'type' => 'boolean', 'example' => 'false'], + 'ExplicitHit' => ['description' => '最近7天，显式query命中的总次数。', 'type' => 'integer', 'format' => 'int64', 'example' => '5'], + 'IsInactive' => ['description' => '探测到当前物化视图距离第一次创建时间大于30天，且没有被访问过（包括显式查询和隐式查询）。', 'type' => 'boolean', 'example' => 'false'], + 'RemoteSize' => ['description' => '物化视图占用冷数据磁盘空间（单位bytes）。', 'type' => 'integer', 'format' => 'int64', 'example' => '1234'], + 'LocalSize' => ['description' => '物化视图占用热数据磁盘空间（单位bytes）。', 'type' => 'integer', 'format' => 'int64', 'example' => '1234'], + 'RefreshState' => ['description' => '物化视图刷新模型。', 'type' => 'string', 'example' => 'FAST'], + 'RefreshInterval' => ['description' => '刷新时间间隔。', 'type' => 'string', 'example' => '(now() + INTERVAL \'10\' SECOND)'], + 'ImplicitHit' => ['description' => '最近7天，隐式query命中的总次数。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], + 'UpdatedAt' => ['description' => '最近一次刷新的时间。', 'type' => 'string', 'example' => '2025-01-01 10:00:00'], + 'ResourceGroup' => ['description' => '刷新所依赖的资源组。', 'type' => 'string', 'example' => 'user_default'], + 'BaseTableInfos' => [ + 'description' => '当前物化视图所有直接父基表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'SchemaName' => ['description' => '库名。', 'type' => 'string', 'example' => 'test_db'], + 'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'test_tbl'], + 'BaseTableIsMv' => ['description' => '基表是否为一个物化视图。', 'type' => 'boolean', 'example' => 'false'], + 'TableEngine' => ['description' => '表引擎。', 'type' => 'string', 'example' => 'XUANWU'], ], + 'description' => '', ], ], - 'ExecutionTimeRange' => [ - 'title' => '应用执行消耗时间范围', - 'type' => 'object', - 'properties' => [ - 'MinTimeInSeconds' => [ - 'title' => '筛选下限', - 'type' => 'integer', - 'format' => 'int64', - 'minimum' => '0', - ], - 'MaxTimeInSeconds' => [ - 'title' => '筛选上限', - 'type' => 'integer', - 'format' => 'int64', - 'minimum' => '1', - ], + 'TableEngine' => ['description' => '表引擎。', 'type' => 'string', 'example' => 'XUANWU'], + 'BaseTableNames' => [ + 'description' => '当前物化视图所有直接父基表。', + 'type' => 'array', + 'items' => [ + 'description' => '基表的库名和表名。', + 'type' => 'array', + 'items' => ['description' => '库名或表名。', 'type' => 'string', 'example' => 't1'], ], ], + 'EnableDelayAlert' => ['description' => '开启刷新延迟告警。取值如下：'."\n" + ."\n" + .'- true：是。'."\n" + .'- false：否。', 'type' => 'integer', 'format' => 'int32', 'example' => 'false'], + 'EnableFailureAlert' => ['description' => '开启刷新任务失败告警。取值如下：'."\n" + ."\n" + .'- true：是。 '."\n" + .'- false：否。', 'type' => 'integer', 'format' => 'int32', 'example' => 'false'], + 'LatencyTolerance' => ['description' => '刷新延迟容忍度（分钟）。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], ], ], - 'LogAnalyzeResult' => [ - 'title' => 'Spark日志分析结果', - 'description' => 'Spark日志分析结果', + 'open_struct_MVRecommendResultModel' => [ + 'description' => '物化视图推荐结果详细信息', 'type' => 'object', 'properties' => [ - 'AppErrorCode' => [ - 'title' => '错误码信息', - 'description' => 'Spark日志分析后如果有可分析错误, 此处显示错误类型.', - 'type' => 'string', - 'example' => 'EXCEEDED_QUOTA', - ], - 'AppErrorLog' => [ - 'title' => '错误日志', - 'description' => 'Spark日志分析任务中找到的报错日志', - 'type' => 'string', - 'example' => 'exception: cpu is exceeded limits 12/10', - ], - 'AppErrorAdvice' => [ - 'title' => '针对错误的建议', - 'description' => '针对自动分析出的错误日志, 给出的建议解决方案内容.', - 'type' => 'string', - 'example' => 'Please increase cpu quota for your resource group', + 'BaseTables' => [ + 'description' => '子查询关联的基表。', + 'type' => 'array', + 'items' => ['description' => '基表详细信息。', '$ref' => '#/components/schemas/open_struct_MvBaseTableDetailModel'], ], + 'AcceleratedQueriesCount' => ['description' => '成功加速的查询数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '32'], + 'SupportIncrementalRefresh' => ['description' => '当前子查询是否支持增量刷新。', 'type' => 'boolean', 'example' => 'true'], + 'SubqueryId' => ['description' => '子查询ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'SavedScanbytes' => ['description' => '当前MV从关联父查询，后验测算出来可以节约扫描的字节数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '321321223'], + 'Subquery' => ['description' => '提取出来的公共子查询。', 'type' => 'string', 'example' => 'SELECT * FROM demo.tbl'], + ], + ], + 'open_struct_MvRecommendSubTaskModel' => [ + 'description' => '物化视图推荐任务执行详情。', + 'type' => 'object', + 'properties' => [ + 'SubQueriesCount' => ['description' => '生成的新增MV建议数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '70'], + 'Status' => ['description' => '当前运行的状态。', 'type' => 'string', 'example' => 'RUNNING'], + 'EndTime' => ['description' => '任务结束时间。', 'type' => 'string', 'example' => '2025-10-16 16:56'."\n"], + 'StartTime' => ['description' => '任务开始时间。', 'type' => 'string', 'example' => '2025-10-16 16:55'."\n"], + 'SubtaskId' => ['description' => '任务执行的记录ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'ScanQueriesCount' => ['description' => '扫描的查询数。', 'type' => 'integer', 'format' => 'int64', 'example' => '55'], + 'MinRewriteQueryCount' => ['description' => 'Pattern匹配的最少慢查询个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '3'], + 'MinRewriteQueryPattern' => ['description' => '最小可加速的Pattern数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'SlowQueryThreshold' => ['description' => '慢查询阈值。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + ], + ], + 'open_struct_MvRecommendTaskModel' => [ + 'description' => '物化视图推荐任务详细信息', + 'type' => 'object', + 'properties' => [ + 'Description' => ['description' => '描述。', 'type' => 'string', 'example' => 'task desc'."\n"], + 'CreatedTime' => ['description' => '创建时间。', 'type' => 'string', 'example' => '2024-12-12 23:59'], + 'LastRunAt' => ['description' => '最近一次运行时间。', 'type' => 'string', 'example' => '2024-12-13 00:10'], + 'TaskName' => ['description' => '推荐任务名称。', 'type' => 'string', 'example' => 'mv_task1'], + 'ScanQueriesRange' => ['description' => '扫描的时间范围，单位天，默认取值3。', 'type' => 'integer', 'format' => 'int32', 'example' => '3'], + 'SchedulingSettings' => ['description' => '任务的例行运行设置。', 'type' => 'string', 'example' => 'The 12:30 every day'], + 'MinRewriteQueryCount' => ['description' => 'Pattern匹配的最少慢查询个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '3'], + 'MinRewriteQueryPattern' => ['description' => '最小可加速的Pattern数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'SlowQueryThreshold' => ['description' => '慢查询阈值。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + ], + ], + 'open_struct_RefreshJobModel' => [ + 'description' => '刷新任务详细信息。', + 'type' => 'object', + 'properties' => [ + 'Status' => ['description' => '本次刷新任务的状态。', 'type' => 'string', 'example' => 'RUNNING'], + 'EndTime' => ['description' => '刷新任务结束时间。', 'type' => 'string', 'example' => '2025-01-15 10:12:00'], + 'RefreshModel' => ['description' => '刷新方式。'."\n" + .'- FAST'."\n" + .'- COMPLETE', 'type' => 'string', 'example' => 'FAST'], + 'StartTime' => ['description' => '实际开始时间。', 'type' => 'string', 'example' => '2025-01-15 10:11:00'], + 'RefreshInterval' => ['description' => '刷新时间间隔。', 'type' => 'string', 'example' => '30s'], + 'Processid' => ['description' => '任务ID。', 'type' => 'string', 'example' => '2025103010xxxxxxx'], + 'SchemaName' => ['description' => '数据库名。', 'type' => 'string', 'example' => 'adb_demo'], + 'ResourceGroup' => ['description' => '刷新所依赖的资源组。', 'type' => 'string', 'example' => 'user_default'], + 'Name' => ['description' => '物化视图名称。', 'type' => 'string', 'example' => 'demo_mv'], + 'ScheduledStartTime' => ['description' => '计划开始时间。', 'type' => 'string', 'example' => '2025-01-15 10:11:00'."\n"], ], ], 'OperatorNode' => [ @@ -973,109 +387,118 @@ 'description' => 'spark 算子节点', 'type' => 'object', 'properties' => [ - 'nodeName' => [ - 'title' => '算子名称', - 'type' => 'string', - ], - 'id' => [ - 'title' => '算子id', - 'type' => 'integer', - 'format' => 'int32', - ], - 'nodeDepth' => [ - 'title' => '算子所在树的层级', - 'type' => 'integer', - 'format' => 'int32', - ], - 'parentId' => [ - 'title' => '父算子 id', - 'type' => 'integer', - 'format' => 'int32', - ], - 'levelWidth' => [ - 'title' => '算子所在树层级共有多少节点', - 'type' => 'integer', - 'format' => 'int32', - ], - 'nodeWidth' => [ - 'title' => '该节点在对应层级从左到右的 position', - 'type' => 'integer', - 'format' => 'int32', - ], + 'nodeName' => ['title' => '算子名称', 'type' => 'string'], + 'id' => ['title' => '算子id', 'type' => 'integer', 'format' => 'int32'], + 'nodeDepth' => ['title' => '算子所在树的层级', 'type' => 'integer', 'format' => 'int32'], + 'parentId' => ['title' => '父算子 id', 'type' => 'integer', 'format' => 'int32'], + 'levelWidth' => ['title' => '算子所在树层级共有多少节点', 'type' => 'integer', 'format' => 'int32'], + 'nodeWidth' => ['title' => '该节点在对应层级从左到右的 position', 'type' => 'integer', 'format' => 'int32'], 'stats' => [ 'title' => '算子统计信息', 'type' => 'object', 'properties' => [ - 'parameters' => [ - 'title' => '算子参数', - 'type' => 'string', - 'required' => false, - ], - 'bytes' => [ - 'title' => '数据量', - 'type' => 'integer', - 'format' => 'int64', - ], - 'outputRows' => [ - 'title' => '输出行数', - 'type' => 'integer', - 'format' => 'int64', - ], - 'timeCost' => [ - 'title' => '运行时间', - 'type' => 'integer', - 'format' => 'int64', - ], - 'peakMemory' => [ - 'title' => '消耗内存最大值', - 'type' => 'integer', - 'format' => 'int64', - ], + 'parameters' => ['title' => '算子参数', 'type' => 'string', 'required' => false], + 'bytes' => ['title' => '数据量', 'type' => 'integer', 'format' => 'int64'], + 'outputRows' => ['title' => '输出行数', 'type' => 'integer', 'format' => 'int64'], + 'timeCost' => ['title' => '运行时间', 'type' => 'integer', 'format' => 'int64'], + 'peakMemory' => ['title' => '消耗内存最大值', 'type' => 'integer', 'format' => 'int64'], ], ], 'children' => [ 'title' => '子算子队列', 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/OperatorNode', - ], + 'items' => ['$ref' => '#/components/schemas/OperatorNode'], ], ], ], + 'SemanticViewModel' => [ + 'description' => '语义视图定义', + 'type' => 'object', + 'properties' => [ + 'ViewSchema' => ['title' => '语义视图所在的 schema', 'description' => '语义视图所在的 schema', 'type' => 'string', 'example' => 'sales_db'], + 'Definition' => ['title' => '语义视图 YAML 定义内容', 'description' => '语义视图 YAML 定义内容', 'type' => 'string', 'example' => 'name: revenue_analysis'."\n" + .'description: "Semantic view for analyzing revenue across products and customers"'."\n" + ."\n" + .'tables:'."\n" + .' - name: customers'."\n" + .' description: "Customer information"'."\n" + .' base_table:'."\n" + .' schema: sales_db'."\n" + .' table: customers'."\n" + .' dimensions:'."\n" + .' - name: customer_name'."\n" + .' synonyms: ["client name", "customer"]'."\n" + .' description: "Full name of the customer"'."\n" + .' expr: c_name'."\n" + .' data_type: VARCHAR'."\n" + .' - name: customer_segment'."\n" + .' synonyms: ["segment", "market segment"]'."\n" + .' description: "Customer market segment"'."\n" + .' expr: c_mktsegment'."\n" + .' data_type: VARCHAR'."\n" + .' is_enum: true'."\n" + ."\n" + .' - name: orders'."\n" + .' description: "Order information"'."\n" + .' base_table:'."\n" + .' schema: sales_db'."\n" + .' table: orders'."\n" + .' dimensions:'."\n" + .' - name: order_date'."\n" + .' description: "Date when order was placed"'."\n" + .' expr: o_orderdate'."\n" + .' data_type: DATE'."\n" + .' - name: order_year'."\n" + .' description: "Year when order was placed"'."\n" + .' expr: YEAR(o_orderdate)'."\n" + .' data_type: NUMBER'."\n" + .' facts:'."\n" + .' - name: order_total'."\n" + .' description: "Total order amount"'."\n" + .' expr: o_totalprice'."\n" + .' data_type: NUMBER'."\n" + .' metrics:'."\n" + .' - name: total_orders'."\n" + .' description: "Total number of orders"'."\n" + .' expr: COUNT(*)'."\n" + .' - name: total_revenue'."\n" + .' description: "Total revenue of orders"'."\n" + .' expr: SUM(o_totalprice)'."\n" + .' - name: average_order_value'."\n" + .' description: "Average order value"'."\n" + .' expr: AVG(o_totalprice)'."\n" + ."\n" + .'relationships:'."\n" + .' - name: orders_to_customers'."\n" + .' left_table: orders'."\n" + .' right_table: customers'."\n" + .' relationship_columns:'."\n" + .' - left_column: o_custkey'."\n" + .' right_column: c_custkey'."\n" + ."\n" + .'metrics:'."\n" + .' - name: revenue_per_customer'."\n" + .' description: "Average revenue per customer"'."\n" + .' expr: orders.total_revenue / customers.customer_count'."\n"], + 'ViewName' => ['title' => '语义视图名称', 'description' => '语义视图名称', 'type' => 'string', 'example' => 'revenue_analysis'], + 'Comment' => ['title' => '语义视图注解', 'description' => '语义视图注解', 'type' => 'string', 'example' => '这是一个定义销售额相关指标的视图'], + 'Score' => ['title' => '向量检索匹配度（默认为 1，检索查询时为向量匹配值0-1之间的小数）', 'description' => '向量检索匹配度（默认为 1，检索查询时为向量匹配值0-1之间的小数）', 'type' => 'number', 'format' => 'double', 'example' => '0.81'], + ], + ], 'SerDeInfoModel' => [ 'title' => 'A short description of struct', 'description' => '序列化信息元信息。', 'type' => 'object', 'properties' => [ - 'SerDeId' => [ - 'title' => 'serDeId', - 'description' => 'ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'Name' => [ - 'title' => 'name', - 'description' => '序列化信息名字。', - 'type' => 'string', - 'example' => 'example', - ], + 'SerDeId' => ['title' => 'serDeId', 'description' => 'ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'Name' => ['title' => 'name', 'description' => '序列化信息名字。', 'type' => 'string', 'example' => 'example'], 'Parameters' => [ 'title' => 'parameters', 'description' => '序列化反序列化的配置参数。', 'type' => 'object', - 'additionalProperties' => [ - 'description' => '参数的值。', - 'type' => 'string', - 'example' => 'key:value', - ], - ], - 'SerializationLib' => [ - 'title' => 'serializationLib', - 'description' => '序列化使用的库。', - 'type' => 'string', - 'example' => 'org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe', + 'additionalProperties' => ['description' => '参数的值。', 'type' => 'string', 'example' => 'key:value'], ], + 'SerializationLib' => ['title' => 'serializationLib', 'description' => '序列化使用的库。', 'type' => 'string', 'example' => 'org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe'], ], ], 'SparkAnalyzeLogTask' => [ @@ -1083,70 +506,16 @@ 'description' => 'Spark日志分析任务', 'type' => 'object', 'properties' => [ - 'TaskId' => [ - 'title' => 'Spark日志分析任务ID', - 'description' => 'Spark日志分析任务ID', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], - 'UserId' => [ - 'title' => '提交任务的用户ID', - 'description' => '提交任务的用户ID', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '13719918xxx', - ], - 'SubmittedTimeInMillis' => [ - 'title' => '提交任务的毫秒时间戳', - 'description' => '提交任务的毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1672123543000', - ], - 'TerminatedTimeInMillis' => [ - 'title' => '任务终止的毫秒级时间戳', - 'description' => '任务终止的毫秒级时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1672123543000', - ], - 'TaskState' => [ - 'title' => '任务所处状态', - 'description' => '任务所处状态', - 'type' => 'string', - 'example' => 'WAITING', - ], - 'Result' => [ - 'title' => '任务分析结果', - 'description' => '任务分析结果', - '$ref' => '#/components/schemas/LogAnalyzeResult', - ], - 'StartedTimeInMillis' => [ - 'title' => '任务开始的毫秒时间戳', - 'description' => '任务开始的毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1672123543000', - ], - 'RuleMatched' => [ - 'title' => '是否命中了规则', - 'description' => '是否命中了规则', - 'type' => 'boolean', - 'example' => 'true', - ], - 'TaskErrMsg' => [ - 'title' => 'Task失败的错误信息', - 'description' => 'Task失败的错误信息', - 'type' => 'string', - 'example' => 'Driver log not found', - ], - 'DBClusterId' => [ - 'title' => '数据库集群ID', - 'description' => '数据库集群ID', - 'type' => 'string', - 'example' => 'amv-adbxxxxx', - ], + 'TaskId' => ['title' => 'Spark日志分析任务ID', 'description' => 'Spark日志分析任务ID', 'type' => 'integer', 'format' => 'int64', 'example' => '10'], + 'UserId' => ['title' => '提交任务的用户ID', 'description' => '提交任务的用户ID', 'type' => 'integer', 'format' => 'int64', 'example' => '13719918xxx'], + 'SubmittedTimeInMillis' => ['title' => '提交任务的毫秒时间戳', 'description' => '提交任务的毫秒时间戳', 'type' => 'integer', 'format' => 'int64', 'example' => '1672123543000'], + 'TerminatedTimeInMillis' => ['title' => '任务终止的毫秒级时间戳', 'description' => '任务终止的毫秒级时间戳', 'type' => 'integer', 'format' => 'int64', 'example' => '1672123543000'], + 'TaskState' => ['title' => '任务所处状态', 'description' => '任务所处状态', 'type' => 'string', 'example' => 'WAITING'], + 'Result' => ['title' => '任务分析结果', 'description' => '任务分析结果', '$ref' => '#/components/schemas/LogAnalyzeResult'], + 'StartedTimeInMillis' => ['title' => '任务开始的毫秒时间戳', 'description' => '任务开始的毫秒时间戳', 'type' => 'integer', 'format' => 'int64', 'example' => '1672123543000'], + 'RuleMatched' => ['title' => '是否命中了规则', 'description' => '是否命中了规则', 'type' => 'boolean', 'example' => 'true'], + 'TaskErrMsg' => ['title' => 'Task失败的错误信息', 'description' => 'Task失败的错误信息', 'type' => 'string', 'example' => 'Driver log not found'], + 'DBClusterId' => ['title' => '数据库集群ID', 'description' => '数据库集群ID', 'type' => 'string', 'example' => 'amv-adbxxxxx'], ], ], 'SparkAppInfo' => [ @@ -1154,58 +523,24 @@ 'description' => 'Spark应用的执行状态信息。', 'type' => 'object', 'properties' => [ - 'AppId' => [ - 'title' => 'Spark应用ID', - 'description' => '应用ID。', - 'type' => 'string', - 'example' => 's202207151211hz0c****', - ], - 'AppName' => [ - 'title' => '应用的命名', - 'description' => '应用名称。', - 'type' => 'string', - 'example' => 'SparkTest', - ], - 'Priority' => [ - 'title' => '优先级', - 'description' => '优先级', - 'type' => 'string', - 'example' => 'NORMAL', - ], - 'State' => [ - 'title' => '状态', - 'description' => 'Spark应用的状态，取值说明：'."\n" - .'- **SUBMITTED**：已提交。'."\n" - .'- **STARTING**：开始启动。'."\n" - .'- **RUNNING**：执行中。'."\n" - .'- **FAILING**：任务失败，清理环境中。'."\n" - .'- **FAILED**：失败。'."\n" - .'- **KILLING**：中止任务，清理环境中。'."\n" - .'- **KILLED**：中止任务。'."\n" - .'- **SUCCEEDING**：任务执行结束，清理环境中。'."\n" - .'- **COMPLETED**：任务执行结束。'."\n" - .'- **FATAL**：意外失败。'."\n" - .'- **UNKNOWN**：未知错误。', - 'type' => 'string', - 'example' => 'SUBMITTED', - ], - 'Message' => [ - 'title' => '附加信息', - 'description' => '告警信息，如任务执行失败或资源不足等，无告警时则返回为空。', - 'type' => 'string', - 'example' => 'WARN: Disk is full.', - ], - 'Detail' => [ - 'title' => '作业详细信息', - 'description' => 'Spark应用的详细信息。', - '$ref' => '#/components/schemas/Detail', - ], - 'DBClusterId' => [ - 'title' => '数据库ID', - 'description' => '数据库ID', - 'type' => 'string', - 'example' => 'amv-23xxxx', - ], + 'AppId' => ['title' => 'Spark应用ID', 'description' => '应用ID。', 'type' => 'string', 'example' => 's202207151211hz0c****'], + 'Message' => ['title' => '附加信息', 'description' => '告警信息，如任务执行失败或资源不足等，无告警时则返回为空。', 'type' => 'string', 'example' => 'WARN: Disk is full.'], + 'Priority' => ['title' => '优先级', 'description' => '优先级', 'type' => 'string', 'example' => 'NORMAL'], + 'State' => ['title' => '状态', 'description' => 'Spark应用的状态，取值说明：'."\n" + .'- **SUBMITTED**：已提交。'."\n" + .'- **STARTING**：开始启动。'."\n" + .'- **RUNNING**：执行中。'."\n" + .'- **FAILING**：任务失败，清理环境中。'."\n" + .'- **FAILED**：失败。'."\n" + .'- **KILLING**：中止任务，清理环境中。'."\n" + .'- **KILLED**：中止任务。'."\n" + .'- **SUCCEEDING**：任务执行结束，清理环境中。'."\n" + .'- **COMPLETED**：任务执行结束。'."\n" + .'- **FATAL**：意外失败。'."\n" + .'- **UNKNOWN**：未知错误。', 'type' => 'string', 'example' => 'SUBMITTED'], + 'DBClusterId' => ['title' => '数据库ID', 'description' => '数据库ID', 'type' => 'string', 'example' => 'amv-23xxxx'], + 'Detail' => ['title' => '作业详细信息', 'description' => 'Spark应用的详细信息。', '$ref' => '#/components/schemas/Detail'], + 'AppName' => ['title' => '应用的命名', 'description' => '应用名称。', 'type' => 'string', 'example' => 'SparkTest'], ], ], 'SparkAttemptInfo' => [ @@ -1213,46 +548,22 @@ 'description' => 'Spark重试的详细信息。', 'type' => 'object', 'properties' => [ - 'AttemptId' => [ - 'title' => 'Spark应用重试ID', - 'description' => 'Spark应用的重试ID。', - 'type' => 'string', - 'example' => 's202207151211hz****-0001', - ], - 'Priority' => [ - 'title' => 'Spark应用重试优先级', - 'description' => 'Spark应用重试优先级', - 'type' => 'string', - 'example' => 'NORMAL', - ], - 'State' => [ - 'title' => 'Spark应用重试状态', - 'description' => 'Spark应用的状态。取值说明：'."\n" - .'- **SUBMITTED**：已提交。'."\n" - .'- **STARTING**：开始启动。'."\n" - .'- **RUNNING**：执行中。'."\n" - .'- **FAILING**：任务失败，清理环境中。'."\n" - .'- **FAILED**：失败。'."\n" - .'- **KILLING**：中止任务，清理环境中。'."\n" - .'- **KILLED**：中止任务。'."\n" - .'- **SUCCEEDING**：任务执行结束，清理环境中。'."\n" - .'- **COMPLETED**：任务执行结束。'."\n" - .'- **FATAL**：意外失败。'."\n" - .'- **UNKNOWN**：未知错误。', - 'type' => 'string', - 'example' => 'SUBMITTED', - ], - 'Message' => [ - 'title' => '备注', - 'description' => '告警信息，如任务执行失败或资源不足等，无告警时则返回为空。', - 'type' => 'string', - 'example' => 'WARN: Disk is full', - ], - 'Detail' => [ - 'title' => '重试详细信息', - 'description' => 'Spark应用的详细信息。', - '$ref' => '#/components/schemas/Detail', - ], + 'AttemptId' => ['title' => 'Spark应用重试ID', 'description' => 'Spark应用的重试ID。', 'type' => 'string', 'example' => 's202207151211hz****-0001'], + 'Message' => ['title' => '备注', 'description' => '告警信息，如任务执行失败或资源不足等，无告警时则返回为空。', 'type' => 'string', 'example' => 'WARN: Disk is full'], + 'Priority' => ['title' => 'Spark应用重试优先级', 'description' => 'Spark应用重试优先级', 'type' => 'string', 'example' => 'NORMAL'], + 'State' => ['title' => 'Spark应用重试状态', 'description' => 'Spark应用的状态。取值说明：'."\n" + .'- **SUBMITTED**：已提交。'."\n" + .'- **STARTING**：开始启动。'."\n" + .'- **RUNNING**：执行中。'."\n" + .'- **FAILING**：任务失败，清理环境中。'."\n" + .'- **FAILED**：失败。'."\n" + .'- **KILLING**：中止任务，清理环境中。'."\n" + .'- **KILLED**：中止任务。'."\n" + .'- **SUCCEEDING**：任务执行结束，清理环境中。'."\n" + .'- **COMPLETED**：任务执行结束。'."\n" + .'- **FATAL**：意外失败。'."\n" + .'- **UNKNOWN**：未知错误。', 'type' => 'string', 'example' => 'SUBMITTED'], + 'Detail' => ['title' => '重试详细信息', 'description' => 'Spark应用的详细信息。', '$ref' => '#/components/schemas/Detail'], ], ], 'SparkBatchSQL' => [ @@ -1260,12 +571,13 @@ 'description' => 'SparkBatchSQL返回结构。', 'type' => 'object', 'properties' => [ - 'QueryId' => [ - 'title' => 'Query ID', - 'description' => 'Query ID。', - 'type' => 'string', - 'example' => 'sq172352176****', - ], + 'Uid' => ['title' => '提交者UID', 'description' => '阿里云账号ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '2198002412336****'], + 'QuerySubmissionTime' => ['title' => '提交的时间戳', 'description' => '提交的时间戳。', 'type' => 'integer', 'format' => 'int64', 'example' => '1723521767000'], + 'Query' => ['title' => '执行语句原文', 'description' => '执行语句原文。', 'type' => 'string', 'example' => 'SELECT * FROM db.tb'], + 'QueryId' => ['title' => 'Query ID', 'description' => 'Query ID。', 'type' => 'string', 'example' => 'sq172352176****'], + 'Schema' => ['title' => '执行选择Schema', 'description' => '执行时选择的数据库名称。', 'type' => 'string', 'example' => 'default'], + 'QueryEndTime' => ['title' => '结束执行的时间戳', 'description' => '结束执行的时间戳。', 'type' => 'integer', 'format' => 'int64', 'example' => '1723521767000'], + 'DBClusterId' => ['title' => 'ADB集群ID', 'description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp17s73f016****'], 'QueryState' => [ 'title' => '执行状态', 'description' => '执行状态，可选值有：'."\n" @@ -1279,73 +591,15 @@ 'enumValueTitles' => [], 'example' => 'RUNNING', ], - 'QuerySubmissionTime' => [ - 'title' => '提交的时间戳', - 'description' => '提交的时间戳。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1723521767000', - ], - 'QueryStartTime' => [ - 'title' => '开始执行的时间戳', - 'description' => '开始执行的时间戳。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1723521767000', - ], - 'QueryEndTime' => [ - 'title' => '结束执行的时间戳', - 'description' => '结束执行的时间戳。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1723521767000', - ], - 'Schema' => [ - 'title' => '执行选择Schema', - 'description' => '执行时选择的数据库名称。', - 'type' => 'string', - 'example' => 'default', - ], - 'Uid' => [ - 'title' => '提交者UID', - 'description' => '阿里云账号ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2198002412336****', - ], - 'DBClusterId' => [ - 'title' => 'ADB集群ID', - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp17s73f016****', - ], - 'ResourceGroupName' => [ - 'title' => '资源组名称', - 'description' => '资源组名称。', - 'type' => 'string', - 'example' => 'spark_rg', - ], - 'Query' => [ - 'title' => '执行语句原文', - 'description' => '执行语句原文。', - 'type' => 'string', - 'example' => 'SELECT * FROM db.tb', - ], 'Statements' => [ 'title' => '语句执行结果', 'description' => '语句执行结果。', 'type' => 'array', - 'items' => [ - 'description' => 'SQL执行内容状态结构体。', - '$ref' => '#/components/schemas/SparkBatchSQLStatement', - ], - ], - 'ErrMessage' => [ - 'title' => '最后的执行报错信息', - 'description' => '执行报错信息。', - 'type' => 'string', - 'example' => 'schema is not found', + 'items' => ['description' => 'SQL执行内容状态结构体。', '$ref' => '#/components/schemas/SparkBatchSQLStatement'], ], + 'ErrMessage' => ['title' => '最后的执行报错信息', 'description' => '执行报错信息。', 'type' => 'string', 'example' => 'schema is not found'], + 'QueryStartTime' => ['title' => '开始执行的时间戳', 'description' => '开始执行的时间戳。', 'type' => 'integer', 'format' => 'int64', 'example' => '1723521767000'], + 'ResourceGroupName' => ['title' => '资源组名称', 'description' => '资源组名称。', 'type' => 'string', 'example' => 'spark_rg'], ], ], 'SparkBatchSQLStatement' => [ @@ -1353,31 +607,10 @@ 'description' => 'SparkBatchSQL Statement返回结构', 'type' => 'object', 'properties' => [ - 'ResultUri' => [ - 'title' => '结果存储位置', - 'description' => 'SQL执行结果在OSS上的存储位置，当用户没有指定存储位置时，返回结果为空。', - 'type' => 'string', - 'example' => 'oss://yourbucket/result.json', - ], - 'EndTime' => [ - 'title' => '结束执行的时间戳', - 'description' => 'SQL执行结束的时间戳。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1723521767000', - ], - 'AppId' => [ - 'title' => '执行当前SQL的Spark作业ID', - 'description' => '执行这个SQL语句的Spark作业ID。', - 'type' => 'string', - 'example' => 's20240122jsdx****', - ], - 'StatementId' => [ - 'title' => 'Statement Id', - 'description' => 'SQL语句ID。', - 'type' => 'string', - 'example' => 'sq1723521767****-0001', - ], + 'ResultUri' => ['title' => '结果存储位置', 'description' => 'SQL执行结果在OSS上的存储位置，当用户没有指定存储位置时，返回结果为空。', 'type' => 'string', 'example' => 'oss://yourbucket/result.json'], + 'EndTime' => ['title' => '结束执行的时间戳', 'description' => 'SQL执行结束的时间戳。', 'type' => 'integer', 'format' => 'int64', 'example' => '1723521767000'], + 'AppId' => ['title' => '执行当前SQL的Spark作业ID', 'description' => '执行这个SQL语句的Spark作业ID。', 'type' => 'string', 'example' => 's20240122jsdx****'], + 'StatementId' => ['title' => 'Statement Id', 'description' => 'SQL语句ID。', 'type' => 'string', 'example' => 'sq1723521767****-0001'], 'State' => [ 'title' => '执行状态', 'description' => '执行状态，可选值有：'."\n" @@ -1391,36 +624,15 @@ 'enumValueTitles' => [], 'example' => 'RUNNING', ], - 'StartTime' => [ - 'title' => '开始执行的时间戳', - 'description' => 'SQL开始执行的时间戳。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1723521767000', - ], - 'Error' => [ - 'title' => '执行失败后的报错内容', - 'description' => 'SQL执行报错后的错误信息。', - 'type' => 'string', - 'example' => 'table is not found', - ], - 'Code' => [ - 'title' => '执行代码', - 'description' => 'SQL执行的内容，为用户输入的原始SQL文本。', - 'type' => 'string', - 'example' => 'SELECT 100', - ], - 'Result' => [ - 'title' => '执行结果', - 'description' => 'SQL执行的结果，内容为Spark中`DataFrame Show`语句的返回格式。', - 'type' => 'string', - 'example' => '+---+-----+'."\n" - .'|age| name|'."\n" - .'+---+-----+'."\n" - .'| 14| Tom|'."\n" - .'| 23|Alice|'."\n" - .'+---+-----+', - ], + 'StartTime' => ['title' => '开始执行的时间戳', 'description' => 'SQL开始执行的时间戳。', 'type' => 'integer', 'format' => 'int64', 'example' => '1723521767000'], + 'Error' => ['title' => '执行失败后的报错内容', 'description' => 'SQL执行报错后的错误信息。', 'type' => 'string', 'example' => 'table is not found'], + 'Code' => ['title' => '执行代码', 'description' => 'SQL执行的内容，为用户输入的原始SQL文本。', 'type' => 'string', 'example' => 'SELECT 100'], + 'Result' => ['title' => '执行结果', 'description' => 'SQL执行的结果，内容为Spark中`DataFrame Show`语句的返回格式。', 'type' => 'string', 'example' => '+---+-----+'."\n" + .'|age| name|'."\n" + .'+---+-----+'."\n" + .'| 14| Tom|'."\n" + .'| 23|Alice|'."\n" + .'+---+-----+'], ], ], 'SparkOperatorInfo' => [ @@ -1428,161 +640,8 @@ 'description' => 'Spark 算子信息', 'type' => 'object', 'properties' => [ - 'OperatorName' => [ - 'title' => '算子名称', - 'type' => 'string', - 'format' => 'byte', - ], - 'MetricValue' => [ - 'title' => 'metrics 值', - 'type' => 'integer', - 'format' => 'int64', - ], - ], - ], - 'SparkSession' => [ - 'title' => 'A short description of struct', - 'description' => 'spark连接对象', - 'type' => 'object', - 'properties' => [ - 'SessionId' => [ - 'title' => 'session id', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '15', - ], - 'State' => [ - 'title' => '状态', - 'type' => 'string', - 'example' => 'idle', - ], - 'AliyunUid' => [ - 'title' => '用户ID', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '11123123', - ], - 'Active' => [ - 'title' => '是否活跃', - 'type' => 'string', - 'example' => 'true', - ], - ], - ], - 'Statement' => [ - 'title' => 'Spark代码块', - 'description' => 'Spark可执行代码块', - 'type' => 'object', - 'properties' => [ - 'SessionId' => [ - 'title' => '会话id', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], - 'StatementId' => [ - 'title' => '代码块id', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'Code' => [ - 'title' => '代码块内容', - 'type' => 'string', - 'example' => 'SELECT * FROM table', - ], - 'CodeState' => [ - 'title' => '代码执行状态', - 'type' => 'string', - 'example' => 'Waiting', - ], - 'Output' => [ - 'title' => '执行结果', - 'type' => 'string', - 'example' => 'Spark is running, the ouput is...', - ], - 'StartTime' => [ - 'title' => '开始执行的毫秒级时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1658977911000', - ], - 'EndTime' => [ - 'title' => '结束执行的毫秒级时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1658987911000', - ], - 'Error' => [ - 'title' => '执行错误信息', - 'type' => 'string', - 'example' => 'Disk is full', - ], - 'CodeType' => [ - 'title' => '代码执行类型', - 'type' => 'string', - 'example' => 'SQL', - ], - 'AliyunUid' => [ - 'title' => '用户ID', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1111111', - ], - 'ResourceGroup' => [ - 'title' => '资源组名称', - 'type' => 'string', - 'example' => 'rg1', - ], - 'HaveRows' => [ - 'title' => '是否有OSS数据', - 'type' => 'boolean', - 'example' => 'true', - ], - 'TotalCount' => [ - 'title' => '返回行数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1000', - ], - ], - ], - 'StatementInfo' => [ - 'title' => 'A short description of struct', - 'description' => '代码块执行信息', - 'type' => 'object', - 'properties' => [ - 'StatementId' => [ - 'title' => '代码块标识ID', - 'type' => 'string', - ], - 'Code' => [ - 'title' => '代码块内容', - 'type' => 'string', - ], - 'CompletedTimeInMills' => [ - 'title' => '执行完成的时间戳', - 'type' => 'integer', - 'format' => 'int64', - ], - 'Output' => [ - 'title' => '执行结果详细信息', - 'type' => 'string', - ], - 'Process' => [ - 'title' => '执行进度百分比', - 'type' => 'number', - 'format' => 'float', - ], - 'StartedTimeInMills' => [ - 'title' => '开始执行的时间戳', - 'type' => 'integer', - 'format' => 'int64', - ], - 'State' => [ - 'title' => '当前执行状态', - 'type' => 'string', - ], + 'OperatorName' => ['title' => '算子名称', 'type' => 'string', 'format' => 'byte'], + 'MetricValue' => ['title' => 'metrics 值', 'type' => 'integer', 'format' => 'int64'], ], ], 'StorageDescriptorModel' => [ @@ -1590,64 +649,20 @@ 'description' => '存储描述元信息。', 'type' => 'object', 'properties' => [ - 'SdId' => [ - 'title' => 'sdId', - 'description' => '描述信息的存储ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'Location' => [ - 'title' => 'location', - 'description' => '存储位置。', - 'type' => 'string', - 'example' => 'oss://**************', - ], - 'InputFormat' => [ - 'title' => 'inputFormat', - 'description' => '输入格式。', - 'type' => 'string', - 'example' => 'org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat', - ], - 'OutputFormat' => [ - 'title' => 'outputFormat', - 'description' => '输出格式。', - 'type' => 'string', - 'example' => 'org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat', - ], - 'Compressed' => [ - 'title' => 'compressed', - 'description' => '是否压缩。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'NumBuckets' => [ - 'title' => 'numBuckets', - 'description' => 'Bucket个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'SerDeInfo' => [ - 'description' => '序列化反序列化信息。', - '$ref' => '#/components/schemas/SerDeInfoModel', - ], + 'SdId' => ['title' => 'sdId', 'description' => '描述信息的存储ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'Location' => ['title' => 'location', 'description' => '存储位置。', 'type' => 'string', 'example' => 'oss://**************'], + 'InputFormat' => ['title' => 'inputFormat', 'description' => '输入格式。', 'type' => 'string', 'example' => 'org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat'], + 'OutputFormat' => ['title' => 'outputFormat', 'description' => '输出格式。', 'type' => 'string', 'example' => 'org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat'], + 'Compressed' => ['title' => 'compressed', 'description' => '是否压缩。', 'type' => 'boolean', 'example' => 'false'], + 'NumBuckets' => ['title' => 'numBuckets', 'description' => 'Bucket个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'SerDeInfo' => ['description' => '序列化反序列化信息。', '$ref' => '#/components/schemas/SerDeInfoModel'], 'Parameters' => [ 'title' => 'parameters', 'description' => '存储配置参数。', 'type' => 'object', - 'additionalProperties' => [ - 'description' => '参数的值。', - 'type' => 'string', - 'example' => 'key:value', - ], - ], - 'StoredAsSubDirectories' => [ - 'title' => 'storedAsSubDirectories', - 'description' => '是否以子目录方式存储。', - 'type' => 'boolean', - 'example' => 'false', + 'additionalProperties' => ['description' => '参数的值。', 'type' => 'string', 'example' => 'key:value'], ], + 'StoredAsSubDirectories' => ['title' => 'storedAsSubDirectories', 'description' => '是否以子目录方式存储。', 'type' => 'boolean', 'example' => 'false'], ], ], 'TableDetailModel' => [ @@ -1655,77 +670,27 @@ 'description' => '表详细信息。', 'type' => 'object', 'properties' => [ - 'SchemaName' => [ - 'title' => '逻辑库名', - 'description' => '逻辑库名。', - 'type' => 'string', - 'example' => 'schemaName', - ], - 'TableName' => [ - 'title' => '逻辑表名', - 'description' => '逻辑表名。', - 'type' => 'string', - 'example' => 'tableName', - ], - 'TableType' => [ - 'title' => 'table类型', - 'description' => '表类型。', - 'type' => 'string', - 'example' => 'PHYSICAL_SCHEMA_NAME', - ], - 'CreateTime' => [ - 'title' => '创建时间', - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2023-01-05 13:17:55', - ], - 'UpdateTime' => [ - 'title' => '更新时间', - 'description' => '更新时间。', - 'type' => 'string', - 'example' => '2023-01-05 13:17:55', - ], - 'Description' => [ - 'title' => '备注', - 'description' => '描述。', - 'type' => 'string', - 'example' => 'Description', - ], - 'Owner' => [ - 'title' => '所有者', - 'description' => '所有者。', - 'type' => 'string', - 'example' => 'abc', - ], + 'SchemaName' => ['title' => '逻辑库名', 'description' => '逻辑库名。', 'type' => 'string', 'example' => 'schemaName'], + 'TableName' => ['title' => '逻辑表名', 'description' => '逻辑表名。', 'type' => 'string', 'example' => 'tableName'], + 'TableType' => ['title' => 'table类型', 'description' => '表类型。', 'type' => 'string', 'example' => 'PHYSICAL_SCHEMA_NAME'], + 'CreateTime' => ['title' => '创建时间', 'description' => '创建时间。', 'type' => 'string', 'example' => '2023-01-05 13:17:55'], + 'UpdateTime' => ['title' => '更新时间', 'description' => '更新时间。', 'type' => 'string', 'example' => '2023-01-05 13:17:55'], + 'Description' => ['title' => '备注', 'description' => '描述。', 'type' => 'string', 'example' => 'Description'], + 'Owner' => ['title' => '所有者', 'description' => '所有者。', 'type' => 'string', 'example' => 'abc'], 'Columns' => [ 'title' => '列信息', 'description' => '列信息。', 'type' => 'array', - 'items' => [ - 'description' => '列的详细信息。', - '$ref' => '#/components/schemas/ColDetailModel', - ], - ], - 'Catalog' => [ - 'title' => '外部数据源', - 'description' => '外部数据源。', - 'type' => 'string', - 'example' => 'oss', - ], - 'CreatedBySource' => [ - 'type' => 'string', - ], - 'CreatedByUser' => [ - 'type' => 'string', - ], - 'Location' => [ - 'type' => 'string', + 'items' => ['description' => '列的详细信息。', '$ref' => '#/components/schemas/ColDetailModel'], ], + 'Catalog' => ['title' => '外部数据源', 'description' => '外部数据源。', 'type' => 'string', 'example' => 'oss'], + 'CreatedBySource' => ['type' => 'string', 'description' => ''], + 'CreatedByUser' => ['type' => 'string', 'description' => ''], + 'Location' => ['type' => 'string', 'description' => ''], 'Parameters' => [ 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - ], + 'additionalProperties' => ['type' => 'string', 'description' => ''], + 'description' => '', ], ], ], @@ -1734,327 +699,86 @@ 'description' => '表元信息。', 'type' => 'object', 'properties' => [ - 'TblId' => [ - 'title' => 'tblId', - 'description' => '表编号。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'DbName' => [ - 'title' => 'dbName', - 'description' => '逻辑库名。', - 'type' => 'string', - 'example' => 'example', - ], - 'TableName' => [ - 'title' => 'tblName', - 'description' => '逻辑表名。', - 'type' => 'string', - 'example' => 'tableName', - ], - 'TableType' => [ - 'title' => 'tblType', - 'description' => '表类型。', - 'type' => 'string', - 'example' => 'external_table', - ], + 'TblId' => ['title' => 'tblId', 'description' => '表编号。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'DbName' => ['title' => 'dbName', 'description' => '逻辑库名。', 'type' => 'string', 'example' => 'example'], + 'TableName' => ['title' => 'tblName', 'description' => '逻辑表名。', 'type' => 'string', 'example' => 'tableName'], + 'TableType' => ['title' => 'tblType', 'description' => '表类型。', 'type' => 'string', 'example' => 'external_table'], 'PartitionKeys' => [ 'title' => 'partitionKeys', 'description' => '分区键。', 'type' => 'array', - 'items' => [ - 'description' => '分区列信息。', - '$ref' => '#/components/schemas/FieldSchemaModel', - ], + 'items' => ['description' => '分区列信息。', '$ref' => '#/components/schemas/FieldSchemaModel'], ], 'Parameters' => [ 'title' => 'parameters', 'description' => '参数。', 'type' => 'object', - 'additionalProperties' => [ - 'description' => '参数的值。', - 'type' => 'string', - 'example' => 'key:value', - ], - ], - 'Sd' => [ - 'title' => 'sd', - 'description' => '存储描述信息。', - '$ref' => '#/components/schemas/StorageDescriptorModel', - ], - 'CreateTime' => [ - 'title' => 'createTime', - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2023-01-05 13:17:55', - ], - 'ViewOriginalText' => [ - 'title' => 'viewOriginalText', - 'description' => '创建视图时输入的SQL。', - 'type' => 'string', - 'example' => 'ViewOriginalText', - ], - 'ViewExpandedText' => [ - 'title' => 'viewExpandedText', - 'description' => '对创建视图的SQL进行规范化处理后的结果。', - 'type' => 'string', - 'example' => 'ViewExpandedText', - ], - 'Temporary' => [ - 'title' => 'temporary', - 'description' => '是否是临时表。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'Comment' => [ - 'title' => 'comment', - 'description' => '描述。', - 'type' => 'string', - 'example' => 'description', + 'additionalProperties' => ['description' => '参数的值。', 'type' => 'string', 'example' => 'key:value'], ], + 'Sd' => ['title' => 'sd', 'description' => '存储描述信息。', '$ref' => '#/components/schemas/StorageDescriptorModel'], + 'CreateTime' => ['title' => 'createTime', 'description' => '创建时间。', 'type' => 'string', 'example' => '2023-01-05 13:17:55'], + 'ViewOriginalText' => ['title' => 'viewOriginalText', 'description' => '创建视图时输入的SQL。', 'type' => 'string', 'example' => 'ViewOriginalText'], + 'ViewExpandedText' => ['title' => 'viewExpandedText', 'description' => '对创建视图的SQL进行规范化处理后的结果。', 'type' => 'string', 'example' => 'ViewExpandedText'], + 'Temporary' => ['title' => 'temporary', 'description' => '是否是临时表。', 'type' => 'boolean', 'example' => 'false'], + 'Comment' => ['title' => 'comment', 'description' => '描述。', 'type' => 'string', 'example' => 'description'], 'Cols' => [ 'title' => 'cols', 'description' => '列信息。', 'type' => 'array', - 'items' => [ - 'description' => '列详细信息。', - '$ref' => '#/components/schemas/FieldSchemaModel', - ], + 'items' => ['description' => '列详细信息。', '$ref' => '#/components/schemas/FieldSchemaModel'], ], 'DistributeColumns' => [ 'title' => 'distributeColumns', 'description' => '分布列。', 'type' => 'array', - 'items' => [ - 'description' => '分布列信息', - '$ref' => '#/components/schemas/FieldSchemaModel', - ], - ], - 'PhysicalTableName' => [ - 'title' => 'physicalTableName', - 'description' => '物理表名。', - 'type' => 'string', - 'example' => 'physicalTableName', - ], - 'PhysicalDatabaseName' => [ - 'title' => 'physicalDatabaseName', - 'description' => '物理库名。', - 'type' => 'string', - 'example' => 'physicalDatabaseName', - ], - 'DistributeType' => [ - 'title' => 'distributeType', - 'description' => '分布类型。', - 'type' => 'string', - 'example' => 'DistributeType', - ], - 'PartitionType' => [ - 'title' => 'partitionType', - 'description' => '分区类型。', - 'type' => 'string', - 'example' => 'PartitionType', - ], - 'PartitionColumn' => [ - 'title' => 'partitionColumn', - 'description' => '分区列信息。', - 'type' => 'string', - 'example' => 'colName', - ], - 'PartitionCount' => [ - 'title' => 'partitionCount', - 'description' => '分区数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '16', - ], - 'PreviousVersion' => [ - 'title' => 'previousVersion', - 'description' => '先前版本。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'CurrentVersion' => [ - 'title' => 'currentVersion', - 'description' => '现在版本。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2', - ], - 'UpdateTime' => [ - 'title' => 'updateTime', - 'description' => '更新时间。', - 'type' => 'string', - 'example' => '2023-01-05 13:17:55', - ], - 'TableEngineName' => [ - 'title' => 'tableEngineName', - 'description' => '表引擎名字。', - 'type' => 'string', - 'example' => 'hive', - ], - 'IsAllIndex' => [ - 'title' => 'isAllIndex', - 'description' => '是否是全索引。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'BlockSize' => [ - 'title' => 'blockSize', - 'description' => '块大小。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '64', - ], - 'Compression' => [ - 'title' => 'compression', - 'description' => '压缩方式。', - 'type' => 'string', - 'example' => 'Compression', - ], - 'RawTableName' => [ - 'title' => 'rawTableName', - 'description' => '原始表名。', - 'type' => 'string', - 'example' => 'RawTableName', - ], - 'SubpartitionType' => [ - 'title' => 'subpartitionType', - 'description' => '子分区类型。', - 'type' => 'string', - 'example' => 'SubpartitionColumn', - ], - 'SubpartitionColumn' => [ - 'title' => 'subpartitionColumn', - 'description' => '子分区列信息。', - 'type' => 'string', - 'example' => 'SubpartitionColumn', - ], - 'SubpartitionCount' => [ - 'title' => 'subpartitionCount', - 'description' => '子分区数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '64', - ], - 'ArchiveType' => [ - 'title' => 'archiveType', - 'description' => '存档类型。', - 'type' => 'string', - 'example' => 'ArchiveType', - ], - 'MaxColumnId' => [ - 'title' => 'maxColumnId', - 'description' => '最大列编号。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => 'MaxColumnId', - ], - 'EnableDfs' => [ - 'title' => 'enableDfs', - 'description' => '是否允许DFS。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'StoragePolicy' => [ - 'title' => 'storagePolicy', - 'description' => '存储策略。', - 'type' => 'string', - 'example' => 'StoragePolicy', - ], - 'HotPartitionCount' => [ - 'title' => 'hotPartitionCount', - 'description' => '热分区数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '32', - ], - 'IsFulltextDict' => [ - 'title' => 'isFulltextDict', - 'description' => '是否是全文索引字典。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'RtIndexAll' => [ - 'title' => 'rtIndexAll', - 'description' => '是否路由所有索引。', - 'type' => 'boolean', - 'example' => 'false', - ], + 'items' => ['description' => '分布列信息', '$ref' => '#/components/schemas/FieldSchemaModel'], + ], + 'PhysicalTableName' => ['title' => 'physicalTableName', 'description' => '物理表名。', 'type' => 'string', 'example' => 'physicalTableName'], + 'PhysicalDatabaseName' => ['title' => 'physicalDatabaseName', 'description' => '物理库名。', 'type' => 'string', 'example' => 'physicalDatabaseName'], + 'DistributeType' => ['title' => 'distributeType', 'description' => '分布类型。', 'type' => 'string', 'example' => 'DistributeType'], + 'PartitionType' => ['title' => 'partitionType', 'description' => '分区类型。', 'type' => 'string', 'example' => 'PartitionType'], + 'PartitionColumn' => ['title' => 'partitionColumn', 'description' => '分区列信息。', 'type' => 'string', 'example' => 'colName'], + 'PartitionCount' => ['title' => 'partitionCount', 'description' => '分区数。', 'type' => 'integer', 'format' => 'int64', 'example' => '16'], + 'PreviousVersion' => ['title' => 'previousVersion', 'description' => '先前版本。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'CurrentVersion' => ['title' => 'currentVersion', 'description' => '现在版本。', 'type' => 'integer', 'format' => 'int64', 'example' => '2'], + 'UpdateTime' => ['title' => 'updateTime', 'description' => '更新时间。', 'type' => 'string', 'example' => '2023-01-05 13:17:55'], + 'TableEngineName' => ['title' => 'tableEngineName', 'description' => '表引擎名字。', 'type' => 'string', 'example' => 'hive'], + 'IsAllIndex' => ['title' => 'isAllIndex', 'description' => '是否是全索引。', 'type' => 'boolean', 'example' => 'true'], + 'BlockSize' => ['title' => 'blockSize', 'description' => '块大小。', 'type' => 'integer', 'format' => 'int64', 'example' => '64'], + 'Compression' => ['title' => 'compression', 'description' => '压缩方式。', 'type' => 'string', 'example' => 'Compression'], + 'RawTableName' => ['title' => 'rawTableName', 'description' => '原始表名。', 'type' => 'string', 'example' => 'RawTableName'], + 'SubpartitionType' => ['title' => 'subpartitionType', 'description' => '子分区类型。', 'type' => 'string', 'example' => 'SubpartitionColumn'], + 'SubpartitionColumn' => ['title' => 'subpartitionColumn', 'description' => '子分区列信息。', 'type' => 'string', 'example' => 'SubpartitionColumn'], + 'SubpartitionCount' => ['title' => 'subpartitionCount', 'description' => '子分区数。', 'type' => 'integer', 'format' => 'int64', 'example' => '64'], + 'ArchiveType' => ['title' => 'archiveType', 'description' => '存档类型。', 'type' => 'string', 'example' => 'ArchiveType'], + 'MaxColumnId' => ['title' => 'maxColumnId', 'description' => '最大列编号。', 'type' => 'integer', 'format' => 'int64', 'example' => 'MaxColumnId'], + 'EnableDfs' => ['title' => 'enableDfs', 'description' => '是否允许DFS。', 'type' => 'boolean', 'example' => 'false'], + 'StoragePolicy' => ['title' => 'storagePolicy', 'description' => '存储策略。', 'type' => 'string', 'example' => 'StoragePolicy'], + 'HotPartitionCount' => ['title' => 'hotPartitionCount', 'description' => '热分区数。', 'type' => 'integer', 'format' => 'int64', 'example' => '32'], + 'IsFulltextDict' => ['title' => 'isFulltextDict', 'description' => '是否是全文索引字典。', 'type' => 'boolean', 'example' => 'false'], + 'RtIndexAll' => ['title' => 'rtIndexAll', 'description' => '是否路由所有索引。', 'type' => 'boolean', 'example' => 'false'], 'RouteColumns' => [ 'title' => 'routeColumns', 'description' => '路由列。', 'type' => 'array', - 'items' => [ - 'description' => '路由列信息。', - '$ref' => '#/components/schemas/FieldSchemaModel', - ], - ], - 'RouteEffectiveColumn' => [ - 'title' => 'routeEffectiveColumn', - 'description' => '路由有效列。', - '$ref' => '#/components/schemas/FieldSchemaModel', - ], - 'RtEngineType' => [ - 'title' => 'rtEngineType', - 'description' => '路由引擎类型。', - 'type' => 'string', - 'example' => 'RtEngineType', - ], - 'RtModeType' => [ - 'title' => 'rtModeType', - 'description' => '路由模式类型。', - 'type' => 'string', - 'example' => 'RtModeType', - ], - 'RouteType' => [ - 'title' => 'routeType', - 'description' => '路由类型。', - 'type' => 'string', - 'example' => 'routeType', - ], - 'DictEncode' => [ - 'title' => 'dictEncode', - 'description' => '是否加密。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'BucketCount' => [ - 'title' => 'bucketCount', - 'description' => 'Bucket个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '16', - ], - 'Bucket' => [ - 'title' => 'bucket', - 'description' => 'Bucket编号。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '16', - ], - 'ViewSecurityMode' => [ - 'title' => 'viewSecurityMode', - 'description' => '视图安全模式。', - 'type' => 'string', - 'example' => 'ViewSecurityMode', - ], + 'items' => ['description' => '路由列信息。', '$ref' => '#/components/schemas/FieldSchemaModel'], + ], + 'RouteEffectiveColumn' => ['title' => 'routeEffectiveColumn', 'description' => '路由有效列。', '$ref' => '#/components/schemas/FieldSchemaModel'], + 'RtEngineType' => ['title' => 'rtEngineType', 'description' => '路由引擎类型。', 'type' => 'string', 'example' => 'RtEngineType'], + 'RtModeType' => ['title' => 'rtModeType', 'description' => '路由模式类型。', 'type' => 'string', 'example' => 'RtModeType'], + 'RouteType' => ['title' => 'routeType', 'description' => '路由类型。', 'type' => 'string', 'example' => 'routeType'], + 'DictEncode' => ['title' => 'dictEncode', 'description' => '是否加密。', 'type' => 'boolean', 'example' => 'false'], + 'BucketCount' => ['title' => 'bucketCount', 'description' => 'Bucket个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '16'], + 'Bucket' => ['title' => 'bucket', 'description' => 'Bucket编号。', 'type' => 'integer', 'format' => 'int64', 'example' => '16'], + 'ViewSecurityMode' => ['title' => 'viewSecurityMode', 'description' => '视图安全模式。', 'type' => 'string', 'example' => 'ViewSecurityMode'], 'Indexes' => [ 'title' => 'indexes', 'description' => '索引。', 'type' => 'array', - 'items' => [ - 'description' => '索引列信息。', - '$ref' => '#/components/schemas/CstoreIndexModel', - ], - ], - 'CreatedBySource' => [ - 'type' => 'string', - ], - 'CreatedByUser' => [ - 'type' => 'string', + 'items' => ['description' => '索引列信息。', '$ref' => '#/components/schemas/CstoreIndexModel'], ], + 'CreatedBySource' => ['type' => 'string', 'description' => ''], + 'CreatedByUser' => ['type' => 'string', 'description' => ''], ], ], 'TableSummaryModel' => [ @@ -2062,591 +786,124 @@ 'description' => '表或视图的概要数据。', 'type' => 'object', 'properties' => [ - 'SchemaName' => [ - 'title' => 'db逻辑名', - 'description' => '逻辑库名。', - 'type' => 'string', - 'example' => 'schemaName', - ], - 'TableName' => [ - 'title' => 'table逻辑名', - 'description' => '逻辑表名或逻辑视图名。', - 'type' => 'string', - 'example' => 'tableName', - ], - 'TableType' => [ - 'title' => 'table类型', - 'description' => '表或视图类型。', - 'type' => 'string', - 'example' => 'PHYSICAL_SCHEMA_NAME', - ], - 'TableSize' => [ - 'title' => 'table大小', - 'description' => '表大小，单位为Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1234', - ], - 'CreateTime' => [ - 'title' => '创建时间', - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2023-01-05 13:17:55', - ], - 'UpdateTime' => [ - 'title' => '更新时间', - 'description' => '更新时间。', - 'type' => 'string', - 'example' => '2023-01-05 13:17:55', - ], - 'SQL' => [ - 'title' => 'view SQL', - 'description' => '创建表或视图的SQL。', - 'type' => 'string', - 'example' => 'create table(a varchar)', - ], - 'Description' => [ - 'title' => '描述', - 'description' => '描述。', - 'type' => 'string', - 'example' => 'descrtiption', - ], - 'Owner' => [ - 'title' => '所有者', - 'description' => '所有者。', - 'type' => 'string', - 'example' => 'abc', - ], - 'MvDetailModel' => [ - '$ref' => '#/components/schemas/open_struct_MvDetailModel', - ], - 'CreatedBySource' => [ - 'type' => 'string', - ], - 'CreatedByUser' => [ - 'type' => 'string', - ], - ], - ], - 'open_struct_MVRecommendResultModel' => [ - 'description' => '物化视图推荐结果详细信息', - 'type' => 'object', - 'properties' => [ - 'BaseTables' => [ - 'description' => '子查询关联的基表。', - 'type' => 'array', - 'items' => [ - 'description' => '基表详细信息。', - '$ref' => '#/components/schemas/open_struct_MvBaseTableDetailModel', - ], - ], - 'AcceleratedQueriesCount' => [ - 'description' => '成功加速的查询数量。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '32', - ], - 'SupportIncrementalRefresh' => [ - 'description' => '当前子查询是否支持增量刷新。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'SubqueryId' => [ - 'description' => '子查询ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'SavedScanbytes' => [ - 'description' => '当前MV从关联父查询，后验测算出来可以节约扫描的字节数量。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '321321223', - ], - 'Subquery' => [ - 'description' => '提取出来的公共子查询。', - 'type' => 'string', - 'example' => 'SELECT * FROM demo.tbl', - ], - ], - ], - 'open_struct_MvBaseTableDetailModel' => [ - 'description' => '物化视图基表详细信息。', - 'type' => 'object', - 'properties' => [ - 'TableName' => [ - 'description' => '表名。', - 'type' => 'string', - 'example' => 'test', - ], - 'DataVolumn' => [ - 'description' => '数据量。', - 'type' => 'string', - 'example' => '321233', - ], - 'EnableBinlog' => [ - 'description' => '表是否开启binlog。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'SchemaName' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - ], - ], - 'open_struct_MvDetailModel' => [ - 'description' => '物化视图概要数据。', - 'type' => 'object', - 'properties' => [ - 'FirstRefreshTime' => [ - 'description' => '首次刷新时间。', - 'type' => 'string', - 'example' => '2025-01-01 09:00:00', - ], - 'QueryRewriteEnabled' => [ - 'description' => '当前物化视图是否启用查询改写。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'ExplicitHit' => [ - 'description' => '最近7天，显式query命中的总次数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '5', - ], - 'IsInactive' => [ - 'description' => '探测到当前物化视图距离第一次创建时间大于30天，且没有被访问过（包括显式查询和隐式查询）。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'RemoteSize' => [ - 'description' => '物化视图占用冷数据磁盘空间（单位bytes）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1234', - ], - 'LocalSize' => [ - 'description' => '物化视图占用热数据磁盘空间（单位bytes）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1234', - ], - 'RefreshState' => [ - 'description' => '物化视图刷新模型。', - 'type' => 'string', - 'example' => 'FAST', - ], - 'RefreshInterval' => [ - 'description' => '刷新时间间隔。', - 'type' => 'string', - 'example' => '(now() + INTERVAL \'10\' SECOND)', - ], - 'ImplicitHit' => [ - 'description' => '最近7天，隐式query命中的总次数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', - ], - 'UpdatedAt' => [ - 'description' => '最近一次刷新的时间。', - 'type' => 'string', - 'example' => '2025-01-01 10:00:00', - ], - 'ResourceGroup' => [ - 'description' => '刷新所依赖的资源组。', - 'type' => 'string', - 'example' => 'user_default', - ], - 'BaseTableInfos' => [ - 'description' => '当前物化视图所有直接父基表。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'SchemaName' => [ - 'description' => '库名。', - 'type' => 'string', - 'example' => 'test_db', - ], - 'TableName' => [ - 'description' => '表名。', - 'type' => 'string', - 'example' => 'test_tbl', - ], - 'BaseTableIsMv' => [ - 'description' => '基表是否为一个物化视图。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'TableEngine' => [ - 'description' => '表引擎。', - 'type' => 'string', - 'example' => 'XUANWU', - ], - ], - ], - ], - 'TableEngine' => [ - 'description' => '表引擎。', - 'type' => 'string', - 'example' => 'XUANWU', - ], - 'BaseTableNames' => [ - 'description' => '当前物化视图所有直接父基表。', - 'type' => 'array', - 'items' => [ - 'description' => '基表的库名和表名。', - 'type' => 'array', - 'items' => [ - 'description' => '库名或表名。', - 'type' => 'string', - 'example' => 't1', - ], - ], - ], - 'EnableDelayAlert' => [ - 'description' => '开启刷新延迟告警。取值如下：'."\n" - ."\n" - .'- true：是。'."\n" - .'- false：否。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => 'false', - ], - 'EnableFailureAlert' => [ - 'description' => '开启刷新任务失败告警。取值如下：'."\n" - ."\n" - .'- true：是。 '."\n" - .'- false：否。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => 'false', - ], - 'LatencyTolerance' => [ - 'description' => '刷新延迟容忍度（分钟）。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - ], - ], - 'open_struct_MvRecommendSubTaskModel' => [ - 'description' => '物化视图推荐任务执行详情。', - 'type' => 'object', - 'properties' => [ - 'SubQueriesCount' => [ - 'description' => '生成的新增MV建议数量。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '70', - ], - 'Status' => [ - 'description' => '当前运行的状态。', - 'type' => 'string', - 'example' => 'RUNNING', - ], - 'EndTime' => [ - 'description' => '任务结束时间。', - 'type' => 'string', - 'example' => '2025-10-16 16:56'."\n", - ], - 'StartTime' => [ - 'description' => '任务开始时间。', - 'type' => 'string', - 'example' => '2025-10-16 16:55'."\n", - ], - 'SubtaskId' => [ - 'description' => '任务执行的记录ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'ScanQueriesCount' => [ - 'description' => '扫描的查询数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '55', - ], - 'MinRewriteQueryCount' => [ - 'description' => 'Pattern匹配的最少慢查询个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '3', - ], - 'MinRewriteQueryPattern' => [ - 'description' => '最小可加速的Pattern数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'SlowQueryThreshold' => [ - 'description' => '慢查询阈值。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - ], - ], - 'open_struct_MvRecommendTaskModel' => [ - 'description' => '物化视图推荐任务详细信息', - 'type' => 'object', - 'properties' => [ - 'Description' => [ - 'description' => '描述。', - 'type' => 'string', - 'example' => 'task desc'."\n", - ], - 'CreatedTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2024-12-12 23:59', - ], - 'LastRunAt' => [ - 'description' => '最近一次运行时间。', - 'type' => 'string', - 'example' => '2024-12-13 00:10', - ], - 'TaskName' => [ - 'description' => '推荐任务名称。', - 'type' => 'string', - 'example' => 'mv_task1', - ], - 'ScanQueriesRange' => [ - 'description' => '扫描的时间范围，单位天，默认取值3。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '3', - ], - 'SchedulingSettings' => [ - 'description' => '任务的例行运行设置。', - 'type' => 'string', - 'example' => 'The 12:30 every day', - ], - 'MinRewriteQueryCount' => [ - 'description' => 'Pattern匹配的最少慢查询个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '3', - ], - 'MinRewriteQueryPattern' => [ - 'description' => '最小可加速的Pattern数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'SlowQueryThreshold' => [ - 'description' => '慢查询阈值。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - ], - ], - 'open_struct_RefreshJobModel' => [ - 'description' => '刷新任务详细信息。', - 'type' => 'object', - 'properties' => [ - 'Status' => [ - 'description' => '本次刷新任务的状态。', - 'type' => 'string', - 'example' => 'RUNNING', - ], - 'EndTime' => [ - 'description' => '刷新任务结束时间。', - 'type' => 'string', - 'example' => '2025-01-15 10:12:00', - ], - 'RefreshModel' => [ - 'description' => '刷新方式。'."\n" - .'- FAST'."\n" - .'- COMPLETE', - 'type' => 'string', - 'example' => 'FAST', - ], - 'StartTime' => [ - 'description' => '实际开始时间。', - 'type' => 'string', - 'example' => '2025-01-15 10:11:00', - ], - 'RefreshInterval' => [ - 'description' => '刷新时间间隔。', - 'type' => 'string', - 'example' => '30s', - ], - 'Processid' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => '2025103010xxxxxxx', - ], - 'ScheduledStartTime' => [ - 'description' => '计划开始时间。', - 'type' => 'string', - 'example' => '2025-01-15 10:11:00'."\n", - ], - 'SchemaName' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - 'ResourceGroup' => [ - 'description' => '刷新所依赖的资源组。', - 'type' => 'string', - 'example' => 'user_default', - ], - 'Name' => [ - 'description' => '物化视图名称。', - 'type' => 'string', - 'example' => 'demo_mv', - ], + 'SchemaName' => ['title' => 'db逻辑名', 'description' => '逻辑库名。', 'type' => 'string', 'example' => 'schemaName'], + 'TableName' => ['title' => 'table逻辑名', 'description' => '逻辑表名或逻辑视图名。', 'type' => 'string', 'example' => 'tableName'], + 'TableType' => ['title' => 'table类型', 'description' => '表或视图类型。', 'type' => 'string', 'example' => 'PHYSICAL_SCHEMA_NAME'], + 'TableSize' => ['title' => 'table大小', 'description' => '表大小，单位为Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1234'], + 'CreateTime' => ['title' => '创建时间', 'description' => '创建时间。', 'type' => 'string', 'example' => '2023-01-05 13:17:55'], + 'UpdateTime' => ['title' => '更新时间', 'description' => '更新时间。', 'type' => 'string', 'example' => '2023-01-05 13:17:55'], + 'SQL' => ['title' => 'view SQL', 'description' => '创建表或视图的SQL。', 'type' => 'string', 'example' => 'create table(a varchar)'], + 'Description' => ['title' => '描述', 'description' => '描述。', 'type' => 'string', 'example' => 'descrtiption'], + 'Owner' => ['title' => '所有者', 'description' => '所有者。', 'type' => 'string', 'example' => 'abc'], + 'MvDetailModel' => ['$ref' => '#/components/schemas/open_struct_MvDetailModel', 'description' => ''], + 'CreatedBySource' => ['type' => 'string', 'description' => ''], + 'CreatedByUser' => ['type' => 'string', 'description' => ''], ], ], ], ], 'apis' => [ - 'DescribeRegions' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'AllocateClusterPublicConnection' => [ + 'summary' => '为集群申请公网连接地址。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', - 'abilityTreeCode' => '154593', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '131191', + 'abilityTreeNodes' => ['FEATUREads4DZDZG'], ], 'parameters' => [ [ - 'name' => 'AcceptLanguage', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '地域名称和可用区名称（即返回数据中LocalName）返回值所使用的语言，取值说明：'."\n" - .'- **zh-CN**：简体中文（默认语言）。'."\n" - .'- **en-US**：英文。'."\n" - .'- **ja**：日文。', - 'type' => 'string', - 'required' => false, - 'example' => 'en-US', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1z5d2q71is2****'], ], [ - 'name' => 'RegionId', + 'name' => 'ConnectionStringPrefix', + 'in' => 'query', + 'schema' => ['description' => '定义公网连接地址的前缀。'."\n" + .'- 以小写字母开头，可包含小写字母、数字和中划线（-）；'."\n" + .'- 长度不超过30个字符。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'test12'], + ], + [ + 'name' => 'Engine', 'in' => 'query', 'schema' => [ + 'description' => '数据库引擎，取值：'."\n" + ."\n" + .'- **AnalyticDB**（默认）：AnalyticDB for MySQL引擎。'."\n" + .'- **Clickhouse**：宽表引擎。', 'type' => 'string', 'required' => false, + 'enumValueTitles' => ['AnalyticDB' => 'AnalyticDB', 'Clickhouse' => 'Clickhouse'], + 'example' => 'Clickhouse', ], ], + [ + 'name' => 'ResourceGroupName', + 'in' => 'query', + 'schema' => ['type' => 'string'], + ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '421794A3-72A5-5D27-9E8B-A75A4C503E17', - ], - 'Regions' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Region' => [ - 'description' => '地域信息列表。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'RegionEndpoint' => [ - 'description' => '地域对应的接入地址。', - 'type' => 'string', - 'example' => 'adb.aliyuncs.com', - ], - 'LocalName' => [ - 'description' => '地域名称。', - 'type' => 'string', - 'example' => 'China (Hangzhou)', - ], - 'RegionId' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'Zones' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Zone' => [ - 'description' => '可用区列表。', - 'type' => 'array', - 'items' => [ - 'description' => '可用区列表。', - 'type' => 'object', - 'properties' => [ - 'ZoneId' => [ - 'description' => '可用区ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou-h', - ], - 'VpcEnabled' => [ - 'description' => '目标可用区是否支持VPC，取值说明：'."\n" - .'- **true**：支持。'."\n" - .'- **false**：不支持。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'LocalName' => [ - 'description' => '可用区名称。', - 'type' => 'string', - 'example' => 'Hangzhou Zone H', - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '868EF07F-D0B2-5043-B092-0C14CD00B65A'], ], + 'description' => '', ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidConnectionStringPrefix.Malformed', 'errorMessage' => 'The specified connection string is invalid.', 'description' => '连接地址无效'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'ACS.InvalidParameter.%s', 'errorMessage' => 'Parameter %s is invalid.', 'description' => '输入的参数无效'], + ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"421794A3-72A5-5D27-9E8B-A75A4C503E17\\",\\n \\"Regions\\": {\\n \\"Region\\": [\\n {\\n \\"RegionEndpoint\\": \\"adb.aliyuncs.com\\",\\n \\"LocalName\\": \\"China (Hangzhou)\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"Zones\\": {\\n \\"Zone\\": [\\n {\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"VpcEnabled\\": true,\\n \\"LocalName\\": \\"Hangzhou Zone H\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeRegionsResponse>\\n <RequestId>421794A3-72A5-5D27-9E8B-A75A4C503E17</RequestId>\\n <Regions>\\n <RegionEndpoint>adb.aliyuncs.com</RegionEndpoint>\\n <LocalName>China (Hangzhou)</LocalName>\\n <RegionId>cn-hangzhou</RegionId>\\n <Zones>\\n <ZoneId>cn-hangzhou-h</ZoneId>\\n <VpcEnabled>true</VpcEnabled>\\n <LocalName>Hangzhou Zone H</LocalName>\\n </Zones>\\n </Regions>\\n</DescribeRegionsResponse>","errorExample":""}]', - 'title' => '查询地域和可用区', - 'summary' => '查询AnalyticDB MySQL湖仓版支持的地域和可用区。', + 'title' => '申请公网地址', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeDBClusters' => [ - 'summary' => '查看目标地域下的湖仓版集群列表信息。', - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2024-06-13T13:53:52.000Z', 'description' => '错误码发生变更、请求参数发生变更'], + ['createdAt' => '2023-03-31T07:03:59.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:51:57.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'AllocateClusterPublicConnection'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:AllocateClusterPublicConnection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"868EF07F-D0B2-5043-B092-0C14CD00B65A\\"\\n}","errorExample":""},{"type":"xml","example":"<AllocateClusterPublicConnectionResponse>\\n <RequestId>868EF07F-D0B2-5043-B092-0C14CD00B65A</RequestId>\\n</AllocateClusterPublicConnectionResponse>","errorExample":""}]', + ], + 'ApplyAdviceById' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2655,173 +912,122 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '130697', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'abilityTreeCode' => '193679', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-uf6g8w25jacm7****'], ], [ - 'name' => 'DBClusterIds', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '湖仓版集群ID。'."\n" - ."\n" - .'此参数不填写时，默认返回该地域中所有集群的信息。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-bp1r053byu48p****', - ], + 'schema' => ['title' => 'regionId', 'description' => '地域 ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DBClusterDescription', + 'name' => 'AdviceId', 'in' => 'query', - 'schema' => [ - 'description' => '集群描述。'."\n" - .'- 不能以`http://`或者`https://`开头。'."\n" - .'- 长度为2~256个字符。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['title' => 'AdviceId', 'description' => '建议 ID。', 'type' => 'string', 'required' => false, 'example' => '0baf1f52-53df-487f-8292-99a03716****'], ], [ - 'name' => 'DBClusterStatus', + 'name' => 'AdviceDate', 'in' => 'query', - 'schema' => [ - 'description' => '集群状态，取值说明：'."\n" - .'- **Preparing**：准备中。'."\n" - .'- **Creating**：创建中。'."\n" - .'- **Running**：运行中。'."\n" - .'- **Deleting**：删除中。'."\n" - .'- **Restoring**：备份恢复中。'."\n" - .'- **ClassChanging**：变配中。'."\n" - .'- **NetAddressCreating**：创建网络中。'."\n" - .'- **NetAddressDeleting**：删除网络中。'."\n" - .'- **NetAddressModifying**：修改网络中。', - 'type' => 'string', - 'required' => false, - 'example' => 'Running', - ], + 'schema' => ['title' => 'AdviceDate', 'description' => '建议生成的日期。格式：yyyyMMdd', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '20221101'], ], [ - 'name' => 'PageSize', + 'name' => 'ApplyType', 'in' => 'query', 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int32', + 'description' => '采纳类型。', + 'type' => 'string', 'required' => false, - 'example' => '30', - 'default' => '30', + 'enumValueTitles' => ['DROP_INDEX' => 'DROP_INDEX', 'DISABLE_INDEX' => 'DISABLE_INDEX', 'ADD_INDEX' => 'ADD_INDEX'], + 'example' => 'DROP_INDEX', ], ], [ - 'name' => 'PageNumber', + 'name' => 'BuildImmediately', 'in' => 'query', 'schema' => [ - 'description' => '页码，取值为大于0且不超过Integer数据类型的正整数。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int32', + 'description' => '是否立即启动build任务。', + 'type' => 'boolean', 'required' => false, - 'example' => '1', - 'default' => '1', + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], + 'example' => 'true', ], ], - [ - 'name' => 'ResourceGroupId', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '资源组ID。'."\n" - .'此参数不填写时，默认返回集群中所有资源组信息。', - 'type' => 'string', - 'required' => false, - 'example' => 'rg-4690g37929****', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求id。', 'type' => 'string', 'example' => '5DC10091-348D-12B1-906D-AB49D658012E'], + ], ], ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '应用单条优化建议', + 'summary' => '应用单条优化建议。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2025-07-09T06:38:11.000Z', 'description' => '请求参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ApplyAdviceById'], + ], + ], + 'ramActions' => [ [ - 'name' => 'Tag', - 'in' => 'query', - 'style' => 'repeatList', - 'schema' => [ - 'description' => '集群的标签信息。', - 'type' => 'array', - 'items' => [ - 'description' => '集群标签信息。', - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => '集群的标签键。', - 'type' => 'string', - 'required' => false, - 'example' => 'tag1', - ], - 'Value' => [ - 'description' => '集群的标签值。', - 'type' => 'string', - 'required' => false, - 'example' => 'test1', - ], - ], - 'required' => false, + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ApplyAdviceById', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], - 'required' => false, - 'maxItems' => 21, ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"5DC10091-348D-12B1-906D-AB49D658012E\\"\\n}","type":"json"}]', + ], + 'AttachUserENI' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'ProductVersion', - 'in' => 'query', - 'schema' => [ - 'description' => '产品版本：'."\n" - .'- **EnterpriseVersion**：企业版。'."\n" - .'- **BasicVersion**：基础版。'."\n" - .'> 选填参数，不填时默认返回全部集群。', - 'type' => 'string', - 'required' => false, - 'example' => 'BasicVersion', - 'enum' => [ - 'EnterpriseVersion', - 'BasicVersion', - ], - ], + 'AK' => [], ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREadsPOF80W'], + ], + 'parameters' => [ [ - 'name' => 'DBClusterVersion', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群版本'."\n" - .'- **3.0**：数仓版。'."\n" - .'- **5.0**（默认值）：包括湖仓版、企业版和基础版。'."\n" - .'- **All**：所有版本，包括数仓版、湖仓版、企业版和基础版。', - 'type' => 'string', - 'required' => false, - 'example' => '5.0', - 'default' => '5.0', - 'enum' => [ - 'All', - '3.0', - '5.0', - ], - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-bp11q28kvl688****'], ], ], 'responses' => [ @@ -2829,826 +1035,349 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A5EDBA27-AF3E-5966-9503-FD1557E19167', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'Items' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'DBCluster' => [ - 'description' => '列表详情。', - 'type' => 'array', - 'items' => [ - 'description' => '集群列表。', - 'type' => 'object', - 'properties' => [ - 'Expired' => [ - 'description' => '包年包月集群是否过期。取值说明：'."\n" - .'* **true**：已过期。'."\n" - .'* **false**：未过期。'."\n" - ."\n" - .'> - 如果集群已过期，在一定时间内集群会被锁定甚至释放。建议您进行续费操作，详情请参见[续费说明](~~135246~~)。'."\n" - .'- 按量付费集群不返回此参数。', - 'type' => 'string', - 'example' => 'false', - ], - 'CreateTime' => [ - 'description' => '集群创建时间。UTC时间，格式为<i>yyyy-mm-ddThh:mm:ssZ</i>。', - 'type' => 'string', - 'example' => '2022-04-01T09:50:18Z', - ], - 'PayType' => [ - 'description' => '集群付费类型，取值说明：'."\n" - .'* **Postpaid**：按量付费。'."\n" - .'* **Prepaid**：包年包月。', - 'type' => 'string', - 'example' => 'Prepaid', - ], - 'Mode' => [ - 'description' => '集群模式。默认返回**flexible**，表示弹性模式集群。', - 'type' => 'string', - 'example' => 'flexible', - ], - 'Port' => [ - 'description' => '集群端口号。', - 'type' => 'string', - 'example' => '3306', - ], - 'LockMode' => [ - 'description' => '集群的锁定状态，取值说明： '."\n" - .'- **Unlock**：未锁定。 '."\n" - .'- **ManualLock**：手动触发锁定。 '."\n" - .'- **LockByExpiration**：集群过期自动锁定。', - 'type' => 'string', - 'example' => 'Unlock', - ], - 'StorageResource' => [ - 'description' => '存储预留资源规格。1 ACU约等于1核4 GB。存储资源用于数据读写，增加该资源能提高集群读写能力。', - 'type' => 'string', - 'example' => '24ACU', - ], - 'DBClusterId' => [ - 'description' => '湖仓版集群ID。', - 'type' => 'string', - 'example' => 'amv-bp163885f8q21****', - ], - 'ConnectionString' => [ - 'description' => '集群的公网连接地址。', - 'type' => 'string', - 'example' => 'amv-bp163885f8q21****.ads.aliyuncs.com', - ], - 'DBClusterType' => [ - 'description' => '集群类型。默认返回**Common**，表示常规集群。', - 'type' => 'string', - 'example' => 'Common', - ], - 'CommodityCode' => [ - 'description' => '商品付费类型，取值说明：'."\n" - .'- **ads**：按量付费商品。'."\n" - .'- **ads_pre**：包年包月商品。', - 'type' => 'string', - 'example' => 'ads_pre', - ], - 'ExpireTime' => [ - 'description' => '集群到期时间，UTC时间，格式为<i>yyyy-MM-ddTHH:mm:ssZ</i>。'."\n" - ."\n" - .'> * 若集群付费类型为包年包月，则返回实际到期时间。'."\n" - .'* 若集群付费类型为按量付费，则返回为空。'."\n", - 'type' => 'string', - 'example' => '2022-07-01T09:50:18Z', - ], - 'LockReason' => [ - 'description' => '集群锁定原因。'."\n" - .'> 仅当集群被锁定时会返回该参数，固定为**instance_expire**。', - 'type' => 'string', - 'example' => 'instance_expired', - ], - 'VPCId' => [ - 'description' => '专有网络（VPC）ID。', - 'type' => 'string', - 'example' => 'vpc-bp13h7uzhulpuxvnp****', - ], - 'RegionId' => [ - 'description' => '集群所在的地域ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'ComputeResource' => [ - 'description' => '计算预留资源规格。1 ACU约等于1核4 GB。计算资源用于数据计算，增加计算资源能加快查询速度，可以根据集群实际性能按需弹性扩缩。', - 'type' => 'string', - 'example' => '16ACU', - ], - 'VSwitchId' => [ - 'description' => '交换机ID。', - 'type' => 'string', - 'example' => 'vsw-bp1syh8vvw8yech7n****', - ], - 'DBVersion' => [ - 'description' => '数据库版本，当前仅支持**5.0**版本。', - 'type' => 'string', - 'example' => '5.0', - ], - 'DBClusterStatus' => [ - 'description' => '集群状态，取值说明：'."\n" - .'- **Preparing**：准备中。'."\n" - .'- **Creating**：创建中。'."\n" - .'- **Running**：运行中。'."\n" - .'- **Deleting**：删除中。'."\n" - .'- **Restoring**：备份恢复中。'."\n" - .'- **ClassChanging**：变配中。'."\n" - .'- **NetAddressCreating**：创建网络中。'."\n" - .'- **NetAddressDeleting**：删除网络中。'."\n" - .'- **NetAddressModifying**：修改网络中。', - 'type' => 'string', - 'example' => 'Running', - ], - 'ResourceGroupId' => [ - 'description' => '资源组ID。', - 'type' => 'string', - 'example' => 'rg-acfmyiu4ekp****', - ], - 'DBClusterNetworkType' => [ - 'description' => '集群网络类型。仅支持**VPC**（专有网络）类型。', - 'type' => 'string', - 'example' => 'VPC', - 'default' => 'VPC', - ], - 'DBClusterDescription' => [ - 'description' => '集群的描述信息。', - 'type' => 'string', - 'example' => 'adb_test', - ], - 'ZoneId' => [ - 'description' => '集群所在的可用区ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou-h', - ], - 'Engine' => [ - 'description' => '集群引擎，固定为**AnalyticDB**。', - 'type' => 'string', - 'example' => 'AnalyticDB', - ], - 'ReservedACU' => [ - 'description' => '集群剩余可分配计算预留资源。1 ACU约等于1核4 GB。', - 'type' => 'string', - 'example' => '32ACU', - ], - 'Tags' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Tag' => [ - 'description' => '标签列表。', - 'type' => 'array', - 'items' => [ - 'description' => '标签列表。', - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => '标签键。'."\n" - .'> 您可以调用[TagResources](~~179253~~)接口为目标集群创建标签。', - 'type' => 'string', - 'example' => 'tag1', - ], - 'Value' => [ - 'description' => '标签值。', - 'type' => 'string', - 'example' => 'test1', - ], - ], - ], - ], - ], - ], - 'Category' => [ - 'description' => '产品系列，仅在实例为数仓版时该值有意义，取值说明：'."\n" - .'- **BASIC**：预留模式基础版。'."\n" - .'- **CLUSTER**：预留模式集群版。'."\n" - .'- **MIXED_STORAGE**：弹性模式集群版（新版）。'."\n" - .'> 更多关于集群系列的介绍，请参见[产品系列](~~205001~~)。', - 'type' => 'string', - 'example' => 'MIXED_STORAGE', - ], - 'InnerPort' => [ - 'description' => '集群的内网连接端口。', - 'type' => 'string', - 'example' => '3306', - ], - 'VPCCloudInstanceId' => [ - 'description' => '内网连接地址。', - 'type' => 'string', - 'example' => 'am-bp163885f8q21****-controller', - ], - 'InnerIp' => [ - 'description' => '集群内网IP地址。', - 'type' => 'string', - 'example' => '10.1.xx.xx', - ], - 'DtsJobId' => [ - 'description' => 'DTS同步任务ID。仅MySQL分析实例会返回该参数。<props="china"><ph>更多详情，请参见[MySQL分析实例简介](~~154779~~)。</ph></props>'."\n", - 'type' => 'string', - 'example' => 'dtsb1578j90XXXX', - ], - 'ElasticIOResource' => [ - 'description' => '弹性IO资源（Elastic IO Unit，简称EIU），更多详情，请参见[EIU详解](~~189505~~)。'."\n" - .'> 仅弹性模式集群会返回该参数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'RdsInstanceId' => [ - 'description' => '同步源RDS实例ID。仅MySQL分析实例会返回该参数。<props="china"><ph>更多详情，请参见[MySQL分析实例简介](~~154779~~)。</ph></props>', - 'type' => 'string', - 'example' => 'rm-bp11q28kvl688****', - ], - 'ExecutorCount' => [ - 'description' => '弹性模式下集群使用的计算节点数量。', - 'type' => 'string', - 'example' => '1', - ], - 'DBNodeClass' => [ - 'description' => '节点规格，仅在实例为数仓版时该值有意义。', - 'type' => 'string', - 'example' => 'E8', - ], - 'DiskType' => [ - 'description' => '集群的磁盘类型，取值说明：'."\n" - .'- **local_ssd**：本地磁盘。'."\n" - .'- **cloud**：普通云盘。'."\n" - .'- **cloud_ssd**：SSD云盘。'."\n" - .'- **cloud_efficiency**：高效云盘。'."\n" - .'- **cloud_essd**：PL1等级的ESSD云盘。'."\n" - .'- **cloud_essd2**：PL2 等级的ESSD云盘。'."\n" - .'- **cloud_essd3**：PL3 等级的ESSD云盘。'."\n" - .'> 更多关于ESSD云盘的详情，请参见[ESSD云盘规格](~~122389~~)。', - 'type' => 'string', - 'example' => 'cloud_essd', - ], - 'DBNodeStorage' => [ - 'description' => '集群的存储空间，单位：GB。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '300', - ], - 'DBNodeCount' => [ - 'description' => '节点组个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2', - ], - 'TaskInfo' => [ - 'description' => '任务进度信息。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '任务名称。', - 'type' => 'string', - 'example' => 'analyticDBFlexibleScaleOut', - ], - 'Status' => [ - 'description' => '任务状态，取值为：'."\n" - .'- **NOT_RUN**：等待运行。'."\n" - .'- **RUNNING**：运行中。'."\n" - .'- **SUCCEED**：已结束。', - 'type' => 'string', - 'example' => 'RUNNING', - 'enum' => [ - 'RUNNING', - 'SUCCEED', - 'NOT_RUN', - ], - ], - 'Progress' => [ - 'description' => '任务进度，单位：%。', - 'type' => 'string', - 'example' => '10%', - ], - 'StepList' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'StepList' => [ - 'description' => '任务步骤。', - 'type' => 'array', - 'items' => [ - 'description' => '任务步骤。', - 'type' => 'object', - 'properties' => [ - 'StepName' => [ - 'description' => '步骤名称。', - 'type' => 'string', - 'example' => 'ApplyResource', - ], - 'StepDesc' => [ - 'description' => '步骤描述。', - 'type' => 'string', - 'example' => 'Apply resource', - ], - 'StepStatus' => [ - 'description' => '步骤状态，取值为：'."\n" - .'- **NOT_RUN**：等待运行。'."\n" - .'- **RUNNING**：运行中。'."\n" - .'- **SUCCEED**：已结束。', - 'type' => 'string', - 'example' => 'SUCCEED', - 'enum' => [ - 'RUNNING', - 'SUCCEED', - 'NOT_RUN', - ], - ], - 'StepProgress' => [ - 'description' => '步骤进度，单位：%。', - 'type' => 'string', - 'example' => '50%', - ], - 'StartTime' => [ - 'description' => '步骤开始时间，格式为 YYYY-MM-DDThh:mm:ssZ。', - 'type' => 'string', - 'example' => '2024-03-10T09:28:34Z', - ], - 'EndTime' => [ - 'description' => '步骤结束时间，格式为 YYYY-MM-DDThh:mm:ssZ。', - 'type' => 'string', - 'example' => '2024-03-10T10:28:34Z', - ], - ], - ], - ], - ], - ], - ], - ], - 'ProductForm' => [ - 'description' => '产品形态枚举：'."\n" - .'- **LegacyForm**: 传统形态。'."\n" - .'- **IntegrationForm**：融合形态。', - 'type' => 'string', - 'example' => 'IntegrationForm', - 'enum' => [ - 'IntegrationForm', - 'LegacyForm', - ], - ], - 'ProductVersion' => [ - 'description' => '产品版本。取值为：'."\n" - .'- **BasicVersion**：基础版。'."\n" - .'- **EnterpriseVersion**：企业版。', - 'type' => 'string', - 'example' => 'EnterpriseVersion', - ], - 'ReservedNodeSize' => [ - 'description' => '预留资源单节点规格。', - 'type' => 'string', - 'example' => '8ACU', - ], - 'ReservedNodeCount' => [ - 'description' => '预留资源节点数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'AINodeSpec' => [ - 'type' => 'string', - ], - 'AINodeNumber' => [ - 'type' => 'integer', - 'format' => 'int32', - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], ], + 'description' => '', ], ], ], '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' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"A5EDBA27-AF3E-5966-9503-FD1557E19167\\",\\n \\"PageNumber\\": 1,\\n \\"Items\\": {\\n \\"DBCluster\\": [\\n {\\n \\"Expired\\": \\"false\\",\\n \\"CreateTime\\": \\"2022-04-01T09:50:18Z\\",\\n \\"PayType\\": \\"Prepaid\\",\\n \\"Mode\\": \\"flexible\\",\\n \\"Port\\": \\"3306\\",\\n \\"LockMode\\": \\"Unlock\\",\\n \\"StorageResource\\": \\"24ACU\\",\\n \\"DBClusterId\\": \\"amv-bp163885f8q21****\\",\\n \\"ConnectionString\\": \\"amv-bp163885f8q21****.ads.aliyuncs.com\\",\\n \\"DBClusterType\\": \\"Common\\",\\n \\"CommodityCode\\": \\"ads_pre\\",\\n \\"ExpireTime\\": \\"2022-07-01T09:50:18Z\\",\\n \\"LockReason\\": \\"instance_expired\\",\\n \\"VPCId\\": \\"vpc-bp13h7uzhulpuxvnp****\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"ComputeResource\\": \\"16ACU\\",\\n \\"VSwitchId\\": \\"vsw-bp1syh8vvw8yech7n****\\",\\n \\"DBVersion\\": \\"5.0\\",\\n \\"DBClusterStatus\\": \\"Running\\",\\n \\"ResourceGroupId\\": \\"rg-acfmyiu4ekp****\\",\\n \\"DBClusterNetworkType\\": \\"VPC\\",\\n \\"DBClusterDescription\\": \\"adb_test\\",\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"Engine\\": \\"AnalyticDB\\",\\n \\"ReservedACU\\": \\"32ACU\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"Key\\": \\"tag1\\",\\n \\"Value\\": \\"test1\\"\\n }\\n ]\\n },\\n \\"Category\\": \\"MIXED_STORAGE\\",\\n \\"InnerPort\\": \\"3306\\",\\n \\"VPCCloudInstanceId\\": \\"am-bp163885f8q21****-controller\\",\\n \\"InnerIp\\": \\"10.1.xx.xx\\",\\n \\"DtsJobId\\": \\"dtsb1578j90XXXX\\",\\n \\"ElasticIOResource\\": 2,\\n \\"RdsInstanceId\\": \\"rm-bp11q28kvl688****\\",\\n \\"ExecutorCount\\": \\"1\\",\\n \\"DBNodeClass\\": \\"E8\\",\\n \\"DiskType\\": \\"cloud_essd\\",\\n \\"DBNodeStorage\\": 300,\\n \\"DBNodeCount\\": 2,\\n \\"TaskInfo\\": {\\n \\"Name\\": \\"analyticDBFlexibleScaleOut\\",\\n \\"Status\\": \\"RUNNING\\",\\n \\"Progress\\": \\"10%\\",\\n \\"StepList\\": {\\n \\"StepList\\": [\\n {\\n \\"StepName\\": \\"ApplyResource\\",\\n \\"StepDesc\\": \\"Apply resource\\",\\n \\"StepStatus\\": \\"SUCCEED\\",\\n \\"StepProgress\\": \\"50%\\",\\n \\"StartTime\\": \\"2024-03-10T09:28:34Z\\",\\n \\"EndTime\\": \\"2024-03-10T10:28:34Z\\"\\n }\\n ]\\n }\\n },\\n \\"ProductForm\\": \\"IntegrationForm\\",\\n \\"ProductVersion\\": \\"EnterpriseVersion\\",\\n \\"ReservedNodeSize\\": \\"8ACU\\",\\n \\"ReservedNodeCount\\": 1,\\n \\"AINodeSpec\\": \\"\\",\\n \\"AINodeNumber\\": 0\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeDBClustersResponse>\\n <TotalCount>1</TotalCount>\\n <PageSize>30</PageSize>\\n <RequestId>A5EDBA27-AF3E-5966-9503-FD1557E19167</RequestId>\\n <PageNumber>1</PageNumber>\\n <Items>\\n <Expired>false</Expired>\\n <CreateTime>2022-04-01T09:50:18Z</CreateTime>\\n <PayType>Prepaid</PayType>\\n <Mode>flexible</Mode>\\n <Port>3306</Port>\\n <LockMode>Unlock</LockMode>\\n <StorageResource>24ACU</StorageResource>\\n <DBClusterId>amv-bp163885f8q21****</DBClusterId>\\n <ConnectionString>amv-bp163885f8q21****.ads.aliyuncs.com</ConnectionString>\\n <DBClusterType>Common</DBClusterType>\\n <CommodityCode>ads_pre</CommodityCode>\\n <ExpireTime>2022-07-01T09:50:18Z</ExpireTime>\\n <LockReason>instance_expired</LockReason>\\n <VPCId>vpc-bp13h7uzhulpuxvnp****</VPCId>\\n <RegionId>cn-hangzhou</RegionId>\\n <ComputeResource>16ACU</ComputeResource>\\n <VSwitchId>vsw-bp1syh8vvw8yech7n****</VSwitchId>\\n <DBVersion>5.0</DBVersion>\\n <DBClusterStatus>Running</DBClusterStatus>\\n <ResourceGroupId>rg-acfmyiu4ekp****</ResourceGroupId>\\n <DBClusterNetworkType>VPC</DBClusterNetworkType>\\n <DBClusterDescription>adb_test</DBClusterDescription>\\n <ZoneId>cn-hangzhou-h</ZoneId>\\n <Engine>AnalyticDB</Engine>\\n <ReservedACU>32ACU</ReservedACU>\\n </Items>\\n</DescribeDBClustersResponse>","errorExample":""}]', - 'title' => '查询集群列表', + 'title' => '打通用户ENI', + 'summary' => '为集群创建VPC弹性网卡。', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'CreateDBCluster' => [ - 'summary' => '创建湖仓版集群。', - 'methods' => [ - 'post', - 'get', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'AttachUserENI'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:AttachUserENI', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', + ], + 'BatchApplyAdviceByIdList' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'update', 'riskType' => 'none', - 'chargeType' => 'paid', - 'abilityTreeCode' => '130062', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'chargeType' => 'free', + 'abilityTreeCode' => '193683', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定湖仓版集群的地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-uf6g8w25jacm7****'], ], [ - 'name' => 'ZoneId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '可用区ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定湖仓版集群的可用区ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou-h', - ], + 'schema' => ['title' => 'regionId', 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DBClusterVersion', + 'name' => 'AdviceIdList', 'in' => 'query', - 'schema' => [ - 'description' => '湖仓版集群的版本，取值：**5.0**。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '5.0', - ], + 'schema' => ['description' => '待批量应用的建议 ID 列表，多个建议 ID 之间用半角逗号（,）分隔。', 'type' => 'string', 'required' => false, 'example' => 'c2589ff3-e86c-4f19-80c8-2aeb7dd9****,53414470-ebf4-4a53-a312-8a1ad8fd****,6e8dce84-fec8-4b0b-9c04-b0cea12c****,b3b9703d-55ca-47e0-96dd-6a4a9dbf****'], ], [ - 'name' => 'DBClusterNetworkType', + 'name' => 'AdviceDate', 'in' => 'query', - 'schema' => [ - 'description' => '集群网络类型。仅支持**VPC**（专有网络）类型。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'VPC', - ], + 'schema' => ['title' => 'AdviceDate', 'description' => '建议生成的日期。格式：yyyyMMdd。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '20221115'], ], [ - 'name' => 'DBClusterDescription', + 'name' => 'ApplyType', 'in' => 'query', 'schema' => [ - 'description' => '集群描述。'."\n" - .'- 不能以`http://`或者`https://`开头。'."\n" - .'- 长度为2~256个字符。', + 'description' => '采纳类型。', 'type' => 'string', 'required' => false, - 'example' => 'test', + 'enumValueTitles' => ['DROP_INDEX' => 'DROP_INDEX', 'DISABLE_INDEX' => 'DISABLE_INDEX', 'ADD_INDEX' => 'ADD_INDEX'], + 'example' => 'DROP_INDEX', ], ], [ - 'name' => 'PayType', - 'in' => 'query', - 'schema' => [ - 'description' => '付费类型。取值说明：'."\n" - ."\n" - .'- **Postpaid**：按量付费。'."\n" - .'- **Prepaid**：包年包月。', - 'type' => 'string', - 'required' => true, - 'example' => 'Prepaid', - ], - ], - [ - 'name' => 'Period', + 'name' => 'BuildImmediately', 'in' => 'query', 'schema' => [ - 'description' => '指定包年包月集群为包年或包月类型。取值说明：'."\n" - .'- **Year**：包年类型。'."\n" - .'- **Month**：包月类型。'."\n" - ."\n" - .'>PayType为Prepaid（即包年包月）时，本参数为必填参数。', - 'type' => 'string', + 'description' => '是否立即启动build任务。', + 'type' => 'boolean', 'required' => false, - 'example' => 'Month', + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], + 'example' => 'true', ], ], - [ - 'name' => 'UsedTime', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '指定包年包月集群的购买时长。取值说明：'."\n" - .'- 当**Period**为Year时，UsedTime取值范围为：1~3（整数）。'."\n" - .'- 当**Period**为Month时，UsedTime取值范围为：1~9（整数）。'."\n" - ."\n" - .'>PayType为**Prepaid**（即包年包月）时，本参数为必填参数。', - 'type' => 'string', - 'required' => false, - 'example' => '3', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求id。', 'type' => 'string', 'example' => '86F92D26-B774-5FA1-8E53-82CBEEEBB012'], + ], ], ], - [ - 'name' => 'VPCId', - 'in' => 'query', - 'schema' => [ - 'description' => '专有网络ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'vpc-bp1at5ze0t5u3xtqn****', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '批量应用优化建议', + 'summary' => '批量应用优化建议。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2025-07-09T06:38:11.000Z', 'description' => '请求参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'BatchApplyAdviceByIdList'], ], + ], + 'ramActions' => [ [ - 'name' => 'VSwitchId', - 'in' => 'query', - 'schema' => [ - 'description' => '虚拟交换机ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'vsw-bp1aadw9k19x6cis9****', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:BatchApplyAdviceByIdList', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"86F92D26-B774-5FA1-8E53-82CBEEEBB012\\"\\n}","type":"json"}]', + ], + 'BindAccount' => [ + 'summary' => '绑定RAM用户与集群的数据库普通账号。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'StorageResource', - 'in' => 'query', - 'schema' => [ - 'description' => '存储预留资源。取值范围：0ACU～2064ACU，步长：24。1 ACU约等于1核4 GB。'."\n" - .'> 参数填写时，需要带单位。', - 'type' => 'string', - 'required' => false, - 'example' => '24ACU', - ], + 'AK' => [], ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], + ], + 'parameters' => [ [ - 'name' => 'ComputeResource', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '计算预留资源。取值范围：0ACU～4096ACU，步长：16。1 ACU约等于1核4 GB。'."\n" - .'> 参数填写时，需要带单位。', - 'type' => 'string', - 'required' => false, - 'example' => '16ACU', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-wz99d9nh532****'], ], [ - 'name' => 'EnableDefaultResourcePool', + 'name' => 'RamUser', 'in' => 'query', - 'schema' => [ - 'description' => '计算预留资源是否全部分配给默认资源组（user_default），取值说明：'."\n" - .'- **true**（默认值）：是'."\n" - .'- **false**：否', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - 'default' => 'true', - ], + 'schema' => ['description' => '绑定的阿里云 RAM 用户 ID。', 'type' => 'string', 'required' => false, 'example' => '1444832459****'], ], [ - 'name' => 'ResourceGroupId', + 'name' => 'AccountName', 'in' => 'query', - 'schema' => [ - 'description' => '资源组ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'rg-4690g37929****', - ], + 'schema' => ['description' => '数据库普通账号。', 'type' => 'string', 'required' => true, 'example' => 'test_accout'], ], [ - 'name' => 'Tag', + 'name' => 'RamUserList', 'in' => 'query', - 'style' => 'repeatList', + 'style' => 'json', 'schema' => [ - 'description' => '标签列表信息。', + 'description' => '绑定的阿里云 RAM 用户 ID 列表，当前仅支持绑定一个，指定该参数时RamUser参数不生效。', 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => '标签键，可以根据标签过滤集群列表。最多20对标签，各个标签对的数字n必须不同，且必须是从1开始的连续整数。`Tag.N.Key`对应的值为`Tag.N.Value`。'."\n" - ."\n" - .'> 最多支持64个字符，不能以`aliyun`、`acs:`、`http://`或者`https://`开头。', - 'type' => 'string', - 'required' => false, - 'example' => 'testkey1', - ], - 'Value' => [ - 'description' => '标签值，可以根据标签过滤集群列表。最多20对标签，各个标签对的数字n必须不同，且必须是从1开始的连续整数。`Tag.N.Key`对应的值为`Tag.N.Value`。'."\n" - ."\n" - .'> 最多支持64个字符，不能以`aliyun`、`acs:`、`http://`或者`https://`开头。'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'test1', - ], - ], - 'required' => false, - ], - 'required' => false, - 'maxItems' => 21, - ], - ], - [ - 'name' => 'SourceDbClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'AnalyticDB MySQL数仓版集群的源实例ID，指定该参数时为从数仓版集群恢复湖仓版集群。', - 'type' => 'string', + 'items' => ['description' => '绑定的阿里云 RAM 用户 ID。', 'type' => 'string', 'required' => false, 'example' => '20732900249392****'], 'required' => false, - 'example' => 'amv-bp1r053byu48p****', ], ], - [ - 'name' => 'BackupSetId', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '基于备份集恢复时，使用的备份集的ID。'."\n" - ."\n" - .'> 您可以调用[DescribeBackups](~~612318~~)接口查看集群的备份列表。', - 'type' => 'string', - 'required' => false, - 'example' => '1880808684', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'DFF27323-3868-5F8A-917D-5D1D06B6BC0D'], + ], ], ], - [ - 'name' => 'RestoreToTime', - 'in' => 'query', - 'schema' => [ - 'description' => '基于备份集恢复的时间点。', - 'type' => 'string', - 'required' => false, - 'example' => '2023-09-20T03:13:56Z', - ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidAccountName.Malformed', 'errorMessage' => 'The specified parameter AccountName is not valid.', 'description' => 'AccountName不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'ACS.Account.NotExist', 'errorMessage' => 'The account is not found.', 'description' => '用户账户不存在。'], + ['errorCode' => 'ACS.Account.UserHasBind', 'errorMessage' => 'The user has been associated with another database account %s.', 'description' => '用户已绑定到另一个账户'], + ['errorCode' => 'ACS.User.DatabaseAccountHasBind', 'errorMessage' => 'The database account has been bound to %s.', 'description' => '数据库账号已经绑定到一个用户。'], + ['errorCode' => 'ACS.InvalidParameter.%s', 'errorMessage' => 'Parameter %s is invalid.', 'description' => '输入的参数无效'], ], - [ - 'name' => 'RestoreType', - 'in' => 'query', - 'schema' => [ - 'description' => '恢复方式，取值：'."\n" - .'* **backup**：基于备份集恢复，您还需要传入参数**BackupSetId**、**SourceDBClusterId**。'."\n" - .'* **timepoint**：基于时间点恢复，您还需要传入参数**RestoreToTime**、**SourceDBClusterId**。', - 'type' => 'string', - 'required' => false, - 'example' => 'backup', - ], + ], + 'title' => '绑定RAM用户与数据库账号', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-06-07T16:00:26.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-04-20T14:39:16.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-03-31T07:03:59.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:51:57.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'BindAccount'], ], + ], + 'ramActions' => [ [ - 'name' => 'ProductForm', - 'in' => 'query', - 'schema' => [ - 'description' => '产品形态。取值为：'."\n" - .'- **IntegrationForm**：融合形态。'."\n" - .'- **LegacyForm**：湖仓版。', - 'type' => 'string', - 'required' => false, - 'example' => 'LegacyForm', - 'default' => 'LegacyForm', - 'enum' => [ - 'IntegrationForm', - 'LegacyForm', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:BindAccount', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'AccountLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DFF27323-3868-5F8A-917D-5D1D06B6BC0D\\"\\n}","errorExample":""},{"type":"xml","example":"<BindAccountResponse>\\n <RequestId>DFF27323-3868-5F8A-917D-5D1D06B6BC0D</RequestId>\\n</BindAccountResponse>","errorExample":""}]', + ], + 'BindDBResourceGroupWithUser' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'ReservedNodeSize', - 'in' => 'query', - 'schema' => [ - 'description' => '预留节点规格，单位为ACU。', - 'type' => 'string', - 'required' => false, - 'example' => '8ACU', - 'default' => '8ACU', - ], + 'AK' => [], ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREadsYXZ2UA'], + ], + 'parameters' => [ [ - 'name' => 'ReservedNodeCount', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '预留节点数。 '."\n" - .'- 企业版默认为3节点，步长为3。'."\n" - .'- 基础版默认为1节点。'."\n" - .'> 仅ProductForm取值为IntegrationForm时，填写该参数', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '3', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1ub9grke1****'], ], [ - 'name' => 'KmsId', + 'name' => 'GroupName', 'in' => 'query', - 'schema' => [ - 'description' => '用于加密云盘数据的密钥ID。'."\n" - .'> 仅当AnalyticDB MySQL集群开启云盘加密时才会使用该参数。', - 'type' => 'string', - 'required' => false, - 'example' => 'e1935511-cf88-1123-a0f8-1be8d251****'."\n", - ], + 'schema' => ['description' => '资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'test'."\n"], ], [ - 'name' => 'DiskEncryption', + 'name' => 'GroupUser', 'in' => 'query', + 'schema' => ['description' => '需要绑定的数据库账号。既可以绑定数据库普通账号，也可以绑定数据库高权限账号。', 'type' => 'string', 'required' => true, 'example' => 'accout'."\n"], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '是否开启云盘加密。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + ], ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidPoolName.Malformed', 'errorMessage' => 'The specified parameter PoolName is not valid.', 'description' => 'PoolName参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPoolUser.Malformed', 'errorMessage' => 'The specified parameter PoolUser is not valid.', 'description' => 'PoolUser参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ], + ], + 'title' => '将资源组与数据库用户进行绑定', + 'summary' => '绑定资源组。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'BindDBResourceGroupWithUser'], + ], + ], + 'ramActions' => [ [ - 'name' => 'CloneSourceRegionId', - 'in' => 'query', - 'allowEmptyValue' => false, - 'schema' => [ - 'title' => '克隆源实例所在区域，跨域克隆必填，同域克隆可不填。', - 'description' => '源集群所在的地域。'."\n" - .'> 跨地域克隆时该参数必填。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:BindDBResourceGroupWithUser', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', + ], + 'CancelSparkReplStatement' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'ProductVersion', - 'in' => 'query', - 'schema' => [ - 'description' => '产品版本。取值为：'."\n" - .'- **BasicVersion**：基础版。'."\n" - .'- **EnterpriseVersion**：企业版。'."\n" - .'> 仅ProductForm取值为IntegrationForm时，填写该参数', - 'type' => 'string', - 'required' => false, - 'example' => 'BasicVersion', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ [ - 'name' => 'SecondaryZoneId', - 'in' => 'query', - 'schema' => [ - 'description' => '备可用区ID。'."\n" - .'> 本参数和ZoneId参数传入的值不能相同。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing-h', - ], + 'name' => 'AppId', + 'in' => 'formData', + 'schema' => ['title' => 'Spark App的名称', 'description' => '应用ID。'."\n" + .'> 可调用[ListSparkApps](~~455888~~)接口查询Spark应用ID。', 'type' => 'string', 'required' => false, 'example' => 's202411071444hzdvk486d9d2001****', 'default' => 'ADB-Spark-Application'], ], [ - 'name' => 'SecondaryVSwitchId', - 'in' => 'query', - 'schema' => [ - 'description' => '备虚拟交换机ID。'."\n" - .'> 本参数和VSwitchId参数传入的值不能相同。', - 'type' => 'string', - 'required' => false, - 'example' => 'vsw-bp1aadw9k19x451gx****', - ], + 'name' => 'StatementId', + 'in' => 'formData', + 'schema' => ['description' => 'Spark作业中代码块的唯一ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '123'], ], [ - 'name' => 'EnableSSL', - 'in' => 'query', - 'schema' => [ - 'type' => 'boolean', - 'required' => false, - ], + 'name' => 'SessionId', + 'in' => 'formData', + 'schema' => ['description' => '会话ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '456'], ], ], 'responses' => [ @@ -3656,48 +1385,124 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'ResourceGroupId' => [ - 'description' => '默认资源组的ID。', - 'type' => 'string', - 'example' => 'rg-4690g37929****', - ], - 'DBClusterId' => [ - 'description' => 'AnalyticDB MySQL湖仓版（3.0）集群ID。', - 'type' => 'string', - 'example' => 'amv-bp1r053byu48p****', - ], - 'OrderId' => [ - 'description' => '订单ID。', - 'type' => 'string', - 'example' => '202353278****', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => [ + 'description' => '返回内容。', + 'type' => 'object', + 'properties' => [ + 'StatementId' => ['description' => 'Spark作业中代码块的唯一ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'Code' => ['description' => '输入的代码。', 'type' => 'string', 'example' => 'print(1+1)'], + 'CodeType' => [ + 'description' => '代码的类型，取值如下：'."\n" + .'- SCALA'."\n" + .'- PYTHON', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => 'PYTHON', + ], + 'CodeState' => [ + 'description' => '代码执行状态，取值如下：'."\n" + .'- CANCELLED： 执行取消'."\n" + .'- RUNNING： 执行中'."\n" + .'- SUCCEEDED： 执行成功'."\n" + .'- ERROR： 执行失败', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => 'RUNNING', + ], + 'AliyunUid' => ['description' => '集群所属的阿里云主账号。', 'type' => 'integer', 'format' => 'int64', 'example' => '190063530332****'], + 'OutputType' => [ + 'description' => '执行结果的序列化格式，结构为一个JSON，取值如下：'."\n" + .'- TEXT： 输出结果为Apache Livy标准下的文本内容。'."\n" + .'- TABLE：输出结果为Apache Livy标准下的表格内容。', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => 'TEXT', + ], + 'Output' => ['description' => '代码执行结果，一个JSON格式的字符串，格式上符合Apache Livy的输出标准。', 'type' => 'string', 'example' => '{"text/plain": "2"}'], + 'Columns' => [ + 'description' => '当输出结果为表时，表的列名。', + 'type' => 'array', + 'items' => ['description' => '列名。', 'type' => 'string', 'example' => 'col1'], + ], + 'Error' => ['description' => '错误消息。', 'type' => 'string', 'example' => 'StackOverflow Exception：'], + 'StartTime' => ['description' => '执行开始时间的毫秒级时间戳。', 'type' => 'integer', 'format' => 'int64', 'example' => '1730968056000'], + 'EndTime' => ['description' => '执行结束时间的毫秒级时间戳。', 'type' => 'integer', 'format' => 'int64', 'example' => '1730968056000'], + ], ], ], + 'description' => '', ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.App.ExceedQuotaLimitation', 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', 'description' => ''], + ['errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', 'description' => 'AppType类型不合法，请参考使用文档指定适合业务的AppType，请关注配置类型：%s。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ResourceNegativeError', 'errorMessage' => 'The requested resource MUST be positive: %s', 'description' => ''], + ['errorCode' => 'Spark.Config.InvalidAppFilePath', 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', 'description' => '主驱动文件地址必须是合法的OSS地址，当前的地址是 %s。'], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.InvalidDiskConfig', 'errorMessage' => 'The requested disk mount parameter is invalid: %s', 'description' => '磁盘挂载配置错误。'], + ['errorCode' => 'Spark.Config.InvalidHostAliasConfig', 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', 'description' => '域名映射配置错误。'], + ['errorCode' => 'Spark.Config.InvalidLogOssPath', 'errorMessage' => 'The OSS address for log storage is illegal: %s', 'description' => '存储日志的OSS地址非法。'], + ['errorCode' => 'Spark.Config.InvalidRoleArnFormat', 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', 'description' => '配置的RoleARN格式错误。'], + ['errorCode' => 'Spark.Config.InvalidTimeZone', 'errorMessage' => 'Unable to parse time zone configuration %s : %s', 'description' => '时区配置错误。'], + ['errorCode' => 'Spark.Config.MainAppFileNotExists', 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', 'description' => '主驱动文件缺失，必须保证file或者sqls配置不为空。'], + ['errorCode' => 'Spark.Config.OSSPathAccessError', 'errorMessage' => 'The configured OSS address %s cannot be accessed.', 'description' => '配置的OSS路径无法访问。'], + ['errorCode' => 'Spark.Config.OSSPathNotExists', 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', 'description' => 'OSS路径不存在或当前用户无权限访问。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Config.SecurityGroupNotFound', 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', 'description' => '配置的资源组不存在或者因权限不足无法访问。%s。'], + ['errorCode' => 'Spark.Config.VswitchNotFound', 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', 'description' => '无法找到配置虚拟机交换机，或当前账号权限不足。%s。'], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.RoleArn.Invalid', 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', 'description' => 'RoleArn不存在或子账号未授权。'], + ['errorCode' => 'Spark.SQL.BlankError', 'errorMessage' => 'Input sql can not be blank string.', 'description' => '提交SQL不能为空。'], + ['errorCode' => 'Spark.SQL.MultipleSQLError', 'errorMessage' => 'Element in field [sqls] can not contain more than one sql statement: %s.', 'description' => '提交的Spark SQL包含了多条可执行SQL。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Submit spark app failed when parser SQL %s. Error message: %s.', 'description' => '解析提交的Spark SQL失败。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.App.NotFound', 'errorMessage' => 'The Spark application %s is not found.', 'description' => '未能找到输入的 Spark App。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"ResourceGroupId\\": \\"rg-4690g37929****\\",\\n \\"DBClusterId\\": \\"amv-bp1r053byu48p****\\",\\n \\"OrderId\\": \\"202353278****\\"\\n}","errorExample":""},{"type":"xml","example":"<CreateDBClusterResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <ResourceGroupId>rg-4690g37929****</ResourceGroupId>\\n <DBClusterId>amv-bp1r053byu48p****</DBClusterId>\\n <OrderId>202353278****</OrderId>\\n</CreateDBClusterResponse>","errorExample":""}]', - 'title' => '创建集群', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'ModifyDBCluster' => [ - 'summary' => '对湖仓版集群进行升降配。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '终止Spark作业中的部分代码块', + 'summary' => '终止Spark作业中的部分代码块。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CancelSparkReplStatement'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CancelSparkReplStatement', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbClusterId}/resourcegroup/{#resourceGroupName}/sparkapp/{#sparkAppId}/{#sparkStatmentId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"StatementId\\": 123,\\n \\"Code\\": \\"print(1+1)\\",\\n \\"CodeType\\": \\"PYTHON\\",\\n \\"CodeState\\": \\"RUNNING\\",\\n \\"AliyunUid\\": 0,\\n \\"OutputType\\": \\"TEXT\\",\\n \\"Output\\": \\"{\\\\\\"text/plain\\\\\\": \\\\\\"2\\\\\\"}\\",\\n \\"Columns\\": [\\n \\"col1\\"\\n ],\\n \\"Error\\": \\"StackOverflow Exception：\\",\\n \\"StartTime\\": 1730968056000,\\n \\"EndTime\\": 1730968056000\\n }\\n}","type":"json"}]', + ], + 'CancelSparkWarehouseBatchSQL' => [ + 'summary' => '取消Spark SQL执行。', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -3708,102 +1513,186 @@ 'systemTags' => [ 'operationType' => 'update', 'riskType' => 'none', - 'chargeType' => 'paid', - 'abilityTreeCode' => '132381', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'chargeType' => 'free', + 'abilityTreeCode' => '235570', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], + 'autoTest' => true, 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ + 'name' => 'QueryId', + 'in' => 'formData', + 'schema' => ['description' => 'Spark SQL的执行ID。', 'type' => 'string', 'required' => true, 'example' => 'sq202501011001s****'], + ], + [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '湖仓版集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看湖仓版集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1r053byu48p****', - ], + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-uf6485635f***'], ], [ - 'name' => 'RegionId', - 'in' => 'query', + 'name' => 'Agency', + 'in' => 'formData', + 'schema' => ['description' => '协助记录客户端名称，最长16个字符的意义字符串。', 'type' => 'string', 'required' => false, 'example' => 'DMS'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定湖仓版集群的地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', + 'title' => 'Schema of Response', + 'description' => '返回结构。', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '771C5FAA-530F-52F7-B84D-EBAD45***'], + 'Data' => ['description' => '返回结果。', 'example' => '123', '$ref' => '#/components/schemas/SparkBatchSQL'], + ], ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.BlankError', 'errorMessage' => 'Input sql can not be blank string.', 'description' => '提交SQL不能为空。'], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ], + 404 => [ + ['errorCode' => 'Spark.App.NotFound', 'errorMessage' => 'The Spark application %s is not found.', 'description' => '未能找到输入的 Spark App。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '取消Spark SQL执行', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CancelSparkWarehouseBatchSQL'], + ], + ], + 'ramActions' => [ [ - 'name' => 'StorageResource', - 'in' => 'query', - 'schema' => [ - 'description' => '存储预留资源。取值范围：0ACU～2064ACU，步长：24。1 ACU约等于1核4 GB。'."\n" - .'> 参数填写时，需要带单位。', - 'type' => 'string', - 'required' => false, - 'example' => '24ACU', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:CancelSparkWarehouseBatchSQL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"771C5FAA-530F-52F7-B84D-EBAD45***\\",\\n \\"Data\\": {\\n \\"Uid\\": 0,\\n \\"QuerySubmissionTime\\": 1723521767000,\\n \\"Query\\": \\"SELECT * FROM db.tb\\",\\n \\"QueryId\\": \\"sq172352176****\\",\\n \\"Schema\\": \\"default\\",\\n \\"QueryEndTime\\": 1723521767000,\\n \\"DBClusterId\\": \\"amv-bp17s73f016****\\",\\n \\"QueryState\\": \\"RUNNING\\",\\n \\"Statements\\": [\\n {\\n \\"ResultUri\\": \\"oss://yourbucket/result.json\\",\\n \\"EndTime\\": 1723521767000,\\n \\"AppId\\": \\"s20240122jsdx****\\",\\n \\"StatementId\\": \\"sq1723521767****-0001\\",\\n \\"State\\": \\"RUNNING\\",\\n \\"StartTime\\": 1723521767000,\\n \\"Error\\": \\"table is not found\\",\\n \\"Code\\": \\"SELECT 100\\",\\n \\"Result\\": \\"+---+-----+\\\\n|age| name|\\\\n+---+-----+\\\\n| 14| Tom|\\\\n| 23|Alice|\\\\n+---+-----+\\"\\n }\\n ],\\n \\"ErrMessage\\": \\"schema is not found\\",\\n \\"QueryStartTime\\": 1723521767000,\\n \\"ResourceGroupName\\": \\"spark_rg\\"\\n }\\n}","type":"json"}]', + ], + 'CheckBindRamUser' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'ComputeResource', - 'in' => 'query', - 'schema' => [ - 'description' => '计算预留资源。取值范围：0ACU～4096ACU，步长：16。1 ACU约等于1核4 GB。'."\n" - .'> 参数填写时，需要带单位。', - 'type' => 'string', - 'required' => false, - 'example' => '16ACU', - ], + 'AK' => [], ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'get'], + 'parameters' => [ [ - 'name' => 'EnableDefaultResourcePool', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '计算预留资源是否全部分配给默认资源组（user_default），取值说明：'."\n" - .'- true（默认值）：是'."\n" - .'- false：否', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'ProductForm', + 'name' => 'DBClusterId', 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查询集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-wz9842849v6****'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'type' => 'string', - 'required' => false, - 'example' => 'LegacyForm', - 'default' => 'LegacyForm', - 'enum' => [ - 'IntegrationForm', - 'LegacyForm', + 'title' => 'Schema of Response', + 'description' => '响应模式。', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '2FB9DCA3-DA56-5B43-A9A0-68E3D0E6AA84'], + 'Result' => ['description' => '任务返回结果。取值说明：'."\n" + .'- **true**：当前RAM用户已绑定数据库账号。'."\n" + .'- **false**：当前RAM用户未绑定数据库账号。', 'type' => 'boolean', 'example' => 'true'], ], ], ], + ], + 'title' => '查询当前RAM用户是否绑定数据库账号', + 'summary' => '检查当前调用接口的RAM用户，是否已绑定集群数据库账号。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2022-06-11T16:51:36.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CheckBindRamUser'], + ], + ], + 'ramActions' => [ [ - 'name' => 'ReservedNodeSize', - 'in' => 'query', - 'schema' => [ - 'type' => 'string', - 'required' => false, - 'example' => 'LegacyForm', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:CheckBindRamUser', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2FB9DCA3-DA56-5B43-A9A0-68E3D0E6AA84\\",\\n \\"Result\\": true\\n}","errorExample":""},{"type":"xml","example":"<CheckBindRamUserResponse>\\n <RequestId>2FB9DCA3-DA56-5B43-A9A0-68E3D0E6AA84</RequestId>\\n <Result>true</Result>\\n</CheckBindRamUserResponse>","errorExample":""}]', + ], + 'CheckFormationSchemaExists' => [ + 'summary' => '检查元数据发现 Schema 是否存在', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'ReservedNodeCount', - 'in' => 'query', - 'schema' => [ - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - ], + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'none', + 'abilityTreeCode' => '138512', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => 'RegionId', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'Schema', + 'in' => 'formData', + 'schema' => ['description' => 'schema 。', 'type' => 'string', 'required' => true, 'example' => 'testdb01'], + ], + [ + 'name' => 'PrefixMode', + 'in' => 'formData', + 'schema' => ['description' => '前缀模式。true：是。false：否', 'type' => 'boolean', 'required' => true, 'example' => 'false'], + ], + [ + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], ], 'responses' => [ @@ -3811,85 +1700,46 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '0D6BF3E2-41D8-57F6-9A62-A13A70377952', - ], - 'DBClusterId' => [ - 'description' => '湖仓版集群ID。', - 'type' => 'string', - 'example' => 'amv-bp1r053byu48p****', - ], - 'OrderId' => [ - 'description' => '订单ID。', - 'type' => 'string', - 'example' => '2035629****', - ], + 'HttpStatusCode' => ['description' => 'http 状态接口', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '表示存在与否', 'type' => 'string', 'example' => 'false'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '82C80833-BE26-424D-B485-1ABC8431E14'], + 'Success' => ['description' => '是否请求成功', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '状态码', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '提示信息，成功时为 OK', 'type' => 'string', 'example' => 'OK'], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ACS.Cluster.InvalidWorkerState', - 'errorMessage' => 'The state of the worker does not support this operation.', - ], - [ - 'errorCode' => 'ACS.Cluster.ElasticPlanJobsExists', - 'errorMessage' => 'Operation failed. Ongoing elastic plan jobs exist.', - ], + ['errorCode' => 'Parameter.InputError', 'errorMessage' => 'The specified parameter is invalid. ', 'description' => ''], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"0D6BF3E2-41D8-57F6-9A62-A13A70377952\\",\\n \\"DBClusterId\\": \\"amv-bp1r053byu48p****\\",\\n \\"OrderId\\": \\"2035629****\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyDBClusterResponse>\\n <RequestId>0D6BF3E2-41D8-57F6-9A62-A13A70377952</RequestId>\\n <DBClusterId>amv-bp1r053byu48p****</DBClusterId>\\n <OrderId>2035629****</OrderId>\\n</ModifyDBClusterResponse>","errorExample":""}]', - 'title' => '集群升降配', - 'description' => '### 注意事项'."\n" - .'- 扩缩容期间，会禁止`submit job`提交异步任务。如果业务依赖相关功能，请根据业务情况选择时段执行扩缩容。'."\n" - .'- 扩缩容操作会对数据进行重分布迁移，迁移时长与数据量成正比，扩缩容期间服务不中断。集群从大规格缩容到小规格时，数据迁移时长通常需要数小时甚至数十小时，数据量大时请谨慎缩容。'."\n" - .'- 如果集群已加载内置数据集，在缩容时请确保集群具有至少24 ACU的存储预留资源，否则内置数据集无法使用。'."\n" - .'- 扩缩容即将结束时，可能会发生连接闪断，建议您在业务低峰期扩缩容，或确保您的应用有自动重连机制。'."\n" - .'- 不支持将湖仓版变配为数仓版。支持将数仓版变配为湖仓版，详情请参见数仓版变配湖仓版。'."\n" - .'- 当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DeleteDBCluster' => [ - 'summary' => '删除集群。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'title' => '检查元数据发现 Schema 是否存在', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": \\"false\\",\\n \\"RequestId\\": \\"82C80833-BE26-424D-B485-1ABC8431E14\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', + ], + 'CheckSampleDataSet' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], - ], + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1r053byu48p****', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-wz9r8f67h4cqz41u'], ], ], 'responses' => [ @@ -3897,489 +1747,159 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-bp1r053byu48p****', - ], + 'Status' => ['description' => '内置数据集状态，取值说明：'."\n" + .'- **SUCCEED**：加载成功。'."\n" + ."\n" + .'- **INIT**：加载中。'."\n" + ."\n" + .'- **FAILED**：加载失败。'."\n" + ."\n" + .'- **UNINITIALIZED**：未加载。', 'type' => 'string', 'example' => 'UNINITIALIZED'], + 'RequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => '0CE655C3-C211-513D-A42F-D4AE2D1A867C'], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ACS.Cluster.InvalidWorkerState', - 'errorMessage' => 'The state of the worker does not support this operation.', - ], - [ - 'errorCode' => 'ACS.Cluster.ElasticPlanJobsExists', - 'errorMessage' => 'Operation failed. Ongoing elastic plan jobs exist.', - ], - ], 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' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"DBClusterId\\": \\"amv-bp1r053byu48p****\\"\\n}","errorExample":""},{"type":"xml","example":"<DeleteDBClusterResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <DBClusterId>amv-bp1r053byu48p****</DBClusterId>\\n</DeleteDBClusterResponse>","errorExample":""}]', - 'title' => '释放集群', - 'description' => '### 注意事项'."\n" - .'- 仅支持删除按量付费类型的集群。'."\n" - .'- 集群状态为运行中。'."\n" - .'- 当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeDBClusterAttribute' => [ - 'summary' => '查看指定集群的详细信息。', - 'methods' => [ - 'post', - 'get', + 'title' => '检查内置数据集状态', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CheckSampleDataSet'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:CheckSampleDataSet', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Status\\": \\"UNINITIALIZED\\",\\n \\"RequestId\\": \\"0CE655C3-C211-513D-A42F-D4AE2D1A867C\\"\\n}","type":"json"}]', + ], + 'ConfigureResultExport' => [ + 'summary' => '配置导出的SLS 或者OSS 信息，实例级别唯一，遵循一次配置多次使用的原则。', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '130313', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'abilityTreeCode' => '254776', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], ], 'parameters' => [ [ + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-shenzhen'], + ], + [ 'name' => 'DBClusterId', - 'in' => 'query', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下所有AnalyticDB MySQL集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-wz9509beptiz****'], + ], + [ + 'name' => 'ExportType', + 'in' => 'formData', + 'schema' => ['description' => '导出类型，枚举类型，当前可选值为：'."\n" + ."\n" + .'- SLS：标识导出目的为SLS。'."\n" + .'- OSS：标识导出目的为OSS。', 'type' => 'string', 'required' => false, 'example' => 'SLS'], + ], + [ + 'name' => 'SlsInfo', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - .'> 调用[DescribeDBClusters](~~454250~~)接口可以查询集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-wz9509beptiz****', + 'description' => '当导出目的为SLS类型时，对应的SLS配置信息。', + 'type' => 'object', + 'properties' => [ + 'SlsProject' => ['description' => 'SLS Project名称。', 'type' => 'string', 'required' => false, 'example' => 'test-project'], + 'ResourceGroup' => ['description' => '导出SQL运行的资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'aps'], + 'LogstoreTtl' => ['description' => '结果集导出临时生成的logstore的过期时间，单位为天，过期后自动删除。'."\n" + .'最小1天，最大30天，超过范围报错。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'], + ], + 'required' => false, + ], + ], + [ + 'name' => 'OssInfo', + 'in' => 'formData', + 'style' => 'json', + 'schema' => [ + 'description' => '当导出目的为OSS类型时，对应的OSS配置信息。', + 'type' => 'object', + 'properties' => [ + 'ExportBasePath' => ['description' => '导出结果存储的OSS路径地址。', 'type' => 'string', 'required' => false, 'example' => 'oss://testBucketName/data_result'], + 'ResourceGroup' => ['description' => '导出SQL运行的资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'aps'], + 'ResultFileTtl' => ['description' => 'Oss文件过期时间，单位为天，最小1天，最大30天，超出范围报错。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'], + ], + 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'ResultData<?>', + 'description' => 'ResultData<?>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD', - ], - 'Items' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + ."\n" + .'- 请求正常，返回OK。'."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'OK'], + 'Code' => ['description' => '后端错误码。', 'type' => 'string', 'example' => '200'], + 'Data' => [ + 'description' => '已配置的结果集导出信息', 'type' => 'object', - 'itemNode' => true, 'properties' => [ - 'DBCluster' => [ - 'description' => '<props="china">企业版、基础版集群信息列表。</props>'."\n" - .'<props="intl">湖仓版集群信息列表。</props>', - 'type' => 'array', - 'items' => [ - 'description' => '集群详情。', - 'type' => 'object', - 'properties' => [ - 'CreationTime' => [ - 'description' => '集群创建时间。UTC时间，格式为`yyyy-MM-ddThh:mm:ssZ`。', - 'type' => 'string', - 'example' => '2022-07-01T09:50:18Z', - ], - 'Expired' => [ - 'description' => '包年包月集群是否过期。取值说明：'."\n" - .'- **true**：已过期。'."\n" - .'- **false**：未过期。'."\n" - .'> - 如果集群已过期，在一定时间内集群会被锁定甚至释放。建议您进行续费操作，详情请参见[续费说明](~~135248~~)。'."\n" - .'- 按量付费集群不返回此参数。', - 'type' => 'string', - 'example' => 'false', - ], - 'MaintainTime' => [ - 'description' => '集群的可维护时间。UTC时间，格式为`HH:mmZ-HH:mmZ`。'."\n" - .'> 更多关于可维护时间段的信息，请参见[设置可维护时间段](~~122569~~)。', - 'type' => 'string', - 'example' => '04:00Z-05:00Z', - ], - 'PayType' => [ - 'description' => '集群付费类型，取值说明：'."\n" - .'* **Postpaid**：按量付费。'."\n" - .'* **Prepaid**：包年包月。', - 'type' => 'string', - 'example' => 'Prepaid', - ], - 'Tags' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Tag' => [ - 'description' => '标签列表。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => '标签键。'."\n" - .'> 您可以调用[TagResources](~~179253~~)接口为目标集群创建标签。', - 'type' => 'string', - 'example' => 'tag1', - ], - 'Value' => [ - 'description' => '标签值。', - 'type' => 'string', - 'example' => 'test1', - ], - ], - ], - ], - ], - ], - 'Mode' => [ - 'description' => '集群模式。默认返回**flexible**，表示弹性模式集群。', - 'type' => 'string', - 'example' => 'flexible', - ], - 'Port' => [ - 'description' => '集群端口号。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '3306', - ], - 'LockMode' => [ - 'description' => '集群的锁定模式，取值说明：'."\n" - .'- **Unlock**：未锁定。'."\n" - .'- **ManualLock**：手动触发锁定。'."\n" - .'- **LockByExpiration**：集群到期自动锁定。', - 'type' => 'string', - 'example' => 'ManualLock', - ], - 'EngineVersion' => [ - 'description' => '集群引擎版本。', - 'type' => 'string', - 'example' => '3.1.16', - 'default' => '3.1.7.0', - ], - 'StorageResource' => [ - 'description' => '存储预留资源规格。1 ACU约等于1核4 GB。存储资源用于数据读写，增加该资源能提高集群读写能力。', - 'type' => 'string', - 'example' => '24ACU', - ], - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</prop', - 'type' => 'string', - 'example' => 'amv-wz9509beptiz****', - ], - 'ConnectionString' => [ - 'description' => '集群的公网连接地址。', - 'type' => 'string', - 'example' => 'amv-wz9509beptiz****.ads.aliyuncs.com', - ], - 'DBClusterType' => [ - 'description' => '集群类型。默认返回**Common**，表示常规集群。', - 'type' => 'string', - 'example' => 'Common', - ], - 'CommodityCode' => [ - 'description' => '商品付费类型，取值说明：'."\n" - .'- **ads**：按量付费商品。'."\n" - .'- **ads_pre**：包年包月商品。', - 'type' => 'string', - 'example' => 'ads_pre', - ], - 'ExpireTime' => [ - 'description' => '集群到期时间。'."\n" - .'- 若集群付费类型为包年包月，则返回实际到期时间。'."\n" - .'- 若集群付费类型为按量付费，则返回为空。', - 'type' => 'string', - 'example' => '2022-10-01T09:50:18Z', - ], - 'LockReason' => [ - 'description' => '集群锁定原因。'."\n" - .'> 仅当集群被锁定时会返回该参数，固定为**instance_expire**。', - 'type' => 'string', - 'example' => 'instance_expire', - ], - 'VPCId' => [ - 'description' => '专有网络（VPC）ID。', - 'type' => 'string', - 'example' => 'vpc-bp13h7uzhulpu****', - ], - 'ComputeResource' => [ - 'description' => '计算预留资源规格。1 ACU约等于1核4 GB。计算资源用于数据计算，增加计算资源能加快查询速度，可以根据集群实际性能按需弹性扩缩。', - 'type' => 'string', - 'example' => '16ACU', - ], - 'RegionId' => [ - 'description' => '集群所在的地域ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'VSwitchId' => [ - 'description' => '交换机ID。', - 'type' => 'string', - 'example' => 'vsw-uf629gydd54ld****', - ], - 'DBVersion' => [ - 'description' => 'AnalyticDB MySQL集群的版本，当前仅支持**5.0**版本。', - 'type' => 'string', - 'example' => '5.0', - ], - 'DBClusterStatus' => [ - 'description' => '集群状态。取值说明：'."\n" - .'- **Preparing**：准备中'."\n" - .'- **Creating**：创建中'."\n" - .'- **Running**：运行中'."\n" - .'- **Deleting**：删除中'."\n" - .'- **Restoring**：备份恢复中'."\n" - .'- **ClassChanging**：变配中'."\n" - .'- **NetAddressCreating**：创建网络中'."\n" - .'- **NetAddressDeleting**：删除网络中'."\n" - .'- **NetAddressModifying**：修改网络中', - 'type' => 'string', - 'example' => 'Running', - ], - 'ResourceGroupId' => [ - 'description' => '资源组ID。', - 'type' => 'string', - 'example' => 'rg-acfmyiu4ekp****', - ], - 'DBClusterNetworkType' => [ - 'description' => '集群网络类型。仅支持**VPC**（专有网络）类型。', - 'type' => 'string', - 'example' => 'VPC', - 'default' => 'VPC', - ], - 'DBClusterDescription' => [ - 'description' => '集群的描述信息。', - 'type' => 'string', - 'example' => 'adb_test', - ], - 'UserENIStatus' => [ - 'description' => '是否已启用ENI（Elastic Network Interface，弹性网卡）网络，取值说明：'."\n" - .'- **true**：已启用。'."\n" - .'- **false**：未启用。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'ZoneId' => [ - 'description' => '集群所在的可用区ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou-h', - ], - 'Engine' => [ - 'description' => '集群引擎，固定为**AnalyticDB**。', - 'type' => 'string', - 'example' => 'AnalyticDB', - ], - 'ReservedACU' => [ - 'description' => '集群剩余可分配计算预留资源。1 ACU约等于1核4 GB。', - 'type' => 'string', - 'example' => '24ACU', - ], - 'ComputeResourceTotal' => [ - 'description' => '集群计算总资源量。1 ACU约等于1核4 GB。', - 'type' => 'string', - 'example' => '48ACU', - ], - 'StorageResourceTotal' => [ - 'description' => '集群存储总资源量。1 ACU约等于1核4 GB。', - 'type' => 'string', - 'example' => '24ACU', - ], - 'SupportedFeatures' => [ - 'description' => '预留参数，不涉及。', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - 'description' => '预留参数，不涉及。', - 'example' => '预留参数，不涉及。', - ], - ], - 'ProductForm' => [ - 'description' => '预留参数，不涉及。', - 'type' => 'string', - 'example' => '预留参数，不涉及。', - 'enum' => [ - 'IntegrationForm', - 'LegacyForm', - ], - ], - 'ReservedNodeSize' => [ - 'description' => '预留参数，不涉及。', - 'type' => 'string', - 'example' => '预留参数，不涉及。', - ], - 'ReservedNodeCount' => [ - 'description' => '预留参数，不涉及。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '预留参数，不涉及。', - ], - 'ClickhouseEngineEnabled' => [ - 'description' => 'ClickHouse宽表引擎是否开启。'."\n" - .'- **true**: 已开启Clickhouse宽表引擎。'."\n" - .'- **false**: 未开启Clickhouse宽表引擎。', - 'type' => 'boolean', - 'enumValueTitles' => [ - 'true' => 'true', - 'false' => 'false', - ], - 'example' => 'true', - ], - 'AINodeNumber' => [ - 'type' => 'integer', - 'format' => 'int32', - ], - 'ProductVersion' => [ - 'description' => '产品版本。取值为：'."\n" - .'- **BasicVersion**：基础版。'."\n" - .'- **EnterpriseVersion**：企业版。', - 'type' => 'string', - 'example' => 'BasicVersion', - ], - 'KmsId' => [ - 'description' => '用于加密云盘数据的密钥ID。'."\n" - .'> 仅当AnalyticDB MySQL集群开启云盘加密时才会返回该参数。', - 'type' => 'string', - 'example' => 'e1935511-cf88-1123-a0f8-1be8d251****', - ], - 'TaskInfo' => [ - 'description' => '任务信息。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '任务名称。', - 'type' => 'string', - 'example' => 'ScaleUpDBCluster', - ], - 'Status' => [ - 'description' => '任务状态，取值为：'."\n" - .'* NOT_RUN：等待运行。'."\n" - .'* RUNNING：运行中。'."\n" - .'* SUCCEED：已结束。', - 'type' => 'string', - 'example' => 'RUNNING', - 'enum' => [ - 'RUNNING', - 'SUCCEED', - 'NOT_RUN', - ], - ], - 'Progress' => [ - 'description' => '任务进度，单位：%。', - 'type' => 'string', - 'example' => '10', - ], - 'StepList' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'StepList' => [ - 'description' => '任务步骤。', - 'type' => 'array', - 'items' => [ - 'description' => '任务步骤。', - 'type' => 'object', - 'properties' => [ - 'StepName' => [ - 'description' => '步骤名称。', - 'type' => 'string', - 'example' => 'PrepareResources', - ], - 'StepDesc' => [ - 'description' => '步骤描述。', - 'type' => 'string', - 'example' => 'Prepare resources', - ], - 'StepStatus' => [ - 'description' => '步骤状态，取值为：'."\n" - .'* NOT_RUN：等待运行。'."\n" - .'* RUNNING：运行中。'."\n" - .'* SUCCEED：已结束。', - 'type' => 'string', - 'example' => 'RUNNING', - 'enum' => [ - 'RUNNING', - 'SUCCEED', - 'NOT_RUN', - ], - ], - 'StepProgress' => [ - 'description' => '步骤进度，单位：%。', - 'type' => 'string', - 'example' => '50', - ], - 'StartTime' => [ - 'description' => '步骤开始时间，格式为 YYYY-MM-DDThh:mm:ssZ。', - 'type' => 'string', - 'example' => '2024-03-10T09:28:34Z', - ], - 'EndTime' => [ - 'description' => '步骤结束时间，格式为 YYYY-MM-DDThh:mm:ssZ。', - 'type' => 'string', - 'example' => '2024-03-10T10:28:34Z', - ], - ], - ], - ], - ], - ], - ], - ], - 'UserENIVpcId' => [ - 'description' => 'ENI的VPC信息。', - 'type' => 'string', - 'example' => 'vpc-rj9hnedlfm645uj******', - ], - 'UserENIVSwitchOptions' => [ - 'description' => 'ENI交换机列表。多个交换机中间用英文逗号（,）分隔。', - 'type' => 'string', - 'example' => 'vsw-rj9ixufmywqq98z******,vsw-rj95ij6wcz656v7******', - ], - 'UserENIZoneOptions' => [ - 'description' => 'ENI可用区信息。多个可用区之间用英文逗号（,）分隔。', - 'type' => 'string', - 'example' => 'cn-hangzhou-k,cn-hangzhou-h', - ], - 'SecondaryZoneId' => [ - 'type' => 'string', - ], - 'SecondaryVSwitchId' => [ - 'type' => 'string', - ], - 'DiskEncryption' => [ - 'type' => 'boolean', - ], - 'ClickhouseEngineCacheSize' => [ - 'description' => 'ClickHouse宽表引擎的缓存大小，单位：GB。若返回-1，则表示未开启宽表引擎。 若返回具体数字，则表示云盘缓存空间大小。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '100', - ], - 'AINodeSpec' => [ - 'type' => 'string', - ], - ], + 'ExportType' => ['description' => '导出类型，枚举类型，返回结果可能值为：'."\n" + ."\n" + .'- SLS：标识导出目的为SLS。'."\n" + .'- OSS：标识导出目的为OSS。', 'type' => 'string', 'example' => 'SLS'], + 'SlsInfo' => [ + 'description' => '当导出目的为SLS类型时，对应的SLS配置信息。', + 'type' => 'object', + 'properties' => [ + 'SlsProject' => ['description' => 'SLS Project名称。', 'type' => 'string', 'example' => 'test-project'], + 'ResourceGroup' => ['description' => '导出SQL运行的资源组名称。', 'type' => 'string', 'example' => 'aps'], + 'LogstoreTtl' => ['description' => '结果集导出临时生成的logstore的过期时间，单位为天，过期后自动删除。 最小1天，最大30天。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + ], + ], + 'OssInfo' => [ + 'description' => '当导出目的为OSS类型时，配置成功的OSS导出信息。', + 'type' => 'object', + 'properties' => [ + 'ExportBasePath' => ['description' => '导出结果存储的OSS路径地址。', 'type' => 'string', 'example' => 'oss://testBucketName/data_result'], + 'ResourceGroup' => ['description' => '导出SQL运行的资源组名称。', 'type' => 'string', 'example' => 'aps'], + 'ResultFileTtl' => ['description' => 'Oss文件过期时间，单位为天，最小1天，最大30天。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], ], ], ], @@ -4388,70 +1908,108 @@ ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '配置结果集导出信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ConfigureResultExport'], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:ConfigureResultExport', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\",\\n \\"Items\\": {\\n \\"DBCluster\\": [\\n {\\n \\"CreationTime\\": \\"2022-07-01T09:50:18Z\\",\\n \\"Expired\\": \\"false\\",\\n \\"MaintainTime\\": \\"04:00Z-05:00Z\\",\\n \\"PayType\\": \\"Prepaid\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"Key\\": \\"tag1\\",\\n \\"Value\\": \\"test1\\"\\n }\\n ]\\n },\\n \\"Mode\\": \\"flexible\\",\\n \\"Port\\": 3306,\\n \\"LockMode\\": \\"ManualLock\\",\\n \\"EngineVersion\\": \\"3.1.16\\",\\n \\"StorageResource\\": \\"24ACU\\",\\n \\"DBClusterId\\": \\"amv-wz9509beptiz****\\",\\n \\"ConnectionString\\": \\"amv-wz9509beptiz****.ads.aliyuncs.com\\",\\n \\"DBClusterType\\": \\"Common\\",\\n \\"CommodityCode\\": \\"ads_pre\\",\\n \\"ExpireTime\\": \\"2022-10-01T09:50:18Z\\",\\n \\"LockReason\\": \\"instance_expire\\",\\n \\"VPCId\\": \\"vpc-bp13h7uzhulpu****\\",\\n \\"ComputeResource\\": \\"16ACU\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"VSwitchId\\": \\"vsw-uf629gydd54ld****\\",\\n \\"DBVersion\\": \\"5.0\\",\\n \\"DBClusterStatus\\": \\"Running\\",\\n \\"ResourceGroupId\\": \\"rg-acfmyiu4ekp****\\",\\n \\"DBClusterNetworkType\\": \\"VPC\\",\\n \\"DBClusterDescription\\": \\"adb_test\\",\\n \\"UserENIStatus\\": false,\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"Engine\\": \\"AnalyticDB\\",\\n \\"ReservedACU\\": \\"24ACU\\",\\n \\"ComputeResourceTotal\\": \\"48ACU\\",\\n \\"StorageResourceTotal\\": \\"24ACU\\",\\n \\"SupportedFeatures\\": {\\n \\"key\\": \\"预留参数，不涉及。\\"\\n },\\n \\"ProductForm\\": \\"预留参数，不涉及。\\",\\n \\"ReservedNodeSize\\": \\"预留参数，不涉及。\\",\\n \\"ReservedNodeCount\\": 0,\\n \\"ClickhouseEngineEnabled\\": true,\\n \\"AINodeNumber\\": 0,\\n \\"ProductVersion\\": \\"BasicVersion\\",\\n \\"KmsId\\": \\"e1935511-cf88-1123-a0f8-1be8d251****\\",\\n \\"TaskInfo\\": {\\n \\"Name\\": \\"ScaleUpDBCluster\\",\\n \\"Status\\": \\"RUNNING\\",\\n \\"Progress\\": \\"10\\",\\n \\"StepList\\": {\\n \\"StepList\\": [\\n {\\n \\"StepName\\": \\"PrepareResources\\",\\n \\"StepDesc\\": \\"Prepare resources\\",\\n \\"StepStatus\\": \\"RUNNING\\",\\n \\"StepProgress\\": \\"50\\",\\n \\"StartTime\\": \\"2024-03-10T09:28:34Z\\",\\n \\"EndTime\\": \\"2024-03-10T10:28:34Z\\"\\n }\\n ]\\n }\\n },\\n \\"UserENIVpcId\\": \\"vpc-rj9hnedlfm645uj******\\",\\n \\"UserENIVSwitchOptions\\": \\"vsw-rj9ixufmywqq98z******,vsw-rj95ij6wcz656v7******\\",\\n \\"UserENIZoneOptions\\": \\"cn-hangzhou-k,cn-hangzhou-h\\",\\n \\"SecondaryZoneId\\": \\"\\",\\n \\"SecondaryVSwitchId\\": \\"\\",\\n \\"DiskEncryption\\": true,\\n \\"ClickhouseEngineCacheSize\\": 100,\\n \\"AINodeSpec\\": \\"\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeDBClusterAttributeResponse>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n <Items>\\n <CreationTime>2022-07-01T09:50:18Z</CreationTime>\\n <Expired>false</Expired>\\n <MaintainTime>04:00Z-05:00Z</MaintainTime>\\n <PayType>Prepaid</PayType>\\n <Mode>flexible</Mode>\\n <Port>3306</Port>\\n <LockMode>ManualLock</LockMode>\\n <EngineVersion>3.1.16</EngineVersion>\\n <StorageResource>24ACU</StorageResource>\\n <DBClusterId>amv-wz9509beptiz****</DBClusterId>\\n <ConnectionString>amv-wz9509beptiz****.ads.aliyuncs.com</ConnectionString>\\n <DBClusterType>Common</DBClusterType>\\n <CommodityCode>ads_pre</CommodityCode>\\n <ExpireTime>2022-10-01T09:50:18Z</ExpireTime>\\n <LockReason>instance_expire</LockReason>\\n <VPCId>vpc-bp13h7uzhulpu****</VPCId>\\n <ComputeResource>16ACU</ComputeResource>\\n <RegionId>cn-hangzhou</RegionId>\\n <VSwitchId>vsw-uf629gydd54ld****</VSwitchId>\\n <DBVersion>5.0</DBVersion>\\n <DBClusterStatus>Running</DBClusterStatus>\\n <ResourceGroupId>rg-acfmyiu4ekp****</ResourceGroupId>\\n <DBClusterNetworkType>VPC</DBClusterNetworkType>\\n <DBClusterDescription>adb_test</DBClusterDescription>\\n <UserENIStatus>false</UserENIStatus>\\n <ZoneId>cn-hangzhou-h</ZoneId>\\n <Engine>AnalyticDB</Engine>\\n <ReservedACU>24ACU</ReservedACU>\\n <ComputeResourceTotal>48ACU</ComputeResourceTotal>\\n <StorageResourceTotal>24ACU</StorageResourceTotal>\\n </Items>\\n</DescribeDBClusterAttributeResponse>","errorExample":""}]', - 'title' => '查询集群详细信息', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"200\\",\\n \\"Data\\": {\\n \\"ExportType\\": \\"SLS\\",\\n \\"SlsInfo\\": {\\n \\"SlsProject\\": \\"test-project\\",\\n \\"ResourceGroup\\": \\"aps\\",\\n \\"LogstoreTtl\\": 10\\n },\\n \\"OssInfo\\": {\\n \\"ExportBasePath\\": \\"oss://testBucketName/data_result\\",\\n \\"ResourceGroup\\": \\"aps\\",\\n \\"ResultFileTtl\\": 10\\n }\\n }\\n}","type":"json"}]', ], - 'DescribeKernelVersion' => [ - 'summary' => '调用DescrbeKernelVersion接口查看目标集群的内核版本信息。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'CreateAPSJob' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '254101', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'abilityTreeCode' => '180008', + 'abilityTreeNodes' => ['FEATUREadsH8FO36'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> * 您可以调用[DescribeDBClusters](~~98094~~)接口查看目标地域下所有的集群信息，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-2ze918p6qf6h9****', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。'."\n" + .'>您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-shanghai'], ], [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看可用地域的地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-shenzhen', - ], + 'name' => 'SourceEndpointInstanceID', + 'in' => 'formData', + 'schema' => ['description' => '源数据库实例ID。', 'type' => 'string', 'required' => true, 'example' => 'pc-xxxxx'], + ], + [ + 'name' => 'SourceEndpointRegion', + 'in' => 'formData', + 'schema' => ['description' => '源数据库地域。'."\n", 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'], + ], + [ + 'name' => 'SourceEndpointUserName', + 'in' => 'formData', + 'schema' => ['description' => '源端用户名。', 'type' => 'string', 'required' => false, 'example' => 'xxxx'], + ], + [ + 'name' => 'SourceEndpointPassword', + 'in' => 'formData', + 'schema' => ['description' => '源端密码。', 'type' => 'string', 'required' => false, 'example' => '******'], + ], + [ + 'name' => 'DestinationEndpointInstanceID', + 'in' => 'formData', + 'schema' => ['description' => '目标端数据库实例ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-xxxxx'], + ], + [ + 'name' => 'DestinationEndpointPassword', + 'in' => 'formData', + 'schema' => ['description' => '目标端实例密码。', 'type' => 'string', 'required' => false, 'example' => '******'], + ], + [ + 'name' => 'DestinationEndpointUserName', + 'in' => 'formData', + 'schema' => ['description' => '目标端实例用户名。', 'type' => 'string', 'required' => false, 'example' => '******'], + ], + [ + 'name' => 'DbList', + 'in' => 'formData', + 'schema' => ['description' => '同步对象列表。'."\n" + ."\n", 'type' => 'string', 'required' => true, 'example' => '{"EntireInstance":true}'], + ], + [ + 'name' => 'ApsJobName', + 'in' => 'formData', + 'schema' => ['description' => '任务名称。', 'type' => 'string', 'required' => true, 'example' => 'aps-xxxxx'], + ], + [ + 'name' => 'PartitionList', + 'in' => 'formData', + 'schema' => ['description' => '分区列表。', 'type' => 'string', 'required' => false, 'example' => '{}'], + ], + [ + 'name' => 'TargetTableMode', + 'in' => 'formData', + 'schema' => ['description' => '目标表模式。', 'type' => 'string', 'required' => false, 'example' => '1'], ], ], 'responses' => [ @@ -4459,70 +2017,50 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'KernelVersion' => [ - 'description' => '集群内核版本号，例如：**3.1.8**。', - 'type' => 'string', - 'example' => '3.1.8', - ], - 'ExpireDate' => [ - 'description' => '版本维护到期时间，时间格式为yyyy-MM-DD HH:mm:ss。超过此时间后，系统将不再维护该版本，若有问题，请升级到更高版本。', - 'type' => 'string', - 'example' => '2025-01-12T16:00:00Z', - ], - 'AvailableKernelVersions' => [ - 'description' => '当前版本支持升级到的目标版本列表。', - 'type' => 'array', - 'items' => [ - 'description' => '当前版本支持升级到的目标版本列表。', - 'type' => 'object', - 'properties' => [ - 'KernelVersion' => [ - 'description' => '集群内核版本号，例如：**3.1.9**。', - 'type' => 'string', - 'example' => '3.1.9', - ], - 'ReleaseDate' => [ - 'description' => '内核版本的发布时间。时间格式为yyyy-MM-DD HH:mm:ss。', - 'type' => 'string', - 'example' => '2024-07-17T16:00:00Z'."\n", - ], - 'ExpireDate' => [ - 'description' => '版本维护到期时间，时间格式为yyyy-MM-DD HH:mm:ss。超过此时间后，系统将不再维护该版本，若有问题，请升级到更高版本。', - 'type' => 'string', - 'example' => '2025-07-17T16:00:00Z', - ], - ], - ], - ], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'ApsJobId' => ['description' => '任务ID。', 'type' => 'string', 'example' => 'aps-bj1xxxxxx'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'D1B8ED33-5E9B-512D-B188-1579ED6xxx'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'True'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => 'InvalidInput'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**OK**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'OK'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'staticInfo' => ['returnType' => 'asynchronous', 'callback' => 'adb::2021-12-01::DescribeApsJobDetail', 'callbackInterval' => 6000, 'maxCallbackTimes' => 100], + 'title' => '创建APS任务', + 'summary' => '创建APS任务。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateAPSJob'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateAPSJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"KernelVersion\\": \\"3.1.8\\",\\n \\"ExpireDate\\": \\"2025-01-12T16:00:00Z\\",\\n \\"AvailableKernelVersions\\": [\\n {\\n \\"KernelVersion\\": \\"3.1.9\\",\\n \\"ReleaseDate\\": \\"2024-07-17T16:00:00Z\\\\n\\",\\n \\"ExpireDate\\": \\"2025-07-17T16:00:00Z\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '查询集群内核版本', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"ApsJobId\\": \\"aps-bj1xxxxxx\\",\\n \\"RequestId\\": \\"D1B8ED33-5E9B-512D-B188-1579ED6xxx\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', ], - 'UpgradeKernelVersion' => [ - 'summary' => '升级目标AnalyticDB MySQL版集群的内核版本。', - 'path' => '', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], + 'CreateAccount' => [ + 'summary' => '为集群创建数据库账号。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -4531,55 +2069,77 @@ 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'abilityTreeCode' => '130688', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], + ], + [ + 'name' => 'AccountName', + 'in' => 'query', + 'schema' => ['description' => '数据库账号名称，需符合如下要求：'."\n" + .'- 以小写字母开头，以小写字母或数字结尾。'."\n" + .'- 由小写字母、数字或下划线（_）组成。', 'type' => 'string', 'required' => true, 'example' => 'test_accout'], + ], + [ + 'name' => 'AccountPassword', + 'in' => 'query', + 'schema' => ['description' => '数据库账号密码。'."\n" + .'- 由大写字母、小写字母、数字、特殊字符中的任意三种组成。'."\n" + .'- 特殊符号包含：`!@#$%^&*()_+-=`'."\n" + .'- 密码长度为8~32个字符。', 'type' => 'string', 'required' => true, 'example' => 'Test_accout1'], + ], + [ + 'name' => 'AccountDescription', + 'in' => 'query', + 'schema' => ['description' => '账号描述。'."\n" + .'- 不能以`http://`或者`https://`开头。'."\n" + .'- 长度不超过256个字符。', 'type' => 'string', 'required' => false, 'example' => '数据库连接测试账号'], + ], + [ + 'name' => 'AccountType', + 'in' => 'query', 'schema' => [ - 'description' => '集群ID。'."\n" - ."\n" - .'> 您可以通过[DescribeDBClusters](~~129857~~)接口查看账号下AnalyticDB MySQL数仓版集群的集群ID。', + 'description' => '账号类型。取值说明：'."\n" + .'- **Normal**：普通账号。'."\n" + .'- **Super**：高权限账号。', 'type' => 'string', 'required' => true, - 'docRequired' => true, - 'example' => 'am-uf6g8w25jacm7****', + 'example' => 'Normal', + 'enum' => ['Super', 'Normal'], ], ], [ - 'name' => 'DBVersion', + 'name' => 'Engine', 'in' => 'query', 'schema' => [ - 'description' => '需要升级到的目标内核版本。'."\n" - .'> 您可以调用**DescribeKernelVersion**接口查询集群支持的内核版本列表。', + 'description' => '数据库引擎，取值：'."\n" + ."\n" + .'- **AnalyticDB**（默认）：AnalyticDB MySQL引擎。'."\n" + .'- **Clickhouse**：宽表引擎。', 'type' => 'string', 'required' => false, - 'example' => '3.1.9', + 'enumValueTitles' => [], + 'example' => 'Clickhouse', ], ], [ - 'name' => 'SwitchMode', + 'name' => 'RamUserList', 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => '执行时间，取值：'."\n" - .'* **0**：立即执行，默认值。'."\n" - .'* **1**：在可维护时间段执行。'."\n" - ."\n" - .'> 您可以调用[ModifyDBClusterMaintainTime](~~612236~~)修改集群的可维护时间段。', - 'type' => 'integer', - 'format' => 'int32', + 'description' => '绑定的阿里云RAM用户ID列表，当前仅支持绑定一个。', + 'type' => 'array', + 'items' => ['description' => '绑定的阿里云RAM用户ID。', 'type' => 'string', 'required' => false, 'example' => '20732900249392****'], 'required' => false, - 'example' => '0', - 'enum' => [ - '0', - '1', - ], ], ], ], @@ -4590,57 +2150,99 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A444FFFFFF', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidAccountName.Malformed', 'errorMessage' => 'The specified parameter AccountName is not valid.', 'description' => 'AccountName不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidAccountPassword.Malformed', 'errorMessage' => 'The specified parameter AccountPassword is not valid.', 'description' => 'AccountPassword参数不正确，请确认参数是否符合规范。'."\n"], + ['errorCode' => 'InvalidAccountDescription.Malformed', 'errorMessage' => 'The specified parameter AccountDescription is not valid.', 'description' => 'AccountDescription参数不正确，请确认参数是否符合规范。'."\n"], + ['errorCode' => 'InvalidAccountType.Malformed', 'errorMessage' => 'The specified parameter AccountType is not valid.', 'description' => 'AccountType参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'ACS.Sql.CannotConnect', 'errorMessage' => 'Cannot connect instance which type is %s.', 'description' => '无法连接到给定类型的子实例。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A444FFFFFF\\"\\n}","type":"json"}]', - 'title' => '升级集群内核版本', - ], - 'DescribeDBClusterStatus' => [ - 'methods' => [ - 'post', - 'get', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","errorExample":""},{"type":"xml","example":"<CreateAccountResponse>\\n <RequestId>2FED790E-FB61-4721-8C1C-07C627FA5A19</RequestId>\\n</CreateAccountResponse>","errorExample":""}]', + 'title' => '创建数据库账号', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-06-13T14:53:43.000Z', 'description' => '错误码发生变更、请求参数发生变更'], + ['createdAt' => '2023-03-31T07:03:59.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:52:03.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateAccount'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateAccount', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + ], + 'CreateApsCopyWorkload' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '133754', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'operationType' => 'none', + 'abilityTreeCode' => '186455', + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsY28JLD'], ], 'parameters' => [ [ 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'>您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1xxxxxxxx47'], + ], + [ + 'name' => 'WorkloadType', + 'in' => 'formData', + 'schema' => ['description' => '任务类型。', 'type' => 'string', 'required' => true, 'example' => 'SLS_INGESTION_ADB'], + ], + [ + 'name' => 'DatasourceId', + 'in' => 'formData', + 'schema' => ['description' => '数据源ID。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '123'], + ], + [ + 'name' => 'DbName', + 'in' => 'formData', + 'schema' => ['description' => '数据库名。', 'type' => 'string', 'required' => false, 'example' => 'dbName'], + ], + [ + 'name' => 'TableName', + 'in' => 'formData', + 'schema' => ['description' => '表名。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + [ + 'name' => 'WorkloadId', + 'in' => 'formData', + 'schema' => ['description' => '数据链路任务ID。', 'type' => 'string', 'required' => true, 'example' => 'aps-******'], ], ], 'responses' => [ @@ -4648,102 +2250,216 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'Status' => [ - 'description' => '集群状态列表。', - 'type' => 'array', - 'items' => [ - 'description' => '集群状态，取值说明：'."\n" - .'- **Preparing**：准备中。'."\n" - ."\n" - .'- **Creating**：创建中。'."\n" - ."\n" - .'- **Restoring**：备份恢复中。'."\n" - ."\n" - .'- **Running**：运行中。'."\n" - ."\n" - .'- **Deleting**：删除中。'."\n" - ."\n" - .'- **ClassChanging**：变配中。'."\n" - ."\n" - .'- **NetAddressCreating**：创建网络中。'."\n" - ."\n" - .'- **NetAddressDeleting**：释放网络中。'."\n" - ."\n" - .'- **NetAddressModifying**：网络地址修改中。'."\n" - ."\n" - .'- **EngineVersionUpgrading**：版本升级中。', - 'type' => 'string', - 'example' => 'Running', - ], - ], - 'RequestId' => [ - 'description' => '请求id。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEAU', - ], + 'HttpStatusCode' => ['description' => 'HTTP状态码。'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '******-3EEC-******-9F06-******'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：调用成功。'."\n" + .'- **false**：调用失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => 'InvalidInput'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回Success。'."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], + 'Data' => ['description' => '删除的应用信息。', 'type' => 'object', 'example' => '-'], ], + 'description' => '', ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Status\\": [\\n \\"Running\\"\\n ],\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEAU\\"\\n}","type":"json"}]', - 'title' => '查询集群的状态列表', - 'summary' => '查询集群的状态列表。', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'ModifyDBClusterDescription' => [ - 'summary' => '修改指定集群的描述信息，方便集群的维护管理。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建APS复制链路', + 'summary' => '创建APS复制链路。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateApsCopyWorkload'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateApsCopyWorkload', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Message\\": \\"Success\\",\\n \\"Data\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n}","type":"json"}]', + ], + 'CreateApsDatasoure' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'abilityTreeCode' => '168860', + 'abilityTreeNodes' => ['FEATUREadsBIVU9O', 'FEATUREadsY28JLD', 'FEATUREads1II0UT'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-xxxxx'], + ], + [ + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-shanghai'], + ], + [ + 'name' => 'DatasourceType', + 'in' => 'formData', + 'schema' => ['description' => '数据源类型。', 'type' => 'string', 'required' => true, 'example' => 'KAFKA'], + ], + [ + 'name' => 'DatasourceName', + 'in' => 'formData', + 'schema' => ['description' => '数据源名称。', 'type' => 'string', 'required' => true, 'example' => 'sls-******'], + ], + [ + 'name' => 'DatasourceDescription', + 'in' => 'formData', + 'schema' => ['description' => '数据源描述。', 'type' => 'string', 'required' => false, 'example' => 'description'], + ], + [ + 'name' => 'Mode', + 'in' => 'formData', + 'schema' => ['description' => '模式。'."\n", 'type' => 'string', 'required' => false, 'example' => 'ALI_CLOUD_INSTANCE'], + ], + [ + 'name' => 'SlsInfo', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1r053byu48p****', + 'description' => '创建的日志服务（SLS）信息。', + 'type' => 'object', + 'properties' => [ + 'SourceRegionId' => ['description' => '源集群所处地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'], + 'Project' => ['description' => '日志服务（SLS）项目。', 'type' => 'string', 'required' => false, 'example' => 'test-project'], + 'Store' => ['description' => 'sls logstore。', 'type' => 'string', 'required' => false, 'example' => 'test-store'], + 'Across' => ['description' => '是否跨账号。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'AcrossUid' => ['description' => '跨账号UID。', 'type' => 'string', 'required' => false, 'example' => 'xxxx'], + 'AcrossRole' => ['description' => '跨账号角色名。', 'type' => 'string', 'required' => false, 'example' => 'yyy'], + ], + 'required' => false, + 'example' => '-', ], ], [ - 'name' => 'DBClusterDescription', - 'in' => 'query', + 'name' => 'KafkaInfo', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '集群描述。'."\n" - ."\n" - .'- 不能以`http://`或者`https`开头；'."\n" - .'- 长度为2~256个字符。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'adb_test', + 'description' => 'Kafka信息。', + 'type' => 'object', + 'properties' => [ + 'KafkaClusterId' => ['description' => 'kafka实例ID。', 'type' => 'string', 'required' => false, 'example' => '******'], + 'KafkaTopic' => ['description' => '分配kafka topic名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + 'required' => false, + 'example' => '-', + ], + ], + [ + 'name' => 'HiveInfo', + 'in' => 'formData', + 'style' => 'json', + 'schema' => [ + 'description' => 'Hive数据源信息。', + 'type' => 'object', + 'properties' => [ + 'MetaStoreUri' => ['description' => 'meta store 连接地址。', 'type' => 'string', 'required' => false, 'example' => '******'], + 'Vswitch' => ['description' => '交换机ID。', 'type' => 'string', 'required' => false, 'example' => 'vsw-bp1*****k'], + 'SecurityGroup' => ['description' => '安全组。', 'type' => 'string', 'required' => false, 'example' => 'sg-uf*******h'], + 'ClusterId' => ['description' => '实例ID', 'type' => 'string', 'required' => false, 'example' => '******'], + 'HostConfig' => ['description' => '主机配置。', 'type' => 'string', 'required' => false, 'example' => '******'], + ], + 'required' => false, + 'example' => '-', + ], + ], + [ + 'name' => 'RdsMysqlInfo', + 'in' => 'formData', + 'style' => 'json', + 'schema' => [ + 'description' => 'rds mysql数据源信息。', + 'type' => 'object', + 'properties' => [ + 'InstanceId' => ['description' => '实例ID。', 'type' => 'string', 'required' => false, 'example' => 'rm-xxxxxxx'], + 'UserName' => ['description' => '用户名。', 'type' => 'string', 'required' => false, 'example' => 'Username.'], + 'Password' => ['description' => '密码。', 'type' => 'string', 'required' => false, 'example' => '******'], + 'RegionId' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-shanghai'], + 'ConnectUrl' => ['description' => '只读实例连接地址。', 'type' => 'string', 'required' => false, 'example' => '******'], + 'SecurityGroup' => ['description' => '安全组。', 'type' => 'string', 'required' => false, 'example' => 'sg-******'], + ], + 'required' => false, + 'example' => '-', + ], + ], + [ + 'name' => 'PolarDBMysqlInfo', + 'in' => 'formData', + 'style' => 'json', + 'schema' => [ + 'description' => 'polardb mysql数据源信息。', + 'type' => 'object', + 'properties' => [ + 'InstanceId' => ['description' => '实例ID。', 'type' => 'string', 'required' => false, 'example' => 'pc-bp*********'], + 'UserName' => ['description' => '用户名。', 'type' => 'string', 'required' => false, 'example' => 'test-user-name'], + 'Password' => ['description' => '密码。', 'type' => 'string', 'required' => false, 'example' => '***'], + 'RegionId' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-shanghai'], + 'ConnectUrl' => ['description' => '私有定制RDS连接地址。', 'type' => 'string', 'required' => false, 'example' => '****'], + 'SecurityGroup' => ['description' => '安全组。', 'type' => 'string', 'required' => false, 'example' => 'sg-******'], + 'Across' => ['description' => '是否跨账号。取值：'."\n" + ."\n" + .'- **true** ：当前网络实例为跨账号资源。'."\n" + .'- **false** ：当前网络实例为本账号资源。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'AcrossUid' => ['description' => '跨账号UID。', 'type' => 'string', 'required' => false, 'example' => '123456789*'], + 'AcrossRole' => ['description' => '跨账号角色。', 'type' => 'string', 'required' => false, 'example' => 'test-role'], + ], + 'required' => false, + 'example' => '-', + ], + ], + [ + 'name' => 'PolarDBXInfo', + 'in' => 'formData', + 'style' => 'json', + 'schema' => [ + 'description' => 'polardbx数据源信息。', + 'type' => 'object', + 'properties' => [ + 'InstanceId' => ['description' => 'OceanBase 集群 ID。', 'type' => 'string', 'required' => false, 'example' => '-'], + ], + 'required' => false, + 'example' => '-', + ], + ], + [ + 'name' => 'DatabricksInfo', + 'in' => 'formData', + 'style' => 'json', + 'schema' => [ + 'description' => 'databricks数据源信息。', + 'type' => 'object', + 'properties' => [ + 'AccessToken' => ['description' => '访问令牌。', 'type' => 'string', 'required' => false, 'example' => '******'], + 'WorkspaceURL' => ['description' => '工作空间URL。', 'type' => 'string', 'required' => false, 'example' => 'xxxxx'], + ], + 'required' => false, + 'example' => '-', ], ], ], @@ -4752,163 +2468,182 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '17F57FEE-EA4F-4337-8D2E-9C23CAA63D74', - ], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '集群资源具体使用详情。', 'type' => 'string', 'example' => '69'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '65D2***-45C1-5C18-**********'], + 'Success' => ['description' => '预检查结果，返回值说明：'."\n" + ."\n" + .'- **success**：检查通过。'."\n" + .'- **false**：检查不通过。', 'type' => 'boolean', 'example' => 'True'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'OK'], + 'DBClusterId' => ['description' => '集群ID。'."\n", 'type' => 'string', 'example' => 'amv-7xxxxx'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidDBClusterDescription.Malformed', - 'errorMessage' => 'The specified parameter DBClusterDescription is not valid.', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建APS数据源', + 'summary' => '创建APS数据源。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateApsDatasoure'], ], - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateApsDatasoure', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"17F57FEE-EA4F-4337-8D2E-9C23CAA63D74\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyDBClusterDescriptionResponse>\\n <RequestId>17F57FEE-EA4F-4337-8D2E-9C23CAA63D74</RequestId>\\n</ModifyDBClusterDescriptionResponse>","errorExample":""}]', - 'title' => '变更集群描述', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": \\"69\\",\\n \\"RequestId\\": \\"65D2***-45C1-5C18-**********\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\",\\n \\"DBClusterId\\": \\"amv-7xxxxx\\"\\n}","type":"json"}]', ], - 'DescribeClusterAccessWhiteList' => [ - 'summary' => '查看指定集群的IP白名单。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'CreateApsHiveJob' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsG383TB', - ], + 'operationType' => 'none', + 'abilityTreeCode' => '170254', + 'abilityTreeNodes' => ['FEATUREadsBIVU9O'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'in' => 'formData', + 'schema' => ['description' => 'AnalyticDB for MySQL集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-****'], ], [ 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'type' => 'string', - 'required' => false, - ], + 'in' => 'formData', + 'schema' => ['description' => '运维事件所在地域的地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-beijing'], + ], + [ + 'name' => 'WorkloadName', + 'in' => 'formData', + 'schema' => ['description' => '工作负载名。', 'type' => 'string', 'required' => true, 'example' => 'xxx-20240224100253'], + ], + [ + 'name' => 'ResourceGroup', + 'in' => 'formData', + 'schema' => ['description' => '资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'user_default'], + ], + [ + 'name' => 'FullComputeUnit', + 'in' => 'formData', + 'schema' => ['description' => '迁移所需acu数。', 'type' => 'string', 'required' => true, 'example' => '16'], + ], + [ + 'name' => 'DatasourceId', + 'in' => 'formData', + 'schema' => ['description' => '数据源ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '40'], + ], + [ + 'name' => 'SyncAllowExpression', + 'in' => 'formData', + 'schema' => ['description' => '允许同步对象的表达式。', 'type' => 'string', 'required' => false, 'example' => '*'], + ], + [ + 'name' => 'SyncDenyExpression', + 'in' => 'formData', + 'schema' => ['description' => '允许同步对象的表达式。', 'type' => 'string', 'required' => false, 'example' => 'abc'], + ], + [ + 'name' => 'TargetType', + 'in' => 'formData', + 'schema' => ['description' => '目标端类型。', 'type' => 'string', 'required' => false, 'example' => 'OSS'], + ], + [ + 'name' => 'OssLocation', + 'in' => 'formData', + 'schema' => ['description' => '目的端湖仓地址，完整OSS路径。', 'type' => 'string', 'required' => true, 'example' => 'oss://test-test*/*0516/'], + ], + [ + 'name' => 'ConflictStrategy', + 'in' => 'formData', + 'schema' => ['description' => '目的端存在同名库表处理策略。', 'type' => 'string', 'required' => false, 'example' => 'Intercept: reports error and aborts.'."\n" + .'Ignore: ignores and continues.'."\n" + .'Skip: skips relevant tables.'], + ], + [ + 'name' => 'AdvancedConfig', + 'in' => 'formData', + 'schema' => ['description' => '高级配置。', 'type' => 'string', 'required' => false, 'example' => '-'], + ], + [ + 'name' => 'Parallelism', + 'in' => 'formData', + 'schema' => ['description' => '并行任务数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '8'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '370D09FD-442A-5225-AAD3-7362CAE39177', - ], - 'Items' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'IPArray' => [ - 'description' => '集群的IP白名单分组列表。', - 'type' => 'array', - 'items' => [ - 'description' => '集群的IP白名单分组列表。', - 'type' => 'object', - 'properties' => [ - 'DBClusterIPArrayAttribute' => [ - 'description' => '白名单分组属性。'."\n" - .'> 控制台不显示带有**hidden**属性的分组，带有该标签的分组通常是用于访问DTS、PolarDB服务的。'."\n" - ."\n", - 'type' => 'string', - 'example' => 'hidden', - ], - 'SecurityIPList' => [ - 'description' => 'IP白名单分组下的IP列表，最多500个，以英文逗号（,）隔开。', - 'type' => 'string', - 'example' => '127.0.xx.xx', - ], - 'DBClusterIPArrayName' => [ - 'description' => 'IP白名单分组名称。'."\n" - ."\n" - .'单个集群最多支持50个白名单分组。', - 'type' => 'string', - 'example' => 'test', - ], - ], - ], - ], - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '2895BB82-B2C1-408E-AA73-DB8D59******'], + 'Data' => ['description' => '工作负载返回数据。', 'type' => 'string', 'example' => '-'], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'string', 'example' => '200'], + 'Success' => ['description' => '请求是否成功。取值说明：'."\n" + .'- **True**：成功。'."\n" + .'- **False**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => 'InvalidInput'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回Success。'."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], ], ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建APS Hive任务', + 'summary' => '创建APS Hive任务。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateApsHiveJob'], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateApsHiveJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"370D09FD-442A-5225-AAD3-7362CAE39177\\",\\n \\"Items\\": {\\n \\"IPArray\\": [\\n {\\n \\"DBClusterIPArrayAttribute\\": \\"hidden\\",\\n \\"SecurityIPList\\": \\"127.0.xx.xx\\",\\n \\"DBClusterIPArrayName\\": \\"test\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeClusterAccessWhiteListResponse>\\n <RequestId>370D09FD-442A-5225-AAD3-7362CAE39177</RequestId>\\n <Items>\\n <DBClusterIPArrayAttribute>hidden</DBClusterIPArrayAttribute>\\n <SecurityIPList>127.0.xx.xx</SecurityIPList>\\n <DBClusterIPArrayName>test</DBClusterIPArrayName>\\n </Items>\\n</DescribeClusterAccessWhiteListResponse>","errorExample":""}]', - 'title' => '查询白名单', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2895BB82-B2C1-408E-AA73-DB8D59******\\",\\n \\"Data\\": \\"-\\",\\n \\"HttpStatusCode\\": \\"200\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Message\\": \\"Success\\"\\n}","type":"json"}]', ], - 'ModifyClusterAccessWhiteList' => [ - 'summary' => '修改指定集群的IP白名单。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'CreateApsKafkaHudiJob' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -4917,82 +2652,221 @@ 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'none', 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsG383TB', - ], + 'chargeType' => 'paid', + 'abilityTreeCode' => '157674', + 'abilityTreeNodes' => ['FEATUREadsY28JLD'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'in' => 'formData', + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'SecurityIps', - 'in' => 'query', - 'schema' => [ - 'description' => '集群的IP白名单，多个IP地址之间以英文逗号（,）隔开，不可重复，最多500个。支持如下两种格式：'."\n" - .'- IP地址形式，例如：10.23.xx.xx。'."\n" - .'- CIDR形式，例如：10.23.xx.xx/24（无类域间路由，24表示了地址中前缀的长度，范围为1~32）。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '10.23.xx.xx', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DBClusterIPArrayName', - 'in' => 'query', + 'name' => 'PartitionSpecs', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => 'IP白名单分组名称，默认操作Default分组。'."\n" + 'description' => '分区信息。', + 'type' => 'array', + 'items' => ['description' => '"SourceColumn": 源端分区字段名。'."\n" + .'"Strategy": 策略。'."\n" + .'1) 按照格式化日期: "ParseAsTimeAndFormat"。'."\n" + .'2) 指定分区字段："CustomSpecify"。'."\n" + ."\0\n" + .'"SourceTypeFormat": 源端类型格式。'."\n" + .'"TargetTypeFormat": 目标端类型格式。'."\n" + .'"TargetColumn": 目标端分区字段名。'."\n" ."\n" - .'- IP白名单分组名称以小写字母开头、以数字或小写字母结尾，可包含小写字母、数字及下划线（_），长度为2~32个字符。'."\n" - .'- 单个集群最多支持50个白名单分组。', - 'type' => 'string', + .'其中SourceTypeFormat枚举及含义如下，右侧对应时间精度。'."\n" + .'APSLiteralTimestampMilliSecond ->毫秒级精度。'."\n" + .'APSLiteralTimestampMicroSecond -> 微秒级精度。'."\n" + .'APSLiteralTimestampSecond -> 秒级精度。'."\n" + .'APSMIDyyyyMMddHHmmssSSS -> yyyy-MM-dd HH:mm:ss.SSS。'."\n" + .'APSMIDyyyyMMddHHmmss -> yyyy-MM-dd HH:mm:ss'."\n" + .'APSMIDyyyyMMdd -> yyyy-MM-dd。'."\n" + .'APSyyyyMMddHHmmss -> yyyyMMddHHmmss。'."\n" + ."\0".'APSyyyyMMdd -> yyyyMMdd。'."\n" + .'APSyyyyMM -> yyyyMM。'."\n" + .'APSSLAyyyyMMdd -> yyyy/MM/dd。'."\n" + .'APSSLAMMddyyyy -> MM/dd/yyyy。', 'type' => 'object', 'required' => false, 'example' => '[{ "SourceColumn": "NetOutFlow", "Strategy": "ParseAsTimeAndFormat", "SourceTypeFormat": "APSLiteralTimestampSecond", "TargetTypeFormat": "yyyy-MM-dd", "TargetColumn": "NetOutFlow" }]'], 'required' => false, - 'example' => 'test', - 'default' => 'default', ], ], [ - 'name' => 'DBClusterIPArrayAttribute', - 'in' => 'query', + 'name' => 'Columns', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '白名单分组属性，默认为空。'."\n" - .'> 控制台不显示带有“hidden”属性的分组，带有该标签的分组通常是用于访问DTS、PolarDB服务的。', - 'type' => 'string', - 'required' => false, - 'example' => 'hidden', + 'description' => '列信息。', + 'type' => 'array', + 'items' => [ + 'description' => '列信息。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '源端字段名称。', 'type' => 'string', 'required' => false, 'example' => 'a'], + 'MapName' => ['description' => '目标端字段名称。', 'type' => 'string', 'required' => false, 'example' => 'b'], + 'Type' => ['description' => '源端字段类型。', 'type' => 'string', 'required' => false, 'example' => 'string'], + 'MapType' => ['description' => '目标端字段类型。', 'type' => 'string', 'required' => false, 'example' => 'string'], + ], + 'required' => false, + ], + 'required' => true, ], ], [ - 'name' => 'ModifyMode', - 'in' => 'query', - 'schema' => [ - 'description' => '修改白名单的方式，取值：'."\n" - .'- **Cover**（默认值）：覆盖原IP白名单。'."\n" - .'- **Append**：追加IP。'."\n" - .'- **Delete**：删除IP。', - 'type' => 'string', - 'required' => false, - 'example' => 'Cover', - 'default' => 'Cover', - 'enum' => [ - 'Cover', - 'Append', - 'Delete', - ], - ], + 'name' => 'PrimaryKeyDefinition', + 'in' => 'formData', + 'schema' => ['description' => '主键设置。包含uuid策略和映射策略。解释如下。'."\n" + .'Uuid策略： "Strategy": "uuid"。'."\n" + .'映射策略：'."\n" + .'"Strategy": "mapping",'."\n" + .'"Values":['."\n" + .' "f1",'."\n" + .' "f2"'."\n" + .'],'."\n" + .'"RecordVersionField","xxx"'."\n" + .'其中RecordVersionField的含义是HUDI记录版本。', 'type' => 'string', 'required' => false, 'example' => '"Strategy": "mapping"'], + ], + [ + 'name' => 'WorkloadName', + 'in' => 'formData', + 'schema' => ['description' => 'Workload的名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'LakehouseId', + 'in' => 'formData', + 'schema' => ['description' => 'Lakehouse的ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '123'], + ], + [ + 'name' => 'ResourceGroup', + 'in' => 'formData', + 'schema' => ['description' => '资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'aps'], + ], + [ + 'name' => 'HudiAdvancedConfig', + 'in' => 'formData', + 'schema' => ['description' => '目标端HUDI配置。', 'type' => 'string', 'required' => false, 'example' => 'hoodie.keep.min.commits=20'], + ], + [ + 'name' => 'AdvancedConfig', + 'in' => 'formData', + 'schema' => ['description' => '高级配置。', 'type' => 'string', 'required' => false, 'example' => '-'], + ], + [ + 'name' => 'FullComputeUnit', + 'in' => 'formData', + 'schema' => ['description' => '全量同步配置。', 'type' => 'string', 'required' => false, 'example' => '2ACU'], + ], + [ + 'name' => 'IncrementalComputeUnit', + 'in' => 'formData', + 'schema' => ['description' => '增量同步配置。', 'type' => 'string', 'required' => true, 'example' => '2ACU'], + ], + [ + 'name' => 'KafkaClusterId', + 'in' => 'formData', + 'schema' => ['description' => 'Kafka实例ID。可以在Kafka控制台获取。', 'type' => 'string', 'required' => false, 'example' => 'xxx'], + ], + [ + 'name' => 'KafkaTopic', + 'in' => 'formData', + 'schema' => ['description' => 'Kafka Topic ID。可以在Kafka控制台获取。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + [ + 'name' => 'StartingOffsets', + 'in' => 'formData', + 'schema' => ['description' => 'Kafka起始消费位点。'."\n" + .'枚举如下：'."\n" + .'begin_cursor/end_cursor/timestamp'."\n" + .'分别对应最早/最近/指定时间。', 'type' => 'string', 'required' => true, 'example' => 'begincursor'], + ], + [ + 'name' => 'MaxOffsetsPerTrigger', + 'in' => 'formData', + 'schema' => ['description' => '单次消费条数。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '50000'], + ], + [ + 'name' => 'DbName', + 'in' => 'formData', + 'schema' => ['description' => '用户自定义的数据库名称。', 'type' => 'string', 'required' => true, 'example' => 'testDB'], + ], + [ + 'name' => 'TableName', + 'in' => 'formData', + 'schema' => ['description' => '用户自定义的表名称。', 'type' => 'string', 'required' => true, 'example' => 'testTB'], + ], + [ + 'name' => 'OutputFormat', + 'in' => 'formData', + 'schema' => ['description' => '输出数据格式。', 'type' => 'string', 'required' => false, 'example' => 'HUDI'], + ], + [ + 'name' => 'TargetType', + 'in' => 'formData', + 'schema' => ['description' => '目标端类型。', 'type' => 'string', 'required' => false, 'example' => 'OSS'], + ], + [ + 'name' => 'TargetGenerateRule', + 'in' => 'formData', + 'schema' => ['description' => '目标生成规则。', 'type' => 'string', 'required' => false, 'example' => 'xxx'], + ], + [ + 'name' => 'AcrossUid', + 'in' => 'formData', + 'schema' => ['description' => '源端Kafka所属的阿里云账号的ID。', 'type' => 'string', 'required' => false, 'example' => '123************'], + ], + [ + 'name' => 'AcrossRole', + 'in' => 'formData', + 'schema' => ['description' => '可信实体为阿里云账号的RAM角色。如何创建RAM角色，请参见创建可信实体为阿里云账号的RAM角色。'."\n" + .'RAM角色中已将AnalyticDB MySQL所属阿里云账号设置为Kafka所属阿里云账号的信任云账号。', 'type' => 'string', 'required' => false, 'example' => 'aps'], + ], + [ + 'name' => 'SourceRegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'JsonParseLevel', + 'in' => 'formData', + 'schema' => ['description' => '设置JSON的嵌套解析层数，取值如下。'."\n" + .'0：不做解析。'."\n" + .'1：解析一层。'."\n" + .'2：解析两层。'."\n" + .'3：解析三层。'."\n" + .'4：解析四层。'."\n" + .'默认会解析一层。JSON的嵌套解析策略具体可见 JSON解析层级和Schema字段推断示例。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '0'], + ], + [ + 'name' => 'DataOutputFormat', + 'in' => 'formData', + 'schema' => ['description' => '枚举值及说明。'."\n" + .'Single：源端是单行的Json记录。'."\n" + .'Multi：源端是Json数组。需要输出单条Json记录。', 'type' => 'string', 'required' => false, 'example' => 'Single'], + ], + [ + 'name' => 'OssLocation', + 'in' => 'formData', + 'schema' => ['description' => '目的端湖仓地址，完整OSS路径。', 'type' => 'string', 'required' => false, 'example' => 'oss://test-xx-zzz/yyy/'], + ], + [ + 'name' => 'DatasourceId', + 'in' => 'formData', + 'schema' => ['description' => '数据源ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'DataFormatType', + 'in' => 'formData', + 'schema' => ['title' => 'Kafka消息类型，支持的消息类型为：json、general_canal_json、mongo_canal_json、dataworks_json和shareplex_json', 'description' => 'Kafka消息类型，支持的消息类型为：json、general_canal_json、mongo_canal_json、dataworks_json和shareplex_json', 'type' => 'string', 'required' => false, 'example' => 'json'], ], ], 'responses' => [ @@ -5000,224 +2874,430 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'TaskId' => [ - 'description' => '任务ID。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1564657730', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '370D09FD-442A-5225-AAD3-7362CAE39177', - ], - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-bp11q28kvl688****', - ], + 'HttpStatusCode' => ['description' => 'HTTP状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '返回创建的任务ID。', 'type' => 'string', 'example' => 'xxx'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1A943417-5B0E-1DB9-A8**-A566****C3'], + 'Success' => ['description' => '是否请求成功。'."\n" + .'True：成功。False：不成功。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '同HTTP状态码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '返回消息。', 'type' => 'string', 'example' => 'ok'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'SecurityIPList.Duplicate', - 'errorMessage' => 'The specified IP address is duplicate.', - ], - [ - 'errorCode' => 'InvalidDBClusterIPArrayName.Malformed', - 'errorMessage' => 'The specified parameter DBClusterIPArrayName is not valid.', - ], - [ - 'errorCode' => 'InvalidSecurityIPList.Malformed', - 'errorMessage' => 'The specified SecurityIPList is incorrectly formatted.', - ], - [ - 'errorCode' => 'InvalidSecurityIPList.Duplicate', - 'errorMessage' => 'Specified security IP list is not valid: Duplicate IP address in the list', - ], + 'title' => '创建APS Kafka入湖任务', + 'summary' => '创建APS Kafka入湖任务。', + 'changeSet' => [ + ['createdAt' => '2025-12-03T12:34:32.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2025-09-18T03:16:43.000Z', 'description' => '请求参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateApsKafkaHudiJob'], ], - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateApsKafkaHudiJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"TaskId\\": 1564657730,\\n \\"RequestId\\": \\"370D09FD-442A-5225-AAD3-7362CAE39177\\",\\n \\"DBClusterId\\": \\"amv-bp11q28kvl688****\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyClusterAccessWhiteListResponse>\\n <TaskId>1564657730</TaskId>\\n <RequestId>370D09FD-442A-5225-AAD3-7362CAE39177</RequestId>\\n <DBClusterId>amv-bp11q28kvl688****</DBClusterId>\\n</ModifyClusterAccessWhiteListResponse>","errorExample":""}]', - 'title' => '修改白名单', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": \\"xxx\\",\\n \\"RequestId\\": \\"1A943417-5B0E-1DB9-A8**-A566****C3\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"ok\\"\\n}","errorExample":""},{"type":"xml","example":"<CreateApsKafkaHudiJobResponse>\\n <HttpStatusCode>200</HttpStatusCode>\\n <Data>xxx</Data>\\n <RequestId>1A943417-5B0E-1DB9-A8**-A566****C3</RequestId>\\n <Success>true</Success>\\n <Code>200</Code>\\n <Message>ok</Message>\\n</CreateApsKafkaHudiJobResponse>","errorExample":""}]', ], - 'ModifyClickhouseEngine' => [ - 'summary' => '为AnalyticDB MySQL实例开启宽表引擎；如果宽表引擎已开启，则修改宽表引擎的缓存大小。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'CreateApsSlsADBJob' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'paid', - 'abilityTreeCode' => '208236', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'operationType' => 'none', + 'abilityTreeCode' => '207599', + 'abilityTreeNodes' => ['FEATUREads1II0UT'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-*********'], + ], + [ + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'PartitionSpecs', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', + 'description' => '分区信息。', + 'type' => 'array', + 'items' => ['description' => '分区信息。', 'type' => 'object', 'required' => false, 'example' => '-'], + 'required' => false, + 'example' => '-', ], ], [ - 'name' => 'Enabled', - 'in' => 'query', + 'name' => 'Columns', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '是否开启宽表引擎。'."\n" - .'取值说明：'."\n" - .'- true：开启。'."\n" - .'- false：不开启。', - 'type' => 'boolean', - 'required' => false, - 'enumValueTitles' => [ - 'true' => 'true', - 'false' => 'false', + 'description' => '列信息。', + 'type' => 'array', + 'items' => [ + 'description' => '列信息。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '列名。', 'type' => 'string', 'required' => false, 'example' => 'id'], + 'MapName' => ['description' => '映射名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], + 'Type' => ['description' => '列数据类型。', 'type' => 'string', 'required' => false, 'example' => 'bigint'], + 'MapType' => ['description' => '映射类型。', 'type' => 'string', 'required' => false, 'example' => 'int'], + ], + 'required' => false, + 'example' => '-', ], - 'example' => 'true', + 'required' => true, + 'example' => '-', ], ], [ - 'name' => 'CacheSize', - 'in' => 'query', + 'name' => 'PrimaryKeyDefinition', + 'in' => 'formData', + 'schema' => ['description' => '主键定义。', 'type' => 'string', 'required' => false, 'example' => '-'], + ], + [ + 'name' => 'WorkloadName', + 'in' => 'formData', + 'schema' => ['description' => '工作负载名。', 'type' => 'string', 'required' => true, 'example' => 'sls-******'], + ], + [ + 'name' => 'LakehouseId', + 'in' => 'formData', + 'schema' => ['description' => 'lakehosue ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '123'], + ], + [ + 'name' => 'ResourceGroup', + 'in' => 'formData', + 'schema' => ['description' => '资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + [ + 'name' => 'AdvancedConfig', + 'in' => 'formData', + 'schema' => ['description' => '高级配置。', 'type' => 'string', 'required' => false, 'example' => '-'], + ], + [ + 'name' => 'HudiAdvancedConfig', + 'in' => 'formData', + 'schema' => ['description' => 'huid高级配置。', 'type' => 'string', 'required' => false, 'example' => '-'], + ], + [ + 'name' => 'FullComputeUnit', + 'in' => 'formData', + 'schema' => ['description' => '全量acu。', 'type' => 'string', 'required' => false, 'example' => '16'], + ], + [ + 'name' => 'IncrementalComputeUnit', + 'in' => 'formData', + 'schema' => ['description' => '增量acu。', 'type' => 'string', 'required' => false, 'example' => '168'], + ], + [ + 'name' => 'Project', + 'in' => 'formData', + 'schema' => ['description' => '项目名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + [ + 'name' => 'Store', + 'in' => 'formData', + 'schema' => ['description' => 'sls Store。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + [ + 'name' => 'StartingOffsets', + 'in' => 'formData', + 'schema' => ['description' => '投递起始位点。', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'MaxOffsetsPerTrigger', + 'in' => 'formData', + 'schema' => ['description' => '最大位点。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '-'], + ], + [ + 'name' => 'DbName', + 'in' => 'formData', + 'schema' => ['description' => '数据库名。', 'type' => 'string', 'required' => true, 'example' => 'dbName'], + ], + [ + 'name' => 'TableName', + 'in' => 'formData', + 'schema' => ['description' => "\n" + .'表名。', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'OutputFormat', + 'in' => 'formData', + 'schema' => ['description' => '输出格式。', 'type' => 'string', 'required' => false, 'example' => '-'], + ], + [ + 'name' => 'TargetType', + 'in' => 'formData', + 'schema' => ['description' => '目标端类型。', 'type' => 'string', 'required' => false, 'example' => 'ADB'], + ], + [ + 'name' => 'TargetGenerateRule', + 'in' => 'formData', + 'schema' => ['description' => '目标端生成规则。', 'type' => 'string', 'required' => false, 'example' => '-'], + ], + [ + 'name' => 'AcrossUid', + 'in' => 'formData', + 'schema' => ['description' => '跨账号UID。', 'type' => 'string', 'required' => false, 'example' => '123456'], + ], + [ + 'name' => 'AcrossRole', + 'in' => 'formData', + 'schema' => ['description' => '跨账号角色名称。', 'type' => 'string', 'required' => false, 'example' => 'test-role'], + ], + [ + 'name' => 'SourceRegionId', + 'in' => 'formData', + 'schema' => ['description' => '源集群所处地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'], + ], + [ + 'name' => 'OssLocation', + 'in' => 'formData', + 'schema' => ['description' => 'oss地址。', 'type' => 'string', 'required' => false, 'example' => 'oss://test*'], + ], + [ + 'name' => 'DatasourceId', + 'in' => 'formData', + 'schema' => ['description' => '数据源ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '327'], + ], + [ + 'name' => 'DirtyDataProcessPattern', + 'in' => 'formData', + 'schema' => ['description' => '脏数据处理模式。', 'type' => 'string', 'required' => false, 'example' => 'STOP'], + ], + [ + 'name' => 'ExactlyOnce', + 'in' => 'formData', + 'schema' => ['description' => '精确一致。', 'type' => 'string', 'required' => false, 'example' => 'false'], + ], + [ + 'name' => 'UnixTimestampConvert', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '宽表引擎云盘缓存空间大小，单位为GB，默认为100GB，取值范围为[100,1000]。', - 'type' => 'integer', - 'format' => 'int32', + 'description' => '时间戳转换。', + 'type' => 'object', + 'properties' => [ + 'Convert' => ['description' => '转换。', 'type' => 'string', 'required' => false, 'example' => 'false。'], + 'Format' => ['description' => '格式。', 'type' => 'string', 'required' => false, 'example' => "\0".'APSyyyyMMdd'], + 'Transform' => ['description' => '转换开关。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + ], 'required' => false, - 'example' => '200', + 'example' => '-', ], ], + [ + 'name' => 'UserName', + 'in' => 'formData', + 'schema' => ['description' => '用户名。', 'type' => 'string', 'required' => true, 'example' => 'user_test'], + ], + [ + 'name' => 'Password', + 'in' => 'formData', + 'schema' => ['description' => '密码。', 'type' => 'string', 'required' => true, 'example' => 'test_user'], + ], + [ + 'name' => 'DirtyDataHandleMode', + 'in' => 'formData', + 'schema' => ['description' => '脏数据处理模式。', 'type' => 'string', 'required' => true, 'example' => '-'], + ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D761DA51-12F8-5457-AAA9-F52B9F436D2D', - ], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '返回数据。', 'type' => 'string', 'example' => '-'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '******-3EEC-******-9F06-******'], + 'Success' => ['description' => '预检查结果，返回值说明：'."\n" + ."\n" + .'- **success**：检查通过。'."\n" + .'- **false**：检查不通过。', 'type' => 'boolean', 'example' => 'True'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => 'InvalidInput'], + 'Message' => ['description' => '调用结果的信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常信息。', 'type' => 'string', 'example' => 'Success'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'ACS.InvalidParameter.%s', - 'errorMessage' => 'Parameter %s is invalid.', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建一个SLS到ADB数仓的APS链路', + 'summary' => '创建一个SLS到ADB数仓的APS链路。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateApsSlsADBJob'], ], - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateApsSlsADBJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D761DA51-12F8-5457-AAA9-F52B9F436D2D\\"\\n}","type":"json"}]', - 'title' => '开启和修改宽表引擎', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": \\"-\\",\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Message\\": \\"Success\\"\\n}","type":"json"}]', ], - 'DescribeResourceGroupSpec' => [ - 'summary' => '查询资源组规格相关信息。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], + 'CreateApsWebhook' => [ + 'path' => '', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '235394', - 'abilityTreeNodes' => [ - 'FEATUREadsYXZ2UA', - ], + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsBIVU9O', 'FEATUREadsY28JLD'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], + ], + [ + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '集群所属地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'JobType', + 'in' => 'formData', + 'schema' => ['description' => '任务类型。取值如下'."\n" + .'任务类型SLS/OSS导出任务：ResultExport。', 'type' => 'string', 'required' => true, 'example' => 'ResultExport'], + ], + [ + 'name' => 'Webhook', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '企业版、基础版或湖仓版集群 ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-8vbo40tl1dxxxxxx', + 'description' => 'Webhook数组。', + 'type' => 'array', + 'items' => [ + 'description' => 'Webhook信息。', + 'type' => 'object', + 'properties' => [ + 'WebhookType' => ['description' => '通知方式。取值如下： dingtalk：钉钉。 lark：飞书。', 'type' => 'string', 'required' => true, 'example' => 'dingtalk'], + 'Url' => ['description' => '请求地址。', 'type' => 'string', 'required' => true, 'example' => 'https://example.com/webhook'], + 'Key' => ['description' => '加签密钥。', 'type' => 'string', 'required' => false, 'example' => '***'], + 'Name' => ['description' => 'Webhook名称。', 'type' => 'string', 'required' => false, 'example' => 'MyWebhookName'], + ], + 'required' => false, + ], + 'required' => false, ], ], - [ - 'name' => 'ResourceGroupType', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '资源组的类型。', - 'type' => 'string', - 'required' => true, - 'example' => 'ai', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response。', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。'."\n", 'type' => 'string', 'example' => '1234567890abcdef'], + 'Data' => ['description' => '返回数据。', 'type' => 'string', 'example' => '[]'], + 'HttpStatusCode' => ['description' => 'http状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Message' => ['description' => '返回消息。', 'type' => 'string', 'example' => 'OK'], + 'Code' => ['description' => '请求返回Code。', 'type' => 'string', 'example' => '200'], + 'Success' => ['description' => '是否成功。', 'type' => 'boolean', 'example' => 'true'], + ], + ], + ], + ], + 'errorCodes' => [], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建Webhook', + 'summary' => '用于为指定数据库集群和任务类型创建新的Webhook。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateApsWebhook'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateApsWebhook', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1234567890abcdef\\",\\n \\"Data\\": \\"[]\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": true\\n}","type":"json"}]', + ], + 'CreateBackup' => [ + 'summary' => '立即创建一个备份集。', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'paid', + 'abilityTreeCode' => '246050', + 'abilityTreeNodes' => ['FEATUREadsM6VDCK'], + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ + [ + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-wz9or2xawpnc****'], + ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '实例所在Region ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ @@ -5227,1035 +3307,299 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'requestId', - 'type' => 'string', - 'example' => '10226189-4391-5B10-97AF-5CA5XXXXXXX', - ], - 'Specs' => [ - 'description' => '规格列表。', - 'type' => 'array', - 'items' => [ - 'description' => '规格信息。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '规格名称。', - 'type' => 'string', - 'example' => 'xlarge', - ], - 'AllocateUnits' => [ - 'description' => '该规格支持的分配单元列表。', - 'type' => 'array', - 'items' => [ - 'description' => '分配单元。', - 'type' => 'string', - 'example' => '1', - ], - ], - 'MaxQuantity' => [ - 'description' => '该规格能够使用的最大数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '8', - ], - 'Type' => [ - 'description' => '资源类型。', - 'type' => 'string', - 'example' => 'GPU', - 'default' => 'GPU', - 'enum' => [ - 'CPU', - 'GPU', - ], - ], - ], - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '421794A3-72A5-5D27-9E8B-A75A4C50****'], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidPoolName.Malformed', - 'errorMessage' => 'The specified parameter PoolName is not valid.', - ], - [ - 'errorCode' => 'InvalidPoolUser.Malformed', - 'errorMessage' => 'The specified parameter PoolUser is not valid.', - ], - [ - 'errorCode' => 'InvalidPoolType.Malformed', - 'errorMessage' => 'The specified parameter PoolType is not valid.', - ], - ], - 408 => [ - [ - 'errorCode' => 'AcsServerTimeOut', - 'errorMessage' => 'The request has failed due to Adb Cloud Service time out.', - ], + ['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', + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"10226189-4391-5B10-97AF-5CA5XXXXXXX\\",\\n \\"Specs\\": [\\n {\\n \\"Name\\": \\"xlarge\\",\\n \\"AllocateUnits\\": [\\n \\"1\\"\\n ],\\n \\"MaxQuantity\\": 8,\\n \\"Type\\": \\"GPU\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '查询资源组规格', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'CreateDBResourceGroup' => [ - 'summary' => '为指定的企业版、基础版或湖仓版集群创建资源组。', - 'methods' => [ - 'post', + 'gatewayOptions' => [ + 'gatewayProtocols' => [], ], - 'schemes' => [ - 'http', - 'https', + 'title' => '立即创建一个临时备份', + 'description' => '**请确保在使用该接口前，已充分了解云原生数据仓库ADB MySQL产品的收费方式和[价格](https://www.aliyun.com/price/product#/ads/detail/ads_pre'."\n" + .')。** 临时备份与常规备份，在价格、备份集的保留周期上是一致的。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateBackup'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateBackup', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"421794A3-72A5-5D27-9E8B-A75A4C50****\\"\\n}","type":"json"}]', + ], + 'CreateDBCluster' => [ + 'summary' => '创建湖仓版集群。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'create', 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '136449', - 'abilityTreeNodes' => [ - 'FEATUREadsYXZ2UA', - ], + 'chargeType' => 'paid', + 'abilityTreeCode' => '130062', + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '企业版、基础版或湖仓版集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定湖仓版集群的地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'GroupName', + 'name' => 'ZoneId', 'in' => 'query', - 'schema' => [ - 'description' => '资源组名称。'."\n" - .'- 长度不超过255个字符。'."\n" - .'- 必须以数字、大写字母或小写字母开头。'."\n" - .'- 可包含数字、大写字母、小写字母、中划线（-）和下划线（_）。', - 'type' => 'string', - 'required' => true, - 'example' => 'test_group', - ], + 'schema' => ['description' => '可用区ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定湖仓版集群的可用区ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou-h'], ], [ - 'name' => 'GroupType', + 'name' => 'DBClusterVersion', 'in' => 'query', - 'schema' => [ - 'description' => '资源组类型，取值：'."\n" - .'- **Interactive**'."\n" - .'- **Job**'."\n" - .'> 关于湖仓版资源组的详细信息，请参见[资源组介绍（湖仓版）](~~428610~~)。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'Job', - 'enum' => [], - ], + 'schema' => ['description' => '湖仓版集群的版本，取值：**5.0**。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '5.0'], ], [ - 'name' => 'MinComputeResource', + 'name' => 'DBClusterNetworkType', 'in' => 'query', - 'schema' => [ - 'title' => '', - 'description' => '最小计算预留资源，单位为ACU。'."\n" - .'- 当资源组类型为Interactive时，计算预留资源最小为16 ACU。'."\n" - .'- 当资源组类型为Job时，计算预留资源最小为0 ACU。', - 'type' => 'string', - 'required' => false, - 'example' => '0ACU', - ], + 'schema' => ['description' => '集群网络类型。仅支持**VPC**（专有网络）类型。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'VPC'], ], [ - 'name' => 'MaxComputeResource', + 'name' => 'DBClusterDescription', 'in' => 'query', - 'schema' => [ - 'description' => '最大计算预留资源，单位为ACU。'."\n" - .'- 当资源组类型为Interactive时，计算预留资源最大为集群当前未分配资源，步长为16 ACU。'."\n" - .'- 当资源组类型为Job时，计算预留资源最大为集群当前未分配资源，步长为8 ACU。', - 'type' => 'string', - 'required' => false, - 'example' => '48ACU', - ], + 'schema' => ['description' => '集群描述。'."\n" + .'- 不能以`http://`或者`https://`开头。'."\n" + .'- 长度为2~256个字符。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ - 'name' => 'ClusterSizeResource', + 'name' => 'PayType', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数（不涉及）', - 'type' => 'string', - 'required' => false, - 'example' => '无', - ], + 'schema' => ['description' => '付费类型。取值说明：'."\n" + ."\n" + .'- **Postpaid**：按量付费。'."\n" + .'- **Prepaid**：包年包月。', 'type' => 'string', 'required' => true, 'example' => 'Prepaid'], ], [ - 'name' => 'MinClusterCount', + 'name' => 'Period', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数（不涉及）', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '无'."\n", - ], + 'schema' => ['description' => '指定包年包月集群为包年或包月类型。取值说明：'."\n" + .'- **Year**：包年类型。'."\n" + .'- **Month**：包月类型。'."\n" + ."\n" + .'>PayType为Prepaid（即包年包月）时，本参数为必填参数。', 'type' => 'string', 'required' => false, 'example' => 'Month'], ], [ - 'name' => 'MaxClusterCount', + 'name' => 'UsedTime', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数（不涉及）', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '无', - ], + 'schema' => ['description' => '指定包年包月集群的购买时长。取值说明：'."\n" + .'- 当**Period**为Year时，UsedTime取值范围为：1~3（整数）。'."\n" + .'- 当**Period**为Month时，UsedTime取值范围为：1~9（整数）。'."\n" + ."\n" + .'>PayType为**Prepaid**（即包年包月）时，本参数为必填参数。', 'type' => 'string', 'required' => false, 'example' => '3'], ], [ - 'name' => 'ClusterMode', + 'name' => 'VPCId', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数（不涉及）', - 'type' => 'string', - 'required' => false, - 'example' => '无', - ], + 'schema' => ['description' => '专有网络ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'vpc-bp1at5ze0t5u3xtqn****'], ], [ - 'name' => 'EnableSpot', + 'name' => 'VSwitchId', 'in' => 'query', - 'schema' => [ - 'description' => '资源组是否开启竞价实例功能。开启竞价实例后资源单价降低，但是有概率被释放。仅Job型资源组可以开启。取值：'."\n" - .'- **True**：开启竞价实例功能。'."\n" - .'- **False**：关闭竞价实例功能。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'True', - ], + 'schema' => ['description' => '虚拟交换机ID。', 'type' => 'string', 'required' => true, 'example' => 'vsw-bp1aadw9k19x6cis9****'], ], [ - 'name' => 'RegionId', + 'name' => 'StorageResource', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - ."\n" - .'> 您可以调用[DescribeRegions](~~612393~~)接口查看AnalyticDB MySQL湖仓版（3.0）集群的地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '存储预留资源。取值范围：0ACU～2064ACU，步长：24。1 ACU约等于1核4 GB。'."\n" + .'> 参数填写时，需要带单位。', 'type' => 'string', 'required' => false, 'example' => '24ACU'], ], [ - 'name' => 'Rules', + 'name' => 'ComputeResource', 'in' => 'query', - 'style' => 'json', + 'schema' => ['description' => '计算预留资源。取值范围：0ACU～4096ACU，步长：16。1 ACU约等于1核4 GB。'."\n" + .'> 参数填写时，需要带单位。', 'type' => 'string', 'required' => false, 'example' => '16ACU'], + ], + [ + 'name' => 'EnableDefaultResourcePool', + 'in' => 'query', + 'schema' => ['description' => '计算预留资源是否全部分配给默认资源组（user_default），取值说明：'."\n" + .'- **true**（默认值）：是'."\n" + .'- **false**：否', 'type' => 'boolean', 'required' => false, 'example' => 'true', 'default' => 'true'], + ], + [ + 'name' => 'ResourceGroupId', + 'in' => 'query', + 'schema' => ['description' => '资源组ID。', 'type' => 'string', 'required' => false, 'example' => 'rg-4690g37929****'], + ], + [ + 'name' => 'Tag', + 'in' => 'query', + 'style' => 'repeatList', 'schema' => [ - 'description' => '作业投递规则。', + 'description' => '标签列表信息。', 'type' => 'array', 'items' => [ - 'description' => '规则信息列表。', 'type' => 'object', 'properties' => [ - 'GroupName' => [ - 'description' => '资源组名称。'."\n" - .'- 长度不超过255个字符。'."\n" - .'- 必须以数字、大写字母或小写字母开头。'."\n" - .'- 可包含数字、大写字母、小写字母、中划线（-）和下划线（_）。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_group', - ], - 'QueryTime' => [ - 'description' => '查询执行时间阈值，单位为毫秒（ms）。', - 'type' => 'string', - 'required' => false, - 'example' => '180000'."\n", - ], - 'TargetGroupName' => [ - 'description' => '目标资源组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'job'."\n", - ], + 'Key' => ['description' => '标签键，可以根据标签过滤集群列表。最多20对标签，各个标签对的数字n必须不同，且必须是从1开始的连续整数。`Tag.N.Key`对应的值为`Tag.N.Value`。'."\n" + ."\n" + .'> 最多支持64个字符，不能以`aliyun`、`acs:`、`http://`或者`https://`开头。', 'type' => 'string', 'required' => false, 'example' => 'testkey1'], + 'Value' => ['description' => '标签值，可以根据标签过滤集群列表。最多20对标签，各个标签对的数字n必须不同，且必须是从1开始的连续整数。`Tag.N.Key`对应的值为`Tag.N.Value`。'."\n" + ."\n" + .'> 最多支持64个字符，不能以`aliyun`、`acs:`、`http://`或者`https://`开头。'."\n", 'type' => 'string', 'required' => false, 'example' => 'test1'], ], 'required' => false, + 'description' => '', ], 'required' => false, + 'maxItems' => 21, ], ], [ - 'name' => 'Engine', + 'name' => 'SourceDbClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库引擎，取值：'."\n" - ."\n" - .'- **AnalyticDB**（默认）：AnalyticDB for MySQL引擎。'."\n" - .'- **SparkWarehouse**：SparkWarehouse引擎。', - 'type' => 'string', - 'required' => false, - 'example' => 'SparkWarehouse', - ], + 'schema' => ['description' => 'AnalyticDB MySQL数仓版集群的源实例ID，指定该参数时为从数仓版集群恢复湖仓版集群。', 'type' => 'string', 'required' => false, 'example' => 'amv-bp1r053byu48p****'], ], [ - 'name' => 'EngineParams', + 'name' => 'BackupSetId', 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'description' => '引擎配置。', - 'type' => 'object', - 'required' => false, - 'example' => '{\\"spark.adb.version\\":\\"3.5\\"}', - ], + 'schema' => ['description' => '基于备份集恢复时，使用的备份集的ID。'."\n" + ."\n" + .'> 您可以调用[DescribeBackups](~~612318~~)接口查看集群的备份列表。', 'type' => 'string', 'required' => false, 'example' => '1880808684'], ], [ - 'name' => 'AutoStopInterval', + 'name' => 'RestoreToTime', 'in' => 'query', - 'schema' => [ - 'description' => '自动停止时间，单位为分钟（m）。', - 'type' => 'string', - 'required' => false, - 'example' => '5m', - ], + 'schema' => ['description' => '基于备份集恢复的时间点。', 'type' => 'string', 'required' => false, 'example' => '2023-09-20T03:13:56Z'], ], [ - 'name' => 'SpecName', + 'name' => 'RestoreType', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数，不涉及。', - 'type' => 'string', - 'required' => false, - 'example' => '预留参数，不涉及。', - ], + 'schema' => ['description' => '恢复方式，取值：'."\n" + .'* **backup**：基于备份集恢复，您还需要传入参数**BackupSetId**、**SourceDBClusterId**。'."\n" + .'* **timepoint**：基于时间点恢复，您还需要传入参数**RestoreToTime**、**SourceDBClusterId**。', 'type' => 'string', 'required' => false, 'example' => 'backup'], ], [ - 'name' => 'MinGpuQuantity', + 'name' => 'ProductForm', 'in' => 'query', 'schema' => [ - 'description' => '预留参数，不涉及。', - 'type' => 'integer', - 'format' => 'int32', + 'description' => '产品形态。取值为：'."\n" + .'- **IntegrationForm**：融合形态。'."\n" + .'- **LegacyForm**：湖仓版。', + 'type' => 'string', 'required' => false, - 'example' => '预留参数，不涉及。', + 'example' => 'LegacyForm', + 'default' => 'LegacyForm', + 'enum' => ['IntegrationForm', 'LegacyForm'], ], ], [ - 'name' => 'MaxGpuQuantity', + 'name' => 'ReservedNodeSize', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数，不涉及。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '预留参数，不涉及。', - ], + 'schema' => ['description' => '预留节点规格，单位为ACU。', 'type' => 'string', 'required' => false, 'example' => '8ACU', 'default' => '8ACU'], ], [ - 'name' => 'TargetResourceGroupName', + 'name' => 'ReservedNodeCount', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数，不涉及。', - 'type' => 'string', - 'required' => false, - 'example' => '预留参数，不涉及。', - ], + 'schema' => ['description' => '预留节点数。 '."\n" + .'- 企业版默认为3节点，步长为3。'."\n" + .'- 基础版默认为1节点。'."\n" + .'> 仅ProductForm取值为IntegrationForm时，填写该参数', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '3'], ], [ - 'name' => 'RayConfig', + 'name' => 'KmsId', 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'description' => 'Ray配置信息(当资源组为ai资源组且对应引擎为RayCluster时需要填写)', - 'type' => 'object', - 'properties' => [ - 'EnableUserEni' => [ - 'type' => 'boolean', - 'required' => false, - ], - 'HeadSpecType' => [ - 'type' => 'string', - 'required' => false, - 'default' => 'CPU', - 'enum' => [ - 'CPU', - 'GPU', - ], - ], - 'HeadSpec' => [ - 'description' => 'Head节点规格', - 'type' => 'string', - 'required' => false, - 'example' => 'xlarge', - ], - 'HeadAllocateUnit' => [ - 'type' => 'string', - 'required' => false, - ], - 'HeadDiskCapacity' => [ - 'type' => 'string', - 'required' => false, - ], - 'Category' => [ - 'description' => 'Ray集群类型，取值说明：'."\n" - ."\n" - .'- BASIC：基础类型，非高可用'."\n" - ."\n" - .'- HIGH_AVAILABILITY：高可用类型', - 'type' => 'string', - 'required' => false, - 'example' => 'BASIC', - 'enum' => [ - 'BASIC', - 'HIGH_AVAILABILITY', - ], - ], - 'WorkerGroups' => [ - 'description' => 'Ray Worker组配置信息列表', - 'type' => 'array', - 'items' => [ - 'description' => 'Ray Worker组配置信息', - 'type' => 'object', - 'properties' => [ - 'GroupName' => [ - 'description' => 'worker组名称', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], - 'AllocateUnit' => [ - 'description' => '分配单元', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - 'MaxWorkerQuantity' => [ - 'description' => '最大worker数量', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '2', - ], - 'MinWorkerQuantity' => [ - 'description' => '最新worker数量', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], - 'WorkerDiskCapacity' => [ - 'description' => 'worker节点的磁盘大小', - 'type' => 'string', - 'required' => false, - 'example' => '100G', - ], - 'WorkerSpecName' => [ - 'description' => 'worker节点规格', - 'type' => 'string', - 'required' => false, - 'example' => 'xlarge', - ], - 'WorkerSpecType' => [ - 'description' => 'worker节点资源类型', - 'type' => 'string', - 'required' => false, - 'example' => 'GPU', - 'enum' => [ - 'CPU', - 'GPU', - ], - ], - ], - 'required' => false, - ], - 'required' => false, - ], - ], - 'required' => false, - ], + 'schema' => ['description' => '用于加密云盘数据的密钥ID。'."\n" + .'> 仅当AnalyticDB MySQL集群开启云盘加密时才会使用该参数。', 'type' => 'string', 'required' => false, 'example' => 'e1935511-cf88-1123-a0f8-1be8d251****'."\n"], ], [ - 'name' => 'GpuElasticPlan', + 'name' => 'DiskEncryption', 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'Enabled' => [ - 'type' => 'boolean', - 'required' => false, - ], - 'Rules' => [ - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'StartCronExpression' => [ - 'type' => 'string', - 'required' => false, - ], - 'EndCronExpression' => [ - 'type' => 'string', - 'required' => false, - ], - ], - 'required' => false, - ], - 'required' => false, - ], - ], - 'required' => false, - ], + 'schema' => ['description' => '是否开启云盘加密。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A94B6C02-7BD4-5D67-9776-3AC8317E8DD5', - ], - ], - ], - ], - ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidPoolName.Malformed', - 'errorMessage' => 'The specified parameter PoolName is not valid.', - ], - [ - 'errorCode' => 'InvalidPoolUser.Malformed', - 'errorMessage' => 'The specified parameter PoolUser is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'InvalidPoolType.Malformed', - 'errorMessage' => 'The specified parameter PoolType is not valid.', - ], - [ - 'errorCode' => 'InvalidMinComputeResource.Malformed', - 'errorMessage' => 'The specified parameter MinComputeResource is not valid.', - ], - [ - 'errorCode' => 'InvalidMaxComputeResource.Malformed', - 'errorMessage' => 'The specified parameter MaxComputeResource is not valid.', - ], - [ - 'errorCode' => 'ACS.ResourceGroup.InvalidResourceGroupState', - 'errorMessage' => 'The state of this resource group does not support this operation.', - ], + [ + 'name' => 'CloneSourceRegionId', + 'in' => 'query', + 'allowEmptyValue' => false, + 'schema' => ['title' => '克隆源实例所在区域，跨域克隆必填，同域克隆可不填。', 'description' => '源集群所在的地域。'."\n" + .'> 跨地域克隆时该参数必填。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'], ], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A94B6C02-7BD4-5D67-9776-3AC8317E8DD5\\"\\n}","errorExample":""},{"type":"xml","example":"<CreateDBResourceGroupResponse>\\n <RequestId>A94B6C02-7BD4-5D67-9776-3AC8317E8DD5</RequestId>\\n</CreateDBResourceGroupResponse>","errorExample":""}]', - 'title' => '创建资源组', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeDBResourceGroup' => [ - 'summary' => '查询集群的资源组信息。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ [ - 'AK' => [], + 'name' => 'ProductVersion', + 'in' => 'query', + 'schema' => ['description' => '产品版本。取值为：'."\n" + .'- **BasicVersion**：基础版。'."\n" + .'- **EnterpriseVersion**：企业版。'."\n" + .'> 仅ProductForm取值为IntegrationForm时，填写该参数', 'type' => 'string', 'required' => false, 'example' => 'BasicVersion'], ], - ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '136430', - 'abilityTreeNodes' => [ - 'FEATUREadsYXZ2UA', + [ + 'name' => 'SecondaryZoneId', + 'in' => 'query', + 'schema' => ['description' => '备可用区ID。'."\n" + .'> 本参数和ZoneId参数传入的值不能相同。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing-h'], ], - ], - 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'SecondaryVSwitchId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版的集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'schema' => ['description' => '备虚拟交换机ID。'."\n" + .'> 本参数和VSwitchId参数传入的值不能相同。', 'type' => 'string', 'required' => false, 'example' => 'vsw-bp1aadw9k19x451gx****'], ], [ - 'name' => 'GroupName', + 'name' => 'EnableSSL', 'in' => 'query', - 'schema' => [ - 'description' => '资源组名称。'."\n" - .'> 此参数不填写时，默认返回指定集群的所有资源组信息。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_group', - ], + 'schema' => ['description' => '是否开启SSL链路加密功能，取值：'."\n" + ."\n" + .'- **true**：开启。'."\n" + .'- **false**：关闭。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], ], [ - 'name' => 'GroupType', + 'name' => 'AINodeSpec', 'in' => 'query', - 'schema' => [ - 'description' => '资源组类型，取值：'."\n" - .'- **Interactive**'."\n" - .'- **Job**'."\n" - .'> 关于湖仓版资源组的详细信息，请参见[资源组介绍](~~428610~~)。', - 'type' => 'string', - 'required' => false, - 'example' => 'Job', - ], + 'schema' => ['title' => 'AI节点规格', 'type' => 'string', 'example' => 'ADB.MLPlus.4'], ], [ - 'name' => 'RegionId', + 'name' => 'AINodeNumber', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用 [DescribeRegions](~~612393~~) 接口查看集群的地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['title' => 'AI节点数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A94B6C02-7BD4-5D67-9776-3AC8317E8DD3', - ], - 'GroupsInfo' => [ - 'description' => '资源组信息列表。', - 'type' => 'array', - 'items' => [ - 'description' => '资源组信息列表。', - 'type' => 'object', - 'properties' => [ - 'GroupType' => [ - 'description' => '资源组类型，取值：'."\n" - .'- **Interactive**'."\n" - .'- **Job**'."\n" - .'> 关于湖仓版资源组的详细信息，请参见[资源组介绍（湖仓版）](~~428610~~)。', - 'type' => 'string', - 'example' => 'Job', - ], - 'GroupName' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'example' => 'test1', - ], - 'MinComputeResource' => [ - 'description' => '最小计算预留资源，单位为ACU。'."\n", - 'type' => 'string', - 'example' => '0ACU', - ], - 'MaxComputeResource' => [ - 'description' => '最大计算预留资源，单位为ACU。', - 'type' => 'string', - 'example' => '512ACU', - ], - 'ClusterSizeResource' => [ - 'description' => '预留参数，不涉及', - 'type' => 'string', - 'example' => '预留参数，不涉及', - ], - 'MinClusterCount' => [ - 'description' => '预留参数，不涉及', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '预留参数，不涉及', - ], - 'MaxClusterCount' => [ - 'description' => '预留参数，不涉及', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '预留参数，不涉及', - ], - 'RunningClusterCount' => [ - 'description' => '预留参数，不涉及', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '预留参数，不涉及', - ], - 'ClusterMode' => [ - 'description' => '预留参数，不涉及', - 'type' => 'string', - 'example' => '预留参数，不涉及', - ], - 'ElasticMinComputeResource' => [ - 'description' => '最小计算弹性资源，单位为ACU。', - 'type' => 'string', - 'example' => '16ACU', - ], - 'EnableSpot' => [ - 'description' => '资源组是否开启竞价实例功能。开启竞价实例后资源单价降低，但是有概率被释放。取值：'."\n" - .'- **True**：开启竞价实例功能。'."\n" - .'- **False**：关闭竞价实例功能。'."\n" - ."\n" - .'仅Job型资源组可以为True。', - 'type' => 'string', - 'example' => 'True', - ], - 'GroupUsers' => [ - 'description' => '资源组绑定的RAM用户。', - 'type' => 'string', - 'example' => 'testb,testc', - ], - 'CreateTime' => [ - 'description' => '资源组创建时间，UTC时间，格式为<i>yyyy-MM-ddTHH:mm:ssZ</i>。', - 'type' => 'string', - 'example' => '2022-08-29T03:34:30Z', - ], - 'UpdateTime' => [ - 'description' => '更新时间，UTC时间，格式为<i>yyyy-MM-ddTHH:mm:ssZ</i>。', - 'type' => 'string', - 'example' => '2022-08-31T03:34:30Z', - ], - 'Status' => [ - 'description' => '资源组状态，取值说明：'."\n" - .'- **creating**：创建中'."\n" - .'- **ok**：创建成功'."\n" - .'- **pendingdelete**：等待删除', - 'type' => 'string', - 'example' => 'ok', - ], - 'Rules' => [ - 'description' => '作业投递规则。', - 'type' => 'array', - 'items' => [ - 'description' => '规则信息列表。', - 'type' => 'object', - 'properties' => [ - 'GroupName' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'example' => 'user_default', - ], - 'QueryTime' => [ - 'description' => '查询执行时间阈值，单位为毫秒（ms）。', - 'type' => 'string', - 'example' => '180000', - ], - 'TargetGroupName' => [ - 'description' => '目标资源组名称。', - 'type' => 'string', - 'example' => 'job', - ], - ], - ], - ], - 'Engine' => [ - 'type' => 'string', - ], - 'Message' => [ - 'type' => 'string', - 'required' => true, - ], - 'AutoStopInterval' => [ - 'type' => 'string', - ], - 'SpecName' => [ - 'type' => 'string', - ], - 'TargetResourceGroupName' => [ - 'type' => 'string', - ], - 'MinGpuQuantity' => [ - 'type' => 'integer', - 'format' => 'int32', - ], - 'MaxGpuQuantity' => [ - 'type' => 'integer', - 'format' => 'int32', - ], - 'RayConfig' => [ - 'type' => 'object', - 'properties' => [ - 'EnableUserEni' => [ - 'type' => 'boolean', - ], - 'HeadSpecType' => [ - 'type' => 'string', - ], - 'HeadSpec' => [ - 'type' => 'string', - ], - 'HeadAllocateUnit' => [ - 'type' => 'string', - ], - 'HeadDiskCapacity' => [ - 'type' => 'string', - ], - 'Category' => [ - 'type' => 'string', - 'enum' => [ - 'Basic', - 'HighAvailability', - ], - ], - 'WorkerGroups' => [ - 'title' => 'Ray Worker组列表', - 'description' => 'Ray Worker组列表', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'GroupName' => [ - 'title' => 'Ray Worker组名', - 'description' => 'Ray Worker组名', - 'type' => 'string', - 'example' => 'g01', - ], - 'AllocateUnit' => [ - 'title' => '分配单元', - 'description' => '分配单元', - 'type' => 'string', - 'example' => '1', - ], - 'MaxWorkerQuantity' => [ - 'title' => '最大Worker个数', - 'description' => '最大Worker个数', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'MinWorkerQuantity' => [ - 'title' => '最小Worker个数', - 'description' => '最小Worker个数', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'WorkerDiskCapacity' => [ - 'title' => '每个Worker磁盘大小', - 'description' => '每个Worker磁盘大小', - 'type' => 'string', - 'example' => '100G', - ], - 'WorkerSpecName' => [ - 'title' => 'Worker资源型号', - 'description' => 'Worker资源型号', - 'type' => 'string', - 'example' => 'large', - ], - 'WorkerSpecType' => [ - 'title' => 'Ray Worker资源类型', - 'description' => 'Ray Worker资源类型', - 'type' => 'string', - 'example' => 'CPU', - 'enum' => [ - 'CPU', - 'GPU', - ], - ], - ], - ], - ], - 'RayClusterAddress' => [ - 'title' => 'Ray Cluster地址', - 'description' => 'Ray Cluster地址', - 'type' => 'string', - 'example' => 'http://ray-cluster-address.example.com', - ], - 'RayDashboardAddress' => [ - 'title' => 'Ray Dashboard地址', - 'description' => 'Ray Dashboard地址', - 'type' => 'string', - 'example' => 'http://ray-dashboard-address.example.com', - ], - 'RayGrafanaAddress' => [ - 'title' => 'Ray Grafana地址', - 'description' => 'Ray Grafana地址', - 'type' => 'string', - 'example' => 'http://ray-grafana-address.example.com', - ], - 'AppConfig' => [ - 'title' => 'Ray应用配置', - 'description' => 'Ray应用配置', - 'type' => 'object', - 'properties' => [ - 'AppName' => [ - 'title' => 'Ray应用名', - 'description' => 'Ray应用名', - 'type' => 'string', - 'example' => 'app01', - ], - 'AppType' => [ - 'title' => 'Ray应用类型', - 'description' => 'Ray应用类型', - 'type' => 'string', - 'example' => 'IsaacLab', - ], - 'ImageSelector' => [ - 'title' => '镜像配置', - 'description' => '镜像配置', - 'type' => 'object', - 'properties' => [ - 'Image' => [ - 'title' => '镜像', - 'description' => '镜像', - 'type' => 'string', - 'example' => 'lab2.10.0-ray2.43.0', - ], - 'InferenceEngine' => [ - 'title' => '推理引擎', - 'description' => '推理引擎', - 'type' => 'string', - 'example' => 'vLLM', - ], - 'LlmModel' => [ - 'title' => 'LLM模型', - 'description' => 'LLM模型', - 'type' => 'string', - 'example' => 'Deepseek-R1', - ], - ], - ], - ], - ], - 'StorageMounts' => [ - 'title' => '挂载存储列表', - 'description' => '挂载存储列表', - 'type' => 'array', - 'items' => [ - 'title' => '挂载存储', - 'description' => '挂载存储', - 'type' => 'object', - 'properties' => [ - 'StorageId' => [ - 'title' => '存储ID', - 'description' => '存储ID', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'MountPath' => [ - 'title' => '挂载路径', - 'description' => '挂载路径', - 'type' => 'string', - 'example' => '/mnt/data01', - ], - ], - ], - ], - ], - ], - 'GpuElasticPlan' => [ - 'type' => 'object', - 'properties' => [ - 'Enabled' => [ - 'type' => 'boolean', - ], - 'Rules' => [ - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'StartCronExpression' => [ - 'type' => 'string', - ], - 'EndCronExpression' => [ - 'type' => 'string', - ], - ], - ], - ], - ], - ], - 'EngineParams' => [ - 'title' => '引擎参数', - 'description' => '引擎参数', - 'type' => 'object', - 'additionalProperties' => [ - 'title' => '引擎参数', - 'description' => '引擎参数', - 'type' => 'any', - 'example' => '', - ], - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'ResourceGroupId' => ['description' => '默认资源组的ID。', 'type' => 'string', 'example' => 'rg-4690g37929****'], + 'DBClusterId' => ['description' => 'AnalyticDB MySQL湖仓版（3.0）集群ID。', 'type' => 'string', 'example' => 'amv-bp1r053byu48p****'], + 'OrderId' => ['description' => '订单ID。', 'type' => 'string', 'example' => '202353278****'], ], - ], - ], - ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidPoolName.Malformed', - 'errorMessage' => 'The specified parameter PoolName is not valid.', - ], - [ - 'errorCode' => 'InvalidPoolUser.Malformed', - 'errorMessage' => 'The specified parameter PoolUser is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'InvalidPoolType.Malformed', - 'errorMessage' => 'The specified parameter PoolType is not valid.', - ], - [ - 'errorCode' => 'InvalidMinComputeResource.Malformed', - 'errorMessage' => 'The specified parameter MinComputeResource is not valid.', - ], - [ - 'errorCode' => 'InvalidMaxComputeResource.Malformed', - 'errorMessage' => 'The specified parameter MaxComputeResource is not valid.', - ], - ], - 408 => [ - [ - 'errorCode' => 'AcsServerTimeOut', - 'errorMessage' => 'The request has failed due to Adb Cloud Service time out.', + 'description' => '', ], ], ], @@ -6263,19 +3607,48 @@ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A94B6C02-7BD4-5D67-9776-3AC8317E8DD3\\",\\n \\"GroupsInfo\\": [\\n {\\n \\"GroupType\\": \\"Job\\",\\n \\"GroupName\\": \\"test1\\",\\n \\"MinComputeResource\\": \\"0ACU\\",\\n \\"MaxComputeResource\\": \\"512ACU\\",\\n \\"ClusterSizeResource\\": \\"预留参数，不涉及\\",\\n \\"MinClusterCount\\": 0,\\n \\"MaxClusterCount\\": 0,\\n \\"RunningClusterCount\\": 0,\\n \\"ClusterMode\\": \\"预留参数，不涉及\\",\\n \\"ElasticMinComputeResource\\": \\"16ACU\\",\\n \\"EnableSpot\\": \\"True\\",\\n \\"GroupUsers\\": \\"testb,testc\\",\\n \\"CreateTime\\": \\"2022-08-29T03:34:30Z\\",\\n \\"UpdateTime\\": \\"2022-08-31T03:34:30Z\\",\\n \\"Status\\": \\"ok\\",\\n \\"Rules\\": [\\n {\\n \\"GroupName\\": \\"user_default\\",\\n \\"QueryTime\\": \\"180000\\",\\n \\"TargetGroupName\\": \\"job\\"\\n }\\n ],\\n \\"Engine\\": \\"\\",\\n \\"Message\\": \\"\\",\\n \\"AutoStopInterval\\": \\"\\",\\n \\"SpecName\\": \\"\\",\\n \\"TargetResourceGroupName\\": \\"\\",\\n \\"MinGpuQuantity\\": 0,\\n \\"MaxGpuQuantity\\": 0,\\n \\"RayConfig\\": {\\n \\"EnableUserEni\\": true,\\n \\"HeadSpecType\\": \\"\\",\\n \\"HeadSpec\\": \\"\\",\\n \\"HeadAllocateUnit\\": \\"\\",\\n \\"HeadDiskCapacity\\": \\"\\",\\n \\"Category\\": \\"\\",\\n \\"WorkerGroups\\": [\\n {\\n \\"GroupName\\": \\"g01\\",\\n \\"AllocateUnit\\": \\"1\\",\\n \\"MaxWorkerQuantity\\": 1,\\n \\"MinWorkerQuantity\\": 1,\\n \\"WorkerDiskCapacity\\": \\"100G\\",\\n \\"WorkerSpecName\\": \\"large\\",\\n \\"WorkerSpecType\\": \\"CPU\\"\\n }\\n ],\\n \\"RayClusterAddress\\": \\"http://ray-cluster-address.example.com\\",\\n \\"RayDashboardAddress\\": \\"http://ray-dashboard-address.example.com\\",\\n \\"RayGrafanaAddress\\": \\"http://ray-grafana-address.example.com\\",\\n \\"AppConfig\\": {\\n \\"AppName\\": \\"app01\\",\\n \\"AppType\\": \\"IsaacLab\\",\\n \\"ImageSelector\\": {\\n \\"Image\\": \\"lab2.10.0-ray2.43.0\\",\\n \\"InferenceEngine\\": \\"vLLM\\",\\n \\"LlmModel\\": \\"Deepseek-R1\\"\\n }\\n },\\n \\"StorageMounts\\": [\\n {\\n \\"StorageId\\": 1,\\n \\"MountPath\\": \\"/mnt/data01\\"\\n }\\n ]\\n },\\n \\"GpuElasticPlan\\": {\\n \\"Enabled\\": true,\\n \\"Rules\\": [\\n {\\n \\"StartCronExpression\\": \\"\\",\\n \\"EndCronExpression\\": \\"\\"\\n }\\n ]\\n },\\n \\"EngineParams\\": {\\n \\"key\\": \\"\\"\\n }\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeDBResourceGroupResponse>\\n <RequestId>A94B6C02-7BD4-5D67-9776-3AC8317E8DD3</RequestId>\\n <GroupsInfo>\\n <GroupType>Job</GroupType>\\n <GroupName>test1</GroupName>\\n <MinComputeResource>0ACU</MinComputeResource>\\n <MaxComputeResource>512ACU</MaxComputeResource>\\n <ClusterSizeResource>预留参数，不涉及</ClusterSizeResource>\\n <ClusterMode>预留参数，不涉及</ClusterMode>\\n <ElasticMinComputeResource>16ACU</ElasticMinComputeResource>\\n <EnableSpot>True</EnableSpot>\\n <GroupUsers>testb,testc</GroupUsers>\\n <CreateTime>2022-08-29T03:34:30Z</CreateTime>\\n <UpdateTime>2022-08-31T03:34:30Z</UpdateTime>\\n <Status>ok</Status>\\n <Rules/>\\n </GroupsInfo>\\n</DescribeDBResourceGroupResponse>","errorExample":""}]', - 'title' => '查询资源组', + 'title' => '创建集群', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'ModifyDBResourceGroup' => [ - 'summary' => '变更集群的资源组。', - 'methods' => [ - 'post', + 'changeSet' => [ + ['createdAt' => '2025-09-23T08:52:46.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2025-04-17T08:45:34.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2025-04-12T03:04:19.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2025-02-27T02:22:57.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-09-24T09:29:31.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-05-23T06:30:01.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-05-09T03:29:13.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-08-28T06:20:13.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-07-27T11:22:29.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-11-07T06:19:23.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-11-03T03:01:24.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-11T16:52:03.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateDBCluster'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateDBCluster', + 'authLevel' => 'resource', + 'actionConditions' => [ + ['conditionKey' => 'adb:DiskEncryption', 'validationType' => 'always'], + ['conditionKey' => 'adb:EnableSSL', 'validationType' => 'always'], + ], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"ResourceGroupId\\": \\"rg-4690g37929****\\",\\n \\"DBClusterId\\": \\"amv-bp1r053byu48p****\\",\\n \\"OrderId\\": \\"202353278****\\"\\n}","errorExample":""},{"type":"xml","example":"<CreateDBClusterResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <ResourceGroupId>rg-4690g37929****</ResourceGroupId>\\n <DBClusterId>amv-bp1r053byu48p****</DBClusterId>\\n <OrderId>202353278****</OrderId>\\n</CreateDBClusterResponse>","errorExample":""}]', + ], + 'CreateDBResourceGroup' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -6284,36 +3657,25 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'create', 'riskType' => 'none', - 'chargeType' => 'paid', - 'abilityTreeCode' => '136445', - 'abilityTreeNodes' => [ - 'FEATUREadsYXZ2UA', - ], + 'chargeType' => 'free', + 'abilityTreeCode' => '136449', + 'abilityTreeNodes' => ['FEATUREadsYXZ2UA'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版的集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1r053byu48p****', - ], + 'schema' => ['description' => '企业版、基础版或湖仓版集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ 'name' => 'GroupName', 'in' => 'query', - 'schema' => [ - 'description' => '资源组名称。'."\n" - .'> 您可以调用[DescribeDBResourceGroup](~~459446~~)接口查看指定集群的资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'schema' => ['description' => '资源组名称。'."\n" + .'- 长度不超过255个字符。'."\n" + .'- 必须以数字、大写字母或小写字母开头。'."\n" + .'- 可包含数字、大写字母、小写字母、中划线（-）和下划线（_）。', 'type' => 'string', 'required' => true, 'example' => 'test_group'], ], [ 'name' => 'GroupType', @@ -6322,103 +3684,61 @@ 'description' => '资源组类型，取值：'."\n" .'- **Interactive**'."\n" .'- **Job**'."\n" - .'> 关于湖仓版资源组的详细信息，请参见[资源组介绍](~~428610~~)。', + .'> 关于湖仓版资源组的详细信息，请参见[资源组介绍（湖仓版）](~~428610~~)。', 'type' => 'string', 'required' => true, 'docRequired' => true, - 'example' => 'Interactive', + 'example' => 'Job', 'enum' => [], ], ], [ 'name' => 'MinComputeResource', 'in' => 'query', - 'schema' => [ - 'title' => '', - 'description' => '最小计算预留资源。'."\n" - .'- 当资源组类型为Interactive时，计算预留资源最小为16ACU。'."\n" - .'- 当资源组类型为Job时，计算预留资源最小为0ACU。', - 'type' => 'string', - 'required' => false, - 'example' => '0ACU', - ], + 'schema' => ['title' => '', 'description' => '最小计算预留资源，单位为ACU。'."\n" + .'- 当资源组类型为Interactive时，计算预留资源最小为16 ACU。'."\n" + .'- 当资源组类型为Job时，计算预留资源最小为0 ACU。', 'type' => 'string', 'required' => false, 'example' => '0ACU'], ], [ 'name' => 'MaxComputeResource', 'in' => 'query', - 'schema' => [ - 'description' => '最大计算预留资源。'."\n" - .'- 当资源组类型为Interactive时，计算预留资源最大为集群当前未分配资源，步长为16ACU。'."\n" - .'- 当资源组类型为Job时，计算预留资源最大为集群当前未分配资源，步长为8ACU。', - 'type' => 'string', - 'required' => false, - 'example' => '48ACU', - ], + 'schema' => ['description' => '最大计算预留资源，单位为ACU。'."\n" + .'- 当资源组类型为Interactive时，计算预留资源最大为集群当前未分配资源，步长为16 ACU。'."\n" + .'- 当资源组类型为Job时，计算预留资源最大为集群当前未分配资源，步长为8 ACU。', 'type' => 'string', 'required' => false, 'example' => '48ACU'], ], [ 'name' => 'ClusterSizeResource', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数（不涉及）。', - 'type' => 'string', - 'required' => false, - 'example' => '无', - ], + 'schema' => ['description' => '预留参数（不涉及）', 'type' => 'string', 'required' => false, 'example' => '-'], ], [ 'name' => 'MinClusterCount', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数（不涉及）。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '无'."\n", - ], + 'schema' => ['description' => '预留参数（不涉及）', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '-'."\n"], ], [ 'name' => 'MaxClusterCount', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数（不涉及）。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '无', - ], + 'schema' => ['description' => '预留参数（不涉及）', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '-'], ], [ 'name' => 'ClusterMode', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数（不涉及）。', - 'type' => 'string', - 'required' => false, - 'example' => '无', - ], + 'schema' => ['description' => '预留参数（不涉及）', 'type' => 'string', 'required' => false, 'example' => '-'], ], [ 'name' => 'EnableSpot', 'in' => 'query', - 'schema' => [ - 'description' => '资源组是否开启竞价实例功能。开启竞价实例后资源单价降低，但是有概率被释放。仅Job型资源组可以开启。取值：'."\n" - .'- **True**：开启竞价实例功能。'."\n" - .'- **False**：关闭竞价实例功能。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'True', - ], + 'schema' => ['description' => '资源组是否开启竞价实例功能。开启竞价实例后资源单价降低，但是有概率被释放。仅Job型资源组可以开启。取值：'."\n" + .'- **True**：开启竞价实例功能。'."\n" + .'- **False**：关闭竞价实例功能。', 'type' => 'boolean', 'required' => false, 'example' => 'True'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定群的地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。'."\n" + ."\n" + .'> 您可以调用[DescribeRegions](~~612393~~)接口查看AnalyticDB MySQL湖仓版（3.0）集群的地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ 'name' => 'Rules', @@ -6431,24 +3751,12 @@ 'description' => '规则信息列表。', 'type' => 'object', 'properties' => [ - 'GroupName' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'user_default', - ], - 'QueryTime' => [ - 'description' => '查询执行时间阈值，单位为毫秒（ms）。', - 'type' => 'string', - 'required' => false, - 'example' => '180000'."\n", - ], - 'TargetGroupName' => [ - 'description' => '目标资源组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'job'."\n", - ], + 'GroupName' => ['description' => '资源组名称。'."\n" + .'- 长度不超过255个字符。'."\n" + .'- 必须以数字、大写字母或小写字母开头。'."\n" + .'- 可包含数字、大写字母、小写字母、中划线（-）和下划线（_）。', 'type' => 'string', 'required' => false, 'example' => 'test_group'], + 'QueryTime' => ['description' => '查询执行时间阈值，单位为毫秒（ms）。', 'type' => 'string', 'required' => false, 'example' => '180000'."\n"], + 'TargetGroupName' => ['description' => '目标资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'job'."\n"], ], 'required' => false, ], @@ -6456,119 +3764,65 @@ ], ], [ + 'name' => 'Engine', + 'in' => 'query', + 'schema' => ['description' => '数据库引擎，取值：'."\n" + ."\n" + .'- **AnalyticDB**（默认）：AnalyticDB for MySQL引擎。'."\n" + .'- **SparkWarehouse**：SparkWarehouse引擎。', 'type' => 'string', 'required' => false, 'example' => 'SparkWarehouse'], + ], + [ 'name' => 'EngineParams', 'in' => 'query', 'style' => 'json', - 'schema' => [ - 'description' => '引擎配置。', - 'type' => 'object', - 'required' => false, - 'example' => '{\\"spark.adb.version\\":\\"3.5\\"}', - ], + 'schema' => ['description' => '引擎配置。', 'type' => 'object', 'required' => false, 'example' => '{\\"spark.adb.version\\":\\"3.5\\"}'], ], [ 'name' => 'AutoStopInterval', 'in' => 'query', - 'schema' => [ - 'description' => '自动停止时间', - 'type' => 'string', - 'required' => false, - 'example' => '5m', - ], + 'schema' => ['description' => '自动停止时间，单位为分钟（m）。', 'type' => 'string', 'required' => false, 'example' => '5m'], ], [ 'name' => 'SpecName', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数，不涉及。', - 'type' => 'string', - 'required' => false, - 'example' => '预留参数，不涉及。', - ], + 'schema' => ['description' => '规格名。', 'type' => 'string', 'required' => false, 'example' => 'ADB.MLLarge.2'], ], [ 'name' => 'MinGpuQuantity', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数，不涉及。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '预留参数，不涉及。', - ], + 'schema' => ['description' => '最小GPU数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], ], [ 'name' => 'MaxGpuQuantity', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数，不涉及。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '预留参数，不涉及。', - ], + 'schema' => ['description' => '最大GPU数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '2'], ], [ 'name' => 'TargetResourceGroupName', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数，不涉及。', - 'type' => 'string', - 'required' => false, - 'example' => '预留参数，不涉及。', - ], - ], - [ - 'name' => 'Status', - 'in' => 'query', - 'schema' => [ - 'description' => '资源组状态。**starting** 表示启动资源组，**stopping**表示停止资源组', - 'type' => 'string', - 'required' => false, - 'example' => 'starting', - ], + 'schema' => ['description' => '目标资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ 'name' => 'RayConfig', 'in' => 'query', 'style' => 'json', 'schema' => [ - 'description' => 'Ray配置信息(当资源组为ai资源组且对应引擎为RayCluster时需要填写)', + 'description' => 'Ray配置信息。'."\n" + .'> 当资源组为AI资源组且对应引擎为RayCluster时需要填写。', 'type' => 'object', 'properties' => [ - 'EnableUserEni' => [ - 'type' => 'boolean', - 'required' => false, - ], + 'EnableUserEni' => ['description' => '是否打通用户ENI。', 'type' => 'boolean', 'required' => false], 'HeadSpecType' => [ 'description' => 'Head节点资源类型。', 'type' => 'string', 'required' => false, 'example' => 'CPU', 'default' => 'CPU', - 'enum' => [ - 'CPU', - 'GPU', - ], - ], - 'HeadSpec' => [ - 'description' => 'Head节点规格。', - 'type' => 'string', - 'required' => false, - 'example' => 'xlarge', - ], - 'HeadAllocateUnit' => [ - 'description' => 'Head节点分配单元。', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - 'HeadDiskCapacity' => [ - 'description' => 'Head节点磁盘大小。', - 'type' => 'string', - 'required' => false, - 'example' => '100G', + 'enum' => ['CPU', 'GPU'], ], + 'HeadSpec' => ['description' => 'Head节点规格', 'type' => 'string', 'required' => false, 'example' => 'xlarge'], + 'HeadAllocateUnit' => ['description' => 'Head节点分配单元。', 'type' => 'string', 'required' => false, 'example' => '1'], + 'HeadDiskCapacity' => ['description' => 'Head节点磁盘大小。', 'type' => 'string', 'required' => false, 'example' => '100G'], 'Category' => [ 'description' => 'Ray集群类型，取值说明：'."\n" ."\n" @@ -6578,10 +3832,7 @@ 'type' => 'string', 'required' => false, 'example' => 'BASIC', - 'enum' => [ - 'BASIC', - 'HIGH_AVAILABILITY', - ], + 'enum' => ['BASIC', 'HIGH_AVAILABILITY'], ], 'WorkerGroups' => [ 'description' => 'Ray Worker组配置信息列表。', @@ -6590,128 +3841,25 @@ 'description' => 'Ray Worker组配置信息。', 'type' => 'object', 'properties' => [ - 'AllocateUnit' => [ - 'description' => '分配单元', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - 'GroupName' => [ - 'description' => 'Worker组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], - 'MaxWorkerQuantity' => [ - 'description' => '最大Worker数量。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '2', - ], - 'MinWorkerQuantity' => [ - 'description' => '最小Worker数量。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], - 'WorkerDiskCapacity' => [ - 'description' => 'Worker节点的磁盘大小。', - 'type' => 'string', - 'required' => false, - 'example' => '100G', - ], - 'WorkerSpecName' => [ - 'description' => 'Worker节点规格。', - 'type' => 'string', - 'required' => false, - 'example' => 'xlarge', - ], + 'GroupName' => ['description' => 'Worker组名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], + 'AllocateUnit' => ['description' => '分配单元。', 'type' => 'string', 'required' => false, 'example' => '1'], + 'MaxWorkerQuantity' => ['description' => '最大worker数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '2'], + 'MinWorkerQuantity' => ['description' => '最小worker数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], + 'WorkerDiskCapacity' => ['description' => 'Worker节点的磁盘大小。', 'type' => 'string', 'required' => false, 'example' => '100G'], + 'WorkerSpecName' => ['description' => 'Worker节点规格。', 'type' => 'string', 'required' => false, 'example' => 'xlarge'], 'WorkerSpecType' => [ 'description' => 'Worker节点资源类型。', 'type' => 'string', 'required' => false, 'example' => 'GPU', - 'enum' => [ - 'CPU', - 'GPU', - ], - ], - ], - 'required' => false, - ], - 'required' => false, - ], - 'AppConfig' => [ - 'title' => 'Ray应用配置', - 'type' => 'object', - 'properties' => [ - 'AppName' => [ - 'title' => '应用名称', - 'type' => 'string', - 'required' => false, - 'example' => 'app01', - ], - 'AppType' => [ - 'title' => '应用类型', - 'type' => 'string', - 'required' => false, - 'example' => 'IsaacLab', - ], - 'ImageSelector' => [ - 'title' => '镜像配置', - 'type' => 'object', - 'properties' => [ - 'Image' => [ - 'title' => '镜像名', - 'type' => 'string', - 'required' => false, - 'example' => 'lab2.10.0-ray2.43.0', - ], - 'InferenceEngine' => [ - 'title' => '推理引擎', - 'type' => 'string', - 'required' => false, - 'example' => 'vLLM', - ], - 'LlmModel' => [ - 'title' => 'LLM模型', - 'type' => 'string', - 'required' => false, - 'example' => 'Deepseek-R1', - ], - ], - 'required' => false, - ], - ], - 'required' => false, - ], - 'StorageMounts' => [ - 'title' => '存储挂载列表', - 'type' => 'array', - 'items' => [ - 'title' => '存储挂载', - 'type' => 'object', - 'properties' => [ - 'StorageId' => [ - 'title' => '存储ID', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - ], - 'MountPath' => [ - 'title' => '挂载路径', - 'type' => 'string', - 'required' => false, - 'example' => '/mnt/data01', + 'enum' => ['CPU', 'GPU'], ], ], 'required' => false, ], 'required' => false, ], + 'UserDefinedRequirements' => ['type' => 'string'], ], 'required' => false, ], @@ -6721,25 +3869,22 @@ 'in' => 'query', 'style' => 'json', 'schema' => [ + 'description' => 'GPU分时弹性计划。', 'type' => 'object', 'properties' => [ - 'Enabled' => [ - 'type' => 'boolean', - 'required' => false, - ], + 'Enabled' => ['description' => '创建后是否立即启用弹性计划。'."\n" + .'取值说明：'."\n" + .'- true：立即启用。'."\n" + .'- false：不启用。'."\n", 'type' => 'boolean', 'required' => false, 'example' => 'true'], 'Rules' => [ + 'description' => '规则列表。', 'type' => 'array', 'items' => [ + 'description' => '规则。', 'type' => 'object', 'properties' => [ - 'StartCronExpression' => [ - 'type' => 'string', - 'required' => false, - ], - 'EndCronExpression' => [ - 'type' => 'string', - 'required' => false, - ], + 'StartCronExpression' => ['description' => '启动时间，Cron表达式，间隔不低于1小时。', 'type' => 'string', 'required' => false, 'example' => '0 0 2 * * ?'], + 'EndCronExpression' => ['description' => '结束时间，Cron 表达式，间隔不低于 1 小时。', 'type' => 'string', 'required' => false, 'example' => '0 0 3 * * ?'], ], 'required' => false, ], @@ -6749,114 +3894,58 @@ 'required' => false, ], ], - ], - 'responses' => [ - 200 => [ + [ + 'name' => 'ScalePolicy', + 'in' => 'query', 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '805F14E1-0186-520E-A6D5-30188D94E8DA', - ], - ], - ], - ], - ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidPoolName.Malformed', - 'errorMessage' => 'The specified parameter PoolName is not valid.', - ], - [ - 'errorCode' => 'InvalidPoolUser.Malformed', - 'errorMessage' => 'The specified parameter PoolUser is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'InvalidPoolType.Malformed', - 'errorMessage' => 'The specified parameter PoolType is not valid.', - ], - [ - 'errorCode' => 'InvalidMinComputeResource.Malformed', - 'errorMessage' => 'The specified parameter MinComputeResource is not valid.', - ], - [ - 'errorCode' => 'InvalidMaxComputeResource.Malformed', - 'errorMessage' => 'The specified parameter MaxComputeResource is not valid.', - ], - [ - 'errorCode' => 'ACS.ResourceGroup.ElasticPlanExists', - 'errorMessage' => 'This resource group does not support this operation. Elastic plans that have been enabled already exist.', - ], - [ - 'errorCode' => 'ACS.ResourceGroup.InvalidResourceGroupState', - 'errorMessage' => 'The state of this resource group does not support this operation.', + 'description' => '资源组的扩容策略，取值说明：'."\n" + .'- AutoScaling：开启自动弹性AutoScaling策略。'."\n" + .'- Disable：关闭自动弹性。'."\n" + .'- MultiCluster：开启自动弹性MultiCluster策略。', + 'type' => 'string', + 'required' => false, + 'example' => 'AutoScaling', + 'enum' => ['AutoScaling', 'Disable', 'MultiCluster'], ], ], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"805F14E1-0186-520E-A6D5-30188D94E8DA\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyDBResourceGroupResponse>\\n <RequestId>805F14E1-0186-520E-A6D5-30188D94E8DA</RequestId>\\n</ModifyDBResourceGroupResponse>","errorExample":""}]', - 'title' => '修改资源组', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DeleteDBResourceGroup' => [ - 'summary' => '调用CreateDBResourceGroup接口删除指定集群的资源组。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], - ], - ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - 'riskType' => 'none', - 'chargeType' => 'paid', - 'abilityTreeCode' => '136447', - 'abilityTreeNodes' => [ - 'FEATUREadsYXZ2UA', - ], - ], - 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'Classification', 'in' => 'query', 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版的集群ID。</props>', + 'description' => '资源组的分类，取值类型：'."\n" + .'- SQL'."\n" + .'- SparkSQL'."\n" + .'- MultiCluster'."\n" + .'- AI', 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', + 'required' => false, + 'example' => 'SQL', + 'enum' => ['SQL', 'SparkSQL', 'Job', 'AI'], ], ], [ - 'name' => 'GroupName', + 'name' => 'AtmConfig', 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => '资源组名称。'."\n" - .'> 您可以调用[DescribeDBResourceGroup](~~612410~~)接口查看指定集群的资源组信息，包括资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test_group', + 'type' => 'object', + 'properties' => [ + 'SelectNodeSpec' => ['type' => 'string', 'example' => '8ACU'], + 'SelectNodeNum' => ['type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'SelectNodeCacheSize' => ['type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'StorageNodeSpec' => ['type' => 'string', 'example' => '8ACU'], + 'StorageNodeNum' => ['type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'StorageNodeDiskSize' => ['type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'StorageNodeDiskType' => [ + 'type' => 'string', + 'example' => 'essd_pl1', + 'enum' => ['essd_pl1', 'essd_pl2'], + ], + 'InsertNodeSpec' => ['type' => 'string', 'example' => '8ACU'], + 'InsertNodeNum' => ['type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'AuthNodeSpec' => ['type' => 'string', 'example' => '8ACU'], + 'AuthNodeNum' => ['type' => 'integer', 'format' => 'int32', 'example' => '2'], + ], ], ], ], @@ -6867,436 +3956,354 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A94B6C02-7BD4-5D67-9776-3AC8317E8DD3', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'A94B6C02-7BD4-5D67-9776-3AC8317E8DD5'], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidPoolName.Malformed', - 'errorMessage' => 'The specified parameter PoolName is not valid.', - ], - [ - 'errorCode' => 'InvalidPoolUser.Malformed', - 'errorMessage' => 'The specified parameter PoolUser is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'ACS.ResourceGroup.ElasticPlanExists', - 'errorMessage' => 'This resource group does not support this operation. Elastic plans that have been enabled already exist.', - ], - [ - 'errorCode' => 'ACS.ResourceGroup.InvalidResourceGroupState', - 'errorMessage' => 'The state of this resource group does not support this operation.', - ], - [ - 'errorCode' => 'ACS.ResourceGroup.OngoingJobExists', - 'errorMessage' => 'Resource group has ongoing job(s).', - ], + ['errorCode' => 'InvalidPoolName.Malformed', 'errorMessage' => 'The specified parameter PoolName is not valid.', 'description' => 'PoolName参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPoolUser.Malformed', 'errorMessage' => 'The specified parameter PoolUser is not valid.', 'description' => 'PoolUser参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPoolType.Malformed', 'errorMessage' => 'The specified parameter PoolType is not valid.', 'description' => 'PoolType参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidMinComputeResource.Malformed', 'errorMessage' => 'The specified parameter MinComputeResource is not valid.', 'description' => 'MinComputeResource参数不正确，请确认参数是否符合规范。'."\n"], + ['errorCode' => 'InvalidMaxComputeResource.Malformed', 'errorMessage' => 'The specified parameter MaxComputeResource is not valid.', 'description' => 'MaxComputeResource参数不正确，请确认参数是否符合规范。'."\n"], + ['errorCode' => 'ACS.ResourceGroup.InvalidResourceGroupState', 'errorMessage' => 'The state of this resource group does not support this operation.', 'description' => '当前状态的资源组不支持此操作。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A94B6C02-7BD4-5D67-9776-3AC8317E8DD3\\"\\n}","errorExample":""},{"type":"xml","example":"<DeleteDBResourceGroupResponse>\\n <RequestId>A94B6C02-7BD4-5D67-9776-3AC8317E8DD3</RequestId>\\n</DeleteDBResourceGroupResponse>","errorExample":""}]', - 'title' => '删除资源组', + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '创建资源组', + 'summary' => '为指定的企业版、基础版或湖仓版集群创建资源组。', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'BindDBResourceGroupWithUser' => [ - 'summary' => '绑定资源组。', - 'methods' => [ - 'post', + 'changeSet' => [ + ['createdAt' => '2025-12-02T15:07:18.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2025-08-20T12:54:57.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2025-03-31T12:12:58.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-10-15T17:29:25.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-08-13T16:32:41.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-03-25T02:12:25.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-01-26T02:37:32.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-12-19T08:51:25.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-09-25T10:08:40.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-04-13T11:20:16.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-03-31T07:03:58.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:51:36.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateDBResourceGroup'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateDBResourceGroup', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A94B6C02-7BD4-5D67-9776-3AC8317E8DD5\\"\\n}","errorExample":""},{"type":"xml","example":"<CreateDBResourceGroupResponse>\\n <RequestId>A94B6C02-7BD4-5D67-9776-3AC8317E8DD5</RequestId>\\n</CreateDBResourceGroupResponse>","errorExample":""}]', + ], + 'CreateElasticPlan' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsYXZ2UA', - ], + 'operationType' => 'create', + 'abilityTreeNodes' => ['FEATUREadsL7JFYD'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'ElasticPlanName', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'am-bp1ub9grke1****', - ], + 'schema' => ['description' => '弹性计划名称。'."\n" + .'> 弹性计划名称的长度为2～30个字符，以字母开头，且只能由字母、数字和下划线组成。', 'type' => 'string', 'required' => true, 'example' => 'test'], ], [ - 'name' => 'GroupName', + 'name' => 'ResourceGroupName', 'in' => 'query', - 'schema' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test'."\n", - ], + 'schema' => ['description' => '资源组名称。'."\n" + ."\n" + .'>- 如果需要创建弹性资源类型为Interactive资源组的弹性计划（即计算资源类型的弹性计划），必须指定资源组名称。如果需要创建弹性资源类型为查询存储加速服务（EIU）的弹性计划，无需指定资源组名称。'."\n" + .'- 调用[DescribeDBResourceGroup](~~459446~~)接口可以查看指定集群的资源组名称。'."\n", 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ - 'name' => 'GroupUser', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '需要绑定的数据库账号。既可以绑定数据库普通账号，也可以绑定数据库高权限账号。', - 'type' => 'string', - 'required' => true, - 'example' => 'accout'."\n", - ], + 'schema' => ['description' => '开始时间。'."\n" + ."\n" + .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'required' => false, 'example' => '2022-01-01T12:01:00Z'], ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - ], - ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => '结束时间。'."\n" + ."\n" + .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'required' => false, 'example' => '2025-01-01T12:01:00Z'], ], - ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidPoolName.Malformed', - 'errorMessage' => 'The specified parameter PoolName is not valid.', - ], - [ - 'errorCode' => 'InvalidPoolUser.Malformed', - 'errorMessage' => 'The specified parameter PoolUser is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], + [ + 'name' => 'Enabled', + 'in' => 'query', + 'schema' => ['description' => '创建后是否立即启用弹性计划。'."\n" + .'取值说明：'."\n" + .'- true：立即启用。'."\n" + .'- false：不启用。'."\n", 'type' => 'boolean', 'required' => true, 'example' => 'true'], ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', - 'title' => '将资源组与数据库用户进行绑定', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'UnbindDBResourceGroupWithUser' => [ - 'summary' => '为AnalyticDB MySQL集群的资源组解绑数据库账号。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ [ - 'AK' => [], + 'name' => 'CronExpression', + 'in' => 'query', + 'schema' => ['description' => 'Cron表达式，表示弹性计划的变配周期和变配时间。'."\n" + ."\n" + .'>Type参数取值为EXECUTOR时，该参数必填。', 'type' => 'string', 'required' => false, 'example' => '0 20 14 * * ?'], ], - ], - 'operationType' => 'write', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsYXZ2UA', + [ + 'name' => 'TargetSize', + 'in' => 'query', + 'schema' => ['description' => '目标规格。'."\n" + .'> - 只有弹性资源类型为**存储加速服务弹性计划**并且启用了**存储加速服务(EIU)按比例默认弹性**，可以不填写该参数。其它情况下，该参数为必填项。'."\n" + .'> - 调用[DescribeElasticPlanSpecifications](~~601278~~)接口可以查看弹性计划支持的弹性变配规格。', 'type' => 'string', 'required' => false, 'example' => '32ACU'], ], - ], - 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'Type', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'am-bp1ub9grke1****', - ], + 'schema' => ['description' => '弹性计划类型。'."\n" + .'取值说明：'."\n" + .'- EXECUTOR：Interactive资源组，即计算资源类型。'."\n" + .'- WORKER：存储加速服务（EIU）。', 'type' => 'string', 'required' => true, 'example' => 'EXECUTOR'], ], [ - 'name' => 'GroupName', + 'name' => 'AutoScale', 'in' => 'query', - 'schema' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['description' => '是否启用**存储加速服务(EIU)按比例默认弹性**。'."\n" + .'取值说明：'."\n" + .'- true：启用。启用后，存储资源会跟随计算资源的弹性伸缩而伸缩，且不支持填写目标规格和Cron表达式。'."\n" + .'- false：不启用。'."\n" + .'>- Type为WORKER时，本参数必填。Type为EXECUTOR时，本参数不填。'."\n" + .'> - 整个集群只支持启用一个存储加速服务(EIU)按比例默认弹性的存储弹性计划，启用了此类型的弹性计划以后，无法再启用其他的存储弹性计划。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], ], [ - 'name' => 'GroupUser', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '解绑的数据库账号。', - 'type' => 'string', - 'required' => false, - 'example' => 'user1', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~454250~~)接口查看集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-wz9509beptiz****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'title' => 'BaseResponse', + 'description' => 'BaseResponse', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD'], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidPoolName.Malformed', - 'errorMessage' => 'The specified parameter PoolName is not valid.', - ], - [ - 'errorCode' => 'InvalidPoolUser.Malformed', - 'errorMessage' => 'The specified parameter PoolUser is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], + ['errorCode' => 'ACS.ElasticPlan.InvalidEndTime', 'errorMessage' => 'The end time should be later than current time.', 'description' => '分时弹性的结束时间应该晚于当前时间。'], + ['errorCode' => 'ACS.ElasticPlan.NameAlreadyExists', 'errorMessage' => 'The name already exists.', 'description' => '存在同名的弹性计划。'], + ['errorCode' => 'ACS.ElasticPlan.WorkerNotFound', 'errorMessage' => 'Worker not found.', 'description' => '此实例没有预留存储资源，无法设置存储弹性计划。'], + ['errorCode' => 'ACS.ElasticPlan.AutoWorkerPlanExists', 'errorMessage' => 'Failed to enable the elastic plan. The instance already has an active elastic plan.', 'description' => '启用此存储弹性计划失败，当前实例存在启用的存储自动弹性计划。'], + ['errorCode' => 'ACS.ElasticPlan.WorkerPlanExists', 'errorMessage' => 'Failed to enable the elastic plan. At least one active elastic plan already exists.', 'description' => '启用存储自动弹性计划失败，当前存在另外一个启用的存储弹性计划。'], + ['errorCode' => 'ACS.ElasticPlan.InvalidStartTimeInterval', 'errorMessage' => 'The start time of this elastic plan is too closed to another one.', 'description' => '此弹性计划的启用时间和另外一个弹性计划过于接近。'], + ['errorCode' => 'ACS.ElasticPlan.InvalidTodayPlan', 'errorMessage' => 'Failed to enable this elastic plan. Today\'s schedule time is missed and you should prepare at least %s minutes for us to prepare resource.', 'description' => '启用弹性计划失败。今天的弹性变配功能已经无法于弹性计划配置的变配时间进行触发，请检查配置的时间是否晚于可变配时间（当前时间加上资源准备时间%s分钟）。'], + ['errorCode' => 'ACS.ElasticPlan.InvalidTargetSize', 'errorMessage' => 'Invalid target size.', 'description' => '无效的目标规格'], + ['errorCode' => 'ACS.ElasticPlan.InvalidStartTime', 'errorMessage' => 'Invalid start time.', 'description' => '弹性计划开始时间填写不正确'], + ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', - 'title' => '解绑资源组和用户', + 'title' => '创建弹性计划', + 'summary' => '创建集群的弹性计划。', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeComputeResourceUsage' => [ - 'summary' => '查询集群资源组计算资源使用情况。', - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2023-06-30T02:18:58.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-04-14T08:51:07.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-04-13T11:20:17.000Z', 'description' => '错误码发生变更、响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateElasticPlan'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateElasticPlan', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<CreateElasticPlanResponse>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</CreateElasticPlanResponse>","errorExample":""}]', + ], + 'CreateFormationCrawler' => [ + 'summary' => '在ADB实例中创建Formation Crawler元数据发现任务。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'none', + 'abilityTreeCode' => '136903', + 'abilityTreeNodes' => ['FEATUREadsQO9FPM'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'am-bp1xxxxxxxx47', - ], - ], - [ - 'name' => 'ResourceGroupName', - 'in' => 'query', - 'schema' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '实例所在地域标识'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-beijing'], ], [ - 'name' => 'StartTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。', - 'type' => 'string', - 'required' => true, - 'example' => '2023-02-04T03:45:00Z', - ], + 'name' => 'CrawlerInfo', + 'in' => 'formData', + 'schema' => ['description' => 'Crawler 完整配置信息的 JSON 字符串。此字段为最核心参数，其内部 JSON 结构详见 CrawlerInfo 结构定义 章节', 'type' => 'string', 'required' => true, 'example' => '{"sourceType":"OSSWAREHOUSE","dbName":"sales_db","sourceInfo":{"ossSourceInfo":{"sourceMode":"WAREHOUSE","ossLocations":"oss://test-bucket/***/***/","inclusions":[],"exclusions":[]}},"classifiers":"[]","frequency":{"type":"run_on_demand","cron":""},"configuration":"","schemaChangePolicy":{"updateRule":"ONLY_ADD_COLUMN","deleteRule":"IGNORE"}}'], ], [ - 'name' => 'EndTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间。格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', - 'type' => 'string', - 'required' => true, - 'example' => '2023-02-05T03:45:00Z', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => 'ADB 实例 ID，资源级别的操作范围'."\n", 'type' => 'string', 'required' => true, 'example' => 'am-bp*****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', - 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEAW', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Data' => [ - 'description' => '返回结果数据。', - 'type' => 'object', - 'properties' => [ - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-clusterxxx', - ], - 'ResourceGroupType' => [ - 'description' => '资源组的类型。', - 'type' => 'string', - 'example' => 'interative', - ], - 'ResourceGroupName' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'StartTime' => [ - 'description' => '查询开始时间，格式为：yyyy-MM-ddTHH:mmZ。', - 'type' => 'string', - 'example' => '2023-04-24T07:00:00Z', - ], - 'EndTime' => [ - 'description' => '查询结束时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。', - 'type' => 'string', - 'example' => '2023-06-07T02:37:00Z', - ], - 'AcuInfo' => [ - 'description' => '集群ACU资源使用情况。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '对应指标项取值的状态，取值说明：'."\n" - .'- `TotalAcuNumber`：总ACU资源数。'."\n" - .'- `ReservedAcuNumber`：预留资源ACU数。'."\n" - .'- `ReservedAcuUsageNumber`：已使用的预留资源ACU数。', - 'type' => 'string', - 'example' => 'TotalAcuNumber', - ], - 'Values' => [ - 'description' => '对应指标项在各时间点取值列表。', - 'type' => 'array', - 'items' => [ - 'description' => '对应指标项在各时间点的具体取值。', - 'type' => 'string', - 'example' => '16.0', - ], - ], - ], - ], - ], - ], - ], + 'HttpStatusCode' => ['description' => 'HTTP 状态码，正常为 200'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '请求是否处理成功'."\n", 'type' => 'boolean', 'example' => 'True'], + 'RequestId' => ['description' => '请求追踪 ID'."\n", 'type' => 'string', 'example' => '019F3BE7-E8FA-3DC5-8EE7-501A90B5A54D'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'True'], + 'Code' => ['description' => '状态码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '提示信息，成功时为 OK'."\n", 'type' => 'string', 'example' => 'OK'], + 'TaskId' => ['description' => '操作结果，true 表示创建成功'."\n", 'type' => 'string', 'example' => '241'], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEAW\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"DBClusterId\\": \\"amv-clusterxxx\\",\\n \\"ResourceGroupType\\": \\"interative\\",\\n \\"ResourceGroupName\\": \\"test\\",\\n \\"StartTime\\": \\"2023-04-24T07:00:00Z\\",\\n \\"EndTime\\": \\"2023-06-07T02:37:00Z\\",\\n \\"AcuInfo\\": [\\n {\\n \\"Name\\": \\"TotalAcuNumber\\",\\n \\"Values\\": [\\n \\"16.0\\"\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '查询资源组计算资源使用情况', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'errorCodes' => [ + 409 => [ + ['errorCode' => 'AlreadyExists', 'errorMessage' => 'The formation task already exists. ', 'description' => ''], + ], + ], + 'title' => '创建元数据发现任务', + 'description' => '## 请求说明'."\n" + .'- 此接口用于在AnalyticDB for MySQL实例中创建一个Formation Crawler元数据发现任务。'."\n" + .'- 创建的任务配置不会立即执行，需调用`StartFormationCrawler`启动任务。'."\n" + .'- `CrawlerInfo`字段为JSON字符串，包含任务的核心配置信息，如目标数据库名、数据源类型等。'."\n" + .'- 注意部分参数（如`classifiers`、`frequency`）需要双重JSON编码。'."\n" + .'- 数据库名`dbName`会被服务端自动转为小写。'."\n" + .'- `schemaChangePolicy`是必填项，必须同时提供`updateRule`和`deleteRule`。'."\n" + .'- 推荐使用`RUN_ON_DEMAND`调度模式以避免不必要的重复扫描。'."\n" + .'- 确保产品名为`adb`，域名格式为`adb.{regionId}.aliyuncs.com`。'."\n" + .'- 创建后需手动调用`StartFormationCrawler`触发首次元数据发现。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": true,\\n \\"RequestId\\": \\"019F3BE7-E8FA-3DC5-8EE7-501A90B5A54D\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\",\\n \\"TaskId\\": \\"241\\"\\n}","type":"json"}]', ], - 'DescribeUserQuota' => [ - 'summary' => '查询可用配额。', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'CreateLakeStorage' => [ + 'summary' => '创建湖存储。', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '216925', + 'abilityTreeNodes' => ['FEATUREadsQO9FPM'], ], 'parameters' => [ [ + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => 'RegionId', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'Description', + 'in' => 'formData', + 'schema' => ['title' => '湖存储描述', 'description' => '湖存储描述', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1qjt3o18d8****', - 'enum' => [], - ], + 'in' => 'formData', + 'schema' => ['title' => 'ADB实例ID', 'description' => '湖存储绑定的ADB实例ID', 'type' => 'string', 'required' => false, 'example' => 'amv-******'], ], [ - 'name' => 'RegionId', - 'in' => 'query', + 'name' => 'Permissions', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', - 'type' => 'string', + 'title' => '湖存储权限', + 'description' => '创建湖存储时会自动给操作的RAM账号和主账号加上权限，此处可以增加额外的主账号授权', + 'type' => 'array', + 'items' => [ + 'title' => '权限项', + 'description' => '权限项', + 'type' => 'object', + 'properties' => [ + 'Read' => ['title' => '读权限', 'description' => '读权限', 'type' => 'boolean', 'required' => false, 'example' => '-'], + 'Write' => ['title' => '写权限', 'description' => '写权限', 'type' => 'boolean', 'required' => false, 'example' => '-'], + 'Account' => ['title' => '账户ID', 'description' => '账户ID', 'type' => 'string', 'required' => false, 'example' => '-', 'pattern' => '^\\d+$', 'default' => ''], + 'Type' => [ + 'title' => '账户类型', + 'description' => '账户类型', + 'type' => 'string', + 'required' => false, + 'example' => '-', + 'enum' => ['CUSTOMER', 'SUB', 'STS'], + ], + ], + 'required' => false, + ], 'required' => false, - 'example' => 'cn-hangzhou', + 'example' => '-', ], ], + [ + 'name' => 'ClientToken', + 'in' => 'query', + 'allowEmptyValue' => false, + 'schema' => ['title' => '幂等参数', 'description' => '-', 'type' => 'string', 'required' => false, 'example' => '******'], + ], ], 'responses' => [ 200 => [ @@ -7305,1676 +4312,1126 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '0322C7FB-4584-5D2A-BF7F-F9036E940C35', - ], - 'ElasticACU' => [ - 'description' => '可用弹性ACU。', - 'type' => 'string', - 'example' => '512 ACU', - ], - 'ResourceGroupCount' => [ - 'description' => '可用资源组数目。', - 'type' => 'string', - 'example' => '10', - ], - 'ReserverdCompteACU' => [ - 'description' => '可用预留计算资源。', - 'type' => 'string', - 'example' => '48 ACU', - ], - 'ReserverdStorageACU' => [ - 'description' => '可用存储计算资源。', - 'type' => 'string', - 'example' => '24 ACU', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '******'], + 'Message' => ['title' => '若创建接口为异步实现，则需返回明确的JobId。', 'description' => '若创建接口为异步实现，则需返回明确的JobId。', 'type' => 'string', 'example' => 'OK'], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => 'InvalidInput'], + 'Data' => ['description' => '集群资源使用详情。', 'type' => 'string', 'example' => 'true'], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], + ['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' => ''], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"0322C7FB-4584-5D2A-BF7F-F9036E940C35\\",\\n \\"ElasticACU\\": \\"512 ACU\\",\\n \\"ResourceGroupCount\\": \\"10\\",\\n \\"ReserverdCompteACU\\": \\"48 ACU\\",\\n \\"ReserverdStorageACU\\": \\"24 ACU\\"\\n}","type":"json"}]', - 'title' => '查询用户可用配额', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'CreateElasticPlan' => [ - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建湖存储', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateLakeStorage'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateLakeStorageBucket', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******\\",\\n \\"Message\\": \\"OK\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Data\\": \\"true\\"\\n}","type":"json"}]', + ], + 'CreateMaterializedViewRecommend' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'create', - 'abilityTreeNodes' => [ - 'FEATUREadsL7JFYD', - ], + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREadsTYGUV3'], ], 'parameters' => [ [ - 'name' => 'ElasticPlanName', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '弹性计划名称。'."\n" - .'> 弹性计划名称的长度为2～30个字符，以字母开头，且只能由字母、数字和下划线组成。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'ResourceGroupName', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '资源组名称。'."\n" - ."\n" - .'>- 如果需要创建弹性资源类型为Interactive资源组的弹性计划（即计算资源类型的弹性计划），必须指定资源组名称。如果需要创建弹性资源类型为查询存储加速服务（EIU）的弹性计划，无需指定资源组名称。'."\n" - .'- 调用[DescribeDBResourceGroup](~~459446~~)接口可以查看指定集群的资源组名称。'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-8vbwm***'], ], [ - 'name' => 'StartTime', + 'name' => 'TaskName', 'in' => 'query', - 'schema' => [ - 'description' => '开始时间。'."\n" - ."\n" - .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'required' => false, - 'example' => '2022-01-01T12:01:00Z', - ], + 'schema' => ['title' => '推荐任务名称', 'description' => '推荐任务名称。', 'type' => 'string', 'required' => true, 'example' => 'task_n1'], ], [ - 'name' => 'EndTime', + 'name' => 'SchedulingPolicy', 'in' => 'query', 'schema' => [ - 'description' => '结束时间。'."\n" + 'title' => '推荐的策略，取值"daliy"或"weekly"', + 'description' => '推荐的策略，取值如下：'."\n" + ."\n" + .'daily：按日调度。'."\n" ."\n" - .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', + .'weekly：按周调度。', 'type' => 'string', - 'required' => false, - 'example' => '2025-01-01T12:01:00Z', + 'required' => true, + 'example' => 'weekly', + 'enum' => ['daily', 'weekly'], ], ], [ - 'name' => 'Enabled', + 'name' => 'SchedulingDay', 'in' => 'query', - 'schema' => [ - 'description' => '创建后是否立即启用弹性计划。'."\n" - .'取值说明：'."\n" - .'- true：立即启用。'."\n" - .'- false：不启用。'."\n", - 'type' => 'boolean', - 'required' => true, - 'example' => 'true', - ], + 'schema' => ['title' => '仅当SchedulingPolicy取值为weekly时有效，取值为：Monday|Tuesday|Wendesday|Thursday|Friday|Saturday|Sunday，多天以逗号分隔符拼接', 'description' => '仅当SchedulingPolicy取值为weekly时有效，取值如下：'."\n" + ."\n" + .'- Monday'."\n" + .'- Tuesday'."\n" + .'- Wednesday'."\n" + .'- Thursday'."\n" + .'- Friday'."\n" + .'- Saturday'."\n" + .'- Sunday'."\n" + ."\n" + .'多天以逗号分隔符拼接。', 'type' => 'string', 'required' => false, 'example' => 'Monday;Wednesday'], ], [ - 'name' => 'CronExpression', + 'name' => 'SpecifiedTime', 'in' => 'query', - 'schema' => [ - 'description' => 'Cron表达式，表示弹性计划的变配周期和变配时间。'."\n" - ."\n" - .'>Type参数取值为EXECUTOR时，该参数必填。', - 'type' => 'string', - 'required' => false, - 'example' => '0 20 14 * * ?', - ], + 'schema' => ['title' => '任务的执行时间，格式HH:MM:SS', 'description' => '任务的执行时间，格式HH:MM:SS。', 'type' => 'string', 'required' => true, 'example' => '10:00:00'], ], [ - 'name' => 'TargetSize', + 'name' => 'ScanQueriesRange', 'in' => 'query', - 'schema' => [ - 'description' => '目标规格。'."\n" - .'> - 只有弹性资源类型为**存储加速服务弹性计划**并且启用了**存储加速服务(EIU)按比例默认弹性**，可以不填写该参数。其它情况下，该参数为必填项。'."\n" - .'> - 调用[DescribeElasticPlanSpecifications](~~601278~~)接口可以查看弹性计划支持的弹性变配规格。', - 'type' => 'string', - 'required' => false, - 'example' => '32ACU', - ], + 'schema' => ['title' => '扫描的时间范围，单位天，默认取值3', 'description' => '扫描的时间范围，单位天，默认取值3。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '3'], ], [ - 'name' => 'Type', + 'name' => 'Description', 'in' => 'query', - 'schema' => [ - 'description' => '弹性计划类型。'."\n" - .'取值说明：'."\n" - .'- EXECUTOR：Interactive资源组，即计算资源类型。'."\n" - .'- WORKER：存储加速服务（EIU）。', - 'type' => 'string', - 'required' => true, - 'example' => 'EXECUTOR', - ], + 'schema' => ['title' => '推荐任务的描述', 'description' => '推荐任务的描述。', 'type' => 'string', 'required' => false, 'example' => 'task desc'], ], [ - 'name' => 'AutoScale', + 'name' => 'SlowQueryThreshold', 'in' => 'query', - 'schema' => [ - 'description' => '是否启用**存储加速服务(EIU)按比例默认弹性**。'."\n" - .'取值说明：'."\n" - .'- true：启用。启用后，存储资源会跟随计算资源的弹性伸缩而伸缩，且不支持填写目标规格和Cron表达式。'."\n" - .'- false：不启用。'."\n" - .'>- Type为WORKER时，本参数必填。Type为EXECUTOR时，本参数不填。'."\n" - .'> - 整个集群只支持启用一个存储加速服务(EIU)按比例默认弹性的存储弹性计划，启用了此类型的弹性计划以后，无法再启用其他的存储弹性计划。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 'schema' => ['title' => '慢查询阈值', 'description' => '慢查询阈值。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'minimum' => '1', 'example' => '2'], ], [ - 'name' => 'DBClusterId', + 'name' => 'MinRewriteQueryPattern', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~454250~~)接口查看集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz9509beptiz****', - ], + 'schema' => ['title' => '最小可加速的Pattern数量', 'description' => '最小可加速的Pattern数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'minimum' => '1', 'example' => '5'], + ], + [ + 'name' => 'MinRewriteQueryCount', + 'in' => 'query', + 'schema' => ['title' => 'Pattern匹配的最少慢查询个数', 'description' => 'Pattern匹配的最少慢查询个数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'minimum' => '1', 'example' => '3'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'BaseResponse', - 'description' => 'BaseResponse', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], ], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ACS.ElasticPlan.InvalidEndTime', - 'errorMessage' => 'The end time should be later than current time.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.NameAlreadyExists', - 'errorMessage' => 'The name already exists.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.WorkerNotFound', - 'errorMessage' => 'Worker not found.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.AutoWorkerPlanExists', - 'errorMessage' => 'Failed to enable the elastic plan. The instance already has an active elastic plan.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.WorkerPlanExists', - 'errorMessage' => 'Failed to enable the elastic plan. At least one active elastic plan already exists.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.InvalidStartTimeInterval', - 'errorMessage' => 'The start time of this elastic plan is too closed to another one.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.InvalidTodayPlan', - 'errorMessage' => 'Failed to enable this elastic plan. Today\'s schedule time is missed and you should prepare at least %s minutes for us to prepare resource.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.InvalidTargetSize', - 'errorMessage' => 'Invalid target size.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.InvalidStartTime', - 'errorMessage' => 'Invalid start time.', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建物化视图自动推荐任务', + 'summary' => '创建物化视图自动推荐任务。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateMaterializedViewRecommend'], ], - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateMaterializedViewRecommend', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<CreateElasticPlanResponse>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</CreateElasticPlanResponse>","errorExample":""}]', - 'title' => '创建弹性计划', - 'summary' => '创建集群的弹性计划。', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', ], - 'DescribeElasticPlans' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'CreateOssSubDirectory' => [ + 'summary' => 'OSS创建子目录。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '125729', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], ], 'parameters' => [ [ - 'name' => 'ElasticPlanName', - 'in' => 'query', - 'schema' => [ - 'description' => '弹性计划名称。'."\n" - .'> 不填写弹性计划名称将查询所有弹性计划。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], - ], - [ - 'name' => 'ResourceGroupName', - 'in' => 'query', - 'schema' => [ - 'description' => '资源组名称。'."\n" - .'> - 不填写表示查询所有资源组的弹性计划，包括Interactive资源组类型和存储加速服务（EIU）。'."\n" - .'>- 调用[DescribeDBResourceGroup](~~459446~~)接口可以查看集群的资源组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], - ], - [ - 'name' => 'Enabled', - 'in' => 'query', - 'schema' => [ - 'description' => '创建后是否启用弹性计划。'."\n" - .'取值说明：'."\n" - .'- **true**：启用。'."\n" - .'- **false**：不启用。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'allowEmptyValue' => false, - 'schema' => [ - 'description' => '每页大小。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'minimum' => '1', - 'example' => '10', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'minimum' => '1', - 'example' => '1', - ], + 'name' => 'Path', + 'in' => 'formData', + 'schema' => ['title' => '创建的子目录的完整OSS路径'."\n", 'description' => '创建目录的完整OSS路径。'."\n", 'type' => 'string', 'required' => true, 'example' => 'oss://testBucketName/das_lakehouse'], ], [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~612397~~)接口可以查看集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz9509beptiz****', - ], - ], - [ - 'name' => 'Type', - 'in' => 'query', - 'schema' => [ - 'description' => '弹性计划类型。 取值说明：'."\n" - ."\n" - .'- **EXECUTOR**：Interactive资源组，即计算资源类型。'."\n" - .'- **WORKER**：存储加速服务（EIU）。', - 'type' => 'string', - 'required' => false, - 'example' => 'EXECUTOR', - ], + 'in' => 'formData', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'>您可以调用[DescribeDBClusters](~~612397~~)接口查看目标地域下所有的集群信息，包括集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp149vz49b36t****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PaginationResponse<List<DescribeElasticPlansResponse>>', - 'description' => 'PaginationResponse<List<DescribeElasticPlansResponse>>', + 'title' => 'Schema of Response', + 'description' => '响应模式。', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总计划数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '15', - ], - 'PageNumber' => [ - 'description' => '页数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页大小。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'ElasticPlans' => [ - 'description' => '弹性计划列表。', - 'type' => 'array', - 'items' => [ - 'description' => '弹性计划。', - 'type' => 'object', - 'properties' => [ - 'ElasticPlanName' => [ - 'description' => '弹性计划名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'Type' => [ - 'description' => '弹性计划类型。'."\n" - .'取值说明：'."\n" - .'- **EXECUTORE**：Interactive资源组类型，即计算资源类型。'."\n" - .'- **WORKER**：存储加速服务（EIU）。', - 'type' => 'string', - 'example' => 'EXECUTOR', - ], - 'Enabled' => [ - 'description' => '创建后是否立即启用弹性计划。'."\n" - .'取值说明：'."\n" - .'- **true**：立即启用。'."\n" - .'- **false**：不启用。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'ResourceGroupName' => [ - 'description' => '资源组名称。'."\n" - .'> 调用[DescribeDBResourceGroup](~~459446~~)接口可以查看集群的资源组名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'TargetSize' => [ - 'description' => '目标规格。', - 'type' => 'string', - 'example' => '32ACU', - ], - 'NextScheduleTime' => [ - 'description' => '下次调度时间。'."\n" - ."\n" - .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'example' => '2022-01-01T12:01:00Z', - ], - 'AutoScale' => [ - 'description' => '是否**开启存储加速服务(EIU)按比例默认弹性**。'."\n" - .'取值说明：'."\n" - .'- **true**：开启。'."\n" - .'- **false**：不开启。', - 'type' => 'boolean', - 'example' => 'false', - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '3A0DE2E0-A37B-5EE4-9136-C4C473714802'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'], + 'Data' => [ + 'description' => '返回数据。', + 'type' => 'object', + 'properties' => [ + 'ClientCRC' => ['description' => 'Client.CRC校验值。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'ETag' => ['description' => 'OSS路径的标签。', 'type' => 'string', 'example' => '1'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '3A0DE2E0-A37B-5EE4-9136-C4C473714802'], + 'ServerCRC' => ['description' => '阿里云OSS Bucket的CRC-64值。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], ], ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD', - ], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：调用成功。'."\n" + .'- **false**：调用失败。', 'type' => 'boolean', 'example' => 'True'], ], ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'title' => '创建oss目录', + 'description' => '- 中心的公网接入地址：`adb.aliyuncs.com`。'."\n" + .'- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2024-05-10T06:05:35.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-22T08:51:54.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateOssSubDirectory'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateOssSubDirectory', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 15,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"ElasticPlans\\": [\\n {\\n \\"ElasticPlanName\\": \\"test\\",\\n \\"Type\\": \\"EXECUTOR\\",\\n \\"Enabled\\": true,\\n \\"ResourceGroupName\\": \\"test\\",\\n \\"TargetSize\\": \\"32ACU\\",\\n \\"NextScheduleTime\\": \\"2022-01-01T12:01:00Z\\",\\n \\"AutoScale\\": false\\n }\\n ],\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeElasticPlansResponse>\\n <TotalCount>15</TotalCount>\\n <PageNumber>1</PageNumber>\\n <PageSize>10</PageSize>\\n <ElasticPlans>\\n <ElasticPlanName>test</ElasticPlanName>\\n <Type>EXECUTOR</Type>\\n <Enabled>true</Enabled>\\n <ResourceGroupName>test</ResourceGroupName>\\n <TargetSize>32ACU</TargetSize>\\n <NextScheduleTime>2022-01-01T12:01:00Z</NextScheduleTime>\\n <AutoScale>false</AutoScale>\\n </ElasticPlans>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</DescribeElasticPlansResponse>","errorExample":""}]', - 'title' => '查询弹性计划列表', - 'summary' => '根据查询条件查询集群的弹性计划。', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"3A0DE2E0-A37B-5EE4-9136-C4C473714802\\",\\n \\"Message\\": \\"Success\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": {\\n \\"ClientCRC\\": 1,\\n \\"ETag\\": \\"1\\",\\n \\"RequestId\\": \\"3A0DE2E0-A37B-5EE4-9136-C4C473714802\\",\\n \\"ServerCRC\\": 1\\n },\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"<CreateOssSubDirectoryResponse>\\n <RequestId>3A0DE2E0-A37B-5EE4-9136-C4C473714802</RequestId>\\n <Message>Success</Message>\\n <HttpStatusCode>200</HttpStatusCode>\\n <Data>\\n <ClientCRC>1</ClientCRC>\\n <ETag>1</ETag>\\n <RequestId>3A0DE2E0-A37B-5EE4-9136-C4C473714802</RequestId>\\n <ServerCRC>1</ServerCRC>\\n </Data>\\n <Success>true</Success>\\n</CreateOssSubDirectoryResponse>","errorExample":""}]', ], - 'ModifyElasticPlan' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'CreatePerformanceView' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'tags' => ['Perth'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '221254', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'ElasticPlanName', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '弹性计划名称。'."\n" - .'> 调用[DescribeElasticPlans](~~601334~~)接口可以查看指定集群的弹性计划名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 调用[DescribeDBClusters](~~612397~~)接口可以查看集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1ub9grke1****'], ], [ - 'name' => 'StartTime', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '开始时间。'."\n" - ."\n" - .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'required' => false, - 'example' => '2022-01-01T12:01:00Z', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-beijing'], ], [ - 'name' => 'EndTime', + 'name' => 'ViewDetail', 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => '结束时间。'."\n" - ."\n" - .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'required' => false, - 'example' => '2025-01-01T12:01:00Z', + 'description' => '监控视图详情。', + 'type' => 'object', + 'properties' => [ + 'ChartsPerLine' => ['description' => '每一行展示的图表数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '2'], + 'ChartLinked' => ['description' => '是否联动图表。取值：'."\n" + .'- **true**：是。'."\n" + .'- **false**：否。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'Categories' => [ + 'description' => '指标分类列表。', + 'type' => 'array', + 'items' => [ + 'description' => '指标分类。', + 'type' => 'object', + 'properties' => [ + 'Category' => ['description' => '指标分类名，取值：'."\n" + .'* **Node**：节点资源指标。'."\n" + .'* **DiskData**：磁盘指标。'."\n" + .'* **WorkLoad**：负载指标。'."\n" + .'* **ResourceGroup**：资源组指标。', 'type' => 'string', 'required' => false, 'example' => 'Node'], + 'Keys' => [ + 'description' => '指标列表。', + 'type' => 'array', + 'items' => [ + 'description' => '单个指标配置。', + 'type' => 'object', + 'properties' => [ + 'KeyName' => ['description' => '指标Key。', 'type' => 'string', 'required' => false, 'example' => 'AnalyticDB_CPU'], + 'Selected' => ['description' => '是否选中。取值：'."\n" + .'- **true**：是。'."\n" + .'- **false**：否。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + ], + 'required' => false, + ], + 'required' => false, + ], + ], + 'required' => false, + ], + 'required' => false, + ], + ], + 'required' => true, ], ], [ - 'name' => 'CronExpression', + 'name' => 'ViewName', 'in' => 'query', - 'schema' => [ - 'description' => 'Cron表达式，表示弹性计划的变配周期和变配时间。', - 'type' => 'string', - 'required' => false, - 'example' => '0 20 14 * * ?', - ], + 'schema' => ['description' => '监控视图名称。', 'type' => 'string', 'required' => true, 'example' => 'Custom-All metrics-2 columns-Linked'], ], [ - 'name' => 'TargetSize', + 'name' => 'CreateFromViewType', 'in' => 'query', - 'schema' => [ - 'description' => '目标规格。'."\n" - .'> - 只有弹性资源类型为**存储加速服务弹性计划**并且启用了**存储加速服务(EIU)按比例默认弹性**，可以不填写该参数。其它情况下，该参数为必填项。'."\n" - .'- 调用[DescribeElasticPlanSpecifications](~~601278~~)接口可以查看弹性计划支持的弹性变配规格。', - 'type' => 'string', - 'required' => false, - 'example' => '32ACU', - ], + 'schema' => ['description' => '当前监控视图复制自原始监控视图的类型，取值：'."\n" + ."\n" + .'- **Basic**：基础视图'."\n" + .'- **Advanced**：高级视图', 'type' => 'string', 'required' => false, 'example' => 'Basic'], ], [ - 'name' => 'DBClusterId', + 'name' => 'FillOriginViewKeys', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz9509beptiz****', - ], + 'schema' => ['description' => '查看监控视图时，是否填充原始监控视图完成的Key。取值：'."\n" + .'- **true**：是。'."\n" + .'- **false**：否。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'BaseResponse', - 'description' => 'BaseResponse', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'E031AABF-BD56-5966-A063-4283EF18DB45'], + 'CreateStatus' => ['description' => '创建结果，取值：'."\n" + ."\n" + .'- **SUCCESS**：成功。'."\n" + .'- **FAILED**：失败。', 'type' => 'string', 'example' => 'SUCCESS'], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], ], + 'description' => '', ], ], ], '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' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyElasticPlanResponse>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</ModifyElasticPlanResponse>","errorExample":""}]', - 'title' => '修改弹性计划', - 'summary' => '修改集群的弹性计划。', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'EnableElasticPlan' => [ - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建自定义监控视图', + 'summary' => '创建自定义监控视图。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreatePerformanceView'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreatePerformanceView', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"E031AABF-BD56-5966-A063-4283EF18DB45\\",\\n \\"CreateStatus\\": \\"SUCCESS\\",\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', + ], + 'CreateSemanticView' => [ + 'path' => '', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'create', + 'riskType' => 'high', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREadsTYGUV3'], ], 'parameters' => [ [ - 'name' => 'ElasticPlanName', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '弹性计划名称。'."\n" - .'> 调用[DescribeElasticPlans](~~601334~~)接口可以查看集群的弹性计划名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'schema' => ['title' => 'ADB集群ID。', 'description' => 'ADB集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp198m028ih55****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz9509beptiz****', - ], + 'schema' => ['title' => 'Schema名称。'."\n" + .' '."\n", 'description' => 'Schema名称。'."\n" + .' '."\n", 'type' => 'string', 'required' => true, 'example' => 'adb_demo'], + ], + [ + 'name' => 'ViewName', + 'in' => 'query', + 'schema' => ['title' => '语义视图名称。', 'description' => '语义视图名称。', 'type' => 'string', 'required' => true, 'example' => 'adb_sv_name'], + ], + [ + 'name' => 'Definition', + 'in' => 'query', + 'schema' => ['title' => '语义视图 YAML 定义', 'description' => '语义视图 YAML 定义', 'type' => 'string', 'required' => true, 'example' => 'YAML 内容'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'BaseResponse', - 'description' => 'BaseResponse', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ACS.ElasticPlan.AutoWorkerPlanExists', - 'errorMessage' => 'Failed to enable the elastic plan. The instance already has an active elastic plan.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.WorkerPlanExists', - 'errorMessage' => 'Failed to enable the elastic plan. At least one active elastic plan already exists.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.InvalidStartTimeInterval', - 'errorMessage' => 'The start time of this elastic plan is too closed to another one.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.InvalidEndTime', - 'errorMessage' => 'The end time should be later than current time.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.InvalidTodayPlan', - 'errorMessage' => 'Failed to enable this elastic plan. Today\'s schedule time is missed and you should prepare at least %s minutes for us to prepare resource.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.InvalidTargetSize', - 'errorMessage' => 'Invalid target size.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.InvalidStartTime', - 'errorMessage' => 'Invalid start time.', - ], + ['errorCode' => 'MDS.CatalogAlreadyExist', 'errorMessage' => 'The catalog already exists.', 'description' => '目录已经存在'], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ['errorCode' => 'MDS.SemanticViewAlreadyExist', 'errorMessage' => 'The semantic view already exists.', 'description' => '此语义视图已经存在'], ], - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + [ + ['errorCode' => 'MDS.InstanceNotExist', 'errorMessage' => 'ADB instance does not exist.', 'description' => 'ADB 实例不存在'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<EnableElasticPlanResponse>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</EnableElasticPlanResponse>","errorExample":""}]', - 'title' => '启用弹性计划', - 'summary' => '启用集群的弹性计划。', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DisableElasticPlan' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建语义视图', + 'summary' => '创建语义视图', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', + ], + 'CreateSparkTemplate' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'create', + 'abilityTreeCode' => '132061', + 'abilityTreeNodes' => ['FEATUREadsCQJTKP'], ], 'parameters' => [ [ - 'name' => 'ElasticPlanName', - 'in' => 'query', - 'schema' => [ - 'description' => '弹性计划名称。'."\n" - .'> 调用[DescribeElasticPlans](~~601334~~)接口可以查看集群的弹性计划名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['title' => '模板文件所在数据库ID', 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****', 'maxLength' => 64], ], [ - 'name' => 'DBClusterId', - 'in' => 'query', + 'name' => 'ParentId', + 'in' => 'formData', + 'schema' => ['title' => '父文件夹ID', 'description' => '应用模板所属的目录ID。'."\n" + .'> 调用[GetSparkTemplateFolderTree](~~456218~~)接口查询目录ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'minimum' => '0', 'example' => '10'], + ], + [ + 'name' => 'Name', + 'in' => 'formData', + 'schema' => ['title' => '模板文件名称', 'description' => '应用模板名称。长度不超过64个字符。', 'type' => 'string', 'required' => true, 'example' => 'batchfile', 'maxLength' => 64], + ], + [ + 'name' => 'Type', + 'in' => 'formData', 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群ID。', + 'title' => '模板文件类型, 可以为FOLDER或者FILE', + 'description' => '应用模板类型，取值说明：'."\n" + .'- **folder**：目录'."\n" + .'- **file**：应用', 'type' => 'string', 'required' => true, - 'example' => 'amv-wz9509beptiz****', + 'example' => 'file', + 'enum' => [], ], ], + [ + 'name' => 'AppType', + 'in' => 'formData', + 'schema' => ['title' => '模板文件内容的类型, 可选值有 BATCH, STREAMING, SQL, 默认为UNDEFINED', 'description' => '应用类型，取值说明：'."\n" + .'- **SQL**：SQL应用'."\n" + .'- **STREAMING**：流应用'."\n" + .'- **BATCH**：离线应用'."\n" + ."\n" + .'> 当应用模板类型为folder时，无需配置此参数。', 'type' => 'string', 'required' => false, 'example' => 'SQL', 'default' => 'UNDEFINED'], + ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'BaseResponse', - 'description' => 'BaseResponse', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => [ + 'description' => '应用模板创建结果。', + 'type' => 'object', + 'properties' => [ + 'Succeeded' => ['title' => '是否创建成功', 'description' => '是否创建成功，取值说明：'."\n" + .'- **True**：成功'."\n" + .'- **False**：失败', 'type' => 'boolean', 'example' => 'True'], + ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.TemplateFile.BadFileType', 'errorMessage' => 'The requested template %s is not a file.', 'description' => '请求的模板文件ID不是文件类型的。'], + ], 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], + ['errorCode' => 'Spark.TemplateFile.TemplateNotFound', 'errorMessage' => 'The template %s is not found.', 'description' => '模板文件未找到。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<DisableElasticPlanResponse>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</DisableElasticPlanResponse>","errorExample":""}]', - 'title' => '停用弹性计划', - 'summary' => '停用集群的弹性计划。', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DeleteElasticPlan' => [ - 'methods' => [ - 'post', - 'get', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '创建Spark应用模板', + 'summary' => '创建Spark应用模板。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-06-28T01:10:39.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateSparkTemplate'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateSparkTemplate', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"Succeeded\\": true\\n }\\n}","errorExample":""},{"type":"xml","example":"<CreateSparkTemplateResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Data>\\n <Succeeded>true</Succeeded>\\n </Data>\\n</CreateSparkTemplateResponse>","errorExample":""}]', + ], + 'DeleteAccount' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '130690', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], ], 'parameters' => [ [ - 'name' => 'ElasticPlanName', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '弹性计划名称。'."\n" - .'> 调用[DescribeElasticPlans](~~601334~~)接口可以查看集群的弹性计划名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'AccountName', + 'in' => 'query', + 'schema' => ['description' => '数据库账号名称。'."\n" + .'> 您可以调用[DescribeAccounts](~~612430~~)接口查看指定集群的数据库账号信息，包括账号名称。', 'type' => 'string', 'required' => true, 'example' => 'test_accout'], + ], + [ + 'name' => 'Engine', 'in' => 'query', 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下所有集群ID。', + 'description' => '数据库引擎，取值：'."\n" + ."\n" + .'- **AnalyticDB**（默认）：AnalyticDB MySQL引擎。'."\n" + .'- **Clickhouse**：宽表引擎。', 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz9509beptiz****', + 'required' => false, + 'enumValueTitles' => [], + 'example' => 'Clickhouse', ], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'BaseResponse', - 'description' => 'BaseResponse', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], ], ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'InvalidAccountName.Malformed', 'errorMessage' => 'The specified parameter AccountName is not valid.', 'description' => 'AccountName不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<DeleteElasticPlanResponse>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</DeleteElasticPlanResponse>","errorExample":""}]', - 'title' => '删除弹性计划', - 'summary' => '删除集群的弹性计划。', - 'description' => '- 删除弹性计划前，需先停用该计划。'."\n" - .'- 当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeElasticPlanJobs' => [ - 'methods' => [ - 'post', - 'get', + 'title' => '删除数据库账号', + 'summary' => '删除集群的数据库账号。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-06-13T13:53:52.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-03-31T07:03:59.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:52:03.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteAccount'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteAccount', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","errorExample":""},{"type":"xml","example":"<DeleteAccountResponse>\\n <RequestId>2FED790E-FB61-4721-8C1C-07C627FA5A19</RequestId>\\n</DeleteAccountResponse>","errorExample":""}]', + ], + 'DeleteApsDatasoure' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'none', + 'abilityTreeCode' => '168866', + 'abilityTreeNodes' => ['FEATUREadsQO9FPM'], ], 'parameters' => [ [ - 'name' => 'ElasticPlanName', - 'in' => 'query', - 'schema' => [ - 'description' => '弹性计划名称。'."\n" - .'> - 不填写弹性计划名称将查询所有弹性计划。'."\n" - .'- 调用[DescribeElasticPlans](~~601334~~)接口查看集群的弹性计划名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], - ], - [ - 'name' => 'ResourceGroupName', - 'in' => 'query', - 'schema' => [ - 'description' => '资源组名称。'."\n" - .'> - 不填写表示查询所有资源组的弹性计划，包括Interactive资源组类型和存储加速服务（EIU）。'."\n" - .'- 调用[DescribeDBResourceGroup](~~459446~~)接口可以查看集群的资源组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], - ], - [ - 'name' => 'Status', - 'in' => 'query', - 'schema' => [ - 'description' => '作业状态。'."\n" - .'取值说明：'."\n" - .'- RUNNING：运行中。'."\n" - .'- SUCCESSFUL：运行成功。'."\n" - .'- FAILED：运行失败。'."\n" - .'> 不填写将查询所有状态的弹性计划。', - 'type' => 'string', - 'required' => false, - 'example' => 'SUCCESSFUL', - ], - ], - [ - 'name' => 'StartTime', - 'in' => 'query', - 'schema' => [ - 'description' => '开始时间。'."\n" - .'格式为yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'required' => false, - 'example' => '2022-01-01T12:01:00Z', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页大小。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '10', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => 'ADB实例ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-******'], ], [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '1', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz9509beptiz****', - ], + 'name' => 'DatasourceId', + 'in' => 'formData', + 'schema' => ['description' => '数据源ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PaginationResponse<List<DescribeElasticPlanJobsResponse>>', - 'description' => 'PaginationResponse<List<DescribeElasticPlanJobsResponse>>', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总作业数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '15', - ], - 'PageNumber' => [ - 'description' => '页数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页大小。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'Jobs' => [ - 'description' => '作业列表。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'ElasticPlanName' => [ - 'description' => '弹性计划名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'Status' => [ - 'description' => '作业状态。'."\n" - .'取值说明：'."\n" - .'- RUNNING：运行中。'."\n" - .'- SUCCESSFUL：运行成功。'."\n" - .'- FAILED：运行失败。', - 'type' => 'string', - 'example' => 'SUCCESSFUL', - ], - 'Type' => [ - 'description' => '弹性计划作业类型。'."\n" - .'取值说明：'."\n" - .'- EXECUTORE：Interactive资源组类型，即计算资源类型。'."\n" - .'- WORKER：存储加速服务（EIU）。', - 'type' => 'string', - 'example' => 'EXECUTOR', - ], - 'ResourceGroupName' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'StartTime' => [ - 'description' => '作业开始时间。'."\n" - .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'example' => '2022-01-01T11:01:00Z', - ], - 'EndTime' => [ - 'description' => '作业结束时间。'."\n" - ."\n" - .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'example' => '2022-01-01T12:01:00Z', - ], - 'TargetSize' => [ - 'description' => '目标规格。', - 'type' => 'string', - 'example' => '32ACU', - ], - 'TotalAcu' => [ - 'description' => '总资源。'."\n" - .'> - Type取值为EXECUTOR时，本参数表示所属资源组的总计算资源。'."\n" - .'> - Type取值为WORKER时，本参数表示整个集群的总存储资源。', - 'type' => 'string', - 'example' => '32ACU', - ], - 'ReserveAcu' => [ - 'description' => '预留资源。'."\n" - .'> - Type取值为EXECUTOR时，本参数表示当前资源组的预留资源。'."\n" - .'> - Type取值为WORKER时，本参数表示当前集群的总预留存储资源。', - 'type' => 'string', - 'example' => '16ACU', - ], - 'ElasticAcu' => [ - 'description' => '弹性资源。'."\n" - .'> - Type取值为EXECUTOR时，本参数表示当前资源组的弹性资源。'."\n" - .'> - Type取值为WORKER时，本参数表示当前集群的总存储弹性资源。', - 'type' => 'string', - 'example' => '16ACU', - ], - 'InstanceSize' => [ - 'description' => '实例数量。'."\n" - .'> - Type取值为EXECUTOR时，本参数表示当前计算节点数量。'."\n" - .'> - Type取值为WORKER时，本参数表示当前集群的存储副本集数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - ], - ], - ], - 'RequestId' => [ - 'description' => '请求ID。 ', - 'type' => 'string', - 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'FAE98A4F-****-****-BF6D-67EEAC9C39DE'], + 'Data' => ['description' => '返回数据。', 'type' => 'string', 'example' => '7'], + 'HttpStatusCode' => ['description' => 'HTTP状态码。'."\n", 'type' => 'string', 'example' => '200'], + 'Success' => ['description' => '请求是否成功。取值说明：'."\n" + .'- **True**：成功。'."\n" + .'- **False**：失败。', 'type' => 'string', 'example' => 'True'], + 'Code' => ['description' => '返回码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '调用结果的信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常信息。', 'type' => 'string', 'example' => 'OK'], ], ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除APS数据源', + 'summary' => '删除APS数据源。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteApsDatasoure'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DeleteApsDatasoure', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 15,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"Jobs\\": [\\n {\\n \\"ElasticPlanName\\": \\"test\\",\\n \\"Status\\": \\"SUCCESSFUL\\",\\n \\"Type\\": \\"EXECUTOR\\",\\n \\"ResourceGroupName\\": \\"test\\",\\n \\"StartTime\\": \\"2022-01-01T11:01:00Z\\",\\n \\"EndTime\\": \\"2022-01-01T12:01:00Z\\",\\n \\"TargetSize\\": \\"32ACU\\",\\n \\"TotalAcu\\": \\"32ACU\\",\\n \\"ReserveAcu\\": \\"16ACU\\",\\n \\"ElasticAcu\\": \\"16ACU\\",\\n \\"InstanceSize\\": 1\\n }\\n ],\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeElasticPlanJobsResponse>\\n <TotalCount>15</TotalCount>\\n <PageNumber>1</PageNumber>\\n <PageSize>10</PageSize>\\n <Jobs>\\n <ElasticPlanName>test</ElasticPlanName>\\n <Status>SUCCESSFUL</Status>\\n <Type>EXECUTOR</Type>\\n <ResourceGroupName>test</ResourceGroupName>\\n <StartTime>2022-01-01T11:01:00Z</StartTime>\\n <EndTime>2022-01-01T12:01:00Z</EndTime>\\n <TargetSize>32ACU</TargetSize>\\n <TotalAcu>32ACU</TotalAcu>\\n <ReserveAcu>16ACU</ReserveAcu>\\n <ElasticAcu>16ACU</ElasticAcu>\\n <InstanceSize>1</InstanceSize>\\n </Jobs>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</DescribeElasticPlanJobsResponse>","errorExample":""}]', - 'title' => '查询弹性计划作业列表', - 'summary' => '查询集群的弹性计划作业。', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FAE98A4F-****-****-BF6D-67EEAC9C39DE\\",\\n \\"Data\\": \\"7\\",\\n \\"HttpStatusCode\\": \\"200\\",\\n \\"Success\\": \\"True\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', ], - 'DescribeElasticPlanAttribute' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DeleteApsJob' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'none', + 'riskType' => 'high', + 'chargeType' => 'free', + 'abilityTreeCode' => '183073', + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsY28JLD'], ], 'parameters' => [ [ - 'name' => 'ElasticPlanName', - 'in' => 'query', - 'schema' => [ - 'description' => '弹性计划名称。'."\n" - .'> 调用[DescribeElasticPlans](~~601334~~)接口查看集群的弹性计划名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。'."\n" + .'>您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz9509beptiz****', - ], + 'name' => 'ApsJobId', + 'in' => 'formData', + 'schema' => ['description' => '任务ID。', 'type' => 'string', 'required' => true, 'example' => 'aps-*****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', - 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', 'type' => 'object', 'properties' => [ - 'ElasticPlan' => [ - 'description' => '弹性计划。', - 'type' => 'object', - 'properties' => [ - 'ElasticPlanName' => [ - 'description' => '弹性计划名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'Type' => [ - 'description' => '弹性计划类型。', - 'type' => 'string', - 'example' => 'EXECUTOR', - ], - 'Enabled' => [ - 'description' => '是否启用。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'ResourceGroupName' => [ - 'description' => '所属资源组名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'TargetSize' => [ - 'description' => '目标规格。', - 'type' => 'string', - 'example' => '32ACU', - ], - 'StartTime' => [ - 'description' => '开始时间。'."\n" - ."\n" - .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'example' => '2022-01-01T12:01:00Z', - ], - 'EndTime' => [ - 'description' => '结束时间。'."\n" - ."\n" - .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'example' => '2025-01-01T12:01:00Z', - ], - 'CronExpression' => [ - 'description' => 'Cron表达式，表示弹性计划的变配周期和变配时间。', - 'type' => 'string', - 'example' => '0 20 14 * * ?', - ], - 'AutoScale' => [ - 'description' => '是否启用**存储加速服务(EIU)按比例默认弹性**。'."\n" - .'取值说明：'."\n" - .'true：启用。启用后，存储资源会跟随计算资源的弹性伸缩而伸缩。'."\n" - .'false：不启用。'."\n" - .'>整个集群只支持启用一个存储加速服务(EIU)按比例默认弹性的存储弹性计划，启用了此类型的弹性计划以后，无法再启用其他的存储弹性计划。', - 'type' => 'boolean', - 'example' => 'false', - ], - ], - ], - 'RequestId' => [ - 'description' => '请求ID。 ', - 'type' => 'string', - 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD', - ], + 'HttpStatusCode' => ['description' => 'HTTP状态码。'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'ApsJobId' => ['description' => '任务ID。', 'type' => 'string', 'example' => 'aps-*****'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '****-****-5D14-AC9F-*********'], + 'Success' => ['description' => '是否成功。', 'type' => 'boolean', 'example' => 'True'], + 'ErrCode' => ['description' => '调用出错时返回的错误码。', 'type' => 'string', 'example' => 'Success'], + 'ErrMessage' => ['description' => '调用错误时返回对应的错误信息。', 'type' => 'string', 'example' => 'OK'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '调用结果的信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常信息。', 'type' => 'string', 'example' => 'OK'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'ACS.ElasticPlan.NotFound', - 'errorMessage' => 'The elastic plan is not found.', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除APS任务', + 'summary' => '删除aps任务。', + 'description' => '- 删除备份集是异步操作，前端显示会有延迟，需要等待约10-20分钟才会生效。'."\n" + .'- 单次最大允许删除100个备份集。如果要删超过100个备份集，请分2次调用。'."\n" + .'- 为保证数据安全性，系统会强制保留1个有效备份集。当要删除仅有的备份集时，接口会禁止。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteApsJob'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DeleteApsJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"ElasticPlan\\": {\\n \\"ElasticPlanName\\": \\"test\\",\\n \\"Type\\": \\"EXECUTOR\\",\\n \\"Enabled\\": true,\\n \\"ResourceGroupName\\": \\"test\\",\\n \\"TargetSize\\": \\"32ACU\\",\\n \\"StartTime\\": \\"2022-01-01T12:01:00Z\\",\\n \\"EndTime\\": \\"2025-01-01T12:01:00Z\\",\\n \\"CronExpression\\": \\"0 20 14 * * ?\\",\\n \\"AutoScale\\": false\\n },\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeElasticPlanAttributeResponse>\\n <ElasticPlan>\\n <ElasticPlanName>test</ElasticPlanName>\\n <Type>EXECUTOR</Type>\\n <Enabled>true</Enabled>\\n <ResourceGroupName>test</ResourceGroupName>\\n <TargetSize>32ACU</TargetSize>\\n <StartTime>2022-01-01T12:01:00Z</StartTime>\\n <EndTime>2025-01-01T12:01:00Z</EndTime>\\n <CronExpression>0 20 14 * * ?</CronExpression>\\n <AutoScale>false</AutoScale>\\n </ElasticPlan>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</DescribeElasticPlanAttributeResponse>","errorExample":""}]', - 'title' => '查询弹性计划详情', - 'summary' => '查询集群的弹性计划详情。', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"ApsJobId\\": \\"aps-*****\\",\\n \\"RequestId\\": \\"****-****-5D14-AC9F-*********\\",\\n \\"Success\\": true,\\n \\"ErrCode\\": \\"Success\\",\\n \\"ErrMessage\\": \\"OK\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', ], - 'DescribeElasticPlanSpecifications' => [ - 'summary' => '查询集群的不同类型弹性计划支持的规格列表。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DeleteApsWebhook' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsBIVU9O', 'FEATUREadsY28JLD'], ], 'parameters' => [ [ - 'name' => 'Type', - 'in' => 'query', - 'schema' => [ - 'description' => '弹性计划类型。 取值说明：'."\n" - ."\n" - .'- EXECUTOR：Interactive资源组，即计算资源类型。'."\n" - .'- WORKER：存储加速服务（EIU）。', - 'type' => 'string', - 'required' => true, - 'example' => 'EXECUTOR', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-uf63i4ij56b***'], ], [ - 'name' => 'ResourceGroupName', - 'in' => 'query', - 'schema' => [ - 'description' => '资源组名称。'."\n" - ."\n" - .'>- 查询Interactive资源组的弹性计划（即计算资源类型的弹性计划）支持的规格时，必须指定资源组名称。查询存储加速服务（EIU）的弹性计划支持的规格时，无需指定资源组名称。'."\n" - .'- 调用[DescribeDBResourceGroup](~~459446~~)接口可以查看指定集群的资源组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz9509beptiz****', - ], + 'name' => 'WebhookId', + 'in' => 'formData', + 'schema' => ['description' => '待删除的Webhook的ID。', 'type' => 'string', 'required' => true, 'example' => '***1*595*'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PaginationResponse<List<String>>', - 'description' => 'PaginationResponse<List<String>>', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response。', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总规格数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'PageNumber' => [ - 'description' => '当前页数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页大小。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'Specifications' => [ - 'description' => '支持的规格列表。', - 'type' => 'array', - 'items' => [ - 'description' => '支持的规格。', - 'type' => 'string', - 'example' => '16ACU', - ], - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。'."\n", 'type' => 'string', 'example' => 'exampleRequestId'], + 'Data' => ['description' => '返回数据。', 'type' => 'string', 'example' => '[]'], + 'HttpStatusCode' => ['description' => 'http状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Message' => ['description' => '返回消息。', 'type' => 'string', 'example' => 'Operation succeeded'], + 'DBClusterId' => ['description' => '实例ID。', 'type' => 'string', 'example' => 'amv-uf63i4ij56b***'."\n"], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => '200'], + 'Success' => ['description' => '是否成功。', 'type' => 'boolean', 'example' => 'true'], ], ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除Webhook接口', + 'summary' => '用于删除指定数据库集群中的特定Webhook。', + 'description' => '本API允许用户通过提供`RegionId`、`DBClusterId`以及`WebhookId`来删除一个已存在的Webhook配置。请确保提供的参数值准确无误，以免误删重要设置。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteApsWebhook'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteApsWebhook', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 10,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 5,\\n \\"Specifications\\": [\\n \\"16ACU\\"\\n ],\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeElasticPlanSpecificationsResponse>\\n <TotalCount>10</TotalCount>\\n <PageNumber>1</PageNumber>\\n <PageSize>5</PageSize>\\n <Specifications>16ACU</Specifications>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</DescribeElasticPlanSpecificationsResponse>","errorExample":""}]', - 'title' => '查询弹性计划支持的规格列表', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"exampleRequestId\\",\\n \\"Data\\": \\"[]\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"Operation succeeded\\",\\n \\"DBClusterId\\": \\"amv-uf63i4ij56b***\\\\n\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": true\\n}","type":"json"}]', ], - 'DescribeAuditLogRecords' => [ - 'summary' => '查询集群的SQL审计日志。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DeleteBackups' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '132363', - 'abilityTreeNodes' => [ - 'FEATUREadsGAMOR7', - ], + 'operationType' => 'delete', + 'riskType' => 'high', + 'chargeType' => 'paid', + 'abilityTreeCode' => '246050', + 'abilityTreeNodes' => ['FEATUREadsM6VDCK'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-t4nj8619bz2w3****', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看集群的地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'AnalyticDB for MySQL集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-uf6g8w25jacm7****'], ], [ - 'name' => 'StartTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间，UTC时间，格式为：yyyy-MM-ddTHH:mmZ。'."\n" - .'> 仅当SQL审计状态为开启时，才能查询到SQL审计日志，且只支持查询30天内的SQL审计日志。如果中途关闭了SQL审计，再次打开时，仅能查询到再次打开后的SQL审计日志。'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2022-08-12T04:17Z', - ], - ], - [ - 'name' => 'EndTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间，UTC时间，格式为：yyyy-MM-ddTHH:mmZ。'."\n" - .'> - 查询结束时间需晚于查询开始时间。'."\n" - .'> - 查询开始时间与查询结束时间的间隔不能超过24小时。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2022-08-12T17:08Z', - ], - ], - [ - 'name' => 'DBName', - 'in' => 'query', - 'schema' => [ - 'description' => '执行目标SQL的数据库名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], - ], - [ - 'name' => 'QueryKeyword', - 'in' => 'query', - 'schema' => [ - 'description' => '可设置一个字符串类型的值，使用该值作为关键词对返回结果进行搜索。', - 'type' => 'string', - 'required' => false, - 'example' => 'adb', - ], - ], - [ - 'name' => 'SqlType', - 'in' => 'query', - 'schema' => [ - 'description' => 'SQL类型，取值：'."\n" - .'- **DELETE**'."\n" - .'- **SELECT**'."\n" - .'- **UPDATE**'."\n" - .'- **INSERT INTO SELECT**'."\n" - .'- **ALTER**'."\n" - .'- **DROP**'."\n" - .'- **CREATE**'."\n" - ."\n" - .'> 每次仅允许传入一种类型查询，若该参数为空，默认查询所有类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'SELECT', - ], - ], - [ - 'name' => 'Succeed', + 'name' => 'BackupIds', 'in' => 'query', - 'schema' => [ - 'description' => '目标SQL是否执行成功，取值说明：'."\n" - .'* **true**：执行成功。'."\n" - .'* **false**：执行失败。', - 'type' => 'string', - 'required' => false, - 'example' => 'true', - ], + 'schema' => ['description' => '待删除的备份集ID，多个备份集ID以英文逗号（,）分隔。', 'type' => 'string', 'required' => true, 'example' => '763,764'], ], [ - 'name' => 'HostAddress', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '执行目标SQL的客户端IP地址和端口号。', - 'type' => 'string', - 'required' => false, - 'example' => '100.104.XX.XX:43908', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], - [ - 'name' => 'OrderType', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '按SQL执行时间进行正序或倒序排序，取值说明：'."\n" - .'* **asc**：正序。'."\n" - .'* **desc**：倒序。', - 'type' => 'string', - 'required' => false, - 'example' => 'asc', + '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' => '771C5FAA-530F-52F7-B84D-EBAD4561D590'], + ], ], ], - [ - 'name' => 'User', - 'in' => 'query', - 'schema' => [ - 'description' => '执行目标SQL的用户名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + ], + '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' => 'Order', - 'in' => 'query', - 'schema' => [ - 'description' => '根据指定字段进行排序，格式为JSON，是一个有序JSON数组，按输入数组的顺序进行复合排序，包含`Field`和`Type`两个字段，例如`[{"Field":"ExecutionStartTime","Type":"Desc"},{"Field":"ScanRows","Type":"Asc"}]`。其中：'."\n" - .'* `Field`表示需要排序的字段名，支持如下取值：'."\n" - .' * **HostAddress**：连接数据库的客户端地址。'."\n" - .' * **UserName**：用户名。'."\n" - .' * **ExecutionStartTime**：目标SQL的执行开始时间。'."\n" - .' * **QueryTime**：目标SQL执行时长。'."\n" - .' * **PeakMemoryUsage**：执行目标SQL语句时的峰值内存。'."\n" - .' * **ScanRows**：带数据源的任务的扫描数据行数。'."\n" - .' * **ScanSize**：扫描的数据量。'."\n" - .' * **ScanTime**：扫描数据总耗时。'."\n" - .' * **PlanningTime**：执行计划生成耗时。'."\n" - .' * **WallTime**：查询中的所有算子在各个节点CPU Time的累加值。'."\n" - .' * **ProcessID**：进程ID。'."\n" - ."\n" - .'* `Type`表示排序类型，支持如下取值：'."\n" - .' * **Desc**：降序。'."\n" - .' * **Asc**：升序。', - 'type' => 'string', - 'required' => false, - 'example' => '[{"Field":"ExecuteTime","Type":"Desc"},{"Field":"HostAddress","Type":"Asc"}]', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '删除备份集', + 'summary' => '手动删除备份集。', + 'description' => '- 单次最大允许删除100个备份集。如果要删超过100个备份集，请分2次调用。'."\n" + .'- 为保证数据安全性，系统会强制保留1个有效备份集。当要删除仅有的备份集时，接口会禁止。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteBackups'], ], + ], + 'ramActions' => [ [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **10**（默认值）'."\n" - .'- **30**'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '10', - 'example' => '10', - 'default' => '10', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteBackups', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"771C5FAA-530F-52F7-B84D-EBAD4561D590\\"\\n}","type":"json"}]', + ], + 'DeleteDBCluster' => [ + 'summary' => '删除集群。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - ], + 'AK' => [], ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], + ], + 'parameters' => [ [ - 'name' => 'ProxyUser', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '预留参数。', - 'type' => 'string', - 'required' => false, - 'example' => '无', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1r053byu48p****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '列表详情。', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '6974', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'string', - 'example' => '10', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '8A564B7F-8C00-43C0-8EC5-919FBB70573', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'string', - 'example' => '1', - ], - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-t4nj8619bz2w3****', - ], - 'Items' => [ - 'description' => '列表。', - 'type' => 'array', - 'items' => [ - 'description' => 'SQL记录列表。', - 'type' => 'object', - 'properties' => [ - 'HostAddress' => [ - 'description' => '执行目标SQL的客户端IP地址和端口号。', - 'type' => 'string', - 'example' => '100.104.XX.XX:43908', - ], - 'Succeed' => [ - 'description' => '目标SQL是否执行成功。取值说明：'."\n" - .'- **true**：执行成功。'."\n" - .'- **false**：执行失败。', - 'type' => 'string', - 'example' => 'true', - ], - 'SQLText' => [ - 'description' => 'SQL语句详情。', - 'type' => 'string', - 'example' => 'SELECT * FROM adb_hdfs_import_source', - ], - 'TotalTime' => [ - 'description' => '目标SQL的执行时长，单位：毫秒（ms）。', - 'type' => 'string', - 'example' => '216', - ], - 'ConnId' => [ - 'description' => '通信ID。', - 'type' => 'string', - 'example' => '14356****', - ], - 'DBName' => [ - 'description' => '执行目标SQL的数据库名称。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - 'SQLType' => [ - 'description' => '目标SQL的类型。', - 'type' => 'string', - 'example' => 'SELECT', - ], - 'ExecuteTime' => [ - 'description' => '目标SQL的执行开始时间，本地时间，格式为：yyyy-MM-dd HH:mm:ss。', - 'type' => 'string', - 'example' => '2022-08-12 10:10:00', - ], - 'ExecuteTimestamp' => [ - 'type' => 'integer', - 'format' => 'int64', - ], - 'ProcessID' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => '202106081752021720161662490345362390', - ], - 'User' => [ - 'description' => '执行目标SQL的用户名。', - 'type' => 'string', - 'example' => 'test', - ], - 'HasDiagnosticInfo' => [ - 'type' => 'boolean', - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-bp1r053byu48p****'], ], + 'description' => '', ], ], ], 'errorCodes' => [ + 400 => [ + ['errorCode' => 'ACS.Cluster.InvalidWorkerState', 'errorMessage' => 'The state of the worker does not support this operation.', 'description' => '当前存储节点的状态不支持此操作'], + ['errorCode' => 'ACS.Cluster.ElasticPlanJobsExists', 'errorMessage' => 'Operation failed. Ongoing elastic plan jobs exist.', 'description' => '无法执行此操作：存在正在运行的存储弹性计划作业'], + ], 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' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": \\"6974\\",\\n \\"PageSize\\": \\"10\\",\\n \\"RequestId\\": \\"8A564B7F-8C00-43C0-8EC5-919FBB70573\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"DBClusterId\\": \\"amv-t4nj8619bz2w3****\\",\\n \\"Items\\": [\\n {\\n \\"HostAddress\\": \\"100.104.XX.XX:43908\\",\\n \\"Succeed\\": \\"true\\",\\n \\"SQLText\\": \\"SELECT * FROM adb_hdfs_import_source\\",\\n \\"TotalTime\\": \\"216\\",\\n \\"ConnId\\": \\"14356****\\",\\n \\"DBName\\": \\"adb_demo\\",\\n \\"SQLType\\": \\"SELECT\\",\\n \\"ExecuteTime\\": \\"2022-08-12 10:10:00\\",\\n \\"ExecuteTimestamp\\": 0,\\n \\"ProcessID\\": \\"202106081752021720161662490345362390\\",\\n \\"User\\": \\"test\\",\\n \\"HasDiagnosticInfo\\": true\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeAuditLogRecordsResponse>\\n <TotalCount>6974</TotalCount>\\n <PageSize>10</PageSize>\\n <RequestId>8A564B7F-8C00-43C0-8EC5-919FBB70573</RequestId>\\n <PageNumber>1</PageNumber>\\n <DBClusterId>amv-t4nj8619bz2w3****</DBClusterId>\\n <Items>\\n <HostAddress>100.104.XX.XX:43908</HostAddress>\\n <Succeed>true</Succeed>\\n <SQLText>SELECT * FROM adb_hdfs_import_source</SQLText>\\n <TotalTime>216</TotalTime>\\n <ConnId>14356****</ConnId>\\n <DBName>adb_demo</DBName>\\n <SQLType>SELECT</SQLType>\\n <ExecuteTime>2022-08-12 10:10:00</ExecuteTime>\\n <ProcessID>202106081752021720161662490345362390</ProcessID>\\n <User>test</User>\\n </Items>\\n</DescribeAuditLogRecordsResponse>","errorExample":""}]', - 'title' => '查询SQL审计日志', - 'description' => '- 仅当SQL审计状态为开启时，才能查询到SQL审计日志，且只支持查询30天内的SQL审计日志。如果中途关闭了SQL审计，再次打开时，仅能查询到再次打开后的SQL审计日志。SQL审计日志不记录**INSERT INTO VALUES**、**REPLACE INTO VALUES**和**UPSERT INTO VALUES**操作。'."\n" + 'title' => '释放集群', + 'description' => '### 注意事项'."\n" + .'- 仅支持删除按量付费类型的集群。'."\n" + .'- 集群状态为运行中。'."\n" .'- 当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'ModifyAuditLogConfig' => [ - 'summary' => '修改集群的SQL审计日志设置。', - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2023-04-13T11:20:16.000Z', 'description' => '错误码发生变更、响应参数发生变更'], + ['createdAt' => '2022-11-16T06:05:49.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-11-03T03:01:24.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-11T16:51:57.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteDBCluster'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteDBCluster', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"DBClusterId\\": \\"amv-bp1r053byu48p****\\"\\n}","errorExample":""},{"type":"xml","example":"<DeleteDBClusterResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <DBClusterId>amv-bp1r053byu48p****</DBClusterId>\\n</DeleteDBClusterResponse>","errorExample":""}]', + ], + 'DeleteDBResourceGroup' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -8983,758 +5440,407 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'delete', 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '132366', - 'abilityTreeNodes' => [ - 'FEATUREadsGAMOR7', - ], - 'tenantRelevance' => 'tenant', + 'chargeType' => 'paid', + 'abilityTreeCode' => '136447', + 'abilityTreeNodes' => ['FEATUREadsYXZ2UA'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-t4nj8619bz2w3****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版的集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'AuditLogStatus', - 'in' => 'query', - 'schema' => [ - 'description' => '修改SQL审计日志的状态。取值说明：'."\n" - .'- **on**：开启SQL审计。'."\n" - .'- **off**：关闭SQL审计。'."\n" - ."\n" - .'> SQL审计功能关闭后，SQL审计日志会被清空。请先查询和导出SQL审计日志，再关闭SQL审计功能。具体操作，请参见[DescribeAuditLogRecords](~~612426~~)。当再次打开审计日志，审计日志将从最近一次打开审计日志的时间开始展示。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'on', - ], - ], - [ - 'name' => 'EngineType', + 'name' => 'GroupName', 'in' => 'query', - 'schema' => [ - 'description' => '计算引擎类型。取值说明：'."\n" - ."\n" - .'- XIHE（**默认值**）：羲和计算引擎。'."\n" - .'- SPARK：Spark计算引擎。', - 'type' => 'string', - 'required' => false, - 'example' => 'XIHE', - ], + 'schema' => ['description' => '资源组名称。'."\n" + .'> 您可以调用[DescribeDBResourceGroup](~~612410~~)接口查看指定集群的资源组信息，包括资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'test_group'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '列表详情。', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'CDC59E56-BD07-56CA-A05F-B7907DE5C862', - ], - 'UpdateSucceed' => [ - 'description' => '是否已更新SQL审计的开启状态。取值说明：'."\n" - .'- **true**：状态已更新。'."\n" - .'- **false**：状态更新失败。', - 'type' => 'boolean', - 'example' => 'true', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'A94B6C02-7BD4-5D67-9776-3AC8317E8DD3'], ], ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'InvalidPoolName.Malformed', 'errorMessage' => 'The specified parameter PoolName is not valid.', 'description' => 'PoolName参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPoolUser.Malformed', 'errorMessage' => 'The specified parameter PoolUser is not valid.', 'description' => 'PoolUser参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'ACS.ResourceGroup.ElasticPlanExists', 'errorMessage' => 'This resource group does not support this operation. Elastic plans that have been enabled already exist.', 'description' => '当前资源组不支持此操作：存在启用的弹性计划。'], + ['errorCode' => 'ACS.ResourceGroup.InvalidResourceGroupState', 'errorMessage' => 'The state of this resource group does not support this operation.', 'description' => '当前状态的资源组不支持此操作。'], + ['errorCode' => 'ACS.ResourceGroup.OngoingJobExists', 'errorMessage' => 'Resource group has ongoing job(s).', 'description' => '资源组有正在进行的作业。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CDC59E56-BD07-56CA-A05F-B7907DE5C862\\",\\n \\"UpdateSucceed\\": true\\n}","errorExample":""},{"type":"xml","example":"<ModifyAuditLogConfigResponse>\\n <RequestId>CDC59E56-BD07-56CA-A05F-B7907DE5C862</RequestId>\\n <UpdateSucceed>true</UpdateSucceed>\\n</ModifyAuditLogConfigResponse>","errorExample":""}]', - 'title' => '修改SQL审计日志设置', + 'title' => '删除资源组', + 'summary' => '调用CreateDBResourceGroup接口删除指定集群的资源组。', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeSparkAuditLogRecords' => [ - 'summary' => '查询Spark Interactive资源组的SQL审计日志。', - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2023-06-07T16:00:26.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-04-13T11:20:16.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-03-31T07:03:58.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:51:36.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteDBResourceGroup'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteDBResourceGroup', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A94B6C02-7BD4-5D67-9776-3AC8317E8DD3\\"\\n}","errorExample":""},{"type":"xml","example":"<DeleteDBResourceGroupResponse>\\n <RequestId>A94B6C02-7BD4-5D67-9776-3AC8317E8DD3</RequestId>\\n</DeleteDBResourceGroupResponse>","errorExample":""}]', + ], + 'DeleteElasticPlan' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '235459', - 'abilityTreeNodes' => [ - 'FEATUREadsGAMOR7', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', - ], + 'systemTags' => ['operationType' => 'delete'], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'ElasticPlanName', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - ."\n" - .'> - 您可以调用[DescribeDBClusters](~~454250~~)接口可以查询集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1j7******78j8i', - ], + 'schema' => ['description' => '弹性计划名称。'."\n" + .'> 调用[DescribeElasticPlans](~~601334~~)接口可以查看集群的弹性计划名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], ], [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~612293~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-shanghai', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下所有集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-wz9509beptiz****'], ], - [ - 'name' => 'StartTime', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。'."\n" - .'> 建议查询开始时间设置为30天内的任意时间点。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2025-09-25T00:00Z', + 'title' => 'BaseResponse', + 'description' => 'BaseResponse', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD'], + ], ], ], - [ - 'name' => 'EndTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间，需要大于查询开始时间，且与查询开始时间间隔小于1天。'."\n" - .'格式：yyyy-MM-ddTHH:mmZ（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2025-09-25T01:00Z', - ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - [ - 'name' => 'User', - 'in' => 'query', - 'schema' => [ - 'description' => 'SQL执行用户名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_user', - ], + ], + 'title' => '删除弹性计划', + 'summary' => '删除集群的弹性计划。', + 'description' => '- 删除弹性计划前，需先停用该计划。'."\n" + .'- 当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-12-12T10:09:37.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-04-13T11:20:16.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteElasticPlan'], ], + ], + 'ramActions' => [ [ - 'name' => 'Order', - 'in' => 'query', - 'schema' => [ - 'description' => '根据指定字段对SQL语句进行排序，格式为JSON，是一个有序JSON数组，按输入数组的顺序进行复合排序，包含`Field`和`Type`两个字段，例如`[{"Field":"TotalTime", "Type": "desc" }]`。其中：'."\n" - ."\n" - .'- `Field`表示需要排序的字段名，支持如下字段：'."\n" - .' - `ResourceGroupName`：资源组名称。'."\n" - .' - `Status`：SQL执行状态。'."\n" - .' - `User`：SQL执行用户名。'."\n" - .' - `ExecuteTime`：SQL执行开始时间。'."\n" - .' - `TotalTime`：SQL执行时长。'."\n" - .' - `ProcessId`：查询ID。'."\n" - .' - `ClientIp`：访问源地址。'."\n" - .' - `StatementSource`：查询发起来源。'."\n" - ."\n" - .'- `Type`表示排序类型，支持如下取值（取值均不区分大小写）：'."\n" - .' - `Desc`：降序。'."\n" - .' - `Asc`：升序。', - 'type' => 'string', - 'required' => false, - 'example' => '[{\\"Field\\":\\"ExecuteTime\\",\\"Type\\":\\"Desc\\"}]', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteElasticPlan', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<DeleteElasticPlanResponse>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</DeleteElasticPlanResponse>","errorExample":""}]', + ], + 'DeleteFormationCrawler' => [ + 'summary' => '删除元数据发现任务', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '10', - 'example' => '30', - 'default' => '10', - ], + 'AK' => [], ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'none', + 'abilityTreeCode' => '138243', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], + ], + 'parameters' => [ [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域id，您可通过接口[describeregions](~~143074~~)查看可用的地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'ProxyUser', - 'in' => 'query', - 'schema' => [ - 'description' => '废弃参数。', - 'type' => 'string', - 'required' => false, - 'example' => 'user', - ], + 'name' => 'CrawlerTaskId', + 'in' => 'formData', + 'schema' => ['description' => '任务id。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '247'], ], [ - 'name' => 'ResourceGroupName', - 'in' => 'query', - 'schema' => [ - 'description' => '资源组名称。'."\n" - .'> 您可以调用[DescribeDBResourceGroup](~~612410~~)接口查看集群的资源组ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_job', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '实例id。', 'type' => 'string', 'required' => true, 'example' => 'amv-8vbc***'], ], [ - 'name' => 'Status', - 'in' => 'query', + 'name' => 'CrawlerTaskName', + 'in' => 'formData', + 'schema' => ['description' => '任务名称。', 'type' => 'string', 'required' => true, 'example' => 'wz_log'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => 'SQL执行状态。', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'cancel' => '已取消。', - 'finish' => '执行成功。', - 'error' => '执行失败。', - 'timeout' => '执行超时。', + 'type' => 'object', + 'properties' => [ + 'HttpStatusCode' => ['description' => 'http状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '是否成功删除。-true：删除成功。-false：删除失败。', 'type' => 'boolean', 'example' => 'True'], + 'RequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => 'E8DA77FA-FF0F-5516-A551-86C6E2D4BE92'], + 'Success' => ['description' => '是否成功。', 'type' => 'boolean', 'example' => 'True'], + 'Code' => ['description' => '状态码。', 'type' => 'string', 'example' => 'InvalidInput'], + 'Message' => ['description' => '错误信息。', 'type' => 'string', 'example' => 'OK'], ], - 'example' => 'finish', + 'description' => '', ], ], - [ - 'name' => 'StatementId', - 'in' => 'query', - 'schema' => [ - 'description' => 'Statement ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'fbd22066-1c03-xxxx-aa16-6ae28288****', - ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid. ', 'description' => ''], + ['errorCode' => 'NotExists', 'errorMessage' => 'The formation task does not exist. ', 'description' => ''], ], - [ - 'name' => 'TotalTime', - 'in' => 'query', - 'schema' => [ - 'description' => 'SQL执行时长，单位：毫秒（ms）。', - 'type' => 'string', - 'required' => false, - 'example' => '3000', - ], + 500 => [ + ['errorCode' => 'ServerStoreError', 'errorMessage' => 'A server storage error occurred.', 'description' => ''], ], + ], + 'title' => '删除元数据发现任务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": true,\\n \\"RequestId\\": \\"E8DA77FA-FF0F-5516-A551-86C6E2D4BE92\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', + ], + 'DeleteLakeStorage' => [ + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'SQLText', - 'in' => 'query', - 'schema' => [ - 'description' => 'SQL语句中的关键词。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_table_name', - ], + 'AK' => [], ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'delete', + 'abilityTreeCode' => '216926', + 'abilityTreeNodes' => ['FEATUREadsQO9FPM'], + ], + 'parameters' => [ [ - 'name' => 'ProcessId', - 'in' => 'query', - 'schema' => [ - 'description' => '查询ID。', - 'type' => 'string', - 'required' => false, - 'example' => '999f2439-6b10-xxxx-a5d3-daf3b35c****', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'], ], [ - 'name' => 'ClientIp', - 'in' => 'query', - 'schema' => [ - 'description' => '访问源地址。', - 'type' => 'string', - 'required' => false, - 'example' => '192.168.XX.XX', - ], + 'name' => 'LakeStorageId', + 'in' => 'formData', + 'schema' => ['title' => '实例 ID。', 'description' => '湖存储实例 ID。', 'type' => 'string', 'required' => true, 'example' => '-'], ], [ - 'name' => 'StatementSource', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '查询发起来源。', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'SQL_EDITOR' => 'SQL_EDITOR', - 'JDBC' => 'JDBC', - ], - 'example' => 'SQL_EDITOR', - ], + 'schema' => ['description' => 'ADB实例ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-bp*********'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '100', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'string', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '2D5867CF-423F-559F-BBB1-199A289E****', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'string', - 'example' => '1', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp1j7******78j8i', - ], - 'Items' => [ - 'description' => 'SQL记录列表。', - 'type' => 'array', - 'items' => [ - 'description' => '详情。', - 'type' => 'object', - 'properties' => [ - 'SQLText' => [ - 'description' => 'SQL语句详情。', - 'type' => 'string', - 'example' => 'SELECT * FROM adb_hdfs_import_source', - ], - 'TotalTime' => [ - 'description' => 'SQL执行时长，单位：毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '40000', - ], - 'ExecuteTime' => [ - 'description' => 'SQL执行开始时间，UTC时间，格式为：yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'example' => '2022-01-23T16:05:08Z', - ], - 'User' => [ - 'description' => 'SQL执行用户名。', - 'type' => 'string', - 'example' => 'test_user', - ], - 'StatementId' => [ - 'description' => 'Statement ID。', - 'type' => 'string', - 'example' => 'fbd22066-1c03-xxxx-aa16-6ae28288****', - ], - 'Status' => [ - 'description' => 'SQL执行状态。', - 'type' => 'string', - 'enumValueTitles' => [ - 'cancel' => '已取消。', - 'finish' => '执行成功。', - 'error' => '执行失败。', - 'timeout' => '执行超时。', - ], - 'example' => 'finish', - ], - 'ResourceGroupName' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'example' => 'test_job', - ], - 'AppId' => [ - 'description' => 'Spark应用ID。', - 'type' => 'string', - 'example' => 's202411061011hzc5d6476000****', - ], - 'InnerQueryId' => [ - 'description' => 'Spark 应用内部 query 执行 ID。', - 'type' => 'string', - 'example' => '1', - ], - 'IsDiagnosable' => [ - 'description' => '是否可诊断。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'ClientIp' => [ - 'description' => '访问源地址。', - 'type' => 'string', - 'example' => '192.168.XX.XX', - ], - 'ProcessId' => [ - 'description' => '查询ID。', - 'type' => 'string', - 'example' => '999f2439-6b10-xxxx-a5d3-daf3b35c****', - ], - 'StatementSource' => [ - 'description' => '查询发起来源。', - 'type' => 'string', - 'enumValueTitles' => [ - 'SQL_EDITOR' => 'SQL_EDITOR', - 'JDBC' => 'JDBC', - ], - 'example' => 'SQL_EDITOR', - ], - 'ErrorMsg' => [ - 'description' => 'SQL执行错误信息。', - 'type' => 'string', - 'example' => 'notFoundIp', - ], - 'ErrorTrace' => [ - 'description' => 'SQL执行错误堆栈。', - 'type' => 'string', - 'example' => 'notFoundIpException', - ], - ], - ], - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '2******-B2C1-408E-AA73-DB8D59******'], + 'Message' => ['title' => '若创建接口为异步实现，则需返回明确的JobId。', 'description' => '若创建接口为异步实现，则需返回明确的JobId。', 'type' => 'string', 'example' => 'Success'], + 'HttpStatusCode' => ['description' => 'HTTP状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Success' => ['description' => '调用是否成功。'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '状态码。说明 200表示成功。', 'type' => 'string', 'example' => '200'], + 'Data' => ['description' => '删除结果。', 'type' => 'string', 'example' => 'True'], ], ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 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', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"100\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"2D5867CF-423F-559F-BBB1-199A289E****\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"DBClusterId\\": \\"amv-bp1j7******78j8i\\",\\n \\"Items\\": [\\n {\\n \\"SQLText\\": \\"SELECT * FROM adb_hdfs_import_source\\",\\n \\"TotalTime\\": 40000,\\n \\"ExecuteTime\\": \\"2022-01-23T16:05:08Z\\",\\n \\"User\\": \\"test_user\\",\\n \\"StatementId\\": \\"fbd22066-1c03-xxxx-aa16-6ae28288****\\",\\n \\"Status\\": \\"finish\\",\\n \\"ResourceGroupName\\": \\"test_job\\",\\n \\"AppId\\": \\"s202411061011hzc5d6476000****\\",\\n \\"InnerQueryId\\": \\"1\\",\\n \\"IsDiagnosable\\": true,\\n \\"ClientIp\\": \\"192.168.XX.XX\\",\\n \\"ProcessId\\": \\"999f2439-6b10-xxxx-a5d3-daf3b35c****\\",\\n \\"StatementSource\\": \\"SQL_EDITOR\\",\\n \\"ErrorMsg\\": \\"notFoundIp\\",\\n \\"ErrorTrace\\": \\"notFoundIpException\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', - 'title' => '查询Spark Interactive资源组的SQL审计日志。', - 'description' => '仅当SQL审计状态为开启时，才能查询到SQL审计日志，且只支持查询30天内的SQL审计日志。如果中途关闭了SQL审计，再次打开时，仅能查询到再次打开后的SQL审计日志。'."\n" - ."\n" - .'><notice>本接口只能查询到，通过**Spark Interactive型资源组**执行的SQL审计日志。></notice>', - ], - 'DescribeClusterNetInfo' => [ - 'summary' => '调用DescribeDBClusterNetInfo接口查询指定集群的网络信息。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除湖存储', + 'summary' => '删除湖存储。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteLakeStorage'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteLakeStorage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2******-B2C1-408E-AA73-DB8D59******\\",\\n \\"Message\\": \\"Success\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Data\\": \\"True\\"\\n}","type":"json"}]', + ], + 'DeleteMaterializedViewRecommend' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '133667', - 'abilityTreeNodes' => [ - 'FEATUREads4DZDZG', - ], + 'abilityTreeNodes' => ['FEATUREadsTYGUV3'], ], 'parameters' => [ [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'], + ], + [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-wz9dqvn0o7****', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-uf66*****'], ], [ - 'name' => 'Engine', + 'name' => 'TaskName', 'in' => 'query', - 'schema' => [ - 'description' => '数据库引擎，取值：'."\n" - ."\n" - .'- **AnalyticDB**（默认）：AnalyticDB for MySQL引擎。'."\n" - .'- **Clickhouse**：宽表引擎。', - 'type' => 'string', - 'required' => false, - 'example' => 'Clickhouse', - ], + 'schema' => ['title' => '推荐任务名称', 'description' => '物化视图推荐任务的名称。', 'type' => 'string', 'required' => true, 'example' => 'my_task_1'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'ClusterNetworkType' => [ - 'description' => '集群网络类型，当前仅支持专有网络，取值固定为**VPC**。', - 'type' => 'string', - 'example' => 'VPC', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '69A29B65-CD0C-52B1-BE42-8B454569747F', - ], - 'Items' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Address' => [ - 'description' => '详情。', - 'type' => 'array', - 'items' => [ - 'description' => '集群列表。', - 'type' => 'object', - 'properties' => [ - 'VSwitchId' => [ - 'description' => '交换机ID。'."\n" - .'> 当NetType取值为Public时，交换机ID返回为空。', - 'type' => 'string', - 'example' => 'vsw-bp1syh8vvw8yec****', - ], - 'ConnectionString' => [ - 'description' => '集群的网络连接地址。'."\n" - .'- 当网络类型为VPC时，ConnectionString为VPC地址。'."\n" - .'- 当网络类型为Public时，ConnectionString为公网地址。', - 'type' => 'string', - 'example' => 'amv-wz9dqvn0o7****.ads.aliyuncs.com', - ], - 'NetType' => [ - 'description' => '网络类型。取值说明：'."\n" - .'- **Public**：公网。'."\n" - .'- **VPC**：VPC网络。', - 'type' => 'string', - 'example' => 'VPC', - ], - 'Port' => [ - 'description' => '端口号。固定为**3306**。', - 'type' => 'string', - 'example' => '3306', - ], - 'VPCId' => [ - 'description' => 'VPC ID。'."\n" - .'> 当NetType取值为Public时，VPC ID返回为空。', - 'type' => 'string', - 'example' => 'vpc-8vbhucmd5b****', - ], - 'IPAddress' => [ - 'description' => 'IP地址。'."\n" - .'- 当网络类型为VPC时，IPAddress为私网IP地址。'."\n" - .'- 当网络类型为Public时，IPAddress为连接数据库的客户端IP地址。', - 'type' => 'string', - 'example' => '192.168.xx.xx', - ], - 'ConnectionStringPrefix' => [ - 'description' => '网络地址的前缀。'."\n" - .'- 当网络类型为VPC时，ConnectionStringPrefix为VPC地址的前辍。'."\n" - .'- 当网络类型为Public时，ConnectionStringPrefix为数据库公网连接地址的前缀。', - 'type' => 'string', - 'example' => 'amv-wz9dqvn0o7****', - ], - 'Ports' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'ports' => [ - 'description' => '端口列表。', - 'type' => 'array', - 'items' => [ - 'description' => '端口详情', - 'type' => 'object', - 'properties' => [ - 'Port' => [ - 'description' => '对外服务端口。', - 'type' => 'string', - 'example' => '3306', - ], - 'Protocol' => [ - 'description' => '协议类型。取值：'."\n" - ."\n" - .' - **tcp**：传输控制协议。'."\n" - .' - **http**：超文本传输协议。'."\n" - .' - **https**：超文本传输安全协议。'."\n" - .'- **mysql**：MySQL协议。', - 'type' => 'string', - 'example' => 'mysql', - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '7B081A85-0568-5E54-82EF-6958C4A3D4B4'], ], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ACS.InvalidParameter.%s', - 'errorMessage' => 'Parameter %s is invalid.', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除物化视图自动推荐任务', + 'summary' => '删除物化视图自动推荐任务。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteMaterializedViewRecommend'], ], - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + ], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteMaterializedViewRecommend', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"ClusterNetworkType\\": \\"VPC\\",\\n \\"RequestId\\": \\"69A29B65-CD0C-52B1-BE42-8B454569747F\\",\\n \\"Items\\": {\\n \\"Address\\": [\\n {\\n \\"VSwitchId\\": \\"vsw-bp1syh8vvw8yec****\\",\\n \\"ConnectionString\\": \\"amv-wz9dqvn0o7****.ads.aliyuncs.com\\",\\n \\"NetType\\": \\"VPC\\",\\n \\"Port\\": \\"3306\\",\\n \\"VPCId\\": \\"vpc-8vbhucmd5b****\\",\\n \\"IPAddress\\": \\"192.168.xx.xx\\",\\n \\"ConnectionStringPrefix\\": \\"amv-wz9dqvn0o7****\\",\\n \\"Ports\\": {\\n \\"ports\\": [\\n {\\n \\"Port\\": \\"3306\\",\\n \\"Protocol\\": \\"mysql\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeClusterNetInfoResponse>\\n <ClusterNetworkType>VPC</ClusterNetworkType>\\n <RequestId>69A29B65-CD0C-52B1-BE42-8B454569747F</RequestId>\\n <Items>\\n <VSwitchId>vsw-bp1syh8vvw8yec****</VSwitchId>\\n <ConnectionString>amv-wz9dqvn0o7****.ads.aliyuncs.com</ConnectionString>\\n <NetType>VPC</NetType>\\n <Port>3306</Port>\\n <VPCId>vpc-8vbhucmd5b****</VPCId>\\n <IPAddress>192.168.xx.xx</IPAddress>\\n <ConnectionStringPrefix>amv-wz9dqvn0o7****</ConnectionStringPrefix>\\n </Items>\\n</DescribeClusterNetInfoResponse>","errorExample":""}]', - 'title' => '查询网络信息', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7B081A85-0568-5E54-82EF-6958C4A3D4B4\\"\\n}","type":"json"}]', ], - 'AllocateClusterPublicConnection' => [ - 'summary' => '为集群申请公网连接地址。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DeletePerformanceView' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'tags' => ['Perth'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '131191', - 'abilityTreeNodes' => [ - 'FEATUREads4DZDZG', - ], + 'abilityTreeCode' => '221469', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1z5d2q71is2****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 调用[DescribeDBClusters](~~612397~~)接口可以查看集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-uf6wjk5xxxxxxxxxx'], ], [ - 'name' => 'ConnectionStringPrefix', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '定义公网连接地址的前缀。'."\n" - .'- 以小写字母开头，可包含小写字母、数字和中划线（-）；'."\n" - .'- 长度不超过30个字符。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'test12', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'Engine', + 'name' => 'ViewName', 'in' => 'query', - 'schema' => [ - 'description' => '数据库引擎，取值：'."\n" - ."\n" - .'- **AnalyticDB**（默认）：AnalyticDB for MySQL引擎。'."\n" - .'- **Clickhouse**：宽表引擎。', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'AnalyticDB' => 'AnalyticDB', - 'Clickhouse' => 'Clickhouse', - ], - 'example' => 'Clickhouse', - ], + 'schema' => ['description' => '监控视图名称。', 'type' => 'string', 'required' => true, 'example' => 'Custom-All metrics-2 columns-Linked'], ], ], 'responses' => [ @@ -9742,132 +5848,137 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '868EF07F-D0B2-5043-B092-0C14CD00B65A', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'DeleteStatus' => ['description' => '删除结果，取值：'."\n" + ."\n" + .'- **SUCCESS**：成功'."\n" + .'- **FAILED**：失败', 'type' => 'boolean', 'example' => 'SUCCESS'], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息.'."\n" + .'> 只有RAM校验失败才会返回此字段。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidConnectionStringPrefix.Malformed', - 'errorMessage' => 'The specified connection string is invalid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'ACS.InvalidParameter.%s', - 'errorMessage' => 'Parameter %s is invalid.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'PerformanceViewNotFound', 'errorMessage' => 'Performance view not found.', 'description' => '没有找到指定的监控视图名'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"868EF07F-D0B2-5043-B092-0C14CD00B65A\\"\\n}","errorExample":""},{"type":"xml","example":"<AllocateClusterPublicConnectionResponse>\\n <RequestId>868EF07F-D0B2-5043-B092-0C14CD00B65A</RequestId>\\n</AllocateClusterPublicConnectionResponse>","errorExample":""}]', - 'title' => '申请公网地址', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'ReleaseClusterPublicConnection' => [ - 'summary' => '释放指定集群的公网连接地址。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除监控视图', + 'summary' => '删除监控视图。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeletePerformanceView'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeletePerformanceView', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"DeleteStatus\\": true,\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', + ], + 'DeleteSemanticView' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '131192', - 'abilityTreeNodes' => [ - 'FEATUREads4DZDZG', - ], + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'schema' => ['title' => 'ADB集群ID', 'description' => 'ADB集群ID', 'type' => 'string', 'required' => true, 'example' => 'am-bp11q28kvl688****'], ], [ - 'name' => 'Engine', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '数据库引擎，取值：'."\n" - ."\n" - .'- **AnalyticDB**（默认）：AnalyticDB for MySQL引擎。'."\n" - .'- **Clickhouse**：宽表引擎。', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'AnalyticDB' => 'AnalyticDB', - 'Clickhouse' => 'Clickhouse', - ], - 'example' => 'Clickhouse', - ], + 'schema' => ['title' => 'schema 名称。'."\n" + .' '."\n", 'description' => 'Schema 名称。', 'type' => 'string', 'required' => true, 'example' => 'adb_demo'], + ], + [ + 'name' => 'ViewName', + 'in' => 'query', + 'schema' => ['title' => '语义视图名称。', 'description' => '语义视图名称。', 'type' => 'string', 'required' => true, 'example' => 'adb_sv_name'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A94B6C02-7BD4-5D67-9776-3AC8317E8DD5', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '3A8F6106-6AFD-5A34-9C80-8DE2C42D06E8'], ], ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'MDS.CatalogAlreadyExist', 'errorMessage' => 'The catalog already exists.', 'description' => '目录已经存在'], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ['errorCode' => 'MDS.SemanticViewNotExist', 'errorMessage' => 'This semantic view does not exist.', 'description' => '此语义视图不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + [ + ['errorCode' => 'MDS.InstanceNotExist', 'errorMessage' => 'ADB instance does not exist.', 'description' => 'ADB 实例不存在'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A94B6C02-7BD4-5D67-9776-3AC8317E8DD5\\"\\n}","errorExample":""},{"type":"xml","example":"<ReleaseClusterPublicConnectionResponse>\\n <RequestId>A94B6C02-7BD4-5D67-9776-3AC8317E8DD5</RequestId>\\n</ReleaseClusterPublicConnectionResponse>","errorExample":""}]', - 'title' => '释放公网地址', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'AttachUserENI' => [ - 'summary' => '为集群创建VPC弹性网卡。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除语义视图', + 'summary' => '删除指定的语义视图', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"3A8F6106-6AFD-5A34-9C80-8DE2C42D06E8\\"\\n}","type":"json"}]', + ], + 'DeleteSparkTemplate' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -9876,27 +5987,23 @@ 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsPOF80W', - ], + 'operationType' => 'delete', + 'abilityTreeCode' => '132062', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], ], 'parameters' => [ [ + 'name' => 'Id', + 'in' => 'formData', + 'schema' => ['title' => '待删除模板文件的ID', 'description' => '待删除模板文件的目录ID或应用ID。'."\n" + .'> - 您可以调用[GetSparkTemplateFullTree](~~612467~~)接口查询目录ID或应用ID。'."\n" + .'- 输入目录ID时，会删除目录及目录下所有的应用模板文件。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'minimum' => '0', 'exclusiveMinimum' => true, 'example' => '725204'], + ], + [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-bp11q28kvl688****', - ], + 'in' => 'formData', + 'schema' => ['title' => '模板文件所在数据库的ID', 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****', 'maxLength' => 64], ], ], 'responses' => [ @@ -9904,63 +6011,115 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求id。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => [ + 'description' => '删除结果。', + 'type' => 'object', + 'properties' => [ + 'Succeeded' => ['title' => '是否删除成功', 'description' => '是否删除成功，取值说明：'."\n" + .'- **True**：删除成功。'."\n" + .'- **False**：删除失败。', 'type' => 'boolean', 'example' => 'True'], + ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '只允许分析处于终止状态的 Spark app。指定 app 不满足条件。'], + ['errorCode' => 'Spark.AnalyzeTask.FailedToKill', 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', 'description' => '杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。'], + ['errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.KillOperationFailed', 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', 'description' => '杀死 Spark 应用失败，请稍后重试。'], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.Log.IllegalPath', 'errorMessage' => 'Invalid job log URI: %s.', 'description' => '配置的Spark日志路径不合法：%s。'], + ['errorCode' => 'Spark.Log.InvalidState', 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'description' => '无法获取指定Spark作业的日志。'], + ['errorCode' => 'Spark.Oss.InternalError', 'errorMessage' => 'An OSS internal error occurred: %s', 'description' => 'OSS内部错误，请求失败。'], + ['errorCode' => 'Spark.RoleArn.Invalid', 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', 'description' => 'RoleArn不存在或子账号未授权。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', 'description' => 'Spark作业信息中的SQL无法解析。'], + ['errorCode' => 'Spark.TemplateFile.BadFileType', 'errorMessage' => 'The requested template %s is not a file.', 'description' => '请求的模板文件ID不是文件类型的。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.AnalyzeTask.NotFound', 'errorMessage' => 'The requested analysis task %s is not found.', 'description' => '请求查看的日志分析任务 %s 不存在。'], + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.Log.PodLogNotFound', 'errorMessage' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', 'description' => '无法通过podName找到对应pod的日志 [%s]。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], + ['errorCode' => 'Spark.TemplateFile.TemplateNotFound', 'errorMessage' => 'The template %s is not found.', 'description' => '模板文件未找到。'], + ], + 406 => [ + ['errorCode' => 'Spark.App.KillNotAcceptable', 'errorMessage' => 'Can\'t kill the application %s in %s state.', 'description' => '不能删除处于不可删除状态下的 Spark 应用。'], + ], + 500 => [ + ['errorCode' => 'Spark.Resources.LoadFileFromClasspathFailed', 'errorMessage' => 'Can\'t load the content from file: %s', 'description' => '加载资源文件失败。'], + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', - 'title' => '打通用户ENI', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DetachUserENI' => [ - 'summary' => '解绑用户弹性网卡', - 'methods' => [ - 'post', - 'get', + 'title' => '删除Spark模板', + 'summary' => '删除Spark模板文件。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-06-28T01:10:39.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteSparkTemplate'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteSparkTemplate', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/template/{#TemplateId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"Succeeded\\": true\\n }\\n}","errorExample":""},{"type":"xml","example":"<DeleteSparkTemplateResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Data>\\n <Succeeded>true</Succeeded>\\n </Data>\\n</DeleteSparkTemplateResponse>","errorExample":""}]', + ], + 'DeleteSparkTemplateFile' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsPOF80W', - ], + 'operationType' => 'delete', + 'abilityTreeCode' => '123240', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], ], 'parameters' => [ [ + 'name' => 'Id', + 'in' => 'formData', + 'schema' => ['title' => '模板文件的ID', 'description' => '需要删除模板的文件ID。'."\n" + .'> 调用[GetSparkTemplateFullTree](~~456205~~)接口查询所有现存的模板文件的ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'minimum' => '0', 'exclusiveMinimum' => true, 'example' => '284'], + ], + [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '实例id。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-bp11q28kvl688****', - ], + 'in' => 'formData', + 'schema' => ['title' => '数据库的ID', 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1y769u11748****', 'maxLength' => 64], ], ], 'responses' => [ @@ -9968,85 +6127,119 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求id。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'C3A9594F-1D40-4472-A96C-8FB8AA20D38C'], + 'Data' => [ + 'description' => '删除结果。', + 'type' => 'object', + 'properties' => [ + 'Succeeded' => ['description' => '是否成功删除，取值说明：'."\n" + .'- **true**：删除成功。'."\n" + .'- **false**：删除失败。', 'type' => 'boolean', 'example' => 'true'], + ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '只允许分析处于终止状态的 Spark app。指定 app 不满足条件。'], + ['errorCode' => 'Spark.AnalyzeTask.FailedToKill', 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', 'description' => '杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。'], + ['errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.KillOperationFailed', 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', 'description' => '杀死 Spark 应用失败，请稍后重试。'], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Log.IllegalPath', 'errorMessage' => 'Invalid job log URI: %s.', 'description' => '配置的Spark日志路径不合法：%s。'], + ['errorCode' => 'Spark.Log.InvalidState', 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'description' => '无法获取指定Spark作业的日志。'], + ['errorCode' => 'Spark.Oss.InternalError', 'errorMessage' => 'An OSS internal error occurred: %s', 'description' => 'OSS内部错误，请求失败。'], + ['errorCode' => 'Spark.RoleArn.Invalid', 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', 'description' => 'RoleArn不存在或子账号未授权。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', 'description' => 'Spark作业信息中的SQL无法解析。'], + ['errorCode' => 'Spark.TemplateFile.BadFileType', 'errorMessage' => 'The requested template %s is not a file.', 'description' => '请求的模板文件ID不是文件类型的。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.AnalyzeTask.NotFound', 'errorMessage' => 'The requested analysis task %s is not found.', 'description' => '请求查看的日志分析任务 %s 不存在。'], + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.Log.PodLogNotFound', 'errorMessage' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', 'description' => '无法通过podName找到对应pod的日志 [%s]。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], + ['errorCode' => 'Spark.TemplateFile.TemplateNotFound', 'errorMessage' => 'The template %s is not found.', 'description' => '模板文件未找到。'], + ], + 406 => [ + ['errorCode' => 'Spark.App.KillNotAcceptable', 'errorMessage' => 'Can\'t kill the application %s in %s state.', 'description' => '不能删除处于不可删除状态下的 Spark 应用。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ['errorCode' => 'Spark.Resources.LoadFileFromClasspathFailed', 'errorMessage' => 'Can\'t load the content from file: %s', 'description' => '加载资源文件失败。'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', - 'title' => '关闭用户ENI', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'ModifyUserEniVswitchOptions' => [ - 'summary' => '修改ENI交换机。', - 'path' => '', - 'methods' => [ - 'post', + 'title' => '删除Spark模板', + 'summary' => '删除Spark模板文件。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-06-28T01:10:38.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteSparkTemplateFile'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteSparkTemplate', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/template/{#TemplateId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C3A9594F-1D40-4472-A96C-8FB8AA20D38C\\",\\n \\"Data\\": {\\n \\"Succeeded\\": true\\n }\\n}","errorExample":""},{"type":"xml","example":"<DeleteSparkTemplateFileResponse>\\n <RequestId>C3A9594F-1D40-4472-A96C-8FB8AA20D38C</RequestId>\\n <Data>\\n <Succeeded>true</Succeeded>\\n </Data>\\n</DeleteSparkTemplateFileResponse>","errorExample":""}]', + ], + 'DescribeAPSADBInstances' => [ + 'summary' => '获取APS联邦分析ADB实例列表。', + 'methods' => ['get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads3N2V5J', - ], + 'operationType' => 'none', + 'abilityTreeCode' => '204210', + 'abilityTreeNodes' => ['FEATUREadsH8FO36'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '页数。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'docRequired' => true, 'maximum' => '10000', 'minimum' => '1', 'example' => '1'], ], [ - 'name' => 'DbClusterId', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'schema' => ['description' => '本页记录数。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'docRequired' => true, 'maximum' => '1000', 'minimum' => '1', 'example' => '30'], ], [ - 'name' => 'VSwitchOptions', - 'in' => 'formData', - 'schema' => [ - 'description' => '可选交换机列表。 交换机需要与ENI所属同一个VPC和可用区内，最多可填3个交换机，交换机之间用英文逗号（,）分隔。'."\n" - .'> * 所填写的交换机列表将覆盖已有ENI交换机列表。'."\n" - .'> * 您可以调用[DescribeDBClusterAttribute](~~612399~~)接口查看指定集群的ENI网络信息。', - 'type' => 'string', - 'required' => true, - 'example' => 'vsw-rj9ixufmywqq98z******,vsw-rj95ij6wcz656v7******'."\n", - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ @@ -10056,292 +6249,318 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常信息。', - 'type' => 'string', - 'example' => 'Success', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => '200', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：调用成功。'."\n" - .'- **false**：调用失败。', - 'type' => 'boolean', - 'example' => 'true', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '******'], + 'PageNumber' => ['description' => '页码。', 'type' => 'string', 'example' => '1'], + 'PageSize' => ['description' => '每页大小。', 'type' => 'string', 'example' => '30'], + 'TotalCount' => ['description' => '返回的结果总数。', 'type' => 'string', 'example' => '100'], + 'Items' => [ + 'description' => '列表。', + 'type' => 'array', + 'items' => [ + 'description' => '-', + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => 'AnalyticDB MySQL 湖仓版（3.0）集群 ID。', 'type' => 'string', 'example' => 'am-bp1********'], + 'DBClusterDescription' => ['description' => '集群的描述信息。', 'type' => 'string', 'example' => 'adb_test'], + 'ZoneId' => ['description' => '集群所在的可用区ID。', 'type' => 'string', 'example' => 'cn-hangzhou-h'], + 'ComputeResource' => ['description' => '计算预留资源规格。', 'type' => 'string', 'example' => '16ACU'], + 'StorageResource' => ['description' => '存储预留资源规格。', 'type' => 'integer', 'format' => 'int64', 'example' => '24ACU'], + 'ReservedACU' => ['description' => '集群剩余可分配计算预留资源。', 'type' => 'string', 'example' => '24ACU'], + 'DBClusterStatus' => ['description' => '集群状态。', 'type' => 'string', 'example' => 'Running'], + ], + ], + 'example' => '-', ], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => '0'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], + 'HttpStatusCode' => ['description' => 'HTTP状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], ], ], ], ], - 'errorCodes' => [], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid.', 'description' => ''], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"Success\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": true\\n}","type":"json"}]', - 'title' => '修改用户ENI交换机列表', - ], - 'ModifyDBClusterVip' => [ - 'summary' => '修改集群访问的VIP。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取联邦分析支持的ADB实例列表', + 'description' => '根据性能参数查看某个集群、某时间段范围内的性能监控数据。采集粒度为30秒。支持对慢SQL进行查询，提供SQL查询时长、扫描行数、扫描量等监控内容。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAPSADBInstances'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeAPSADBInstances', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"PageSize\\": \\"30\\",\\n \\"TotalCount\\": \\"100\\",\\n \\"Items\\": [\\n {\\n \\"DBClusterId\\": \\"am-bp1********\\",\\n \\"DBClusterDescription\\": \\"adb_test\\",\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"ComputeResource\\": \\"16ACU\\",\\n \\"StorageResource\\": 0,\\n \\"ReservedACU\\": \\"24ACU\\",\\n \\"DBClusterStatus\\": \\"Running\\"\\n }\\n ],\\n \\"Success\\": true,\\n \\"Code\\": \\"0\\",\\n \\"Message\\": \\"Success\\",\\n \\"HttpStatusCode\\": 200\\n}","type":"json"}]', + ], + 'DescribeAbnormalPatternDetection' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '212368', - 'abilityTreeNodes' => [ - 'FEATUREads3N2V5J', - ], + 'abilityTreeCode' => '194346', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下AnalyticDB MySQL湖仓版集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-2ze8mbuai97*****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-xxx'], ], [ - 'name' => 'VPCId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '专有网络VPC ID。'."\n" - ."\n" - .'> - **VPC**所在地域与集群属于同一地域。', - 'type' => 'string', - 'required' => true, - 'example' => 'vpc-bp1at5ze0t5u3xtqn****', - ], + 'schema' => ['description' => '运维事件所在地域的地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-zhangjiakou'], ], [ - 'name' => 'VSwitchId', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '虚拟交换机ID。'."\n" - .'> - 传入的新虚拟交换机必须与集群属于同一个可用区。', - 'type' => 'string', - 'required' => true, - 'example' => 'vsw-bp1aadw9k19x6cis9****', - ], + 'schema' => ['description' => '查询起始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2021-09-30T00:10Z'], ], [ - 'name' => 'ConnectString', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => '连接串地址。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-2ze8mbuai974s4y2500000169.ads.aliyuncs.com', - ], + 'schema' => ['description' => '查询结束时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。'."\n" + .'> 查询结束时间需晚于查询开始时间。'."\n", 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2024-11-17T02:16Z'], + ], + [ + 'name' => 'Lang', + 'in' => 'query', + 'schema' => ['description' => '语言配置，取值说明：'."\n" + .'- **zh**：简体中文（默认语言）。'."\n" + .'- **en**：英文。', 'type' => 'string', 'required' => false, 'example' => 'zh'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-****-4A42-BF6D-8A4442913CEF', + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '15'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '19B824E0-690D-5A78-9992-5398C2F43694'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-xxxx'], + 'DetectionItems' => [ + 'description' => '检测项及检测结果列表。', + 'type' => 'array', + 'items' => [ + 'description' => '检测项及检测结果列表。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '检测项名字。', 'type' => 'string', 'example' => 'Cost'], + 'Results' => [ + 'description' => '检测结果集合。', + 'type' => 'array', + 'items' => [ + 'description' => '检测结果对象。', + 'type' => 'object', + 'properties' => [ + 'PatternId' => ['description' => 'SQL Pattern的ID。', 'type' => 'string', 'example' => '2803084667741875187'], + 'SQLPattern' => ['description' => 'SQL Pattern的具体语句。', 'type' => 'string', 'example' => 'SELECT `tsid`nFROM `prod_ods_marketing_engine_material`nWHERE `tsid` = ?nLIMIT ?'], + 'Detail' => ['description' => '检测结果描述。', 'type' => 'string', 'example' => 'Two SQL patterns that have abnormal totalTime metric values are detected. This may cause high CPU usage or slow queries, which affects system stability. Go to the monitoring page and use one-click diagnostics to view details and optimize the queries.'], + 'RelatedMetrics' => ['description' => 'Pattern相关指标。', 'type' => 'string', 'example' => 'Maximum query duration: 1.43s'."\n" + .'Maximum peak memory: 20.73 MB'."\n" + .'Maximum table read data volume: 10.12 MB'], + 'User' => ['description' => '提交查询的用户名。', 'type' => 'string', 'example' => 'test'], + 'AccessIp' => ['description' => '提交Pattern相关的SQL客户端IP地址。', 'type' => 'string', 'example' => '172.16.133.168'], + 'Tables' => ['description' => '表名。', 'type' => 'string', 'example' => 'dw_student_exam.ods_school_queanal'], + 'QueryCount' => ['description' => '查询总数。', 'type' => 'integer', 'format' => 'int64', 'example' => '72'], + 'FailedCount' => ['description' => '指定时间范围内，Pattern的失败次数。', 'type' => 'integer', 'format' => 'int64', 'example' => '7'], + ], + ], + ], + ], + ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ACS.Cluster.InvalidState', - 'errorMessage' => 'The state of the cluster does not support this operation.', - ], - [ - 'errorCode' => 'InvalidConnectionString.Malformed', - 'errorMessage' => 'The specified parameter "ConnectionString" is not valid.', - ], - [ - 'errorCode' => 'InvalidConnectionString.UnSupported', - 'errorMessage' => 'The specified parameter "ConnectionString" Only support vpc address.', - ], - [ - 'errorCode' => 'ACS.InvalidParameter.%s', - 'errorMessage' => 'Parameter %s is invalid.', - ], - [ - 'errorCode' => 'ACS.UnsupportedAvailableZone', - 'errorMessage' => 'The specified available zone is not supported.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'ACS.ServerError', - 'errorMessage' => 'ADB Cloud Service failed to process your request.', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询异常模式检测', + 'summary' => '查询异常Pattern诊断结果。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAbnormalPatternDetection'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeAbnormalPatternDetection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-****-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', - 'title' => '修改集群访问VIP', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"15\\",\\n \\"RequestId\\": \\"19B824E0-690D-5A78-9992-5398C2F43694\\",\\n \\"DBClusterId\\": \\"amv-xxxx\\",\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"Cost\\",\\n \\"Results\\": [\\n {\\n \\"PatternId\\": \\"2803084667741875187\\",\\n \\"SQLPattern\\": \\"SELECT `tsid`nFROM `prod_ods_marketing_engine_material`nWHERE `tsid` = ?nLIMIT ?\\",\\n \\"Detail\\": \\"Two SQL patterns that have abnormal totalTime metric values are detected. This may cause high CPU usage or slow queries, which affects system stability. Go to the monitoring page and use one-click diagnostics to view details and optimize the queries.\\",\\n \\"RelatedMetrics\\": \\"Maximum query duration: 1.43s\\\\nMaximum peak memory: 20.73 MB\\\\nMaximum table read data volume: 10.12 MB\\",\\n \\"User\\": \\"test\\",\\n \\"AccessIp\\": \\"172.16.133.168\\",\\n \\"Tables\\": \\"dw_student_exam.ods_school_queanal\\",\\n \\"QueryCount\\": 72,\\n \\"FailedCount\\": 7\\n }\\n ]\\n }\\n ]\\n}","type":"json"}]', ], - 'ModifyDBClusterSSL' => [ - 'summary' => '修改集群的SSL链路配置。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'DescribeAccountAllPrivileges' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '216076', - 'abilityTreeNodes' => [ - 'FEATUREadsG383TB', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'operationType' => 'list', + 'abilityTreeCode' => '162785', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-************', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'EnableSSL', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '是否开启SSL链路加密功能，取值：'."\n" - ."\n" - .'- **true**：开启。'."\n" - .'- **false**：关闭。', - 'type' => 'boolean', - 'required' => true, - 'docRequired' => true, - 'example' => 'true', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp14t95lun0w****'], ], [ - 'name' => 'ConnectionString', + 'name' => 'AccountName', 'in' => 'query', - 'schema' => [ - 'description' => '需要创建或更新服务器证书的内网或外网连接地址。', - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => 'amv-***********.ads.aliyuncs.com', - ], + 'schema' => ['description' => '集群的数据库账户名称。', 'type' => 'string', 'required' => true, 'example' => 'account1'], ], [ - 'name' => 'RegionId', + 'name' => 'Marker', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '当请求的返回结果被截断时，可以将返回结果中的`Marker`填入到该字段以获取从当前截断位置之后的内容。', 'type' => 'string', 'required' => false, 'example' => 'EXAMPLE'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'BaseResponse', + 'description' => 'BaseResponse', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '3BB185E9-BB54-1727-B876-13243E4C0EB5'], + 'Data' => [ + 'description' => '权限详情。', + 'type' => 'object', + 'properties' => [ + 'Result' => [ + 'description' => '权限列表。', + 'type' => 'array', + 'items' => [ + 'description' => '权限详情。', + 'type' => 'object', + 'properties' => [ + 'PrivilegeType' => ['description' => '权限级别，来自接口`DescribeEnabledPrivileges`。', 'type' => 'string', 'example' => 'Global'], + 'PrivilegeObject' => [ + 'description' => '权限对象，为库、表和列的三元组，为Global权限级别时全为空。', + 'type' => 'object', + 'properties' => [ + 'Database' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'tdb1'], + 'Table' => ['description' => '表名称。', 'type' => 'string', 'example' => 'table1'], + 'Column' => ['description' => '列名称。', 'type' => 'string', 'example' => 'id'], + 'Description' => ['description' => '对权限对象的描述。', 'type' => 'string', 'example' => 'id of table'], + ], + ], + 'Privileges' => [ + 'description' => '权限列表。', + 'type' => 'array', + 'items' => ['description' => '权限名称，与接口`DescribeEnabledPrivileges`返回的权限名一致。'."\n", 'type' => 'string', 'example' => 'select'], + ], + ], + ], + ], + 'Marker' => ['description' => '当返回的字段`Truncated`为`true`时，继续调用该接口时传入该字段的值以获取接下来的内容。', 'type' => 'string', 'example' => '0573e74fd1ccb01739993a691e876074db6e1b6ad79f54115f0e98528432ba6a523cfec5780ade5189299cc3396f6ff7'], + 'Truncated' => ['description' => '当返回的内容被截断时，该字段的值为`true`。此时需要继续调用该接口获取接下来的内容，直到该字段的值为`false`。', 'type' => 'boolean', 'example' => 'true'], + ], ], ], ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'ACS.Account.NotExist', 'errorMessage' => 'The account is not found.', 'description' => '用户账户不存在。'], + ['errorCode' => 'ACS.InvalidParameter.%s', 'errorMessage' => 'Parameter %s is invalid.', 'description' => '输入的参数无效'], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => ''], + ['errorCode' => 'ACS.User.NotBindDatabaseAccount', 'errorMessage' => 'The user has not been associated with a database account.', 'description' => '用户没有绑定数据库账户。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '查询数据库账号的所有权限', + 'summary' => '获取给定账号拥有的所有权限，包括全局、库、表、列级别。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-12-06T02:33:11.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-04-20T14:39:17.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-03-24T06:25:39.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', - 'title' => '修改ADB实例的SSL配置', - ], - 'DescribeDBClusterSSL' => [ - 'summary' => '查询集群的SSL配置情况。', - 'methods' => [ - 'post', - 'get', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAccountAllPrivileges'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAccountAllPrivileges', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"3BB185E9-BB54-1727-B876-13243E4C0EB5\\",\\n \\"Data\\": {\\n \\"Result\\": [\\n {\\n \\"PrivilegeType\\": \\"Global\\",\\n \\"PrivilegeObject\\": {\\n \\"Database\\": \\"tdb1\\",\\n \\"Table\\": \\"table1\\",\\n \\"Column\\": \\"id\\",\\n \\"Description\\": \\"id of table\\"\\n },\\n \\"Privileges\\": [\\n \\"select\\"\\n ]\\n }\\n ],\\n \\"Marker\\": \\"0573e74fd1ccb01739993a691e876074db6e1b6ad79f54115f0e98528432ba6a523cfec5780ade5189299cc3396f6ff7\\",\\n \\"Truncated\\": true\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeAccountAllPrivilegesResponse>\\n <RequestId>3BB185E9-BB54-1727-B876-13243E4C0EB5</RequestId>\\n <Data>\\n <Result>\\n <PrivilegeType>Global</PrivilegeType>\\n <PrivilegeObject/>\\n </Result>\\n <Marker>0573e74fd1ccb01739993a691e876074db6e1b6ad79f54115f0e98528432ba6a523cfec5780ade5189299cc3396f6ff7</Marker>\\n <Truncated>true</Truncated>\\n </Data>\\n</DescribeAccountAllPrivilegesResponse>","errorExample":""}]', + ], + 'DescribeAccountPrivilegeObjects' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -10350,94 +6569,129 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '220651', - 'abilityTreeNodes' => [ - 'FEATUREadsG383TB', - ], + 'abilityTreeCode' => '160215', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - ."\n" - .'> 您可以调用[DescribeRegions](~~612393~~)接口查看集群所属的地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'ch-hangzhou'], ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-************', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1k3wdmt139****'], + ], + [ + 'name' => 'AccountName', + 'in' => 'query', + 'schema' => ['description' => '数据库账号名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'PrivilegeType', + 'in' => 'query', + 'schema' => ['description' => '权限级别，只能传入库（Database)）、表（Table）、列（Column）级别，不能传入全局（Global）级别。', 'type' => 'string', 'required' => false, 'example' => 'Column', 'default' => 'Database'], + ], + [ + 'name' => 'DatabasePrivilegeObject', + 'in' => 'query', + 'schema' => ['description' => '根据给定的数据库名称进行筛选。', 'type' => 'string', 'required' => false, 'example' => 'database1'], + ], + [ + 'name' => 'TablePrivilegeObject', + 'in' => 'query', + 'schema' => ['description' => '根据给定的表名称进行筛选。', 'type' => 'string', 'required' => false, 'example' => 'table1'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页号，从1开始，默认值1。', 'type' => 'string', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页含有条目的最大数量，默认为20。', 'type' => 'string', 'required' => false, 'example' => '20'], + ], + [ + 'name' => 'ColumnPrivilegeObject', + 'in' => 'query', + 'schema' => ['description' => '根据给定的列名进行筛选。', 'type' => 'string', 'required' => false, 'example' => 'col1'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '348303D8-6F42-5141-9B00-A6EECA1E37B6', - ], - 'ExpireTime' => [ - 'description' => 'SSL 证书有效期。格式：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。', - 'type' => 'string', - 'example' => '2022-10-11T08:16:43Z', - ], - 'ConnectionString' => [ - 'description' => '受SSL保护的连接地址。', - 'type' => 'string', - 'example' => 'amv-*********.ads.aliyuncs.com', - ], - 'SSLEnabled' => [ - 'description' => '是否开启SSL。'."\n" - .'取值： '."\n" - .'- true：开启。'."\n" - .'- false：关闭。', - 'type' => 'boolean', - 'example' => 'true', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '34B2AD29-682F-1C14-B3AA-9EF1A96084B8'], + 'Data' => [ + 'description' => '权限列表。', + 'type' => 'array', + 'items' => [ + 'description' => '权限对象，为库、表、列的三元组。', + 'type' => 'object', + 'properties' => [ + 'Database' => ['description' => '数据库名称，当权限级别是库、表、列时返回该字段。', 'type' => 'string', 'example' => 'tdb1'], + 'Table' => ['description' => '表名称，当权限级别是表和列时返回该字段。', 'type' => 'string', 'example' => 'table1'], + 'Column' => ['description' => '列名称，当权限界别是列时返回该字段。', 'type' => 'string', 'example' => 'column1'], + 'Description' => ['description' => '创建表/列时指定的描述。只有当权限级别为库和表时才有值，分别代表库和表的描述。', 'type' => 'string', 'example' => 'a test db'], + ], + ], ], + 'TotalCount' => ['description' => '查询得到的结果总数。', 'type' => 'integer', 'format' => 'int64', 'example' => '23'], + 'PageNumber' => ['description' => '页号，和传入的值一致。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '页大小，和传入的值一致。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], ], ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'ACS.Account.NotExist', 'errorMessage' => 'The account is not found.', 'description' => '用户账户不存在。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'ACS.InvalidParameter.%s', 'errorMessage' => 'Parameter %s is invalid.', 'description' => '输入的参数无效'], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => ''], + ['errorCode' => 'ACS.User.NotBindDatabaseAccount', 'errorMessage' => 'The user has not been associated with a database account.', 'description' => '用户没有绑定数据库账户。'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"348303D8-6F42-5141-9B00-A6EECA1E37B6\\",\\n \\"ExpireTime\\": \\"2022-10-11T08:16:43Z\\",\\n \\"ConnectionString\\": \\"amv-*********.ads.aliyuncs.com\\",\\n \\"SSLEnabled\\": true\\n}","type":"json"}]', - 'title' => '查询ADB实例的SSL配置', - 'description' => '><warning>目前该功能处于内测阶段，控制台界面展示及API调用接口尚未稳定，可能持续变化。></warning>', - ], - 'DownloadInstanceCACertificate' => [ - 'summary' => '获取CA证书下载OSS路径，用于连接宽表引擎。', - 'methods' => [ - 'post', - 'get', + 'title' => '查询数据库账号可见的库表列', + 'summary' => '获取给定账号可见的库表列。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-12-06T02:33:11.000Z', 'description' => '错误码发生变更、请求参数发生变更'], + ['createdAt' => '2023-04-20T14:39:17.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-03-24T06:25:39.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAccountPrivilegeObjects'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAccountPrivilegeObjects', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"34B2AD29-682F-1C14-B3AA-9EF1A96084B8\\",\\n \\"Data\\": [\\n {\\n \\"Database\\": \\"tdb1\\",\\n \\"Table\\": \\"table1\\",\\n \\"Column\\": \\"column1\\",\\n \\"Description\\": \\"a test db\\"\\n }\\n ],\\n \\"TotalCount\\": 23,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 20\\n}","errorExample":""},{"type":"xml","example":"<DescribeAccountPrivilegeObjectsResponse>\\n <RequestId>34B2AD29-682F-1C14-B3AA-9EF1A96084B8</RequestId>\\n <Data>\\n <Database>tdb1</Database>\\n <Table>table1</Table>\\n <Column>column1</Column>\\n <Description>a test db</Description>\\n </Data>\\n <TotalCount>23</TotalCount>\\n <PageNumber>1</PageNumber>\\n <PageSize>20</PageSize>\\n</DescribeAccountPrivilegeObjectsResponse>","errorExample":""}]', + ], + 'DescribeAccountPrivileges' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -10446,110 +6700,141 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '208235', - 'abilityTreeNodes' => [ - 'FEATUREads4DZDZG', - ], + 'abilityTreeCode' => '159083', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], ], 'parameters' => [ [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], + ], + [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz9842849v6****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1k5p066e1a****'], ], [ - 'name' => 'Engine', + 'name' => 'AccountName', 'in' => 'query', - 'schema' => [ - 'description' => '数据库引擎，取值：'."\n" - ."\n" - .'- **AnalyticDB**（默认）：AnalyticDB for MySQL引擎。'."\n" - .'- **Clickhouse**：宽表引擎。', - 'type' => 'string', - 'required' => false, - 'example' => 'Clickhouse', - ], + 'schema' => ['description' => '要查看权限的数据库账号名称。', 'type' => 'string', 'required' => true, 'example' => 'account1'], ], [ - 'name' => 'RegionId', + 'name' => 'PrivilegeType', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '要查看的权限级别，来自接口`DescribeEnabledPrivileges`。', 'type' => 'string', 'required' => false, 'example' => 'Global', 'default' => 'Database'], + ], + [ + 'name' => 'DatabasePrivilegeObject', + 'in' => 'query', + 'schema' => ['description' => '根据数据库名称进行筛选。只有当权限级别为库、表、列时才可用。', 'type' => 'string', 'required' => false, 'example' => 'db1'], + ], + [ + 'name' => 'TablePrivilegeObject', + 'in' => 'query', + 'schema' => ['description' => '根据表名称进行筛选。可以和库名称一起进行联合筛选，只有当权限级别是表和列时该参数才可用。', 'type' => 'string', 'required' => false, 'example' => 'table1'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页号，从1开始，默认值1。', 'type' => 'string', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页含有的条目数量，默认每页20条。', 'type' => 'string', 'required' => false, 'example' => '10'], + ], + [ + 'name' => 'ColumnPrivilegeObject', + 'in' => 'query', + 'schema' => ['description' => '根据列名称进行筛选，只有当权限级别是列时该参数才可用。', 'type' => 'string', 'required' => false, 'example' => 'col1'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '9CCFAAB4-97B7-5800-B9F2-685EB596E3EF', - ], - 'DownloadUrl' => [ - 'description' => '证书下载路径。', - 'type' => 'string', - 'example' => 'https://***/ca.crt', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'DA32480A-E3E5-1BE7-BA98-724551DC04C8'], + 'Data' => [ + 'description' => '权限详情列表。', + 'type' => 'array', + 'items' => [ + 'description' => '权限详情。', + 'type' => 'object', + 'properties' => [ + 'PrivilegeType' => ['description' => '权限级别，可以是全局`Global`、库`Databae`、表`Table`和列`Column`，来自接口`DescribeEnabledPrivileges`。', 'type' => 'string', 'example' => 'Column'], + 'PrivilegeObject' => [ + 'description' => '权限对象，为库表列的三元组，以及额外的描述信息。', + 'type' => 'object', + 'properties' => [ + 'Database' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'db1'], + 'Table' => ['description' => '表名称。', 'type' => 'string', 'example' => 'tabl1'], + 'Column' => ['description' => '列名称。', 'type' => 'string', 'example' => 'column1'], + 'Description' => ['description' => '描述信息。', 'type' => 'string', 'example' => 'a test column'], + ], + ], + 'Privileges' => [ + 'description' => '权限列表。', + 'type' => 'array', + 'items' => ['description' => '权限名，来自接口`DescribeEnabledPrivileges`。', 'type' => 'string', 'example' => 'insert,select'], + ], + ], + ], ], + 'TotalCount' => ['description' => '用户在该权限级别拥有的权限总数。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'PageNumber' => ['description' => '页号，和入参的页号一致。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '页大小，和入参的页大小一致。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - ], - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + ['errorCode' => 'ACS.Account.NotExist', 'errorMessage' => 'The account is not found.', 'description' => '用户账户不存在。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'ACS.InvalidParameter.%s', 'errorMessage' => 'Parameter %s is invalid.', 'description' => '输入的参数无效'], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => ''], + ['errorCode' => 'ACS.User.NotBindDatabaseAccount', 'errorMessage' => 'The user has not been associated with a database account.', 'description' => '用户没有绑定数据库账户。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '查询数据库账号的权限', + 'summary' => '获取给定数据库账号在某个级别拥有的权限。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~).', + 'changeSet' => [ + ['createdAt' => '2023-12-06T02:33:11.000Z', 'description' => '错误码发生变更、请求参数发生变更'], + ['createdAt' => '2023-04-20T14:39:16.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-03-24T06:25:38.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAccountPrivileges'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9CCFAAB4-97B7-5800-B9F2-685EB596E3EF\\",\\n \\"DownloadUrl\\": \\"https://***/ca.crt\\"\\n}","type":"json"}]', - 'title' => '获取证书下载地址', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAccountPrivileges', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA32480A-E3E5-1BE7-BA98-724551DC04C8\\",\\n \\"Data\\": [\\n {\\n \\"PrivilegeType\\": \\"Column\\",\\n \\"PrivilegeObject\\": {\\n \\"Database\\": \\"db1\\",\\n \\"Table\\": \\"tabl1\\",\\n \\"Column\\": \\"column1\\",\\n \\"Description\\": \\"a test column\\"\\n },\\n \\"Privileges\\": [\\n \\"insert,select\\"\\n ]\\n }\\n ],\\n \\"TotalCount\\": 100,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 20\\n}","errorExample":""},{"type":"xml","example":"<DescribeAccountPrivilegesResponse>\\n <RequestId>DA32480A-E3E5-1BE7-BA98-724551DC04C8</RequestId>\\n <Data>\\n <PrivilegeType>Column</PrivilegeType>\\n <PrivilegeObject>\\n <Database>db1</Database>\\n <Table>tabl1</Table>\\n <Column>column1</Column>\\n <Description>a test column</Description>\\n </PrivilegeObject>\\n <Privileges>insert,select</Privileges>\\n </Data>\\n <TotalCount>100</TotalCount>\\n <PageNumber>1</PageNumber>\\n <PageSize>20</PageSize>\\n</DescribeAccountPrivilegesResponse>","errorExample":""}]', ], 'DescribeAccounts' => [ - 'summary' => '查询集群的数据库账号。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -10562,32 +6847,20 @@ 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '131026', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ 'name' => 'AccountName', 'in' => 'query', - 'schema' => [ - 'description' => '数据库账号。'."\n" - .'> 此参数不填写时，默认返回所有数据库账号信息。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_accout', - ], + 'schema' => ['description' => '数据库账号。'."\n" + .'> 此参数不填写时，默认返回所有数据库账号信息。', 'type' => 'string', 'required' => false, 'example' => 'test_accout'], ], [ 'name' => 'Engine', @@ -10611,12 +6884,7 @@ 'description' => '数据库账号列表。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '9CCFAAB4-97B7-5800-B9F2-685EB596E3EF', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '9CCFAAB4-97B7-5800-B9F2-685EB596E3EF'], 'AccountList' => [ 'type' => 'object', 'itemNode' => true, @@ -10628,60 +6896,37 @@ 'description' => '详细信息。', 'type' => 'object', 'properties' => [ - 'AccountName' => [ - 'description' => '数据库账号。', - 'type' => 'string', - 'example' => 'test_accout', - ], - 'AccountStatus' => [ - 'description' => '账号状态。取值说明：'."\n" - .'- **Creating**：创建中。'."\n" - .'- **Available**：可用。'."\n" - .'- **Deleting**：删除中。', - 'type' => 'string', - 'example' => 'Available', - ], - 'AccountDescription' => [ - 'description' => '账号描述。', - 'type' => 'string', - 'example' => '测试数据库账号', - ], - 'RamUsers' => [ - 'description' => 'RAM用户的账号ID。', - 'type' => 'string', - 'example' => '1958134230****', - ], - 'AccountType' => [ - 'description' => '账号类型，取值说明：'."\n" - .'- **Normal**：普通账号。'."\n" - .'- **Super**：高权限账号。', - 'type' => 'string', - 'example' => 'Normal', - ], - 'Engine' => [ - 'description' => '数据库引擎，取值：'."\n" - ."\n" - .'- **AnalyticDB**：AnalyticDB MySQL引擎。'."\n" - .'- **Clickhouse**：宽表引擎。', - 'type' => 'string', - 'example' => 'Clickhouse', - ], + 'AccountName' => ['description' => '数据库账号。', 'type' => 'string', 'example' => 'test_accout'], + 'AccountStatus' => ['description' => '账号状态。取值说明：'."\n" + .'- **Creating**：创建中。'."\n" + .'- **Available**：可用。'."\n" + .'- **Deleting**：删除中。', 'type' => 'string', 'example' => 'Available'], + 'AccountDescription' => ['description' => '账号描述。', 'type' => 'string', 'example' => 'Test database account'], + 'RamUsers' => ['description' => 'RAM用户的账号ID。', 'type' => 'string', 'example' => '1958134230****'], + 'AccountType' => ['description' => '账号类型，取值说明：'."\n" + .'- **Normal**：普通账号。'."\n" + .'- **Super**：高权限账号。', 'type' => 'string', 'example' => 'Normal'], + 'Engine' => ['description' => '数据库引擎，取值：'."\n" + ."\n" + .'- **AnalyticDB**：AnalyticDB MySQL引擎。'."\n" + .'- **Clickhouse**：宽表引擎。', 'type' => 'string', 'example' => 'Clickhouse'], 'RamUserList' => [ 'type' => 'object', 'itemNode' => true, 'properties' => [ 'RamUserList' => [ + 'description' => '绑定的阿里云 RAM 用户 ID 列表。', 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], + 'items' => ['description' => '绑定的阿里云 RAM 用户 ID 。', 'type' => 'string', 'example' => '20732900249392****'], ], ], + 'description' => '', ], ], ], ], ], + 'description' => '', ], ], ], @@ -10689,306 +6934,235 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'ACS.Sql.CannotConnect', - 'errorMessage' => 'Cannot connect instance which type is %s.', - ], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'ACS.Sql.CannotConnect', 'errorMessage' => 'Cannot connect instance which type is %s.', 'description' => '无法连接到给定类型的子实例。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9CCFAAB4-97B7-5800-B9F2-685EB596E3EF\\",\\n \\"AccountList\\": {\\n \\"DBAccount\\": [\\n {\\n \\"AccountName\\": \\"test_accout\\",\\n \\"AccountStatus\\": \\"Available\\",\\n \\"AccountDescription\\": \\"测试数据库账号\\",\\n \\"RamUsers\\": \\"1958134230****\\",\\n \\"AccountType\\": \\"Normal\\",\\n \\"Engine\\": \\"Clickhouse\\",\\n \\"RamUserList\\": {\\n \\"RamUserList\\": [\\n \\"\\"\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeAccountsResponse>\\n <RequestId>9CCFAAB4-97B7-5800-B9F2-685EB596E3EF</RequestId>\\n <AccountList>\\n <AccountName>test_accout</AccountName>\\n <AccountStatus>Available</AccountStatus>\\n <AccountDescription>测试数据库账号</AccountDescription>\\n <RamUsers>1958134230****</RamUsers>\\n <AccountType>Normal</AccountType>\\n </AccountList>\\n</DescribeAccountsResponse>","errorExample":""}]', 'title' => '查询数据库账号', + 'summary' => '查询集群的数据库账号。', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'CreateAccount' => [ - 'summary' => '为集群创建数据库账号。', - 'methods' => [ - 'post', + 'changeSet' => [ + ['createdAt' => '2024-06-13T13:53:52.000Z', 'description' => '错误码发生变更、请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-03-31T07:03:59.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:51:57.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAccounts'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAccounts', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9CCFAAB4-97B7-5800-B9F2-685EB596E3EF\\",\\n \\"AccountList\\": {\\n \\"DBAccount\\": [\\n {\\n \\"AccountName\\": \\"test_accout\\",\\n \\"AccountStatus\\": \\"Available\\",\\n \\"AccountDescription\\": \\"Test database account\\",\\n \\"RamUsers\\": \\"1958134230****\\",\\n \\"AccountType\\": \\"Normal\\",\\n \\"Engine\\": \\"Clickhouse\\",\\n \\"RamUserList\\": {\\n \\"RamUserList\\": [\\n \\"20732900249392****\\"\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeAccountsResponse>\\n <RequestId>9CCFAAB4-97B7-5800-B9F2-685EB596E3EF</RequestId>\\n <AccountList>\\n <AccountName>test_accout</AccountName>\\n <AccountStatus>Available</AccountStatus>\\n <AccountDescription>测试数据库账号</AccountDescription>\\n <RamUsers>1958134230****</RamUsers>\\n <AccountType>Normal</AccountType>\\n </AccountList>\\n</DescribeAccountsResponse>","errorExample":""}]', + ], + 'DescribeAdbMySqlColumns' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '130688', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], - ], - [ - 'name' => 'AccountName', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库账号名称，需符合如下要求：'."\n" - .'- 以小写字母开头，以小写字母或数字结尾。'."\n" - .'- 由小写字母、数字或下划线（_）组成。'."\n" - .'- 长度为2~16个字符。'."\n" - .'- 不能使用预留的用户名，如root、admin和opsadmin。', - 'type' => 'string', - 'required' => true, - 'example' => 'test_accout', - ], + 'schema' => ['title' => 'RegionId', 'description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'AccountPassword', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库账号密码。'."\n" - .'- 由大写字母、小写字母、数字、特殊字符中的任意三种组成。'."\n" - .'- 特殊符号包含：`!@#$%^&*()_+-=`'."\n" - .'- 密码长度为8~32个字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'Test_accout1', - ], + 'schema' => ['title' => '实例ID', 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1r053byu48p****'], ], [ - 'name' => 'AccountDescription', + 'name' => 'Schema', 'in' => 'query', - 'schema' => [ - 'description' => '账号描述。'."\n" - .'- 不能以`http://`或者`https://`开头。'."\n" - .'- 长度不超过256个字符。', - 'type' => 'string', - 'required' => false, - 'example' => '数据库连接测试账号', - ], + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => false, 'example' => 'adb_demo', 'default' => 'INFORMATION_SCHEMA'], ], [ - 'name' => 'AccountType', - 'in' => 'query', - 'schema' => [ - 'description' => '账号类型。取值说明：'."\n" - .'- **Normal**：普通账号。'."\n" - .'- **Super**：高权限账号。', - 'type' => 'string', - 'required' => true, - 'example' => 'Normal', - 'enum' => [ - 'Super', - 'Normal', - ], - ], - ], - [ - 'name' => 'Engine', + 'name' => 'TableName', 'in' => 'query', - 'schema' => [ - 'description' => '数据库引擎，取值：'."\n" - ."\n" - .'- **AnalyticDB**（默认）：AnalyticDB MySQL引擎。'."\n" - .'- **Clickhouse**：宽表引擎。', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [], - 'example' => 'Clickhouse', - ], - ], - [ - 'name' => 'RamUserList', - 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'type' => 'array', - 'items' => [ - 'type' => 'string', - 'required' => false, - ], - 'required' => false, - ], + 'schema' => ['description' => '表名称。', 'type' => 'string', 'required' => false, 'example' => 'test', 'default' => 'COLUMNS'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A9F013CD-0222-595E-8157-445969B97F03'], + 'Success' => ['description' => '调用是否成功。'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Schema' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'adb_demo'], + 'TableName' => ['description' => "\n" + .'表名。', 'type' => 'string', 'example' => 'test'], + 'ColumnCount' => ['description' => '总列数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'Columns' => [ + 'description' => '列信息。', + 'type' => 'array', + 'items' => [ + 'description' => '列信息。', + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => '列的数据类型。', 'type' => 'string', 'example' => 'bigint'], + 'Name' => ['description' => '列名。', 'type' => 'string', 'example' => 'id'], + 'Comment' => ['description' => '列注释。', 'type' => 'string', 'example' => 'test'], + ], + ], ], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidAccountName.Malformed', - 'errorMessage' => 'The specified parameter AccountName is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'InvalidAccountPassword.Malformed', - 'errorMessage' => 'The specified parameter AccountPassword is not valid.', - ], - [ - 'errorCode' => 'InvalidAccountDescription.Malformed', - 'errorMessage' => 'The specified parameter AccountDescription is not valid.', - ], - [ - 'errorCode' => 'InvalidAccountType.Malformed', - 'errorMessage' => 'The specified parameter AccountType is not valid.', - ], - [ - 'errorCode' => 'ACS.Sql.CannotConnect', - 'errorMessage' => 'Cannot connect instance which type is %s.', + 'title' => '查询表的列信息', + 'summary' => '查询集群指定表的列信息。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2023-11-02T03:45:47.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAdbMySqlColumns'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAdbMySqlColumns', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","errorExample":""},{"type":"xml","example":"<CreateAccountResponse>\\n <RequestId>2FED790E-FB61-4721-8C1C-07C627FA5A19</RequestId>\\n</CreateAccountResponse>","errorExample":""}]', - 'title' => '创建数据库账号', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"A9F013CD-0222-595E-8157-445969B97F03\\",\\n \\"Success\\": true,\\n \\"Schema\\": \\"adb_demo\\",\\n \\"TableName\\": \\"test\\",\\n \\"ColumnCount\\": 1,\\n \\"Columns\\": [\\n {\\n \\"Type\\": \\"bigint\\",\\n \\"Name\\": \\"id\\",\\n \\"Comment\\": \\"test\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeAdbMySqlColumnsResponse>\\n <Message>Success</Message>\\n <RequestId>A9F013CD-0222-595E-8157-445969B97F03</RequestId>\\n <Success>true</Success>\\n <Schema>adb_demo</Schema>\\n <TableName>test</TableName>\\n <ColumnCount>1</ColumnCount>\\n <Columns>\\n <Type>bigint</Type>\\n <Name>id</Name>\\n <Comment>test</Comment>\\n </Columns>\\n</DescribeAdbMySqlColumnsResponse>","errorExample":""}]', ], - 'DeleteAccount' => [ - 'summary' => '删除集群的数据库账号。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeAdbMySqlIndexes' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '130690', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['title' => 'RegionId', 'description' => '地域ID。'."\n" + .'> 您可以调用 [DescribeRegions](~~612393~~) 接口查看集群的地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], + ], + [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'schema' => ['title' => '实例ID', 'description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看数仓版集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-uf6wjk5xxxxxxxxxx'], ], [ - 'name' => 'AccountName', + 'name' => 'Schema', 'in' => 'query', - 'schema' => [ - 'description' => '数据库账号名称。'."\n" - .'> 您可以调用[DescribeAccounts](~~612430~~)接口查看指定集群的数据库账号信息，包括账号名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test_accout', - ], + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => false, 'example' => 'tpch_oss', 'default' => 'INFORMATION_SCHEMA'], ], [ - 'name' => 'Engine', + 'name' => 'TableName', 'in' => 'query', - 'schema' => [ - 'description' => '数据库引擎，取值：'."\n" - ."\n" - .'- **AnalyticDB**（默认）：AnalyticDB MySQL引擎。'."\n" - .'- **Clickhouse**：宽表引擎。', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [], - 'example' => 'Clickhouse', - ], + 'schema' => ['description' => '目标表名。'."\n" + .'> 若该参数留空，则会返回当前日期内目标集群下所有表的使用频次数据。', 'type' => 'string', 'required' => false, 'example' => 'orders', 'default' => 'COLUMNS'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', + 'Message' => ['description' => '调用结果的信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常信息。', 'type' => 'string', 'example' => 'Success'], + 'RequestId' => ['description' => '请求ID，阿里云为该请求生成的标识符。', 'type' => 'string', 'example' => 'F0983B43-B2EC-536A-8791-142B5CF1E9B6'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Schema' => ['description' => '数据库名。 '."\n" + ."\n" + .'> <br>如填写，后续迁移或同步操作，只会针对该数据库操作。', 'type' => 'string', 'example' => 'adb_demo'], + 'TableName' => ['description' => '表名称。', 'type' => 'string', 'example' => 'test'], + 'IndexCount' => ['description' => '索引个数（索引缺失表目前所拥有的索引个数）筛选条件。输入格式为`运算符+分割服“”+索引个数`，例如`>=100`。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'Indexes' => [ + 'description' => '索引列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => '索引类型。', 'type' => 'string', 'example' => 'normal'], + 'Name' => ['description' => '索引名。', 'type' => 'string', 'example' => 'ttl'], + 'Column' => ['description' => '列名称。', 'type' => 'string', 'example' => 'preclcu'], + ], + 'description' => '', + ], ], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidAccountName.Malformed', - 'errorMessage' => 'The specified parameter AccountName is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查看表索引信息', + 'summary' => '用于查看表索引信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAdbMySqlIndexes'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeAdbMySqlIndexes', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\"\\n}","errorExample":""},{"type":"xml","example":"<DeleteAccountResponse>\\n <RequestId>2FED790E-FB61-4721-8C1C-07C627FA5A19</RequestId>\\n</DeleteAccountResponse>","errorExample":""}]', - 'title' => '删除数据库账号', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"F0983B43-B2EC-536A-8791-142B5CF1E9B6\\",\\n \\"Success\\": true,\\n \\"Schema\\": \\"adb_demo\\",\\n \\"TableName\\": \\"test\\",\\n \\"IndexCount\\": 10,\\n \\"Indexes\\": [\\n {\\n \\"Type\\": \\"normal\\",\\n \\"Name\\": \\"ttl\\",\\n \\"Column\\": \\"preclcu\\"\\n }\\n ]\\n}","type":"json"}]', ], - 'ModifyAccountDescription' => [ - 'summary' => '修改目标集群的数据库账号的备注信息。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeAdbMySqlSchemas' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -10996,316 +7170,174 @@ ], 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '130693', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], - ], - [ - 'name' => 'AccountName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库账号。'."\n" - .'> 您可以调用[DescribeAccounts](~~612430~~)接口查看指定集群的数据库账号信息，包括数据库账号。', - 'type' => 'string', - 'required' => true, - 'example' => 'testacc', - ], - ], - [ - 'name' => 'AccountDescription', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '账号描述。'."\n" - .'- 不能以`http://`、`https:// `开头。'."\n" - .'- 长度为2~256个字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'AccDesc', - ], + 'schema' => ['title' => 'RegionId', 'description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'Engine', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库引擎，取值：'."\n" - ."\n" - .'- **AnalyticDB**（默认）：AnalyticDB MySQL引擎。'."\n" - .'- **Clickhouse**：宽表引擎。', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [], - 'example' => 'Clickhouse', - ], + 'schema' => ['title' => '实例ID', 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1r053byu48p****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Schemas' => [ + 'description' => '数据库列表。', + 'type' => 'array', + 'items' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'adb_demo,adb_test,mysql'], ], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidAccountDescription.Malformed', - 'errorMessage' => 'The specified parameter AccountDescription is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'ACS.InvalidParameter.%s', - 'errorMessage' => 'Parameter %s is invalid.', + 'title' => '查询所有数据库列表', + 'summary' => '枚举指定集群下所有数据库列表。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAdbMySqlSchemas'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAdbMySqlSchemas', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyAccountDescriptionResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n</ModifyAccountDescriptionResponse>","errorExample":""}]', - 'title' => '修改数据库账号的备注信息', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"Schemas\\": [\\n \\"adb_demo,adb_test,mysql\\"\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeAdbMySqlSchemasResponse>\\n <Message>Success</Message>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Success>true</Success>\\n <Schemas>adb_demo,adb_test,mysql</Schemas>\\n</DescribeAdbMySqlSchemasResponse>","errorExample":""}]', ], - 'ResetAccountPassword' => [ - 'summary' => '重置指定集群的数据库账号密码。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeAdbMySqlTableMeta' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '130691', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'schema' => ['title' => 'RegionId', 'description' => '地域ID。'."\n" + ."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'AccountName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库账号。'."\n" - .'> 您可以调用[DescribeAccounts](~~612430~~)接口查看指定集群的数据库账号信息，包括数据库账号。', - 'type' => 'string', - 'required' => true, - 'example' => 'test_accout', - ], - ], - [ - 'name' => 'AccountPassword', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库账号密码。'."\n" - .'- 由大写字母、小写字母、数字、特殊字符中的任意三种组成。'."\n" - .'- 特殊符号包含：`!@#$%^&*()_+-=`'."\n" - .'- 密码长度为8~32个字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'Test_accout1', - ], + 'schema' => ['title' => '实例ID', 'description' => 'AnalyticDB MySQL湖仓版集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp11q28kvl688****'], ], [ - 'name' => 'AccountDescription', + 'name' => 'Schema', 'in' => 'query', - 'schema' => [ - 'description' => '账号描述。'."\n" - .'- 不能以`http://`和`https://` 开头。'."\n" - .'- 长度为2~256个字符。', - 'type' => 'string', - 'required' => false, - 'example' => 'AccDesc', - ], + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => true, 'example' => 'adb_demo'], ], [ - 'name' => 'Engine', + 'name' => 'TableName', 'in' => 'query', - 'schema' => [ - 'description' => '数据库引擎，取值：'."\n" - ."\n" - .'- **AnalyticDB**（默认）：AnalyticDB MySQL引擎。'."\n" - .'- **Clickhouse**：宽表引擎。', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [], - 'example' => 'Clickhouse', - ], + 'schema' => ['description' => '目标表名。'."\n" + .'> 若该参数留空，则会返回当前日期内目标集群下所有表的使用频次数据。', 'type' => 'string', 'required' => true, 'example' => 'test'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'TableMeta' => [ + 'description' => '表元数据信息', + 'type' => 'object', + 'properties' => [ + 'TableSchema' => ['description' => '表所属的数据库。', 'type' => 'string', 'example' => 'tpch'], + 'TableName' => ['description' => '目标表名。'."\n" + .'> 若该参数留空，则会返回当前日期内目标集群下所有表的使用频次数据。', 'type' => 'string', 'example' => 'external_supplier'], + 'TableType' => ['description' => '表类型。', 'type' => 'string', 'example' => 'fact_table'], + 'DistributeType' => ['description' => '分布类型。', 'type' => 'string', 'example' => 'hash'], + 'DistributeColumn' => ['description' => '分布键列。', 'type' => 'string', 'example' => 'customer_id'], + 'PartitionType' => ['description' => '分区类型。', 'type' => 'string', 'example' => 'value'], + 'PartitionColumn' => ['description' => '分区列信息。', 'type' => 'string', 'example' => 'DATE_FORMAT(login_time, \'%Y%m%d\')'], + 'PrimaryKeyColumn' => ['description' => '主键列。', 'type' => 'string', 'example' => 'login_time,customer_id,phone_num'], + 'TableEngine' => ['description' => '表引擎。', 'type' => 'string', 'example' => 'XUANWU'], + 'IsDictEncode' => ['description' => '是否字典编码。', 'type' => 'boolean', 'example' => 'true'], + 'IsHidden' => ['description' => '表示页面是否隐藏。'."\n" + .'- **false**：否。'."\n" + .'- **true**：是。', 'type' => 'boolean', 'example' => 'true'], + 'IsAllIndex' => ['description' => '是否是全索引。', 'type' => 'boolean', 'example' => 'false'], + 'IsFullTextDict' => ['description' => '是否全文索引。', 'type' => 'boolean', 'example' => 'true'], + 'CreateTime' => ['description' => '创建时间。', 'type' => 'string', 'example' => '2025-03-14 02:18:08.0'], + 'UpdateTime' => ['description' => '更新时间。', 'type' => 'string', 'example' => '2024-07-25 02:07:23.0'], + ], ], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidAccountPassword.Malformed', - 'errorMessage' => 'The specified parameter AccountPassword is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'ACS.Sql.CannotConnect', - 'errorMessage' => 'Cannot connect instance which type is %s.', - ], - ], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","errorExample":""},{"type":"xml","example":"<ResetAccountPasswordResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n</ResetAccountPasswordResponse>","errorExample":""}]', - 'title' => '重置数据库账号的密码', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'CheckBindRamUser' => [ - 'summary' => '检查当前调用接口的RAM用户，是否已绑定集群数据库账号。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查看表元数据信息', + 'summary' => '用于查看表元数据信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAdbMySqlTableMeta'], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], + 'ramActions' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查询集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-wz9842849v6****', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '响应模式。', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '2FB9DCA3-DA56-5B43-A9A0-68E3D0E6AA84', - ], - 'Result' => [ - 'description' => '任务返回结果。取值说明：'."\n" - .'- **true**：当前RAM用户已绑定数据库账号。'."\n" - .'- **false**：当前RAM用户未绑定数据库账号。', - 'type' => 'boolean', - 'example' => 'true', - ], + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeAdbMySqlTableMeta', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2FB9DCA3-DA56-5B43-A9A0-68E3D0E6AA84\\",\\n \\"Result\\": true\\n}","errorExample":""},{"type":"xml","example":"<CheckBindRamUserResponse>\\n <RequestId>2FB9DCA3-DA56-5B43-A9A0-68E3D0E6AA84</RequestId>\\n <Result>true</Result>\\n</CheckBindRamUserResponse>","errorExample":""}]', - 'title' => '查询当前RAM用户是否绑定数据库账号', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\",\\n \\"Success\\": true,\\n \\"TableMeta\\": {\\n \\"TableSchema\\": \\"tpch\\",\\n \\"TableName\\": \\"external_supplier\\",\\n \\"TableType\\": \\"fact_table\\",\\n \\"DistributeType\\": \\"hash\\",\\n \\"DistributeColumn\\": \\"customer_id\\",\\n \\"PartitionType\\": \\"value\\",\\n \\"PartitionColumn\\": \\"DATE_FORMAT(login_time, \'%Y%m%d\')\\",\\n \\"PrimaryKeyColumn\\": \\"login_time,customer_id,phone_num\\",\\n \\"TableEngine\\": \\"XUANWU\\",\\n \\"IsDictEncode\\": true,\\n \\"IsHidden\\": true,\\n \\"IsAllIndex\\": false,\\n \\"IsFullTextDict\\": true,\\n \\"CreateTime\\": \\"2025-03-14 02:18:08.0\\",\\n \\"UpdateTime\\": \\"2024-07-25 02:07:23.0\\"\\n }\\n}","type":"json"}]', ], - 'BindAccount' => [ - 'summary' => '绑定RAM用户与集群的数据库普通账号。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeAdbMySqlTables' => [ + 'summary' => '枚举集群指定数据库下所有表信息。', + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -11313,319 +7345,267 @@ ], 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz99d9nh532****', - ], - ], - [ - 'name' => 'RamUser', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'RAM用户的账号ID。', - 'type' => 'string', - 'required' => false, - 'example' => '1444832459****', - ], + 'schema' => ['title' => 'RegionId', 'description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'AccountName', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库普通账号。', - 'type' => 'string', - 'required' => true, - 'example' => 'test_accout', - ], + 'schema' => ['title' => '实例ID', 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'RamUserList', + 'name' => 'Schema', 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'type' => 'array', - 'items' => [ - 'type' => 'string', - 'required' => false, - ], - 'required' => false, - ], + 'allowEmptyValue' => false, + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => false, 'example' => 'adb_demo', 'default' => 'INFORMATION_SCHEMA'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'DFF27323-3868-5F8A-917D-5D1D06B6BC0D', + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '7A7D49E3-5585-5DF8-B62C-75C46B4991DC'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Schema' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'adb_demo'], + 'Tables' => [ + 'description' => '表信息。', + 'type' => 'array', + 'items' => ['description' => '表名称。', 'type' => 'string', 'example' => 'test'], ], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidAccountName.Malformed', - 'errorMessage' => 'The specified parameter AccountName is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'ACS.Account.NotExist', - 'errorMessage' => 'The account is not found.', - ], - [ - 'errorCode' => 'ACS.Account.UserHasBind', - 'errorMessage' => 'The user has been associated with another database account %s.', - ], - [ - 'errorCode' => 'ACS.User.DatabaseAccountHasBind', - 'errorMessage' => 'The database account has been bound to %s.', - ], - [ - 'errorCode' => 'ACS.InvalidParameter.%s', - 'errorMessage' => 'Parameter %s is invalid.', + 'title' => '查询数据库下所有表信息', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2023-11-02T03:45:47.000Z', 'description' => '请求参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAdbMySqlTables'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAdbMySqlTables', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DFF27323-3868-5F8A-917D-5D1D06B6BC0D\\"\\n}","errorExample":""},{"type":"xml","example":"<BindAccountResponse>\\n <RequestId>DFF27323-3868-5F8A-917D-5D1D06B6BC0D</RequestId>\\n</BindAccountResponse>","errorExample":""}]', - 'title' => '绑定RAM用户与数据库账号', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"7A7D49E3-5585-5DF8-B62C-75C46B4991DC\\",\\n \\"Success\\": true,\\n \\"Schema\\": \\"adb_demo\\",\\n \\"Tables\\": [\\n \\"test\\"\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeAdbMySqlTablesResponse>\\n <Message>Success</Message>\\n <RequestId>7A7D49E3-5585-5DF8-B62C-75C46B4991DC</RequestId>\\n <Success>true</Success>\\n <Schema>adb_demo</Schema>\\n <Tables>test</Tables>\\n</DescribeAdbMySqlTablesResponse>","errorExample":""}]', ], - 'UnbindAccount' => [ - 'summary' => '解绑RAM用户与集群的数据库普通账号。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeAdviceServiceEnabled' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz99d9nh5****', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-2ze0vp0j6t3to****'], ], [ - 'name' => 'AccountName', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库账号。'."\n" - .'> 您可以调用[DescribeAccounts](~~612430~~)接口查看指定集群的数据库账号信息，包括数据库账号。', - 'type' => 'string', - 'required' => true, - 'example' => 'test_accout', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '93E85E5C-C805-5837-8713-05B69A504EE5', - ], + 'Message' => ['title' => 'Message', 'description' => '调用结果的信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常信息。', 'type' => 'string', 'example' => 'Success'], + 'RequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => 'E031AABF-BD56-5966-A063-4283EF18DB45'], + 'Result' => ['title' => 'Advice Service Enabled', 'description' => '建议服务是否开启。取值说明：'."\n" + .'- 开启，返回**True**。 '."\n" + .'- 关闭，返回**False**。', 'type' => 'boolean', 'example' => 'False'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidAccountName.Malformed', - 'errorMessage' => 'The specified parameter AccountName is not valid.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询建议服务是否开启', + 'summary' => '查询建议服务是否开启。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAdviceServiceEnabled'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeAdviceServiceEnabled', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"93E85E5C-C805-5837-8713-05B69A504EE5\\"\\n}","errorExample":""},{"type":"xml","example":"<UnbindAccountResponse>\\n <RequestId>93E85E5C-C805-5837-8713-05B69A504EE5</RequestId>\\n</UnbindAccountResponse>","errorExample":""}]', - 'title' => '解绑RAM用户与数据库账号', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"E031AABF-BD56-5966-A063-4283EF18DB45\\",\\n \\"Result\\": true\\n}","type":"json"}]', ], - 'ModifyAccountPrivileges' => [ - 'summary' => '修改某一数据库账户的权限。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeAllDataSource' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '159109', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '190495', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1k5p066e1a****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1pke2pcfavw****'], ], [ - 'name' => 'AccountName', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '数据库账号名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'account1', - ], + 'schema' => ['description' => '数据库名称。'."\n" + .' '."\n", 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], ], [ - 'name' => 'AccountPrivileges', + 'name' => 'TableName', 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'description' => '授予的权限列表。', - 'type' => 'array', - 'items' => [ - 'description' => '权限详情。', - 'type' => 'object', - 'properties' => [ - 'PrivilegeObject' => [ - 'description' => '权限对象，为库表列的三元组。', - 'type' => 'object', - 'properties' => [ - 'Database' => [ - 'description' => '授权的数据库，当为库、表和列权限级别时此参数必传。', - 'type' => 'string', - 'required' => false, - 'example' => 'tsdb1', - ], - 'Table' => [ - 'description' => '授权的表，当为表和列权限级别时此参数必传。', - 'type' => 'string', - 'required' => false, - 'example' => 'table1', - ], - 'Column' => [ - 'description' => '授权的列，当为列权限级别时此参数必传。', - 'type' => 'string', - 'required' => false, - 'example' => 'column1', - ], - ], - 'required' => false, - ], - 'Privileges' => [ - 'description' => '授予的权限列表。', - 'type' => 'array', - 'items' => [ - 'description' => '权限，来自接口`DescribeEnabledPrivileges`。', - 'type' => 'string', - 'required' => false, - 'example' => 'select', - ], - 'required' => false, - ], - 'PrivilegeType' => [ - 'description' => '权限级别，来自接口`DescribeEnabledPrivileges`。', - 'type' => 'string', - 'required' => false, - 'example' => 'Global', - ], - ], - 'required' => false, - ], - 'required' => true, - ], + 'schema' => ['description' => '表名。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID', - 'type' => 'string', - 'example' => '9DD88DE7-824F-1082-AA57-575AFC6517A8', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'C7EDB8E4-9769-4233-88C7-DCA4C9******'], + 'Tables' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Table' => [ + 'description' => '表列表。', + 'type' => 'array', + 'items' => [ + 'description' => '表信息。', + 'type' => 'object', + 'properties' => [ + 'TableName' => ['description' => '逻辑表名。', 'type' => 'string', 'example' => 'test'], + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-bp1pke2pcfavw****'], + 'SchemaName' => ['description' => '数据库名称。'."\n" + .' '."\n", 'type' => 'string', 'example' => 'adb_demo'], + ], + ], + ], + ], + 'description' => '', + ], + 'Columns' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Column' => [ + 'description' => '列列表。', + 'type' => 'array', + 'items' => [ + 'description' => '列信息。', + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => '列的数据类型。', 'type' => 'string', 'example' => 'bigint'], + 'ColumnName' => ['description' => '列名。', 'type' => 'string', 'example' => 'id'], + 'TableName' => ['description' => '逻辑表名。', 'type' => 'string', 'example' => 'test'], + 'AutoIncrementColumn' => ['description' => '列是否自增，取值说明：'."\n" + .'- **true**：自增。'."\n" + .'- **false**：不自增。', 'type' => 'boolean', 'example' => 'true'], + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-bp1pke2pcfavw****'], + 'PrimaryKey' => ['description' => '列是否为主键，取值说明：'."\n" + .'- **true**：主键。'."\n" + .'- **false**：非主键。', 'type' => 'boolean', 'example' => 'false'], + 'SchemaName' => ['description' => '逻辑库名。', 'type' => 'string', 'example' => 'adb_demo'], + ], + ], + ], + ], + 'description' => '', + ], + 'Schemas' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Schema' => [ + 'description' => '数据库列表。', + 'type' => 'array', + 'items' => [ + 'description' => '数据库信息。', + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-bp1pke2pcfavw****'], + 'SchemaName' => ['description' => '逻辑库名。', 'type' => 'string', 'example' => 'adb_demo'], + ], + ], + ], + ], + 'description' => '', ], ], ], @@ -11633,319 +7613,320 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ACS.Privilege.ModifyFailed', - 'errorMessage' => 'Failed to modify the account privilege. Make sure that bound account have sufficient database privileges.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'ACS.Parameter.Malformed', - 'errorMessage' => 'The following required parameters are not specified: %s', - ], - [ - 'errorCode' => 'ACS.InvalidParameter.%s', - 'errorMessage' => 'Parameter %s is invalid.', - ], - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'ACS.User.NotBindDatabaseAccount', - 'errorMessage' => 'The user has not been associated with a database account.', - ], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9DD88DE7-824F-1082-AA57-575AFC6517A8\\"\\n}","type":"json"}]', - 'title' => ' 修改数据库账户的权限', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeAccountPrivileges' => [ - 'summary' => '获取给定数据库账号在某个级别拥有的权限。', - 'methods' => [ - 'post', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '枚举数据库列表', + 'summary' => '枚举实例下所有数据库列表、表列表和列列表。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2025-05-07T05:42:07.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-08-25T03:37:06.000Z', 'description' => '请求参数发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAllDataSource'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:describeAllDataSource', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C7EDB8E4-9769-4233-88C7-DCA4C9******\\",\\n \\"Tables\\": {\\n \\"Table\\": [\\n {\\n \\"TableName\\": \\"test\\",\\n \\"DBClusterId\\": \\"amv-bp1pke2pcfavw****\\",\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ]\\n },\\n \\"Columns\\": {\\n \\"Column\\": [\\n {\\n \\"Type\\": \\"bigint\\",\\n \\"ColumnName\\": \\"id\\",\\n \\"TableName\\": \\"test\\",\\n \\"AutoIncrementColumn\\": true,\\n \\"DBClusterId\\": \\"amv-bp1pke2pcfavw****\\",\\n \\"PrimaryKey\\": false,\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ]\\n },\\n \\"Schemas\\": {\\n \\"Schema\\": [\\n {\\n \\"DBClusterId\\": \\"amv-bp1pke2pcfavw****\\",\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeAppliedAdvices' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', - 'abilityTreeCode' => '159083', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '193678', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-uf6g8w25jacm7****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1k5p066e1a****', - ], + 'schema' => ['title' => 'RegionId', 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'AccountName', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '要查看权限的数据库账号名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'account1', - ], + 'schema' => ['title' => 'StartTime', 'description' => '查询建议的开始日期，格式为 yyyyMMdd。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '20220811'], ], [ - 'name' => 'PrivilegeType', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => '要查看的权限级别，来自接口`DescribeEnabledPrivileges`。', - 'type' => 'string', - 'required' => false, - 'example' => 'Global', - 'default' => 'Database', - ], + 'schema' => ['title' => 'EndTime', 'description' => '查询建议的结束日期，格式为 yyyyMMdd。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '20220824'], ], [ - 'name' => 'DatabasePrivilegeObject', + 'name' => 'Lang', 'in' => 'query', - 'schema' => [ - 'description' => '根据数据库名称进行筛选。只有当权限级别为库、表、列时才可用。', - 'type' => 'string', - 'required' => false, - 'example' => 'db1', - ], + 'schema' => ['title' => 'Lang', 'description' => '设置建议的显示语言，取值说明：'."\n" + .'- **zh**：简体中文（默认语言）。'."\n" + .'- **en**：英文。'."\n" + .'- **ja**：日文。'."\n" + .'- **zh-tw**：繁体中文。', 'type' => 'string', 'required' => false, 'example' => 'zh'], ], [ - 'name' => 'TablePrivilegeObject', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '根据表名称进行筛选。可以和库名称一起进行联合筛选，只有当权限级别是表和列时该参数才可用。', - 'type' => 'string', - 'required' => false, - 'example' => 'table1', - ], + 'schema' => ['title' => 'PageSize', 'description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '30'], ], [ 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '页号，从1开始，默认值1。', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['title' => 'PageNumber', 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], ], [ - 'name' => 'PageSize', + 'name' => 'AdviceType', 'in' => 'query', - 'schema' => [ - 'description' => '每页含有的条目数量，默认每页20条。', - 'type' => 'string', - 'required' => false, - 'example' => '10', - ], + 'schema' => ['description' => '建议的类型，取值说明：'."\n" + .'- **INDEX**：索引优化。'."\n" + .'- **TIERING**：冷热数据优化。', 'type' => 'string', 'required' => false, 'example' => 'INDEX'], ], [ - 'name' => 'ColumnPrivilegeObject', + 'name' => 'Keyword', 'in' => 'query', - 'schema' => [ - 'description' => '根据列名称进行筛选，只有当权限级别是列时该参数才可用。', - 'type' => 'string', - 'required' => false, - 'example' => 'col1', - ], + 'schema' => ['description' => '查询关键字，支持根据表名模糊搜索。', 'type' => 'string', 'required' => false, 'example' => 'you_table_name'], + ], + [ + 'name' => 'SchemaTableName', + 'in' => 'query', + 'schema' => ['description' => '数据库名和表名。格式为**数据库.表**。', 'type' => 'string', 'required' => false, 'example' => 'tpch.lineitem'], + ], + [ + 'name' => 'Order', + 'in' => 'query', + 'schema' => ['description' => '将查询结果按指定字段进行排序。格式为JSON字符串，例如`[{"Field":"SchemaName","Type":"Asc"}]`。其中：'."\n" + .'- `Field`表示排序字段。支持如下取值：'."\n" + .' - `SchemaName`：数据库名。'."\n" + .' - `TableName`：表名。'."\n" + .' - `JobStatus`：表Build任务状态。'."\n" + .' - `SubmitTime`：建议下发的时间。'."\n" + .' - `Benefit`：预期优化收益。'."\n" + .'- `Type`表示排序方式。支持如下取值：'."\n" + .' - `Asc`：升序排序。'."\n" + .' - `Desc`： 降序排序。'."\n" + ."\n" + .'> 若不设置参数，默认按照优化建议下发的时间降序排列。', 'type' => 'string', 'required' => false, 'example' => '[{\\"Field\\":\\"AdviceType\\",\\"Type\\":\\"Desc\\"}]'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结果。', + 'description' => '返回对象。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'DA32480A-E3E5-1BE7-BA98-724551DC04C8', - ], - 'Data' => [ - 'description' => '权限详情列表。', + 'Items' => [ + 'title' => 'Items', + 'description' => '详情。', 'type' => 'array', 'items' => [ - 'description' => '权限详情。', + 'description' => '建议列表。', 'type' => 'object', 'properties' => [ - 'PrivilegeType' => [ - 'description' => '权限级别，可以是全局`Global`、库`Databae`、表`Table`和列`Column`，来自接口`DescribeEnabledPrivileges`。', - 'type' => 'string', - 'example' => 'Column', - ], - 'PrivilegeObject' => [ - 'description' => '权限对象，为库表列的三元组，以及额外的描述信息。', - 'type' => 'object', - 'properties' => [ - 'Database' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'db1', - ], - 'Table' => [ - 'description' => '表名称。', - 'type' => 'string', - 'example' => 'tabl1', - ], - 'Column' => [ - 'description' => '列名称。', - 'type' => 'string', - 'example' => 'column1', - ], - 'Description' => [ - 'description' => '描述信息。', - 'type' => 'string', - 'example' => 'a test column', - ], - ], - ], - 'Privileges' => [ - 'description' => '权限列表。', - 'type' => 'array', - 'items' => [ - 'description' => '权限名，来自接口`DescribeEnabledPrivileges`。', - 'type' => 'string', - 'example' => 'insert,select', - ], - ], + 'AdviceId' => ['title' => 'AdviceId', 'description' => '建议ID。', 'type' => 'string', 'example' => '7417db9c-914d-43f3-a123-4d0e448f****'], + 'SubmitTime' => ['title' => 'SubmitTime', 'description' => '建议下发的时间，格式：yyMMddHHmm（UTC时间）。', 'type' => 'string', 'example' => '2208131600'], + 'SubmitStatus' => ['title' => 'SubmitStatus', 'description' => '建议的下发状态。'."\n" + .'取值说明：'."\n" + .'- **SUCCEED**：成功。'."\n" + .'- **FAILED**：失败。', 'type' => 'string', 'example' => 'SUCCEED'], + 'SQL' => ['title' => 'SQL', 'description' => '应用建议的SQL语句。', 'type' => 'string', 'example' => 'alter table `schema1`.`table1` drop key col1_1_idx'], + 'RollbackSQL' => ['title' => 'RollbackSQL', 'description' => '回滚建议的SQL语句。', 'type' => 'string', 'example' => 'alter table `schema1`.`table1` add key col1_1_idx(col1)'], + 'JobStatus' => ['title' => 'JobStatus', 'description' => '执行建议的任务的状态。'."\n" + .'取值说明：'."\n" + .'- **SUCCEED**：成功。'."\n" + .'- **FAILED**：失败。', 'type' => 'string', 'example' => 'SUCCEED'], + 'Benefit' => ['title' => 'Benefit', 'description' => '建议的收益。', 'type' => 'string', 'example' => '节省0.4 GB的存储空间'], + 'BuildSQL' => ['title' => 'Benefit', 'description' => '执行Build任务的SQL语句。', 'type' => 'string', 'example' => 'build table `schema1`.`table1`'], + 'TotalCount' => ['title' => 'TotalCount', 'description' => '返回的结果总数，取值为：大于等于0且不超过Integer数据类型的最大值，默认值为0。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['title' => 'PageSize', 'description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'PageNumber' => ['title' => 'PageNumber', 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'SchemaName' => ['description' => '数据库名。', 'type' => 'string', 'example' => 'adb_demo'], + 'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'test'], + 'IndexFields' => ['description' => '索引字段。', 'type' => 'string', 'example' => 'message'], ], ], ], - 'TotalCount' => [ - 'description' => '用户在该权限级别拥有的权限总数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'PageNumber' => [ - 'description' => '页号，和入参的页号一致。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '页大小，和入参的页大小一致。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', + 'PageNumber' => ['description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '84489769-3065-5A28-A4CB-977CD426F1C3'], + 'TotalCount' => ['description' => '返回的结果总数，取值为：大于等于0且不超过Integer数据类型的最大值，默认值为0。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'SchemaTableNames' => [ + 'description' => '数据库名和表名的字符串拼接。', + 'type' => 'array', + 'items' => ['description' => '数据库名和表名的字符串拼接。', 'type' => 'string', 'example' => '['."\n" + .' "tpch.lineitem",'."\n" + .' "tpch.partsupp",'."\n" + .' "tpch.orders"'."\n" + .']'], ], ], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ACS.Account.NotExist', - 'errorMessage' => 'The account is not found.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'ACS.InvalidParameter.%s', - 'errorMessage' => 'Parameter %s is invalid.', - ], - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'ACS.User.NotBindDatabaseAccount', - 'errorMessage' => 'The user has not been associated with a database account.', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '显示已采纳的优化', + 'summary' => '显示已采纳的优化建议。', + 'changeSet' => [ + ['createdAt' => '2025-07-09T06:38:11.000Z', 'description' => '响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAppliedAdvices'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeAppliedAdvices', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA32480A-E3E5-1BE7-BA98-724551DC04C8\\",\\n \\"Data\\": [\\n {\\n \\"PrivilegeType\\": \\"Column\\",\\n \\"PrivilegeObject\\": {\\n \\"Database\\": \\"db1\\",\\n \\"Table\\": \\"tabl1\\",\\n \\"Column\\": \\"column1\\",\\n \\"Description\\": \\"a test column\\"\\n },\\n \\"Privileges\\": [\\n \\"insert,select\\"\\n ]\\n }\\n ],\\n \\"TotalCount\\": 100,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 20\\n}","errorExample":""},{"type":"xml","example":"<DescribeAccountPrivilegesResponse>\\n <RequestId>DA32480A-E3E5-1BE7-BA98-724551DC04C8</RequestId>\\n <Data>\\n <PrivilegeType>Column</PrivilegeType>\\n <PrivilegeObject>\\n <Database>db1</Database>\\n <Table>tabl1</Table>\\n <Column>column1</Column>\\n <Description>a test column</Description>\\n </PrivilegeObject>\\n <Privileges>insert,select</Privileges>\\n </Data>\\n <TotalCount>100</TotalCount>\\n <PageNumber>1</PageNumber>\\n <PageSize>20</PageSize>\\n</DescribeAccountPrivilegesResponse>","errorExample":""}]', - 'title' => '查询数据库账号的权限', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~).', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Items\\": [\\n {\\n \\"AdviceId\\": \\"7417db9c-914d-43f3-a123-4d0e448f****\\",\\n \\"SubmitTime\\": \\"2208131600\\",\\n \\"SubmitStatus\\": \\"SUCCEED\\",\\n \\"SQL\\": \\"alter table `schema1`.`table1` drop key col1_1_idx\\",\\n \\"RollbackSQL\\": \\"alter table `schema1`.`table1` add key col1_1_idx(col1)\\",\\n \\"JobStatus\\": \\"SUCCEED\\",\\n \\"Benefit\\": \\"节省0.4 GB的存储空间\\",\\n \\"BuildSQL\\": \\"build table `schema1`.`table1`\\",\\n \\"TotalCount\\": 1,\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"SchemaName\\": \\"adb_demo\\",\\n \\"TableName\\": \\"test\\",\\n \\"IndexFields\\": \\"message\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"84489769-3065-5A28-A4CB-977CD426F1C3\\",\\n \\"TotalCount\\": 1,\\n \\"SchemaTableNames\\": [\\n \\"[\\\\n \\\\\\"tpch.lineitem\\\\\\",\\\\n \\\\\\"tpch.partsupp\\\\\\",\\\\n \\\\\\"tpch.orders\\\\\\"\\\\n]\\"\\n ]\\n}","type":"json"}]', ], - 'DescribeEnabledPrivileges' => [ - 'summary' => '获取支持的权限级别和权限列表。', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeApsActionLogs' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', - 'abilityTreeCode' => '159129', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '154388', + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsY28JLD'], ], 'parameters' => [ [ + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1r053byu48p****'], + ], + [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。'."\n" + ."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看地域ID。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DBClusterId', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp14t95lun0w****', - ], + 'schema' => ['description' => '日志的开始时间，格式：**yyyy-MM-ddTHH:mmZ**（UTC时间）。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2023-02-11T08:30Z'], ], [ - 'name' => 'AccountName', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => '数据库账号名称。'."\n" - .'> 您可以调用[DescribeAccounts](~~612430~~)接口查看指定集群的数据库账号信息，包括账号名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_accout', - ], + 'schema' => ['description' => '日志的结束时间，格式：**yyyy-MM-ddTHH:mmZ**（UTC时间）。'."\n" + ."\n" + .'> 查询日志时，结束时间需大于开始时间，且与开始时间最大间隔不超过30天。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2023-02-11T09:30Z'], + ], + [ + 'name' => 'WorkloadId', + 'in' => 'query', + 'schema' => ['description' => '数据链路任务ID。', 'type' => 'string', 'required' => true, 'example' => 'aps-hz109vpvt4fg8528d****'], + ], + [ + 'name' => 'Keyword', + 'in' => 'query', + 'schema' => ['description' => '查询的关键字。在日志查询时模糊匹配。', 'type' => 'string', 'required' => false, 'example' => 'table_test'], + ], + [ + 'name' => 'Stage', + 'in' => 'query', + 'schema' => ['description' => '任务阶段。取值：'."\n" + ."\n" + .'- **StructureMigrate**：结构迁移。'."\n" + .'- **FullDataSync**：全量同步。'."\n" + .'- **IncrementalSync**：增量同步。'."\n" + ."\n" + .'> 未指定该参数时，默认查询所有的任务阶段。', 'type' => 'string', 'required' => false, 'example' => 'FullDataSync'], + ], + [ + 'name' => 'State', + 'in' => 'query', + 'schema' => ['description' => '日志类型。多个日志类型用英文逗号（,）分隔。取值：'."\n" + ."\n" + .'- **INFO**：信息。'."\n" + .'- **WARN**：警告。'."\n" + .'- **ERROR**：错误。'."\n" + ."\n" + .'> 未指定该参数时，默认查询所有的日志类型。', 'type' => 'string', 'required' => false, 'example' => 'INFO,WARN,ERROR'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页的记录数。取值：'."\n" + ."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '10', 'example' => '30', 'default' => '10'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码。取值为大于0且不超过Integer数据类型的正整数。默认值为1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1'], ], ], 'responses' => [ @@ -11953,214 +7934,212 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '246F42E0-A475-15FF-96D2-8DC47FC2F289', - ], - 'Data' => [ - 'description' => '支持的权限级别和权限列表。', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A5EDBA27-AF3E-5966-9503-FD1557E19167'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp1r053byu48p****'], + 'WorkloadId' => ['description' => '数据链路任务ID。', 'type' => 'string', 'example' => 'aps-hz109vpvt4fg8528d****'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '3'], + 'PageSize' => ['description' => '每页的记录数。', 'type' => 'string', 'example' => '30'], + 'PageNumber' => ['description' => '页码。', 'type' => 'string', 'example' => '1'], + 'ActionLogs' => [ + 'description' => '日志列表。', 'type' => 'array', 'items' => [ - 'description' => '权限级别以及在该级别支持的权限。', 'type' => 'object', 'properties' => [ - 'Scope' => [ - 'description' => '权限级别。', - 'type' => 'string', - 'required' => true, - 'example' => 'Global', - ], - 'Description' => [ - 'description' => '对权限级别的描述。', - 'type' => 'string', - 'required' => true, - 'example' => '全局权限', - ], - 'Privileges' => [ - 'description' => '支持的权限列表。', - 'type' => 'array', - 'items' => [ - 'description' => '权限详情，包含权限名和描述。', - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => '权限名。', - 'type' => 'string', - 'example' => 'select', - ], - 'Description' => [ - 'description' => '权限描述。', - 'type' => 'string', - 'example' => '查询数据', - ], - ], - ], - 'required' => true, - ], + 'Time' => ['description' => '日志时间。格式：**yyyy-MM-ddTHH:mm:ssZ**（UTC时间）。', 'type' => 'string', 'example' => '2023-02-01T05:46:30Z'], + 'Stage' => ['description' => '任务阶段。取值：'."\n" + ."\n" + .'- **StructureMigrate**：结构迁移。'."\n" + .'- **FullDataSync**：全量同步。'."\n" + .'- **IncrementalSync**：增量同步。', 'type' => 'string', 'example' => 'FullDataSync'], + 'State' => ['description' => '日志类型。多个日志类型用英文逗号（,）分隔。取值：'."\n" + ."\n" + .'- **INFO**：信息。'."\n" + .'- **WARN**：警告。'."\n" + .'- **ERROR**：错误。', 'type' => 'string', 'example' => 'INFO,WARN,ERROR'], + 'Context' => ['description' => '日志的内容。', 'type' => 'string', 'example' => 'DDL migration job finished'], ], - 'required' => true, + 'description' => '', ], - 'required' => false, + ], + 'AccessDeniedDetail' => [ + 'description' => '访问被拒绝详细信息。', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => '{'."\n" + .' "AuthAction": "xxx",'."\n" + .' "AuthPrincipalDisplayName": "sampleName",'."\n" + .' "AuthPrincipalOwnerId": "111111111111111111",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthResource": "xxx",'."\n" + .' "NoPermissionType": "xxx",'."\n" + .' "PolicyType": "xxx"'."\n" + .'}', ], ], + 'description' => '', ], ], ], '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' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"246F42E0-A475-15FF-96D2-8DC47FC2F289\\",\\n \\"Data\\": [\\n {\\n \\"Scope\\": \\"Global\\",\\n \\"Description\\": \\"全局权限\\",\\n \\"Privileges\\": [\\n {\\n \\"Key\\": \\"select\\",\\n \\"Description\\": \\"查询数据\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeEnabledPrivilegesResponse>\\n <RequestId>246F42E0-A475-15FF-96D2-8DC47FC2F289</RequestId>\\n <Data>\\n <Scope>Global</Scope>\\n <Description>全局</Description>\\n <Privileges>\\n <Key>select</Key>\\n <Description>查询</Description>\\n </Privileges>\\n </Data>\\n</DescribeEnabledPrivilegesResponse>","errorExample":""}]', - 'title' => '查询支持的权限级别和权限列表', + 'title' => '查询实时数据接入任务的日志', + 'summary' => '查询集群实时数据接入任务的日志详细信息。', 'description' => '- 中心的公网接入地址：`adb.aliyuncs.com`。'."\n" .'- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'DescribeAccountAllPrivileges' => [ - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2024-05-14T08:33:02.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-01-24T03:42:40.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-06-21T09:28:25.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-03-30T02:43:46.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-11-01T17:21:16.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsActionLogs'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsActionLogs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5EDBA27-AF3E-5966-9503-FD1557E19167\\",\\n \\"DBClusterId\\": \\"amv-bp1r053byu48p****\\",\\n \\"WorkloadId\\": \\"aps-hz109vpvt4fg8528d****\\",\\n \\"TotalCount\\": \\"3\\",\\n \\"PageSize\\": \\"30\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"ActionLogs\\": [\\n {\\n \\"Time\\": \\"2023-02-01T05:46:30Z\\",\\n \\"Stage\\": \\"FullDataSync\\",\\n \\"State\\": \\"INFO,WARN,ERROR\\",\\n \\"Context\\": \\"DDL migration job finished\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"xxx\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"sampleName\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"111111111111111111\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthResource\\\\\\": \\\\\\"xxx\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"xxx\\\\\\",\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"xxx\\\\\\"\\\\n}\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeApsActionLogsResponse>\\n <RequestId>A5EDBA27-AF3E-5966-9503-FD1557E19167</RequestId>\\n <DBClusterId>amv-bp1r053byu48p****</DBClusterId>\\n <WorkloadId>aps-hz109vpvt4fg8528d****</WorkloadId>\\n <TotalCount>3</TotalCount>\\n <PageSize>20</PageSize>\\n <PageNumber>1</PageNumber>\\n <ActionLogs>\\n <Time>2022-09-01T05:46:30Z</Time>\\n <Stage>FullDataSync</Stage>\\n <State>INFO,WARN,ERROR</State>\\n <Context>DDL migration job finished</Context>\\n </ActionLogs>\\n</DescribeApsActionLogsResponse>","errorExample":""}]', + ], + 'DescribeApsDatasource' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', - 'abilityTreeCode' => '162785', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '168878', + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsY28JLD'], ], 'parameters' => [ [ 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-beijing'], ], [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp14t95lun0w****', - ], - ], - [ - 'name' => 'AccountName', - 'in' => 'query', - 'schema' => [ - 'description' => '集群的数据库账户名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'account1', - ], + 'in' => 'formData', + 'schema' => ['description' => 'ADB实例ID。', 'type' => 'string', 'required' => true, 'example' => 'am-*******'], ], [ - 'name' => 'Marker', - 'in' => 'query', - 'schema' => [ - 'description' => '当请求的返回结果被截断时，可以将返回结果中的`Marker`填入到该字段以获取从当前截断位置之后的内容。', - 'type' => 'string', - 'required' => false, - 'example' => 'EXAMPLE', - ], + 'name' => 'DatasourceId', + 'in' => 'formData', + 'schema' => ['description' => '数据源ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'BaseResponse', - 'description' => 'BaseResponse', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '3BB185E9-BB54-1727-B876-13243E4C0EB5', - ], - 'Data' => [ - 'description' => '权限详情。', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '******-**D8-5***-A***-****587'], + 'ApsDatasource' => [ + 'description' => '-', 'type' => 'object', 'properties' => [ - 'Result' => [ - 'description' => '权限列表。', - 'type' => 'array', - 'items' => [ - 'description' => '权限详情。', - 'type' => 'object', - 'properties' => [ - 'PrivilegeType' => [ - 'description' => '权限级别，来自接口`DescribeEnabledPrivileges`。', - 'type' => 'string', - 'example' => 'Global', - ], - 'PrivilegeObject' => [ - 'description' => '权限对象，为库、表和列的三元组，为Global权限级别时全为空。', - 'type' => 'object', - 'properties' => [ - 'Database' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'tdb1', - ], - 'Table' => [ - 'description' => '表名称。', - 'type' => 'string', - 'example' => 'table1', - ], - 'Column' => [ - 'description' => '列名称。', - 'type' => 'string', - 'example' => 'id', - ], - 'Description' => [ - 'description' => '对权限对象的描述。', - 'type' => 'string', - 'example' => 'id of table', - ], - ], - ], - 'Privileges' => [ - 'description' => '权限列表。', - 'type' => 'array', - 'items' => [ - 'description' => '权限名称，与接口`DescribeEnabledPrivileges`返回的权限名一致。'."\n", - 'type' => 'string', - 'example' => 'select', - ], - ], - ], + 'DatasourceName' => ['description' => '数据源的名称。', 'type' => 'string', 'example' => 'kafka-2024***'], + 'CreateTime' => ['description' => '创建时间。', 'type' => 'string', 'example' => '2024-04-12T15:03:38Z'], + 'DatasourceType' => ['description' => '数据源类型。', 'type' => 'string', 'example' => 'KAFKA'], + 'DatasourceDescription' => ['description' => '数据源描述。', 'type' => 'string', 'example' => 'test'], + 'SlsInfo' => [ + 'description' => '日志服务（SLS）项目。', + 'type' => 'object', + 'properties' => [ + 'SourceRegionId' => ['description' => '生产站点所属的地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'Project' => ['description' => 'sls项目名称。', 'type' => 'string', 'example' => '***'], + 'Store' => ['description' => 'sls logstore名称。', 'type' => 'string', 'example' => '***'], + 'Across' => ['description' => '是否跨账号。取值：'."\n" + ."\n" + .'- **true** ：当前网络实例为跨账号资源。'."\n" + .'- **false** ：当前网络实例为本账号资源。', 'type' => 'boolean', 'example' => 'false'], + 'AcrossUid' => ['description' => '跨账号UID。', 'type' => 'string', 'example' => '123456'], + 'AcrossRole' => ['description' => '跨账号角色名。', 'type' => 'string', 'example' => 'test'], ], + 'example' => '-', ], - 'Marker' => [ - 'description' => '当返回的字段`Truncated`为`true`时，继续调用该接口时传入该字段的值以获取接下来的内容。', - 'type' => 'string', - 'example' => '0573e74fd1ccb01739993a691e876074db6e1b6ad79f54115f0e98528432ba6a523cfec5780ade5189299cc3396f6ff7', + 'KafkaInfo' => [ + 'description' => 'kafka实例信息。', + 'type' => 'object', + 'properties' => [ + 'KafkaClusterId' => ['description' => 'kafka实例ID。', 'type' => 'string', 'example' => '-'], + 'KafkaTopic' => ['description' => 'kafka topic', 'type' => 'string', 'example' => '[{\'value\': \'hongxian_test\'}]'], + ], + 'example' => '-', ], - 'Truncated' => [ - 'description' => '当返回的内容被截断时，该字段的值为`true`。此时需要继续调用该接口获取接下来的内容，直到该字段的值为`false`。', - 'type' => 'boolean', - 'example' => 'true', + 'HiveInfo' => [ + 'description' => 'hive数据源信息。', + 'type' => 'object', + 'properties' => [ + 'MetaStoreUri' => ['description' => 'hive meta store url。', 'type' => 'string', 'example' => '-'], + 'Vswitch' => ['description' => '交换机ID。', 'type' => 'string', 'example' => 'vsw-******'], + 'SecurityGroup' => ['description' => '安全组ID。', 'type' => 'string', 'example' => 'sg-******'], + 'EmrClusterId' => ['description' => 'EMR集群ID', 'type' => 'string', 'example' => '-'], + ], + 'example' => '-', + ], + 'RdsMysqlInfo' => [ + 'description' => '目前已不再支持。', + 'type' => 'object', + 'properties' => [ + 'UserName' => ['description' => '-', 'type' => 'string', 'example' => '-'], + 'RegionId' => ['description' => '-', 'type' => 'string', 'example' => '-'], + 'InstanceId' => ['description' => '-', 'type' => 'string', 'example' => '-'], + 'ConnectUrl' => ['description' => '-', 'type' => 'string', 'example' => '-'], + 'SecurityGroup' => ['description' => '-', 'type' => 'string', 'example' => '-'], + ], + 'example' => '-', + ], + 'PolarDBMysqlInfo' => [ + 'description' => '目前已不再支持。', + 'type' => 'object', + 'properties' => [ + 'UserName' => ['description' => '-', 'type' => 'string', 'example' => '-'], + 'RegionId' => ['description' => '-', 'type' => 'string', 'example' => '-'], + 'InstanceId' => ['description' => '-', 'type' => 'string', 'example' => '-'], + 'ConnectUrl' => ['description' => '-', 'type' => 'string', 'example' => '-'], + 'SecurityGroup' => ['description' => '-', 'type' => 'string', 'example' => '-'], + 'Across' => ['description' => '-', 'type' => 'boolean', 'example' => '-'], + 'AcrossUid' => ['description' => '-', 'type' => 'string', 'example' => '-'], + 'AcrossRole' => ['description' => '-', 'type' => 'string', 'example' => '-'], + ], + 'example' => '-', + ], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-******'], + 'DatabricksInfo' => [ + 'description' => 'databricks信息。', + 'type' => 'object', + 'properties' => [ + 'accessToken' => ['description' => '访问databrick的令牌。', 'type' => 'string', 'example' => '******'], + 'workspaceURL' => ['description' => '工作空间URL。', 'type' => 'string', 'example' => '-'], + ], + 'example' => '-', ], ], ], @@ -12170,205 +8149,120 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ACS.Account.NotExist', - 'errorMessage' => 'The account is not found.', - ], - [ - 'errorCode' => 'ACS.InvalidParameter.%s', - 'errorMessage' => 'Parameter %s is invalid.', - ], - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'ACS.User.NotBindDatabaseAccount', - 'errorMessage' => 'The user has not been associated with a database account.', - ], + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid.', 'description' => ''], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"3BB185E9-BB54-1727-B876-13243E4C0EB5\\",\\n \\"Data\\": {\\n \\"Result\\": [\\n {\\n \\"PrivilegeType\\": \\"Global\\",\\n \\"PrivilegeObject\\": {\\n \\"Database\\": \\"tdb1\\",\\n \\"Table\\": \\"table1\\",\\n \\"Column\\": \\"id\\",\\n \\"Description\\": \\"id of table\\"\\n },\\n \\"Privileges\\": [\\n \\"select\\"\\n ]\\n }\\n ],\\n \\"Marker\\": \\"0573e74fd1ccb01739993a691e876074db6e1b6ad79f54115f0e98528432ba6a523cfec5780ade5189299cc3396f6ff7\\",\\n \\"Truncated\\": true\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeAccountAllPrivilegesResponse>\\n <RequestId>3BB185E9-BB54-1727-B876-13243E4C0EB5</RequestId>\\n <Data>\\n <Result>\\n <PrivilegeType>Global</PrivilegeType>\\n <PrivilegeObject/>\\n </Result>\\n <Marker>0573e74fd1ccb01739993a691e876074db6e1b6ad79f54115f0e98528432ba6a523cfec5780ade5189299cc3396f6ff7</Marker>\\n <Truncated>true</Truncated>\\n </Data>\\n</DescribeAccountAllPrivilegesResponse>","errorExample":""}]', - 'title' => '查询数据库账号的所有权限', - 'summary' => '获取给定账号拥有的所有权限，包括全局、库、表、列级别。', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeAccountPrivilegeObjects' => [ - 'summary' => '获取给定账号可见的库表列。', - 'methods' => [ - 'post', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询过APS数据源详情', + 'summary' => '查询过APS数据源详情。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsDatasource'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsDatasource', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-**D8-5***-A***-****587\\",\\n \\"ApsDatasource\\": {\\n \\"DatasourceName\\": \\"kafka-2024***\\",\\n \\"CreateTime\\": \\"2024-04-12T15:03:38Z\\",\\n \\"DatasourceType\\": \\"KAFKA\\",\\n \\"DatasourceDescription\\": \\"test\\",\\n \\"SlsInfo\\": {\\n \\"SourceRegionId\\": \\"cn-hangzhou\\",\\n \\"Project\\": \\"***\\",\\n \\"Store\\": \\"***\\",\\n \\"Across\\": false,\\n \\"AcrossUid\\": \\"123456\\",\\n \\"AcrossRole\\": \\"test\\"\\n },\\n \\"KafkaInfo\\": {\\n \\"KafkaClusterId\\": \\"-\\",\\n \\"KafkaTopic\\": \\"[{\'value\': \'hongxian_test\'}]\\"\\n },\\n \\"HiveInfo\\": {\\n \\"MetaStoreUri\\": \\"-\\",\\n \\"Vswitch\\": \\"vsw-******\\",\\n \\"SecurityGroup\\": \\"sg-******\\",\\n \\"EmrClusterId\\": \\"-\\"\\n },\\n \\"RdsMysqlInfo\\": {\\n \\"UserName\\": \\"-\\",\\n \\"RegionId\\": \\"-\\",\\n \\"InstanceId\\": \\"-\\",\\n \\"ConnectUrl\\": \\"-\\",\\n \\"SecurityGroup\\": \\"-\\"\\n },\\n \\"PolarDBMysqlInfo\\": {\\n \\"UserName\\": \\"-\\",\\n \\"RegionId\\": \\"-\\",\\n \\"InstanceId\\": \\"-\\",\\n \\"ConnectUrl\\": \\"-\\",\\n \\"SecurityGroup\\": \\"-\\",\\n \\"Across\\": true,\\n \\"AcrossUid\\": \\"-\\",\\n \\"AcrossRole\\": \\"-\\"\\n },\\n \\"DBClusterId\\": \\"amv-******\\",\\n \\"DatabricksInfo\\": {\\n \\"accessToken\\": \\"******\\",\\n \\"workspaceURL\\": \\"-\\"\\n }\\n }\\n}","type":"json"}]', + ], + 'DescribeApsDatasources' => [ + 'summary' => '查询APS数据源列表。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', - 'abilityTreeCode' => '160215', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsY28JLD', 'FEATUREadsCORDM7'], ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'ch-hangzhou', - ], - ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1k3wdmt139****', - ], + 'name' => 'PageNumber', + 'in' => 'formData', + 'schema' => ['description' => '页数。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'docRequired' => true, 'maximum' => '10000', 'minimum' => '1', 'example' => '1'], ], [ - 'name' => 'AccountName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库账号名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'name' => 'PageSize', + 'in' => 'formData', + 'schema' => ['description' => '页大小。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'docRequired' => true, 'maximum' => '1000', 'minimum' => '1', 'example' => '30'], ], [ - 'name' => 'PrivilegeType', - 'in' => 'query', - 'schema' => [ - 'description' => '权限级别，只能传入库（Database)）、表（Table）、列（Column）级别，不能传入全局（Global）级别。', - 'type' => 'string', - 'required' => false, - 'example' => 'Column', - 'default' => 'Database', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '区域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DatabasePrivilegeObject', - 'in' => 'query', - 'schema' => [ - 'description' => '根据给定的数据库名称进行筛选。', - 'type' => 'string', - 'required' => false, - 'example' => 'database1', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => 'ADB实例ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-******'], ], [ - 'name' => 'TablePrivilegeObject', - 'in' => 'query', - 'schema' => [ - 'description' => '根据给定的表名称进行筛选。', - 'type' => 'string', - 'required' => false, - 'example' => 'table1', - ], + 'name' => 'DatasourceType', + 'in' => 'formData', + 'schema' => ['description' => '数据源类型。', 'type' => 'string', 'required' => false, 'example' => 'SLS'], ], [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页号，从1开始，默认值1。', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], + 'name' => 'DatasourceName', + 'in' => 'formData', + 'schema' => ['description' => '数据源名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页含有条目的最大数量，默认为20。', - 'type' => 'string', - 'required' => false, - 'example' => '20', - ], + 'name' => 'StartTime', + 'in' => 'formData', + 'schema' => ['description' => '开始时间。', 'type' => 'string', 'required' => false, 'example' => '2024-01-01'], ], [ - 'name' => 'ColumnPrivilegeObject', - 'in' => 'query', - 'schema' => [ - 'description' => '根据给定的列名进行筛选。', - 'type' => 'string', - 'required' => false, - 'example' => 'col1', - ], + 'name' => 'EndTime', + 'in' => 'formData', + 'schema' => ['description' => '结束时间。', 'type' => 'string', 'required' => false, 'example' => '2024-01-30'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回结果。', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '34B2AD29-682F-1C14-B3AA-9EF1A96084B8', - ], - 'Data' => [ - 'description' => '权限列表。', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '******-5213-******-B608-******'], + 'PageNumber' => ['description' => '页数。', 'type' => 'string', 'example' => '1'], + 'PageSize' => ['description' => '每页的记录数。', 'type' => 'string', 'example' => '30'], + 'TotalCount' => ['description' => '返回的结果总数。', 'type' => 'string', 'example' => '1'], + 'ApsDatasources' => [ + 'description' => '数据源数组。', 'type' => 'array', 'items' => [ - 'description' => '权限对象，为库、表、列的三元组。', 'type' => 'object', 'properties' => [ - 'Database' => [ - 'description' => '数据库名称，当权限级别是库、表、列时返回该字段。', - 'type' => 'string', - 'example' => 'tdb1', - ], - 'Table' => [ - 'description' => '表名称，当权限级别是表和列时返回该字段。', - 'type' => 'string', - 'example' => 'table1', - ], - 'Column' => [ - 'description' => '列名称，当权限界别是列时返回该字段。', - 'type' => 'string', - 'example' => 'column1', - ], - 'Description' => [ - 'description' => '创建表/列时指定的描述。只有当权限级别为库和表时才有值，分别代表库和表的描述。', - 'type' => 'string', - 'example' => 'a test db', - ], + 'DatasourceName' => ['description' => '目标数据源的名称。', 'type' => 'string', 'example' => 'test'], + 'CreateTime' => ['description' => '创建时间。', 'type' => 'string', 'example' => '2024-01-10 14:44:33'], + 'DatasourceType' => ['description' => '数据源类型。', 'type' => 'string', 'example' => 'SLS'], + 'DatasourceDescription' => ['description' => '数据源描述。', 'type' => 'string', 'example' => 'test'], + 'DatasourceId' => ['description' => '数据源ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'HasJob' => ['description' => '是否有任务在使用这个数据源。', 'type' => 'boolean', 'example' => 'false'], ], + 'example' => '-', + 'description' => '', ], - ], - 'TotalCount' => [ - 'description' => '查询得到的结果总数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '23', - ], - 'PageNumber' => [ - 'description' => '页号，和传入的值一致。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '页大小，和传入的值一致。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', + 'example' => '-', ], ], ], @@ -12376,41 +8270,36 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ACS.Account.NotExist', - 'errorMessage' => 'The account is not found.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'ACS.InvalidParameter.%s', - 'errorMessage' => 'Parameter %s is invalid.', - ], - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'ACS.User.NotBindDatabaseAccount', - 'errorMessage' => 'The user has not been associated with a database account.', - ], + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid.', 'description' => ''], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"34B2AD29-682F-1C14-B3AA-9EF1A96084B8\\",\\n \\"Data\\": [\\n {\\n \\"Database\\": \\"tdb1\\",\\n \\"Table\\": \\"table1\\",\\n \\"Column\\": \\"column1\\",\\n \\"Description\\": \\"a test db\\"\\n }\\n ],\\n \\"TotalCount\\": 23,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 20\\n}","errorExample":""},{"type":"xml","example":"<DescribeAccountPrivilegeObjectsResponse>\\n <RequestId>34B2AD29-682F-1C14-B3AA-9EF1A96084B8</RequestId>\\n <Data>\\n <Database>tdb1</Database>\\n <Table>table1</Table>\\n <Column>column1</Column>\\n <Description>a test db</Description>\\n </Data>\\n <TotalCount>23</TotalCount>\\n <PageNumber>1</PageNumber>\\n <PageSize>20</PageSize>\\n</DescribeAccountPrivilegeObjectsResponse>","errorExample":""}]', - 'title' => '查询数据库账号可见的库表列', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeOperatorPermission' => [ - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询APS数据源列表', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsDatasources'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsDatasources', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-5213-******-B608-******\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"PageSize\\": \\"30\\",\\n \\"TotalCount\\": \\"1\\",\\n \\"ApsDatasources\\": [\\n {\\n \\"DatasourceName\\": \\"test\\",\\n \\"CreateTime\\": \\"2024-01-10 14:44:33\\",\\n \\"DatasourceType\\": \\"SLS\\",\\n \\"DatasourceDescription\\": \\"test\\",\\n \\"DatasourceId\\": 1,\\n \\"HasJob\\": false\\n }\\n ]\\n}","type":"json"}]', + ], + 'DescribeApsHiveWorkload' => [ + 'summary' => '查询APS Hive工作负载详情。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -12419,112 +8308,146 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '214554', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], + 'operationType' => 'none', + 'abilityTreeCode' => '170284', + 'abilityTreeNodes' => ['FEATUREadsBIVU9O'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-uf6wjk5xxxxxxxxxx', - ], + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-*******'], + ], + [ + 'name' => 'WorkloadId', + 'in' => 'formData', + 'schema' => ['description' => '数据链路任务ID。', 'type' => 'string', 'required' => true, 'example' => 'aps-******'], + ], + [ + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'CreatedTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2024-02-25T03:35:02Z', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Privileges' => [ - 'description' => '授权详情。', - 'type' => 'string', - 'example' => 'Control,Data', - ], - 'ExpiredTime' => [ - 'description' => '授权过期时间。', - 'type' => 'string', - 'example' => '2024-01-10T02:19:00Z', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-uf6wjk5xxxxxxxxxx', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '86F92D26-B774-5FA1-8E53-******'], + 'ApsWorkload' => [ + 'description' => '任务信息。', + 'type' => 'object', + 'properties' => [ + 'RegionId' => ['description' => '地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-*******'], + 'WorkloadId' => ['description' => '数据链路任务ID。', 'type' => 'string', 'example' => 'aps-******'], + 'WorkloadName' => ['description' => '工作负载名。', 'type' => 'string', 'example' => 'test'], + 'ResourceGroup' => ['description' => 'SQL语句所属的资源池。', 'type' => 'string', 'example' => 'test'], + 'FullComputeUnit' => ['description' => '迁移所需acu数。', 'type' => 'string', 'example' => '16'], + 'SyncAllowExpression' => ['description' => '手动匹配源端库表白名单表达式。', 'type' => 'string', 'example' => 'abc'], + 'SyncDenyExpression' => ['description' => '手动匹配源端库表黑名单表达式。', 'type' => 'string', 'example' => 'def'], + 'TargetType' => ['description' => '目标类型。', 'type' => 'string', 'example' => 'OSS'], + 'OssLocation' => ['description' => 'oss地址。', 'type' => 'string', 'example' => 'oss://******'], + 'ConflictStrategy' => ['description' => '目的端存在同名库表处理策略。', 'type' => 'string', 'example' => 'Intercept'], + 'AdvancedConfig' => ['description' => '高级配置。', 'type' => 'string', 'example' => 'test.adv.config=value'], + 'DatasourceId' => ['description' => '数据源ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '8'], + 'DatasourceName' => ['description' => '数据源名称。', 'type' => 'string', 'example' => 'sls-******'], + 'Parallelism' => ['description' => '并行度。'."\n" + ."\n", 'type' => 'integer', 'format' => 'int64', 'example' => '2'], + 'WorkloadTypeName' => ['description' => '工作负载名称。', 'type' => 'string', 'example' => 'test'], + 'State' => ['description' => '状态。', 'type' => 'string', 'example' => 'COMPLETED'], + 'CreateTime' => ['description' => '创建时间。', 'type' => 'string', 'example' => '-'], + 'MetaStoreUri' => ['description' => 'hive meta store url。', 'type' => 'string', 'example' => '-'], + 'Vswitch' => ['description' => '交换机（vSwitch）名称。', 'type' => 'string', 'example' => 'vsw-******'], + 'EmrClusterId' => ['description' => 'EMR集群ID。', 'type' => 'string', 'example' => '-'], + ], + 'example' => '-', ], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"CreatedTime\\": \\"2024-02-25T03:35:02Z\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Privileges\\": \\"Control,Data\\",\\n \\"ExpiredTime\\": \\"2024-01-10T02:19:00Z\\",\\n \\"DBClusterId\\": \\"amv-uf6wjk5xxxxxxxxxx\\"\\n}","type":"json"}]', - 'title' => '查询服务账号授权情况', - 'summary' => '查询服务账号授权情况。', - ], - 'RevokeOperatorPermission' => [ - 'summary' => '取消服务账号的授权。', - 'methods' => [ - 'post', - 'get', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid.', 'description' => ''], + ], ], - 'schemes' => [ - 'http', - 'https', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询APS Hive工作负载详情', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsHiveWorkload'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsHiveWorkload', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"86F92D26-B774-5FA1-8E53-******\\",\\n \\"ApsWorkload\\": {\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"DBClusterId\\": \\"amv-*******\\",\\n \\"WorkloadId\\": \\"aps-******\\",\\n \\"WorkloadName\\": \\"test\\",\\n \\"ResourceGroup\\": \\"test\\",\\n \\"FullComputeUnit\\": \\"16\\",\\n \\"SyncAllowExpression\\": \\"abc\\",\\n \\"SyncDenyExpression\\": \\"def\\",\\n \\"TargetType\\": \\"OSS\\",\\n \\"OssLocation\\": \\"oss://******\\",\\n \\"ConflictStrategy\\": \\"Intercept\\",\\n \\"AdvancedConfig\\": \\"test.adv.config=value\\",\\n \\"DatasourceId\\": 8,\\n \\"DatasourceName\\": \\"sls-******\\",\\n \\"Parallelism\\": 2,\\n \\"WorkloadTypeName\\": \\"test\\",\\n \\"State\\": \\"COMPLETED\\",\\n \\"CreateTime\\": \\"-\\",\\n \\"MetaStoreUri\\": \\"-\\",\\n \\"Vswitch\\": \\"vsw-******\\",\\n \\"EmrClusterId\\": \\"-\\"\\n }\\n}","type":"json"}]', + ], + 'DescribeApsJobDetail' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '214578', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], + 'operationType' => 'none', + 'abilityTreeCode' => '180625', + 'abilityTreeNodes' => ['FEATUREadsH8FO36'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1mfe9qmsw1dzyg', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'], + ], + [ + 'name' => 'ApsJobId', + 'in' => 'formData', + 'schema' => ['description' => '任务ID。', 'type' => 'string', 'required' => true, 'example' => 'aps-******'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '******-E606-4A42-BF6D-******'], + 'APSJobDetail' => [ + 'description' => '任务详情。', + 'type' => 'object', + 'properties' => [ + 'SourceEndpointRegion' => ['description' => '源数据库地域。'."\n", 'type' => 'string', 'example' => 'cn-beijing'], + 'SourceEndpointInstanceID' => ['description' => '源数据库实例ID。', 'type' => 'string', 'example' => 'pc-*******'], + 'DestinationEndpointRegion' => ['description' => '目标实例所属地域。', 'type' => 'string', 'example' => 'cn-beijing'], + 'DestinationEndpointInstanceID' => ['description' => '目标端数据库实例ID。', 'type' => 'string', 'example' => 'amv-******'], + 'PartitionList' => ['description' => '分区列表。', 'type' => 'string', 'example' => '{}'], + 'DbList' => ['description' => '同步对象列表。'."\n" + ."\n", 'type' => 'string', 'example' => '{}'], + 'TargetTableMode' => ['description' => '目标表模式。', 'type' => 'string', 'example' => '0'], + 'Status' => ['description' => '状态。', 'type' => 'string', 'example' => 'Running'], + ], + 'example' => '-', ], ], ], @@ -12532,117 +8455,157 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'RelatedTaskNotFinish', - 'errorMessage' => 'The related task does not finish.', - ], + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid.', 'description' => ''], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', - 'title' => '取消授权服务账号', - ], - 'GrantOperatorPermission' => [ - 'summary' => '用户授予服务账号权限，供值班定位问题。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询APS任务详情', + 'summary' => 'DescribeApsJobDetail。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsJobDetail'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsJobDetail', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-E606-4A42-BF6D-******\\",\\n \\"APSJobDetail\\": {\\n \\"SourceEndpointRegion\\": \\"cn-beijing\\",\\n \\"SourceEndpointInstanceID\\": \\"pc-*******\\",\\n \\"DestinationEndpointRegion\\": \\"cn-beijing\\",\\n \\"DestinationEndpointInstanceID\\": \\"amv-******\\",\\n \\"PartitionList\\": \\"{}\\",\\n \\"DbList\\": \\"{}\\",\\n \\"TargetTableMode\\": \\"0\\",\\n \\"Status\\": \\"Running\\"\\n }\\n}","type":"json"}]', + ], + 'DescribeApsJobs' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '214575', - 'abilityTreeNodes' => [ - 'FEATUREadsF4WPVU', - ], + 'operationType' => 'list', + 'abilityTreeCode' => '180030', + 'abilityTreeNodes' => ['FEATUREadsH8FO36'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1565u55p32****', - ], + 'name' => 'PageNumber', + 'in' => 'formData', + 'schema' => ['description' => '页数。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'docRequired' => true, 'maximum' => '10000', 'minimum' => '1', 'example' => '1'], ], [ - 'name' => 'ExpiredTime', - 'in' => 'query', - 'schema' => [ - 'description' => '服务账号权限过期时间。UTC时间，格式为yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2022-11-30T00:00:00Z', - ], + 'name' => 'PageSize', + 'in' => 'formData', + 'schema' => ['description' => '每页大小。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'docRequired' => true, 'maximum' => '1000', 'minimum' => '1', 'example' => '30'], ], [ - 'name' => 'Privileges', - 'in' => 'query', - 'schema' => [ - 'description' => '权限名称。取值说明：'."\n" - .'- **Control**：配置权限，查看和修改集群配置。'."\n" - .'- **Data**：数据权限，查看表结构、索引和SQL。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'enumValueTitles' => [ - 'Control' => 'Control', - 'Data' => 'Data', - ], - 'example' => 'Control', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'], + ], + [ + 'name' => 'CreateTimeStart', + 'in' => 'formData', + 'schema' => ['description' => '起始创建时间。', 'type' => 'string', 'required' => false, 'example' => '2022-03-23T01:10Z'], + ], + [ + 'name' => 'CreateTimeEnd', + 'in' => 'formData', + 'schema' => ['description' => '截止创建时间。', 'type' => 'string', 'required' => false, 'example' => '2022-04-23T01:10Z'], + ], + [ + 'name' => 'ApsJobName', + 'in' => 'formData', + 'schema' => ['description' => '任务名称。', 'type' => 'string', 'required' => false, 'example' => 'aps-xxxxx'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A438072A-E2E7-5509-9A3F-66293512A820', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '******-7F9D-5DBD-993E-******'], + 'PageNumber' => ['description' => '页码。', 'type' => 'string', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'string', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '0'], + 'APSJobs' => [ + 'description' => '任务列表。', + 'type' => 'array', + 'items' => [ + 'description' => '-', + 'type' => 'object', + 'properties' => [ + 'Status' => ['description' => '任务状态。', 'type' => 'string', 'example' => '-'], + 'ApsJobName' => ['description' => '任务名称。', 'type' => 'string', 'example' => 'data-sync-******'], + 'DestinationInstanceID' => ['description' => '目标端实例ID。', 'type' => 'string', 'example' => 'amv-*******'], + 'SourceInstanceID' => ['description' => '源端实例ID。', 'type' => 'string', 'example' => 'pc-******'], + 'Delay' => ['description' => '同步延迟时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'CreateTime' => ['description' => '创建时间。', 'type' => 'string', 'example' => '2022-06-28 15:00:04'], + 'Projress' => ['description' => '进展。', 'type' => 'string', 'example' => '30: progress 30%'], + 'ApsJobId' => ['description' => '任务ID。', 'type' => 'string', 'example' => 'aps-******'], + 'SubStatus' => ['description' => '子任务状态。', 'type' => 'string', 'example' => '-'], + 'ErrMessage' => ['description' => '错误信息。', 'type' => 'string', 'example' => 'OK'], + ], + 'example' => '-', + ], + 'example' => '-', ], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'True'], + 'Code' => ['description' => '后端错误码。', 'type' => 'string', 'example' => 'ok'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'OK'], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => 'ok'], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'RelatedTaskNotFinish', - 'errorMessage' => 'The related task does not finish.', - ], + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid.', 'description' => ''], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"A438072A-E2E7-5509-9A3F-66293512A820\\"\\n}","type":"json"}]', - 'title' => '授予服务账号权限', - ], - 'DescribeBackupPolicy' => [ - 'summary' => '查看集群备份设置', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询APS任务列表', + 'summary' => '查询APS任务列表。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsJobs'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeApsJobs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-7F9D-5DBD-993E-******\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"PageSize\\": \\"30\\",\\n \\"TotalCount\\": \\"0\\",\\n \\"APSJobs\\": [\\n {\\n \\"Status\\": \\"-\\",\\n \\"ApsJobName\\": \\"data-sync-******\\",\\n \\"DestinationInstanceID\\": \\"amv-*******\\",\\n \\"SourceInstanceID\\": \\"pc-******\\",\\n \\"Delay\\": 0,\\n \\"CreateTime\\": \\"2022-06-28 15:00:04\\",\\n \\"Projress\\": \\"30: progress 30%\\",\\n \\"ApsJobId\\": \\"aps-******\\",\\n \\"SubStatus\\": \\"-\\",\\n \\"ErrMessage\\": \\"OK\\"\\n }\\n ],\\n \\"Success\\": true,\\n \\"Code\\": \\"ok\\",\\n \\"Message\\": \\"OK\\",\\n \\"HttpStatusCode\\": 0\\n}","type":"json"}]', + ], + 'DescribeApsMigrationWorkloads' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -12650,202 +8613,141 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsM6VDCK', - ], - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ + 'name' => 'PageNumber', + 'in' => 'formData', + 'schema' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'docRequired' => true, 'maximum' => '10000', 'minimum' => '1', 'example' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'formData', + 'schema' => ['description' => '每页大小。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'docRequired' => true, 'maximum' => '1000', 'minimum' => '1', 'example' => '30'], + ], + [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-uf6s7oa710rbu0x3b', - ], + 'in' => 'formData', + 'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-*******'], + ], + [ + 'name' => 'WorkloadName', + 'in' => 'formData', + 'schema' => ['description' => '工作负载名。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + [ + 'name' => 'OssLocation', + 'in' => 'formData', + 'schema' => ['description' => 'oss地址。', 'type' => 'string', 'required' => false, 'example' => 'oss://******'], + ], + [ + 'name' => 'StartTime', + 'in' => 'formData', + 'schema' => ['description' => '查询开始时间。', 'type' => 'string', 'required' => false, 'example' => '2021-06-20T16:00:00Z'], + ], + [ + 'name' => 'EndTime', + 'in' => 'formData', + 'schema' => ['description' => '查询结束时间。', 'type' => 'string', 'required' => false, 'example' => '2021-07-20T16:00:00Z'], ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ - 'PreferredBackupPeriod' => [ - 'description' => '数据备份周期，多个取值用英文逗号（,）隔开。取值：'."\n" - ."\n" - .'- Monday：周一；'."\n" - .'- Tuesday：周二；'."\n" - .'- Wednesday：周三；'."\n" - .'- Thursday：周四；'."\n" - .'- Friday：周五；'."\n" - .'- Saturday：周六；'."\n" - .'- Sunday：周日。', - 'type' => 'string', - 'example' => 'Wednesday,Saturday', - ], - 'LogBackupRetentionPeriod' => [ - 'description' => '日志备份保留天数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '7', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'PreferredBackupTime' => [ - 'description' => '数据备份时间，格式：HH:mmZ-HH:mmZ。', - 'type' => 'string', - 'example' => '15:00Z-16:00Z', - ], - 'EnableBackupLog' => [ - 'description' => '是否开启日志（实时）备份。取值说明：'."\n" - .'- **Enable**：开启。'."\n" - .'- **Disable**：关闭。', - 'type' => 'string', - 'example' => 'true', - ], - 'BackupRetentionPeriod' => [ - 'description' => '数据备份保留天数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '7', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '******-3EEC-57F0-9F06-******'], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '本页记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'MigrationWorkloads' => [ + 'description' => '迁移工作负载列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ModifyTime' => ['description' => '任务修改的时间。', 'type' => 'string', 'example' => '2021-06-21T02:15:16Z'], + 'CreateTime' => ['description' => '任务创建时间。', 'type' => 'string', 'example' => '2021-06-21T02:15:16Z'], + 'Id' => ['description' => '任务ID。', 'type' => 'string', 'example' => '123'], + 'State' => ['description' => '状态。', 'type' => 'string', 'example' => 'COMPLETED'], + 'OssLocation' => ['description' => 'oss地址。', 'type' => 'string', 'example' => 'oss://******'], + 'TargetType' => ['description' => '目标类型。', 'type' => 'string', 'example' => 'OSS'], + 'WorkloadSubType' => ['description' => '子任务类型。', 'type' => 'string', 'example' => 'test'], + 'Name' => ['description' => '名称。', 'type' => 'string', 'example' => 'TEST-001'], + 'AcuCount' => ['description' => 'acu数。', 'type' => 'integer', 'format' => 'int32', 'example' => '-'], + 'MaxRT' => ['description' => '最大响应时间。', 'type' => 'string', 'example' => '1000'], + 'FailedMsg' => ['description' => '错误消息。', 'type' => 'string', 'example' => '-'], + ], + 'description' => '', + ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid.', 'description' => ''], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PreferredBackupPeriod\\": \\"Wednesday,Saturday\\",\\n \\"LogBackupRetentionPeriod\\": 7,\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PreferredBackupTime\\": \\"15:00Z-16:00Z\\",\\n \\"EnableBackupLog\\": \\"true\\",\\n \\"BackupRetentionPeriod\\": 7\\n}","type":"json"}]', - 'title' => '查询集群自动备份策略', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'ModifyBackupPolicy' => [ - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询APS迁移任务工作负载列表', + 'summary' => '查询APS迁移任务工作负载列表。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsMigrationWorkloads'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeApsMigrationWorkloads', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-3EEC-57F0-9F06-******\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 0,\\n \\"MigrationWorkloads\\": [\\n {\\n \\"ModifyTime\\": \\"2021-06-21T02:15:16Z\\",\\n \\"CreateTime\\": \\"2021-06-21T02:15:16Z\\",\\n \\"Id\\": \\"123\\",\\n \\"State\\": \\"COMPLETED\\",\\n \\"OssLocation\\": \\"oss://******\\",\\n \\"TargetType\\": \\"OSS\\",\\n \\"WorkloadSubType\\": \\"test\\",\\n \\"Name\\": \\"TEST-001\\",\\n \\"AcuCount\\": 0,\\n \\"MaxRT\\": \\"1000\\",\\n \\"FailedMsg\\": \\"-\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'DescribeApsProgress' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '155194', - 'abilityTreeNodes' => [ - 'FEATUREadsM6VDCK', - ], + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '171313', + 'abilityTreeNodes' => ['FEATUREadsH8FO36'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-bp1xxxxxxxx47', - ], - ], - [ - 'name' => 'PreferredBackupTime', - 'in' => 'query', - 'schema' => [ - 'description' => '执行全量备份的开始时间，格式为HH:mmZ-HH:mmZ（UTC时间）。'."\n" - ."\n" - .'> 时间范围限制为1小时。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '18:00Z-19:00Z', - ], - ], - [ - 'name' => 'PreferredBackupPeriod', - 'in' => 'query', - 'schema' => [ - 'description' => '全量备份周期，多个取值用英文逗号（,）隔开。取值说明：'."\n" - .'- **Monday**：周一。'."\n" - .'- **Tuesday**：周二。'."\n" - .'- **Wednesday**：周三。'."\n" - .'- **Thursday**：周四。'."\n" - .'- **Friday**：周五。'."\n" - .'- **Saturday**：周六。'."\n" - .'- **Sunday**：周日。'."\n" - ."\n" - .'> 为保证数据安全，最少选择两个。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'Monday,Wednesday,Friday,Sunday', - ], - ], - [ - 'name' => 'BackupRetentionPeriod', - 'in' => 'query', - 'schema' => [ - 'description' => '全量备份保留天数，取值范围为：7~730。'."\n" - .'> 本参数不填写，默认为7天。', - 'type' => 'string', - 'required' => false, - 'example' => '7', - 'default' => '7', - ], + 'in' => 'formData', + 'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-******'], ], [ - 'name' => 'EnableBackupLog', - 'in' => 'query', - 'schema' => [ - 'description' => '是否开启日志（实时）备份。取值说明：'."\n" - .'- **Enable**：开启。'."\n" - .'- **Disable**：关闭。'."\n" - .'> 本参数不填写，默认开启。', - 'type' => 'string', - 'required' => false, - 'example' => 'Enable', - ], + 'name' => 'WorkloadId', + 'in' => 'formData', + 'schema' => ['description' => '数据链路任务ID。', 'type' => 'string', 'required' => true, 'example' => 'aps-******'], ], [ - 'name' => 'LogBackupRetentionPeriod', - 'in' => 'query', - 'schema' => [ - 'description' => '日志（实时）数据备份保留天数，取值范围为：7~730。'."\n" - .'> 本参数不填写，默认为7天。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '730', - 'minimum' => '7', - 'example' => '7', - 'default' => '7', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ @@ -12853,58 +8755,63 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '******-3EEC-******-9F06-******'], + 'TotalTableCount' => ['description' => '表总数。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'SuccessTableCount' => ['description' => '成功迁移表总数。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'SuccessPercentage' => ['description' => '成功百分比。', 'type' => 'integer', 'format' => 'int32', 'example' => '100'], + 'ApsHiveProgress' => [ + 'description' => '迁移进度。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DbName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'test'], + 'TbName' => ['description' => '表名称。', 'type' => 'string', 'example' => 'test'], + 'Progress' => ['description' => '进度。', 'type' => 'string', 'example' => '95'], + 'Speed' => ['description' => '迁移速度。', 'type' => 'string', 'example' => '2'], + ], + 'example' => '-', + 'description' => '', + ], + 'example' => '-', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'InvalidPreferredBackupTime.Malformed', - 'errorMessage' => 'The specified parameter PreferredBackupTime is not valid.', - ], - [ - 'errorCode' => 'InvalidPreferredBackupPeriod.Malformed', - 'errorMessage' => 'The specified parameter PreferredBackupPeriod is not valid.', - ], - [ - 'errorCode' => 'InvalidBackupRetentionPeriod.Malformed', - 'errorMessage' => 'The specified parameter "BackupRetentionPeriod" should be within [7-%s] days.', - ], + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid.', 'description' => ''], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', - 'title' => '修改集群备份策略', - 'summary' => '修改集群的备份策略。', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeBackups' => [ - 'summary' => '查询实例备份集', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询APS进度', + 'summary' => '查询APS进度。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsProgress'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsProgress', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"TotalTableCount\\": 10,\\n \\"SuccessTableCount\\": 10,\\n \\"SuccessPercentage\\": 100,\\n \\"ApsHiveProgress\\": [\\n {\\n \\"DbName\\": \\"test\\",\\n \\"TbName\\": \\"test\\",\\n \\"Progress\\": \\"95\\",\\n \\"Speed\\": \\"2\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'DescribeApsResourceGroups' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -12913,429 +8820,465 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '155193', - 'abilityTreeNodes' => [ - 'FEATUREadsM6VDCK', - ], + 'abilityTreeCode' => '146751', + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsY28JLD'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-bp18934i73vb5****', - ], - ], - [ - 'name' => 'BackupId', - 'in' => 'query', - 'schema' => [ - 'description' => '备份集ID。', - 'type' => 'string', - 'required' => false, - 'example' => '1679758862', - ], - ], - [ - 'name' => 'StartTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间，格式：yyyy-MM-ddTHH:mmZ。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2011-06-01T16:00Z', - ], - ], - [ - 'name' => 'EndTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间，需要大于查询开始时间，格式：yyyy-MM-ddTHH:mmZ。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2023-02-20T02:30Z', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - ."\n" - .'- 30；'."\n" - .'- 50；'."\n" - .'- 100'."\n" - ."\n" - .'默认值：30。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '30', - 'example' => '30', - 'default' => '30', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码，取值：大于0且不超过Integer数据类型最大值的正整数。默认值：1。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'>您可以调用[DescribeDBClusters](~~612397~~)接口查看集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1t6rym21****'], ], [ - 'name' => 'Remote', - 'in' => 'query', - 'schema' => [ - 'description' => '是否仅查询跨地域备份。取值为true时，仅查询跨地域备份。取值为false时，仅查询本地备份。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - 'default' => 'false', - ], + 'name' => 'WorkloadId', + 'in' => 'formData', + 'schema' => ['description' => '数据同步任务ID。', 'type' => 'string', 'required' => false, 'example' => 'aps-hz1686v37sx****'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '响应模式。', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '300', - ], - 'PageSize' => [ - 'description' => '本页备份集个数。', - 'type' => 'string', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'CE17270B-F8F8-5A31-9DB4-DADDFDAD7940', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'string', - 'example' => '1', - ], - 'FreeBackupSize' => [ - 'description' => '备份集免费大小，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'TotalBackupSize' => [ - 'description' => '总备份集大小，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '64953700', - ], - 'Items' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '6FC370D7-1D4C-5A8E-805E-F73366382C66'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回Success。'."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], + 'HttpStatusCode' => ['description' => 'HTTP状态码。'."\n", 'type' => 'integer', 'format' => 'int64', 'example' => '200'], + 'Data' => [ + 'description' => '资源组信息列表。', 'type' => 'object', - 'itemNode' => true, 'properties' => [ - 'Backup' => [ - 'description' => '备份集列表。', + 'Step' => ['description' => '资源组的步长，单位ACU。'."\n" + .'- 当GroupType为**Interactive**时，步长为16 ACU。'."\n" + .'- 当GroupType为**Job**时，步长为8 ACU。', 'type' => 'integer', 'format' => 'int64', 'example' => '8'], + 'ResourceGroups' => [ + 'description' => '资源组列表。', 'type' => 'array', 'items' => [ + 'description' => '资源组列表。', 'type' => 'object', 'properties' => [ - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'am-bp11q28kvl688****', - ], - 'BackupType' => [ - 'description' => '备份类型。取值说明：'."\n" - .'- **FullBackup**：全量备份。'."\n" - .'- **IncrementalBackup**：增量备份。', - 'type' => 'string', - 'example' => 'FullBackup', - ], - 'BackupStartTime' => [ - 'description' => '备份开始时间。', - 'type' => 'string', - 'example' => '2022-06-01T16:00Z', - ], - 'BackupSize' => [ - 'description' => '备份文件大小，单位：Byte。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2167808', - ], - 'BackupEndTime' => [ - 'description' => '备份结束时间。', - 'type' => 'string', - 'example' => '2022-06-02T16:00Z', - ], - 'BackupExpiredTime' => [ - 'description' => '备份集过期时间。', - 'type' => 'string', - 'example' => '2022-07-02T16:00Z'."\n", - ], - 'BackupId' => [ - 'description' => '备份集ID。', - 'type' => 'string', - 'example' => '32732****', - ], - 'BackupMethod' => [ - 'description' => '备份方法。只支持快照备份（Snapshot）。', - 'type' => 'string', - 'example' => 'Snapshot', - ], - 'BackupRegion' => [ - 'description' => '跨地域备份所在地域。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'ParentBackupId' => [ - 'description' => '跨地域备份所关联的本地备份集ID', - 'type' => 'string', - 'example' => '32733****', - ], - 'BackupStatus' => [ - 'description' => '备份的状态。取值如下：'."\n" - ."\n" - .'- Running：备份正在进行中。'."\n" - .'- Finished：备份已完成。', - 'type' => 'string', - 'example' => 'Finished', - ], + 'CuOptions' => [ + 'description' => '资源梯度值列表。', + 'type' => 'array', + 'items' => ['description' => '资源梯度值。', 'type' => 'integer', 'format' => 'int64', 'example' => '无'], + ], + 'MaxComputeResource' => ['description' => '最大计算预留资源，单位ACU。'."\n" + .'- 当GroupType为**Interactive**时，计算预留资源最大为集群当前未分配资源，步长为16 ACU。'."\n" + .'- 当GroupType为**Job**时，计算预留资源最大为集群当前未分配资源，步长为8 ACU。', 'type' => 'integer', 'format' => 'int32', 'example' => '512'], + 'LeftComputeResource' => ['description' => '剩余计算资源，单位ACU。', 'type' => 'integer', 'format' => 'int32', 'example' => '512'], + 'MinComputeResource' => ['description' => '最小计算预留资源，单位ACU。'."\n" + .'- 当GroupType为**Interactive**时，计算预留资源最小为16 ACU。'."\n" + .'- 当GroupType为**Job**时，计算预留资源最小为0 ACU。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'GroupName' => ['description' => '资源组名称。', 'type' => 'string', 'example' => 'test'], + 'GroupType' => ['description' => '资源组类型，取值：'."\n" + .'- **Interactive**'."\n" + .'- **Job**'."\n" + .'> 关于湖仓版资源组的详细信息，请参见[资源组介绍](~~428610~~)。', 'type' => 'string', 'example' => 'Job'], + 'Available' => ['description' => '资源组是否可用。取值说明：'."\n" + .'- **True**：可用。'."\n" + .'- **False**：不可用。', 'type' => 'boolean', 'example' => 'True'], ], ], ], ], ], + 'Success' => ['description' => '请求是否成功。取值说明：'."\n" + .'- **True**：成功。'."\n" + .'- **False**：失败。', 'type' => 'boolean', 'example' => 'True'], ], ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 'title' => '查询资源组信息', + 'summary' => '获取数据同步时所用资源组的详细信息。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2024-04-10T07:29:36.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-05-09T09:42:58.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-08-08T07:26:35.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsResourceGroups'], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsResourceGroups', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"300\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"CE17270B-F8F8-5A31-9DB4-DADDFDAD7940\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"FreeBackupSize\\": 0,\\n \\"TotalBackupSize\\": 64953700,\\n \\"Items\\": {\\n \\"Backup\\": [\\n {\\n \\"DBClusterId\\": \\"am-bp11q28kvl688****\\",\\n \\"BackupType\\": \\"FullBackup\\",\\n \\"BackupStartTime\\": \\"2022-06-01T16:00Z\\",\\n \\"BackupSize\\": 2167808,\\n \\"BackupEndTime\\": \\"2022-06-02T16:00Z\\",\\n \\"BackupExpiredTime\\": \\"2022-07-02T16:00Z\\\\n\\",\\n \\"BackupId\\": \\"32732****\\",\\n \\"BackupMethod\\": \\"Snapshot\\",\\n \\"BackupRegion\\": \\"cn-hangzhou\\",\\n \\"ParentBackupId\\": \\"32733****\\",\\n \\"BackupStatus\\": \\"Finished\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '查询备份集列表', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"6FC370D7-1D4C-5A8E-805E-F73366382C66\\",\\n \\"Message\\": \\"Success\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": {\\n \\"Step\\": 8,\\n \\"ResourceGroups\\": [\\n {\\n \\"CuOptions\\": [\\n 0\\n ],\\n \\"MaxComputeResource\\": 512,\\n \\"LeftComputeResource\\": 512,\\n \\"MinComputeResource\\": 0,\\n \\"GroupName\\": \\"test\\",\\n \\"GroupType\\": \\"Job\\",\\n \\"Available\\": true\\n }\\n ]\\n },\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"<DescribeApsResourceGroupsResponse>\\n <RequestId>6FC370D7-1D4C-5A8E-805E-F73366382C66</RequestId>\\n <Message>Success</Message>\\n <HttpStatusCode>200</HttpStatusCode>\\n <Data>\\n <Step>8</Step>\\n <ResourceGroups>\\n <MaxComputeResource>512</MaxComputeResource>\\n <MinComputeResource>0</MinComputeResource>\\n <GroupName>test</GroupName>\\n <GroupType>Job</GroupType>\\n <Available>true</Available>\\n </ResourceGroups>\\n </Data>\\n <Success>true</Success>\\n</DescribeApsResourceGroupsResponse>","errorExample":""}]', ], - 'CreateBackup' => [ - 'summary' => '立即创建一个备份集。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'DescribeAuditLogRecords' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'list', 'riskType' => 'none', - 'chargeType' => 'paid', - 'abilityTreeCode' => '246050', - 'abilityTreeNodes' => [ - 'FEATUREadsM6VDCK', - ], + 'chargeType' => 'free', + 'abilityTreeCode' => '132363', + 'abilityTreeNodes' => ['FEATUREadsGAMOR7'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz9or2xawpnc****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-t4nj8619bz2w3****'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '实例所在Region ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看集群的地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => ['description' => '查询开始时间，UTC时间，格式为：yyyy-MM-ddTHH:mmZ。'."\n" + .'> 仅当SQL审计状态为开启时，才能查询到SQL审计日志，且只支持查询30天内的SQL审计日志。如果中途关闭了SQL审计，再次打开时，仅能查询到再次打开后的SQL审计日志。'."\n", 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2022-08-12T04:17Z'], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => '查询结束时间，UTC时间，格式为：yyyy-MM-ddTHH:mmZ。'."\n" + .'> - 查询结束时间需晚于查询开始时间。'."\n" + .'> - 查询开始时间与查询结束时间的间隔不能超过24小时。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2022-08-12T17:08Z'], + ], + [ + 'name' => 'DBName', + 'in' => 'query', + 'schema' => ['description' => '执行目标SQL的数据库名称。', 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], + ], + [ + 'name' => 'QueryKeyword', + 'in' => 'query', + 'schema' => ['description' => '可设置一个字符串类型的值，使用该值作为关键词对返回结果进行搜索。', 'type' => 'string', 'required' => false, 'example' => 'adb'], + ], + [ + 'name' => 'SqlType', + 'in' => 'query', + 'schema' => ['description' => 'SQL类型，取值：'."\n" + .'- **DELETE**'."\n" + .'- **SELECT**'."\n" + .'- **UPDATE**'."\n" + .'- **INSERT INTO SELECT**'."\n" + .'- **ALTER**'."\n" + .'- **DROP**'."\n" + .'- **CREATE**'."\n" + ."\n" + .'> 每次仅允许传入一种类型查询，若该参数为空，默认查询所有类型。', 'type' => 'string', 'required' => false, 'example' => 'SELECT'], + ], + [ + 'name' => 'Succeed', + 'in' => 'query', + 'schema' => ['description' => '目标SQL是否执行成功，取值说明：'."\n" + .'* **true**：执行成功。'."\n" + .'* **false**：执行失败。', 'type' => 'string', 'required' => false, 'example' => 'true'], + ], + [ + 'name' => 'HostAddress', + 'in' => 'query', + 'schema' => ['description' => '执行目标SQL的客户端IP地址和端口号。', 'type' => 'string', 'required' => false, 'example' => '100.104.XX.XX:43908'], + ], + [ + 'name' => 'OrderType', + 'in' => 'query', + 'schema' => ['description' => '按SQL执行时间进行正序或倒序排序，取值说明：'."\n" + .'* **asc**：正序。'."\n" + .'* **desc**：倒序。', 'type' => 'string', 'required' => false, 'example' => 'asc'], + ], + [ + 'name' => 'User', + 'in' => 'query', + 'schema' => ['description' => '执行目标SQL的用户名。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + [ + 'name' => 'Order', + 'in' => 'query', + 'schema' => ['description' => '根据指定字段进行排序，格式为JSON，是一个有序JSON数组，按输入数组的顺序进行复合排序，包含`Field`和`Type`两个字段，例如`[{"Field":"ExecutionStartTime","Type":"Desc"},{"Field":"ScanRows","Type":"Asc"}]`。其中：'."\n" + .'* `Field`表示需要排序的字段名，支持如下取值：'."\n" + .' * **HostAddress**：连接数据库的客户端地址。'."\n" + .' * **UserName**：用户名。'."\n" + .' * **ExecutionStartTime**：目标SQL的执行开始时间。'."\n" + .' * **QueryTime**：目标SQL执行时长。'."\n" + .' * **PeakMemoryUsage**：执行目标SQL语句时的峰值内存。'."\n" + .' * **ScanRows**：带数据源的任务的扫描数据行数。'."\n" + .' * **ScanSize**：扫描的数据量。'."\n" + .' * **ScanTime**：扫描数据总耗时。'."\n" + .' * **PlanningTime**：执行计划生成耗时。'."\n" + .' * **WallTime**：查询中的所有算子在各个节点CPU Time的累加值。'."\n" + .' * **ProcessID**：进程ID。'."\n" + ."\n" + .'* `Type`表示排序类型，支持如下取值：'."\n" + .' * **Desc**：降序。'."\n" + .' * **Asc**：升序。', 'type' => 'string', 'required' => false, 'example' => '[{"Field":"ExecuteTime","Type":"Desc"},{"Field":"HostAddress","Type":"Asc"}]'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数，取值：'."\n" + .'- **10**（默认值）'."\n" + .'- **30**'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '10', 'example' => '10', 'default' => '10'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1'], + ], + [ + 'name' => 'ProxyUser', + 'in' => 'query', + 'schema' => ['description' => '预留参数。', 'type' => 'string', 'required' => false, 'example' => '无'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '列表详情。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => '421794A3-72A5-5D27-9E8B-A75A4C50****', + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '6974'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'string', 'example' => '10'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '8A564B7F-8C00-43C0-8EC5-919FBB70573'], + 'PageNumber' => ['description' => '页码。', 'type' => 'string', 'example' => '1'], + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-t4nj8619bz2w3****'], + 'Items' => [ + 'description' => '列表。', + 'type' => 'array', + 'items' => [ + 'description' => 'SQL记录列表。', + 'type' => 'object', + 'properties' => [ + 'HostAddress' => ['description' => '执行目标SQL的客户端IP地址和端口号。', 'type' => 'string', 'example' => '100.104.XX.XX:43908'], + 'Succeed' => ['description' => '目标SQL是否执行成功。取值说明：'."\n" + .'- **true**：执行成功。'."\n" + .'- **false**：执行失败。', 'type' => 'string', 'example' => 'true'], + 'SQLText' => ['description' => 'SQL语句详情。', 'type' => 'string', 'example' => 'SELECT * FROM adb_hdfs_import_source'], + 'TotalTime' => ['description' => '目标SQL的执行时长，单位：毫秒（ms）。', 'type' => 'string', 'example' => '216'], + 'ConnId' => ['description' => '通信ID。', 'type' => 'string', 'example' => '14356****'], + 'DBName' => ['description' => '执行目标SQL的数据库名称。', 'type' => 'string', 'example' => 'adb_demo'], + 'SQLType' => ['description' => '目标SQL的类型。', 'type' => 'string', 'example' => 'SELECT'], + 'ExecuteTime' => ['description' => '目标SQL的执行开始时间，本地时间，格式为：yyyy-MM-dd HH:mm:ss。', 'type' => 'string', 'example' => '2022-08-12 10:10:00'], + 'ExecuteTimestamp' => ['description' => '目标 SQL 的执行开始时间，毫秒时间戳。', 'type' => 'integer', 'format' => 'int64', 'example' => '1774600396584'], + 'ProcessID' => ['description' => '任务ID。', 'type' => 'string', 'example' => '202106081752021720161662490345362390'], + 'User' => ['description' => '执行目标SQL的用户名。', 'type' => 'string', 'example' => 'test'], + 'HasDiagnosticInfo' => [ + 'description' => '是否包含诊断信息。', + 'type' => 'boolean', + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], + 'example' => 'true', + ], + ], + ], ], ], ], ], ], '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' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'staticInfo' => ['returnType' => 'synchronous'], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'title' => '查询SQL审计日志', + 'summary' => '查询集群的SQL审计日志。', + 'description' => '- 仅当SQL审计状态为开启时，才能查询到SQL审计日志，且只支持查询30天内的SQL审计日志。如果中途关闭了SQL审计，再次打开时，仅能查询到再次打开后的SQL审计日志。SQL审计日志不记录**INSERT INTO VALUES**、**REPLACE INTO VALUES**和**UPSERT INTO VALUES**操作。'."\n" + .'- 当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2025-10-27T07:49:15.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-12-08T02:33:56.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-22T04:03:32.000Z', 'description' => 'OpenAPI 下线'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"421794A3-72A5-5D27-9E8B-A75A4C50****\\"\\n}","type":"json"}]', - 'title' => '立即创建一个临时备份', - 'description' => '**请确保在使用该接口前，已充分了解云原生数据仓库ADB MySQL产品的收费方式和[价格](https://www.aliyun.com/price/product#/ads/detail/ads_pre'."\n" - .')。** 临时备份与常规备份，在价格、备份集的保留周期上是一致的。', - ], - 'DeleteBackups' => [ - 'summary' => '手动删除备份集。', - 'methods' => [ - 'post', - 'get', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAuditLogRecords'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAuditLogRecords', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": \\"6974\\",\\n \\"PageSize\\": \\"10\\",\\n \\"RequestId\\": \\"8A564B7F-8C00-43C0-8EC5-919FBB70573\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"DBClusterId\\": \\"amv-t4nj8619bz2w3****\\",\\n \\"Items\\": [\\n {\\n \\"HostAddress\\": \\"100.104.XX.XX:43908\\",\\n \\"Succeed\\": \\"true\\",\\n \\"SQLText\\": \\"SELECT * FROM adb_hdfs_import_source\\",\\n \\"TotalTime\\": \\"216\\",\\n \\"ConnId\\": \\"14356****\\",\\n \\"DBName\\": \\"adb_demo\\",\\n \\"SQLType\\": \\"SELECT\\",\\n \\"ExecuteTime\\": \\"2022-08-12 10:10:00\\",\\n \\"ExecuteTimestamp\\": 1774600396584,\\n \\"ProcessID\\": \\"202106081752021720161662490345362390\\",\\n \\"User\\": \\"test\\",\\n \\"HasDiagnosticInfo\\": true\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeAuditLogRecordsResponse>\\n <TotalCount>6974</TotalCount>\\n <PageSize>10</PageSize>\\n <RequestId>8A564B7F-8C00-43C0-8EC5-919FBB70573</RequestId>\\n <PageNumber>1</PageNumber>\\n <DBClusterId>amv-t4nj8619bz2w3****</DBClusterId>\\n <Items>\\n <HostAddress>100.104.XX.XX:43908</HostAddress>\\n <Succeed>true</Succeed>\\n <SQLText>SELECT * FROM adb_hdfs_import_source</SQLText>\\n <TotalTime>216</TotalTime>\\n <ConnId>14356****</ConnId>\\n <DBName>adb_demo</DBName>\\n <SQLType>SELECT</SQLType>\\n <ExecuteTime>2022-08-12 10:10:00</ExecuteTime>\\n <ProcessID>202106081752021720161662490345362390</ProcessID>\\n <User>test</User>\\n </Items>\\n</DescribeAuditLogRecordsResponse>","errorExample":""}]', + ], + 'DescribeAutoRenewalAttribute' => [ + 'summary' => '查询包年包月集群自动续费状态。', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', - 'riskType' => 'high', - 'chargeType' => 'paid', - 'abilityTreeCode' => '246050', - 'abilityTreeNodes' => [ - 'FEATUREadsM6VDCK', - ], - 'tenantRelevance' => 'tenant', + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '10788', + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], ], 'parameters' => [ [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], + ], + [ 'name' => 'DBClusterId', 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => 'AnalyticDB for MySQL集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-uf6g8w25jacm7****', + 'description' => '集群 ID列表。', + 'type' => 'array', + 'items' => ['description' => '集群ID。', 'type' => 'string', 'required' => false, 'example' => 'am-bp1u8c0mgfg58****'], + 'required' => false, ], ], [ - 'name' => 'BackupIds', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '待删除的备份集ID，多个备份集ID以英文逗号（,）分隔。', - 'type' => 'string', - 'required' => true, - 'example' => '763,764', - ], + 'schema' => ['description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', 'default' => '30'], ], [ - 'name' => 'RegionId', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '页码，取值为大于0且不超过Integer数据类型最大值的正整数。默认值为**1**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', 'default' => '1'], + ], + [ + 'name' => 'ResourceGroupId', + 'in' => 'query', + 'schema' => ['description' => '资源组ID。', 'type' => 'string', 'required' => false, 'example' => 'rg-4690g37929****'], ], ], 'responses' => [ 200 => [ + 'headers' => [], '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' => '771C5FAA-530F-52F7-B84D-EBAD4561D590', + 'TotalRecordCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + 'PageRecordCount' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'BA0F6761-7A8C-59F8-9624-FB56788C0EDF'], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'Items' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'AutoRenewalAttribute' => [ + 'description' => '自动续费详情列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-uf6485635fz8****'], + 'AutoRenewalPeriodUnit' => ['description' => '自动续费时长的单位，取值说明：'."\n" + ."\n" + .'- **Year**：年。'."\n" + .'- **Month**：月。', 'type' => 'string', 'example' => 'Year'], + 'AutoRenewalPeriod' => ['description' => '自动续费时长。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'AutoRenewalStatus' => ['description' => '自动续费状态，取值说明：'."\n" + ."\n" + .'- **AutoRenewal**：自动续费。'."\n" + .'- **Normal**：手动续费，集群到期前通过短信提醒。'."\n" + .'- **NotRenewal**：到期不续费，集群到期前无提醒，只在到期前第三天发送不续费提醒。', 'type' => 'string', 'example' => 'AutoRenewal'], + 'AutoRenewalEnabled' => ['description' => '是否开启自动续费，取值说明：'."\n" + ."\n" + .'- **true**：开启。'."\n" + .'- **false**：关闭。', 'type' => 'boolean', 'example' => 'true'], + 'RegionId' => ['description' => '地域ID。', 'type' => 'string', 'example' => 'cn-shenzhen'], + ], + 'description' => '', + ], + ], + ], + 'description' => '', ], ], + 'description' => '', ], ], ], - '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.', - ], + 'title' => '查询包年包月集群自动续费状态', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAutoRenewalAttribute'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeAutoRenewalAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"771C5FAA-530F-52F7-B84D-EBAD4561D590\\"\\n}","type":"json"}]', - 'title' => '删除备份集', - 'description' => '- 单次最大允许删除100个备份集。如果要删超过100个备份集，请分2次调用。'."\n" - .'- 为保证数据安全性，系统会强制保留1个有效备份集。当要删除仅有的备份集时，接口会禁止。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalRecordCount\\": 20,\\n \\"PageRecordCount\\": 30,\\n \\"RequestId\\": \\"BA0F6761-7A8C-59F8-9624-FB56788C0EDF\\",\\n \\"PageNumber\\": 1,\\n \\"Items\\": {\\n \\"AutoRenewalAttribute\\": [\\n {\\n \\"DBClusterId\\": \\"amv-uf6485635fz8****\\",\\n \\"AutoRenewalPeriodUnit\\": \\"Year\\",\\n \\"AutoRenewalPeriod\\": 1,\\n \\"AutoRenewalStatus\\": \\"AutoRenewal\\",\\n \\"AutoRenewalEnabled\\": true,\\n \\"RegionId\\": \\"cn-shenzhen\\"\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'DescribeHistoryTasks' => [ - 'summary' => '获取历史任务记录。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'DescribeAvailableAdvices' => [ + 'summary' => '用DescribeAvailableAdvices来显示可用优化建议。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -13347,708 +9290,408 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '254755', - 'abilityTreeNodes' => [ - 'FEATUREads12ZDDA', - ], + 'abilityTreeCode' => '193677', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'allowEmptyValue' => false, - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-beijing', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值：10~100。默认值：10。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '10', - 'example' => '10', - 'default' => '10', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '查询结果的页码。取值范围：正整数。 默认值：1。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], - ], - [ - 'name' => 'InstanceType', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '实例类型，当前固定为 Instance。', - 'type' => 'string', - 'required' => false, - 'example' => 'Instance', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-bp198m028ih55****'], ], [ - 'name' => 'Status', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '任务状态，取值说明：'."\n" - ."\n" - .'- **Scheduled**：等待执行。'."\n" - ."\n" - .'- **Running**：执行中。'."\n" - ."\n" - .'- **Succeed**：执行成功。'."\n" - ."\n" - .'- **Failed**：执行失败。'."\n" - ."\n" - .'- **Cancelling**：正在终止。'."\n" - ."\n" - .'- **Canceled**：已终止。'."\n" - ."\n" - .'- **Waiting**：等待预设时间。'."\n" - ."\n" - .'如需查询多个状态则用英文逗号分隔，默认为空，表示全选。', - 'type' => 'string', - 'required' => false, - 'example' => 'Scheduled', - ], + 'schema' => ['title' => 'RegionId', 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'InstanceId', + 'name' => 'AdviceDate', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。多个集群ID用英文逗号（,）分隔。最多填写30个集群ID。若不填写，则默认查询该地域下所有集群的历史任务。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-********', - ], + 'schema' => ['title' => 'AdviceDate', 'description' => '建议的生成日期，格式为yyyyMMdd。'."\n" + ."\n" + .'> 数据是每天凌晨分析后生成，因此要填T-1以上的时间才查询得到数据。譬如当前是20240627，那么应该传20240626或者更早的时间。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'docRequired' => true, 'example' => '20221124'], ], [ - 'name' => 'TaskId', + 'name' => 'Lang', 'in' => 'query', - 'schema' => [ - 'description' => '任务ID。多个任务ID用英文逗号（,）分隔。最多填写30个任务ID。若不填写，则默认查询所有集群的历史任务。', - 'type' => 'string', - 'required' => false, - 'example' => 't-83br18hloy3faf****', - ], + 'schema' => ['title' => 'Lang', 'description' => '设置建议的显示语言，取值说明：'."\n" + .'- **zh**：简体中文（默认语言）。'."\n" + .'- **en**：英文。'."\n" + .'- **ja**：日文。'."\n" + .'- **zh-tw**：繁体中文。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'zh', 'default' => 'zh'], ], [ - 'name' => 'TaskType', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '任务类型，用于查询特定类型任务情况，如有多个用英文逗号（,）分隔，最多支持 30 个，默认为空，表示不限制。', - 'type' => 'string', - 'required' => false, - 'example' => 'autotest_dispatch_cases', - ], + 'schema' => ['title' => 'PageSize', 'description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'docRequired' => true, 'example' => '30', 'default' => '100'], ], [ - 'name' => 'FromStartTime', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '任务开始时间的起始时间，表示查询任务开始时间在此时间之后的任务。按照 ISO8601 标准表示，并需要使用 UTC +0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。最早支持 30 天前，距当前时间超过 30 天会自动转换成 30 天前。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2022-01-02T11:31:03Z', - ], + 'schema' => ['title' => 'PageNumber', 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'docRequired' => true, 'example' => '1', 'default' => '1'], ], [ - 'name' => 'ToStartTime', + 'name' => 'AdviceType', 'in' => 'query', - 'schema' => [ - 'description' => '任务开始时间的结束时间，表示查询任务开始时间在此时间之前的任务。按照 ISO8601 标准表示，并需要使用 UTC +0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2022-03-02T11:31:03Z', - ], + 'schema' => ['description' => '建议的类型，取值说明：'."\n" + .'- **INDEX**：索引优化。'."\n" + .'- **TIERING**：冷热数据优化。', 'type' => 'string', 'required' => false, 'example' => 'INDEX'], ], [ - 'name' => 'FromExecTime', + 'name' => 'Keyword', 'in' => 'query', - 'schema' => [ - 'description' => '任务执行耗时的最小值。用于筛选任务执行耗时大于此时间的任务，单位秒。默认 0，表示不限制。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '0', - ], + 'schema' => ['description' => '查询关键字，支持根据表名模糊搜索。', 'type' => 'string', 'required' => false, 'example' => 'you_table_name'], ], [ - 'name' => 'ToExecTime', + 'name' => 'SchemaTableName', 'in' => 'query', - 'schema' => [ - 'description' => '任务执行耗时的最大值。用于筛选任务执行耗时不小于此时间的任务，单位秒。默认 0，表示不限制。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '0', - ], + 'schema' => ['description' => '数据库名和表名的字符串拼接。', 'type' => 'string', 'required' => false, 'example' => 'tpch.lineitem'], ], [ - 'name' => 'ResourceGroupId', + 'name' => 'Order', 'in' => 'query', - 'schema' => [ - 'description' => '资源组 ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'rg-ae****', - ], + 'schema' => ['description' => '将查询结果按指定字段进行排序。格式为JSON字符串，例如`[{"Field":"SchemaName","Type":"Asc"}]`。其中：'."\n" + .'- `Field`表示排序字段。支持如下取值：'."\n" + .' - `SchemaName`：数据库名。'."\n" + .' - `TableName`：表名。'."\n" + .' - `Benefit`：预期优化收益。'."\n" + .'- `Type`表示排序方式。支持如下取值：'."\n" + .' - `Asc`：升序排序。'."\n" + .' - `Desc`： 降序排序。'."\n" + ."\n" + .'> 若不设置参数，默认按照”预期优化收益“降序排列。', 'type' => 'string', 'required' => false, 'example' => '[{\\"Field\\":\\"AdviceType\\",\\"Type\\":\\"Desc\\"}]'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '返回对象。', 'type' => 'object', 'properties' => [ - 'PageNumber' => [ - 'description' => '查询结果的页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'E51713A3-BB45-5616-AB15-170B704F8F01', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'TotalCount' => [ - 'description' => '总记录条数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '100', - ], 'Items' => [ - 'description' => '任务列表。', + 'title' => 'Items', + 'description' => '详情。', 'type' => 'array', 'items' => [ - 'description' => '任务对象。', + 'description' => '建议列表。', 'type' => 'object', 'properties' => [ - 'Status' => [ - 'description' => '任务状态。'."\n" - ."\n" - .'- **Scheduled**：等待执行。'."\n" - ."\n" - .'- **Running**：执行中。'."\n" - ."\n" - .'- **Succeed**：执行成功。'."\n" - ."\n" - .'- **Failed**：执行失败。'."\n" - ."\n" - .'- **Cancelling**：正在终止。'."\n" - ."\n" - .'- **Canceled**：已终止。'."\n" - ."\n" - .'- **Waiting**：等待预设时间。', - 'type' => 'string', - 'example' => 'Running', - ], - 'TaskId' => [ - 'description' => '任务 ID。', - 'type' => 'string', - 'example' => 't-83br18hloy3faf****', - ], - 'CurrentStepName' => [ - 'description' => '当前执行的步骤名，如果为空代表任务未开始。', - 'type' => 'string', - 'example' => 'exec_task', - ], - 'StartTime' => [ - 'description' => '任务开始时间。', - 'type' => 'string', - 'example' => '2022-02-03T11:31:03Z', - ], - 'EndTime' => [ - 'description' => '任务结束时间。', - 'type' => 'string', - 'example' => '2022-02-03T12:06:17Z', - ], - 'TaskType' => [ - 'description' => '任务类型。', - 'type' => 'string', - 'example' => 'autotest_dispatch_cases', - ], - 'RemainTime' => [ - 'description' => '预估剩余执行时间，单位为秒（s）。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1000', - ], - 'Progress' => [ - 'description' => '当前进度。', - 'type' => 'number', - 'format' => 'float', - 'example' => '79.0', - ], - 'RegionId' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'InstanceType' => [ - 'description' => '实例类型。', - 'type' => 'string', - 'example' => 'Instance', - ], - 'InstanceId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-********', - ], - 'InstanceName' => [ - 'description' => '实例名。', - 'type' => 'string', - 'example' => 'test', - ], - 'DbType' => [ - 'description' => '数据库类型。', - 'type' => 'string', - 'example' => 'analyticdb', - ], - 'Product' => [ - 'description' => '产品。', - 'type' => 'string', - 'example' => 'ads', - 'default' => 'ADB', - ], - 'TaskDetail' => [ - 'description' => '任务详情。', - 'type' => 'string', - 'example' => '{\\"callerUid\\":\\"test\\"}', - ], - 'ActionInfo' => [ - 'description' => '允许的操作信息，具体使用时是根据 currentStepName+status 在此信息中匹配操作 Action，如果未匹配到 Action，代表任务当前状态不支持操作。', - 'type' => 'string', - 'example' => '{\\"steps\\":[{\\"action_info\\":{\\"Waiting\\":[\\"modifySwitchTime\\"]},\\"step_name\\":\\"exec_task\\"}]}', - ], - 'Uid' => [ - 'description' => '资源所属用户 ID。', - 'type' => 'string', - 'example' => '141345906006****', - ], - 'CallerSource' => [ - 'description' => '请求用户 ID，callerSource 为 User 时代表用户 UID。', - 'type' => 'string', - 'example' => '141345906006****', - ], - 'CallerUid' => [ - 'description' => '请求来源，取值说明：'."\n" - ."\n" - .'- **System**：系统。'."\n" - ."\n" - .'- **User**：用户。', - 'type' => 'string', - 'example' => 'User', - ], - 'ReasonCode' => [ - 'description' => '当前任务发起的原因。', - 'type' => 'string', - 'example' => 'test', - ], + 'AdviceId' => ['title' => 'AdviceId', 'description' => '建议ID。', 'type' => 'string', 'example' => 'dcd04135-0925-4aed-a5a7-e7d92cb1****'], + 'AdviceDate' => ['title' => 'AdviceDate', 'description' => '建议生成的时间，格式：yyyyMMdd。', 'type' => 'string', 'example' => '20221124'], + 'AdviceType' => ['title' => 'AdviceType', 'description' => '建议的类型，取值说明：'."\n" + .'- **INDEX**：索引优化。'."\n" + .'- **TIERING**：冷热数据优化。', 'type' => 'string', 'example' => 'INDEX'], + 'SQL' => ['title' => 'SQL', 'description' => '应用建议的SQL语句。', 'type' => 'string', 'example' => 'alter table `schema1`.`table1` drop key col1_1_idx'], + 'Reason' => ['title' => 'Reason', 'description' => '生成优化建议的原因。', 'type' => 'string', 'example' => '15天未使用，历史使用统计概率小于1%'], + 'Benefit' => ['title' => 'Benefit', 'description' => '建议的收益。', 'type' => 'string', 'example' => '节省0.4 GB的存储空间。'], + 'TotalCount' => ['title' => 'TotalCount', 'description' => '返回的结果总数，取值为：大于等于0且不超过Integer数据类型的最大值，默认值为0。', 'type' => 'integer', 'format' => 'int64', 'example' => '10192'], + 'PageSize' => ['title' => 'PageSize', 'description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'PageNumber' => ['title' => 'PageNumber', 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'SchemaName' => ['description' => '数据库名。', 'type' => 'string', 'example' => 'adb_demo'], + 'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'test_table'], + 'IndexFields' => ['description' => '索引字段。', 'type' => 'string', 'example' => 'message'], ], ], ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP状态码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段。', - 'type' => 'object', - 'properties' => [ - 'AuthAction' => [ - 'description' => '鉴权Action。', - 'type' => 'string', - 'example' => 'test', - ], - 'AuthPrincipalDisplayName' => [ - 'description' => '授权主体显示名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'AuthPrincipalOwnerId' => [ - 'description' => '鉴权主体的主账号ID。', - 'type' => 'string', - 'example' => '141345906006****', - ], - 'AuthPrincipalType' => [ - 'description' => '授权主体类型。', - 'type' => 'string', - 'example' => 'test', - ], - 'EncodedDiagnosticMessage' => [ - 'description' => '编码诊断信息。', - 'type' => 'string', - 'example' => 'AQFmy+hZZsvoWTQ2NTJFQUFBLUIyNjktMzk5NS05MEZCLUMxMzgwNDUwMDA2Ng==', - ], - 'NoPermissionType' => [ - 'description' => '权限策略拒绝的类型，取值如下：'."\n" - .'- **ImplicitDeny**：资源持有者未配置相关权限策略给当前用户，缺省拒绝未授权的操作。'."\n" - .'- **ExplicitDeny**：资源持有者配置的RAM策略明确拒绝了当前用户访问对应的资源。', - 'type' => 'string', - 'example' => 'ImplicitDeny', - ], - 'PolicyType' => [ - 'description' => '引起无权限的策略类型，取值如下:'."\n" - .'- **ControlPolicy** ：管控策略。'."\n" - .'- **SessionPolicy**：临时Token额外添加的一个权限策略。'."\n" - .'- **AssumeRolePolicy**：RAM角色的授信策略。'."\n" - .'- **AccountLevelIdentityBasedPolicy**：账号授权范围的主体策略，包含自定义策略和系统策略。'."\n" - .'- **ResourceGroupLevelIdentityBasedPolicy**：资源组授权范围的主体策略，包含自定义策略和系统策略。', - 'type' => 'string', - 'example' => 'ControlPolicy', - ], - ], + 'PageNumber' => ['title' => 'PageNumber', 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['title' => 'PageSize', 'description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '96A55627-28E9-5E47-B8F6-D786BE551349'], + 'TotalCount' => ['description' => '返回的结果总数，取值为：大于等于0且不超过Integer数据类型的最大值，默认值为0。', 'type' => 'integer', 'format' => 'int64', 'example' => '10192'], + 'SchemaTableNames' => [ + 'description' => '数据库名和表名的字符串拼接。', + 'type' => 'array', + 'items' => ['description' => '数据库名和表名的字符串拼接。', 'type' => 'string', 'example' => '['."\n" + .' "tpch.lineitem",'."\n" + .' "tpch.partsupp",'."\n" + .' "tpch.orders"'."\n" + .']'], ], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'MissingParameter.PageSize', 'errorMessage' => 'The PageSize parameter is required.', 'description' => '缺少PageSize参数'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PageNumber\\": 1,\\n \\"RequestId\\": \\"E51713A3-BB45-5616-AB15-170B704F8F01\\",\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 100,\\n \\"Items\\": [\\n {\\n \\"Status\\": \\"Running\\",\\n \\"TaskId\\": \\"t-83br18hloy3faf****\\",\\n \\"CurrentStepName\\": \\"exec_task\\",\\n \\"StartTime\\": \\"2022-02-03T11:31:03Z\\",\\n \\"EndTime\\": \\"2022-02-03T12:06:17Z\\",\\n \\"TaskType\\": \\"autotest_dispatch_cases\\",\\n \\"RemainTime\\": 1000,\\n \\"Progress\\": 79,\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"InstanceType\\": \\"Instance\\",\\n \\"InstanceId\\": \\"amv-********\\",\\n \\"InstanceName\\": \\"test\\",\\n \\"DbType\\": \\"analyticdb\\",\\n \\"Product\\": \\"ads\\",\\n \\"TaskDetail\\": \\"{\\\\\\\\\\\\\\"callerUid\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"test\\\\\\\\\\\\\\"}\\",\\n \\"ActionInfo\\": \\"{\\\\\\\\\\\\\\"steps\\\\\\\\\\\\\\":[{\\\\\\\\\\\\\\"action_info\\\\\\\\\\\\\\":{\\\\\\\\\\\\\\"Waiting\\\\\\\\\\\\\\":[\\\\\\\\\\\\\\"modifySwitchTime\\\\\\\\\\\\\\"]},\\\\\\\\\\\\\\"step_name\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"exec_task\\\\\\\\\\\\\\"}]}\\",\\n \\"Uid\\": \\"141345906006****\\",\\n \\"CallerSource\\": \\"141345906006****\\",\\n \\"CallerUid\\": \\"User\\",\\n \\"ReasonCode\\": \\"test\\"\\n }\\n ],\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Success\\",\\n \\"AccessDeniedDetail\\": {\\n \\"AuthAction\\": \\"test\\",\\n \\"AuthPrincipalDisplayName\\": \\"test\\",\\n \\"AuthPrincipalOwnerId\\": \\"141345906006****\\",\\n \\"AuthPrincipalType\\": \\"test\\",\\n \\"EncodedDiagnosticMessage\\": \\"AQFmy+hZZsvoWTQ2NTJFQUFBLUIyNjktMzk5NS05MEZCLUMxMzgwNDUwMDA2Ng==\\",\\n \\"NoPermissionType\\": \\"ImplicitDeny\\",\\n \\"PolicyType\\": \\"ControlPolicy\\"\\n }\\n}","type":"json"}]', - 'title' => '查询历史运维任务', - 'description' => '仅支持查看30天内的任务。', - ], - 'DescribeHistoryTasksStat' => [ - 'summary' => '任务中心任务统计。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '显示可用优化建议', + 'changeSet' => [ + ['createdAt' => '2025-07-09T06:38:11.000Z', 'description' => '响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAvailableAdvices'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeAvailableAdvices', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Items\\": [\\n {\\n \\"AdviceId\\": \\"dcd04135-0925-4aed-a5a7-e7d92cb1****\\",\\n \\"AdviceDate\\": \\"20221124\\",\\n \\"AdviceType\\": \\"INDEX\\",\\n \\"SQL\\": \\"alter table `schema1`.`table1` drop key col1_1_idx\\",\\n \\"Reason\\": \\"15天未使用，历史使用统计概率小于1%\\",\\n \\"Benefit\\": \\"节省0.4 GB的存储空间。\\",\\n \\"TotalCount\\": 10192,\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"SchemaName\\": \\"adb_demo\\",\\n \\"TableName\\": \\"test_table\\",\\n \\"IndexFields\\": \\"message\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"96A55627-28E9-5E47-B8F6-D786BE551349\\",\\n \\"TotalCount\\": 10192,\\n \\"SchemaTableNames\\": [\\n \\"[\\\\n \\\\\\"tpch.lineitem\\\\\\",\\\\n \\\\\\"tpch.partsupp\\\\\\",\\\\n \\\\\\"tpch.orders\\\\\\"\\\\n]\\"\\n ]\\n}","type":"json"}]', + ], + 'DescribeBackupPolicy' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '254776', - 'abilityTreeNodes' => [ - 'FEATUREadsCORDM7', - ], + 'abilityTreeNodes' => ['FEATUREadsM6VDCK'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'allowEmptyValue' => false, + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-uf6s7oa710rbu0x3b'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-beijing', + 'type' => 'object', + 'properties' => [ + 'PreferredBackupPeriod' => ['description' => '数据备份周期，多个取值用英文逗号（,）隔开。取值：'."\n" + ."\n" + .'- Monday：周一；'."\n" + .'- Tuesday：周二；'."\n" + .'- Wednesday：周三；'."\n" + .'- Thursday：周四；'."\n" + .'- Friday：周五；'."\n" + .'- Saturday：周六；'."\n" + .'- Sunday：周日。', 'type' => 'string', 'example' => 'Wednesday,Saturday'], + 'LogBackupRetentionPeriod' => ['description' => '日志备份保留天数。', 'type' => 'integer', 'format' => 'int32', 'example' => '7'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'PreferredBackupTime' => ['description' => '数据备份时间，格式：HH:mmZ-HH:mmZ。', 'type' => 'string', 'example' => '15:00Z-16:00Z'], + 'EnableBackupLog' => ['description' => '是否开启日志（实时）备份。取值说明：'."\n" + .'- **Enable**：开启。'."\n" + .'- **Disable**：关闭。', 'type' => 'string', 'example' => 'true'], + 'BackupRetentionPeriod' => ['description' => '数据备份保留天数。', 'type' => 'integer', 'format' => 'int32', 'example' => '7'], + ], + 'description' => '', ], ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询集群自动备份策略', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'summary' => '查看集群备份设置', + 'changeSet' => [ + ['createdAt' => '2022-11-16T06:02:18.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeBackupPolicy'], + ], + ], + 'ramActions' => [ [ - 'name' => 'Status', - 'in' => 'query', - 'schema' => [ - 'description' => '任务状态，取值说明：'."\n" - ."\n" - .'- **Scheduled**：等待执行。'."\n" - ."\n" - .'- **Running**：执行中。'."\n" - ."\n" - .'- **Succeed**：执行成功。'."\n" - ."\n" - .'- **Failed**：执行失败。'."\n" - ."\n" - .'- **Cancelling**：正在终止。'."\n" - ."\n" - .'- **Canceled**：已终止。'."\n" - ."\n" - .'- **Waiting**：等待预设时间。'."\n" - ."\n" - .'如有多个状态则用英文逗号分隔，默认为空，表示全选。', - 'type' => 'string', - 'required' => false, - 'example' => 'Scheduled', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeBackupPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PreferredBackupPeriod\\": \\"Wednesday,Saturday\\",\\n \\"LogBackupRetentionPeriod\\": 7,\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PreferredBackupTime\\": \\"15:00Z-16:00Z\\",\\n \\"EnableBackupLog\\": \\"true\\",\\n \\"BackupRetentionPeriod\\": 7\\n}","type":"json"}]', + ], + 'DescribeBackups' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'InstanceId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-********', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '155193', + 'abilityTreeNodes' => ['FEATUREadsM6VDCK'], + ], + 'parameters' => [ [ - 'name' => 'TaskId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '任务 ID。', - 'type' => 'string', - 'required' => false, - 'example' => '1564657730', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-bp18934i73vb5****'], ], [ - 'name' => 'TaskType', + 'name' => 'BackupId', 'in' => 'query', - 'schema' => [ - 'description' => '任务类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'all', - ], + 'schema' => ['description' => '备份集ID。', 'type' => 'string', 'required' => false, 'example' => '1679758862'], ], [ - 'name' => 'FromStartTime', + 'name' => 'StartTime', 'in' => 'query', - 'allowEmptyValue' => false, - 'schema' => [ - 'description' => '查询开始时间。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2023-05-08T07:04:17Z', - ], + 'schema' => ['description' => '查询开始时间，格式：yyyy-MM-ddTHH:mmZ。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2011-06-01T16:00Z'], ], [ - 'name' => 'ToStartTime', + 'name' => 'EndTime', 'in' => 'query', - 'allowEmptyValue' => false, - 'schema' => [ - 'description' => '表示查询任务开始时间在此时间之前的任务。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2023-02-24T10:01:37Z', - ], + 'schema' => ['description' => '查询结束时间，需要大于查询开始时间，格式：yyyy-MM-ddTHH:mmZ。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2023-02-20T02:30Z'], ], [ - 'name' => 'FromExecTime', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '任务执行耗时的最小值，用于筛选任务执行耗时大于此时间的任务，单位秒。默认 0，表示不限制。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['description' => '每页记录数，取值：'."\n" + ."\n" + .'- 30；'."\n" + .'- 50；'."\n" + .'- 100'."\n" + ."\n" + .'默认值：30。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '30', 'example' => '30', 'default' => '30'], ], [ - 'name' => 'ToExecTime', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '任务执行耗时的最大值，用于筛选任务执行耗时不小于此时间的任务，单位秒。默认 0，表示不限制。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '10', - ], + 'schema' => ['description' => '页码，取值：大于0且不超过Integer数据类型最大值的正整数。默认值：1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1'], ], [ - 'name' => 'ResourceGroupId', + 'name' => 'Remote', 'in' => 'query', - 'schema' => [ - 'description' => '资源组 ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'rg-acfmy*****', - ], + 'schema' => ['description' => '是否仅查询跨地域备份。取值为true时，仅查询跨地域备份。取值为false时，仅查询本地备份。', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'default' => 'false'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '300'], + 'PageSize' => ['description' => '本页备份集个数。', 'type' => 'string', 'example' => '30'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'CE17270B-F8F8-5A31-9DB4-DADDFDAD7940'], + 'PageNumber' => ['description' => '页码。', 'type' => 'string', 'example' => '1'], + 'FreeBackupSize' => ['description' => '备份集免费大小，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'TotalBackupSize' => ['description' => '总备份集大小，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '64953700'], 'Items' => [ - 'description' => '任务信息列表。', - 'type' => 'array', - 'items' => [ - 'description' => '任务信息列表。', - 'type' => 'object', - 'properties' => [ - 'Status' => [ - 'description' => '任务状态。'."\n" - ."\n" - .'- **Scheduled**：等待执行。'."\n" - ."\n" - .'- **Running**：执行中。'."\n" - ."\n" - .'- **Succeed**：执行成功。'."\n" - ."\n" - .'- **Failed**：执行失败。'."\n" - ."\n" - .'- **Cancelling**：正在终止。'."\n" - ."\n" - .'- **Canceled**：已终止。'."\n" - ."\n" - .'- **Waiting**：等待预设时间。', - 'type' => 'string', - 'example' => 'Scheduled', - ], - 'TotalCount' => [ - 'description' => '任务总数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - ], - ], - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP状态码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - ."\n" - .'- 请求正常，返回OK。'."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'SUCCESS', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => '200', - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息。', 'type' => 'object', + 'itemNode' => true, 'properties' => [ - 'AuthAction' => [ - 'description' => '鉴权Action。', - 'type' => 'string', - 'example' => 'test', - ], - 'AuthPrincipalDisplayName' => [ - 'description' => '授权主体显示名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'AuthPrincipalOwnerId' => [ - 'description' => '鉴权主体的主账号ID。', - 'type' => 'string', - 'example' => '141345906006****', - ], - 'AuthPrincipalType' => [ - 'description' => '授权主体类型。', - 'type' => 'string', - 'example' => 'test', - ], - 'EncodedDiagnosticMessage' => [ - 'description' => '编码诊断信息。', - 'type' => 'string', - 'example' => 'test'."\n", - ], - 'NoPermissionType' => [ - 'description' => '权限策略拒绝的类型，取值如下：'."\n" - .'- **ImplicitDeny**：资源持有者未配置相关权限策略给当前用户，缺省拒绝未授权的操作。'."\n" - .'- **ExplicitDeny**：资源持有者配置的RAM策略明确拒绝了当前用户访问对应的资源。', - 'type' => 'string', - 'example' => 'ImplicitDeny', - ], - 'PolicyType' => [ - 'description' => '引起无权限的策略类型，取值如下:'."\n" - .'- **ControlPolicy** ：管控策略。'."\n" - .'- **SessionPolicy**：临时Token额外添加的一个权限策略。'."\n" - .'- **AssumeRolePolicy**：RAM角色的授信策略。'."\n" - .'- **AccountLevelIdentityBasedPolicy**：账号授权范围的主体策略，包含自定义策略和系统策略。'."\n" - .'- **ResourceGroupLevelIdentityBasedPolicy**：资源组授权范围的主体策略，包含自定义策略和系统策略。', - 'type' => 'string', - 'example' => 'ControlPolicy', + 'Backup' => [ + 'description' => '备份集列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'am-bp11q28kvl688****'], + 'BackupType' => ['description' => '备份类型。取值说明：'."\n" + .'- **FullBackup**：全量备份。'."\n" + .'- **IncrementalBackup**：增量备份。', 'type' => 'string', 'example' => 'FullBackup'], + 'BackupStartTime' => ['description' => '备份开始时间。', 'type' => 'string', 'example' => '2022-06-01T16:00Z'], + 'BackupSize' => ['description' => '备份文件大小，单位：Byte。', 'type' => 'integer', 'format' => 'int32', 'example' => '2167808'], + 'BackupEndTime' => ['description' => '备份结束时间。', 'type' => 'string', 'example' => '2022-06-02T16:00Z'], + 'BackupExpiredTime' => ['description' => '备份集过期时间。', 'type' => 'string', 'example' => '2022-07-02T16:00Z'."\n"], + 'BackupId' => ['description' => '备份集ID。', 'type' => 'string', 'example' => '32732****'], + 'BackupMethod' => ['description' => '备份方法。只支持快照备份（Snapshot）。', 'type' => 'string', 'example' => 'Snapshot'], + 'BackupRegion' => ['description' => '跨地域备份所在地域。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'ParentBackupId' => ['description' => '跨地域备份所关联的本地备份集ID', 'type' => 'string', 'example' => '32733****'], + 'BackupStatus' => ['description' => '备份的状态。取值如下：'."\n" + ."\n" + .'- Running：备份正在进行中。'."\n" + .'- Finished：备份已完成。', 'type' => 'string', 'example' => 'Finished'], + ], + 'description' => '', + ], ], ], + 'description' => '', ], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Items\\": [\\n {\\n \\"Status\\": \\"Scheduled\\",\\n \\"TotalCount\\": 20\\n }\\n ],\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"SUCCESS\\",\\n \\"Code\\": \\"200\\",\\n \\"AccessDeniedDetail\\": {\\n \\"AuthAction\\": \\"test\\",\\n \\"AuthPrincipalDisplayName\\": \\"test\\",\\n \\"AuthPrincipalOwnerId\\": \\"141345906006****\\",\\n \\"AuthPrincipalType\\": \\"test\\",\\n \\"EncodedDiagnosticMessage\\": \\"test\\\\n\\",\\n \\"NoPermissionType\\": \\"ImplicitDeny\\",\\n \\"PolicyType\\": \\"ControlPolicy\\"\\n }\\n}","type":"json"}]', - 'title' => '统计历史任务', - ], - 'DescribeExecutorDetection' => [ - 'summary' => '查看计算层诊断结果。', - 'methods' => [ - 'post', - 'get', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '查询备份集列表', + 'summary' => '查询实例备份集', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2025-09-11T07:17:53.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2025-05-26T01:44:44.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2024-10-12T14:49:46.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-11-16T06:02:18.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeBackups'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeBackups', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"300\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"CE17270B-F8F8-5A31-9DB4-DADDFDAD7940\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"FreeBackupSize\\": 0,\\n \\"TotalBackupSize\\": 64953700,\\n \\"Items\\": {\\n \\"Backup\\": [\\n {\\n \\"DBClusterId\\": \\"am-bp11q28kvl688****\\",\\n \\"BackupType\\": \\"FullBackup\\",\\n \\"BackupStartTime\\": \\"2022-06-01T16:00Z\\",\\n \\"BackupSize\\": 2167808,\\n \\"BackupEndTime\\": \\"2022-06-02T16:00Z\\",\\n \\"BackupExpiredTime\\": \\"2022-07-02T16:00Z\\\\n\\",\\n \\"BackupId\\": \\"32732****\\",\\n \\"BackupMethod\\": \\"Snapshot\\",\\n \\"BackupRegion\\": \\"cn-hangzhou\\",\\n \\"ParentBackupId\\": \\"32733****\\",\\n \\"BackupStatus\\": \\"Finished\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeBadSqlDetection' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'tags' => ['Perth'], 'security' => [ [ 'AK' => [], @@ -14060,10 +9703,8 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '194344', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '194347', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], 'autoTest' => true, 'tenantRelevance' => 'tenant', ], @@ -14071,60 +9712,31 @@ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-xxx', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-xxx'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-shenzhen', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-shanghai'], ], [ 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2024-10-31T02:06Z', - ], + 'schema' => ['description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2022-01-23T02:18Z'], ], [ 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => '结束时间。日期格式按照ISO8601表示法，并使用UTC时间，格式为yyyy-MM-ddTHH:mmZ。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2021-05-27T16:00Z', - ], + 'schema' => ['description' => '查询结束时间，需晚于查询开始时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2024-11-17T02:16Z'], ], [ 'name' => 'Lang', 'in' => 'query', - 'schema' => [ - 'description' => '语言配置，取值说明：'."\n" - .'- **zh**：简体中文（默认语言）。'."\n" - .'- **en**：英文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', - ], + 'schema' => ['description' => '语言配置，取值说明：'."\n" + .'- **zh**：简体中文（默认语言）。'."\n" + .'- **en**：英文。', 'type' => 'string', 'required' => false, 'example' => 'zh'], ], ], 'responses' => [ @@ -14132,215 +9744,108 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '566', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '9DFF5F54-162B-5860-80A5-411FF550B347', - ], - 'DBClusterId' => [ - 'description' => '数仓版集群ID。', - 'type' => 'string', - 'example' => 'am-xxx', - ], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '50'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '584CFCAE-E3C8-5BBB-B46C-724E77A830A7'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-xxxx'], 'DetectionItems' => [ 'description' => '检测项及检测结果列表。', 'type' => 'array', 'items' => [ - 'description' => '检测结果。', + 'description' => '检测项及检测结果列表。', 'type' => 'object', 'properties' => [ - 'Name' => [ - 'description' => '检测项名字。', - 'type' => 'string', - 'example' => '指标检测', - ], + 'Name' => ['description' => '检测项名字。', 'type' => 'string', 'example' => 'Cost'], 'Results' => [ 'description' => '检测结果集合。', - 'type' => 'object', - 'properties' => [ - 'OperatorDetails' => [ - 'description' => '异常算子检测结果集合。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'MetricName' => [ - 'description' => '检测指标名。', - 'type' => 'string', - 'example' => 'PeakMemory', - ], - 'SearchResults' => [ - 'description' => '异常算子检测结果。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'ProcessId' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => '2024080110010002102500023803151627972', - ], - 'StageId' => [ - 'description' => 'StageID。', - 'type' => 'string', - 'example' => 'Stage[3]', - ], - 'OperatorName' => [ - 'description' => '算子名。', - 'type' => 'string', - 'example' => 'Join', - ], - 'PeakMemory' => [ - 'description' => '峰值内存消耗，单位Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '234', - ], - 'OperatorCost' => [ - 'description' => '该阶段内部总的算子耗时，等同于该阶段的CPU Time，可用于判断查询哪些部分消耗了较多的计算资源。单位为毫秒（ms）。', - 'type' => 'number', - 'format' => 'double', - 'example' => '123', - ], - 'InputRows' => [ - 'description' => '算子的输入数据行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'OutputRows' => [ - 'description' => '算子的输出数据行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2345', - ], - 'InputSize' => [ - 'description' => '算子的输入数据量。单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '345', - ], - 'OutputSize' => [ - 'description' => '算子的输出数据量。单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '234', - ], - 'OperatorInfo' => [ - 'description' => '算子属性信息。', - 'type' => 'string', - 'example' => 'Group By字段：uid', - ], - ], - ], - ], - ], - ], - ], - 'OperatorAgg' => [ - 'description' => '算子指标聚合检测结果集合。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'MetricName' => [ - 'description' => '检测指标名。', - 'type' => 'string', - 'example' => 'OperatorCost', - ], - 'SearchResults' => [ - 'description' => '聚合结果检测结果集合。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'OperatorName' => [ - 'description' => '算子名。', - 'type' => 'string', - 'example' => 'Window', - ], - 'MaxValue' => [ - 'description' => '指标最大值。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2345', - ], - 'TotalValue' => [ - 'description' => '指标累加值。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '345', - ], - 'AvgValue' => [ - 'description' => '指标平均值。', - 'type' => 'number', - 'format' => 'double', - 'example' => '234', - ], - 'OperatorCount' => [ - 'description' => '算子出现次数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '3', - ], - ], - ], + 'type' => 'array', + 'items' => [ + 'description' => '检测结果对象。', + 'type' => 'object', + 'properties' => [ + 'Cost' => ['description' => '查询的总耗时。单位：毫秒。'."\n" + .'> 该耗时指标是`QueuedTime`、`TotalPlanningTime`和`ExecutionTime`三个耗时指标的累加值。', 'type' => 'integer', 'format' => 'int64', 'example' => '709'], + 'PeakMemory' => ['description' => '查询的峰值内存，单位Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '234'], + 'OperatorCost' => ['description' => '该阶段内部总的算子耗时，等同于该阶段的CPU Time，可用于判断查询哪些部分消耗了较多的计算资源。单位为毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '2345'], + 'ScanSize' => ['description' => '扫描数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '2342'], + 'OutputDataSize' => ['description' => '返回数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '235433'], + 'ProcessId' => ['description' => '任务ID。', 'type' => 'string', 'example' => '202410161002191720161451770345363xxxx'], + 'TotalStages' => ['description' => '查询生成的总Stage数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'DiagnosisResults' => [ + 'description' => '查询自诊断结果集合。', + 'type' => 'array', + 'items' => [ + 'description' => '查询自诊断结果对象。', + 'type' => 'object', + 'properties' => [ + 'Code' => ['description' => '诊断码。', 'type' => 'string', 'example' => 'Large amounts of data are returned to the client.'], + 'Detail' => ['description' => '诊断结果详情。', 'type' => 'string', 'example' => 'Large amounts of data are returned to the client. Import the data to OSS.'], + 'StageId' => ['description' => 'StageID。', 'type' => 'string', 'example' => 'Stage[67]'], + 'OperatorId' => ['description' => '算子ID。', 'type' => 'string', 'example' => 'TableScan[234]'], ], ], ], + 'SQL' => ['description' => 'SQL语句详情。'."\n" + .'> 出于性能考虑，当前SQL语句最长支持显示5120个字符，超出限制的SQL语句会被截断。您可以调用[DownloadDiagnosisRecords](~~308212~~)接口下载符合指定条件的SQL语句的摘要信息，包括完整的SQL语句。', 'type' => 'string', 'example' => 'SELECT * FROM device WHERE product_key = \'h66zXfxet2X\' AND name = \'device@zntbtfptv5_9237117\''], + 'StartTime' => ['description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', 'type' => 'string', 'example' => '2024-09-06T02:11:00Z'], + 'PatternId' => ['description' => 'SQL Pattern的ID。', 'type' => 'string', 'example' => '3467484070025860498'], ], ], ], - 'Message' => [ - 'description' => '检测结果信息。', - 'type' => 'string', - 'example' => '检测到Aggregation算子消耗内存资源较多'."\n", - ], - 'Status' => [ - 'description' => '检测结果状态。取值：'."\n" - ."\n" - .'- NORMAL'."\n" - .'- WARNING'."\n" - .'- CRITICAL', - 'type' => 'string', - 'example' => 'WARNING', - ], + 'Status' => ['description' => '检测结果状态。取值：'."\n" + ."\n" + .'- NORMAL'."\n" + .'- WARNING'."\n" + .'- CRITICAL', 'type' => 'string', 'example' => 'WARNING'], + 'Message' => ['description' => '检测结果信息。', 'type' => 'string', 'example' => 'SQL statements that result in high peak memory are detected.'], ], ], ], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], ], + 'description' => '', ], ], ], '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' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"566\\",\\n \\"RequestId\\": \\"9DFF5F54-162B-5860-80A5-411FF550B347\\",\\n \\"DBClusterId\\": \\"am-xxx\\",\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"指标检测\\",\\n \\"Results\\": {\\n \\"OperatorDetails\\": [\\n {\\n \\"MetricName\\": \\"PeakMemory\\",\\n \\"SearchResults\\": [\\n {\\n \\"ProcessId\\": \\"2024080110010002102500023803151627972\\",\\n \\"StageId\\": \\"Stage[3]\\",\\n \\"OperatorName\\": \\"Join\\",\\n \\"PeakMemory\\": 234,\\n \\"OperatorCost\\": 123,\\n \\"InputRows\\": 123,\\n \\"OutputRows\\": 2345,\\n \\"InputSize\\": 345,\\n \\"OutputSize\\": 234,\\n \\"OperatorInfo\\": \\"Group By字段：uid\\"\\n }\\n ]\\n }\\n ],\\n \\"OperatorAgg\\": [\\n {\\n \\"MetricName\\": \\"OperatorCost\\",\\n \\"SearchResults\\": [\\n {\\n \\"OperatorName\\": \\"Window\\",\\n \\"MaxValue\\": 2345,\\n \\"TotalValue\\": 345,\\n \\"AvgValue\\": 234,\\n \\"OperatorCount\\": 3\\n }\\n ]\\n }\\n ]\\n },\\n \\"Message\\": \\"检测到Aggregation算子消耗内存资源较多\\\\n\\",\\n \\"Status\\": \\"WARNING\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '计算节点检测', - ], - 'DescribeWorkerDetection' => [ - 'summary' => '查询存储层诊断结果。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => 'BadSQL检测', + 'summary' => '查看一段时间范围内影响实例稳定的BadSQL。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeBadSqlDetection'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeBadSqlDetection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"50\\",\\n \\"RequestId\\": \\"584CFCAE-E3C8-5BBB-B46C-724E77A830A7\\",\\n \\"DBClusterId\\": \\"amv-xxxx\\",\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"Cost\\",\\n \\"Results\\": [\\n {\\n \\"Cost\\": 709,\\n \\"PeakMemory\\": 234,\\n \\"OperatorCost\\": 2345,\\n \\"ScanSize\\": 2342,\\n \\"OutputDataSize\\": 235433,\\n \\"ProcessId\\": \\"202410161002191720161451770345363xxxx\\",\\n \\"TotalStages\\": 5,\\n \\"DiagnosisResults\\": [\\n {\\n \\"Code\\": \\"Large amounts of data are returned to the client.\\",\\n \\"Detail\\": \\"Large amounts of data are returned to the client. Import the data to OSS.\\",\\n \\"StageId\\": \\"Stage[67]\\",\\n \\"OperatorId\\": \\"TableScan[234]\\"\\n }\\n ],\\n \\"SQL\\": \\"SELECT * FROM device WHERE product_key = \'h66zXfxet2X\' AND name = \'device@zntbtfptv5_9237117\'\\",\\n \\"StartTime\\": \\"2024-09-06T02:11:00Z\\",\\n \\"PatternId\\": \\"3467484070025860498\\"\\n }\\n ],\\n \\"Status\\": \\"WARNING\\",\\n \\"Message\\": \\"SQL statements that result in high peak memory are detected.\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', + ], + 'DescribeClusterAccessWhiteList' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -14349,74 +9854,135 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '194345', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'abilityTreeNodes' => ['FEATUREadsG383TB'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-xxxxx', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ 'name' => 'RegionId', 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~612293~~)接口查看地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-beijing', + 'description' => '返回信息。', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '370D09FD-442A-5225-AAD3-7362CAE39177'], + 'Items' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'IPArray' => [ + 'description' => '集群的IP白名单分组列表。', + 'type' => 'array', + 'items' => [ + 'description' => '集群的IP白名单分组列表。', + 'type' => 'object', + 'properties' => [ + 'DBClusterIPArrayAttribute' => ['description' => '白名单分组属性。'."\n" + .'> 控制台不显示带有**hidden**属性的分组，带有该标签的分组通常是用于访问DTS、PolarDB服务的。'."\n" + ."\n", 'type' => 'string', 'example' => 'hidden'], + 'SecurityIPList' => ['description' => 'IP白名单分组下的IP列表，最多500个，以英文逗号（,）隔开。', 'type' => 'string', 'example' => '127.0.xx.xx'], + 'DBClusterIPArrayName' => ['description' => 'IP白名单分组名称。'."\n" + ."\n" + .'单个集群最多支持50个白名单分组。', 'type' => 'string', 'example' => 'test'], + ], + ], + ], + ], + 'description' => '', + ], + ], + ], + ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => ''], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => ''], + ], + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => '查询白名单', + 'summary' => '查看指定集群的IP白名单。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-09-26T08:36:35.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-03-31T07:03:57.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:51:52.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeClusterAccessWhiteList'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeClusterAccessWhiteList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"370D09FD-442A-5225-AAD3-7362CAE39177\\",\\n \\"Items\\": {\\n \\"IPArray\\": [\\n {\\n \\"DBClusterIPArrayAttribute\\": \\"hidden\\",\\n \\"SecurityIPList\\": \\"127.0.xx.xx\\",\\n \\"DBClusterIPArrayName\\": \\"test\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeClusterAccessWhiteListResponse>\\n <RequestId>370D09FD-442A-5225-AAD3-7362CAE39177</RequestId>\\n <Items>\\n <DBClusterIPArrayAttribute>hidden</DBClusterIPArrayAttribute>\\n <SecurityIPList>127.0.xx.xx</SecurityIPList>\\n <DBClusterIPArrayName>test</DBClusterIPArrayName>\\n </Items>\\n</DescribeClusterAccessWhiteListResponse>","errorExample":""}]', + ], + 'DescribeClusterNetInfo' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'StartTime', + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '133667', + 'abilityTreeNodes' => ['FEATUREads4DZDZG'], + ], + 'parameters' => [ + [ + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间。格式为<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2021-11-18T00:00Z', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-wz9dqvn0o7****'], ], [ - 'name' => 'EndTime', + 'name' => 'Engine', 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间。格式为<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2024-04-25T02:04Z', - ], + 'schema' => ['description' => '数据库引擎，取值：'."\n" + ."\n" + .'- **AnalyticDB**（默认）：AnalyticDB for MySQL引擎。'."\n" + .'- **Clickhouse**：宽表引擎。', 'type' => 'string', 'required' => false, 'example' => 'Clickhouse'], ], [ - 'name' => 'Lang', + 'name' => 'ResourceGroupName', 'in' => 'query', - 'schema' => [ - 'description' => '设置建议的显示语言，取值说明：'."\n" - .'- **zh**：简体中文（默认语言）。'."\n" - .'- **en**：英文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', - ], + 'schema' => ['type' => 'string'], ], ], 'responses' => [ @@ -14424,382 +9990,109 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '20', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'E5B37B61-E6C9-5FE0-9374-45BAA548AEF6', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'am-xxxxx', - ], - 'DetectionItems' => [ - 'description' => '检测项及检测结果列表。', - 'type' => 'array', - 'items' => [ - 'description' => '检测结果。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '检测项名字。', - 'type' => 'string', - 'example' => '指标检测', - ], - 'Results' => [ - 'description' => '检测结果。', + 'ClusterNetworkType' => ['description' => '集群网络类型，当前仅支持专有网络，取值固定为**VPC**。', 'type' => 'string', 'example' => 'VPC'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '69A29B65-CD0C-52B1-BE42-8B454569747F'], + 'Items' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Address' => [ + 'description' => '详情。', + 'type' => 'array', + 'items' => [ + 'description' => '集群列表。', 'type' => 'object', 'properties' => [ - 'SkewedTables' => [ - 'description' => '表倾斜检测。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'SchemaName' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'example' => 'platfunc', - ], - 'TableName' => [ - 'description' => '表名。', - 'type' => 'string', - 'example' => 'sls_log_cheat_action', - ], - 'DDL' => [ - 'description' => '建表语句。', - 'type' => 'string', - 'example' => 'create table test(id varchar)', - ], - 'PartitionCount' => [ - 'description' => '分区数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'TotalDataSize' => [ - 'description' => '表数据量，单位Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2345', - ], - 'TotalRowCount' => [ - 'description' => '表行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '34', - ], - 'TotalPkSize' => [ - 'description' => '表主键数据量，单位Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '234', - ], - 'TotalRemoteDataSize' => [ - 'description' => '冷数据量，单位Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '234', - ], - 'TotalLocalDataSize' => [ - 'description' => '本地数据量，单位Byte。', - 'type' => 'string', - 'example' => '2345', - ], - 'ShardSkewedRows' => [ - 'description' => '表倾斜行数。', - 'type' => 'string', - 'example' => '1234', - ], - ], - ], - ], - 'PartitionedTables' => [ - 'description' => '分区不合理表集合。', - 'type' => 'array', - 'items' => [ - 'description' => '不合理分区表。', - 'type' => 'object', - 'properties' => [ - 'SchemaName' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'nxg', - ], - 'TableName' => [ - 'description' => '表名。', - 'type' => 'string', - 'example' => 'zhw_place_order', - ], - 'DDL' => [ - 'description' => '建表语句。', - 'type' => 'string', - 'example' => 'create table test(id varchar)', - ], - 'PartitionCount' => [ - 'description' => '分区数。', - 'type' => 'string', - 'example' => '234', - ], - 'PartitionIds' => [ - 'description' => '不合理分区ID。', - 'type' => 'string', - 'example' => '[2024,2025]', - ], - 'TotalDataSize' => [ - 'description' => '表总的数据量。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1234', - ], - ], - ], - ], - 'TopAccessTables' => [ - 'description' => '表访问检测结果集合。', - 'type' => 'array', - 'items' => [ - 'description' => '表访问检测结果。', - 'type' => 'object', - 'properties' => [ - 'MetricName' => [ - 'description' => '检测指标名。', - 'type' => 'string', - 'example' => '峰值内存检测', - ], - 'SearchResults' => [ - 'description' => '表访问检索结果集合。', - 'type' => 'array', - 'items' => [ - 'description' => '表访问检索结果。', - 'type' => 'object', - 'properties' => [ - 'TableName' => [ - 'description' => '表名。', - 'type' => 'string', - 'example' => 'tiberias_2copt_origin_order_goods_info', - ], - 'MaxScanCost' => [ - 'description' => '最大扫描耗时，单位ms。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '345', - ], - 'AvgScanCost' => [ - 'description' => '平均扫描耗时，单位ms。', - 'type' => 'number', - 'format' => 'double', - 'example' => '234', - ], - 'MaxScanSize' => [ - 'description' => '最大数据读取量，单位Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2345', - ], - 'AvgScanSize' => [ - 'description' => '平均表读取量，单位Byte。', - 'type' => 'number', - 'format' => 'double', - 'example' => '234', - ], - 'AccessCount' => [ - 'description' => '表被访问的次数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1111', - ], - ], - ], - ], - ], - ], - ], - 'OperatorDetails' => [ - 'description' => '算子检测结果集合。', - 'type' => 'array', - 'items' => [ - 'description' => '算子检测结果。', - 'type' => 'object', - 'properties' => [ - 'MetricName' => [ - 'description' => '指标名。', - 'type' => 'string', - 'example' => 'PeakMemory', - ], - 'SearchResults' => [ - 'description' => '检索结果集合。', - 'type' => 'array', - 'items' => [ - 'description' => '算子检测结果。', - 'type' => 'object', - 'properties' => [ - 'ProcessId' => [ - 'description' => '返回SQL查询ID，便于用户诊断。', - 'type' => 'string', - 'example' => '2024041909301402103302422803151411141', - ], - 'StageId' => [ - 'description' => '阶段ID。', - 'type' => 'string', - 'example' => 'Stage[2]', - ], - 'OperatorName' => [ - 'description' => '算子名。', - 'type' => 'string', - 'example' => 'TableScan', - ], - 'PeakMemory' => [ - 'description' => '算子消耗的峰值内存，单位Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '23', - ], - 'OperatorCost' => [ - 'description' => '该阶段内部总的算子耗时，等同于该阶段的CPU Time，可用于判断查询哪些部分消耗了较多的计算资源。单位为毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '23', - ], - 'InputRows' => [ - 'description' => '算子的输入行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'OutputRows' => [ - 'description' => '算子的输出行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'InputSize' => [ - 'description' => '算子的输入数据量，单位Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'OutputSize' => [ - 'description' => '算子的输出数据量，单位Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'OperatorInfo' => [ - 'description' => '算子属性信息。', - 'type' => 'string', - 'example' => 'Group By字段：id', - ], - ], - ], - ], - ], - ], - ], - 'OperatorAgg' => [ - 'description' => '算子指标聚合检测结果。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'MetricName' => [ - 'description' => '算子指标聚合检测项名。', - 'type' => 'string', - 'example' => '峰值内存', - ], - 'SearchResults' => [ - 'description' => '算子聚合指标检索结果集合。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'OperatorName' => [ - 'description' => '算子名。', - 'type' => 'string', - 'example' => 'Aggregation', - ], - 'MaxValue' => [ - 'description' => '算子指标最大值。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '444', - ], - 'TotalValue' => [ - 'description' => '算子指标累加值。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'AvgValue' => [ - 'description' => '算子指标平均值。', - 'type' => 'number', - 'format' => 'double', - 'example' => '2234', - ], - 'OperatorCount' => [ - 'description' => '算子出现次数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1234', - ], - ], + 'VSwitchId' => ['description' => '交换机ID。'."\n" + .'> 当NetType取值为Public时，交换机ID返回为空。', 'type' => 'string', 'example' => 'vsw-bp1syh8vvw8yec****'], + 'ConnectionString' => ['description' => '集群的网络连接地址。'."\n" + .'- 当网络类型为VPC时，ConnectionString为VPC地址。'."\n" + .'- 当网络类型为Public时，ConnectionString为公网地址。', 'type' => 'string', 'example' => 'amv-wz9dqvn0o7****.ads.aliyuncs.com'], + 'NetType' => ['description' => '网络类型。取值说明：'."\n" + .'- **Public**：公网。'."\n" + .'- **VPC**：VPC网络。', 'type' => 'string', 'example' => 'VPC'], + 'Port' => ['description' => '端口号。固定为**3306**。', 'type' => 'string', 'example' => '3306'], + 'VPCId' => ['description' => 'VPC ID。'."\n" + .'> 当NetType取值为Public时，VPC ID返回为空。', 'type' => 'string', 'example' => 'vpc-8vbhucmd5b****'], + 'IPAddress' => ['description' => 'IP地址。'."\n" + .'- 当网络类型为VPC时，IPAddress为私网IP地址。'."\n" + .'- 当网络类型为Public时，IPAddress为连接数据库的客户端IP地址。', 'type' => 'string', 'example' => '192.168.xx.xx'], + 'ConnectionStringPrefix' => ['description' => '网络地址的前缀。'."\n" + .'- 当网络类型为VPC时，ConnectionStringPrefix为VPC地址的前辍。'."\n" + .'- 当网络类型为Public时，ConnectionStringPrefix为数据库公网连接地址的前缀。', 'type' => 'string', 'example' => 'amv-wz9dqvn0o7****'], + 'Ports' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'ports' => [ + 'description' => '端口列表。', + 'type' => 'array', + 'items' => [ + 'description' => '端口详情', + 'type' => 'object', + 'properties' => [ + 'Port' => ['description' => '对外服务端口。', 'type' => 'string', 'example' => '3306'], + 'Protocol' => ['description' => '协议类型。取值：'."\n" + ."\n" + .' - **tcp**：传输控制协议。'."\n" + .' - **http**：超文本传输协议。'."\n" + .' - **https**：超文本传输安全协议。'."\n" + .'- **mysql**：MySQL协议。', 'type' => 'string', 'example' => 'mysql'], ], ], ], ], + 'description' => '', ], ], ], - 'Message' => [ - 'description' => '检测结果信息。', - 'type' => 'string', - 'example' => '检测到多个表存在主键过多的问题', - ], - 'Status' => [ - 'description' => '检测结果状态。取值：'."\n" - ."\n" - .'- NORMAL'."\n" - .'- WARNING'."\n" - .'- CRITICAL', - 'type' => 'string', - 'example' => 'WARNING', - ], ], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ + 400 => [ + ['errorCode' => 'ACS.InvalidParameter.%s', 'errorMessage' => 'Parameter %s is invalid.', 'description' => '输入的参数无效'], + ], 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' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '查询网络信息', + 'summary' => '调用DescribeDBClusterNetInfo接口查询指定集群的网络信息。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-06-13T13:53:51.000Z', 'description' => '错误码发生变更、请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2022-06-11T16:51:52.000Z', 'description' => 'OpenAPI 下线'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"20\\",\\n \\"RequestId\\": \\"E5B37B61-E6C9-5FE0-9374-45BAA548AEF6\\",\\n \\"DBClusterId\\": \\"am-xxxxx\\",\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"指标检测\\",\\n \\"Results\\": {\\n \\"SkewedTables\\": [\\n {\\n \\"SchemaName\\": \\"platfunc\\",\\n \\"TableName\\": \\"sls_log_cheat_action\\",\\n \\"DDL\\": \\"create table test(id varchar)\\",\\n \\"PartitionCount\\": 2,\\n \\"TotalDataSize\\": 2345,\\n \\"TotalRowCount\\": 34,\\n \\"TotalPkSize\\": 234,\\n \\"TotalRemoteDataSize\\": 234,\\n \\"TotalLocalDataSize\\": \\"2345\\",\\n \\"ShardSkewedRows\\": \\"1234\\"\\n }\\n ],\\n \\"PartitionedTables\\": [\\n {\\n \\"SchemaName\\": \\"nxg\\",\\n \\"TableName\\": \\"zhw_place_order\\",\\n \\"DDL\\": \\"create table test(id varchar)\\",\\n \\"PartitionCount\\": \\"234\\",\\n \\"PartitionIds\\": \\"[2024,2025]\\",\\n \\"TotalDataSize\\": 1234\\n }\\n ],\\n \\"TopAccessTables\\": [\\n {\\n \\"MetricName\\": \\"峰值内存检测\\",\\n \\"SearchResults\\": [\\n {\\n \\"TableName\\": \\"tiberias_2copt_origin_order_goods_info\\",\\n \\"MaxScanCost\\": 345,\\n \\"AvgScanCost\\": 234,\\n \\"MaxScanSize\\": 2345,\\n \\"AvgScanSize\\": 234,\\n \\"AccessCount\\": 1111\\n }\\n ]\\n }\\n ],\\n \\"OperatorDetails\\": [\\n {\\n \\"MetricName\\": \\"PeakMemory\\",\\n \\"SearchResults\\": [\\n {\\n \\"ProcessId\\": \\"2024041909301402103302422803151411141\\",\\n \\"StageId\\": \\"Stage[2]\\",\\n \\"OperatorName\\": \\"TableScan\\",\\n \\"PeakMemory\\": 23,\\n \\"OperatorCost\\": 23,\\n \\"InputRows\\": 123,\\n \\"OutputRows\\": 123,\\n \\"InputSize\\": 123,\\n \\"OutputSize\\": 123,\\n \\"OperatorInfo\\": \\"Group By字段：id\\"\\n }\\n ]\\n }\\n ],\\n \\"OperatorAgg\\": [\\n {\\n \\"MetricName\\": \\"峰值内存\\",\\n \\"SearchResults\\": [\\n {\\n \\"OperatorName\\": \\"Aggregation\\",\\n \\"MaxValue\\": 444,\\n \\"TotalValue\\": 123,\\n \\"AvgValue\\": 2234,\\n \\"OperatorCount\\": 1234\\n }\\n ]\\n }\\n ]\\n },\\n \\"Message\\": \\"检测到多个表存在主键过多的问题\\",\\n \\"Status\\": \\"WARNING\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '预留节点检测', - ], - 'DescribeControllerDetection' => [ - 'summary' => '查看接入层诊断结果。', - 'methods' => [ - 'post', - 'get', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeClusterNetInfo'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeClusterNetInfo', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"ClusterNetworkType\\": \\"VPC\\",\\n \\"RequestId\\": \\"69A29B65-CD0C-52B1-BE42-8B454569747F\\",\\n \\"Items\\": {\\n \\"Address\\": [\\n {\\n \\"VSwitchId\\": \\"vsw-bp1syh8vvw8yec****\\",\\n \\"ConnectionString\\": \\"amv-wz9dqvn0o7****.ads.aliyuncs.com\\",\\n \\"NetType\\": \\"VPC\\",\\n \\"Port\\": \\"3306\\",\\n \\"VPCId\\": \\"vpc-8vbhucmd5b****\\",\\n \\"IPAddress\\": \\"192.168.xx.xx\\",\\n \\"ConnectionStringPrefix\\": \\"amv-wz9dqvn0o7****\\",\\n \\"Ports\\": {\\n \\"ports\\": [\\n {\\n \\"Port\\": \\"3306\\",\\n \\"Protocol\\": \\"mysql\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeClusterNetInfoResponse>\\n <ClusterNetworkType>VPC</ClusterNetworkType>\\n <RequestId>69A29B65-CD0C-52B1-BE42-8B454569747F</RequestId>\\n <Items>\\n <VSwitchId>vsw-bp1syh8vvw8yec****</VSwitchId>\\n <ConnectionString>amv-wz9dqvn0o7****.ads.aliyuncs.com</ConnectionString>\\n <NetType>VPC</NetType>\\n <Port>3306</Port>\\n <VPCId>vpc-8vbhucmd5b****</VPCId>\\n <IPAddress>192.168.xx.xx</IPAddress>\\n <ConnectionStringPrefix>amv-wz9dqvn0o7****</ConnectionStringPrefix>\\n </Items>\\n</DescribeClusterNetInfoResponse>","errorExample":""}]', + ], + 'DescribeClusterResourceDetail' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -14807,126 +10100,157 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '194343', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', - ], + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1jj9xqft1po****'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '集群ID。'."\n" - .'> * 您可以调用[DescribeDBClusters](~~98094~~)接口查看目标地域下所有的集群信息，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-xxxx', + 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', + 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => [ + 'description' => '集群资源具体使用详情。', + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-adbxxxxx'], + 'ComputeResource' => ['description' => '计算预留资源。取值范围：0ACU～4096ACU，步长：16。1 ACU约等于1核4 GB。', 'type' => 'string', 'example' => '16ACU'], + 'FreeComputeResource' => ['description' => '空闲计算预留资源。取值范围：0ACU～4096ACU，步长：16。1 ACU约等于1核4 GB。', 'type' => 'string', 'example' => '0ACU'], + 'StorageResource' => ['description' => '存储预留资源。取值范围：0ACU～2064ACU，步长：24。1 ACU约等于1核4 GB。', 'type' => 'string', 'example' => '24ACU'], + 'ResourceGroupList' => [ + 'description' => '资源组列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'PoolId' => ['description' => '资源组ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '17'], + 'PoolName' => ['description' => '资源组名称。', 'type' => 'string', 'example' => 'testadb'], + 'PoolType' => ['description' => '资源组类型。', 'type' => 'string', 'example' => 'interactive'], + 'MinComputeResource' => ['description' => '最小计算预留资源，单位为ACU。'."\n", 'type' => 'string', 'example' => '16ACU'], + 'MaxComputeResource' => ['description' => '最大计算预留资源，单位为ACU。', 'type' => 'string', 'example' => '128ACU'], + 'PoolUsers' => ['description' => '资源组用户。', 'type' => 'string', 'example' => 'user1'], + 'Status' => ['description' => '资源组状态，取值说明：'."\n" + .'- **running**：运行中'."\n" + .'- **deleting**：删除中'."\n" + .'- **scaling**：变配中', 'type' => 'string', 'example' => 'running'], + 'ClusterSizeResource' => ['description' => '预留参数(不涉及)', 'type' => 'string', 'example' => '0'], + 'MinClusterCount' => ['description' => '预留参数（不涉及）', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'MaxClusterCount' => ['description' => '预留参数（不涉及）', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'RunningClusterCount' => ['description' => '预留参数（不涉及）', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'ClusterMode' => ['description' => '预留参数（不涉及）', 'type' => 'string', 'required' => true, 'example' => '0', 'default' => 'Disable'], + 'EnableSpot' => ['description' => '资源组是否开启竞价实例功能。开启竞价实例后资源单价降低，但是有概率被释放。取值：'."\n" + .'- **True**：开启竞价实例功能。'."\n" + .'- **False**：关闭竞价实例功能。'."\n" + ."\n" + .'仅Job型资源组可以为True。', 'type' => 'boolean', 'example' => 'true'], + ], + 'description' => '', + ], + ], + ], + ], + ], ], ], + ], + 'title' => '查询集群资源具体使用详情', + 'summary' => '查询集群资源具体使用详情。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-01-26T02:37:32.000Z', 'description' => '响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeClusterResourceDetail'], + ], + ], + 'ramActions' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeClusterResourceDetail', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"DBClusterId\\": \\"amv-adbxxxxx\\",\\n \\"ComputeResource\\": \\"16ACU\\",\\n \\"FreeComputeResource\\": \\"0ACU\\",\\n \\"StorageResource\\": \\"24ACU\\",\\n \\"ResourceGroupList\\": [\\n {\\n \\"PoolId\\": 17,\\n \\"PoolName\\": \\"testadb\\",\\n \\"PoolType\\": \\"interactive\\",\\n \\"MinComputeResource\\": \\"16ACU\\",\\n \\"MaxComputeResource\\": \\"128ACU\\",\\n \\"PoolUsers\\": \\"user1\\",\\n \\"Status\\": \\"running\\",\\n \\"ClusterSizeResource\\": \\"0\\",\\n \\"MinClusterCount\\": 0,\\n \\"MaxClusterCount\\": 0,\\n \\"RunningClusterCount\\": 0,\\n \\"ClusterMode\\": \\"0\\",\\n \\"EnableSpot\\": true\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeClusterResourceUsage' => [ + 'methods' => ['get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'StartTime', + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ + [ + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2022-03-10T23:56Z', - ], + 'schema' => ['description' => '集群ID。'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~612397~~)接口查看集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'EndTime', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '日志的结束时间。格式：**yyyy-MM-ddTHH:mmZ**（UTC时间）。'."\n" - ."\n" - .'> 查询日志时，结束时间需大于开始时间，且与开始时间最大间隔不超过30天。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2024-06-23T02:21Z', - ], + 'schema' => ['description' => '查询开始时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。', 'type' => 'string', 'required' => true, 'example' => '2022-11-29T10:20Z'], ], [ - 'name' => 'Lang', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => '语言配置，取值说明：'."\n" - .'- **zh**：简体中文（默认语言）。'."\n" - .'- **en**：英文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', - ], + 'schema' => ['description' => '查询结束时间，UTC时间，格式：yyyy-MM-ddTHH:mmZ。', 'type' => 'string', 'required' => true, 'example' => '2022-08-22T01:06:00Z'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', + 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '查询得到的结果总数。', - 'type' => 'string', - 'example' => '10', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '257FAE29-ED5F-586C-94E4-43BD1392F238', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-xxx', - ], - 'DetectionItems' => [ - 'description' => '检测项及检测结果列表。', - 'type' => 'array', - 'items' => [ - 'description' => '检测结果对象。', - 'type' => 'object', - 'properties' => [ - 'Message' => [ - 'description' => '检测结果信息。', - 'type' => 'string', - 'example' => '检测到接入节点CPU增高', - ], - 'Name' => [ - 'description' => '检测项名字。', - 'type' => 'string', - 'example' => 'CPU增高检测', - ], - 'Status' => [ - 'description' => '检测结果状态。取值：'."\n" - ."\n" - .'- NORMAL'."\n" - .'- WARNING'."\n" - .'- CRITICAL', - 'type' => 'string', - 'example' => 'NORMAL'."\n" - .'WARNING'."\n" - .'CRITICAL', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEAW'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => [ + 'description' => '集群资源使用详情。', + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-uf6dj23rt5zo9s9d'], + 'StartTime' => ['description' => '查询开始时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。', 'type' => 'string', 'example' => '2023-03-14T03:42:15Z'], + 'EndTime' => ['description' => '查询结束时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。', 'type' => 'string', 'example' => '2023-03-23T02:31Z'], + 'AcuInfo' => [ + 'description' => '集群ACU资源使用情况。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '对应指标项取值的状态，取值说明：'."\n" + .'- `TotalAcuNumber`：总ACU资源数。'."\n" + .'- `ReservedAcuNumber`：预留资源ACU数。'."\n" + .'- `ReservedAcuUsageNumber`：已使用的预留资源ACU数。', 'type' => 'string', 'example' => 'TotalAcuNumber'], + 'Values' => [ + 'description' => '对应指标项在各时间点的具体取值。', + 'type' => 'array', + 'items' => ['description' => '不同时间点下的性能值详情。', 'type' => 'string', 'example' => '16.0'], + ], + ], + 'description' => '', ], ], ], @@ -14935,33 +10259,33 @@ ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 'title' => '查询集群资源使用情况', + 'summary' => '调用DescribeClusterResourceUsage接口查询集群资源使用情况。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeClusterResourceUsage'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeClusterResourceUsage', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"10\\",\\n \\"RequestId\\": \\"257FAE29-ED5F-586C-94E4-43BD1392F238\\",\\n \\"DBClusterId\\": \\"amv-xxx\\",\\n \\"DetectionItems\\": [\\n {\\n \\"Message\\": \\"检测到接入节点CPU增高\\",\\n \\"Name\\": \\"CPU增高检测\\",\\n \\"Status\\": \\"NORMAL\\\\nWARNING\\\\nCRITICAL\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '接入节点检测', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEAW\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"DBClusterId\\": \\"amv-uf6dj23rt5zo9s9d\\",\\n \\"StartTime\\": \\"2023-03-14T03:42:15Z\\",\\n \\"EndTime\\": \\"2023-03-23T02:31Z\\",\\n \\"AcuInfo\\": [\\n {\\n \\"Name\\": \\"TotalAcuNumber\\",\\n \\"Values\\": [\\n \\"16.0\\"\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'DescribeBadSqlDetection' => [ - 'summary' => '查看一段时间范围内影响实例稳定的BadSQL。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [ - 'Perth', - ], + 'DescribeColumns' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -14973,261 +10297,294 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '194347', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], + ], + [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-xxx', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1xxxxxxxx47'], ], [ - 'name' => 'RegionId', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-shanghai', - ], + 'schema' => ['description' => '数据库名称。'."\n" + .' '."\n", 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], ], [ - 'name' => 'StartTime', + 'name' => 'TableName', 'in' => 'query', + 'schema' => ['description' => '查询表名。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2022-01-23T02:18Z', + 'title' => 'Schema of Response', + 'description' => '返回结果。', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-XXX442913CEF'], + 'Items' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Column' => [ + 'description' => '列列表。', + 'type' => 'array', + 'items' => [ + 'description' => '列信息。', + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => '列数据类型。', 'type' => 'string', 'example' => 'bigint'], + 'ColumnName' => ['description' => '列名称。', 'type' => 'string', 'example' => 'id'], + 'TableName' => ['description' => '表名称。', 'type' => 'string', 'example' => 'test'], + 'AutoIncrementColumn' => ['description' => '列是否自增，取值说明：'."\n" + .'- **true**：自增。'."\n" + .'- **false**：不自增。', 'type' => 'boolean', 'example' => 'true'], + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-bp111m2cfrdl1****'], + 'PrimaryKey' => ['description' => '列是否为主键，取值说明：'."\n" + .'- **true**：主键。'."\n" + .'- **false**：非主键。', 'type' => 'boolean', 'example' => 'false'], + 'SchemaName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'adb_demo'], + ], + ], + ], + ], + 'description' => '', + ], + ], ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '枚举表的列列表', + 'summary' => '查询指定表的列列表信息。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2025-05-07T05:42:07.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-08-25T03:37:06.000Z', 'description' => '请求参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeColumns'], + ], + ], + 'ramActions' => [ [ - 'name' => 'EndTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间，需晚于查询开始时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2024-11-17T02:16Z', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:describeAllDataSource', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-XXX442913CEF\\",\\n \\"Items\\": {\\n \\"Column\\": [\\n {\\n \\"Type\\": \\"bigint\\",\\n \\"ColumnName\\": \\"id\\",\\n \\"TableName\\": \\"test\\",\\n \\"AutoIncrementColumn\\": true,\\n \\"DBClusterId\\": \\"amv-bp111m2cfrdl1****\\",\\n \\"PrimaryKey\\": false,\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeCompactionServiceSwitch' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'Lang', + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'update'], + 'parameters' => [ + [ + 'name' => 'DBClusterId', 'in' => 'query', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp149vz49b36t****'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '语言配置，取值说明：'."\n" - .'- **zh**：简体中文（默认语言）。'."\n" - .'- **en**：英文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'D761DA51-12F8-5457-AAA9-F52B9F436D2D'], + 'Data' => [ + 'description' => '返回数据。', + 'type' => 'object', + 'properties' => [ + 'EnableCompactionService' => [ + 'description' => '是否开启远程Build服务。', + 'type' => 'boolean', + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], + 'example' => 'true', + ], + ], + ], + ], + 'description' => '', + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidMaintainTime.Malformed', 'errorMessage' => 'The specified parameter MaintainTime is not valid.', 'description' => 'MaintainTime参数不正确，请确认参数是否符合规范。'."\n"], + ], + ], + 'title' => '查询集群加速配置', + 'summary' => '查询集群加速配置中，远程Build服务是否开启。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeCompactionServiceSwitch'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:DescribeCompactionServiceSwitch', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D761DA51-12F8-5457-AAA9-F52B9F436D2D\\",\\n \\"Data\\": {\\n \\"EnableCompactionService\\": true\\n }\\n}","type":"json"}]', + ], + 'DescribeComputeResourceUsage' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'get'], + 'parameters' => [ + [ + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1xxxxxxxx47'], + ], + [ + 'name' => 'ResourceGroupName', + 'in' => 'query', + 'schema' => ['description' => '资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => ['description' => '查询开始时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。', 'type' => 'string', 'required' => true, 'example' => '2023-02-04T03:45:00Z'], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => '查询结束时间。格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', 'type' => 'string', 'required' => true, 'example' => '2023-02-05T03:45:00Z'], + ], + ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', + 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '50', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '584CFCAE-E3C8-5BBB-B46C-724E77A830A7', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-xxxx', - ], - 'DetectionItems' => [ - 'description' => '检测项及检测结果列表。', - 'type' => 'array', - 'items' => [ - 'description' => '检测项及检测结果列表。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '检测项名字。', - 'type' => 'string', - 'example' => 'Cost', - ], - 'Results' => [ - 'description' => '检测结果集合。', - 'type' => 'array', - 'items' => [ - 'description' => '检测结果对象。', - 'type' => 'object', - 'properties' => [ - 'Cost' => [ - 'description' => '查询的总耗时。单位：毫秒。'."\n" - .'> 该耗时指标是`QueuedTime`、`TotalPlanningTime`和`ExecutionTime`三个耗时指标的累加值。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '709', - ], - 'PeakMemory' => [ - 'description' => '查询的峰值内存，单位Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '234', - ], - 'OperatorCost' => [ - 'description' => '该阶段内部总的算子耗时，等同于该阶段的CPU Time，可用于判断查询哪些部分消耗了较多的计算资源。单位为毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2345', - ], - 'ScanSize' => [ - 'description' => '扫描数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2342', - ], - 'OutputDataSize' => [ - 'description' => '返回数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '235433', - ], - 'ProcessId' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => '202410161002191720161451770345363xxxx', - ], - 'TotalStages' => [ - 'description' => '查询生成的总Stage数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '5', - ], - 'DiagnosisResults' => [ - 'description' => '查询自诊断结果集合。', - 'type' => 'array', - 'items' => [ - 'description' => '查询自诊断结果对象。', - 'type' => 'object', - 'properties' => [ - 'Code' => [ - 'description' => '诊断码。', - 'type' => 'string', - 'example' => '查询返回客户端的数据量较大', - ], - 'Detail' => [ - 'description' => '诊断结果详情。', - 'type' => 'string', - 'example' => '当前SQL返回到客户端的数据量较大，考虑导入到OSS', - ], - 'StageId' => [ - 'description' => 'StageID。', - 'type' => 'string', - 'example' => 'Stage[67]', - ], - 'OperatorId' => [ - 'description' => '算子ID。', - 'type' => 'string', - 'example' => 'TableScan[234]', - ], - ], - ], - ], - 'SQL' => [ - 'description' => 'SQL语句详情。'."\n" - .'> 出于性能考虑，当前SQL语句最长支持显示5120个字符，超出限制的SQL语句会被截断。您可以调用[DownloadDiagnosisRecords](~~308212~~)接口下载符合指定条件的SQL语句的摘要信息，包括完整的SQL语句。', - 'type' => 'string', - 'example' => 'SELECT * FROM device WHERE product_key = \'h66zXfxet2X\' AND name = \'device@zntbtfptv5_9237117\'', - ], - 'StartTime' => [ - 'description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', - 'type' => 'string', - 'example' => '2024-09-06T02:11:00Z', - ], - 'PatternId' => [ - 'description' => 'SQL Pattern的ID。', - 'type' => 'string', - 'example' => '3467484070025860498', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEAW'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => [ + 'description' => '返回结果数据。', + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-clusterxxx'], + 'ResourceGroupType' => ['description' => '资源组的类型。', 'type' => 'string', 'example' => 'interative'], + 'ResourceGroupName' => ['description' => '资源组名称。', 'type' => 'string', 'example' => 'test'], + 'StartTime' => ['description' => '查询开始时间，格式为：yyyy-MM-ddTHH:mmZ。', 'type' => 'string', 'example' => '2023-04-24T07:00:00Z'], + 'EndTime' => ['description' => '查询结束时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。', 'type' => 'string', 'example' => '2023-06-07T02:37:00Z'], + 'AcuInfo' => [ + 'description' => '集群ACU资源使用情况。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '对应指标项取值的状态，取值说明：'."\n" + .'- `TotalAcuNumber`：总ACU资源数。'."\n" + .'- `ReservedAcuNumber`：预留资源ACU数。'."\n" + .'- `ReservedAcuUsageNumber`：已使用的预留资源ACU数。', 'type' => 'string', 'example' => 'TotalAcuNumber'], + 'Values' => [ + 'description' => '对应指标项在各时间点取值列表。', + 'type' => 'array', + 'items' => ['description' => '对应指标项在各时间点的具体取值。', 'type' => 'string', 'example' => '16.0'], ], ], - ], - 'Status' => [ - 'description' => '检测结果状态。取值：'."\n" - ."\n" - .'- NORMAL'."\n" - .'- WARNING'."\n" - .'- CRITICAL', - 'type' => 'string', - 'example' => 'WARNING', - ], - 'Message' => [ - 'description' => '检测结果信息。', - 'type' => 'string', - 'example' => '检测到存在峰值内存教导的SQL', + 'description' => '', ], ], ], ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', - ], ], ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 'title' => '查询资源组计算资源使用情况', + 'summary' => '查询集群资源组计算资源使用情况。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeComputeResourceUsage'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeComputeResourceUsage', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"50\\",\\n \\"RequestId\\": \\"584CFCAE-E3C8-5BBB-B46C-724E77A830A7\\",\\n \\"DBClusterId\\": \\"amv-xxxx\\",\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"Cost\\",\\n \\"Results\\": [\\n {\\n \\"Cost\\": 709,\\n \\"PeakMemory\\": 234,\\n \\"OperatorCost\\": 2345,\\n \\"ScanSize\\": 2342,\\n \\"OutputDataSize\\": 235433,\\n \\"ProcessId\\": \\"202410161002191720161451770345363xxxx\\",\\n \\"TotalStages\\": 5,\\n \\"DiagnosisResults\\": [\\n {\\n \\"Code\\": \\"查询返回客户端的数据量较大\\",\\n \\"Detail\\": \\"当前SQL返回到客户端的数据量较大，考虑导入到OSS\\",\\n \\"StageId\\": \\"Stage[67]\\",\\n \\"OperatorId\\": \\"TableScan[234]\\"\\n }\\n ],\\n \\"SQL\\": \\"SELECT * FROM device WHERE product_key = \'h66zXfxet2X\' AND name = \'device@zntbtfptv5_9237117\'\\",\\n \\"StartTime\\": \\"2024-09-06T02:11:00Z\\",\\n \\"PatternId\\": \\"3467484070025860498\\"\\n }\\n ],\\n \\"Status\\": \\"WARNING\\",\\n \\"Message\\": \\"检测到存在峰值内存教导的SQL\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', - 'title' => 'BadSQL检测', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEAW\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"DBClusterId\\": \\"amv-clusterxxx\\",\\n \\"ResourceGroupType\\": \\"interative\\",\\n \\"ResourceGroupName\\": \\"test\\",\\n \\"StartTime\\": \\"2023-04-24T07:00:00Z\\",\\n \\"EndTime\\": \\"2023-06-07T02:37:00Z\\",\\n \\"AcuInfo\\": [\\n {\\n \\"Name\\": \\"TotalAcuNumber\\",\\n \\"Values\\": [\\n \\"16.0\\"\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'DescribeAbnormalPatternDetection' => [ - 'summary' => '查询异常Pattern诊断结果。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeControllerDetection' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -15239,10 +10596,8 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '194346', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '194343', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], 'autoTest' => true, 'tenantRelevance' => 'tenant', ], @@ -15250,63 +10605,33 @@ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-xxx', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> * 您可以调用[DescribeDBClusters](~~98094~~)接口查看目标地域下所有的集群信息，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-xxxx'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '运维事件所在地域的地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-zhangjiakou', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '查询起始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2021-09-30T00:10Z', - ], + 'schema' => ['description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2022-03-10T23:56Z'], ], [ 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。'."\n" - .'> 查询结束时间需晚于查询开始时间。'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2024-11-17T02:16Z', - ], + 'schema' => ['description' => '日志的结束时间。格式：**yyyy-MM-ddTHH:mmZ**（UTC时间）。'."\n" + ."\n" + .'> 查询日志时，结束时间需大于开始时间，且与开始时间最大间隔不超过30天。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2024-06-23T02:21Z'], ], [ 'name' => 'Lang', 'in' => 'query', - 'schema' => [ - 'description' => '语言配置，取值说明：'."\n" - .'- **zh**：简体中文（默认语言）。'."\n" - .'- **en**：英文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', - ], + 'schema' => ['description' => '语言配置，取值说明：'."\n" + .'- **zh**：简体中文（默认语言）。'."\n" + .'- **en**：英文。', 'type' => 'string', 'required' => false, 'example' => 'zh'], ], ], 'responses' => [ @@ -15314,126 +10639,65 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '15', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '19B824E0-690D-5A78-9992-5398C2F43694', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-xxxx', - ], + 'TotalCount' => ['description' => '查询得到的结果总数。', 'type' => 'string', 'example' => '10'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '257FAE29-ED5F-586C-94E4-43BD1392F238'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-xxx'], 'DetectionItems' => [ 'description' => '检测项及检测结果列表。', 'type' => 'array', 'items' => [ - 'description' => '检测项及检测结果列表。', + 'description' => '检测结果对象。', 'type' => 'object', 'properties' => [ - 'Name' => [ - 'description' => '检测项名字。', - 'type' => 'string', - 'example' => 'Cost', - ], - 'Results' => [ - 'description' => '检测结果集合。', - 'type' => 'array', - 'items' => [ - 'description' => '检测结果对象。', - 'type' => 'object', - 'properties' => [ - 'PatternId' => [ - 'description' => 'SQL Pattern的ID。', - 'type' => 'string', - 'example' => '2803084667741875187', - ], - 'SQLPattern' => [ - 'description' => 'SQL Pattern的具体语句。', - 'type' => 'string', - 'example' => 'SELECT `tsid`nFROM `prod_ods_marketing_engine_material`nWHERE `tsid` = ?nLIMIT ?', - ], - 'Detail' => [ - 'description' => '检测结果描述。', - 'type' => 'string', - 'example' => '检测到2个totalTime指标异常Pattern，可能导致CPU使用率增高，或者查询变慢，影响系统稳定性，请到监控页面使用一键诊断查看详情，并进行优化', - ], - 'RelatedMetrics' => [ - 'description' => 'Pattern相关指标。', - 'type' => 'string', - 'example' => '最大查询耗时：1.43s'."\n" - .'最大峰值内存：20.73MB'."\n" - .'最大表读取数据量：10.12MB', - ], - 'User' => [ - 'description' => '提交查询的用户名。', - 'type' => 'string', - 'example' => 'test', - ], - 'AccessIp' => [ - 'description' => '提交Pattern相关的SQL客户端IP地址。', - 'type' => 'string', - 'example' => '172.16.133.168', - ], - 'Tables' => [ - 'description' => '表名。', - 'type' => 'string', - 'example' => 'dw_student_exam.ods_school_queanal', - ], - 'QueryCount' => [ - 'description' => '查询总数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '72', - ], - 'FailedCount' => [ - 'description' => '指定时间范围内，Pattern的失败次数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '7', - ], - ], - ], - ], + 'Message' => ['description' => '检测结果信息。', 'type' => 'string', 'example' => 'A CPU increase is detected on the access node.'], + 'Name' => ['description' => '检测项名字。', 'type' => 'string', 'example' => 'CPU增高检测'], + 'Status' => ['description' => '检测结果状态。取值：'."\n" + ."\n" + .'- NORMAL'."\n" + .'- WARNING'."\n" + .'- CRITICAL', 'type' => 'string', 'example' => 'NORMAL'."\n" + .'WARNING'."\n" + .'CRITICAL'], ], ], ], ], + 'description' => '', ], ], ], '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' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"15\\",\\n \\"RequestId\\": \\"19B824E0-690D-5A78-9992-5398C2F43694\\",\\n \\"DBClusterId\\": \\"amv-xxxx\\",\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"Cost\\",\\n \\"Results\\": [\\n {\\n \\"PatternId\\": \\"2803084667741875187\\",\\n \\"SQLPattern\\": \\"SELECT `tsid`nFROM `prod_ods_marketing_engine_material`nWHERE `tsid` = ?nLIMIT ?\\",\\n \\"Detail\\": \\"检测到2个totalTime指标异常Pattern，可能导致CPU使用率增高，或者查询变慢，影响系统稳定性，请到监控页面使用一键诊断查看详情，并进行优化\\",\\n \\"RelatedMetrics\\": \\"最大查询耗时：1.43s\\\\n最大峰值内存：20.73MB\\\\n最大表读取数据量：10.12MB\\",\\n \\"User\\": \\"test\\",\\n \\"AccessIp\\": \\"172.16.133.168\\",\\n \\"Tables\\": \\"dw_student_exam.ods_school_queanal\\",\\n \\"QueryCount\\": 72,\\n \\"FailedCount\\": 7\\n }\\n ]\\n }\\n ]\\n}","type":"json"}]', - 'title' => '查询异常模式检测', - ], - 'DescribeInclinedNodes' => [ - 'summary' => '查询所有存储节点的磁盘水位。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '接入节点检测', + 'summary' => '查看接入层诊断结果。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeControllerDetection'], + ], ], - 'tags' => [ - 'Perth', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeControllerDetection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"10\\",\\n \\"RequestId\\": \\"257FAE29-ED5F-586C-94E4-43BD1392F238\\",\\n \\"DBClusterId\\": \\"amv-xxx\\",\\n \\"DetectionItems\\": [\\n {\\n \\"Message\\": \\"A CPU increase is detected on the access node.\\",\\n \\"Name\\": \\"CPU增高检测\\",\\n \\"Status\\": \\"NORMAL\\\\nWARNING\\\\nCRITICAL\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'DescribeDBClusterAttribute' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -15443,48 +10707,18 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '217356', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '130313', + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-wz9jd******d1765', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'>您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'Lang', - 'in' => 'query', - 'schema' => [ - 'description' => '设置下载文件的文件标题以及部分错误信息的语言，支持如下语言：'."\n" - .'- **zh**：简体中文。'."\n" - .'- **en**：英文。'."\n" - .'- **ja**：日语。'."\n" - .'- **zh-tw**：繁体中文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + .'> 调用[DescribeDBClusters](~~454250~~)接口可以查询集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-wz9509beptiz****'], ], ], 'responses' => [ @@ -15492,64 +10726,247 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'C0BF6685-0519-543E-90F8-DB8949E4D5F2', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD'], 'Items' => [ - 'description' => '列信息。', - 'type' => 'array', - 'items' => [ - 'description' => '存储节点信息。', - 'type' => 'object', - 'properties' => [ - 'Node' => [ - 'description' => '存储节点编号。', - 'type' => 'string', - 'example' => 'Node1', - ], - 'DiskUsageRatio' => [ - 'description' => '存储节点磁盘水位。', - 'type' => 'string', - 'example' => '90.5', + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'DBCluster' => [ + 'description' => '<props="china">企业版、基础版集群信息列表。</props>'."\n" + .'<props="intl">湖仓版集群信息列表。</props>', + 'type' => 'array', + 'items' => [ + 'description' => '集群详情。', + 'type' => 'object', + 'properties' => [ + 'CreationTime' => ['description' => '集群创建时间。UTC时间，格式为`yyyy-MM-ddThh:mm:ssZ`。', 'type' => 'string', 'example' => '2022-07-01T09:50:18Z'], + 'Expired' => ['description' => '包年包月集群是否过期。取值说明：'."\n" + .'- **true**：已过期。'."\n" + .'- **false**：未过期。'."\n" + .'> - 如果集群已过期，在一定时间内集群会被锁定甚至释放。建议您进行续费操作，详情请参见[续费说明](~~135248~~)。'."\n" + .'- 按量付费集群不返回此参数。', 'type' => 'string', 'example' => 'false'], + 'MaintainTime' => ['description' => '集群的可维护时间。UTC时间，格式为`HH:mmZ-HH:mmZ`。'."\n" + .'> 更多关于可维护时间段的信息，请参见[设置可维护时间段](~~122569~~)。', 'type' => 'string', 'example' => '04:00Z-05:00Z'], + 'PayType' => ['description' => '集群付费类型，取值说明：'."\n" + .'* **Postpaid**：按量付费。'."\n" + .'* **Prepaid**：包年包月。', 'type' => 'string', 'example' => 'Prepaid'], + 'Tags' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Tag' => [ + 'description' => '标签列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => '标签键。'."\n" + .'> 您可以调用[TagResources](~~179253~~)接口为目标集群创建标签。', 'type' => 'string', 'example' => 'tag1'], + 'Value' => ['description' => '标签值。', 'type' => 'string', 'example' => 'test1'], + ], + 'description' => '', + ], + ], + ], + 'description' => '', + ], + 'Mode' => ['description' => '集群模式。默认返回**flexible**，表示弹性模式集群。', 'type' => 'string', 'example' => 'flexible'], + 'Port' => ['description' => '集群端口号。', 'type' => 'integer', 'format' => 'int32', 'example' => '3306'], + 'LockMode' => ['description' => '集群的锁定模式，取值说明：'."\n" + .'- **Unlock**：未锁定。'."\n" + .'- **ManualLock**：手动触发锁定。'."\n" + .'- **LockByExpiration**：集群到期自动锁定。', 'type' => 'string', 'example' => 'ManualLock'], + 'EngineVersion' => ['description' => '集群引擎版本。', 'type' => 'string', 'example' => '3.1.16', 'default' => '3.1.7.0'], + 'StorageResource' => ['description' => '存储预留资源规格。1 ACU约等于1核4 GB。存储资源用于数据读写，增加该资源能提高集群读写能力。', 'type' => 'string', 'example' => '24ACU'], + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</prop', 'type' => 'string', 'example' => 'amv-wz9509beptiz****'], + 'ConnectionString' => ['description' => '集群的VPC地址。', 'type' => 'string', 'example' => 'amv-wz9509beptiz****.ads.aliyuncs.com'], + 'DBClusterType' => ['description' => '集群类型。默认返回**Common**，表示常规集群。', 'type' => 'string', 'example' => 'Common'], + 'CommodityCode' => ['description' => '商品付费类型，取值说明：'."\n" + .'- **ads**：按量付费商品。'."\n" + .'- **ads_pre**：包年包月商品。', 'type' => 'string', 'example' => 'ads_pre'], + 'ExpireTime' => ['description' => '集群到期时间。'."\n" + .'- 若集群付费类型为包年包月，则返回实际到期时间。'."\n" + .'- 若集群付费类型为按量付费，则返回为空。', 'type' => 'string', 'example' => '2022-10-01T09:50:18Z'], + 'LockReason' => ['description' => '集群锁定原因。'."\n" + .'> 仅当集群被锁定时会返回该参数，固定为**instance_expire**。', 'type' => 'string', 'example' => 'instance_expire'], + 'VPCId' => ['description' => '专有网络（VPC）ID。', 'type' => 'string', 'example' => 'vpc-bp13h7uzhulpu****'], + 'ComputeResource' => ['description' => '计算预留资源规格。1 ACU约等于1核4 GB。计算资源用于数据计算，增加计算资源能加快查询速度，可以根据集群实际性能按需弹性扩缩。', 'type' => 'string', 'example' => '16ACU'], + 'RegionId' => ['description' => '集群所在的地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'VSwitchId' => ['description' => '交换机ID。', 'type' => 'string', 'example' => 'vsw-uf629gydd54ld****'], + 'DBVersion' => ['description' => 'AnalyticDB MySQL集群的版本，当前仅支持**5.0**版本。', 'type' => 'string', 'example' => '5.0'], + 'DBClusterStatus' => ['description' => '集群状态。取值说明：'."\n" + .'- **Preparing**：准备中'."\n" + .'- **Creating**：创建中'."\n" + .'- **Running**：运行中'."\n" + .'- **Deleting**：删除中'."\n" + .'- **Restoring**：备份恢复中'."\n" + .'- **ClassChanging**：变配中'."\n" + .'- **NetAddressCreating**：创建网络中'."\n" + .'- **NetAddressDeleting**：删除网络中'."\n" + .'- **NetAddressModifying**：修改网络中', 'type' => 'string', 'example' => 'Running'], + 'ResourceGroupId' => ['description' => '资源组ID。', 'type' => 'string', 'example' => 'rg-acfmyiu4ekp****'], + 'DBClusterNetworkType' => ['description' => '集群网络类型。仅支持**VPC**（专有网络）类型。', 'type' => 'string', 'example' => 'VPC', 'default' => 'VPC'], + 'DBClusterDescription' => ['description' => '集群的描述信息。', 'type' => 'string', 'example' => 'adb_test'], + 'UserENIStatus' => ['description' => '是否已启用ENI（Elastic Network Interface，弹性网卡）网络，取值说明：'."\n" + .'- **true**：已启用。'."\n" + .'- **false**：未启用。', 'type' => 'boolean', 'example' => 'false'], + 'ZoneId' => ['description' => '集群所在的可用区ID。', 'type' => 'string', 'example' => 'cn-hangzhou-h'], + 'Engine' => ['description' => '集群引擎，固定为**AnalyticDB**。', 'type' => 'string', 'example' => 'AnalyticDB'], + 'ReservedACU' => ['description' => '集群剩余可分配计算预留资源。1 ACU约等于1核4 GB。', 'type' => 'string', 'example' => '24ACU'], + 'ComputeResourceTotal' => ['description' => '集群计算总资源量。1 ACU约等于1核4 GB。', 'type' => 'string', 'example' => '48ACU'], + 'StorageResourceTotal' => ['description' => '集群存储总资源量。1 ACU约等于1核4 GB。', 'type' => 'string', 'example' => '24ACU'], + 'SupportedFeatures' => [ + 'description' => '预留参数，不涉及。', + 'type' => 'object', + 'additionalProperties' => ['type' => 'string', 'description' => '预留参数，不涉及。', 'example' => '预留参数，不涉及。'], + ], + 'ProductForm' => [ + 'description' => '预留参数，不涉及。', + 'type' => 'string', + 'example' => 'Reserved parameter. Not applicable.', + 'enum' => ['IntegrationForm', 'LegacyForm'], + ], + 'ReservedNodeSize' => ['description' => '预留参数，不涉及。', 'type' => 'string', 'example' => 'Reserved parameter. Not applicable.'], + 'ReservedNodeCount' => ['description' => '预留参数，不涉及。', 'type' => 'integer', 'format' => 'int32', 'example' => 'Reserved parameter. Not applicable.'], + 'ClickhouseEngineEnabled' => [ + 'description' => 'ClickHouse宽表引擎是否开启。'."\n" + .'- **true**: 已开启Clickhouse宽表引擎。'."\n" + .'- **false**: 未开启Clickhouse宽表引擎。', + 'type' => 'boolean', + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], + 'example' => 'true', + ], + 'AINodeNumber' => ['description' => 'AI节点数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '3'], + 'ProductVersion' => ['description' => '产品版本。取值为：'."\n" + .'- **BasicVersion**：基础版。'."\n" + .'- **EnterpriseVersion**：企业版。', 'type' => 'string', 'example' => 'BasicVersion'], + 'KmsId' => ['description' => '用于加密云盘数据的密钥ID。'."\n" + .'> 仅当AnalyticDB MySQL集群开启云盘加密时才会返回该参数。', 'type' => 'string', 'example' => 'e1935511-cf88-1123-a0f8-1be8d251****'], + 'TaskInfo' => [ + 'description' => '任务信息。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '任务名称。', 'type' => 'string', 'example' => 'ScaleUpDBCluster'], + 'Status' => [ + 'description' => '任务状态，取值为：'."\n" + .'* NOT_RUN：等待运行。'."\n" + .'* RUNNING：运行中。'."\n" + .'* SUCCEED：已结束。', + 'type' => 'string', + 'example' => 'RUNNING', + 'enum' => ['RUNNING', 'SUCCEED', 'NOT_RUN'], + ], + 'Progress' => ['description' => '任务进度，单位：%。', 'type' => 'string', 'example' => '10'], + 'StepList' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'StepList' => [ + 'description' => '任务步骤。', + 'type' => 'array', + 'items' => [ + 'description' => '任务步骤。', + 'type' => 'object', + 'properties' => [ + 'StepName' => ['description' => '步骤名称。', 'type' => 'string', 'example' => 'PrepareResources'], + 'StepDesc' => ['description' => '步骤描述。', 'type' => 'string', 'example' => 'Prepare resources'], + 'StepStatus' => [ + 'description' => '步骤状态，取值为：'."\n" + .'* NOT_RUN：等待运行。'."\n" + .'* RUNNING：运行中。'."\n" + .'* SUCCEED：已结束。', + 'type' => 'string', + 'example' => 'RUNNING', + 'enum' => ['RUNNING', 'SUCCEED', 'NOT_RUN'], + ], + 'StepProgress' => ['description' => '步骤进度，单位：%。', 'type' => 'string', 'example' => '50'], + 'StartTime' => ['description' => '步骤开始时间，格式为 YYYY-MM-DDThh:mm:ssZ。', 'type' => 'string', 'example' => '2024-03-10T09:28:34Z'], + 'EndTime' => ['description' => '步骤结束时间，格式为 YYYY-MM-DDThh:mm:ssZ。', 'type' => 'string', 'example' => '2024-03-10T10:28:34Z'], + ], + ], + ], + ], + 'description' => '', + ], + ], + ], + 'UserENIVpcId' => ['description' => 'ENI的VPC信息。', 'type' => 'string', 'example' => 'vpc-rj9hnedlfm645uj******'], + 'UserENIVSwitchOptions' => ['description' => 'ENI交换机列表。多个交换机中间用英文逗号（,）分隔。', 'type' => 'string', 'example' => 'vsw-rj9ixufmywqq98z******,vsw-rj95ij6wcz656v7******'], + 'UserENIZoneOptions' => ['description' => 'ENI可用区信息。多个可用区之间用英文逗号（,）分隔。', 'type' => 'string', 'example' => 'cn-hangzhou-k,cn-hangzhou-h'], + 'SecondaryZoneId' => ['description' => '备可用区ID。', 'type' => 'string', 'example' => 'cn-hangzhou-k'], + 'SecondaryVSwitchId' => ['description' => '备虚拟交换机ID。', 'type' => 'string', 'example' => 'vsw-8vbl7kfaxxxxx'], + 'DiskEncryption' => ['description' => '是否开启云盘加密。取值：'."\n" + ."\n" + .'- true：是。'."\n" + .'- false：否。', 'type' => 'boolean', 'example' => 'false'], + 'ClickhouseEngineCacheSize' => ['description' => 'ClickHouse宽表引擎的缓存大小，单位：GB。若返回-1，则表示未开启宽表引擎。 若返回具体数字，则表示云盘缓存空间大小。', 'type' => 'integer', 'format' => 'int32', 'example' => '100'], + 'AINodeSpec' => ['description' => 'AI节点规格。', 'type' => 'string', 'example' => 'ADB.MLGrand.5'], + ], ], ], ], + 'description' => '', ], ], + 'description' => '', ], ], ], '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' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C0BF6685-0519-543E-90F8-DB8949E4D5F2\\",\\n \\"Items\\": [\\n {\\n \\"Node\\": \\"Node1\\",\\n \\"DiskUsageRatio\\": \\"90.5\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '查询存储节点磁盘水位', + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '查询集群详细信息', + 'summary' => '查看指定集群的详细信息。', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2025-06-25T11:59:52.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2025-03-04T16:10:35.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-12-25T18:09:42.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-10-25T02:08:24.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-06-13T13:53:51.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-05-28T03:05:13.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-05-23T06:30:01.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-05-09T02:08:18.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-09-26T07:36:40.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-07-27T11:22:29.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-11-03T03:01:24.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-09-27T12:01:07.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-06-11T16:52:03.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBClusterAttribute'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeDBClusterAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\",\\n \\"Items\\": {\\n \\"DBCluster\\": [\\n {\\n \\"CreationTime\\": \\"2022-07-01T09:50:18Z\\",\\n \\"Expired\\": \\"false\\",\\n \\"MaintainTime\\": \\"04:00Z-05:00Z\\",\\n \\"PayType\\": \\"Prepaid\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"Key\\": \\"tag1\\",\\n \\"Value\\": \\"test1\\"\\n }\\n ]\\n },\\n \\"Mode\\": \\"flexible\\",\\n \\"Port\\": 3306,\\n \\"LockMode\\": \\"ManualLock\\",\\n \\"EngineVersion\\": \\"3.1.16\\",\\n \\"StorageResource\\": \\"24ACU\\",\\n \\"DBClusterId\\": \\"amv-wz9509beptiz****\\",\\n \\"ConnectionString\\": \\"amv-wz9509beptiz****.ads.aliyuncs.com\\",\\n \\"DBClusterType\\": \\"Common\\",\\n \\"CommodityCode\\": \\"ads_pre\\",\\n \\"ExpireTime\\": \\"2022-10-01T09:50:18Z\\",\\n \\"LockReason\\": \\"instance_expire\\",\\n \\"VPCId\\": \\"vpc-bp13h7uzhulpu****\\",\\n \\"ComputeResource\\": \\"16ACU\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"VSwitchId\\": \\"vsw-uf629gydd54ld****\\",\\n \\"DBVersion\\": \\"5.0\\",\\n \\"DBClusterStatus\\": \\"Running\\",\\n \\"ResourceGroupId\\": \\"rg-acfmyiu4ekp****\\",\\n \\"DBClusterNetworkType\\": \\"VPC\\",\\n \\"DBClusterDescription\\": \\"adb_test\\",\\n \\"UserENIStatus\\": false,\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"Engine\\": \\"AnalyticDB\\",\\n \\"ReservedACU\\": \\"24ACU\\",\\n \\"ComputeResourceTotal\\": \\"48ACU\\",\\n \\"StorageResourceTotal\\": \\"24ACU\\",\\n \\"SupportedFeatures\\": {\\n \\"key\\": \\"预留参数，不涉及。\\"\\n },\\n \\"ProductForm\\": \\"Reserved parameter. Not applicable.\\",\\n \\"ReservedNodeSize\\": \\"Reserved parameter. Not applicable.\\",\\n \\"ReservedNodeCount\\": 0,\\n \\"ClickhouseEngineEnabled\\": true,\\n \\"AINodeNumber\\": 3,\\n \\"ProductVersion\\": \\"BasicVersion\\",\\n \\"KmsId\\": \\"e1935511-cf88-1123-a0f8-1be8d251****\\",\\n \\"TaskInfo\\": {\\n \\"Name\\": \\"ScaleUpDBCluster\\",\\n \\"Status\\": \\"RUNNING\\",\\n \\"Progress\\": \\"10\\",\\n \\"StepList\\": {\\n \\"StepList\\": [\\n {\\n \\"StepName\\": \\"PrepareResources\\",\\n \\"StepDesc\\": \\"Prepare resources\\",\\n \\"StepStatus\\": \\"RUNNING\\",\\n \\"StepProgress\\": \\"50\\",\\n \\"StartTime\\": \\"2024-03-10T09:28:34Z\\",\\n \\"EndTime\\": \\"2024-03-10T10:28:34Z\\"\\n }\\n ]\\n }\\n },\\n \\"UserENIVpcId\\": \\"vpc-rj9hnedlfm645uj******\\",\\n \\"UserENIVSwitchOptions\\": \\"vsw-rj9ixufmywqq98z******,vsw-rj95ij6wcz656v7******\\",\\n \\"UserENIZoneOptions\\": \\"cn-hangzhou-k,cn-hangzhou-h\\",\\n \\"SecondaryZoneId\\": \\"cn-hangzhou-k\\",\\n \\"SecondaryVSwitchId\\": \\"vsw-8vbl7kfaxxxxx\\",\\n \\"DiskEncryption\\": false,\\n \\"ClickhouseEngineCacheSize\\": 100,\\n \\"AINodeSpec\\": \\"ADB.MLGrand.5\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeDBClusterAttributeResponse>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n <Items>\\n <CreationTime>2022-07-01T09:50:18Z</CreationTime>\\n <Expired>false</Expired>\\n <MaintainTime>04:00Z-05:00Z</MaintainTime>\\n <PayType>Prepaid</PayType>\\n <Mode>flexible</Mode>\\n <Port>3306</Port>\\n <LockMode>ManualLock</LockMode>\\n <EngineVersion>3.1.16</EngineVersion>\\n <StorageResource>24ACU</StorageResource>\\n <DBClusterId>amv-wz9509beptiz****</DBClusterId>\\n <ConnectionString>amv-wz9509beptiz****.ads.aliyuncs.com</ConnectionString>\\n <DBClusterType>Common</DBClusterType>\\n <CommodityCode>ads_pre</CommodityCode>\\n <ExpireTime>2022-10-01T09:50:18Z</ExpireTime>\\n <LockReason>instance_expire</LockReason>\\n <VPCId>vpc-bp13h7uzhulpu****</VPCId>\\n <ComputeResource>16ACU</ComputeResource>\\n <RegionId>cn-hangzhou</RegionId>\\n <VSwitchId>vsw-uf629gydd54ld****</VSwitchId>\\n <DBVersion>5.0</DBVersion>\\n <DBClusterStatus>Running</DBClusterStatus>\\n <ResourceGroupId>rg-acfmyiu4ekp****</ResourceGroupId>\\n <DBClusterNetworkType>VPC</DBClusterNetworkType>\\n <DBClusterDescription>adb_test</DBClusterDescription>\\n <UserENIStatus>false</UserENIStatus>\\n <ZoneId>cn-hangzhou-h</ZoneId>\\n <Engine>AnalyticDB</Engine>\\n <ReservedACU>24ACU</ReservedACU>\\n <ComputeResourceTotal>48ACU</ComputeResourceTotal>\\n <StorageResourceTotal>24ACU</StorageResourceTotal>\\n </Items>\\n</DescribeDBClusterAttributeResponse>","errorExample":""}]', ], 'DescribeDBClusterHealthStatus' => [ 'summary' => '查看集群的健康状态。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -15562,36 +10979,22 @@ 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '151720', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'>您可以调用[DescribeDBClusters](~~612397~~)接口查看集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-uf6o6m8p6x7v****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'>您可以调用[DescribeDBClusters](~~612397~~)接口查看集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-uf6o6m8p6x7v****'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'>您可以调用[DescribeRegions](~~143074~~)接口查看集群的地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'>您可以调用[DescribeRegions](~~143074~~)接口查看集群的地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ @@ -15603,159 +11006,91 @@ 'description' => '实例接入节点状态的列表。', 'type' => 'object', 'properties' => [ - 'ActiveCount' => [ - 'description' => '健康节点个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'UnavailableCount' => [ - 'description' => '不可用节点个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'RiskCount' => [ - 'description' => '风险节点个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'ExpectedCount' => [ - 'description' => '接入节点总个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'Status' => [ - 'description' => '实例接入节点状态，取值说明：'."\n" - .'- **RISK**：风险。'."\n" - .'- **NORMAL**：健康。'."\n" - .'- **UNAVAILABLE**：不可用。', - 'type' => 'string', - 'example' => 'UNAVAILABLE', - ], + 'ActiveCount' => ['description' => '健康节点个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'UnavailableCount' => ['description' => '不可用节点个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'RiskCount' => ['description' => '风险节点个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'ExpectedCount' => ['description' => '接入节点总个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'Status' => ['description' => '实例接入节点状态，取值说明：'."\n" + .'- **RISK**：风险。'."\n" + .'- **NORMAL**：健康。'."\n" + .'- **UNAVAILABLE**：不可用。', 'type' => 'string', 'example' => 'UNAVAILABLE'], ], ], 'Executor' => [ 'description' => '计算节点组健康状态列表。', 'type' => 'object', 'properties' => [ - 'ActiveCount' => [ - 'description' => '健康节点个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'UnavailableCount' => [ - 'description' => '不可用节点个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'RiskCount' => [ - 'description' => '风险节点个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'ExpectedCount' => [ - 'description' => '计算节点总个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'Status' => [ - 'description' => '计算节点组健康状态，取值说明：'."\n" - .'- **RISK**：风险。'."\n" - .'- **NORMAL**：健康。'."\n" - .'- **UNAVAILABLE**：不可用。', - 'type' => 'string', - 'example' => 'UNAVAILABLE', - ], + 'ActiveCount' => ['description' => '健康节点个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'UnavailableCount' => ['description' => '不可用节点个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'RiskCount' => ['description' => '风险节点个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'ExpectedCount' => ['description' => '计算节点总个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'Status' => ['description' => '计算节点组健康状态，取值说明：'."\n" + .'- **RISK**：风险。'."\n" + .'- **NORMAL**：健康。'."\n" + .'- **UNAVAILABLE**：不可用。', 'type' => 'string', 'example' => 'UNAVAILABLE'], ], ], 'Worker' => [ 'description' => '存储节点健康状态列表。', 'type' => 'object', 'properties' => [ - 'ActiveCount' => [ - 'description' => '健康存储节点组个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'UnavailableCount' => [ - 'description' => '不可用存储节点组个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'RiskCount' => [ - 'description' => '风险存储节点组个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'ExpectedCount' => [ - 'description' => '存储节点组总个数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'Status' => [ - 'description' => '存储节点组健康状态，取值说明：'."\n" - .'- **RISK**：风险。'."\n" - .'- **NORMAL**：健康。'."\n" - .'- **UNAVAILABLE**：不可用。', - 'type' => 'string', - 'example' => 'UNAVAILABLE', - ], + 'ActiveCount' => ['description' => '健康存储节点组个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'UnavailableCount' => ['description' => '不可用存储节点组个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'RiskCount' => ['description' => '风险存储节点组个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'ExpectedCount' => ['description' => '存储节点组总个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'Status' => ['description' => '存储节点组健康状态，取值说明：'."\n" + .'- **RISK**：风险。'."\n" + .'- **NORMAL**：健康。'."\n" + .'- **UNAVAILABLE**：不可用。', 'type' => 'string', 'example' => 'UNAVAILABLE'], ], ], - 'InstanceStatus' => [ - 'description' => '集群的健康状态，取值说明：'."\n" - .'- **RISK**：风险。'."\n" - .'- **NORMAL**：健康。'."\n" - .'- **UNAVAILABLE**：不可用。'."\n" - .'>当集群的实例接入节点状态、计算节点组健康状态和存储节点组健康状态，三个健康状态均为**健康**且实例探活成功，则集群的健康状态为**健康**；三个健康状态中包含**风险**时，则集群的健康状态为**风险**；三个健康状态中包含**不可用**时，则集群的健康状态为**不可用**。', - 'type' => 'string', - 'example' => 'NORMAL', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CAV', - ], - 'AccessDeniedDetail' => [ - 'type' => 'string', - ], + 'InstanceStatus' => ['description' => '集群的健康状态，取值说明：'."\n" + .'- **RISK**：风险。'."\n" + .'- **NORMAL**：健康。'."\n" + .'- **UNAVAILABLE**：不可用。'."\n" + .'>当集群的实例接入节点状态、计算节点组健康状态和存储节点组健康状态，三个健康状态均为**健康**且实例探活成功，则集群的健康状态为**健康**；三个健康状态中包含**风险**时，则集群的健康状态为**风险**；三个健康状态中包含**不可用**时，则集群的健康状态为**不可用**。', 'type' => 'string', 'example' => 'NORMAL'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CAV'], + 'AccessDeniedDetail' => ['description' => '鉴权失败信息', 'type' => 'string', 'example' => 'Authentication failed.'], ], + 'description' => '', ], ], ], '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' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"CS\\": {\\n \\"ActiveCount\\": 0,\\n \\"UnavailableCount\\": 1,\\n \\"RiskCount\\": 0,\\n \\"ExpectedCount\\": 1,\\n \\"Status\\": \\"UNAVAILABLE\\"\\n },\\n \\"Executor\\": {\\n \\"ActiveCount\\": 0,\\n \\"UnavailableCount\\": 1,\\n \\"RiskCount\\": 0,\\n \\"ExpectedCount\\": 1,\\n \\"Status\\": \\"UNAVAILABLE\\"\\n },\\n \\"Worker\\": {\\n \\"ActiveCount\\": 0,\\n \\"UnavailableCount\\": 1,\\n \\"RiskCount\\": 1,\\n \\"ExpectedCount\\": 1,\\n \\"Status\\": \\"UNAVAILABLE\\"\\n },\\n \\"InstanceStatus\\": \\"NORMAL\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CAV\\",\\n \\"AccessDeniedDetail\\": \\"\\"\\n}","type":"json"}]', 'title' => '查询集群健康检查状态', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-05-14T08:33:01.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-09-01T03:15:34.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBClusterHealthStatus'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDBClusterHealthStatus', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"CS\\": {\\n \\"ActiveCount\\": 0,\\n \\"UnavailableCount\\": 1,\\n \\"RiskCount\\": 0,\\n \\"ExpectedCount\\": 1,\\n \\"Status\\": \\"UNAVAILABLE\\"\\n },\\n \\"Executor\\": {\\n \\"ActiveCount\\": 0,\\n \\"UnavailableCount\\": 1,\\n \\"RiskCount\\": 0,\\n \\"ExpectedCount\\": 1,\\n \\"Status\\": \\"UNAVAILABLE\\"\\n },\\n \\"Worker\\": {\\n \\"ActiveCount\\": 0,\\n \\"UnavailableCount\\": 1,\\n \\"RiskCount\\": 1,\\n \\"ExpectedCount\\": 1,\\n \\"Status\\": \\"UNAVAILABLE\\"\\n },\\n \\"InstanceStatus\\": \\"NORMAL\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CAV\\",\\n \\"AccessDeniedDetail\\": \\"Authentication failed.\\"\\n}","type":"json"}]', ], 'DescribeDBClusterPerformance' => [ 'summary' => '查看目标集群的性能数据。', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -15768,81 +11103,44 @@ 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '131503', - 'abilityTreeNodes' => [ - 'FEATUREadsCVPI8C', - ], + 'abilityTreeNodes' => ['FEATUREadsCVPI8C'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - .'>您可以调用[DescribeDBClusters](~~~612397~~~)接口查看目标地域下所有集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1hx5n1o8f61****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + .'>您可以调用[DescribeDBClusters](~~~612397~~~)接口查看目标地域下所有集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1hx5n1o8f61****'], ], [ 'name' => 'Key', 'in' => 'query', - 'schema' => [ - 'description' => '需要查询的性能指标名称（监控项Key），多个值之间用英文逗号（,）分隔。支持查询的指标详情请参见[监控项概览](~~2863211~~)。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'AnalyticDB_CPU_Usage_Percentage', - 'default' => 'AnalyticDB_CPU_Usage_Percentage', - ], + 'schema' => ['description' => '需要查询的性能指标名称（监控项Key），多个值之间用英文逗号（,）分隔。支持查询的指标详情请参见[监控项概览](~~2863211~~)。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'AnalyticDB_CPU_Usage_Percentage', 'default' => 'AnalyticDB_CPU_Usage_Percentage'], ], [ 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间。UTC时间，格式为<i>yyyy-MM-ddTHH:mmZ</i>。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2022-03-10T23:56Z', - ], + 'schema' => ['description' => '查询开始时间。UTC时间，格式为<i>yyyy-MM-ddTHH:mmZ</i>。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2022-03-10T23:56Z'], ], [ 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间。UTC时间，格式为<i>yyyy-MM-ddTHH:mmZ</i>。'."\n" - ."\n" - .'> 查询结束时间需晚于开始时间，且开始时间和结束时间的时间间隔不能超过两天。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2022-03-11T15:01Z', - ], + 'schema' => ['description' => '查询结束时间。UTC时间，格式为<i>yyyy-MM-ddTHH:mmZ</i>。'."\n" + ."\n" + .'> 查询结束时间需晚于开始时间，且开始时间和结束时间的时间间隔不能超过两天。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2022-03-11T15:01Z'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~612393~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~612393~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'ResourcePools', 'in' => 'query', - 'schema' => [ - 'description' => '资源组。', - 'type' => 'string', - 'required' => false, - 'example' => 'user_default', - ], + 'schema' => ['description' => '资源组。', 'type' => 'string', 'required' => false, 'example' => 'user_default'], ], ], 'responses' => [ @@ -15850,27 +11148,11 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'EndTime' => [ - 'description' => '查询结束时间。UTC时间，格式为<i>yyyy-MM-ddTHH:mmZ</i>。', - 'type' => 'string', - 'example' => '2022-03-11T15:01Z', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'BD8C3096-8BC6-51DF-A4AB-BACD9DC10435', - ], - 'StartTime' => [ - 'description' => '查询开始时间。UTC时间，格式为<i>yyyy-MM-ddTHH:mmZ</i>。', - 'type' => 'string', - 'example' => '2022-03-10T23:56Z', - ], - 'DBClusterId' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', - 'type' => 'string', - 'example' => 'amv-bp1hx5n1o8f61****', - ], + 'EndTime' => ['description' => '查询结束时间。UTC时间，格式为<i>yyyy-MM-ddTHH:mmZ</i>。', 'type' => 'string', 'example' => '2022-03-11T15:01Z'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'BD8C3096-8BC6-51DF-A4AB-BACD9DC10435'], + 'StartTime' => ['description' => '查询开始时间。UTC时间，格式为<i>yyyy-MM-ddTHH:mmZ</i>。', 'type' => 'string', 'example' => '2022-03-10T23:56Z'], + 'DBClusterId' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', 'type' => 'string', 'example' => 'amv-bp1hx5n1o8f61****'], 'Performances' => [ 'description' => '集群性能指标列表。', 'type' => 'array', @@ -15878,16 +11160,8 @@ 'description' => '列表。', 'type' => 'object', 'properties' => [ - 'Key' => [ - 'description' => '性能指标名称。', - 'type' => 'string', - 'example' => 'AnalyticDB_CPU_Usage_Percentage', - ], - 'Unit' => [ - 'description' => '监控指标的单位。', - 'type' => 'string', - 'example' => '%', - ], + 'Key' => ['description' => '性能指标名称。', 'type' => 'string', 'example' => 'AnalyticDB_CPU_Usage_Percentage'], + 'Unit' => ['description' => '监控指标的单位。', 'type' => 'string', 'example' => '%'], 'Series' => [ 'description' => '性能数据列表。', 'type' => 'array', @@ -15898,33 +11172,19 @@ 'Values' => [ 'description' => '不同时间点下的性能值详情。', 'type' => 'array', - 'items' => [ - 'description' => '不同时间点下的性能值详情。', - 'type' => 'string', - 'example' => '['."\n" - .' [ '."\n" - .' "2023-06-27T13:21:00+08:00","0.1250" '."\n" - .' ], '."\n" - .' [ '."\n" - .' "2022-03-11T10:00:42.739Z","0.3125" '."\n" - .' ]...'."\n" - .']', - ], - ], - 'Name' => [ - 'description' => '性能指标名称（监控指标Value Name）。详情请参见[监控项概览](~~2863211~~)。', - 'type' => 'string', - 'example' => 'AnalyticDB_Storage_CPU_Avg_Usage_Percentage', - ], - 'Tags' => [ - 'description' => '标签值。', - 'type' => 'string', - 'example' => "\n" - .'{instance_name: "am-***"}', - ], - 'TranslateKey' => [ - 'type' => 'string', + 'items' => ['description' => '不同时间点下的性能值详情。', 'type' => 'string', 'example' => '['."\n" + .' [ '."\n" + .' "2023-06-27T13:21:00+08:00","0.1250" '."\n" + .' ], '."\n" + .' [ '."\n" + .' "2022-03-11T10:00:42.739Z","0.3125" '."\n" + .' ]...'."\n" + .']'], ], + 'Name' => ['description' => '性能指标名称（监控指标Value Name）。详情请参见[监控项概览](~~2863211~~)。', 'type' => 'string', 'example' => 'AnalyticDB_Storage_CPU_Avg_Usage_Percentage'], + 'Tags' => ['description' => '标签值。', 'type' => 'string', 'example' => "\n" + .'{instance_name: "am-***"}'], + 'TranslateKey' => ['description' => '做国际化翻译的key，日常不需要关注', 'type' => 'string', 'example' => 'AnalyticDB_RP_WaitTime'], ], ], ], @@ -15932,162 +11192,129 @@ ], ], ], + 'description' => '', ], ], ], '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' => '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', + 'staticInfo' => ['returnType' => 'synchronous'], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"EndTime\\": \\"2022-03-11T15:01Z\\",\\n \\"RequestId\\": \\"BD8C3096-8BC6-51DF-A4AB-BACD9DC10435\\",\\n \\"StartTime\\": \\"2022-03-10T23:56Z\\",\\n \\"DBClusterId\\": \\"amv-bp1hx5n1o8f61****\\",\\n \\"Performances\\": [\\n {\\n \\"Key\\": \\"AnalyticDB_CPU_Usage_Percentage\\",\\n \\"Unit\\": \\"%\\",\\n \\"Series\\": [\\n {\\n \\"Values\\": [\\n \\"[\\\\n [ \\\\n \\\\\\"2023-06-27T13:21:00+08:00\\\\\\",\\\\\\"0.1250\\\\\\" \\\\n ], \\\\n [ \\\\n \\\\\\"2022-03-11T10:00:42.739Z\\\\\\",\\\\\\"0.3125\\\\\\" \\\\n ]...\\\\n]\\"\\n ],\\n \\"Name\\": \\"AnalyticDB_Storage_CPU_Avg_Usage_Percentage\\",\\n \\"Tags\\": \\"\\\\n{instance_name: \\\\\\"am-***\\\\\\"}\\",\\n \\"TranslateKey\\": \\"\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeDBClusterPerformanceResponse>\\n <EndTime>2022-03-11T15:01:00Z</EndTime>\\n <RequestId>BD8C3096-8BC6-51DF-A4AB-BACD9DC10435</RequestId>\\n <StartTime>2022-03-10T23:56:00Z</StartTime>\\n <DBClusterId>am-bp1hx5n1o8f61****</DBClusterId>\\n <Performances>\\n <Key>AnalyticDB_CPU</Key>\\n <Unit>%</Unit>\\n <Series>\\n <Values>[ \\"2022-03-11T03:00:12.72Z\\", \\"0.1250\\" ], [ \\"2022-03-11T10:00:42.739Z\\", \\"0.3125\\" ]</Values>\\n <Name>worker_avg_cpu_used</Name>\\n </Series>\\n </Performances>\\n</DescribeDBClusterPerformanceResponse>","errorExample":""}]', 'title' => '查看集群性能数据', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeClusterResourceUsage' => [ - 'summary' => '调用DescribeClusterResourceUsage接口查询集群资源使用情况。', - 'methods' => [ - 'get', + 'changeSet' => [ + ['createdAt' => '2024-12-16T07:27:17.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-09-13T12:07:35.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-09-01T08:50:45.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2022-03-22T08:51:02.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBClusterPerformance'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDBClusterPerformance', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"EndTime\\": \\"2022-03-11T15:01Z\\",\\n \\"RequestId\\": \\"BD8C3096-8BC6-51DF-A4AB-BACD9DC10435\\",\\n \\"StartTime\\": \\"2022-03-10T23:56Z\\",\\n \\"DBClusterId\\": \\"amv-bp1hx5n1o8f61****\\",\\n \\"Performances\\": [\\n {\\n \\"Key\\": \\"AnalyticDB_CPU_Usage_Percentage\\",\\n \\"Unit\\": \\"%\\",\\n \\"Series\\": [\\n {\\n \\"Values\\": [\\n \\"[\\\\n [ \\\\n \\\\\\"2023-06-27T13:21:00+08:00\\\\\\",\\\\\\"0.1250\\\\\\" \\\\n ], \\\\n [ \\\\n \\\\\\"2022-03-11T10:00:42.739Z\\\\\\",\\\\\\"0.3125\\\\\\" \\\\n ]...\\\\n]\\"\\n ],\\n \\"Name\\": \\"AnalyticDB_Storage_CPU_Avg_Usage_Percentage\\",\\n \\"Tags\\": \\"\\\\n{instance_name: \\\\\\"am-***\\\\\\"}\\",\\n \\"TranslateKey\\": \\"AnalyticDB_RP_WaitTime\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeDBClusterPerformanceResponse>\\n <EndTime>2022-03-11T15:01:00Z</EndTime>\\n <RequestId>BD8C3096-8BC6-51DF-A4AB-BACD9DC10435</RequestId>\\n <StartTime>2022-03-10T23:56:00Z</StartTime>\\n <DBClusterId>am-bp1hx5n1o8f61****</DBClusterId>\\n <Performances>\\n <Key>AnalyticDB_CPU</Key>\\n <Unit>%</Unit>\\n <Series>\\n <Values>[ \\"2022-03-11T03:00:12.72Z\\", \\"0.1250\\" ], [ \\"2022-03-11T10:00:42.739Z\\", \\"0.3125\\" ]</Values>\\n <Name>worker_avg_cpu_used</Name>\\n </Series>\\n </Performances>\\n</DescribeDBClusterPerformanceResponse>","errorExample":""}]', + ], + 'DescribeDBClusterSSL' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '220651', + 'abilityTreeNodes' => ['FEATUREadsG383TB'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~612397~~)接口查看集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], - ], - [ - 'name' => 'StartTime', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。', - 'type' => 'string', - 'required' => true, - 'example' => '2022-11-29T10:20Z', - ], + 'schema' => ['description' => '地域ID。'."\n" + ."\n" + .'> 您可以调用[DescribeRegions](~~612393~~)接口查看集群所属的地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'EndTime', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间，UTC时间，格式：yyyy-MM-ddTHH:mmZ。', - 'type' => 'string', - 'required' => true, - 'example' => '2022-08-22T01:06:00Z', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-************'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', - 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEAW', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Data' => [ - 'description' => '集群资源使用详情。', - 'type' => 'object', - 'properties' => [ - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-uf6dj23rt5zo9s9d', - ], - 'StartTime' => [ - 'description' => '查询开始时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。', - 'type' => 'string', - 'example' => '2023-03-14T03:42:15Z', - ], - 'EndTime' => [ - 'description' => '查询结束时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。', - 'type' => 'string', - 'example' => '2023-03-23T02:31Z', - ], - 'AcuInfo' => [ - 'description' => '集群ACU资源使用情况。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '对应指标项取值的状态，取值说明：'."\n" - .'- `TotalAcuNumber`：总ACU资源数。'."\n" - .'- `ReservedAcuNumber`：预留资源ACU数。'."\n" - .'- `ReservedAcuUsageNumber`：已使用的预留资源ACU数。', - 'type' => 'string', - 'example' => 'TotalAcuNumber', - ], - 'Values' => [ - 'description' => '对应指标项在各时间点的具体取值。', - 'type' => 'array', - 'items' => [ - 'description' => '不同时间点下的性能值详情。', - 'type' => 'string', - 'example' => '16.0', - ], - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '348303D8-6F42-5141-9B00-A6EECA1E37B6'], + 'ExpireTime' => ['description' => 'SSL 证书有效期。格式：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。', 'type' => 'string', 'example' => '2022-10-11T08:16:43Z'], + 'ConnectionString' => ['description' => '受SSL保护的连接地址。', 'type' => 'string', 'example' => 'amv-*********.ads.aliyuncs.com'], + 'SSLEnabled' => ['description' => '是否开启SSL。'."\n" + .'取值： '."\n" + .'- true：开启。'."\n" + .'- false：关闭。', 'type' => 'boolean', 'example' => 'true'], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEAW\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"DBClusterId\\": \\"amv-uf6dj23rt5zo9s9d\\",\\n \\"StartTime\\": \\"2023-03-14T03:42:15Z\\",\\n \\"EndTime\\": \\"2023-03-23T02:31Z\\",\\n \\"AcuInfo\\": [\\n {\\n \\"Name\\": \\"TotalAcuNumber\\",\\n \\"Values\\": [\\n \\"16.0\\"\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '查询集群资源使用情况', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeClusterResourceDetail' => [ - 'summary' => '查询集群资源具体使用详情。', - 'methods' => [ - 'post', - 'get', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], + ], + 'title' => '查询ADB实例的SSL配置', + 'summary' => '查询集群的SSL配置情况。', + 'description' => '><warning>目前该功能处于内测阶段，控制台界面展示及API调用接口尚未稳定，可能持续变化。></warning>', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBClusterSSL'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeDBClusterSSL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"348303D8-6F42-5141-9B00-A6EECA1E37B6\\",\\n \\"ExpireTime\\": \\"2022-10-11T08:16:43Z\\",\\n \\"ConnectionString\\": \\"amv-*********.ads.aliyuncs.com\\",\\n \\"SSLEnabled\\": true\\n}","type":"json"}]', + ], + 'DescribeDBClusterSpaceSummary' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'tags' => [], 'security' => [ [ 'AK' => [], @@ -16099,169 +11326,116 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '212723', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'am-bp1jj9xqft1po****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-wz9v5sa7mm79z4l2'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', - 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], 'Data' => [ - 'description' => '集群资源具体使用详情。', + 'description' => '返回数据。', 'type' => 'object', 'properties' => [ - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-adbxxxxx', - ], - 'ComputeResource' => [ - 'description' => '计算预留资源。取值范围：0ACU～4096ACU，步长：16。1 ACU约等于1核4 GB。', - 'type' => 'string', - 'example' => '16ACU', - ], - 'FreeComputeResource' => [ - 'description' => '空闲计算预留资源。取值范围：0ACU～4096ACU，步长：16。1 ACU约等于1核4 GB。', - 'type' => 'string', - 'example' => '0ACU', + 'TotalSize' => ['description' => '总数据量，单位：Byte。'."\n" + ."\n" + .'> 计算公式为：总数据量 = 热数据总量 + 冷数据总量。', 'type' => 'string', 'example' => '8388608'], + 'HotData' => [ + 'description' => '热数据。', + 'type' => 'object', + 'properties' => [ + 'TotalSize' => ['description' => '热数据总量，单位：Byte。'."\n" + ."\n" + .'> 计算公式为：热数据总量 = 表记录数据量 + 普通索引数据量 + 主键索引数据量 + 其他。', 'type' => 'integer', 'format' => 'int64', 'example' => '4194304'], + 'DataSize' => ['description' => '表记录数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1048576'], + 'IndexSize' => ['description' => '普通索引数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1048576'], + 'PrimaryKeyIndexSize' => ['description' => '主键索引数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1048576'], + 'OtherSize' => ['description' => '其他，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1048576'], + ], ], - 'StorageResource' => [ - 'description' => '存储预留资源。取值范围：0ACU～2064ACU，步长：24。1 ACU约等于1核4 GB。', - 'type' => 'string', - 'example' => '24ACU', + 'ColdData' => [ + 'description' => '冷数据。', + 'type' => 'object', + 'properties' => [ + 'TotalSize' => ['description' => '冷数据总量，单位：Byte。'."\n" + ."\n" + .'> 计算公式为：冷数据总量 = 表记录数据量 + 普通索引数据量 + 主键索引数据量 + 其他。', 'type' => 'integer', 'format' => 'int64', 'example' => '4194304'], + 'DataSize' => ['description' => '表记录数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1048576'], + 'IndexSize' => ['description' => '普通索引数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1048576'], + 'PrimaryKeyIndexSize' => ['description' => '主键索引数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1048576'], + 'OtherSize' => ['description' => '其他，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1048576'], + ], ], - 'ResourceGroupList' => [ - 'description' => '资源组列表。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'PoolId' => [ - 'description' => '资源组ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '17', - ], - 'PoolName' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'example' => 'testadb', - ], - 'PoolType' => [ - 'description' => '资源组类型。', - 'type' => 'string', - 'example' => 'interactive', - ], - 'MinComputeResource' => [ - 'description' => '最小计算预留资源，单位为ACU。'."\n", - 'type' => 'string', - 'example' => '16ACU', - ], - 'MaxComputeResource' => [ - 'description' => '最大计算预留资源，单位为ACU。', - 'type' => 'string', - 'example' => '128ACU', - ], - 'PoolUsers' => [ - 'description' => '资源组用户。', - 'type' => 'string', - 'example' => 'user1', - ], - 'Status' => [ - 'description' => '资源组状态，取值说明：'."\n" - .'- **running**：运行中'."\n" - .'- **deleting**：删除中'."\n" - .'- **scaling**：变配中', - 'type' => 'string', - 'example' => 'running', - ], - 'ClusterSizeResource' => [ - 'description' => '预留参数(不涉及)', - 'type' => 'string', - 'example' => '0', - ], - 'MinClusterCount' => [ - 'description' => '预留参数（不涉及）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'MaxClusterCount' => [ - 'description' => '预留参数（不涉及）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'RunningClusterCount' => [ - 'description' => '预留参数（不涉及）', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'ClusterMode' => [ - 'description' => '预留参数（不涉及）', - 'type' => 'string', - 'required' => true, - 'example' => '0', - 'default' => 'Disable', - ], - 'EnableSpot' => [ - 'description' => '资源组是否开启竞价实例功能。开启竞价实例后资源单价降低，但是有概率被释放。取值：'."\n" - .'- **True**：开启竞价实例功能。'."\n" - .'- **False**：关闭竞价实例功能。'."\n" - ."\n" - .'仅Job型资源组可以为True。', - 'type' => 'boolean', - 'example' => 'true', - ], - ], + 'DataGrowth' => [ + 'description' => '数据增长量。', + 'type' => 'object', + 'properties' => [ + 'DayGrowth' => ['description' => '近1天增长量，单位：Byte。'."\n" + ."\n" + .'> 计算公式为：近1天增长量 = 当前总数据量 - 1天前总数据量。', 'type' => 'integer', 'format' => 'int64', 'example' => '1048576'], + 'WeekGrowth' => ['description' => '近7天日均增长量，单位：Byte。'."\n" + ."\n" + .'> 计算公式为：近7天日均增长量 = (当前总数据量 - 7天前总数据量) / 7。', 'type' => 'integer', 'format' => 'int64', 'example' => '1048576'], ], ], ], ], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"DBClusterId\\": \\"amv-adbxxxxx\\",\\n \\"ComputeResource\\": \\"16ACU\\",\\n \\"FreeComputeResource\\": \\"0ACU\\",\\n \\"StorageResource\\": \\"24ACU\\",\\n \\"ResourceGroupList\\": [\\n {\\n \\"PoolId\\": 17,\\n \\"PoolName\\": \\"testadb\\",\\n \\"PoolType\\": \\"interactive\\",\\n \\"MinComputeResource\\": \\"16ACU\\",\\n \\"MaxComputeResource\\": \\"128ACU\\",\\n \\"PoolUsers\\": \\"user1\\",\\n \\"Status\\": \\"running\\",\\n \\"ClusterSizeResource\\": \\"0\\",\\n \\"MinClusterCount\\": 0,\\n \\"MaxClusterCount\\": 0,\\n \\"RunningClusterCount\\": 0,\\n \\"ClusterMode\\": \\"0\\",\\n \\"EnableSpot\\": true\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '查询集群资源具体使用详情', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查看集群的空间概览', + 'summary' => '查看实例的空间概览信息，包括总数据量、热数据量、冷数据量、数据增长量等。', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeStorageResourceUsage' => [ - 'summary' => '调用DescribeStorageResourceUsage接口查询集群存储资源使用情况。', - 'methods' => [ - 'post', - 'get', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBClusterSpaceSummary'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeDBClusterSpaceSummary', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"TotalSize\\": \\"8388608\\",\\n \\"HotData\\": {\\n \\"TotalSize\\": 4194304,\\n \\"DataSize\\": 1048576,\\n \\"IndexSize\\": 1048576,\\n \\"PrimaryKeyIndexSize\\": 1048576,\\n \\"OtherSize\\": 1048576\\n },\\n \\"ColdData\\": {\\n \\"TotalSize\\": 4194304,\\n \\"DataSize\\": 1048576,\\n \\"IndexSize\\": 1048576,\\n \\"PrimaryKeyIndexSize\\": 1048576,\\n \\"OtherSize\\": 1048576\\n },\\n \\"DataGrowth\\": {\\n \\"DayGrowth\\": 1048576,\\n \\"WeekGrowth\\": 1048576\\n }\\n }\\n}","type":"json"}]', + ], + 'DescribeDBClusterStatus' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -16271,121 +11445,75 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', + 'abilityTreeCode' => '133754', + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp10yt0gva71ei7d', - ], - ], - [ - 'name' => 'StartTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间，UTC时间，格式：yyyy-MM-ddTHH:mmZ。', - 'type' => 'string', - 'required' => true, - 'example' => '2022-08-22T01:06:00Z'."\n", - ], - ], - [ - 'name' => 'EndTime', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间，UTC时间，格式：yyyy-MM-ddTHH:mmZ。', - 'type' => 'string', - 'required' => true, - 'example' => '2022-08-23T01:06:00Z'."\n", - ], + 'schema' => ['description' => '地域ID。'."\n" + .'>您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', - 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEAW', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp1bg858bo8c****', - ], - 'StartTime' => [ - 'description' => '查询开始时间，UTC时间，格式：yyyy-MM-ddTHH:mmZ。', - 'type' => 'string', - 'example' => '2022-08-22T01:06:00Z'."\n", - ], - 'EndTime' => [ - 'description' => '查询结束时间，UTC时间，格式：yyyy-MM-ddTHH:mmZ。', - 'type' => 'string', - 'example' => '2022-08-23T01:06:00Z'."\n", - ], - 'AcuInfo' => [ - 'description' => '集群ACU资源使用情况。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '对应指标项取值的状态，取值说明：'."\n" - .'- `TotalAcuNumber`：总ACU资源数。'."\n" - .'- `ReservedAcuNumber`：预留资源ACU数。', - 'type' => 'string', - 'example' => 'TotalAcuNumber', - ], - 'Values' => [ - 'description' => '对应指标项在各时间点的具体取值。', - 'type' => 'array', - 'items' => [ - 'description' => '不同时间点下的性能值详情。', - 'type' => 'string', - 'example' => '16ACU', - ], - ], - ], - ], - ], - ], + 'Status' => [ + 'description' => '集群状态列表。', + 'type' => 'array', + 'items' => ['description' => '集群状态，取值说明：'."\n" + .'- **Preparing**：准备中。'."\n" + ."\n" + .'- **Creating**：创建中。'."\n" + ."\n" + .'- **Restoring**：备份恢复中。'."\n" + ."\n" + .'- **Running**：运行中。'."\n" + ."\n" + .'- **Deleting**：删除中。'."\n" + ."\n" + .'- **ClassChanging**：变配中。'."\n" + ."\n" + .'- **NetAddressCreating**：创建网络中。'."\n" + ."\n" + .'- **NetAddressDeleting**：释放网络中。'."\n" + ."\n" + .'- **NetAddressModifying**：网络地址修改中。'."\n" + ."\n" + .'- **EngineVersionUpgrading**：版本升级中。', 'type' => 'string', 'example' => 'Running'], ], + 'RequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEAU'], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEAW\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"DBClusterId\\": \\"amv-bp1bg858bo8c****\\",\\n \\"StartTime\\": \\"2022-08-22T01:06:00Z\\\\n\\",\\n \\"EndTime\\": \\"2022-08-23T01:06:00Z\\\\n\\",\\n \\"AcuInfo\\": [\\n {\\n \\"Name\\": \\"TotalAcuNumber\\",\\n \\"Values\\": [\\n \\"16ACU\\"\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '查询集群存储资源使用情况', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeJobResourceUsage' => [ - 'summary' => '获取作业资源使用统计。', - 'methods' => [ - 'post', - 'get', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'schemes' => [ - 'http', - 'https', + 'gatewayOptions' => [ + 'gatewayProtocols' => [], ], + 'title' => '查询集群的状态列表', + 'summary' => '查询集群的状态列表。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBClusterStatus'], + ], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Status\\": [\\n \\"Running\\"\\n ],\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEAU\\"\\n}","type":"json"}]', + ], + 'DescribeDBClusters' => [ + 'summary' => '查看目标地域下的湖仓版集群列表信息。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -16394,485 +11522,721 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '173228', - 'abilityTreeNodes' => [ - 'FEATUREadsCQJTKP', - ], + 'abilityTreeCode' => '130697', + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'am-uf6g8w25jacm7****', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'StartTime', + 'name' => 'DBClusterIds', 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', - 'type' => 'string', - 'required' => true, - 'example' => '2023-02-04T03:45:00Z', - ], + 'schema' => ['description' => '湖仓版集群ID。'."\n" + ."\n" + .'此参数不填写时，默认返回该地域中所有集群的信息。', 'type' => 'string', 'required' => false, 'example' => 'amv-bp1r053byu48p****'], ], [ - 'name' => 'EndTime', + 'name' => 'DBClusterDescription', + 'in' => 'query', + 'schema' => ['description' => '集群描述。'."\n" + .'- 不能以`http://`或者`https://`开头。'."\n" + .'- 长度为2~256个字符。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + [ + 'name' => 'DBClusterStatus', + 'in' => 'query', + 'schema' => ['description' => '集群状态，取值说明：'."\n" + .'- **Preparing**：准备中。'."\n" + .'- **Creating**：创建中。'."\n" + .'- **Running**：运行中。'."\n" + .'- **Deleting**：删除中。'."\n" + .'- **Restoring**：备份恢复中。'."\n" + .'- **ClassChanging**：变配中。'."\n" + .'- **NetAddressCreating**：创建网络中。'."\n" + .'- **NetAddressDeleting**：删除网络中。'."\n" + .'- **NetAddressModifying**：修改网络中。', 'type' => 'string', 'required' => false, 'example' => 'Running'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', 'default' => '30'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码，取值为大于0且不超过Integer数据类型的正整数。默认值为**1**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', 'default' => '1'], + ], + [ + 'name' => 'ResourceGroupId', + 'in' => 'query', + 'schema' => ['description' => '资源组ID。'."\n" + .'此参数不填写时，默认返回集群中所有资源组信息。', 'type' => 'string', 'required' => false, 'example' => 'rg-4690g37929****'], + ], + [ + 'name' => 'Tag', 'in' => 'query', + 'style' => 'repeatList', 'schema' => [ - 'description' => '查询结束时间，需要大于查询开始时间，格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', - 'type' => 'string', - 'required' => true, - 'example' => '2023-03-17T16:00:00Z', + 'description' => '集群的标签信息。', + 'type' => 'array', + 'items' => [ + 'description' => '集群标签信息。', + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => '集群的标签键。', 'type' => 'string', 'required' => false, 'example' => 'tag1'], + 'Value' => ['description' => '集群的标签值。', 'type' => 'string', 'required' => false, 'example' => 'test1'], + ], + 'required' => false, + ], + 'required' => false, + 'maxItems' => 21, ], ], [ - 'name' => 'PageNumber', + 'name' => 'ProductVersion', 'in' => 'query', 'schema' => [ - 'type' => 'integer', - 'format' => 'int32', + 'description' => '产品版本：'."\n" + .'- **EnterpriseVersion**：企业版。'."\n" + .'- **BasicVersion**：基础版。'."\n" + .'> 选填参数，不填时默认返回全部集群。', + 'type' => 'string', 'required' => false, + 'example' => 'BasicVersion', + 'enum' => ['EnterpriseVersion', 'BasicVersion'], ], ], [ - 'name' => 'PageSize', + 'name' => 'DBClusterVersion', 'in' => 'query', 'schema' => [ - 'type' => 'integer', - 'format' => 'int32', + 'description' => '集群版本'."\n" + .'- **3.0**：数仓版。'."\n" + .'- **5.0**（默认值）：包括湖仓版、企业版和基础版。'."\n" + .'- **All**：所有版本，包括数仓版、湖仓版、企业版和基础版。', + 'type' => 'string', 'required' => false, + 'example' => '5.0', + 'default' => '5.0', + 'enum' => ['All', '3.0', '5.0'], ], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', - 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Data' => [ - 'description' => '返回结果数据。', + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A5EDBA27-AF3E-5966-9503-FD1557E19167'], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'Items' => [ 'type' => 'object', + 'itemNode' => true, 'properties' => [ - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-clusterxxx', - ], - 'StartTime' => [ - 'description' => '开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。', - 'type' => 'string', - 'example' => '2023-05-22T16:00:00Z', - ], - 'EndTime' => [ - 'description' => '结束时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。', - 'type' => 'string', - 'example' => '2023-05-23T16:00:00Z'."\n", - ], - 'JobAcuUsage' => [ - 'description' => 'Job型资源组ACU使用情况。', + 'DBCluster' => [ + 'description' => '列表详情。', 'type' => 'array', 'items' => [ + 'description' => '集群列表。', 'type' => 'object', 'properties' => [ - 'JobId' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => '1592', - ], - 'ResourceGroupName' => [ - 'description' => 'Job型资源组名称。', - 'type' => 'string', - 'example' => 'job_default', - ], - 'JobStartTime' => [ - 'description' => '任务开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。', - 'type' => 'string', - 'example' => '2023-05-22T16:00:00Z'."\n", - ], - 'JobEndTime' => [ - 'description' => '任务结束时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。', - 'type' => 'string', - 'example' => '2023-05-23T16:00:00Z', - ], - 'AcuUsageDetail' => [ - 'description' => 'ACU资源使用情况。', + 'Expired' => ['description' => '包年包月集群是否过期。取值说明：'."\n" + .'* **true**：已过期。'."\n" + .'* **false**：未过期。'."\n" + ."\n" + .'> - 如果集群已过期，在一定时间内集群会被锁定甚至释放。建议您进行续费操作，详情请参见[续费说明](~~135246~~)。'."\n" + .'- 按量付费集群不返回此参数。', 'type' => 'string', 'example' => 'false'], + 'CreateTime' => ['description' => '集群创建时间。UTC时间，格式为<i>yyyy-mm-ddThh:mm:ssZ</i>。', 'type' => 'string', 'example' => '2022-04-01T09:50:18Z'], + 'PayType' => ['description' => '集群付费类型，取值说明：'."\n" + .'* **Postpaid**：按量付费。'."\n" + .'* **Prepaid**：包年包月。', 'type' => 'string', 'example' => 'Prepaid'], + 'Mode' => ['description' => '集群模式。默认返回**flexible**，表示弹性模式集群。', 'type' => 'string', 'example' => 'flexible'], + 'Port' => ['description' => '集群端口号。', 'type' => 'string', 'example' => '3306'], + 'LockMode' => ['description' => '集群的锁定状态，取值说明： '."\n" + .'- **Unlock**：未锁定。 '."\n" + .'- **ManualLock**：手动触发锁定。 '."\n" + .'- **LockByExpiration**：集群过期自动锁定。', 'type' => 'string', 'example' => 'Unlock'], + 'StorageResource' => ['description' => '存储预留资源规格。1 ACU约等于1核4 GB。存储资源用于数据读写，增加该资源能提高集群读写能力。', 'type' => 'string', 'example' => '24ACU'], + 'DBClusterId' => ['description' => '湖仓版集群ID。', 'type' => 'string', 'example' => 'amv-bp163885f8q21****'], + 'ConnectionString' => ['description' => '集群的公网连接地址。', 'type' => 'string', 'example' => 'amv-bp163885f8q21****.ads.aliyuncs.com'], + 'DBClusterType' => ['description' => '集群类型。默认返回**Common**，表示常规集群。', 'type' => 'string', 'example' => 'Common'], + 'CommodityCode' => ['description' => '商品付费类型，取值说明：'."\n" + .'- **ads**：按量付费商品。'."\n" + .'- **ads_pre**：包年包月商品。', 'type' => 'string', 'example' => 'ads_pre'], + 'ExpireTime' => ['description' => '集群到期时间，UTC时间，格式为<i>yyyy-MM-ddTHH:mm:ssZ</i>。'."\n" + ."\n" + .'> * 若集群付费类型为包年包月，则返回实际到期时间。'."\n" + .'* 若集群付费类型为按量付费，则返回为空。'."\n", 'type' => 'string', 'example' => '2022-07-01T09:50:18Z'], + 'LockReason' => ['description' => '集群锁定原因。'."\n" + .'> 仅当集群被锁定时会返回该参数，固定为**instance_expire**。', 'type' => 'string', 'example' => 'instance_expired'], + 'VPCId' => ['description' => '专有网络（VPC）ID。', 'type' => 'string', 'example' => 'vpc-bp13h7uzhulpuxvnp****'], + 'RegionId' => ['description' => '集群所在的地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'ComputeResource' => ['description' => '计算预留资源规格。1 ACU约等于1核4 GB。计算资源用于数据计算，增加计算资源能加快查询速度，可以根据集群实际性能按需弹性扩缩。', 'type' => 'string', 'example' => '16ACU'], + 'VSwitchId' => ['description' => '交换机ID。', 'type' => 'string', 'example' => 'vsw-bp1syh8vvw8yech7n****'], + 'DBVersion' => ['description' => '数据库版本，当前仅支持**5.0**版本。', 'type' => 'string', 'example' => '5.0'], + 'DBClusterStatus' => ['description' => '集群状态，取值说明：'."\n" + .'- **Preparing**：准备中。'."\n" + .'- **Creating**：创建中。'."\n" + .'- **Running**：运行中。'."\n" + .'- **Deleting**：删除中。'."\n" + .'- **Restoring**：备份恢复中。'."\n" + .'- **ClassChanging**：变配中。'."\n" + .'- **NetAddressCreating**：创建网络中。'."\n" + .'- **NetAddressDeleting**：删除网络中。'."\n" + .'- **NetAddressModifying**：修改网络中。', 'type' => 'string', 'example' => 'Running'], + 'ResourceGroupId' => ['description' => '资源组ID。', 'type' => 'string', 'example' => 'rg-acfmyiu4ekp****'], + 'DBClusterNetworkType' => ['description' => '集群网络类型。仅支持**VPC**（专有网络）类型。', 'type' => 'string', 'example' => 'VPC', 'default' => 'VPC'], + 'DBClusterDescription' => ['description' => '集群的描述信息。', 'type' => 'string', 'example' => 'adb_test'], + 'ZoneId' => ['description' => '集群所在的可用区ID。', 'type' => 'string', 'example' => 'cn-hangzhou-h'], + 'Engine' => ['description' => '集群引擎，固定为**AnalyticDB**。', 'type' => 'string', 'example' => 'AnalyticDB'], + 'ReservedACU' => ['description' => '集群剩余可分配计算预留资源。1 ACU约等于1核4 GB。', 'type' => 'string', 'example' => '32ACU'], + 'Tags' => [ 'type' => 'object', + 'itemNode' => true, 'properties' => [ - 'TotalAcuNumber' => [ - 'description' => '总ACU资源数。', - 'type' => 'number', - 'format' => 'float', - 'example' => '32ACU', - ], - 'ReservedAcuNumber' => [ - 'description' => '预留资源ACU数。', - 'type' => 'number', - 'format' => 'float', - 'example' => '16ACU', - ], - 'ElasticAcuNumber' => [ - 'description' => '弹性资源ACU数。', - 'type' => 'number', - 'format' => 'float', - 'example' => '16ACU', + 'Tag' => [ + 'description' => '标签列表。', + 'type' => 'array', + 'items' => [ + 'description' => '标签列表。', + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => '标签键。'."\n" + .'> 您可以调用[TagResources](~~179253~~)接口为目标集群创建标签。', 'type' => 'string', 'example' => 'tag1'], + 'Value' => ['description' => '标签值。', 'type' => 'string', 'example' => 'test1'], + ], + ], ], - 'SpotAcuNumber' => [ - 'description' => '竞价实例资源ACU数。', - 'type' => 'number', - 'format' => 'float', - 'example' => '16ACU', + ], + 'description' => '', + ], + 'Category' => ['description' => '产品系列，仅在实例为数仓版时该值有意义，取值说明：'."\n" + .'- **BASIC**：预留模式基础版。'."\n" + .'- **CLUSTER**：预留模式集群版。'."\n" + .'- **MIXED_STORAGE**：弹性模式集群版（新版）。'."\n" + .'> 更多关于集群系列的介绍，请参见[产品系列](~~205001~~)。', 'type' => 'string', 'example' => 'MIXED_STORAGE'], + 'InnerPort' => ['description' => '集群的内网连接端口。', 'type' => 'string', 'example' => '3306'], + 'VPCCloudInstanceId' => ['description' => '内网连接地址。', 'type' => 'string', 'example' => 'am-bp163885f8q21****-controller'], + 'InnerIp' => ['description' => '集群内网IP地址。', 'type' => 'string', 'example' => '10.1.xx.xx'], + 'DtsJobId' => ['description' => 'DTS同步任务ID。仅MySQL分析实例会返回该参数。<props="china"><ph>更多详情，请参见[MySQL分析实例简介](~~154779~~)。</ph></props>'."\n", 'type' => 'string', 'example' => 'dtsb1578j90XXXX'], + 'ElasticIOResource' => ['description' => '弹性IO资源（Elastic IO Unit，简称EIU），更多详情，请参见[EIU详解](~~189505~~)。'."\n" + .'> 仅弹性模式集群会返回该参数。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'RdsInstanceId' => ['description' => '同步源RDS实例ID。仅MySQL分析实例会返回该参数。<props="china"><ph>更多详情，请参见[MySQL分析实例简介](~~154779~~)。</ph></props>', 'type' => 'string', 'example' => 'rm-bp11q28kvl688****'], + 'ExecutorCount' => ['description' => '弹性模式下集群使用的计算节点数量。', 'type' => 'string', 'example' => '1'], + 'DBNodeClass' => ['description' => '节点规格，仅在实例为数仓版时该值有意义。', 'type' => 'string', 'example' => 'E8'], + 'DiskType' => ['description' => '集群的磁盘类型，取值说明：'."\n" + .'- **local_ssd**：本地磁盘。'."\n" + .'- **cloud**：普通云盘。'."\n" + .'- **cloud_ssd**：SSD云盘。'."\n" + .'- **cloud_efficiency**：高效云盘。'."\n" + .'- **cloud_essd**：PL1等级的ESSD云盘。'."\n" + .'- **cloud_essd2**：PL2 等级的ESSD云盘。'."\n" + .'- **cloud_essd3**：PL3 等级的ESSD云盘。'."\n" + .'> 更多关于ESSD云盘的详情，请参见[ESSD云盘规格](~~122389~~)。', 'type' => 'string', 'example' => 'cloud_essd'], + 'DBNodeStorage' => ['description' => '集群的存储空间，单位：GB。', 'type' => 'integer', 'format' => 'int64', 'example' => '300'], + 'DBNodeCount' => ['description' => '节点组个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '2'], + 'TaskInfo' => [ + 'description' => '任务进度信息。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '任务名称。', 'type' => 'string', 'example' => 'analyticDBFlexibleScaleOut'], + 'Status' => [ + 'description' => '任务状态，取值为：'."\n" + .'- **NOT_RUN**：等待运行。'."\n" + .'- **RUNNING**：运行中。'."\n" + .'- **SUCCEED**：已结束。', + 'type' => 'string', + 'example' => 'RUNNING', + 'enum' => ['RUNNING', 'SUCCEED', 'NOT_RUN'], ], - 'SpotAcuPercentage' => [ - 'description' => '竞价实例资源占总弹性资源的比例。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.9', + 'Progress' => ['description' => '任务进度，单位：%。', 'type' => 'string', 'example' => '10%'], + 'StepList' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'StepList' => [ + 'description' => '任务步骤。', + 'type' => 'array', + 'items' => [ + 'description' => '任务步骤。', + 'type' => 'object', + 'properties' => [ + 'StepName' => ['description' => '步骤名称。', 'type' => 'string', 'example' => 'ApplyResource'], + 'StepDesc' => ['description' => '步骤描述。', 'type' => 'string', 'example' => 'Apply resource'], + 'StepStatus' => [ + 'description' => '步骤状态，取值为：'."\n" + .'- **NOT_RUN**：等待运行。'."\n" + .'- **RUNNING**：运行中。'."\n" + .'- **SUCCEED**：已结束。', + 'type' => 'string', + 'example' => 'SUCCEED', + 'enum' => ['RUNNING', 'SUCCEED', 'NOT_RUN'], + ], + 'StepProgress' => ['description' => '步骤进度，单位：%。', 'type' => 'string', 'example' => '50%'], + 'StartTime' => ['description' => '步骤开始时间，格式为 YYYY-MM-DDThh:mm:ssZ。', 'type' => 'string', 'example' => '2024-03-10T09:28:34Z'], + 'EndTime' => ['description' => '步骤结束时间，格式为 YYYY-MM-DDThh:mm:ssZ。', 'type' => 'string', 'example' => '2024-03-10T10:28:34Z'], + ], + ], + ], + ], + 'description' => '', ], ], ], - 'UseCachePool' => [ - 'type' => 'boolean', - ], + 'ProductForm' => [ + 'description' => '产品形态枚举：'."\n" + .'- **LegacyForm**: 传统形态。'."\n" + .'- **IntegrationForm**：融合形态。', + 'type' => 'string', + 'example' => 'IntegrationForm', + 'enum' => ['IntegrationForm', 'LegacyForm'], + ], + 'ProductVersion' => ['description' => '产品版本。取值为：'."\n" + .'- **BasicVersion**：基础版。'."\n" + .'- **EnterpriseVersion**：企业版。', 'type' => 'string', 'example' => 'EnterpriseVersion'], + 'ReservedNodeSize' => ['description' => '预留资源单节点规格。', 'type' => 'string', 'example' => '8ACU'], + 'ReservedNodeCount' => ['description' => '预留资源节点数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'AINodeSpec' => ['description' => 'AI节点规格。', 'type' => 'string', 'example' => 'ADB.MLGrand.5'], + 'AINodeNumber' => ['description' => 'AI节点数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], ], ], ], - 'PageNumber' => [ - 'type' => 'integer', - 'format' => 'int32', - ], - 'PageSize' => [ - 'type' => 'integer', - 'format' => 'int32', - ], - 'TotalCount' => [ - 'type' => 'integer', - 'format' => 'int32', - ], ], + 'description' => '', ], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"DBClusterId\\": \\"amv-clusterxxx\\",\\n \\"StartTime\\": \\"2023-05-22T16:00:00Z\\",\\n \\"EndTime\\": \\"2023-05-23T16:00:00Z\\\\n\\",\\n \\"JobAcuUsage\\": [\\n {\\n \\"JobId\\": \\"1592\\",\\n \\"ResourceGroupName\\": \\"job_default\\",\\n \\"JobStartTime\\": \\"2023-05-22T16:00:00Z\\\\n\\",\\n \\"JobEndTime\\": \\"2023-05-23T16:00:00Z\\",\\n \\"AcuUsageDetail\\": {\\n \\"TotalAcuNumber\\": 0,\\n \\"ReservedAcuNumber\\": 0,\\n \\"ElasticAcuNumber\\": 0,\\n \\"SpotAcuNumber\\": 0,\\n \\"SpotAcuPercentage\\": 0.9\\n },\\n \\"UseCachePool\\": true\\n }\\n ],\\n \\"PageNumber\\": 0,\\n \\"PageSize\\": 0,\\n \\"TotalCount\\": 0\\n }\\n}","type":"json"}]', - 'title' => '查询任务型资源使用情况', + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', 'description' => '系统内部错误，请稍后重试'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'An error occurred while processing your request.', 'description' => '系统暂时不可用，请稍后重试'], + ], + ], + 'title' => '查询集群列表', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribePerformanceViews' => [ - 'summary' => '获取监控视图列表。', - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2025-09-08T10:17:02.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-05-28T03:05:14.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-05-09T03:29:13.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-07-27T11:22:29.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2022-11-03T03:01:24.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2022-06-11T16:51:57.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeDBClusters'], + ], ], - 'tags' => [ - 'Perth', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDBClusters', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"A5EDBA27-AF3E-5966-9503-FD1557E19167\\",\\n \\"PageNumber\\": 1,\\n \\"Items\\": {\\n \\"DBCluster\\": [\\n {\\n \\"Expired\\": \\"false\\",\\n \\"CreateTime\\": \\"2022-04-01T09:50:18Z\\",\\n \\"PayType\\": \\"Prepaid\\",\\n \\"Mode\\": \\"flexible\\",\\n \\"Port\\": \\"3306\\",\\n \\"LockMode\\": \\"Unlock\\",\\n \\"StorageResource\\": \\"24ACU\\",\\n \\"DBClusterId\\": \\"amv-bp163885f8q21****\\",\\n \\"ConnectionString\\": \\"amv-bp163885f8q21****.ads.aliyuncs.com\\",\\n \\"DBClusterType\\": \\"Common\\",\\n \\"CommodityCode\\": \\"ads_pre\\",\\n \\"ExpireTime\\": \\"2022-07-01T09:50:18Z\\",\\n \\"LockReason\\": \\"instance_expired\\",\\n \\"VPCId\\": \\"vpc-bp13h7uzhulpuxvnp****\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"ComputeResource\\": \\"16ACU\\",\\n \\"VSwitchId\\": \\"vsw-bp1syh8vvw8yech7n****\\",\\n \\"DBVersion\\": \\"5.0\\",\\n \\"DBClusterStatus\\": \\"Running\\",\\n \\"ResourceGroupId\\": \\"rg-acfmyiu4ekp****\\",\\n \\"DBClusterNetworkType\\": \\"VPC\\",\\n \\"DBClusterDescription\\": \\"adb_test\\",\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"Engine\\": \\"AnalyticDB\\",\\n \\"ReservedACU\\": \\"32ACU\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"Key\\": \\"tag1\\",\\n \\"Value\\": \\"test1\\"\\n }\\n ]\\n },\\n \\"Category\\": \\"MIXED_STORAGE\\",\\n \\"InnerPort\\": \\"3306\\",\\n \\"VPCCloudInstanceId\\": \\"am-bp163885f8q21****-controller\\",\\n \\"InnerIp\\": \\"10.1.xx.xx\\",\\n \\"DtsJobId\\": \\"dtsb1578j90XXXX\\",\\n \\"ElasticIOResource\\": 2,\\n \\"RdsInstanceId\\": \\"rm-bp11q28kvl688****\\",\\n \\"ExecutorCount\\": \\"1\\",\\n \\"DBNodeClass\\": \\"E8\\",\\n \\"DiskType\\": \\"cloud_essd\\",\\n \\"DBNodeStorage\\": 300,\\n \\"DBNodeCount\\": 2,\\n \\"TaskInfo\\": {\\n \\"Name\\": \\"analyticDBFlexibleScaleOut\\",\\n \\"Status\\": \\"RUNNING\\",\\n \\"Progress\\": \\"10%\\",\\n \\"StepList\\": {\\n \\"StepList\\": [\\n {\\n \\"StepName\\": \\"ApplyResource\\",\\n \\"StepDesc\\": \\"Apply resource\\",\\n \\"StepStatus\\": \\"SUCCEED\\",\\n \\"StepProgress\\": \\"50%\\",\\n \\"StartTime\\": \\"2024-03-10T09:28:34Z\\",\\n \\"EndTime\\": \\"2024-03-10T10:28:34Z\\"\\n }\\n ]\\n }\\n },\\n \\"ProductForm\\": \\"IntegrationForm\\",\\n \\"ProductVersion\\": \\"EnterpriseVersion\\",\\n \\"ReservedNodeSize\\": \\"8ACU\\",\\n \\"ReservedNodeCount\\": 1,\\n \\"AINodeSpec\\": \\"ADB.MLGrand.5\\",\\n \\"AINodeNumber\\": 1\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeDBClustersResponse>\\n <TotalCount>1</TotalCount>\\n <PageSize>30</PageSize>\\n <RequestId>A5EDBA27-AF3E-5966-9503-FD1557E19167</RequestId>\\n <PageNumber>1</PageNumber>\\n <Items>\\n <Expired>false</Expired>\\n <CreateTime>2022-04-01T09:50:18Z</CreateTime>\\n <PayType>Prepaid</PayType>\\n <Mode>flexible</Mode>\\n <Port>3306</Port>\\n <LockMode>Unlock</LockMode>\\n <StorageResource>24ACU</StorageResource>\\n <DBClusterId>amv-bp163885f8q21****</DBClusterId>\\n <ConnectionString>amv-bp163885f8q21****.ads.aliyuncs.com</ConnectionString>\\n <DBClusterType>Common</DBClusterType>\\n <CommodityCode>ads_pre</CommodityCode>\\n <ExpireTime>2022-07-01T09:50:18Z</ExpireTime>\\n <LockReason>instance_expired</LockReason>\\n <VPCId>vpc-bp13h7uzhulpuxvnp****</VPCId>\\n <RegionId>cn-hangzhou</RegionId>\\n <ComputeResource>16ACU</ComputeResource>\\n <VSwitchId>vsw-bp1syh8vvw8yech7n****</VSwitchId>\\n <DBVersion>5.0</DBVersion>\\n <DBClusterStatus>Running</DBClusterStatus>\\n <ResourceGroupId>rg-acfmyiu4ekp****</ResourceGroupId>\\n <DBClusterNetworkType>VPC</DBClusterNetworkType>\\n <DBClusterDescription>adb_test</DBClusterDescription>\\n <ZoneId>cn-hangzhou-h</ZoneId>\\n <Engine>AnalyticDB</Engine>\\n <ReservedACU>32ACU</ReservedACU>\\n </Items>\\n</DescribeDBClustersResponse>","errorExample":""}]', + ], + 'DescribeDBResourceGroup' => [ + 'summary' => '查询集群的资源组信息。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '220841', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '136430', + 'abilityTreeNodes' => ['FEATUREadsYXZ2UA'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 调用[DescribeDBClusters](~~612397~~)接口可以查看集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1ub9grke1****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版的集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], + ], + [ + 'name' => 'GroupName', + 'in' => 'query', + 'schema' => ['description' => '资源组名称。'."\n" + .'> 此参数不填写时，默认返回指定集群的所有资源组信息。', 'type' => 'string', 'required' => false, 'example' => 'test_group'], + ], + [ + 'name' => 'GroupType', + 'in' => 'query', + 'schema' => ['description' => '资源组类型，取值：'."\n" + .'- **Interactive**'."\n" + .'- **Job**'."\n" + .'> 关于湖仓版资源组的详细信息，请参见[资源组介绍](~~428610~~)。', 'type' => 'string', 'required' => false, 'example' => 'Job'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用 [DescribeRegions](~~612393~~) 接口查看集群的地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '3A8F6106-6AFD-5A34-9C80-8DE2C42D06E8', - ], - 'Views' => [ - 'description' => '监控视图列表。', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'A94B6C02-7BD4-5D67-9776-3AC8317E8DD3'], + 'GroupsInfo' => [ + 'description' => '资源组信息列表。', 'type' => 'array', 'items' => [ - 'description' => '单个监控视图信息。', + 'description' => '资源组信息列表。', 'type' => 'object', 'properties' => [ - 'ViewName' => [ - 'description' => '监控视图名称。', - 'type' => 'string', - 'example' => '自定义-1', + 'GroupType' => ['description' => '资源组类型，取值：'."\n" + .'- **Interactive**'."\n" + .'- **Job**'."\n" + .'> 关于湖仓版资源组的详细信息，请参见[资源组介绍（湖仓版）](~~428610~~)。', 'type' => 'string', 'example' => 'Job'], + 'GroupName' => ['description' => '资源组名称。', 'type' => 'string', 'example' => 'test1'], + 'MinComputeResource' => ['description' => '最小计算预留资源，单位为ACU。'."\n", 'type' => 'string', 'example' => '0ACU'], + 'MaxComputeResource' => ['description' => '最大计算预留资源，单位为ACU。', 'type' => 'string', 'example' => '512ACU'], + 'ClusterSizeResource' => ['description' => '预留参数，不涉及', 'type' => 'string', 'example' => 'Reserved parameter'], + 'MinClusterCount' => ['description' => '预留参数，不涉及', 'type' => 'integer', 'format' => 'int32', 'example' => 'Reserved parameter'], + 'MaxClusterCount' => ['description' => '预留参数，不涉及', 'type' => 'integer', 'format' => 'int32', 'example' => 'Reserved parameter'], + 'RunningClusterCount' => ['description' => '预留参数，不涉及', 'type' => 'integer', 'format' => 'int32', 'example' => 'Reserved parameter'], + 'ClusterMode' => ['description' => '预留参数，不涉及', 'type' => 'string', 'example' => 'Reserved parameter'], + 'ElasticMinComputeResource' => ['description' => '最小计算弹性资源，单位为ACU。', 'type' => 'string', 'example' => '16ACU'], + 'EnableSpot' => ['description' => '资源组是否开启竞价实例功能。开启竞价实例后资源单价降低，但是有概率被释放。取值：'."\n" + .'- **True**：开启竞价实例功能。'."\n" + .'- **False**：关闭竞价实例功能。'."\n" + ."\n" + .'仅Job型资源组可以为True。', 'type' => 'string', 'example' => 'True'], + 'GroupUsers' => ['description' => '资源组绑定的RAM用户。', 'type' => 'string', 'example' => 'testb,testc'], + 'CreateTime' => ['description' => '资源组创建时间，UTC时间，格式为<i>yyyy-MM-ddTHH:mm:ssZ</i>。', 'type' => 'string', 'example' => '2022-08-29T03:34:30Z'], + 'UpdateTime' => ['description' => '更新时间，UTC时间，格式为<i>yyyy-MM-ddTHH:mm:ssZ</i>。', 'type' => 'string', 'example' => '2022-08-31T03:34:30Z'], + 'Status' => ['description' => '资源组状态，取值说明：'."\n" + .'- **creating**：创建中'."\n" + .'- **ok**：创建成功'."\n" + .'- **pendingdelete**：等待删除', 'type' => 'string', 'example' => 'ok'], + 'Rules' => [ + 'description' => '作业投递规则。', + 'type' => 'array', + 'items' => [ + 'description' => '规则信息列表。', + 'type' => 'object', + 'properties' => [ + 'GroupName' => ['description' => '资源组名称。', 'type' => 'string', 'example' => 'user_default'], + 'QueryTime' => ['description' => '查询执行时间阈值，单位为毫秒（ms）。', 'type' => 'string', 'example' => '180000'], + 'TargetGroupName' => ['description' => '目标资源组名称。', 'type' => 'string', 'example' => 'job'], + ], + ], ], - 'CreateTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2024-06-18T07:06:53.000+00:00', + 'Engine' => ['description' => '引擎类型', 'type' => 'string', 'example' => 'AnalyticDB'], + 'Message' => ['description' => '作业投递规则消息。', 'type' => 'string', 'required' => true, 'example' => 'SUCCESS'], + 'AutoStopInterval' => ['description' => '自动停止时间，为数字+m的格式表示分钟，范围在0m 或5m~10080m。其中0m表示不会自动停止。', 'type' => 'string', 'example' => '0m'], + 'SpecName' => ['description' => '规格名。', 'type' => 'string', 'example' => 'ADB.MLLarge.2'], + 'TargetResourceGroupName' => ['description' => '目标资源组名称。', 'type' => 'string', 'example' => 'test'], + 'MinGpuQuantity' => ['description' => '最小GPU数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'MaxGpuQuantity' => ['description' => '最大GPU数量', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'RayConfig' => [ + 'description' => 'Ray配置信息。', + 'type' => 'object', + 'properties' => [ + 'EnableUserEni' => ['description' => '开启ENI。', 'type' => 'boolean'], + 'HeadSpecType' => ['description' => 'Head节点资源类型。', 'type' => 'string', 'example' => 'cpu'], + 'HeadSpec' => ['description' => 'Head节点规格', 'type' => 'string', 'example' => 'ADB.MLLarge.2'], + 'HeadAllocateUnit' => ['description' => 'Head节点分配单元。', 'type' => 'string', 'example' => '1'], + 'HeadDiskCapacity' => ['description' => 'Head节点磁盘大小。', 'type' => 'string', 'example' => '100Gi'], + 'Category' => [ + 'description' => 'Ray集群类型，取值说明：'."\n" + ."\n" + .'- BASIC：基础类型，非高可用'."\n" + ."\n" + .'- HIGH_AVAILABILITY：高可用类型', + 'type' => 'string', + 'example' => 'BASIC', + 'enum' => ['Basic', 'HighAvailability'], + ], + 'WorkerGroups' => [ + 'title' => 'Ray Worker组列表', + 'description' => 'Ray Worker组列表。', + 'type' => 'array', + 'items' => [ + 'description' => 'Ray Worker组列表。', + 'type' => 'object', + 'properties' => [ + 'GroupName' => ['title' => 'Ray Worker组名', 'description' => 'Ray Worker组名。', 'type' => 'string', 'example' => 'g01'], + 'AllocateUnit' => ['title' => '分配单元', 'description' => '分配单元。', 'type' => 'string', 'example' => '1'], + 'MaxWorkerQuantity' => ['title' => '最大Worker个数', 'description' => '最大Worker个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'MinWorkerQuantity' => ['title' => '最小Worker个数', 'description' => '最小Worker个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'WorkerDiskCapacity' => ['title' => '每个Worker磁盘大小', 'description' => '每个Worker磁盘大小。', 'type' => 'string', 'example' => '100G'], + 'WorkerSpecName' => ['title' => 'Worker资源型号', 'description' => 'Worker资源型号。', 'type' => 'string', 'example' => 'large'], + 'WorkerSpecType' => [ + 'title' => 'Ray Worker资源类型', + 'description' => 'Ray Worker资源类型。', + 'type' => 'string', + 'example' => 'CPU', + 'enum' => ['CPU', 'GPU'], + ], + ], + ], + ], + 'RayClusterAddress' => ['title' => 'Ray Cluster地址', 'description' => 'Ray Cluster地址。', 'type' => 'string', 'example' => 'http://ray-cluster-address.example.com'], + 'RayDashboardAddress' => ['title' => 'Ray Dashboard地址', 'description' => 'Ray Dashboard地址。', 'type' => 'string', 'example' => 'http://ray-dashboard-address.example.com'], + 'RayGrafanaAddress' => ['title' => 'Ray Grafana地址', 'description' => 'Ray Grafana地址。', 'type' => 'string', 'example' => 'http://ray-grafana-address.example.com'], + 'RayServePublicAddress' => ['title' => 'Ray Serve公网地址', 'type' => 'string', 'example' => '1.2.3.4:8100'], + 'AppConfig' => [ + 'title' => 'Ray应用配置', + 'description' => 'Ray应用配置。', + 'type' => 'object', + 'properties' => [ + 'AppName' => ['title' => 'Ray应用名', 'description' => 'Ray应用名。', 'type' => 'string', 'example' => 'app01'], + 'AppType' => ['title' => 'Ray应用类型', 'description' => 'Ray应用类型。', 'type' => 'string', 'example' => 'IsaacLab'], + 'ImageSelector' => [ + 'title' => '镜像配置', + 'description' => '镜像配置。', + 'type' => 'object', + 'properties' => [ + 'Image' => ['title' => '镜像', 'description' => '镜像。', 'type' => 'string', 'example' => 'lab2.10.0-ray2.43.0'], + 'InferenceEngine' => ['title' => '推理引擎', 'description' => '推理引擎。', 'type' => 'string', 'example' => 'vLLM'], + 'LlmModel' => ['title' => 'LLM模型', 'description' => 'LLM模型。', 'type' => 'string', 'example' => 'Deepseek-R1'], + ], + ], + ], + ], + 'StorageMounts' => [ + 'title' => '挂载存储列表', + 'description' => '挂载存储列表。', + 'type' => 'array', + 'items' => [ + 'title' => '挂载存储', + 'description' => '挂载存储。', + 'type' => 'object', + 'properties' => [ + 'StorageId' => ['title' => '存储ID', 'description' => '存储ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'MountPath' => ['title' => '挂载路径', 'description' => '挂载路径。', 'type' => 'string', 'example' => '/mnt/data01'], + ], + ], + ], + 'UserDefinedRequirements' => ['type' => 'string'], + ], + ], + 'GpuElasticPlan' => [ + 'description' => 'GPU分时弹性计划。', + 'type' => 'object', + 'properties' => [ + 'Enabled' => ['description' => '是否启用。', 'type' => 'boolean', 'example' => 'false'], + 'Rules' => [ + 'description' => '规则列表。', + 'type' => 'array', + 'items' => [ + 'description' => '规则。', + 'type' => 'object', + 'properties' => [ + 'StartCronExpression' => ['description' => '启动时间，Cron表达式，间隔不低于1小时。', 'type' => 'string', 'example' => '0 0 2 * * ?'], + 'EndCronExpression' => ['description' => '结束时间，Cron 表达式，间隔不低于 1 小时。', 'type' => 'string', 'example' => '0 0 3 * * ?'], + ], + ], + ], + ], ], - 'UpdateTime' => [ - 'description' => '更新时间。', + 'ScalePolicy' => [ + 'description' => '资源组的扩容策略，取值说明：'."\n" + ."\n" + .'- AutoScaling：开启自动弹性 AutoScaling 策略。'."\n" + .'- Disable：关闭自动弹性。'."\n" + .'- MultiCluster：开启自动弹性 MultiCluster 策略。', 'type' => 'string', - 'example' => '2024-06-18T07:07:32.000+00:00', + 'example' => 'AutoScaling', + 'enum' => ['AutoScaling', 'Disable', 'MultiCluster'], + ], + 'Classification' => ['description' => '资源组的分类，取值类型：'."\n" + ."\n" + .'- SQL'."\n" + .'- SparkSQL'."\n" + .'- MultiCluster'."\n" + .'- AI', 'type' => 'string', 'example' => 'SQL'], + 'EngineParams' => [ + 'title' => '引擎参数', + 'description' => '引擎参数。', + 'type' => 'object', + 'additionalProperties' => ['title' => '引擎参数', 'description' => '引擎参数。', 'type' => 'any', 'example' => '{\\"spark.adb.version\\":\\"3.5\\"}'], + ], + 'AtmConfig' => [ + 'title' => 'PromQL资源组配置', + 'type' => 'object', + 'properties' => [ + 'InsertNodeSpec' => ['title' => '写入节点规格', 'type' => 'string', 'example' => '8ACU'], + 'InsertNodeNum' => ['title' => '写入节点数量', 'type' => 'string', 'example' => '1'], + 'SelectNodeSpec' => ['title' => '查询节点规格', 'type' => 'string', 'example' => '8ACU'], + 'SelectNodeNum' => ['title' => '查询节点数量', 'type' => 'string', 'example' => '1'], + 'SelectNodeCacheSize' => ['title' => '查询节点缓存大小', 'type' => 'string', 'example' => '10'], + 'StorageNodeSpec' => ['title' => '存储节点规格', 'type' => 'string', 'example' => '8ACU'], + 'StorageNodeNum' => ['title' => '存储节点数量', 'type' => 'string', 'example' => '2'], + 'StorageNodeDiskSize' => ['title' => '存储节点盘大小', 'type' => 'string', 'example' => '100'], + 'StorageNodeDiskType' => [ + 'title' => '存储节点盘类型', + 'type' => 'string', + 'example' => 'essd_pl1', + 'enum' => ['essd_pl1', 'essd_pl2'], + ], + 'AuthNodeSpec' => ['title' => '认证节点规格', 'type' => 'string', 'example' => '8ACU'], + 'AuthNodeNum' => ['title' => '认证节点数量', 'type' => 'string', 'example' => '2'], + ], ], ], ], ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', - ], ], ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'InvalidPoolName.Malformed', 'errorMessage' => 'The specified parameter PoolName is not valid.', 'description' => 'PoolName参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPoolUser.Malformed', 'errorMessage' => 'The specified parameter PoolUser is not valid.', 'description' => 'PoolUser参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPoolType.Malformed', 'errorMessage' => 'The specified parameter PoolType is not valid.', 'description' => 'PoolType参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidMinComputeResource.Malformed', 'errorMessage' => 'The specified parameter MinComputeResource is not valid.', 'description' => 'MinComputeResource参数不正确，请确认参数是否符合规范。'."\n"], + ['errorCode' => 'InvalidMaxComputeResource.Malformed', 'errorMessage' => 'The specified parameter MaxComputeResource is not valid.', 'description' => 'MaxComputeResource参数不正确，请确认参数是否符合规范。'."\n"], ], + 408 => [ + ['errorCode' => 'AcsServerTimeOut', 'errorMessage' => 'The request has failed due to Adb Cloud Service time out.', 'description' => '后端服务超时,请稍后尝试。'], + ], + ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'gatewayOptions' => [ + 'gatewayProtocols' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"3A8F6106-6AFD-5A34-9C80-8DE2C42D06E8\\",\\n \\"Views\\": [\\n {\\n \\"ViewName\\": \\"自定义-1\\",\\n \\"CreateTime\\": \\"2024-06-18T07:06:53.000+00:00\\",\\n \\"UpdateTime\\": \\"2024-06-18T07:07:32.000+00:00\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', - 'title' => '获取监控视图列表', - ], - 'CreatePerformanceView' => [ - 'summary' => '创建自定义监控视图。', - 'methods' => [ - 'post', - 'get', + 'title' => '查询资源组', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2025-12-02T15:07:18.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2025-10-17T13:49:01.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2025-08-20T12:54:57.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2025-03-31T12:12:58.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-10-15T17:29:25.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-09-29T13:33:37.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-08-13T16:32:41.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-03-25T02:12:24.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-03-01T08:17:27.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-01-26T02:37:32.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-09-25T10:08:40.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-03-31T07:03:57.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:51:36.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBResourceGroup'], + ], ], - 'tags' => [ - 'Perth', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDBResourceGroup', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A94B6C02-7BD4-5D67-9776-3AC8317E8DD3\\",\\n \\"GroupsInfo\\": [\\n {\\n \\"GroupType\\": \\"Job\\",\\n \\"GroupName\\": \\"test1\\",\\n \\"MinComputeResource\\": \\"0ACU\\",\\n \\"MaxComputeResource\\": \\"512ACU\\",\\n \\"ClusterSizeResource\\": \\"Reserved parameter\\",\\n \\"MinClusterCount\\": 0,\\n \\"MaxClusterCount\\": 0,\\n \\"RunningClusterCount\\": 0,\\n \\"ClusterMode\\": \\"Reserved parameter\\",\\n \\"ElasticMinComputeResource\\": \\"16ACU\\",\\n \\"EnableSpot\\": \\"True\\",\\n \\"GroupUsers\\": \\"testb,testc\\",\\n \\"CreateTime\\": \\"2022-08-29T03:34:30Z\\",\\n \\"UpdateTime\\": \\"2022-08-31T03:34:30Z\\",\\n \\"Status\\": \\"ok\\",\\n \\"Rules\\": [\\n {\\n \\"GroupName\\": \\"user_default\\",\\n \\"QueryTime\\": \\"180000\\",\\n \\"TargetGroupName\\": \\"job\\"\\n }\\n ],\\n \\"Engine\\": \\"AnalyticDB\\",\\n \\"Message\\": \\"SUCCESS\\",\\n \\"AutoStopInterval\\": \\"0m\\",\\n \\"SpecName\\": \\"ADB.MLLarge.2\\",\\n \\"TargetResourceGroupName\\": \\"test\\",\\n \\"MinGpuQuantity\\": 1,\\n \\"MaxGpuQuantity\\": 2,\\n \\"RayConfig\\": {\\n \\"EnableUserEni\\": true,\\n \\"HeadSpecType\\": \\"cpu\\",\\n \\"HeadSpec\\": \\"ADB.MLLarge.2\\",\\n \\"HeadAllocateUnit\\": \\"1\\",\\n \\"HeadDiskCapacity\\": \\"100Gi\\",\\n \\"Category\\": \\"BASIC\\",\\n \\"WorkerGroups\\": [\\n {\\n \\"GroupName\\": \\"g01\\",\\n \\"AllocateUnit\\": \\"1\\",\\n \\"MaxWorkerQuantity\\": 1,\\n \\"MinWorkerQuantity\\": 1,\\n \\"WorkerDiskCapacity\\": \\"100G\\",\\n \\"WorkerSpecName\\": \\"large\\",\\n \\"WorkerSpecType\\": \\"CPU\\"\\n }\\n ],\\n \\"RayClusterAddress\\": \\"http://ray-cluster-address.example.com\\",\\n \\"RayDashboardAddress\\": \\"http://ray-dashboard-address.example.com\\",\\n \\"RayGrafanaAddress\\": \\"http://ray-grafana-address.example.com\\",\\n \\"RayServePublicAddress\\": \\"1.2.3.4:8100\\",\\n \\"AppConfig\\": {\\n \\"AppName\\": \\"app01\\",\\n \\"AppType\\": \\"IsaacLab\\",\\n \\"ImageSelector\\": {\\n \\"Image\\": \\"lab2.10.0-ray2.43.0\\",\\n \\"InferenceEngine\\": \\"vLLM\\",\\n \\"LlmModel\\": \\"Deepseek-R1\\"\\n }\\n },\\n \\"StorageMounts\\": [\\n {\\n \\"StorageId\\": 1,\\n \\"MountPath\\": \\"/mnt/data01\\"\\n }\\n ],\\n \\"UserDefinedRequirements\\": \\"\\"\\n },\\n \\"GpuElasticPlan\\": {\\n \\"Enabled\\": false,\\n \\"Rules\\": [\\n {\\n \\"StartCronExpression\\": \\"0 0 2 * * ?\\",\\n \\"EndCronExpression\\": \\"0 0 3 * * ?\\"\\n }\\n ]\\n },\\n \\"ScalePolicy\\": \\"AutoScaling\\",\\n \\"Classification\\": \\"SQL\\",\\n \\"EngineParams\\": {\\n \\"key\\": \\"{\\\\\\\\\\\\\\"spark.adb.version\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"3.5\\\\\\\\\\\\\\"}\\"\\n },\\n \\"AtmConfig\\": {\\n \\"InsertNodeSpec\\": \\"8ACU\\",\\n \\"InsertNodeNum\\": \\"1\\",\\n \\"SelectNodeSpec\\": \\"8ACU\\",\\n \\"SelectNodeNum\\": \\"1\\",\\n \\"SelectNodeCacheSize\\": \\"10\\",\\n \\"StorageNodeSpec\\": \\"8ACU\\",\\n \\"StorageNodeNum\\": \\"2\\",\\n \\"StorageNodeDiskSize\\": \\"100\\",\\n \\"StorageNodeDiskType\\": \\"essd_pl1\\",\\n \\"AuthNodeSpec\\": \\"8ACU\\",\\n \\"AuthNodeNum\\": \\"2\\"\\n }\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeDBResourceGroupResponse>\\n <RequestId>A94B6C02-7BD4-5D67-9776-3AC8317E8DD3</RequestId>\\n <GroupsInfo>\\n <GroupType>Job</GroupType>\\n <GroupName>test1</GroupName>\\n <MinComputeResource>0ACU</MinComputeResource>\\n <MaxComputeResource>512ACU</MaxComputeResource>\\n <ClusterSizeResource>预留参数，不涉及</ClusterSizeResource>\\n <ClusterMode>预留参数，不涉及</ClusterMode>\\n <ElasticMinComputeResource>16ACU</ElasticMinComputeResource>\\n <EnableSpot>True</EnableSpot>\\n <GroupUsers>testb,testc</GroupUsers>\\n <CreateTime>2022-08-29T03:34:30Z</CreateTime>\\n <UpdateTime>2022-08-31T03:34:30Z</UpdateTime>\\n <Status>ok</Status>\\n <Rules/>\\n </GroupsInfo>\\n</DescribeDBResourceGroupResponse>","errorExample":""}]', + ], + 'DescribeDiagnosisDimensions' => [ + 'summary' => '查看AnalyticDB MySQL湖仓版（3.0）集群符合指定检索条件的SQL在资源组、数据库名、用户名以及访问源地址等维度下的去重统计信息。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '221254', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, + 'abilityTreeCode' => '132346', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 调用[DescribeDBClusters](~~612397~~)接口可以查看集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1ub9grke1****', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的集群ID。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bt6u59zcmd945****'], ], [ - 'name' => 'RegionId', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-beijing', - ], + 'schema' => ['description' => '查询开始时间，格式为Unix时间戳，单位：毫秒。'."\n" + .'> 仅支持查看最近14天的数据，查询超过14天前的数据返回结果为空。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '1625220210000'], ], [ - 'name' => 'ViewDetail', + 'name' => 'EndTime', 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'description' => '监控视图详情。', - 'type' => 'object', - 'properties' => [ - 'ChartsPerLine' => [ - 'description' => '每一行展示的图表数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '2', - ], - 'ChartLinked' => [ - 'description' => '是否联动图表。取值：'."\n" - .'- **true**：是。'."\n" - .'- **false**：否。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'Categories' => [ - 'description' => '指标分类列表。', - 'type' => 'array', - 'items' => [ - 'description' => '指标分类。', - 'type' => 'object', - 'properties' => [ - 'Category' => [ - 'description' => '指标分类名，取值：'."\n" - .'* **Node**：节点资源指标。'."\n" - .'* **DiskData**：磁盘指标。'."\n" - .'* **WorkLoad**：负载指标。'."\n" - .'* **ResourceGroup**：资源组指标。', - 'type' => 'string', - 'required' => false, - 'example' => 'Node', - ], - 'Keys' => [ - 'description' => '指标列表。', - 'type' => 'array', - 'items' => [ - 'description' => '单个指标配置。', - 'type' => 'object', - 'properties' => [ - 'KeyName' => [ - 'description' => '指标Key。', - 'type' => 'string', - 'required' => false, - 'example' => 'AnalyticDB_CPU', - ], - 'Selected' => [ - 'description' => '是否选中。取值：'."\n" - .'- **true**：是。'."\n" - .'- **false**：否。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - ], - 'required' => false, - ], - 'required' => false, - ], - ], - 'required' => false, - ], - 'required' => false, - ], - ], - 'required' => true, - ], + 'schema' => ['description' => '查询结束时间，格式为Unix时间戳，单位：毫秒。'."\n" + ."\n" + .'> * 查询结束时间需晚于查询开始时间。'."\n" + .'> * 开始时间与结束时间的间隔不能超过24小时。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '1625220213000'], ], [ - 'name' => 'ViewName', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '监控视图名称。', - 'type' => 'string', - 'required' => true, - 'example' => '自定义-全部指标-2列-联动', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定AnalyticDB MySQL湖仓版（3.0）集群的地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'CreateFromViewType', + 'name' => 'QueryCondition', 'in' => 'query', - 'schema' => [ - 'description' => '当前监控视图复制自原始监控视图的类型，取值：'."\n" - ."\n" - .'- **Basic**：基础视图'."\n" - .'- **Advanced**：高级视图', - 'type' => 'string', - 'required' => false, - 'example' => 'Basic', - ], + 'schema' => ['description' => 'SQL查询的条件，格式为JOSN字符串，包含`Type`、`Value`、`Min`或`Max`等字段。其中`Type` 表示查询维度（当前仅支持3个取值：`maxCost`、`status`和`cost`）；`Value`、`Min`或`Max`表示该维度下的查询范围。取值说明：'."\n" + .'- ` {"Type":"maxCost","Value":"100"}`：表示查看执行耗时最长的前100条SQL详情，当前`Value`的取值仅支持设置为100。'."\n" + .'- `{"Type":"status","Value":"finished"}`：表示查看已完成的SQL详情。您也可以将`Value`设置为`running`或`failed`来查询正在执行或执行失败的SQL详情。'."\n" + .'- `{"Type":"cost","Min":"10","Max":"200"}`：表示查看执行耗时为10毫秒~200毫秒的SQL详情，您也可以自定义执行耗时的最大值与最小值，单位：毫秒（ms）。', 'type' => 'string', 'required' => false, 'example' => '{"Type":"maxCost","Value":"100"}'], ], [ - 'name' => 'FillOriginViewKeys', + 'name' => 'Lang', 'in' => 'query', - 'schema' => [ - 'description' => '查看监控视图时，是否填充原始监控视图完成的Key。取值：'."\n" - .'- **true**：是。'."\n" - .'- **false**：否。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], + 'schema' => ['description' => '语言配置，取值说明：'."\n" + .'- **zh-CN**：简体中文（默认语言）。'."\n" + .'- **en-US**：英文。'."\n" + .'- **ja**：日文。', 'type' => 'string', 'required' => false, 'example' => 'zh-CN'], ], ], 'responses' => [ @@ -16880,78 +12244,82 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'E031AABF-BD56-5966-A063-4283EF18DB45', + 'ClientIps' => [ + 'description' => '访问源地址。', + 'type' => 'array', + 'items' => ['description' => '访问源地址。', 'type' => 'string', 'example' => '106.11.xx.xx'], ], - 'CreateStatus' => [ - 'description' => '创建结果，取值：'."\n" - ."\n" - .'- **SUCCESS**：成功。'."\n" - .'- **FAILED**：失败。', - 'type' => 'string', - 'example' => 'SUCCESS', + 'ResourceGroups' => [ + 'description' => '资源组名称。', + 'type' => 'array', + 'items' => ['description' => '资源组名称。', 'type' => 'string', 'example' => 'user_defaul'], ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', + 'UserNames' => [ + 'description' => '用户名。', + 'type' => 'array', + 'items' => ['description' => '用户名。', 'type' => 'string', 'example' => 'test_user'], ], + 'Databases' => [ + 'description' => '数据库名称。', + 'type' => 'array', + 'items' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'adb_demo'], + ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'DEA97C6B-D7A4-5E69-9EFC-D7F88737CED5'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'gatewayOptions' => [ + 'gatewayProtocols' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"E031AABF-BD56-5966-A063-4283EF18DB45\\",\\n \\"CreateStatus\\": \\"SUCCESS\\",\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', - 'title' => '创建自定义监控视图', - ], - 'ModifyPerformanceView' => [ - 'summary' => '修改自定义监控视图。', - 'methods' => [ - 'post', - 'get', + 'title' => '查询不同维度的SQL去重统计信息', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-09-13T12:07:35.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-22T04:03:32.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDiagnosisDimensions'], + ], ], - 'tags' => [ - 'Perth', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDiagnosisDimensions', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"ClientIps\\": [\\n \\"106.11.xx.xx\\"\\n ],\\n \\"ResourceGroups\\": [\\n \\"user_defaul\\"\\n ],\\n \\"UserNames\\": [\\n \\"test_user\\"\\n ],\\n \\"Databases\\": [\\n \\"adb_demo\\"\\n ],\\n \\"RequestId\\": \\"DEA97C6B-D7A4-5E69-9EFC-D7F88737CED5\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeDiagnosisDimensionsResponse>\\n <ClientIps>[\\"106.11.xx.xx\\",\\"106.11.xx.xx\\"]</ClientIps>\\n <ResourceGroups>user_defaul</ResourceGroups>\\n <UserNames>test_user</UserNames>\\n <Databases>adb_demo</Databases>\\n <RequestId>DEA97C6B-D7A4-5E69-9EFC-D7F88737CED5</RequestId>\\n</DescribeDiagnosisDimensionsResponse>","errorExample":""}]', + ], + 'DescribeDiagnosisRecords' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '220840', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '131519', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], 'autoTest' => true, 'tenantRelevance' => 'tenant', ], @@ -16959,179 +12327,250 @@ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 调用[DescribeDBClusters](~~612397~~)接口可以查看集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1ub9grke1****', - ], + 'schema' => ['description' => '企业版、基础版或湖仓版集群ID。'."\n" + ."\n" + .'> 您可以通过[DescribeDBClusters](~~612397~~)接口查看账号下所有集群的详细信息，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1scs48yc125****'], + ], + [ + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => ['description' => '查询开始时间，格式为Unix时间戳，单位：毫秒。'."\n" + .'> 仅支持查看14天内的数据。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '1632931200000'], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => '查询结束时间，格式为Unix时间戳，单位：毫秒。'."\n" + .'> * 查询结束时间需晚于查询开始时间。'."\n" + .'> * 开始时间与结束时间的间隔不能超过24小时。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '1633017540000'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'ViewName', + 'name' => 'QueryCondition', 'in' => 'query', - 'schema' => [ - 'description' => '监控视图名称。', - 'type' => 'string', - 'required' => true, - 'example' => '自定义-全部指标-2列-联动', - ], + 'schema' => ['description' => 'SQL查询的条件，格式为JOSN字符串，包含`Type`、`Value`、`Min`或`Max`等字段。其中`Type` 表示查询维度（当前仅支持3个取值：`maxCost`、`status`和`cost`）；`Value`、`Min`或`Max`表示该维度下的查询范围。取值说明：'."\n" + .'- ` {"Type":"maxCost","Value":"100"}`：表示查看执行耗时最长的前100条SQL详情，当前`Value`的取值仅支持设置为100。'."\n" + .'- `{"Type":"status","Value":"finished"}`：表示查看已完成的SQL详情。您也可以将`Value`设置为`running`或`failed`来查询正在执行或执行失败的SQL详情。'."\n" + .'- `{"Type":"cost","Min":"10","Max":"200"}`：表示查看执行耗时为10毫秒~200毫秒的SQL详情，您也可以自定义执行耗时的最大值与最小值，单位：毫秒。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '{"Type":"status","Value":"finished"}'], ], [ - 'name' => 'ViewDetail', + 'name' => 'Keyword', 'in' => 'query', - 'style' => 'json', + 'schema' => ['description' => '按SQL语句中包含的关键字过滤。', 'type' => 'string', 'required' => false, 'example' => 'select'], + ], + [ + 'name' => 'MinPeakMemory', + 'in' => 'query', + 'schema' => ['description' => 'SQL语句的最小峰值内存，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '0'], + ], + [ + 'name' => 'MaxPeakMemory', + 'in' => 'query', + 'schema' => ['description' => 'SQL语句的最大峰值内存，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '89000000'], + ], + [ + 'name' => 'MinScanSize', + 'in' => 'query', + 'schema' => ['description' => 'SQL语句的最小扫描量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '0'], + ], + [ + 'name' => 'MaxScanSize', + 'in' => 'query', + 'schema' => ['description' => '目标SQL的最大扫描量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1024000000'], + ], + [ + 'name' => 'ResourceGroup', + 'in' => 'query', + 'schema' => ['description' => 'SQL语句所属的资源组。'."\n" + .'> 您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL语句所属的资源组、数据库名、用户名以及访问源地址信息。', 'type' => 'string', 'required' => false, 'example' => 'user_default'], + ], + [ + 'name' => 'UserName', + 'in' => 'query', + 'schema' => ['description' => '执行SQL语句的用户名。'."\n" + .'您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL语句所属的资源组、数据库名、用户名以及访问源地址信息。', 'type' => 'string', 'required' => false, 'example' => 'test_user'], + ], + [ + 'name' => 'Database', + 'in' => 'query', + 'schema' => ['description' => '执行SQL语句的数据库。'."\n" + .'> 您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL语句所属的资源组、数据库名、用户名以及访问源地址信息。', 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], + ], + [ + 'name' => 'ClientIp', + 'in' => 'query', + 'schema' => ['description' => '访问源地址。'."\n" + .'> 您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL语句所属的资源组、数据库名、用户名以及访问源地址信息。', 'type' => 'string', 'required' => false, 'example' => '59.82.XX.XX'], + ], + [ + 'name' => 'Order', + 'in' => 'query', + 'schema' => ['description' => '根据指定字段对SQL语句进行排序，格式为JSON，是一个有序JSON数组，按输入数组的顺序进行复合排序，包含`Field`和`Type`两个字段，例如`[{"Field":"StartTime", "Type": "desc" }]`。其中：'."\n" + ."\n" + .'- `Field`表示需要排序的字段名，支持如下字段：'."\n" + .' - `StartTime`：执行开始时间。'."\n" + .' - `Status`：执行状态。'."\n" + .' - `UserName`：用户名称。'."\n" + .' - `Cost`：执行耗时。'."\n" + .' - `PeakMemory`：峰值内存。'."\n" + .' - `ScanSize`：扫描数据量。'."\n" + .' - `Database`：数据库名称。'."\n" + .' - `ClientIp`：访问源地址.'."\n" + .' - `ResourceGroup`：资源组。'."\n" + .' - `QueueTime`：排队耗时。'."\n" + .' - `OutputRows`：输出行数。'."\n" + .' - `OutputDataSize`：输出数据量。'."\n" + .' - `ResourceCostRank`：SQL内部算子的耗时排名（仅当`QueryCondition`取值为`{"Type":"status","Value":"running"}`时，支持使用该字段）。'."\n" + ."\n" + .'- `Type`表示排序类型，支持如下取值（取值均不区分大小写）：'."\n" + .' - `Desc`：降序。'."\n" + .' - `Asc`：升序。', 'type' => 'string', 'required' => false, 'example' => '[{"Field":"StartTime", "Type": "desc" }]'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30'], + ], + [ + 'name' => 'Lang', + 'in' => 'query', + 'schema' => ['description' => '设置下载文件的文件标题以及部分错误信息的语言，支持如下语言：'."\n" + .'- **zh**：简体中文（默认语言）。'."\n" + .'- **en**：英文。'."\n" + .'- **ja**：日文。'."\n" + .'- **zh-tw**：繁体中文。', 'type' => 'string', 'required' => false, 'example' => 'zh'], + ], + [ + 'name' => 'PatternId', + 'in' => 'query', + 'schema' => ['description' => 'SQL Pattern的ID。', 'type' => 'string', 'required' => false, 'example' => '5575924945138******'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '监控视图详情。', 'type' => 'object', 'properties' => [ - 'ChartsPerLine' => [ - 'description' => '每一行展示的图表数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '3', - ], - 'ChartLinked' => [ - 'description' => '是否联动图表。取值：'."\n" - ."\n" - .'- true'."\n" - .'- false', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'Categories' => [ - 'description' => '指标分类列表。', + 'PageNumber' => ['description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'Querys' => [ + 'description' => 'SQL语句详情列表。', 'type' => 'array', 'items' => [ - 'description' => '指标分类。', + 'description' => '列表。', 'type' => 'object', 'properties' => [ - 'Category' => [ - 'description' => '指标分类名，取值：'."\n" - .'* **Node**：节点资源指标'."\n" - .'* **DiskData**：磁盘指标'."\n" - .'* **WorkLoad**：负载指标'."\n" - .'* **ResourceGroup**：资源组指标', - 'type' => 'string', - 'required' => false, - 'example' => 'Node', - ], - 'Keys' => [ - 'description' => '指标列表', + 'SQL' => ['description' => 'SQL语句详情。'."\n" + .'> 出于性能考虑，当前SQL语句最长支持显示5120个字符，超出限制的SQL语句会被截断。您可以调用[DownloadDiagnosisRecords](~~308212~~)接口下载符合指定条件的SQL语句的摘要信息，包括完整的SQL语句。', 'type' => 'string', 'example' => 'SELECT count(*)\\nFROM nation'], + 'SQLTruncatedThreshold' => ['description' => 'SQL语句的截断阈值，固定为5120个字符。超过该长度的SQL语句会被截断。', 'type' => 'integer', 'format' => 'int64', 'example' => '5120'], + 'Status' => ['description' => 'SQL语句的状态，取值为：'."\n" + .'- **running**：执行中。'."\n" + .'- **finished**：已完成。'."\n" + .'- **failed**：执行失败。', 'type' => 'string', 'example' => 'finished'], + 'OutputDataSize' => ['description' => '返回数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '9'], + 'Cost' => ['description' => '查询的总耗时。单位：毫秒。'."\n" + .'> 该耗时指标是`QueuedTime`、`TotalPlanningTime`和`ExecutionTime`三个耗时指标的累加值。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'], + 'OutputRows' => ['description' => '返回行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'RcHost' => ['description' => '执行SQL语句的AnalyticDB MySQL前端节点IP和端口信息。', 'type' => 'string', 'example' => '10.0.XX.XX:3004'], + 'ScanSize' => ['description' => '扫描数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '9'], + 'ProcessId' => ['description' => '查询ID。', 'type' => 'string', 'example' => '2021093000414401000000023503151******'], + 'StartTime' => ['description' => 'SQL语句的执行开始时间，格式为Unix时间戳，单位：毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1632933704000'], + 'SQLTruncated' => ['description' => '查询结果的长度是否超过阈值（即是否被截断），取值说明：'."\n" + .'- **true**：查询结果的长度超过阈值。'."\n" + .'- **false**：查询结果的长度未超过阈值。', 'type' => 'boolean', 'example' => 'false'], + 'Database' => ['description' => '执行SQL语句的数据库名称。', 'type' => 'string', 'example' => 'adb_demo'], + 'ScanRows' => ['description' => '扫描行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'ResourceCostRank' => ['description' => 'SQL语句内部算子的耗时排名。'."\n" + .'> 仅状态为执行中，即`Status`取值为`running`的SQL语句支持返回该字段。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'ClientIp' => ['description' => '访问源地址。', 'type' => 'string', 'example' => '59.82.XX.XX'], + 'PeakMemory' => ['description' => '峰值内存，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '16648'], + 'QueueTime' => ['description' => '查询执行前的排队时间，单位：毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '6'], + 'ResourceGroup' => ['description' => 'SQL语句所属的资源池。', 'type' => 'string', 'example' => 'user_default'], + 'UserName' => ['description' => '执行SQL语句的用户名。', 'type' => 'string', 'example' => 'test_user'], + 'ExecutionTime' => ['description' => '查询执行的耗时，单位：毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '6'], + 'TotalPlanningTime' => ['description' => '生成执行计划的耗时，单位：毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '4'], + 'EtlWriteRows' => ['description' => 'ETL任务写表的行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'TotalStages' => ['description' => '查询生成的总Stage数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'QueryProperties' => [ + 'description' => '当前查询最终生效的属性列表。'."\n" + ."\n" + .'> 常用属性列表，可以参考官方文档，[Config和Hint配置参数](~~408955~~)。', 'type' => 'array', 'items' => [ - 'description' => '单个指标配置。', + 'description' => '属性键值描述。', 'type' => 'object', 'properties' => [ - 'KeyName' => [ - 'description' => '指标Key。', - 'type' => 'string', - 'required' => false, - 'example' => 'AnalyticDB_CPU', - ], - 'Selected' => [ - 'description' => '是否选中。取值：'."\n" - ."\n" - .'- true'."\n" - .'- false', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], + 'Name' => ['description' => '属性名称。', 'type' => 'string', 'example' => 'max_select_items_count'], + 'Value' => ['description' => '属性值。', 'type' => 'string', 'example' => '1024'], ], - 'required' => false, ], - 'required' => false, ], + 'PatternId' => ['description' => 'SQL Pattern的ID。'."\n" + .'> 您可以调用[DescribePatternPerformance](~~612503~~)接口查看指定时间内该SQLPattern执行的详细指标。', 'type' => 'string', 'example' => '-5575924945138******'], ], - 'required' => false, ], - 'required' => false, ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '7F88BEFA-CF0B-5C95-8BB1-92EC9F09E40D'], ], - 'required' => true, + 'description' => '', ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'C7EDB8E4-9769-4233-88C7-DCA4C9******', - ], - 'ModifyStatus' => [ - 'description' => '修改结果，取值：'."\n" - ."\n" - .'- **SUCCESS**：成功'."\n" - .'- **FAILED**：失败', - 'type' => 'string', - 'example' => 'SUCCESS', - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息；只有校验RAM失败后，字段才会返回。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', - ], - ], - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => '查看SQL摘要信息', + 'summary' => '调用DownloadDiagnosisRecords接口查看目标AnalyticDB MySQL集群中符合指定条件的SQL摘要信息。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-10-21T12:16:17.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-08-30T11:11:29.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-09-13T12:07:35.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2022-03-22T08:51:02.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDiagnosisRecords'], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDiagnosisRecords', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C7EDB8E4-9769-4233-88C7-DCA4C9******\\",\\n \\"ModifyStatus\\": \\"SUCCESS\\",\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', - 'title' => '修改自定义监控视图', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"Querys\\": [\\n {\\n \\"SQL\\": \\"SELECT count(*)\\\\\\\\nFROM nation\\",\\n \\"SQLTruncatedThreshold\\": 5120,\\n \\"Status\\": \\"finished\\",\\n \\"OutputDataSize\\": 9,\\n \\"Cost\\": 10,\\n \\"OutputRows\\": 1,\\n \\"RcHost\\": \\"10.0.XX.XX:3004\\",\\n \\"ScanSize\\": 9,\\n \\"ProcessId\\": \\"2021093000414401000000023503151******\\",\\n \\"StartTime\\": 1632933704000,\\n \\"SQLTruncated\\": false,\\n \\"Database\\": \\"adb_demo\\",\\n \\"ScanRows\\": 1,\\n \\"ResourceCostRank\\": 1,\\n \\"ClientIp\\": \\"59.82.XX.XX\\",\\n \\"PeakMemory\\": 16648,\\n \\"QueueTime\\": 6,\\n \\"ResourceGroup\\": \\"user_default\\",\\n \\"UserName\\": \\"test_user\\",\\n \\"ExecutionTime\\": 6,\\n \\"TotalPlanningTime\\": 4,\\n \\"EtlWriteRows\\": 0,\\n \\"TotalStages\\": 2,\\n \\"QueryProperties\\": [\\n {\\n \\"Name\\": \\"max_select_items_count\\",\\n \\"Value\\": \\"1024\\"\\n }\\n ],\\n \\"PatternId\\": \\"-5575924945138******\\"\\n }\\n ],\\n \\"RequestId\\": \\"7F88BEFA-CF0B-5C95-8BB1-92EC9F09E40D\\"\\n}","type":"json"}]', ], - 'DescribePerformanceViewAttribute' => [ - 'summary' => '查看监控视图详情。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [ - 'Perth', - ], + 'DescribeDiagnosisSQLInfo' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], + 'tags' => [], 'security' => [ [ 'AK' => [], @@ -17140,52 +12579,60 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '220839', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '132343', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 调用[DescribeDBClusters](~~612397~~)接口可以查看集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下AnalyticDB MySQL集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1r053by****'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL支持的地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'ViewName', + 'name' => 'ProcessId', 'in' => 'query', - 'schema' => [ - 'description' => '监控视图名称。', - 'type' => 'string', - 'required' => true, - 'example' => '自定义-全部指标-2列-联动', - ], + 'schema' => ['description' => '查询ID。'."\n" + .'> 您可以调用[DescribeDiagnosisRecords](~~308207~~)接口查看指定的AnalyticDB MySQL集群中SQL摘要信息，包括查询ID。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '20210702164322172016168****', 'default' => '2023091317073501108614302703151362858'], + ], + [ + 'name' => 'ProcessStartTime', + 'in' => 'query', + 'schema' => ['description' => 'SQL语句的执行开始时间，格式为Unix时间戳，单位为毫秒（ms）。'."\n" + .'> 您可以调用[DescribeDiagnosisRecords](~~308207~~)接口查看指定的AnalyticDB MySQL集群中SQL摘要信息，包括SQL语句的执行开始时间。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'docRequired' => true, 'example' => '1625215402000', 'default' => '-1'], + ], + [ + 'name' => 'ProcessState', + 'in' => 'query', + 'schema' => ['description' => 'SQL语句的状态，取值如下：'."\n" + .'- **running**：执行中。'."\n" + .'- **finished**：已完成。'."\n" + .'- **failed**：执行失败。'."\n" + .'> 您可以调用[DescribeDiagnosisRecords](~~308207~~)接口查看指定的AnalyticDB MySQL集群中SQL摘要信息，包括SQL语句的状态信息。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'running', 'default' => 'running'], + ], + [ + 'name' => 'Lang', + 'in' => 'query', + 'schema' => ['description' => '设置下载文件的文件标题以及部分错误信息的语言，支持如下语言：'."\n" + .'- **zh**：简体中文。'."\n" + .'- **en**：英文。'."\n" + .'- **ja**：日语。'."\n" + .'- **zh-tw**：繁体中文。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'zh'], + ], + [ + 'name' => 'ProcessRcHost', + 'in' => 'query', + 'schema' => ['description' => '执行SQL语句的AnalyticDB MySQL前端节点IP和端口信息。'."\n" + .'> 您可以调用[DescribeDiagnosisRecords](~~308207~~)接口查看指定的AnalyticDB MySQL集群中SQL摘要信息，包括前端节点IP和端口信息。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '192.45.***.***:3145'], ], ], 'responses' => [ @@ -17193,216 +12640,109 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'E031AABF-BD56-5966-A063-4283EF18DB45', - ], - 'ViewName' => [ - 'description' => '监控视图名称。', - 'type' => 'string', - 'example' => '自定义-全部指标-2列-联动', - ], - 'CreateFromViewType' => [ - 'description' => '原始图表来源的类型，取值：'."\n" - ."\n" - .'- **Basic**：基础视图'."\n" - .'- **Advanced**：高级视图', - 'type' => 'string', - 'example' => 'Basic', - ], - 'ViewDetail' => [ - 'description' => '监控视图详情。', - 'type' => 'object', - 'properties' => [ - 'ChartsPerLine' => [ - 'description' => '每一行展示的图表数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'ChartLinked' => [ - 'description' => '是否联动图表。取值：'."\n" - ."\n" - .'- true'."\n" - .'- false', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Categories' => [ - 'description' => '指标分类列表。', - 'type' => 'array', - 'items' => [ - 'description' => '指标分类。', - 'type' => 'object', - 'properties' => [ - 'Category' => [ - 'description' => '指标分类名，取值：'."\n" - .'* **Node**：节点资源指标'."\n" - .'* **DiskData**：磁盘指标'."\n" - .'* **WorkLoad**：负载指标'."\n" - .'* **ResourceGroup**：资源组指标', - 'type' => 'string', - 'example' => 'Node', - ], - 'Keys' => [ - 'description' => '指标列表。', - 'type' => 'array', - 'items' => [ - 'description' => '单个指标配置。', - 'type' => 'object', - 'properties' => [ - 'KeyName' => [ - 'description' => '指标Key。', - 'type' => 'string', - 'example' => 'AnalyticDB_CPU', - ], - 'Selected' => [ - 'description' => '是否选中。取值：'."\n" - ."\n" - .'- true'."\n" - .'- false', - 'type' => 'boolean', - 'example' => 'true', - ], - 'GroupType' => [ - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - 'Engine' => [ - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - 'EnableAutoMc' => [ - 'type' => 'boolean', - ], - ], - ], - ], - ], - ], + 'DiagnosisSQLInfo' => ['description' => 'SQL的执行详情，包括详细的SQL语句、统计信息、执行计划和算子信息等。', 'type' => 'string', 'example' => '{ "DiagnosisSQLInfo": { "hasSharedStage": false, "resourceGroup": "user_default", "cost": 274, "queuedTime": 0, "outputDataSize": 9, "scheduled": true, "query": "/*+display=tpch_q14*/SELECT 100.00 * SUM(CASE WHEN p_type LIKE \'PROMO%\' THEN l_extendedprice * (1 - l_discount) ELSE 0 END) / SUM(l_extendedprice * (1 - l_discount)) AS promo_revenue FROM lineitem l, part p WHERE l_partkey = p_partkey AND l_shipdate >= DATE \'1995-09-01\' AND l_shipdate < DATE \'1995-09-01\' + INTERVAL \'1\' MONTH", "outputRows": 1, "userName": "test_user", "parentId": 0, "maxOutputRows": 200000, "scanSize": 8247470, "peakMemory": 13188295, "startTime": 1626330527632, "state": "FINISHED", "endTime": 1626330527905, "writeTableRows": 0, "scanRows": 351966 } }'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1'], + 'StageInfos' => [ + 'description' => '查询的分阶段执行信息。', + 'type' => 'array', + 'items' => [ + 'description' => '查询的分阶段执行信息。', + 'type' => 'object', + 'properties' => [ + 'InputRows' => ['description' => 'Stage总的输入行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '2341'], + 'InputDataSize' => ['description' => 'Stage总的输入数据量，单位为Bytes。', 'type' => 'integer', 'format' => 'int64', 'example' => '2341'], + 'OutputRows' => ['description' => 'Stage总的输出行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '2341'], + 'OutputDataSize' => ['description' => 'Stage总的输出数据量，单位为Bytes。', 'type' => 'integer', 'format' => 'int64', 'example' => '2341'], + 'PeakMemory' => ['description' => 'Stage总的峰值内存，单位为Bytes。', 'type' => 'integer', 'format' => 'int64', 'example' => '2341'], + 'OperatorCost' => ['description' => 'Stage的算子累积耗时，单位为毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '2341'], + 'StageId' => ['description' => 'StageID。', 'type' => 'string', 'example' => 'Stage[26]'], + 'State' => ['description' => 'Stage状态。', 'type' => 'string', 'example' => 'RUNNING'], + 'Progress' => ['description' => 'Stage的执行进度。', 'type' => 'number', 'format' => 'double', 'example' => '0.3'], + 'ExecutionType' => ['type' => 'string', 'description' => ''], ], ], ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp198m028ih55xxxx', - ], - 'FillOriginViewKeys' => [ - 'description' => '查看监控视图时，是否填充原始监控视图完成的Key。取值：'."\n" - ."\n" - .'- true'."\n" - .'- false', - 'type' => 'boolean', - 'example' => 'true', - ], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'PerformanceViewNotFound', - 'errorMessage' => 'Performance view not found.', - ], - ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'gatewayOptions' => [ + 'gatewayProtocols' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"E031AABF-BD56-5966-A063-4283EF18DB45\\",\\n \\"ViewName\\": \\"自定义-全部指标-2列-联动\\",\\n \\"CreateFromViewType\\": \\"Basic\\",\\n \\"ViewDetail\\": {\\n \\"ChartsPerLine\\": 2,\\n \\"ChartLinked\\": true,\\n \\"Categories\\": [\\n {\\n \\"Category\\": \\"Node\\",\\n \\"Keys\\": [\\n {\\n \\"KeyName\\": \\"AnalyticDB_CPU\\",\\n \\"Selected\\": true,\\n \\"GroupType\\": [\\n \\"\\"\\n ],\\n \\"Engine\\": [\\n \\"\\"\\n ],\\n \\"EnableAutoMc\\": true\\n }\\n ]\\n }\\n ]\\n },\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\",\\n \\"DBClusterId\\": \\"amv-bp198m028ih55xxxx\\",\\n \\"FillOriginViewKeys\\": true\\n}","type":"json"}]', - 'title' => '查看监控视图详情', - ], - 'DeletePerformanceView' => [ - 'summary' => '删除监控视图。', - 'methods' => [ - 'post', - 'get', + 'title' => '查看SQL执行详情', + 'summary' => '查看某个SQL的执行详情，包括执行计划、运行信息、资源使用、自诊断结果等。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2025-04-18T08:59:42.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-01-05T06:00:26.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-01-03T03:56:29.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-12-15T11:35:40.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-07-26T03:55:50.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-07-26T03:51:50.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-22T04:03:32.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDiagnosisSQLInfo'], + ], ], - 'tags' => [ - 'Perth', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDiagnosisSQLInfo', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"DiagnosisSQLInfo\\": \\"{ \\\\\\"DiagnosisSQLInfo\\\\\\": { \\\\\\"hasSharedStage\\\\\\": false, \\\\\\"resourceGroup\\\\\\": \\\\\\"user_default\\\\\\", \\\\\\"cost\\\\\\": 274, \\\\\\"queuedTime\\\\\\": 0, \\\\\\"outputDataSize\\\\\\": 9, \\\\\\"scheduled\\\\\\": true, \\\\\\"query\\\\\\": \\\\\\"/*+display=tpch_q14*/SELECT 100.00 * SUM(CASE WHEN p_type LIKE \'PROMO%\' THEN l_extendedprice * (1 - l_discount) ELSE 0 END) / SUM(l_extendedprice * (1 - l_discount)) AS promo_revenue FROM lineitem l, part p WHERE l_partkey = p_partkey AND l_shipdate >= DATE \'1995-09-01\' AND l_shipdate < DATE \'1995-09-01\' + INTERVAL \'1\' MONTH\\\\\\", \\\\\\"outputRows\\\\\\": 1, \\\\\\"userName\\\\\\": \\\\\\"test_user\\\\\\", \\\\\\"parentId\\\\\\": 0, \\\\\\"maxOutputRows\\\\\\": 200000, \\\\\\"scanSize\\\\\\": 8247470, \\\\\\"peakMemory\\\\\\": 13188295, \\\\\\"startTime\\\\\\": 1626330527632, \\\\\\"state\\\\\\": \\\\\\"FINISHED\\\\\\", \\\\\\"endTime\\\\\\": 1626330527905, \\\\\\"writeTableRows\\\\\\": 0, \\\\\\"scanRows\\\\\\": 351966 } }\\",\\n \\"RequestId\\": \\"1\\",\\n \\"StageInfos\\": [\\n {\\n \\"InputRows\\": 2341,\\n \\"InputDataSize\\": 2341,\\n \\"OutputRows\\": 2341,\\n \\"OutputDataSize\\": 2341,\\n \\"PeakMemory\\": 2341,\\n \\"OperatorCost\\": 2341,\\n \\"StageId\\": \\"Stage[26]\\",\\n \\"State\\": \\"RUNNING\\",\\n \\"Progress\\": 0.3,\\n \\"ExecutionType\\": \\"\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeDiagnosisSQLInfoResponse>\\n <DiagnosisSQLInfo>{ \\"DiagnosisSQLInfo\\": { \\"hasSharedStage\\": false, \\"resourceGroup\\": \\"user_default\\", \\"cost\\": 274, \\"queuedTime\\": 0, \\"outputDataSize\\": 9, \\"scheduled\\": true, \\"query\\": \\"/*+display=tpch_q14*/SELECT 100.00 * SUM(CASE WHEN p_type LIKE \'PROMO%\' THEN l_extendedprice * (1 - l_discount) ELSE 0 END) / SUM(l_extendedprice * (1 - l_discount)) AS promo_revenue FROM lineitem l, part p WHERE l_partkey = p_partkey AND l_shipdate &gt;= DATE \'1995-09-01\' AND l_shipdate &lt; DATE \'1995-09-01\' + INTERVAL \'1\' MONTH\\", \\"outputRows\\": 1, \\"userName\\": \\"test_user\\", \\"parentId\\": 0, \\"maxOutputRows\\": 200000, \\"scanSize\\": 8247470, \\"peakMemory\\": 13188295, \\"startTime\\": 1626330527632, \\"state\\": \\"FINISHED\\", \\"endTime\\": 1626330527905, \\"writeTableRows\\": 0, \\"scanRows\\": 351966 } }</DiagnosisSQLInfo>\\n <RequestId>1</RequestId>\\n <StageInfos>\\n <InputRows>123</InputRows>\\n <InputDataSize>2341</InputDataSize>\\n <OutputRows>231</OutputRows>\\n <OutputDataSize>12344</OutputDataSize>\\n <PeakMemory>3421</PeakMemory>\\n <OperatorCost>2341</OperatorCost>\\n <StageId>Stage[26]</StageId>\\n <State>RUNNING</State>\\n <Progress>0.3</Progress>\\n </StageInfos>\\n</DescribeDiagnosisSQLInfoResponse>","errorExample":""}]', + ], + 'DescribeDownloadRecords' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '221469', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '132356', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 调用[DescribeDBClusters](~~612397~~)接口可以查看集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-uf6wjk5xxxxxxxxxx', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-8vb6ha79k6e****'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'ViewName', + 'name' => 'Lang', 'in' => 'query', - 'schema' => [ - 'description' => '监控视图名称。', - 'type' => 'string', - 'required' => true, - 'example' => '自定义-全部指标-2列-联动', - ], + 'schema' => ['description' => '语言配置，取值说明：'."\n" + .'- **zh**：简体中文（默认语言）。'."\n" + .'- **en**：英文。'."\n" + .'- **ja**：日文。'."\n" + .'- **zh-tw**：繁体中文。', 'type' => 'string', 'deprecated' => true, 'required' => false, 'example' => 'zh'], ], ], 'responses' => [ @@ -17410,638 +12750,520 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'DeleteStatus' => [ - 'description' => '删除结果，取值：'."\n" - ."\n" - .'- **SUCCESS**：成功'."\n" - .'- **FAILED**：失败', - 'type' => 'boolean', - 'example' => 'SUCCESS', - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息.'."\n" - .'> 只有RAM校验失败才会返回此字段。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', + 'Records' => [ + 'description' => '详情。', + 'type' => 'array', + 'items' => [ + 'description' => '下载列表详情。', + 'type' => 'object', + 'properties' => [ + 'Status' => ['description' => '任务状态，取值为：'."\n" + .'- **running**：正在下载。'."\n" + .'- **finished**：已完成。'."\n" + .'- **failed**：下载失败。', 'type' => 'string', 'example' => 'finished'], + 'DownloadId' => ['description' => '下载任务ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '636890'], + 'ExceptionMsg' => ['description' => '下载任务失败时返回的异常信息。', 'type' => 'string', 'example' => 'The query result is empty.'], + 'Url' => ['description' => '文件下载地址。', 'type' => 'string', 'example' => 'https://perth-download-task.oss-cn-beijing.aliyuncs.com/adbmysql/query-sql-logs/amv-*********/20210805104301-20210805164302.xlsx?Expires=1943514161&OSSAccessKeyId=*********&Signature=******"'], + 'FileName' => ['description' => '下载文件名。', 'type' => 'string', 'example' => '20210806094635-20210806095135'], + ], + ], ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'D761DA51-12F8-5457-AAA9-F52B9F436D2D'], + 'AccessDeniedDetail' => ['description' => '鉴权失败信息', 'type' => 'string', 'example' => 'Authentication failed.'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'PerformanceViewNotFound', - 'errorMessage' => 'Performance view not found.', - ], + 'title' => '查看最近5次的SQL查询下载任务列表', + 'summary' => '查看目标AnalyticDB MySQL湖仓版（3.0）集群中最近5次的SQL查询下载任务列表。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2025-12-19T09:33:53.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-05-14T08:33:01.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-06-22T04:03:32.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDownloadRecords'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDownloadRecords', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"DeleteStatus\\": true,\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', - 'title' => '删除监控视图', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"Records\\": [\\n {\\n \\"Status\\": \\"finished\\",\\n \\"DownloadId\\": 636890,\\n \\"ExceptionMsg\\": \\"The query result is empty.\\",\\n \\"Url\\": \\"https://perth-download-task.oss-cn-beijing.aliyuncs.com/adbmysql/query-sql-logs/amv-*********/20210805104301-20210805164302.xlsx?Expires=1943514161&OSSAccessKeyId=*********&Signature=******\\\\\\"\\",\\n \\"FileName\\": \\"20210806094635-20210806095135\\"\\n }\\n ],\\n \\"RequestId\\": \\"D761DA51-12F8-5457-AAA9-F52B9F436D2D\\",\\n \\"AccessDeniedDetail\\": \\"Authentication failed.\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeDownloadRecordsResponse>\\n <Records>\\n <Status>finished</Status>\\n <DownloadId>636890</DownloadId>\\n <ExceptionMsg>The query result is empty.</ExceptionMsg>\\n <Url>https://perth-download-task.oss-cn-beijing.aliyuncs.com/adbmysql/query-sql-logs/amv-*********/20210805104301-20210805164302.xlsx?Expires=1943514161&OSSAccessKeyId=*********&Signature=******\\"</Url>\\n <FileName>20210806094635-20210806095135</FileName>\\n </Records>\\n <RequestId>D761DA51-12F8-5457-AAA9-F52B9F436D2D</RequestId>\\n</DescribeDownloadRecordsResponse>","errorExample":""}]', ], - 'ExistRunningSQLEngine' => [ - 'summary' => '是否有存活的SQL ENGINE。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeElasticPlanAttribute' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => true, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '150789', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', - ], + 'deprecated' => false, + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~612397~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1cit7z8j****', - ], + 'name' => 'ElasticPlanName', + 'in' => 'query', + 'schema' => ['description' => '弹性计划名称。'."\n" + .'> 调用[DescribeElasticPlans](~~601334~~)接口查看集群的弹性计划名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], ], [ - 'name' => 'ResourceGroupName', - 'in' => 'formData', - 'schema' => [ - 'description' => '资源组名称。'."\n" - .'>您可以调用[DescribeDBResourceGroup](~~459446~~)接口查看指定集群的资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'spark_test', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-wz9509beptiz****'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', + 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'FA675D68-14A4-5D9C-8820-92537D9F447E', - ], - 'Data' => [ - 'description' => '选定资源组是否存在运行中的Spark SQL Engine。'."\n" - ."\n" - .'取值：'."\n" - .'- **True**：存在。'."\n" - .'- **False**：不存在。', - 'type' => 'boolean', - 'enumValueTitles' => [ - 'True' => 'True', - 'False' => 'False', + 'ElasticPlan' => [ + 'description' => '弹性计划。', + 'type' => 'object', + 'properties' => [ + 'ElasticPlanName' => ['description' => '弹性计划名称。', 'type' => 'string', 'example' => 'test'], + 'Type' => ['description' => '弹性计划类型。', 'type' => 'string', 'example' => 'EXECUTOR'], + 'Enabled' => ['description' => '是否启用。', 'type' => 'boolean', 'example' => 'true'], + 'ResourceGroupName' => ['description' => '所属资源组名称。', 'type' => 'string', 'example' => 'test'], + 'TargetSize' => ['description' => '目标规格。', 'type' => 'string', 'example' => '32ACU'], + 'StartTime' => ['description' => '开始时间。'."\n" + ."\n" + .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'example' => '2022-01-01T12:01:00Z'], + 'EndTime' => ['description' => '结束时间。'."\n" + ."\n" + .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'example' => '2025-01-01T12:01:00Z'], + 'CronExpression' => ['description' => 'Cron表达式，表示弹性计划的变配周期和变配时间。', 'type' => 'string', 'example' => '0 20 14 * * ?'], + 'AutoScale' => ['description' => '是否启用**存储加速服务(EIU)按比例默认弹性**。'."\n" + .'取值说明：'."\n" + .'true：启用。启用后，存储资源会跟随计算资源的弹性伸缩而伸缩。'."\n" + .'false：不启用。'."\n" + .'>整个集群只支持启用一个存储加速服务(EIU)按比例默认弹性的存储弹性计划，启用了此类型的弹性计划以后，无法再启用其他的存储弹性计划。', 'type' => 'boolean', 'example' => 'false'], ], - 'example' => 'True', ], + 'RequestId' => ['description' => '请求ID。 ', 'type' => 'string', 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD'], ], ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'ACS.ElasticPlan.NotFound', 'errorMessage' => 'The elastic plan is not found.', 'description' => '弹性计划不存在'], ], ], - 'staticInfo' => [ - 'noSubstitutionReason' => '无替代API，历史原因导致该API被标记为弃用。', - 'returnType' => 'synchronous', - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'title' => '查询弹性计划详情', + 'summary' => '查询集群的弹性计划详情。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-12-12T10:09:37.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-10-23T02:55:53.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-04-13T11:20:16.000Z', 'description' => '错误码发生变更'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FA675D68-14A4-5D9C-8820-92537D9F447E\\",\\n \\"Data\\": true\\n}","type":"json"}]', - 'title' => '检测是否存在运行中的Spark SQLEngine', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', - ], - 'ExecuteSparkWarehouseBatchSQL' => [ - 'summary' => '批量执行Spark SQL。', - 'methods' => [ - 'post', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeElasticPlanAttribute'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeElasticPlanAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], - 'tags' => [], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"ElasticPlan\\": {\\n \\"ElasticPlanName\\": \\"test\\",\\n \\"Type\\": \\"EXECUTOR\\",\\n \\"Enabled\\": true,\\n \\"ResourceGroupName\\": \\"test\\",\\n \\"TargetSize\\": \\"32ACU\\",\\n \\"StartTime\\": \\"2022-01-01T12:01:00Z\\",\\n \\"EndTime\\": \\"2025-01-01T12:01:00Z\\",\\n \\"CronExpression\\": \\"0 20 14 * * ?\\",\\n \\"AutoScale\\": false\\n },\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeElasticPlanAttributeResponse>\\n <ElasticPlan>\\n <ElasticPlanName>test</ElasticPlanName>\\n <Type>EXECUTOR</Type>\\n <Enabled>true</Enabled>\\n <ResourceGroupName>test</ResourceGroupName>\\n <TargetSize>32ACU</TargetSize>\\n <StartTime>2022-01-01T12:01:00Z</StartTime>\\n <EndTime>2025-01-01T12:01:00Z</EndTime>\\n <CronExpression>0 20 14 * * ?</CronExpression>\\n <AutoScale>false</AutoScale>\\n </ElasticPlan>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</DescribeElasticPlanAttributeResponse>","errorExample":""}]', + ], + 'DescribeElasticPlanJobs' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'paid', - 'abilityTreeCode' => '235566', - 'abilityTreeNodes' => [ - 'FEATUREadsCQJTKP', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ - 'name' => 'Agency', - 'in' => 'formData', - 'schema' => [ - 'description' => '客户标记提交的客户端类型，可以是任意合法的纯英文字符串，如Aliyun Dataworks。', - 'type' => 'string', - 'required' => false, - 'example' => 'Dataworks。', - 'default' => 'POPSDK', - ], - ], - [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'name' => 'ElasticPlanName', + 'in' => 'query', + 'schema' => ['description' => '弹性计划名称。'."\n" + .'> - 不填写弹性计划名称将查询所有弹性计划。'."\n" + .'- 调用[DescribeElasticPlans](~~601334~~)接口查看集群的弹性计划名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ 'name' => 'ResourceGroupName', - 'in' => 'formData', - 'schema' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'in' => 'query', + 'schema' => ['description' => '资源组名称。'."\n" + .'> - 不填写表示查询所有资源组的弹性计划，包括Interactive资源组类型和存储加速服务（EIU）。'."\n" + .'- 调用[DescribeDBResourceGroup](~~459446~~)接口可以查看集群的资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ - 'name' => 'Query', - 'in' => 'formData', - 'schema' => [ - 'description' => '需要批量执行的SQL语句。多个SQL之间用英文分号（;）分隔。 执行引擎会按照顺序在同一个会话中依次执行这些SQL。', - 'type' => 'string', - 'required' => true, - 'example' => 'CREATE TABLE user(id INT, name STRING);'."\n" - .'INSERT INTO t VALUE(1, \'Bob\');'."\n" - .'SELECT * FROM t;', - ], + 'name' => 'Status', + 'in' => 'query', + 'schema' => ['description' => '作业状态。'."\n" + .'取值说明：'."\n" + .'- RUNNING：运行中。'."\n" + .'- SUCCESSFUL：运行成功。'."\n" + .'- FAILED：运行失败。'."\n" + .'> 不填写将查询所有状态的弹性计划。', 'type' => 'string', 'required' => false, 'example' => 'SUCCESSFUL'], ], [ - 'name' => 'Schema', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => ['description' => '开始时间。'."\n" + .'格式为yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'required' => false, 'example' => '2022-01-01T12:01:00Z'], ], [ - 'name' => 'ExecuteResultLimit', - 'in' => 'formData', - 'schema' => [ - 'description' => '抽取部分数据写入 OSS。单位为 MB，默认值为 4096。由于压缩后文件的大小难以准确估计，实际写入到OSS中的数据会小于此处的配置值。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '4096', - 'default' => '1000', - ], + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页大小。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '10'], ], [ - 'name' => 'ExecuteTimeLimitInSeconds', - 'in' => 'formData', - 'schema' => [ - 'description' => '最大允许可执行时长，单位为秒（s）。如果一组SQL在提交后长时间未能执行成功，会被标记为超时失败。默认值为360000秒即为100小时。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '3600000', - 'default' => '604800', - ], + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页数。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '1'], ], [ - 'name' => 'RuntimeConfig', - 'in' => 'formData', - 'schema' => [ - 'description' => '执行SQL时的额外运行参数，输入结构需要是一个JSON字符串。'."\n" - ."\n" - .'这里允许写入所有Apache Spark官方文档中的运行时SQL配置。'."\n" - ."\n" - .'同时此处还包含了用于当前API的控制参数，对写OSS的行为进行控制，说明如下：'."\n" - ."\n" - .'‒ `spark.adb.sqlOutputFormat`: 写入到OSS中的文件格式，默认值是`CSV`。可选值为`CSV`,`JSON`。'."\n" - ."\n" - .'‒ `spark.adb.sqlOutputPartitions`: 写入到OSS中的SQL结果的分区数，默认值为1。'."\n" - ."\n" - .'‒ `spark.adb.sqlOutputLocation`：指定写入OSS的地址，SQL执行结果的抽样会被写入到该地址。此配置为空，则不会讲SQL执行结果的抽样数据写入OSS。'."\n" - ."\n" - .'‒ `spark.adb.sqlIgnorePersistError`：是否忽略写抽样结果时发生的错误，默认值为`false`。当配置为`true`时，执行过程中SQL执行成功，但SQL结果的抽样信息写入OSS失败不会打断执行步骤。', - 'type' => 'string', - 'required' => false, - 'example' => '{'."\n" - .' "OSSURL": "oss://testBucketname/"'."\n" - .'}', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-wz9509beptiz****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'title' => 'PaginationResponse<List<DescribeElasticPlanJobsResponse>>', + 'description' => 'PaginationResponse<List<DescribeElasticPlanJobsResponse>>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'CBE843D8-964D-5EA3-9D31-822125611B6E', - ], - 'Data' => [ - 'description' => '返回数据体。', - 'example' => 'true', - '$ref' => '#/components/schemas/SparkBatchSQL', + 'TotalCount' => ['description' => '总作业数。', 'type' => 'integer', 'format' => 'int32', 'example' => '15'], + 'PageNumber' => ['description' => '页数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '每页大小。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'Jobs' => [ + 'description' => '作业列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ElasticPlanName' => ['description' => '弹性计划名称。', 'type' => 'string', 'example' => 'test'], + 'Status' => ['description' => '作业状态。'."\n" + .'取值说明：'."\n" + .'- RUNNING：运行中。'."\n" + .'- SUCCESSFUL：运行成功。'."\n" + .'- FAILED：运行失败。', 'type' => 'string', 'example' => 'SUCCESSFUL'], + 'Type' => ['description' => '弹性计划作业类型。'."\n" + .'取值说明：'."\n" + .'- EXECUTORE：Interactive资源组类型，即计算资源类型。'."\n" + .'- WORKER：存储加速服务（EIU）。', 'type' => 'string', 'example' => 'EXECUTOR'], + 'ResourceGroupName' => ['description' => '资源组名称。', 'type' => 'string', 'example' => 'test'], + 'StartTime' => ['description' => '作业开始时间。'."\n" + .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'example' => '2022-01-01T11:01:00Z'], + 'EndTime' => ['description' => '作业结束时间。'."\n" + ."\n" + .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'example' => '2022-01-01T12:01:00Z'], + 'TargetSize' => ['description' => '目标规格。', 'type' => 'string', 'example' => '32ACU'], + 'TotalAcu' => ['description' => '总资源。'."\n" + .'> - Type取值为EXECUTOR时，本参数表示所属资源组的总计算资源。'."\n" + .'> - Type取值为WORKER时，本参数表示整个集群的总存储资源。', 'type' => 'string', 'example' => '32ACU'], + 'ReserveAcu' => ['description' => '预留资源。'."\n" + .'> - Type取值为EXECUTOR时，本参数表示当前资源组的预留资源。'."\n" + .'> - Type取值为WORKER时，本参数表示当前集群的总预留存储资源。', 'type' => 'string', 'example' => '16ACU'], + 'ElasticAcu' => ['description' => '弹性资源。'."\n" + .'> - Type取值为EXECUTOR时，本参数表示当前资源组的弹性资源。'."\n" + .'> - Type取值为WORKER时，本参数表示当前集群的总存储弹性资源。', 'type' => 'string', 'example' => '16ACU'], + 'InstanceSize' => ['description' => '实例数量。'."\n" + .'> - Type取值为EXECUTOR时，本参数表示当前计算节点数量。'."\n" + .'> - Type取值为WORKER时，本参数表示当前集群的存储副本集数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + ], + 'description' => '', + ], ], + 'RequestId' => ['description' => '请求ID。 ', 'type' => 'string', 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD'], ], ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - ], 404 => [ - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '查询弹性计划作业列表', + 'summary' => '查询集群的弹性计划作业。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-12-12T10:09:37.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-04-13T11:20:16.000Z', 'description' => '错误码发生变更'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"CBE843D8-964D-5EA3-9D31-822125611B6E\\",\\n \\"Data\\": {\\n \\"QueryId\\": \\"amv-202401-xx\\",\\n \\"QueryState\\": \\"RUNNING\\",\\n \\"QuerySubmissionTime\\": 1723521767000,\\n \\"QueryStartTime\\": 1723521767000,\\n \\"QueryEndTime\\": 1723521767000,\\n \\"Schema\\": \\"default\\",\\n \\"Uid\\": 12222222,\\n \\"DBClusterId\\": \\"amv-xxx\\",\\n \\"ResourceGroupName\\": \\"spark_rg\\",\\n \\"Query\\": \\"query\\",\\n \\"Statements\\": [\\n {\\n \\"ResultUri\\": \\"oss://yourbucket/result.json\\",\\n \\"EndTime\\": 1723521767000,\\n \\"AppId\\": \\"s20240122jsdx****\\",\\n \\"StatementId\\": \\"amv-20240711-stmt\\",\\n \\"State\\": \\"RUNNING\\",\\n \\"StartTime\\": 1723521767000,\\n \\"Error\\": \\"table is not found\\",\\n \\"Code\\": \\"SELECT 100\\",\\n \\"Result\\": \\"JSON格式执行结果集\\"\\n }\\n ],\\n \\"ErrMessage\\": \\"schema is not found\\"\\n }\\n}","type":"json"}]', - 'title' => '批量执行Spark SQL', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', - ], - 'CancelSparkWarehouseBatchSQL' => [ - 'summary' => '取消Spark SQL执行。', - 'methods' => [ - 'post', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeElasticPlanJobs'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeElasticPlanJobs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 15,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"Jobs\\": [\\n {\\n \\"ElasticPlanName\\": \\"test\\",\\n \\"Status\\": \\"SUCCESSFUL\\",\\n \\"Type\\": \\"EXECUTOR\\",\\n \\"ResourceGroupName\\": \\"test\\",\\n \\"StartTime\\": \\"2022-01-01T11:01:00Z\\",\\n \\"EndTime\\": \\"2022-01-01T12:01:00Z\\",\\n \\"TargetSize\\": \\"32ACU\\",\\n \\"TotalAcu\\": \\"32ACU\\",\\n \\"ReserveAcu\\": \\"16ACU\\",\\n \\"ElasticAcu\\": \\"16ACU\\",\\n \\"InstanceSize\\": 1\\n }\\n ],\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeElasticPlanJobsResponse>\\n <TotalCount>15</TotalCount>\\n <PageNumber>1</PageNumber>\\n <PageSize>10</PageSize>\\n <Jobs>\\n <ElasticPlanName>test</ElasticPlanName>\\n <Status>SUCCESSFUL</Status>\\n <Type>EXECUTOR</Type>\\n <ResourceGroupName>test</ResourceGroupName>\\n <StartTime>2022-01-01T11:01:00Z</StartTime>\\n <EndTime>2022-01-01T12:01:00Z</EndTime>\\n <TargetSize>32ACU</TargetSize>\\n <TotalAcu>32ACU</TotalAcu>\\n <ReserveAcu>16ACU</ReserveAcu>\\n <ElasticAcu>16ACU</ElasticAcu>\\n <InstanceSize>1</InstanceSize>\\n </Jobs>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</DescribeElasticPlanJobsResponse>","errorExample":""}]', + ], + 'DescribeElasticPlanSpecifications' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '235570', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ - 'name' => 'QueryId', - 'in' => 'formData', - 'schema' => [ - 'description' => 'Spark SQL的执行ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'sq202501011001s****', - ], + 'name' => 'Type', + 'in' => 'query', + 'schema' => ['description' => '弹性计划类型。 取值说明：'."\n" + ."\n" + .'- EXECUTOR：Interactive资源组，即计算资源类型。'."\n" + .'- WORKER：存储加速服务（EIU）。', 'type' => 'string', 'required' => true, 'example' => 'EXECUTOR'], ], [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-uf6485635f***', - ], + 'name' => 'ResourceGroupName', + 'in' => 'query', + 'schema' => ['description' => '资源组名称。'."\n" + ."\n" + .'>- 查询Interactive资源组的弹性计划（即计算资源类型的弹性计划）支持的规格时，必须指定资源组名称。查询存储加速服务（EIU）的弹性计划支持的规格时，无需指定资源组名称。'."\n" + .'- 调用[DescribeDBResourceGroup](~~459446~~)接口可以查看指定集群的资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ - 'name' => 'Agency', - 'in' => 'formData', - 'schema' => [ - 'description' => '协助记录客户端名称，最长16个字符的意义字符串。', - 'type' => 'string', - 'required' => false, - 'example' => 'DMS', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-wz9509beptiz****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结构。', + 'title' => 'PaginationResponse<List<String>>', + 'description' => 'PaginationResponse<List<String>>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '771C5FAA-530F-52F7-B84D-EBAD45***', - ], - 'Data' => [ - 'description' => '返回结果。', - 'example' => '123', - '$ref' => '#/components/schemas/SparkBatchSQL', + 'TotalCount' => ['description' => '总规格数。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'PageNumber' => ['description' => '当前页数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '每页大小。', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'Specifications' => [ + 'description' => '支持的规格列表。', + 'type' => 'array', + 'items' => ['description' => '支持的规格。', 'type' => 'string', 'example' => '16ACU'], ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD'], ], ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.BlankError', - 'errorMessage' => 'Input sql can not be blank string.', - ], - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - ], 404 => [ - [ - 'errorCode' => 'Spark.App.NotFound', - 'errorMessage' => 'The Spark application %s is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '查询弹性计划支持的规格列表', + 'summary' => '查询集群的不同类型弹性计划支持的规格列表。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-12-12T10:09:37.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-04-13T11:20:15.000Z', 'description' => '错误码发生变更'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"771C5FAA-530F-52F7-B84D-EBAD45***\\",\\n \\"Data\\": {\\n \\"QueryId\\": \\"amv-202401-xx\\",\\n \\"QueryState\\": \\"RUNNING\\",\\n \\"QuerySubmissionTime\\": 1723521767000,\\n \\"QueryStartTime\\": 1723521767000,\\n \\"QueryEndTime\\": 1723521767000,\\n \\"Schema\\": \\"default\\",\\n \\"Uid\\": 12222222,\\n \\"DBClusterId\\": \\"amv-xxx\\",\\n \\"ResourceGroupName\\": \\"spark_rg\\",\\n \\"Query\\": \\"query\\",\\n \\"Statements\\": [\\n {\\n \\"ResultUri\\": \\"oss://yourbucket/result.json\\",\\n \\"EndTime\\": 1723521767000,\\n \\"AppId\\": \\"s20240122jsdx****\\",\\n \\"StatementId\\": \\"amv-20240711-stmt\\",\\n \\"State\\": \\"RUNNING\\",\\n \\"StartTime\\": 1723521767000,\\n \\"Error\\": \\"table is not found\\",\\n \\"Code\\": \\"SELECT 100\\",\\n \\"Result\\": \\"JSON格式执行结果集\\"\\n }\\n ],\\n \\"ErrMessage\\": \\"schema is not found\\"\\n }\\n}","type":"json"}]', - 'title' => '取消Spark SQL执行', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', - ], - 'ListSparkWarehouseBatchSQL' => [ - 'summary' => '分页查询所有执行的Spark SQL。', - 'methods' => [ - 'post', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeElasticPlanSpecifications'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeElasticPlanSpecifications', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 10,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 5,\\n \\"Specifications\\": [\\n \\"16ACU\\"\\n ],\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeElasticPlanSpecificationsResponse>\\n <TotalCount>10</TotalCount>\\n <PageNumber>1</PageNumber>\\n <PageSize>5</PageSize>\\n <Specifications>16ACU</Specifications>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</DescribeElasticPlanSpecificationsResponse>","errorExample":""}]', + ], + 'DescribeElasticPlans' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '236211', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'am-bp1ub9grke1****', - ], + 'name' => 'ElasticPlanName', + 'in' => 'query', + 'schema' => ['description' => '弹性计划名称。'."\n" + .'> 不填写弹性计划名称将查询所有弹性计划。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ 'name' => 'ResourceGroupName', - 'in' => 'formData', - 'schema' => [ - 'description' => '开启了Spark引擎的Interactive型资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'in' => 'query', + 'schema' => ['description' => '资源组名称。'."\n" + .'> - 不填写表示查询所有资源组的弹性计划，包括Interactive资源组类型和存储加速服务（EIU）。'."\n" + .'>- 调用[DescribeDBResourceGroup](~~459446~~)接口可以查看集群的资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ - 'name' => 'PageNumber', - 'in' => 'formData', - 'schema' => [ - 'description' => '当前页数。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'name' => 'Enabled', + 'in' => 'query', + 'schema' => ['description' => '创建后是否启用弹性计划。'."\n" + .'取值说明：'."\n" + .'- **true**：启用。'."\n" + .'- **false**：不启用。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], ], [ 'name' => 'PageSize', - 'in' => 'formData', - 'schema' => [ - 'description' => '每页记录数。', - 'type' => 'string', - 'required' => false, - 'example' => '30', - 'default' => '10', - ], + 'in' => 'query', + 'allowEmptyValue' => false, + 'schema' => ['description' => '每页大小。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'minimum' => '1', 'example' => '10'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页数。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'minimum' => '1', 'example' => '1'], + ], + [ + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~612397~~)接口可以查看集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-wz9509beptiz****'], + ], + [ + 'name' => 'Type', + 'in' => 'query', + 'schema' => ['description' => '弹性计划类型。 取值说明：'."\n" + ."\n" + .'- **EXECUTOR**：Interactive资源组，即计算资源类型。'."\n" + .'- **WORKER**：存储加速服务（EIU）。', 'type' => 'string', 'required' => false, 'example' => 'EXECUTOR'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'title' => 'PaginationResponse<List<DescribeElasticPlansResponse>>', + 'description' => 'PaginationResponse<List<DescribeElasticPlansResponse>>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Data' => [ - 'description' => '返回结果数据。', - 'type' => 'object', - 'properties' => [ - 'Total' => [ - 'description' => '总条数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', - ], - 'Queries' => [ - 'description' => 'Spark SQL执行列表。', - 'type' => 'array', - 'items' => [ - 'description' => 'Spark SQL结果的结构体。', - 'example' => '[{\\"doc_id\\":[\\"1293619227704606720\\"]}]', - '$ref' => '#/components/schemas/SparkBatchSQL', - ], + 'TotalCount' => ['description' => '总计划数。', 'type' => 'integer', 'format' => 'int32', 'example' => '15'], + 'PageNumber' => ['description' => '页数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '每页大小。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'ElasticPlans' => [ + 'description' => '弹性计划列表。', + 'type' => 'array', + 'items' => [ + 'description' => '弹性计划。', + 'type' => 'object', + 'properties' => [ + 'ElasticPlanName' => ['description' => '弹性计划名称。', 'type' => 'string', 'example' => 'test'], + 'Type' => ['description' => '弹性计划类型。'."\n" + .'取值说明：'."\n" + .'- **EXECUTORE**：Interactive资源组类型，即计算资源类型。'."\n" + .'- **WORKER**：存储加速服务（EIU）。', 'type' => 'string', 'example' => 'EXECUTOR'], + 'Enabled' => ['description' => '创建后是否立即启用弹性计划。'."\n" + .'取值说明：'."\n" + .'- **true**：立即启用。'."\n" + .'- **false**：不启用。', 'type' => 'boolean', 'example' => 'true'], + 'ResourceGroupName' => ['description' => '资源组名称。'."\n" + .'> 调用[DescribeDBResourceGroup](~~459446~~)接口可以查看集群的资源组名称。', 'type' => 'string', 'example' => 'test'], + 'TargetSize' => ['description' => '目标规格。', 'type' => 'string', 'example' => '32ACU'], + 'NextScheduleTime' => ['description' => '下次调度时间。'."\n" + ."\n" + .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'example' => '2022-01-01T12:01:00Z'], + 'AutoScale' => ['description' => '是否**开启存储加速服务(EIU)按比例默认弹性**。'."\n" + .'取值说明：'."\n" + .'- **true**：开启。'."\n" + .'- **false**：不开启。', 'type' => 'boolean', 'example' => 'false'], ], ], ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD'], ], ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + ], + 'title' => '查询弹性计划列表', + 'summary' => '根据查询条件查询集群的弹性计划。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-06-02T01:37:58.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-04-13T11:20:16.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeElasticPlans'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeElasticPlans', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"Total\\": 0,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 20,\\n \\"Queries\\": [\\n {\\n \\"QueryId\\": \\"amv-202401-xx\\",\\n \\"QueryState\\": \\"RUNNING\\",\\n \\"QuerySubmissionTime\\": 1723521767000,\\n \\"QueryStartTime\\": 1723521767000,\\n \\"QueryEndTime\\": 1723521767000,\\n \\"Schema\\": \\"default\\",\\n \\"Uid\\": 12222222,\\n \\"DBClusterId\\": \\"amv-xxx\\",\\n \\"ResourceGroupName\\": \\"spark_rg\\",\\n \\"Query\\": \\"query\\",\\n \\"Statements\\": [\\n {\\n \\"ResultUri\\": \\"oss://yourbucket/result.json\\",\\n \\"EndTime\\": 1723521767000,\\n \\"AppId\\": \\"s20240122jsdx****\\",\\n \\"StatementId\\": \\"amv-20240711-stmt\\",\\n \\"State\\": \\"RUNNING\\",\\n \\"StartTime\\": 1723521767000,\\n \\"Error\\": \\"table is not found\\",\\n \\"Code\\": \\"SELECT 100\\",\\n \\"Result\\": \\"JSON格式执行结果集\\"\\n }\\n ],\\n \\"ErrMessage\\": \\"schema is not found\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '分页查询所有执行的Spark SQL', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 15,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"ElasticPlans\\": [\\n {\\n \\"ElasticPlanName\\": \\"test\\",\\n \\"Type\\": \\"EXECUTOR\\",\\n \\"Enabled\\": true,\\n \\"ResourceGroupName\\": \\"test\\",\\n \\"TargetSize\\": \\"32ACU\\",\\n \\"NextScheduleTime\\": \\"2022-01-01T12:01:00Z\\",\\n \\"AutoScale\\": false\\n }\\n ],\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeElasticPlansResponse>\\n <TotalCount>15</TotalCount>\\n <PageNumber>1</PageNumber>\\n <PageSize>10</PageSize>\\n <ElasticPlans>\\n <ElasticPlanName>test</ElasticPlanName>\\n <Type>EXECUTOR</Type>\\n <Enabled>true</Enabled>\\n <ResourceGroupName>test</ResourceGroupName>\\n <TargetSize>32ACU</TargetSize>\\n <NextScheduleTime>2022-01-01T12:01:00Z</NextScheduleTime>\\n <AutoScale>false</AutoScale>\\n </ElasticPlans>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</DescribeElasticPlansResponse>","errorExample":""}]', ], - 'GetSparkWarehouseBatchSQL' => [ - 'summary' => '获取Spark SQL执行结果。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], + 'DescribeEnabledPrivileges' => [ + 'summary' => '获取支持的权限级别和权限列表。', + 'methods' => ['get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -18050,155 +13272,121 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '235568', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '159129', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], ], 'parameters' => [ [ - 'name' => 'QueryId', - 'in' => 'formData', - 'schema' => [ - 'description' => 'Spark SQ的L执行ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'sq2024123*****', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-uf6485635f***', - ], + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp14t95lun0w****'], ], [ - 'name' => 'Agency', - 'in' => 'formData', - 'schema' => [ - 'description' => '协助记录客户端名称，最长16个字符的意义字符串。', - 'type' => 'string', - 'required' => false, - 'example' => 'DMS', - 'default' => 'POPSDK', - ], + 'name' => 'AccountName', + 'in' => 'query', + 'schema' => ['description' => '数据库账号名称。'."\n" + .'> 您可以调用[DescribeAccounts](~~612430~~)接口查看指定集群的数据库账号信息，包括账号名称。', 'type' => 'string', 'required' => false, 'example' => 'test_accout'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结构体。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '3D44EDA0-A9DC-580D-9B5A-019370C075F4', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '246F42E0-A475-15FF-96D2-8DC47FC2F289'], 'Data' => [ - 'description' => '返回数据。', - 'example' => '{\'DBClusterId\': \'amv-uf6485635fz852mn\', \'Statements\': [{\'Code\': \'show databases\', \'State\': \'FINISHED\', \'StatementId\': \'sq202501141001sh8e12e080006846-0000\', \'Result\': \'+--------------------+n', - '$ref' => '#/components/schemas/SparkBatchSQL', + 'description' => '支持的权限级别和权限列表。', + 'type' => 'array', + 'items' => [ + 'description' => '权限级别以及在该级别支持的权限。', + 'type' => 'object', + 'properties' => [ + 'Scope' => ['description' => '权限级别。', 'type' => 'string', 'required' => true, 'example' => 'Global'], + 'Description' => ['description' => '对权限级别的描述。', 'type' => 'string', 'required' => true, 'example' => '全局权限'], + 'Privileges' => [ + 'description' => '支持的权限列表。', + 'type' => 'array', + 'items' => [ + 'description' => '权限详情，包含权限名和描述。', + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => '权限名。', 'type' => 'string', 'example' => 'select'], + 'Description' => ['description' => '权限描述。', 'type' => 'string', 'example' => '查询数据'], + ], + ], + 'required' => true, + ], + ], + 'required' => true, + ], + 'required' => false, ], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + ], + 'title' => '查询支持的权限级别和权限列表', + 'description' => '- 中心的公网接入地址：`adb.aliyuncs.com`。'."\n" + .'- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2023-12-18T14:04:04.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-12-06T02:33:10.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-04-20T14:39:16.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-03-24T06:25:39.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeEnabledPrivileges'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeEnabledPrivileges', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"3D44EDA0-A9DC-580D-9B5A-019370C075F4\\",\\n \\"Data\\": {\\n \\"QueryId\\": \\"amv-202401-xx\\",\\n \\"QueryState\\": \\"RUNNING\\",\\n \\"QuerySubmissionTime\\": 1723521767000,\\n \\"QueryStartTime\\": 1723521767000,\\n \\"QueryEndTime\\": 1723521767000,\\n \\"Schema\\": \\"default\\",\\n \\"Uid\\": 12222222,\\n \\"DBClusterId\\": \\"amv-xxx\\",\\n \\"ResourceGroupName\\": \\"spark_rg\\",\\n \\"Query\\": \\"query\\",\\n \\"Statements\\": [\\n {\\n \\"ResultUri\\": \\"oss://yourbucket/result.json\\",\\n \\"EndTime\\": 1723521767000,\\n \\"AppId\\": \\"s20240122jsdx****\\",\\n \\"StatementId\\": \\"amv-20240711-stmt\\",\\n \\"State\\": \\"RUNNING\\",\\n \\"StartTime\\": 1723521767000,\\n \\"Error\\": \\"table is not found\\",\\n \\"Code\\": \\"SELECT 100\\",\\n \\"Result\\": \\"JSON格式执行结果集\\"\\n }\\n ],\\n \\"ErrMessage\\": \\"schema is not found\\"\\n }\\n}","type":"json"}]', - 'title' => '获取Spark SQL执行结果', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"246F42E0-A475-15FF-96D2-8DC47FC2F289\\",\\n \\"Data\\": [\\n {\\n \\"Scope\\": \\"Global\\",\\n \\"Description\\": \\"全局权限\\",\\n \\"Privileges\\": [\\n {\\n \\"Key\\": \\"select\\",\\n \\"Description\\": \\"查询数据\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeEnabledPrivilegesResponse>\\n <RequestId>246F42E0-A475-15FF-96D2-8DC47FC2F289</RequestId>\\n <Data>\\n <Scope>Global</Scope>\\n <Description>全局</Description>\\n <Privileges>\\n <Key>select</Key>\\n <Description>查询</Description>\\n </Privileges>\\n </Data>\\n</DescribeEnabledPrivilegesResponse>","errorExample":""}]', ], - 'StartSparkReplSession' => [ - 'summary' => '启动一个Spark会话。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeEssdCacheConfig' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'paid'], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1mfe9qm****', - ], - ], - [ - 'name' => 'ResourceGroupName', - 'in' => 'formData', - 'schema' => [ - 'description' => 'Job型资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], - ], - [ - 'name' => 'Config', - 'in' => 'formData', - 'schema' => [ - 'description' => '启动Spark的具体配置，格式为JSON。详情请参见[Spark Conf配置](~~471203~~)。', - 'type' => 'string', - 'required' => true, - 'example' => '{ "spark.shuffle.timeout": ":0s" }', - ], + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-uf685u1o987hj6rn'], ], ], 'responses' => [ @@ -18206,202 +13394,58 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'C1797FEA-B7D6-5ED6-A24B-2C8C5F4D7361', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'C7EDB8E4-9769-4233-88C7-DCA4C9******'], 'Data' => [ - 'description' => '返回数据。', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'SessionId' => [ - 'description' => '执行代码的会话ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'AttemptId' => [ - 'description' => 'Spark应用的重试ID。', - 'type' => 'string', - 'example' => 's202301061000h****', - ], - 'Error' => [ - 'description' => '错误消息。', - 'type' => 'string', - 'example' => 'session time out', - ], - 'WebUiAddress' => [ - 'description' => 'Spark应用的Web UI地址。', - 'type' => 'string', - 'example' => 'https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****', - ], - 'State' => [ - 'description' => '会话状态，取值如下：'."\n" - .'- IDLE: 会话空闲'."\n" - .'- BUSY: 会话繁忙，有任务在执行'."\n" - .'- DEAD: 会话关闭', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => 'IDLE', - ], - 'AliyunUid' => [ - 'description' => '集群所属的阿里云主账号。', - 'type' => 'string', - 'example' => '178157466******', + 'EnableEssdCache' => [ + 'description' => '是否开区云盘缓存。', + 'type' => 'boolean', + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], + 'example' => 'true', ], + 'EssdCacheSize' => ['description' => '云盘缓存空间大小，单位为GB。', 'type' => 'integer', 'format' => 'int32', 'example' => '500'], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'Spark.App.ExceedQuotaLimitation', - 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', - ], - [ - 'errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', - 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ResourceNegativeError', - 'errorMessage' => 'The requested resource MUST be positive: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidAppFilePath', - 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidDiskConfig', - 'errorMessage' => 'The requested disk mount parameter is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidHostAliasConfig', - 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', - ], - [ - 'errorCode' => 'Spark.Config.InvalidLogOssPath', - 'errorMessage' => 'The OSS address for log storage is illegal: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidRoleArnFormat', - 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', - ], - [ - 'errorCode' => 'Spark.Config.InvalidTimeZone', - 'errorMessage' => 'Unable to parse time zone configuration %s : %s', - ], - [ - 'errorCode' => 'Spark.Config.MainAppFileNotExists', - 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathAccessError', - 'errorMessage' => 'The configured OSS address %s cannot be accessed.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathNotExists', - 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Config.SecurityGroupNotFound', - 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.Config.VswitchNotFound', - 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.RoleArn.Invalid', - 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', - ], - [ - 'errorCode' => 'Spark.SQL.BlankError', - 'errorMessage' => 'Input sql can not be blank string.', - ], - [ - 'errorCode' => 'Spark.SQL.MultipleSQLError', - 'errorMessage' => 'Element in field [sqls] can not contain more than one sql statement: %s.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Submit spark app failed when parser SQL %s. Error message: %s.', - ], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidMaintainTime.Malformed', 'errorMessage' => 'The specified parameter MaintainTime is not valid.', 'description' => 'MaintainTime参数不正确，请确认参数是否符合规范。'."\n"], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + ], + 'title' => '查询集群云盘缓存空间', + 'summary' => '查询集群加速配置，云盘缓存空间大小，单位为GB。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeEssdCacheConfig'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.App.NotFound', - 'errorMessage' => 'The Spark application %s is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:DescribeEssdCacheConfig', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C1797FEA-B7D6-5ED6-A24B-2C8C5F4D7361\\",\\n \\"Data\\": {\\n \\"SessionId\\": 1,\\n \\"AttemptId\\": \\"s202301061000h****\\",\\n \\"Error\\": \\"session time out\\",\\n \\"WebUiAddress\\": \\"https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****\\",\\n \\"State\\": \\"IDLE\\",\\n \\"AliyunUid\\": \\"178157466******\\"\\n }\\n}","type":"json"}]', - 'title' => '启动一个Spark会话', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C7EDB8E4-9769-4233-88C7-DCA4C9******\\",\\n \\"Data\\": {\\n \\"EnableEssdCache\\": true,\\n \\"EssdCacheSize\\": 500\\n }\\n}","type":"json"}]', ], - 'GetSparkReplStatement' => [ - 'summary' => '获取一段代码的执行结果。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeExcessivePrimaryKeys' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -18410,45 +13454,86 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '217360', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'AppId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'Spark App的名称', - 'description' => '应用ID。'."\n" - .'> 可调用[ListSparkApps](~~455888~~)接口查询Spark应用ID。', - 'type' => 'string', - 'required' => false, - 'example' => 's202411071444hzdvk486d9d200****', - 'default' => 'ADB-Spark-Application', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查询目标地域中所有集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-bp1xxxxxxxx47'], ], [ - 'name' => 'StatementId', - 'in' => 'formData', - 'schema' => [ - 'description' => 'Spark作业中代码块的唯一ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '123', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可通过接口[DescribeRegions](~~143074~~)查看可用的地域ID。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'SessionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '执行代码的会话ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - ], + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => ['description' => '查询开始时间。格式为<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2019-06-01T16:00:00Z'], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => '查询结束时间。格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2019-06-01T16:00:00Z'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数，取值范围如下：'."\n" + .'* **30**（默认值）。'."\n" + .'* **50**。'."\n" + .'* **100**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '10', 'example' => '30', 'default' => '10'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1'], + ], + [ + 'name' => 'Lang', + 'in' => 'query', + 'schema' => ['description' => '设置下载文件的文件标题以及部分错误信息的语言，支持如下语言：'."\n" + .'- **zh（默认值）**：简体中文。'."\n" + .'- **en**：英文。'."\n" + .'- **ja**：日文。'."\n" + .'- **zh-tw**：繁体中文。', 'type' => 'string', 'required' => false, 'example' => 'zh'], + ], + [ + 'name' => 'Order', + 'in' => 'query', + 'schema' => ['description' => '按指定字段排序，json格式：JSON数组，有序，按顺序输入排列字段和升降序类型：'."\n" + ."\n" + .'如：'."\n" + ."\n" + .'```'."\n" + .'['."\n" + ."\n" + .' {'."\n" + ."\n" + .' "Field":"Name",'."\n" + ."\n" + .' "Type":"Asc"'."\n" + ."\n" + .' }'."\n" + ."\n" + .']'."\n" + .'```'."\n" + ."\n" + .'其中Field表示需要排序的字段名，目前仅支持对"Name" 字段排序。'."\n" + .'Type表示排序类型 Desc为降序，Asc为升序'."\n" + ."\n" + .'均不区分大小写。', 'type' => 'string', 'required' => false, 'example' => '[{"Field":"TableName", "Type": "Desc" }]'], ], ], 'responses' => [ @@ -18456,241 +13541,97 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'StatementId' => [ - 'description' => '此Spark作业中代码块的唯一ID', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'Code' => [ - 'description' => '执行的代码。', - 'type' => 'string', - 'example' => 'print(1+1)', - ], - 'CodeType' => [ - 'description' => '代码的类型，取值如下：'."\n" - .'- PYTHON'."\n" - .'- SCALA', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => 'PYTHON', - ], - 'CodeState' => [ - 'description' => '代码执行状态，取值如下：'."\n" - .'- CANCELLED: 取消执行'."\n" - .'- RUNNING: 执行中'."\n" - .'- SUCCEEDED: 执行完成'."\n" - .'- ERROR: 执行失败', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => 'RUNNING', - ], - 'AliyunUid' => [ - 'description' => '实例所属的阿里云账户ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '144740799645****', - ], - 'OutputType' => [ - 'description' => '输出结果的类型。', - 'type' => 'string', - 'enumValueTitles' => [ - 'TABLE' => '表。', - 'TEXT' => '文本。', - ], - 'example' => 'TEXT', - ], - 'Output' => [ - 'description' => '输出结果，一个JSON格式的STRING。', - 'type' => 'string', - 'example' => '{"text/plain": 2}', - ], - 'Columns' => [ - 'description' => '列名数组。', - 'type' => 'array', - 'items' => [ - 'description' => '列名。', - 'type' => 'string', - 'example' => 'col1', - ], - ], - 'Error' => [ - 'description' => '错误消息。', - 'type' => 'string', - 'example' => 'stackoverflow error', - ], - 'StartTime' => [ - 'description' => '任务开始时间，Unix时间戳，单位毫秒。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1730968194000', + 'TotalCount' => ['description' => '总数。', 'type' => 'string', 'example' => '300'], + 'PageNumber' => ['description' => '页号，和传入的值一致。', 'type' => 'integer', 'format' => 'int32', 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1', 'default' => '1'], + 'PageSize' => ['description' => '每页记录数，取值范围如下：'."\n" + .'* **30**（默认值）。'."\n" + .'* **50**。'."\n" + .'* **100**。', 'type' => 'integer', 'format' => 'int32', 'maximum' => '100', 'minimum' => '10', 'example' => '30', 'default' => '10'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '863D51B7-5321-41D8-A0B6-A088B0******'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'am-bp1ub9grke1****'], + 'Tables' => [ + 'description' => '主键过多表列表', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'test'], + 'SchemaName' => ['description' => '数据库名。', 'type' => 'string', 'example' => 'adb_demo'], + 'ColumnCount' => ['description' => '总列数。', 'type' => 'integer', 'format' => 'int32', 'example' => '21'], + 'PrimaryKeyCount' => ['description' => '主键字段个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'PrimaryKeyColumns' => ['description' => '主键字段列表。', 'type' => 'string', 'example' => 'id,date'."\n"], + 'SpaceRatio' => ['description' => '表空间占比，单位：%。'."\n" + ."\n" + .'> 计算公式为：表空间占比 = (表总数据量 / 实例总数据量) * 100。', 'type' => 'number', 'format' => 'double', 'example' => '23'], + 'TotalSize' => ['description' => '冷数据总量，单位：Byte。'."\n" + ."\n" + .'> 计算公式为：冷数据总量 = 表记录数据量 + 普通索引数据量 + 主键索引数据量 + 其他。', 'type' => 'integer', 'format' => 'int64', 'example' => '4'], + 'PrimaryKeyIndexSize' => ['description' => '主键索引数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '222'], ], - 'EndTime' => [ - 'description' => '任务结束时间，Unix时间戳，单位毫秒。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1730968194000', + 'description' => '', + ], + ], + 'DetectionItems' => [ + 'description' => '检测项及检测结果列表。', + 'type' => 'array', + 'items' => [ + 'description' => '检测项及检测结果列表。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '检测项名字。', 'type' => 'string', 'example' => 'Excessive primary keys detection'], + 'Message' => ['description' => '检测结果信息。', 'type' => 'string', 'example' => 'Multiple tables are detected with excessive primary keys.'], + 'Status' => ['description' => '检测结果状态。', 'type' => 'string', 'example' => 'NORMAL'."\n" + .'WARNNING'."\n" + .'CRITICAL'], ], ], ], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1906102576997697",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcNqPqHV6lwR4INiAGjIvK1ngXxN1O+6ORRB6A8YvztEOGywOk81ZmuNk0YrNy+qk7+UVDTHeXKsy8h9e/ePY/LMidj0RCmDpo/YpCumd0UGe0qEPe2U+UJAm/+UHlnEFLVg6BP3yIB5D++MCy7mgWm8Kwyhk62IeYly4hQ+5IpXjkh1GQXuDgLVVPVpxEek9n30vnCUL4KsaMgfa7dgojb+3TM8xGsD2zVK5STJNrsXclscIJEqyNXd7CBYiRJVZi1HPO6drN9WW0chLpCSTgjO8n0bNanZaxXKumW9PSwV58UoSFASeMWfZK3TLngX+oq8nGmnTwcJosVjfF4RGzAnS1IXt0Q9N2WHDnpwyLBU/nOz7Hsy8IZ+h+OVjsBTXSM9688/vOF707a5mNzpETvQeGRcua3A5livcKAM2cML0yeUs/Zyj/+BGqtVa+wektspDHC/CECh6R5lxQjRmUdPawY8VDs2onmdLuEH8DdmYt+Yv/jBFBUMWOyAluzkPYcX5nuQKouCIUJUFTSbsJsuH5CTIh7Ls5rbmkj+T1qTVz8gnDR8LxwaqoMSna+elXgVyOOxXtMkenVntsmoC3p/4G7yTPL1hu8JyWGIIvZHZGGLXGEH7FeSuMV8buKxPGFWG3arG8e9LGvDdz5dgTien4y6G5AQ0o1iQdXDos5VWdH3u7k5PrsvdEOpvMi6uSd8a42na80FsYlgGlwM5upydcWUC5Un2HCkJpT1xgk2L6shdVTrK6bidRrqE784FhW9bBQePzGaxSupPENZya0VUctRt+7uq3QwIn4y5jzjgX0E0jgmqPrgiVDjBesMQZYfGPCGysWYWYzfoh+G6V7N2VVGtNnGUwNWzM0WJBPONAgxPv+AmixFRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "202515810214480629",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .' }'], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.App.ExceedQuotaLimitation', - 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', - ], - [ - 'errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', - 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ResourceNegativeError', - 'errorMessage' => 'The requested resource MUST be positive: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidAppFilePath', - 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidDiskConfig', - 'errorMessage' => 'The requested disk mount parameter is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidHostAliasConfig', - 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', - ], - [ - 'errorCode' => 'Spark.Config.InvalidLogOssPath', - 'errorMessage' => 'The OSS address for log storage is illegal: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidRoleArnFormat', - 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', - ], - [ - 'errorCode' => 'Spark.Config.InvalidTimeZone', - 'errorMessage' => 'Unable to parse time zone configuration %s : %s', - ], - [ - 'errorCode' => 'Spark.Config.MainAppFileNotExists', - 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathAccessError', - 'errorMessage' => 'The configured OSS address %s cannot be accessed.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathNotExists', - 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Config.SecurityGroupNotFound', - 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.Config.VswitchNotFound', - 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.RoleArn.Invalid', - 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', - ], - [ - 'errorCode' => 'Spark.SQL.BlankError', - 'errorMessage' => 'Input sql can not be blank string.', - ], - [ - 'errorCode' => 'Spark.SQL.MultipleSQLError', - 'errorMessage' => 'Element in field [sqls] can not contain more than one sql statement: %s.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Submit spark app failed when parser SQL %s. Error message: %s.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '检测主键过多表', + 'summary' => '查看集群存在主键过多的表信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeExcessivePrimaryKeys'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.App.NotFound', - 'errorMessage' => 'The Spark application %s is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeExcessivePrimaryKeys', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"StatementId\\": 123,\\n \\"Code\\": \\"print(1+1)\\",\\n \\"CodeType\\": \\"PYTHON\\",\\n \\"CodeState\\": \\"RUNNING\\",\\n \\"AliyunUid\\": 0,\\n \\"OutputType\\": \\"TEXT\\",\\n \\"Output\\": \\"{\\\\\\"text/plain\\\\\\": 2}\\",\\n \\"Columns\\": [\\n \\"col1\\"\\n ],\\n \\"Error\\": \\"stackoverflow error\\",\\n \\"StartTime\\": 1730968194000,\\n \\"EndTime\\": 1730968194000\\n }\\n}","type":"json"}]', - 'title' => '获取一段代码的执行结果', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"300\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"863D51B7-5321-41D8-A0B6-A088B0******\\",\\n \\"DBClusterId\\": \\"am-bp1ub9grke1****\\",\\n \\"Tables\\": [\\n {\\n \\"TableName\\": \\"test\\",\\n \\"SchemaName\\": \\"adb_demo\\",\\n \\"ColumnCount\\": 21,\\n \\"PrimaryKeyCount\\": 2,\\n \\"PrimaryKeyColumns\\": \\"id,date\\\\n\\",\\n \\"SpaceRatio\\": 23,\\n \\"TotalSize\\": 4,\\n \\"PrimaryKeyIndexSize\\": 222\\n }\\n ],\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"Excessive primary keys detection\\",\\n \\"Message\\": \\"Multiple tables are detected with excessive primary keys.\\",\\n \\"Status\\": \\"NORMAL\\\\nWARNNING\\\\nCRITICAL\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1906102576997697\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcNqPqHV6lwR4INiAGjIvK1ngXxN1O+6ORRB6A8YvztEOGywOk81ZmuNk0YrNy+qk7+UVDTHeXKsy8h9e/ePY/LMidj0RCmDpo/YpCumd0UGe0qEPe2U+UJAm/+UHlnEFLVg6BP3yIB5D++MCy7mgWm8Kwyhk62IeYly4hQ+5IpXjkh1GQXuDgLVVPVpxEek9n30vnCUL4KsaMgfa7dgojb+3TM8xGsD2zVK5STJNrsXclscIJEqyNXd7CBYiRJVZi1HPO6drN9WW0chLpCSTgjO8n0bNanZaxXKumW9PSwV58UoSFASeMWfZK3TLngX+oq8nGmnTwcJosVjfF4RGzAnS1IXt0Q9N2WHDnpwyLBU/nOz7Hsy8IZ+h+OVjsBTXSM9688/vOF707a5mNzpETvQeGRcua3A5livcKAM2cML0yeUs/Zyj/+BGqtVa+wektspDHC/CECh6R5lxQjRmUdPawY8VDs2onmdLuEH8DdmYt+Yv/jBFBUMWOyAluzkPYcX5nuQKouCIUJUFTSbsJsuH5CTIh7Ls5rbmkj+T1qTVz8gnDR8LxwaqoMSna+elXgVyOOxXtMkenVntsmoC3p/4G7yTPL1hu8JyWGIIvZHZGGLXGEH7FeSuMV8buKxPGFWG3arG8e9LGvDdz5dgTien4y6G5AQ0o1iQdXDos5VWdH3u7k5PrsvdEOpvMi6uSd8a42na80FsYlgGlwM5upydcWUC5Un2HCkJpT1xgk2L6shdVTrK6bidRrqE784FhW9bBQePzGaxSupPENZya0VUctRt+7uq3QwIn4y5jzjgX0E0jgmqPrgiVDjBesMQZYfGPCGysWYWYzfoh+G6V7N2VVGtNnGUwNWzM0WJBPONAgxPv+AmixFRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"202515810214480629\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n }\\"\\n}","type":"json"}]', ], - 'ExecuteSparkReplStatement' => [ - 'summary' => '执行Spark作业中的部分代码。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeExecutorDetection' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -18699,57 +13640,43 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '194344', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'AppId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'Spark App的名称', - 'description' => '应用ID。'."\n" - .'> 您可以调用[ListSparkApps](~~455888~~)接口查询Spark的应用ID。', - 'type' => 'string', - 'required' => false, - 'example' => 's202411071444hzdvk486d9d2001****', - 'default' => 'ADB-Spark-Application', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-xxx'], ], [ - 'name' => 'Code', - 'in' => 'formData', - 'schema' => [ - 'description' => '需要执行的代码。', - 'type' => 'string', - 'required' => true, - 'example' => 'print(1+1)', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-shenzhen'], ], [ - 'name' => 'CodeType', - 'in' => 'formData', - 'schema' => [ - 'description' => '代码的语言类型，取值如下：'."\n" - .'- SCALA'."\n" - .'- PYTHON', - 'type' => 'string', - 'required' => true, - 'enumValueTitles' => [], - 'example' => 'PYTHON', - ], + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => ['description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2024-10-31T02:06Z'], ], [ - 'name' => 'SessionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '执行代码的会话ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '123', - ], + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => '结束时间。日期格式按照ISO8601表示法，并使用UTC时间，格式为yyyy-MM-ddTHH:mmZ。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2021-05-27T16:00Z'], + ], + [ + 'name' => 'Lang', + 'in' => 'query', + 'schema' => ['description' => '语言配置，取值说明：'."\n" + .'- **zh**：简体中文（默认语言）。'."\n" + .'- **en**：英文。', 'type' => 'string', 'required' => false, 'example' => 'zh'], ], ], 'responses' => [ @@ -18757,243 +13684,127 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Data' => [ - 'description' => '返回数据体。', - 'type' => 'object', - 'properties' => [ - 'StatementId' => [ - 'description' => 'Spark作业中代码块的唯一ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'Code' => [ - 'description' => '执行的代码。', - 'type' => 'string', - 'example' => 'print(1+1)', - ], - 'CodeType' => [ - 'description' => '代码的类型，取值如下：'."\n" - .'- SCALA'."\n" - .'- PYTHON', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => 'PYTHON', - ], - 'CodeState' => [ - 'description' => '代码执行状态，取值如下：'."\n" - .'- CANCELLED：取消执行'."\n" - .'- RUNNING：执行中'."\n" - .'- SUCCEEDED：执行成功'."\n" - .'- ERROR：执行失败', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => 'RUNNING', - ], - 'AliyunUid' => [ - 'description' => '集群所属的阿里云主账号。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '17108278707****', - ], - 'OutputType' => [ - 'description' => '执行结果的序列化格式，结构为一个JSON，取值如下：'."\n" - .'- TEXT： 输出结果为Apache Livy标准下的文本内容。'."\n" - .'- TABLE：输出结果为Apache Livy标准下的表格内容。', - 'type' => 'string', - 'enumValueTitles' => [ - 'TABLE' => '表格', - 'TEXT' => '文本', - ], - 'example' => 'TEXT', - ], - 'Output' => [ - 'description' => '代码执行结果，一个JSON格式的字符串，格式上符合Apache Livy的输出标准。', - 'type' => 'string', - 'example' => '{"text/plain": 2}', - ], - 'Columns' => [ - 'description' => '列名数组。', - 'type' => 'array', - 'items' => [ - 'description' => '列名。', - 'type' => 'string', - 'example' => 'col1', + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '566'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '9DFF5F54-162B-5860-80A5-411FF550B347'], + 'DBClusterId' => ['description' => '数仓版集群ID。', 'type' => 'string', 'example' => 'am-xxx'], + 'DetectionItems' => [ + 'description' => '检测项及检测结果列表。', + 'type' => 'array', + 'items' => [ + 'description' => '检测结果。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '检测项名字。', 'type' => 'string', 'example' => 'Metric detection'], + 'Results' => [ + 'description' => '检测结果集合。', + 'type' => 'object', + 'properties' => [ + 'OperatorDetails' => [ + 'description' => '异常算子检测结果集合。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'MetricName' => ['description' => '检测指标名。', 'type' => 'string', 'example' => 'PeakMemory'], + 'SearchResults' => [ + 'description' => '异常算子检测结果。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ProcessId' => ['description' => '任务ID。', 'type' => 'string', 'example' => '2024080110010002102500023803151627972'], + 'StageId' => ['description' => 'StageID。', 'type' => 'string', 'example' => 'Stage[3]'], + 'OperatorName' => ['description' => '算子名。', 'type' => 'string', 'example' => 'Join'], + 'PeakMemory' => ['description' => '峰值内存消耗，单位Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '234'], + 'OperatorCost' => ['description' => '该阶段内部总的算子耗时，等同于该阶段的CPU Time，可用于判断查询哪些部分消耗了较多的计算资源。单位为毫秒（ms）。', 'type' => 'number', 'format' => 'double', 'example' => '123'], + 'InputRows' => ['description' => '算子的输入数据行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'OutputRows' => ['description' => '算子的输出数据行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '2345'], + 'InputSize' => ['description' => '算子的输入数据量。单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '345'], + 'OutputSize' => ['description' => '算子的输出数据量。单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '234'], + 'OperatorInfo' => ['description' => '算子属性信息。', 'type' => 'string', 'example' => 'Group By字段：uid'], + ], + 'description' => '', + ], + ], + ], + 'description' => '', + ], + ], + 'OperatorAgg' => [ + 'description' => '算子指标聚合检测结果集合。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'MetricName' => ['description' => '检测指标名。', 'type' => 'string', 'example' => 'OperatorCost'], + 'SearchResults' => [ + 'description' => '聚合结果检测结果集合。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'OperatorName' => ['description' => '算子名。', 'type' => 'string', 'example' => 'Window'], + 'MaxValue' => ['description' => '指标最大值。', 'type' => 'integer', 'format' => 'int64', 'example' => '2345'], + 'TotalValue' => ['description' => '指标累加值。', 'type' => 'integer', 'format' => 'int64', 'example' => '345'], + 'AvgValue' => ['description' => '指标平均值。', 'type' => 'number', 'format' => 'double', 'example' => '234'], + 'OperatorCount' => ['description' => '算子出现次数。', 'type' => 'integer', 'format' => 'int64', 'example' => '3'], + ], + 'description' => '', + ], + ], + ], + 'description' => '', + ], + ], + ], ], - ], - 'Error' => [ - 'description' => '错误消息。', - 'type' => 'string', - 'example' => 'StackOverflow Exception', - ], - 'StartTime' => [ - 'description' => '开始时间，格式为Unix时间戳，单位毫秒。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1730968125000', - ], - 'EndTime' => [ - 'description' => '结束时间，格式为Unix时间戳，单位毫秒。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1730968125000', + 'Message' => ['description' => '检测结果信息。', 'type' => 'string', 'example' => '检测到Aggregation算子消耗内存资源较多'."\n"], + 'Status' => ['description' => '检测结果状态。取值：'."\n" + ."\n" + .'- NORMAL'."\n" + .'- WARNING'."\n" + .'- CRITICAL', 'type' => 'string', 'example' => 'WARNING'], ], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.App.ExceedQuotaLimitation', - 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', - ], - [ - 'errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', - 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ResourceNegativeError', - 'errorMessage' => 'The requested resource MUST be positive: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidAppFilePath', - 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidDiskConfig', - 'errorMessage' => 'The requested disk mount parameter is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidHostAliasConfig', - 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', - ], - [ - 'errorCode' => 'Spark.Config.InvalidLogOssPath', - 'errorMessage' => 'The OSS address for log storage is illegal: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidRoleArnFormat', - 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', - ], - [ - 'errorCode' => 'Spark.Config.InvalidTimeZone', - 'errorMessage' => 'Unable to parse time zone configuration %s : %s', - ], - [ - 'errorCode' => 'Spark.Config.MainAppFileNotExists', - 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathAccessError', - 'errorMessage' => 'The configured OSS address %s cannot be accessed.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathNotExists', - 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Config.SecurityGroupNotFound', - 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.Config.VswitchNotFound', - 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.RoleArn.Invalid', - 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', - ], - [ - 'errorCode' => 'Spark.SQL.BlankError', - 'errorMessage' => 'Input sql can not be blank string.', - ], - [ - 'errorCode' => 'Spark.SQL.MultipleSQLError', - 'errorMessage' => 'Element in field [sqls] can not contain more than one sql statement: %s.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Submit spark app failed when parser SQL %s. Error message: %s.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '计算节点检测', + 'summary' => '查看计算层诊断结果。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeExecutorDetection'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.App.NotFound', - 'errorMessage' => 'The Spark application %s is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeExecutorDetection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"StatementId\\": 123,\\n \\"Code\\": \\"print(1+1)\\",\\n \\"CodeType\\": \\"PYTHON\\",\\n \\"CodeState\\": \\"RUNNING\\",\\n \\"AliyunUid\\": 0,\\n \\"OutputType\\": \\"TEXT\\",\\n \\"Output\\": \\"{\\\\\\"text/plain\\\\\\": 2}\\",\\n \\"Columns\\": [\\n \\"col1\\"\\n ],\\n \\"Error\\": \\"StackOverflow Exception\\",\\n \\"StartTime\\": 1730968125000,\\n \\"EndTime\\": 1730968125000\\n }\\n}","type":"json"}]', - 'title' => '执行Spark作业中的部分代码', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"566\\",\\n \\"RequestId\\": \\"9DFF5F54-162B-5860-80A5-411FF550B347\\",\\n \\"DBClusterId\\": \\"am-xxx\\",\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"Metric detection\\",\\n \\"Results\\": {\\n \\"OperatorDetails\\": [\\n {\\n \\"MetricName\\": \\"PeakMemory\\",\\n \\"SearchResults\\": [\\n {\\n \\"ProcessId\\": \\"2024080110010002102500023803151627972\\",\\n \\"StageId\\": \\"Stage[3]\\",\\n \\"OperatorName\\": \\"Join\\",\\n \\"PeakMemory\\": 234,\\n \\"OperatorCost\\": 123,\\n \\"InputRows\\": 123,\\n \\"OutputRows\\": 2345,\\n \\"InputSize\\": 345,\\n \\"OutputSize\\": 234,\\n \\"OperatorInfo\\": \\"Group By字段：uid\\"\\n }\\n ]\\n }\\n ],\\n \\"OperatorAgg\\": [\\n {\\n \\"MetricName\\": \\"OperatorCost\\",\\n \\"SearchResults\\": [\\n {\\n \\"OperatorName\\": \\"Window\\",\\n \\"MaxValue\\": 2345,\\n \\"TotalValue\\": 345,\\n \\"AvgValue\\": 234,\\n \\"OperatorCount\\": 3\\n }\\n ]\\n }\\n ]\\n },\\n \\"Message\\": \\"检测到Aggregation算子消耗内存资源较多\\\\n\\",\\n \\"Status\\": \\"WARNING\\"\\n }\\n ]\\n}","type":"json"}]', ], - 'CancelSparkReplStatement' => [ - 'summary' => '终止Spark作业中的部分代码块。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeHistoryTasks' => [ + 'summary' => '获取历史任务记录。', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -19002,322 +13813,94 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '254755', + 'abilityTreeNodes' => ['FEATUREads12ZDDA'], ], 'parameters' => [ [ - 'name' => 'AppId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'Spark App的名称', - 'description' => '应用ID。'."\n" - .'> 可调用[ListSparkApps](~~455888~~)接口查询Spark应用ID。', - 'type' => 'string', - 'required' => false, - 'example' => 's202411071444hzdvk486d9d2001****', - 'default' => 'ADB-Spark-Application', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'allowEmptyValue' => false, + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'cn-beijing'], ], [ - 'name' => 'StatementId', - 'in' => 'formData', - 'schema' => [ - 'description' => 'Spark作业中代码块的唯一ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '123', - ], + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数，取值：10~100。默认值：10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '10', 'example' => '10', 'default' => '10'], ], [ - 'name' => 'SessionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '会话ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '456', - ], + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '查询结果的页码。取值范围：正整数。 默认值：1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1', 'default' => '1'], ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Data' => [ - 'description' => '返回内容。', - 'type' => 'object', - 'properties' => [ - 'StatementId' => [ - 'description' => 'Spark作业中代码块的唯一ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'Code' => [ - 'description' => '输入的代码。', - 'type' => 'string', - 'example' => 'print(1+1)', - ], - 'CodeType' => [ - 'description' => '代码的类型，取值如下：'."\n" - .'- SCALA'."\n" - .'- PYTHON', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => 'PYTHON', - ], - 'CodeState' => [ - 'description' => '代码执行状态，取值如下：'."\n" - .'- CANCELLED： 执行取消'."\n" - .'- RUNNING： 执行中'."\n" - .'- SUCCEEDED： 执行成功'."\n" - .'- ERROR： 执行失败', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => 'RUNNING', - ], - 'AliyunUid' => [ - 'description' => '集群所属的阿里云主账号。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '190063530332****', - ], - 'OutputType' => [ - 'description' => '执行结果的序列化格式，结构为一个JSON，取值如下：'."\n" - .'- TEXT： 输出结果为Apache Livy标准下的文本内容。'."\n" - .'- TABLE：输出结果为Apache Livy标准下的表格内容。', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => 'TEXT', - ], - 'Output' => [ - 'description' => '代码执行结果，一个JSON格式的字符串，格式上符合Apache Livy的输出标准。', - 'type' => 'string', - 'example' => '{"text/plain": "2"}', - ], - 'Columns' => [ - 'description' => '当输出结果为表时，表的列名。', - 'type' => 'array', - 'items' => [ - 'description' => '列名。', - 'type' => 'string', - 'example' => 'col1', - ], - ], - 'Error' => [ - 'description' => '错误消息。', - 'type' => 'string', - 'example' => 'StackOverflow Exception：', - ], - 'StartTime' => [ - 'description' => '执行开始时间的毫秒级时间戳。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1730968056000', - ], - 'EndTime' => [ - 'description' => '执行结束时间的毫秒级时间戳。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1730968056000', - ], - ], - ], - ], - ], + [ + 'name' => 'InstanceType', + 'in' => 'query', + 'schema' => ['description' => '实例类型，当前固定为 Instance。', 'type' => 'string', 'required' => false, 'example' => 'Instance'], ], - ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.App.ExceedQuotaLimitation', - 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', - ], - [ - 'errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', - 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ResourceNegativeError', - 'errorMessage' => 'The requested resource MUST be positive: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidAppFilePath', - 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidDiskConfig', - 'errorMessage' => 'The requested disk mount parameter is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidHostAliasConfig', - 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', - ], - [ - 'errorCode' => 'Spark.Config.InvalidLogOssPath', - 'errorMessage' => 'The OSS address for log storage is illegal: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidRoleArnFormat', - 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', - ], - [ - 'errorCode' => 'Spark.Config.InvalidTimeZone', - 'errorMessage' => 'Unable to parse time zone configuration %s : %s', - ], - [ - 'errorCode' => 'Spark.Config.MainAppFileNotExists', - 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathAccessError', - 'errorMessage' => 'The configured OSS address %s cannot be accessed.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathNotExists', - 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Config.SecurityGroupNotFound', - 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.Config.VswitchNotFound', - 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.RoleArn.Invalid', - 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', - ], - [ - 'errorCode' => 'Spark.SQL.BlankError', - 'errorMessage' => 'Input sql can not be blank string.', - ], - [ - 'errorCode' => 'Spark.SQL.MultipleSQLError', - 'errorMessage' => 'Element in field [sqls] can not contain more than one sql statement: %s.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Submit spark app failed when parser SQL %s. Error message: %s.', - ], + [ + 'name' => 'Status', + 'in' => 'query', + 'schema' => ['description' => '任务状态，取值说明：'."\n" + ."\n" + .'- **Scheduled**：等待执行。'."\n" + ."\n" + .'- **Running**：执行中。'."\n" + ."\n" + .'- **Succeed**：执行成功。'."\n" + ."\n" + .'- **Failed**：执行失败。'."\n" + ."\n" + .'- **Cancelling**：正在终止。'."\n" + ."\n" + .'- **Canceled**：已终止。'."\n" + ."\n" + .'- **Waiting**：等待预设时间。'."\n" + ."\n" + .'如需查询多个状态则用英文逗号分隔，默认为空，表示全选。', 'type' => 'string', 'required' => false, 'example' => 'Scheduled'], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + [ + 'name' => 'InstanceId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。多个集群ID用英文逗号（,）分隔。最多填写30个集群ID。若不填写，则默认查询该地域下所有集群的历史任务。', 'type' => 'string', 'required' => false, 'example' => 'amv-********'], ], [ - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.App.NotFound', - 'errorMessage' => 'The Spark application %s is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], + 'name' => 'TaskId', + 'in' => 'query', + 'schema' => ['description' => '任务ID。多个任务ID用英文逗号（,）分隔。最多填写30个任务ID。若不填写，则默认查询所有集群的历史任务。', 'type' => 'string', 'required' => false, 'example' => 't-83br18hloy3faf****'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], + [ + 'name' => 'TaskType', + 'in' => 'query', + 'schema' => ['description' => '任务类型，用于查询特定类型任务情况，如有多个用英文逗号（,）分隔，最多支持 30 个，默认为空，表示不限制。', 'type' => 'string', 'required' => false, 'example' => 'autotest_dispatch_cases'], ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"StatementId\\": 123,\\n \\"Code\\": \\"print(1+1)\\",\\n \\"CodeType\\": \\"PYTHON\\",\\n \\"CodeState\\": \\"RUNNING\\",\\n \\"AliyunUid\\": 0,\\n \\"OutputType\\": \\"TEXT\\",\\n \\"Output\\": \\"{\\\\\\"text/plain\\\\\\": \\\\\\"2\\\\\\"}\\",\\n \\"Columns\\": [\\n \\"col1\\"\\n ],\\n \\"Error\\": \\"StackOverflow Exception：\\",\\n \\"StartTime\\": 1730968056000,\\n \\"EndTime\\": 1730968056000\\n }\\n}","type":"json"}]', - 'title' => '终止Spark作业中的部分代码块', - ], - 'GetSparkReplSession' => [ - 'summary' => '获取会话状态。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ [ - 'AK' => [], + 'name' => 'FromStartTime', + 'in' => 'query', + 'schema' => ['description' => '任务开始时间的起始时间，表示查询任务开始时间在此时间之后的任务。按照 ISO8601 标准表示，并需要使用 UTC +0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。最早支持 30 天前，距当前时间超过 30 天会自动转换成 30 天前。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2022-01-02T11:31:03Z'], ], - ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'free', - ], - 'parameters' => [ [ - 'name' => 'AppId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'Spark App的名称', - 'description' => '应用ID。'."\n" - .'> 您可以调用[ListSparkApps](~~455888~~)接口查询所有的应用ID。', - 'type' => 'string', - 'required' => false, - 'example' => 's202411071444hzdvk486d9d200****', - 'default' => 'ADB-Spark-Application', - ], + 'name' => 'ToStartTime', + 'in' => 'query', + 'schema' => ['description' => '任务开始时间的结束时间，表示查询任务开始时间在此时间之前的任务。按照 ISO8601 标准表示，并需要使用 UTC +0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2022-03-02T11:31:03Z'], ], [ - 'name' => 'SessionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '执行代码的会话ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1', - ], + 'name' => 'FromExecTime', + 'in' => 'query', + 'schema' => ['description' => '任务执行耗时的最小值。用于筛选任务执行耗时大于此时间的任务，单位秒。默认 0，表示不限制。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '0'], + ], + [ + 'name' => 'ToExecTime', + 'in' => 'query', + 'schema' => ['description' => '任务执行耗时的最大值。用于筛选任务执行耗时不小于此时间的任务，单位秒。默认 0，表示不限制。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '0'], + ], + [ + 'name' => 'ResourceGroupId', + 'in' => 'query', + 'schema' => ['description' => '资源组 ID。', 'type' => 'string', 'required' => false, 'example' => 'rg-ae****'], ], ], 'responses' => [ @@ -19325,326 +13908,298 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '4CE6DF97-AEA4-484F-906F-C407EE3770EB', + 'PageNumber' => ['description' => '查询结果的页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'E51713A3-BB45-5616-AB15-170B704F8F01'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'TotalCount' => ['description' => '总记录条数。', 'type' => 'integer', 'format' => 'int32', 'example' => '100'], + 'Items' => [ + 'description' => '任务列表。', + 'type' => 'array', + 'items' => [ + 'description' => '任务对象。', + 'type' => 'object', + 'properties' => [ + 'Status' => ['description' => '任务状态。'."\n" + ."\n" + .'- **Scheduled**：等待执行。'."\n" + ."\n" + .'- **Running**：执行中。'."\n" + ."\n" + .'- **Succeed**：执行成功。'."\n" + ."\n" + .'- **Failed**：执行失败。'."\n" + ."\n" + .'- **Cancelling**：正在终止。'."\n" + ."\n" + .'- **Canceled**：已终止。'."\n" + ."\n" + .'- **Waiting**：等待预设时间。', 'type' => 'string', 'example' => 'Running'], + 'TaskId' => ['description' => '任务 ID。', 'type' => 'string', 'example' => 't-83br18hloy3faf****'], + 'CurrentStepName' => ['description' => '当前执行的步骤名，如果为空代表任务未开始。', 'type' => 'string', 'example' => 'exec_task'], + 'StartTime' => ['description' => '任务开始时间。', 'type' => 'string', 'example' => '2022-02-03T11:31:03Z'], + 'EndTime' => ['description' => '任务结束时间。', 'type' => 'string', 'example' => '2022-02-03T12:06:17Z'], + 'TaskType' => ['description' => '任务类型。', 'type' => 'string', 'example' => 'autotest_dispatch_cases'], + 'RemainTime' => ['description' => '预估剩余执行时间，单位为秒（s）。', 'type' => 'integer', 'format' => 'int32', 'example' => '1000'], + 'Progress' => ['description' => '当前进度。', 'type' => 'number', 'format' => 'float', 'example' => '79.0'], + 'RegionId' => ['description' => '地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'InstanceType' => ['description' => '实例类型。', 'type' => 'string', 'example' => 'Instance'], + 'InstanceId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-********'], + 'InstanceName' => ['description' => '实例名。', 'type' => 'string', 'example' => 'test'], + 'DbType' => ['description' => '数据库类型。', 'type' => 'string', 'example' => 'analyticdb'], + 'Product' => ['description' => '产品。', 'type' => 'string', 'example' => 'ads', 'default' => 'ADB'], + 'TaskDetail' => ['description' => '任务详情。', 'type' => 'string', 'example' => '{\\"callerUid\\":\\"test\\"}'], + 'ActionInfo' => ['description' => '允许的操作信息，具体使用时是根据 currentStepName+status 在此信息中匹配操作 Action，如果未匹配到 Action，代表任务当前状态不支持操作。', 'type' => 'string', 'example' => '{\\"steps\\":[{\\"action_info\\":{\\"Waiting\\":[\\"modifySwitchTime\\"]},\\"step_name\\":\\"exec_task\\"}]}'], + 'Uid' => ['description' => '资源所属用户 ID。', 'type' => 'string', 'example' => '141345906006****'], + 'CallerSource' => ['description' => '请求用户 ID，callerSource 为 User 时代表用户 UID。', 'type' => 'string', 'example' => '141345906006****'], + 'CallerUid' => ['description' => '请求来源，取值说明：'."\n" + ."\n" + .'- **System**：系统。'."\n" + ."\n" + .'- **User**：用户。', 'type' => 'string', 'example' => 'User'], + 'ReasonCode' => ['description' => '当前任务发起的原因。', 'type' => 'string', 'example' => 'test'], + ], + ], ], - 'Data' => [ - 'description' => '返回数据。', + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'HttpStatusCode' => ['description' => 'HTTP状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], + 'AccessDeniedDetail' => [ + 'description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段。', 'type' => 'object', 'properties' => [ - 'SessionId' => [ - 'description' => '执行代码的会话ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'State' => [ - 'description' => '当前会话状态，取值如下：'."\n" - .'- IDLE： 空闲'."\n" - .'- BUSY： 繁忙，执行任务中'."\n" - .'- DEAD： 会话关闭', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => 'IDEL', - ], - 'AttemptId' => [ - 'description' => 'Spark应用的重试ID。', - 'type' => 'string', - 'example' => 's202301061000hz57d797b00002****', - ], - 'Error' => [ - 'description' => '错误消息。', - 'type' => 'string', - 'example' => 'Session timed out', - ], - 'WebUiAddress' => [ - 'description' => 'Spark应用的Web UI地址。', - 'type' => 'string', - 'example' => 'https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****', - ], - 'AliyunUid' => [ - 'description' => '实例所属的阿里云账户ID。', - 'type' => 'string', - 'example' => '178157466101****', - ], - 'Active' => [ - 'description' => '是否处于活跃状态，取值如下：'."\n" - .'- true： 活跃'."\n" - .'- false：不活跃', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => 'true', - ], + 'AuthAction' => ['description' => '鉴权Action。', 'type' => 'string', 'example' => 'test'], + 'AuthPrincipalDisplayName' => ['description' => '授权主体显示名称。', 'type' => 'string', 'example' => 'test'], + 'AuthPrincipalOwnerId' => ['description' => '鉴权主体的主账号ID。', 'type' => 'string', 'example' => '141345906006****'], + 'AuthPrincipalType' => ['description' => '授权主体类型。', 'type' => 'string', 'example' => 'test'], + 'EncodedDiagnosticMessage' => ['description' => '编码诊断信息。', 'type' => 'string', 'example' => 'AQFmy+hZZsvoWTQ2NTJFQUFBLUIyNjktMzk5NS05MEZCLUMxMzgwNDUwMDA2Ng=='], + 'NoPermissionType' => ['description' => '权限策略拒绝的类型，取值如下：'."\n" + .'- **ImplicitDeny**：资源持有者未配置相关权限策略给当前用户，缺省拒绝未授权的操作。'."\n" + .'- **ExplicitDeny**：资源持有者配置的RAM策略明确拒绝了当前用户访问对应的资源。', 'type' => 'string', 'example' => 'ImplicitDeny'], + 'PolicyType' => ['description' => '引起无权限的策略类型，取值如下:'."\n" + .'- **ControlPolicy** ：管控策略。'."\n" + .'- **SessionPolicy**：临时Token额外添加的一个权限策略。'."\n" + .'- **AssumeRolePolicy**：RAM角色的授信策略。'."\n" + .'- **AccountLevelIdentityBasedPolicy**：账号授权范围的主体策略，包含自定义策略和系统策略。'."\n" + .'- **ResourceGroupLevelIdentityBasedPolicy**：资源组授权范围的主体策略，包含自定义策略和系统策略。', 'type' => 'string', 'example' => 'ControlPolicy'], ], ], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.App.ExceedQuotaLimitation', - 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', - ], - [ - 'errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', - 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ResourceNegativeError', - 'errorMessage' => 'The requested resource MUST be positive: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidAppFilePath', - 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidDiskConfig', - 'errorMessage' => 'The requested disk mount parameter is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidHostAliasConfig', - 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', - ], - [ - 'errorCode' => 'Spark.Config.InvalidLogOssPath', - 'errorMessage' => 'The OSS address for log storage is illegal: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidRoleArnFormat', - 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', - ], - [ - 'errorCode' => 'Spark.Config.InvalidTimeZone', - 'errorMessage' => 'Unable to parse time zone configuration %s : %s', - ], - [ - 'errorCode' => 'Spark.Config.MainAppFileNotExists', - 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathAccessError', - 'errorMessage' => 'The configured OSS address %s cannot be accessed.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathNotExists', - 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Config.SecurityGroupNotFound', - 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.Config.VswitchNotFound', - 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.RoleArn.Invalid', - 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', - ], - [ - 'errorCode' => 'Spark.SQL.BlankError', - 'errorMessage' => 'Input sql can not be blank string.', - ], - [ - 'errorCode' => 'Spark.SQL.MultipleSQLError', - 'errorMessage' => 'Element in field [sqls] can not contain more than one sql statement: %s.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Submit spark app failed when parser SQL %s. Error message: %s.', - ], - ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询历史运维任务', + 'description' => '仅支持查看30天内的任务。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeHistoryTasks'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.App.NotFound', - 'errorMessage' => 'The Spark application %s is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeHistoryTasks', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"4CE6DF97-AEA4-484F-906F-C407EE3770EB\\",\\n \\"Data\\": {\\n \\"SessionId\\": 1,\\n \\"State\\": \\"IDEL\\",\\n \\"AttemptId\\": \\"s202301061000hz57d797b00002****\\",\\n \\"Error\\": \\"Session timed out\\",\\n \\"WebUiAddress\\": \\"https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****\\",\\n \\"AliyunUid\\": \\"178157466101****\\",\\n \\"Active\\": \\"true\\"\\n }\\n}","type":"json"}]', - 'title' => '获取会话状态', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PageNumber\\": 1,\\n \\"RequestId\\": \\"E51713A3-BB45-5616-AB15-170B704F8F01\\",\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 100,\\n \\"Items\\": [\\n {\\n \\"Status\\": \\"Running\\",\\n \\"TaskId\\": \\"t-83br18hloy3faf****\\",\\n \\"CurrentStepName\\": \\"exec_task\\",\\n \\"StartTime\\": \\"2022-02-03T11:31:03Z\\",\\n \\"EndTime\\": \\"2022-02-03T12:06:17Z\\",\\n \\"TaskType\\": \\"autotest_dispatch_cases\\",\\n \\"RemainTime\\": 1000,\\n \\"Progress\\": 79,\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"InstanceType\\": \\"Instance\\",\\n \\"InstanceId\\": \\"amv-********\\",\\n \\"InstanceName\\": \\"test\\",\\n \\"DbType\\": \\"analyticdb\\",\\n \\"Product\\": \\"ads\\",\\n \\"TaskDetail\\": \\"{\\\\\\\\\\\\\\"callerUid\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"test\\\\\\\\\\\\\\"}\\",\\n \\"ActionInfo\\": \\"{\\\\\\\\\\\\\\"steps\\\\\\\\\\\\\\":[{\\\\\\\\\\\\\\"action_info\\\\\\\\\\\\\\":{\\\\\\\\\\\\\\"Waiting\\\\\\\\\\\\\\":[\\\\\\\\\\\\\\"modifySwitchTime\\\\\\\\\\\\\\"]},\\\\\\\\\\\\\\"step_name\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"exec_task\\\\\\\\\\\\\\"}]}\\",\\n \\"Uid\\": \\"141345906006****\\",\\n \\"CallerSource\\": \\"141345906006****\\",\\n \\"CallerUid\\": \\"User\\",\\n \\"ReasonCode\\": \\"test\\"\\n }\\n ],\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Success\\",\\n \\"AccessDeniedDetail\\": {\\n \\"AuthAction\\": \\"test\\",\\n \\"AuthPrincipalDisplayName\\": \\"test\\",\\n \\"AuthPrincipalOwnerId\\": \\"141345906006****\\",\\n \\"AuthPrincipalType\\": \\"test\\",\\n \\"EncodedDiagnosticMessage\\": \\"AQFmy+hZZsvoWTQ2NTJFQUFBLUIyNjktMzk5NS05MEZCLUMxMzgwNDUwMDA2Ng==\\",\\n \\"NoPermissionType\\": \\"ImplicitDeny\\",\\n \\"PolicyType\\": \\"ControlPolicy\\"\\n }\\n}","type":"json"}]', ], - 'DescribeSparkAppType' => [ - 'summary' => '查询Spark应用类型。', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeHistoryTasksStat' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '189112', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '254776', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~98094~~)接口查看目标地域下所有的集群信息，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-wz9w49b12933****', - ], + 'allowEmptyValue' => false, + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-beijing'], ], [ - 'name' => 'RegionId', + 'name' => 'Status', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-shenzhen', - ], + 'schema' => ['description' => '任务状态，取值说明：'."\n" + ."\n" + .'- **Scheduled**：等待执行。'."\n" + ."\n" + .'- **Running**：执行中。'."\n" + ."\n" + .'- **Succeed**：执行成功。'."\n" + ."\n" + .'- **Failed**：执行失败。'."\n" + ."\n" + .'- **Cancelling**：正在终止。'."\n" + ."\n" + .'- **Canceled**：已终止。'."\n" + ."\n" + .'- **Waiting**：等待预设时间。'."\n" + ."\n" + .'如有多个状态则用英文逗号分隔，默认为空，表示全选。', 'type' => 'string', 'required' => false, 'example' => 'Scheduled'], ], [ - 'name' => 'AppId', + 'name' => 'InstanceId', 'in' => 'query', - 'schema' => [ - 'description' => '应用ID。'."\n" - .'> 调用[ListSparkApps](~~612475~~)接口查询Spark应用的ID。', - 'type' => 'string', - 'required' => true, - 'example' => 's202407161205sza4c07c1000****', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-********'], + ], + [ + 'name' => 'TaskId', + 'in' => 'query', + 'schema' => ['description' => '任务 ID。', 'type' => 'string', 'required' => false, 'example' => '1564657730'], + ], + [ + 'name' => 'TaskType', + 'in' => 'query', + 'schema' => ['description' => '任务类型。', 'type' => 'string', 'required' => false, 'example' => 'all'], + ], + [ + 'name' => 'FromStartTime', + 'in' => 'query', + 'allowEmptyValue' => false, + 'schema' => ['description' => '查询开始时间。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2023-05-08T07:04:17Z'], + ], + [ + 'name' => 'ToStartTime', + 'in' => 'query', + 'allowEmptyValue' => false, + 'schema' => ['description' => '表示查询任务开始时间在此时间之前的任务。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2023-02-24T10:01:37Z'], + ], + [ + 'name' => 'FromExecTime', + 'in' => 'query', + 'schema' => ['description' => '任务执行耗时的最小值，用于筛选任务执行耗时大于此时间的任务，单位秒。默认 0，表示不限制。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'ToExecTime', + 'in' => 'query', + 'schema' => ['description' => '任务执行耗时的最大值，用于筛选任务执行耗时不小于此时间的任务，单位秒。默认 0，表示不限制。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'], + ], + [ + 'name' => 'ResourceGroupId', + 'in' => 'query', + 'schema' => ['description' => '资源组 ID。', 'type' => 'string', 'required' => false, 'example' => 'rg-acfmy*****'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '596AF63B-8798-501E-BA06-CD2184D48A35', - ], - 'Type' => [ - 'description' => 'Spark应用的类型，可取值如下：'."\n" - .'- BATCH：批处理应用。'."\n" - .'- SQLENGINE：SQL引擎应用。', - 'type' => 'string', - 'enumValueTitles' => [ - 'SQLENGINE' => 'SQL引擎应用。', - 'BATCH' => '批处理应用。', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Items' => [ + 'description' => '任务信息列表。', + 'type' => 'array', + 'items' => [ + 'description' => '任务信息列表。', + 'type' => 'object', + 'properties' => [ + 'Status' => ['description' => '任务状态。'."\n" + ."\n" + .'- **Scheduled**：等待执行。'."\n" + ."\n" + .'- **Running**：执行中。'."\n" + ."\n" + .'- **Succeed**：执行成功。'."\n" + ."\n" + .'- **Failed**：执行失败。'."\n" + ."\n" + .'- **Cancelling**：正在终止。'."\n" + ."\n" + .'- **Canceled**：已终止。'."\n" + ."\n" + .'- **Waiting**：等待预设时间。', 'type' => 'string', 'example' => 'Scheduled'], + 'TotalCount' => ['description' => '任务总数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + ], ], - 'example' => 'Batch', ], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'HttpStatusCode' => ['description' => 'HTTP状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + ."\n" + .'- 请求正常，返回OK。'."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'SUCCESS'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => '200'], 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝的详细原因。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', + 'description' => '访问被拒绝详细信息。', + 'type' => 'object', + 'properties' => [ + 'AuthAction' => ['description' => '鉴权Action。', 'type' => 'string', 'example' => 'test'], + 'AuthPrincipalDisplayName' => ['description' => '授权主体显示名称。', 'type' => 'string', 'example' => 'test'], + 'AuthPrincipalOwnerId' => ['description' => '鉴权主体的主账号ID。', 'type' => 'string', 'example' => '141345906006****'], + 'AuthPrincipalType' => ['description' => '授权主体类型。', 'type' => 'string', 'example' => 'test'], + 'EncodedDiagnosticMessage' => ['description' => '编码诊断信息。', 'type' => 'string', 'example' => 'test'."\n"], + 'NoPermissionType' => ['description' => '权限策略拒绝的类型，取值如下：'."\n" + .'- **ImplicitDeny**：资源持有者未配置相关权限策略给当前用户，缺省拒绝未授权的操作。'."\n" + .'- **ExplicitDeny**：资源持有者配置的RAM策略明确拒绝了当前用户访问对应的资源。', 'type' => 'string', 'example' => 'ImplicitDeny'], + 'PolicyType' => ['description' => '引起无权限的策略类型，取值如下:'."\n" + .'- **ControlPolicy** ：管控策略。'."\n" + .'- **SessionPolicy**：临时Token额外添加的一个权限策略。'."\n" + .'- **AssumeRolePolicy**：RAM角色的授信策略。'."\n" + .'- **AccountLevelIdentityBasedPolicy**：账号授权范围的主体策略，包含自定义策略和系统策略。'."\n" + .'- **ResourceGroupLevelIdentityBasedPolicy**：资源组授权范围的主体策略，包含自定义策略和系统策略。', 'type' => 'string', 'example' => 'ControlPolicy'], + ], ], ], ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '统计历史任务', + 'summary' => '任务中心任务统计。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeHistoryTasksStat'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:DescribeHistoryTasksStat', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"596AF63B-8798-501E-BA06-CD2184D48A35\\",\\n \\"Type\\": \\"Batch\\",\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', - 'title' => '查询Spark应用类型', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Items\\": [\\n {\\n \\"Status\\": \\"Scheduled\\",\\n \\"TotalCount\\": 20\\n }\\n ],\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"SUCCESS\\",\\n \\"Code\\": \\"200\\",\\n \\"AccessDeniedDetail\\": {\\n \\"AuthAction\\": \\"test\\",\\n \\"AuthPrincipalDisplayName\\": \\"test\\",\\n \\"AuthPrincipalOwnerId\\": \\"141345906006****\\",\\n \\"AuthPrincipalType\\": \\"test\\",\\n \\"EncodedDiagnosticMessage\\": \\"test\\\\n\\",\\n \\"NoPermissionType\\": \\"ImplicitDeny\\",\\n \\"PolicyType\\": \\"ControlPolicy\\"\\n }\\n}","type":"json"}]', ], - 'PreloadSparkAppMetrics' => [ - 'summary' => '预加载Spark App 指标数据。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeInclinedNodes' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'tags' => ['Perth'], 'security' => [ [ 'AK' => [], @@ -19653,223 +14208,95 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '169119', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], + 'operationType' => 'get', + 'abilityTreeCode' => '217356', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ - 'name' => 'AppId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'spark app的id', - 'description' => 'Spark应用的ID。', - 'type' => 'string', - 'required' => true, - 'example' => 's202204221525hzca7d8140000003', - 'maxLength' => 64, - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-wz9jd******d1765'], ], [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-bp1mfe9qmsw1dzyg', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'>您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'Lang', + 'in' => 'query', + 'schema' => ['description' => '设置下载文件的文件标题以及部分错误信息的语言，支持如下语言：'."\n" + .'- **zh**：简体中文。'."\n" + .'- **en**：英文。'."\n" + .'- **ja**：日语。'."\n" + .'- **zh-tw**：繁体中文。', 'type' => 'string', 'required' => false, 'example' => 'zh'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '结构体', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '84489769-3065-5A28-A4CB-977CD426F1C3', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'AppId' => [ - 'description' => '应用ID。', - 'type' => 'string', - 'example' => 's202212181815shaccb8be0000253', - ], - 'AttemptId' => [ - 'description' => 'Spark应用的重试ID。', - 'type' => 'string', - 'example' => 's202301061000hz57d797b0000201-0001', - ], - 'Finished' => [ - 'description' => '解析是否结束：'."\n" - .'- true：表示已结束。'."\n" - .'- false：表示未结束。', - 'type' => 'boolean', - 'example' => 'True', - ], - 'EventLogPath' => [ - 'description' => 'Event日志路径。', - 'type' => 'string', - 'example' => 'oss://path/to/eventLog', - ], - 'ScanMetrics' => [ - 'description' => '指标数据。', - 'type' => 'object', - 'properties' => [ - 'OutputRowsCount' => [ - 'description' => '扫描行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1000', - ], - 'TotalReadFileSizeInByte' => [ - 'description' => '扫描字节大小。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10000', - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'C0BF6685-0519-543E-90F8-DB8949E4D5F2'], + 'Items' => [ + 'description' => '列信息。', + 'type' => 'array', + 'items' => [ + 'description' => '存储节点信息。', + 'type' => 'object', + 'properties' => [ + 'Node' => ['description' => '存储节点编号。', 'type' => 'string', 'example' => 'Node1'], + 'DiskUsageRatio' => ['description' => '存储节点磁盘水位。', 'type' => 'string', 'example' => '90.5'], ], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', - 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.FailedToKill', - 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', - 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.KillOperationFailed', - 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Log.InvalidState', - 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.BadFileType', - 'errorMessage' => 'The requested template %s is not a file.', - ], - ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], - ], - [ - [ - 'errorCode' => 'Spark.AnalyzeTask.NotFound', - 'errorMessage' => 'The requested analysis task %s is not found.', - ], - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.TemplateNotFound', - 'errorMessage' => 'The template %s is not found.', - ], - ], - 406 => [ - [ - 'errorCode' => 'Spark.App.KillNotAcceptable', - 'errorMessage' => 'Can\'t kill the application %s in %s state.', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"84489769-3065-5A28-A4CB-977CD426F1C3\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202212181815shaccb8be0000253\\",\\n \\"AttemptId\\": \\"s202301061000hz57d797b0000201-0001\\",\\n \\"Finished\\": true,\\n \\"EventLogPath\\": \\"oss://path/to/eventLog\\",\\n \\"ScanMetrics\\": {\\n \\"OutputRowsCount\\": 1000,\\n \\"TotalReadFileSizeInByte\\": 10000\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"<PreloadSparkAppMetricsResponse>\\n <RequestId>84489769-3065-5A28-A4CB-977CD426F1C3</RequestId>\\n <Data>\\n <AppId>s202212181815shaccb8be0000253</AppId>\\n <AttemptId>s202301061000hz57d797b0000201-0001</AttemptId>\\n <Finished>true</Finished>\\n <EventLogPath>oss://path/to/eventLog</EventLogPath>\\n <ScanMetrics>\\n <OutputRowsCount>1000</OutputRowsCount>\\n <TotalReadFileSizeInByte>10000</TotalReadFileSizeInByte>\\n </ScanMetrics>\\n </Data>\\n</PreloadSparkAppMetricsResponse>","errorExample":""}]', - 'title' => '预加载Spark App指标数据', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', - ], - 'GetSparkAppMetrics' => [ - 'summary' => '获取Spark App指标数据。', - 'methods' => [ - 'post', - 'get', + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '查询存储节点磁盘水位', + 'summary' => '查询所有存储节点的磁盘水位。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeInclinedNodes'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeInclinedNodes', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C0BF6685-0519-543E-90F8-DB8949E4D5F2\\",\\n \\"Items\\": [\\n {\\n \\"Node\\": \\"Node1\\",\\n \\"DiskUsageRatio\\": \\"90.5\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'DescribeInclinedTables' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -19879,311 +14306,180 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '169120', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '186716', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'AppId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'spark app的id', - 'description' => '应用ID。', - 'type' => 'string', - 'required' => true, - 'example' => 's202204221525hzca7d8140000003', - 'maxLength' => 64, - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下AnalyticDB MySQL湖仓版集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-k2jofo4pi5zhd****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'TableType', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~612397~~)接口查询目标地域中所有集群的集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-bp1ggnu61d77****', - ], + 'schema' => ['description' => '表类型，取值说明：'."\n" + .'- **FactTable**：分区表。'."\n" + .'- **DimensionTable**：维度表。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'FactTable'], + ], + [ + 'name' => 'Order', + 'in' => 'query', + 'schema' => ['description' => '按指定字段排序，json格式：JSON数组，有序，按顺序输入排列字段和升降序类型：'."\n" + ."\n" + .'如：'."\n" + ."\n" + .'```'."\n" + .'['."\n" + ."\n" + .' {'."\n" + ."\n" + .' "Field":"Name",'."\n" + ."\n" + .' "Type":"Asc"'."\n" + ."\n" + .' }'."\n" + ."\n" + .']'."\n" + .'```'."\n" + ."\n" + .'其中Field表示需要排序的字段名，目前仅支持对"Name" 字段排序。'."\n" + .'Type表示排序类型 Desc为降序，Asc为升序'."\n" + ."\n" + .'均不区分大小写。', 'type' => 'string', 'required' => false, 'example' => '[ { "Field":"Name", "Type":"Asc" } ]'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）。'."\n" + .'- **50**。'."\n" + .'- **100**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '10', 'example' => '30', 'default' => '30'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码，取值为大于0且不超过integer数据类型的最大值。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1', 'default' => '1'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL支持的地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hongkong'], + ], + [ + 'name' => 'Lang', + 'in' => 'query', + 'schema' => ['description' => '设置建议的显示语言，取值说明：'."\n" + .'- **zh（默认值）**：简体中文。'."\n" + .'- **en**：英文。'."\n" + .'- **ja**：日文。'."\n" + .'- **zh-tw**：繁体中文。', 'type' => 'string', 'required' => false, 'example' => 'zh', 'default' => 'zh'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '结构体', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Data' => [ - 'description' => '返回数据。', + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '15'], + 'PageSize' => ['description' => '总页数。', 'type' => 'string', 'example' => '30'], + 'RequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'PageNumber' => ['description' => '页码，取值为大于0且不超过integer数据类型的最大值。', 'type' => 'string', 'example' => '1'], + 'Items' => [ + 'description' => '表列表。', 'type' => 'object', 'properties' => [ - 'AppId' => [ - 'description' => '应用ID。', - 'type' => 'string', - 'example' => 's202302051515shfa865f8000****', - ], - 'AttemptId' => [ - 'description' => 'Spark应用的重试ID。', - 'type' => 'string', - 'example' => 's202301061000hz57d797b0000201-****', - ], - 'Finished' => [ - 'description' => '解析是否结束：'."\n" - .'- **true**：已结束。'."\n" - .'- **false**：未结束。', - 'type' => 'boolean', - 'example' => 'True', - ], - 'EventLogPath' => [ - 'description' => 'Event日志路径。', - 'type' => 'string', - 'example' => 'oss://path/to/eventLog', - ], - 'ScanMetrics' => [ - 'description' => '指标数据。', - 'type' => 'object', - 'properties' => [ - 'OutputRowsCount' => [ - 'description' => '扫描行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1000', - ], - 'TotalReadFileSizeInByte' => [ - 'description' => '扫描字节大小。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10000', + 'Table' => [ + 'description' => '表列表。', + 'type' => 'array', + 'items' => [ + 'description' => '表列表信息。', + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => '倾斜表检测类型。', 'type' => 'string', 'example' => 'Fact'], + 'Schema' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'spark_test'], + 'Size' => ['description' => '表大小，行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'], + 'Name' => ['description' => '表名。', 'type' => 'string', 'example' => 'admin_daily_own_statistic_record'], + 'IsIncline' => ['description' => '是否倾斜。', 'type' => 'boolean', 'example' => 'True'], + 'TotalSize' => ['description' => '总数据量，单位：Byte。'."\n" + ."\n" + .'> 总数据量的计算，以下2个公式都成立。'."\n" + ."\n" + .'- 公式1：'."\n" + .'总数据量= 热数据量 + 冷数据量。'."\n" + ."\n" + .'- 公式2：总数据量 = 表记录数据量 + 普通索引数据量 + 主键索引数据量 + 其他。', 'type' => 'integer', 'format' => 'int64', 'example' => '53687091200'], + 'SpaceRatio' => ['description' => '表空间占比，单位：%。'."\n" + ."\n" + .'> 计算公式为：表空间占比 = (表总数据量 / 实例总数据量) * 100。', 'type' => 'number', 'format' => 'double', 'example' => '0.4'], + 'RowCount' => ['description' => '表行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'], ], ], ], ], ], + 'DetectionItems' => [ + 'description' => '检测项及检测结果列表。', + 'type' => 'array', + 'items' => [ + 'description' => '具体检测结果。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '检测项名字。', 'type' => 'string', 'example' => 'Table skew'], + 'Message' => ['description' => '检测结果消息。', 'type' => 'string', 'example' => 'A shard skew is detected in a table.'], + 'Status' => ['description' => '检测结果状态。', 'type' => 'string', 'example' => 'NORMAL'."\n" + .'WARNNING'."\n" + .'CRITICAL'], + ], + ], + ], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', - 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.FailedToKill', - 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', - 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.KillOperationFailed', - 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.CancelNotebookStatementFailed', - 'errorMessage' => 'Failed to cancel the execution of notebook statements.', - ], - [ - 'errorCode' => 'Spark.CloseNotebookKernelFailed', - 'errorMessage' => 'Failed to disable the notebook kernel.', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.ExecuteNotebookStatementFailed', - 'errorMessage' => 'Failed to execute notebook statements.', - ], - [ - 'errorCode' => 'Spark.GetNotebookKernelFailed', - 'errorMessage' => 'Failed to start the notebook kernel. Try again later.', - ], - [ - 'errorCode' => 'Spark.GetNotebookKernelStateFailed', - 'errorMessage' => 'Failed to obtain the status of the notebook kernel.', - ], - [ - 'errorCode' => 'Spark.GetNotebookStatementLogFailed', - 'errorMessage' => 'Failed to obtain notebook statement logs.', - ], - [ - 'errorCode' => 'Spark.GetNotebookStatementResultFailed', - 'errorMessage' => 'Failed to obtain notebook statement execution results.', - ], - [ - 'errorCode' => 'Spark.GetNotebookStatementUiFailed', - 'errorMessage' => 'Failed to obtain notebook statement UI.', - ], - [ - 'errorCode' => 'Spark.Log.IllegalPath', - 'errorMessage' => 'Invalid job log URI: %s.', - ], - [ - 'errorCode' => 'Spark.Log.InvalidState', - 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', - ], - [ - 'errorCode' => 'Spark.NotebookKernelBusy', - 'errorMessage' => 'Too many jobs in the notebook kernel. Try again later.', - ], - [ - 'errorCode' => 'Spark.NotebookKernelExpired', - 'errorMessage' => 'The notebook kernel has expired. Restart the kernel.', - ], - [ - 'errorCode' => 'Spark.NotebookKernelInvalidStatus', - 'errorMessage' => 'The status of the notebook kernel is invalid.', - ], - [ - 'errorCode' => 'Spark.NotebookKernelNotStartup', - 'errorMessage' => 'The notebook kernel has not been started', - ], - [ - 'errorCode' => 'Spark.NotebookKernelStarting', - 'errorMessage' => 'The notebook kernel is starting. Try again later.', - ], - [ - 'errorCode' => 'Spark.NotebookNamingDuplicate', - 'errorMessage' => 'The name of the notebook is duplicated, please change the name', - ], - [ - 'errorCode' => 'Spark.NotebookNotFound', - 'errorMessage' => 'The notebook is not found', - ], - [ - 'errorCode' => 'Spark.NotebookParagraphMissingProgramCode', - 'errorMessage' => 'The notebook paragraph program code is missing', - ], - [ - 'errorCode' => 'Spark.NotebookParagraphNotFound', - 'errorMessage' => 'The notebook paragraph is not found', - ], - [ - 'errorCode' => 'Spark.NotebookParagraphNotRunning', - 'errorMessage' => 'The notebook paragraph has not been running', - ], - [ - 'errorCode' => 'Spark.Oss.InternalError', - 'errorMessage' => 'An OSS internal error occurred: %s', - ], - [ - 'errorCode' => 'Spark.RoleArn.Invalid', - 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.BadFileType', - 'errorMessage' => 'The requested template %s is not a file.', - ], - ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查看表监控', + 'summary' => '查看集群表倾斜信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeInclinedTables'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.AnalyzeTask.NotFound', - 'errorMessage' => 'The requested analysis task %s is not found.', - ], - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.Log.PodLogNotFound', - 'errorMessage' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.TemplateNotFound', - 'errorMessage' => 'The template %s is not found.', - ], - ], - 406 => [ - [ - 'errorCode' => 'Spark.App.KillNotAcceptable', - 'errorMessage' => 'Can\'t kill the application %s in %s state.', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], - [ - 'errorCode' => 'Spark.Resources.LoadFileFromClasspathFailed', - 'errorMessage' => 'Can\'t load the content from file: %s', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeInclinedTables', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202302051515shfa865f8000****\\",\\n \\"AttemptId\\": \\"s202301061000hz57d797b0000201-****\\",\\n \\"Finished\\": true,\\n \\"EventLogPath\\": \\"oss://path/to/eventLog\\",\\n \\"ScanMetrics\\": {\\n \\"OutputRowsCount\\": 1000,\\n \\"TotalReadFileSizeInByte\\": 10000\\n }\\n }\\n}","type":"json"}]', - 'title' => '查询Spark App指标数据', - 'description' => '- 在调用该接口前，必须先调用[PreloadSparkAppMetrics](~~612447~~)接口预加载Spark任务的指标数据，否则会调用失败。'."\n" - .'- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"15\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"Items\\": {\\n \\"Table\\": [\\n {\\n \\"Type\\": \\"Fact\\",\\n \\"Schema\\": \\"spark_test\\",\\n \\"Size\\": 200,\\n \\"Name\\": \\"admin_daily_own_statistic_record\\",\\n \\"IsIncline\\": true,\\n \\"TotalSize\\": 53687091200,\\n \\"SpaceRatio\\": 0.4,\\n \\"RowCount\\": 1000\\n }\\n ]\\n },\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"Table skew\\",\\n \\"Message\\": \\"A shard skew is detected in a table.\\",\\n \\"Status\\": \\"NORMAL\\\\nWARNNING\\\\nCRITICAL\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', ], - 'ListSparkLogAnalyzeTasks' => [ - 'summary' => '获取所有的Spark日志分析任务列表。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeJobResourceUsage' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -20192,337 +14488,293 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '173228', + 'abilityTreeNodes' => ['FEATUREadsCQJTKP'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'title' => '集群ID', - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-9scxs****', - ], + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'am-uf6g8w25jacm7****'], + ], + [ + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => ['description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', 'type' => 'string', 'required' => true, 'example' => '2023-02-04T03:45:00Z'], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => '查询结束时间，需要大于查询开始时间，格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', 'type' => 'string', 'required' => true, 'example' => '2023-03-17T16:00:00Z'], + ], + [ + 'name' => 'SparkAppName', + 'in' => 'query', + 'schema' => ['type' => 'string', 'required' => false], ], [ 'name' => 'PageNumber', - 'in' => 'formData', - 'schema' => [ - 'title' => '页码号', - 'description' => '页码号。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'minimum' => '1', - 'example' => '1', - ], + 'in' => 'query', + 'schema' => ['description' => '页码，取值为正整数。默认值为**1**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], ], [ 'name' => 'PageSize', - 'in' => 'formData', - 'schema' => [ - 'title' => '每页数量', - 'description' => '每页返回分析任务数量。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'maximum' => '100', - 'minimum' => '1', - 'example' => '20', - 'default' => '10', - ], + 'in' => 'query', + 'schema' => ['description' => '每页记录数，取值：'."\n" + .'- 30'."\n" + .'- 50'."\n" + .'- 100'."\n" + ."\n" + .'默认值：30。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', + 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1DF5AF5B-C803-1861-A0FF-63666A557709', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], 'Data' => [ 'description' => '返回结果数据。', 'type' => 'object', 'properties' => [ - 'TaskList' => [ - 'title' => '分析任务列表', - 'description' => 'Spark日志分析任务列表。', + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-clusterxxx'], + 'StartTime' => ['description' => '开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。', 'type' => 'string', 'example' => '2023-05-22T16:00:00Z'], + 'EndTime' => ['description' => '结束时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。', 'type' => 'string', 'example' => '2023-05-23T16:00:00Z'."\n"], + 'JobAcuUsage' => [ + 'description' => 'Job型资源组ACU使用情况。', 'type' => 'array', 'items' => [ - 'description' => 'Spark日志分析任务详情列表。', - '$ref' => '#/components/schemas/SparkAnalyzeLogTask', + 'type' => 'object', + 'properties' => [ + 'JobId' => ['description' => '任务ID。', 'type' => 'string', 'example' => '1592'], + 'ResourceGroupName' => ['description' => 'Job型资源组名称。', 'type' => 'string', 'example' => 'job_default'], + 'JobStartTime' => ['description' => '任务开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。', 'type' => 'string', 'example' => '2023-05-22T16:00:00Z'."\n"], + 'JobEndTime' => ['description' => '任务结束时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。', 'type' => 'string', 'example' => '2023-05-23T16:00:00Z'], + 'AcuUsageDetail' => [ + 'description' => 'ACU资源使用情况。', + 'type' => 'object', + 'properties' => [ + 'TotalAcuNumber' => ['description' => '总ACU资源数。', 'type' => 'number', 'format' => 'float', 'example' => '32ACU'], + 'ReservedAcuNumber' => ['description' => '预留资源ACU数。', 'type' => 'number', 'format' => 'float', 'example' => '16ACU'], + 'ElasticAcuNumber' => ['description' => '弹性资源ACU数。', 'type' => 'number', 'format' => 'float', 'example' => '16ACU'], + 'SpotAcuNumber' => ['description' => '竞价实例资源ACU数。', 'type' => 'number', 'format' => 'float', 'example' => '16ACU'], + 'SpotAcuPercentage' => ['description' => '竞价实例资源占总弹性资源的比例。', 'type' => 'number', 'format' => 'float', 'example' => '0.9'], + ], + ], + 'UseCachePool' => ['description' => '是否使用热池。', 'type' => 'boolean', 'example' => 'false'], + 'SparkAppName' => ['type' => 'string'], + ], + 'description' => '', ], ], - 'PageNumber' => [ - 'title' => '页码号', - 'description' => '页码号。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'title' => '每页数量', - 'description' => '每页数量。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', - ], - 'TotalCount' => [ - 'title' => 'Task总数', - 'description' => '集群中Spark日志分析任务总数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '100'], ], ], ], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + 'title' => '查询任务型资源使用情况', + 'summary' => '获取作业资源使用统计。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2025-09-25T10:17:40.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2025-09-08T10:17:02.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2024-06-30T06:27:54.000Z', 'description' => '响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeJobResourceUsage'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeJobResourceUsage', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1DF5AF5B-C803-1861-A0FF-63666A557709\\",\\n \\"Data\\": {\\n \\"TaskList\\": [\\n {\\n \\"TaskId\\": 10,\\n \\"UserId\\": 0,\\n \\"SubmittedTimeInMillis\\": 1672123543000,\\n \\"TerminatedTimeInMillis\\": 1672123543000,\\n \\"TaskState\\": \\"WAITING\\",\\n \\"Result\\": {\\n \\"AppErrorCode\\": \\"EXCEEDED_QUOTA\\",\\n \\"AppErrorLog\\": \\"exception: xxxx\\",\\n \\"AppErrorAdvice\\": \\"\\"\\n },\\n \\"StartedTimeInMillis\\": 1672123543000,\\n \\"RuleMatched\\": true,\\n \\"TaskErrMsg\\": \\"Driver log not found\\",\\n \\"DBClusterId\\": \\"amv-adbxxxxx\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 20,\\n \\"TotalCount\\": 100\\n }\\n}","errorExample":""},{"type":"xml","example":"<ListSparkLogAnalyzeTasksResponse>\\n <RequestId>1DF5AF5B-C803-1861-A0FF-63666A557709</RequestId>\\n <Data>\\n <TaskList>\\n <TaskId>10</TaskId>\\n <SubmittedTimeInMillis>1672123543000</SubmittedTimeInMillis>\\n <TerminatedTimeInMillis>1672123543000</TerminatedTimeInMillis>\\n <TaskState>WAITING</TaskState>\\n <Result>\\n <AppErrorCode>EXCEEDED_QUOTA</AppErrorCode>\\n <AppErrorLog>exception: xxxx</AppErrorLog>\\n </Result>\\n <StartedTimeInMillis>1672123543000</StartedTimeInMillis>\\n <RuleMatched>true</RuleMatched>\\n <TaskErrMsg>Driver log not found</TaskErrMsg>\\n <DBClusterId>amv-adbxxxxx</DBClusterId>\\n </TaskList>\\n <PageNumber>1</PageNumber>\\n <PageSize>20</PageSize>\\n <TotalCount>100</TotalCount>\\n </Data>\\n</ListSparkLogAnalyzeTasksResponse>","errorExample":""}]', - 'title' => '查询Spark日志分析任务列表', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"DBClusterId\\": \\"amv-clusterxxx\\",\\n \\"StartTime\\": \\"2023-05-22T16:00:00Z\\",\\n \\"EndTime\\": \\"2023-05-23T16:00:00Z\\\\n\\",\\n \\"JobAcuUsage\\": [\\n {\\n \\"JobId\\": \\"1592\\",\\n \\"ResourceGroupName\\": \\"job_default\\",\\n \\"JobStartTime\\": \\"2023-05-22T16:00:00Z\\\\n\\",\\n \\"JobEndTime\\": \\"2023-05-23T16:00:00Z\\",\\n \\"AcuUsageDetail\\": {\\n \\"TotalAcuNumber\\": 0,\\n \\"ReservedAcuNumber\\": 0,\\n \\"ElasticAcuNumber\\": 0,\\n \\"SpotAcuNumber\\": 0,\\n \\"SpotAcuPercentage\\": 0.9\\n },\\n \\"UseCachePool\\": false,\\n \\"SparkAppName\\": \\"\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 100\\n }\\n}","type":"json"}]', ], - 'SubmitSparkLogAnalyzeTask' => [ - 'summary' => '提交一个Spark日志分析任务,，服务端会开启指定Spark作业日志的分析流程并返回分析结果。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeKernelVersion' => [ + 'summary' => '调用DescrbeKernelVersion接口查看目标集群的内核版本信息。', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '254101', + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], ], 'parameters' => [ [ - 'name' => 'AppId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'Spark App ID'."\n", - 'description' => 'Spark应用ID。'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 's202301121553hzd9c6f7xxxx', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> * 您可以调用[DescribeDBClusters](~~98094~~)接口查看目标地域下所有的集群信息，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-2ze918p6qf6h9****'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看可用地域的地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-shenzhen'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1DF5AF5B-C803-1861-A0FF-63666A557709', - ], - 'Data' => [ - 'description' => 'Spark日志分析任务详情。', - '$ref' => '#/components/schemas/SparkAnalyzeLogTask', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'KernelVersion' => ['description' => '集群内核版本号，例如：**3.1.8**。', 'type' => 'string', 'example' => '3.1.8'], + 'ExpireDate' => ['description' => '版本维护到期时间，时间格式为yyyy-MM-DD HH:mm:ss。超过此时间后，系统将不再维护该版本，若有问题，请升级到更高版本。', 'type' => 'string', 'example' => '2025-01-12T16:00:00Z'], + 'AvailableKernelVersions' => [ + 'description' => '当前版本支持升级到的目标版本列表。', + 'type' => 'array', + 'items' => [ + 'description' => '当前版本支持升级到的目标版本列表。', + 'type' => 'object', + 'properties' => [ + 'KernelVersion' => ['description' => '集群内核版本号，例如：**3.1.9**。', 'type' => 'string', 'example' => '3.1.9'], + 'ReleaseDate' => ['description' => '内核版本的发布时间。时间格式为yyyy-MM-DD HH:mm:ss。', 'type' => 'string', 'example' => '2024-07-17T16:00:00Z'."\n"], + 'ExpireDate' => ['description' => '版本维护到期时间，时间格式为yyyy-MM-DD HH:mm:ss。超过此时间后，系统将不再维护该版本，若有问题，请升级到更高版本。', 'type' => 'string', 'example' => '2025-07-17T16:00:00Z'], + ], + ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', - 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.FailedToKill', - 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', - 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - ], 404 => [ - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.NotFound', - 'errorMessage' => 'The requested analysis task %s is not found.', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], + ], + 'title' => '查询集群内核版本', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeKernelVersion'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeKernelVersion', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1DF5AF5B-C803-1861-A0FF-63666A557709\\",\\n \\"Data\\": {\\n \\"TaskId\\": 10,\\n \\"UserId\\": 0,\\n \\"SubmittedTimeInMillis\\": 1672123543000,\\n \\"TerminatedTimeInMillis\\": 1672123543000,\\n \\"TaskState\\": \\"WAITING\\",\\n \\"Result\\": {\\n \\"AppErrorCode\\": \\"EXCEEDED_QUOTA\\",\\n \\"AppErrorLog\\": \\"exception: xxxx\\",\\n \\"AppErrorAdvice\\": \\"\\"\\n },\\n \\"StartedTimeInMillis\\": 1672123543000,\\n \\"RuleMatched\\": true,\\n \\"TaskErrMsg\\": \\"Driver log not found\\",\\n \\"DBClusterId\\": \\"amv-adbxxxxx\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<SubmitSparkLogAnalyzeTaskResponse>\\n <RequestId>xxx-xxx-xxxx</RequestId>\\n <Data>\\n <TaskId>10</TaskId>\\n <SubmittedTimeInMillis>1672123543000</SubmittedTimeInMillis>\\n <TerminatedTimeInMillis>1672123543000</TerminatedTimeInMillis>\\n <TaskState>WAITING</TaskState>\\n <Result>\\n <AppErrorCode>EXCEEDED_QUOTA</AppErrorCode>\\n <AppErrorLog>exception: xxxx</AppErrorLog>\\n </Result>\\n <StartedTimeInMillis>1672123543000</StartedTimeInMillis>\\n <RuleMatched>true</RuleMatched>\\n <TaskErrMsg>Driver log not found</TaskErrMsg>\\n </Data>\\n</SubmitSparkLogAnalyzeTaskResponse>","errorExample":""}]', - 'title' => '提交Spark日志分析任务', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"KernelVersion\\": \\"3.1.8\\",\\n \\"ExpireDate\\": \\"2025-01-12T16:00:00Z\\",\\n \\"AvailableKernelVersions\\": [\\n {\\n \\"KernelVersion\\": \\"3.1.9\\",\\n \\"ReleaseDate\\": \\"2024-07-17T16:00:00Z\\\\n\\",\\n \\"ExpireDate\\": \\"2025-07-17T16:00:00Z\\"\\n }\\n ]\\n}","type":"json"}]', ], - 'KillSparkLogAnalyzeTask' => [ - 'summary' => '终止一个Spark分析任务，返回尝试终止后的任务详情。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeLakeCacheSize' => [ + 'summary' => '获取集群湖存储加速缓存空间大小。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', - 'riskType' => 'high', - 'chargeType' => 'free', + 'operationType' => 'get', + 'abilityTreeCode' => '214834', + 'abilityTreeNodes' => ['FEATUREadsCQJTKP'], ], 'parameters' => [ [ - 'name' => 'TaskId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'Spark日志分析任务ID'."\n", - 'description' => 'Spark日志分析任务ID。可以通过调用ListSparkLogAnalyzeTasks查询当前集群中所有的分析任务的ID和状态。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'minimum' => '0', - 'example' => '15', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看数仓版集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp10b6646l07akdt'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', + 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1DF5AF5B-C803-1861-A0FF-63666A557709', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Code' => ['description' => '状态码。说明 200表示成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], 'Data' => [ - 'description' => 'Spark日志分析任务详情。', - '$ref' => '#/components/schemas/SparkAnalyzeLogTask', + 'description' => '返回数据。', + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp10b6646l07akdt'."\n"], + 'EnableLakeCache' => ['description' => '是否开启湖存储加速', 'type' => 'boolean', 'example' => 'true'], + 'Instances' => [ + 'description' => '共享湖存储缓存空间的实例列表。', + 'type' => 'array', + 'items' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp10b6646l07akdt'."\n"], + ], + 'Capacity' => ['description' => '湖存储加速缓存空间大小，单位为GB', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'DataSize' => ['description' => '湖存储缓存空间已经使用的容量大小，单位为GB', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + ], ], ], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + 'title' => '查询湖存储缓存空间设置', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeLakeCacheSize'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeLakeCacheSize', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1DF5AF5B-C803-1861-A0FF-63666A557709\\",\\n \\"Data\\": {\\n \\"TaskId\\": 10,\\n \\"UserId\\": 0,\\n \\"SubmittedTimeInMillis\\": 1672123543000,\\n \\"TerminatedTimeInMillis\\": 1672123543000,\\n \\"TaskState\\": \\"WAITING\\",\\n \\"Result\\": {\\n \\"AppErrorCode\\": \\"EXCEEDED_QUOTA\\",\\n \\"AppErrorLog\\": \\"exception: xxxx\\",\\n \\"AppErrorAdvice\\": \\"\\"\\n },\\n \\"StartedTimeInMillis\\": 1672123543000,\\n \\"RuleMatched\\": true,\\n \\"TaskErrMsg\\": \\"Driver log not found\\",\\n \\"DBClusterId\\": \\"amv-adbxxxxx\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<KillSparkLogAnalyzeTaskResponse>\\n <RequestId>1DF5AF5B-C803-1861-A0FF-63666A557709</RequestId>\\n <Data>\\n <TaskId>10</TaskId>\\n <SubmittedTimeInMillis>1672123543000</SubmittedTimeInMillis>\\n <TerminatedTimeInMillis>1672123543000</TerminatedTimeInMillis>\\n <TaskState>WAITING</TaskState>\\n <Result>\\n <AppErrorCode>EXCEEDED_QUOTA</AppErrorCode>\\n <AppErrorLog>exception: xxxx</AppErrorLog>\\n </Result>\\n <StartedTimeInMillis>1672123543000</StartedTimeInMillis>\\n <RuleMatched>true</RuleMatched>\\n <TaskErrMsg>Driver log not found</TaskErrMsg>\\n <DBClusterId>amv-adbxxxxx</DBClusterId>\\n </Data>\\n</KillSparkLogAnalyzeTaskResponse>","errorExample":""}]', - 'title' => '终止Spark日志分析任务', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"DBClusterId\\": \\"amv-bp10b6646l07akdt\\\\n\\",\\n \\"EnableLakeCache\\": true,\\n \\"Instances\\": [\\n \\"amv-bp10b6646l07akdt\\\\n\\"\\n ],\\n \\"Capacity\\": 100,\\n \\"DataSize\\": 100\\n }\\n}","type":"json"}]', ], - 'GetSparkLogAnalyzeTask' => [ - 'summary' => '获取Spark日志分析任务结果。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeMVRecommendResults' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -20534,177 +14786,85 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ - 'name' => 'TaskId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'Spark日志分析任务ID'."\n", - 'description' => 'Spark日志分析任务ID。调用接口ListSparkLogAnalyzeTasks可以查询当前ADB集群中提交的所有Spark日志分析任务ID。'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'minimum' => '0', - 'example' => '12', - ], + 'name' => 'SubtaskId', + 'in' => 'query', + 'schema' => ['description' => '子任务ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '123'], ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1DF5AF5B-C803-1861-A0FF-63666A557709', - ], - 'Data' => [ - 'description' => 'Spark日志分析任务详情。', - '$ref' => '#/components/schemas/SparkAnalyzeLogTask', - ], - ], - ], + [ + 'name' => 'TaskName', + 'in' => 'query', + 'schema' => ['description' => '推荐任务名称。', 'type' => 'string', 'required' => false, 'example' => 'task_n1'], ], - ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], + [ + 'name' => 'SubQueryId', + 'in' => 'query', + 'schema' => ['description' => '子查询ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '123'], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '本页记录数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30'], ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1DF5AF5B-C803-1861-A0FF-63666A557709\\",\\n \\"Data\\": {\\n \\"TaskId\\": 10,\\n \\"UserId\\": 0,\\n \\"SubmittedTimeInMillis\\": 1672123543000,\\n \\"TerminatedTimeInMillis\\": 1672123543000,\\n \\"TaskState\\": \\"WAITING\\",\\n \\"Result\\": {\\n \\"AppErrorCode\\": \\"EXCEEDED_QUOTA\\",\\n \\"AppErrorLog\\": \\"exception: xxxx\\",\\n \\"AppErrorAdvice\\": \\"\\"\\n },\\n \\"StartedTimeInMillis\\": 1672123543000,\\n \\"RuleMatched\\": true,\\n \\"TaskErrMsg\\": \\"Driver log not found\\",\\n \\"DBClusterId\\": \\"amv-adbxxxxx\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkLogAnalyzeTaskResponse>\\n <RequestId>1DF5AF5B-C803-1861-A0FF-63666A557709</RequestId>\\n <Data>\\n <TaskId>10</TaskId>\\n <SubmittedTimeInMillis>1672123543000</SubmittedTimeInMillis>\\n <TerminatedTimeInMillis>1672123543000</TerminatedTimeInMillis>\\n <TaskState>WAITING</TaskState>\\n <Result>\\n <AppErrorCode>EXCEEDED_QUOTA</AppErrorCode>\\n <AppErrorLog>exception: xxxx</AppErrorLog>\\n </Result>\\n <StartedTimeInMillis>1672123543000</StartedTimeInMillis>\\n <RuleMatched>true</RuleMatched>\\n <TaskErrMsg>Driver log not found</TaskErrMsg>\\n <DBClusterId>amv-adbxxxxx</DBClusterId>\\n </Data>\\n</GetSparkLogAnalyzeTaskResponse>","errorExample":""}]', - 'title' => '查询Spark日志分析任务结果', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', - ], - 'SetSparkAppLogRootPath' => [ - 'summary' => '更改用户Spark的日志配置。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ [ - 'AK' => [], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => false, 'example' => 'am-bp1ub9grke1****'], ], - ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '156583', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], - ], - 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'title' => '数据库的id', - 'description' => 'AnalyticDB for MySQL集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp169ea59k****', - 'maxLength' => 64, - ], + 'name' => 'From', + 'in' => 'query', + 'schema' => ['description' => '固定值，不支持修改。', 'type' => 'string', 'required' => false, 'example' => 'Modification is not supported.'], ], [ - 'name' => 'OssLogPath', - 'in' => 'formData', - 'schema' => [ - 'description' => 'OSS日志地址。', - 'type' => 'string', - 'required' => false, - 'example' => 'oss://testBucketname/to/log', - ], + 'name' => 'ActionInner', + 'in' => 'query', + 'schema' => ['description' => '固定值，不支持修改。', 'type' => 'string', 'required' => false, 'example' => 'Modification is not supported.'], ], [ - 'name' => 'UseDefaultOss', - 'in' => 'formData', - 'schema' => [ - 'description' => '是否使用默认生成的OSS地址。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], + 'name' => 'OrderBy', + 'in' => 'query', + 'schema' => ['description' => '排序字段。', 'type' => 'string', 'required' => false, 'example' => '{"Type": "Desc","Field": "AcceleratedQueriesCount"}'], ], ], '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' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], 'Data' => [ - 'description' => '返回数据体。', + 'description' => '返回数据。', 'type' => 'object', 'properties' => [ - 'IsLogPathExists' => [ - 'title' => '是否存在日志地址', - 'description' => '是否存在日志地址。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RecordedLogPath' => [ - 'title' => '记录的地址名称', - 'description' => '记录的地址名称。', - 'type' => 'string', - 'example' => 'oss://testBucketname/to/log', - ], - 'ModifiedUid' => [ - 'title' => '修改者ID', - 'description' => '修改者ID。', - 'type' => 'string', - 'example' => '11111111', - ], - 'ModifiedTimestamp' => [ - 'title' => '上一次修改时间', - 'description' => '上一次修改时间。', - 'type' => 'string', - 'example' => '1675236908', - ], - 'DefaultLogPath' => [ - 'title' => '推荐的默认地址', - 'description' => '推荐的默认地址。', - 'type' => 'string', - 'example' => 'oss://testBucketname/to/log', + 'PageNumber' => ['description' => '页码。默认值为**1**。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数，取值范围如下：'."\n" + .'* **30**（默认值）。'."\n" + .'* **50**。'."\n" + .'* **100**。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'MvRecommendResultModels' => [ + 'description' => '物化视图推荐结果列表', + 'type' => 'array', + 'items' => ['description' => '推荐结果详情', '$ref' => '#/components/schemas/open_struct_MVRecommendResultModel'], ], ], ], @@ -20714,99 +14874,50 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', - 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.FailedToKill', - 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', - 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Log.InvalidState', - 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s.', - ], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], ], - 404 => [ - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.NotFound', - 'errorMessage' => 'The requested analysis task %s is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.TemplateNotFound', - 'errorMessage' => 'The template %s is not found.', - ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], ], 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"IsLogPathExists\\": true,\\n \\"RecordedLogPath\\": \\"oss://testBucketname/to/log\\",\\n \\"ModifiedUid\\": \\"11111111\\",\\n \\"ModifiedTimestamp\\": \\"1675236908\\",\\n \\"DefaultLogPath\\": \\"oss://testBucketname/to/log\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<SetSparkAppLogRootPathResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <IsLogPathExists>true</IsLogPathExists>\\n <RecordedLogPath>oss://path/to/log</RecordedLogPath>\\n <ModifiedUid>1111111</ModifiedUid>\\n <ModifiedTimestamp>1675236908</ModifiedTimestamp>\\n <DefaultLogPath>oss://path/to/log</DefaultLogPath>\\n </Data>\\n</SetSparkAppLogRootPathResponse>","errorExample":""}]', - 'title' => '更改用户Spark的日志配置', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', - ], - 'GetSparkConfigLogPath' => [ - 'summary' => '查询AnalyticDB MySQL Spark中的日志配置结果，包括默认的Spark日志写入地址。', - 'methods' => [ - 'post', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询物化视图推荐结果列表', + 'summary' => '查询物化视图推荐任务结果。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeMVRecommendResults'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeMVRecommendResults', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 20,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 20,\\n \\"TotalCount\\": 1,\\n \\"MvRecommendResultModels\\": [\\n {\\n \\"BaseTables\\": [\\n {\\n \\"TableName\\": \\"test\\",\\n \\"DataVolumn\\": \\"321233\\",\\n \\"EnableBinlog\\": true,\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ],\\n \\"AcceleratedQueriesCount\\": 32,\\n \\"SupportIncrementalRefresh\\": true,\\n \\"SubqueryId\\": 1,\\n \\"SavedScanbytes\\": 321321223,\\n \\"Subquery\\": \\"SELECT * FROM demo.tbl\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeMvRecommendSubTasks' => [ + 'summary' => '查看物化视图子任务', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -20818,70 +14929,84 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '156541', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ + 'name' => 'TaskName', + 'in' => 'query', + 'schema' => ['description' => '物化视图推荐任务的名称。', 'type' => 'string', 'required' => false, 'example' => 'my_task_1'], + ], + [ + 'name' => 'SubtaskId', + 'in' => 'query', + 'schema' => ['description' => '子任务ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '123'], + ], + [ + 'name' => 'OrderBy', + 'in' => 'query', + 'schema' => ['description' => '排序字段。'."\n" + .'类型取值：'."\n" + .'- Asc；'."\n" + .'- Desc；'."\n" + ."\n" + .'域取值：'."\n" + .'- StartTime;'."\n" + .'- EndTime;', 'type' => 'string', 'required' => false, 'example' => '{\\"Type\\": \\"ASC\\", \\"Field\\": \\"StartTime\\"}'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '本页记录数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30'], + ], + [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'title' => '数据库的id', - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp19lm077co*****', - 'maxLength' => 64, - ], + 'in' => 'query', + 'schema' => ['description' => '集群 ID。', 'type' => 'string', 'required' => false, 'example' => 'am-bp1ub9grke1****'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域 ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'From', + 'in' => 'query', + 'schema' => ['description' => '固定值，不支持修改。', 'type' => 'string', 'required' => false, 'example' => 'Modification is not supported.'], + ], + [ + 'name' => 'ActionInner', + 'in' => 'query', + 'schema' => ['description' => '固定值，不支持修改。', 'type' => 'string', 'required' => false, 'example' => 'Modification is not supported.'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1919-xxx-ssdfsdff', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录条数。', 'type' => 'integer', 'format' => 'int64', 'example' => '4'], 'Data' => [ - 'description' => '返回内容。', + 'description' => '返回数据。', 'type' => 'object', 'properties' => [ - 'IsLogPathExists' => [ - 'title' => '是否存在日志地址', - 'description' => '是否存在日志地址。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RecordedLogPath' => [ - 'title' => '记录的地址名称', - 'description' => '记录的地址名称。', - 'type' => 'string', - 'example' => 'oss://test/spark-logs/', - ], - 'ModifiedUid' => [ - 'title' => '修改者ID', - 'description' => '修改人的账号ID。', - 'type' => 'string', - 'example' => '10130223128xxx', - ], - 'ModifiedTimestamp' => [ - 'title' => '上一次修改时间', - 'description' => '上一次修改时间。', - 'type' => 'string', - 'example' => '1675654361000', - ], - 'DefaultLogPath' => [ - 'title' => '推荐的默认地址', - 'description' => '推荐的默认地址。', - 'type' => 'string', - 'example' => 'oss://aliyun-oa-adb-spark-****-oss-cn-hanghzou/spark-logs', + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录条数。', 'type' => 'integer', 'format' => 'int64', 'example' => '4'], + 'MvRecommendSubTaskModels' => [ + 'description' => '物化视图推荐任务执行列表。', + 'type' => 'array', + 'items' => ['description' => '物化视图推荐任务执行详情。', '$ref' => '#/components/schemas/open_struct_MvRecommendSubTaskModel'], ], ], ], @@ -20891,223 +15016,119 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidAppFilePath', - 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidDiskConfig', - 'errorMessage' => 'The requested disk mount parameter is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidHostAliasConfig', - 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', - ], - [ - 'errorCode' => 'Spark.Config.InvalidLogOssPath', - 'errorMessage' => 'The OSS address for log storage is illegal: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidRoleArnFormat', - 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', - ], - [ - 'errorCode' => 'Spark.Config.InvalidTimeZone', - 'errorMessage' => 'Unable to parse time zone configuration %s : %s', - ], - [ - 'errorCode' => 'Spark.Config.MainAppFileNotExists', - 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathAccessError', - 'errorMessage' => 'The configured OSS address %s cannot be accessed.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathNotExists', - 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Config.SecurityGroupNotFound', - 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.Config.VswitchNotFound', - 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', - ], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], ], 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], ], 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1919-xxx-ssdfsdff\\",\\n \\"Data\\": {\\n \\"IsLogPathExists\\": true,\\n \\"RecordedLogPath\\": \\"oss://test/spark-logs/\\",\\n \\"ModifiedUid\\": \\"10130223128xxx\\",\\n \\"ModifiedTimestamp\\": \\"1675654361000\\",\\n \\"DefaultLogPath\\": \\"oss://aliyun-oa-adb-spark-****-oss-cn-hanghzou/spark-logs\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkConfigLogPathResponse>\\n <RequestId>1919-xxx-ssdfsdff</RequestId>\\n <Data>\\n <IsLogPathExists>true</IsLogPathExists>\\n <RecordedLogPath>oss://test/spark-logs/</RecordedLogPath>\\n <ModifiedUid>10130223128xxx</ModifiedUid>\\n <ModifiedTimestamp>1675654361000</ModifiedTimestamp>\\n <DefaultLogPath>oss://aliyun-oa-adb-spark-1111-oss-cn-hanghzou/spark-logs</DefaultLogPath>\\n </Data>\\n</GetSparkConfigLogPathResponse>","errorExample":""}]', - 'title' => '获取Spark日志配置路径', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', - ], - 'StartSparkSQLEngine' => [ - 'summary' => '启动Spark SQL引擎。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询物化视图推荐任务执行列表', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeMvRecommendSubTasks'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeMvRecommendSubTasks', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 4,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 4,\\n \\"MvRecommendSubTaskModels\\": [\\n {\\n \\"SubQueriesCount\\": 70,\\n \\"Status\\": \\"RUNNING\\",\\n \\"EndTime\\": \\"2025-10-16 16:56\\\\n\\",\\n \\"StartTime\\": \\"2025-10-16 16:55\\\\n\\",\\n \\"SubtaskId\\": 123,\\n \\"ScanQueriesCount\\": 55,\\n \\"MinRewriteQueryCount\\": 3,\\n \\"MinRewriteQueryPattern\\": 5,\\n \\"SlowQueryThreshold\\": 2\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeMvRecommendTasks' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => true, + 'operationType' => 'read', + 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'get', 'riskType' => 'none', - 'chargeType' => 'paid', - 'abilityTreeCode' => '152577', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-abcd****', - ], + 'name' => 'TaskName', + 'in' => 'query', + 'schema' => ['description' => '物化视图推荐任务的名称。', 'type' => 'string', 'required' => false, 'example' => 'my_task_1'], ], [ - 'name' => 'ResourceGroupName', - 'in' => 'formData', - 'schema' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'spark-rg-name', - ], + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], ], [ - 'name' => 'MinExecutor', - 'in' => 'formData', - 'schema' => [ - 'description' => '执行SQL时拉起的最小Exectuor数量，配置为0意味着当不需要执行SQL时不会常驻Exectuor。取值范围为0到2000，当配置数量超过资源组承载总量时会导致服务启动失败。此处配置值必须小于MaxExecutor的配置值。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - 'default' => '0', - ], + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30'], ], [ - 'name' => 'MaxExecutor', - 'in' => 'formData', - 'schema' => [ - 'description' => '执行SQL时启动的最大的Exector数量。取值范围为1到2000，当配置数量超过资源组承载总量时会导致服务启动失败。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '10', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'Jars', - 'in' => 'formData', - 'schema' => [ - 'description' => '启动SQL引擎时需要引入的第三方JAR包列表，以逗号分隔的JAR包所在的OSS地址。', - 'type' => 'string', - 'required' => false, - 'example' => 'oss://testBuckname/test.jar,oss://testBuckname/test2.jar', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'SlotNum', - 'in' => 'formData', - 'schema' => [ - 'description' => '最大槽位数，即最多可以维持多少个Spark Session来执行SQL。取值范围为1到500。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '100', - 'default' => '50', - ], + 'name' => 'From', + 'in' => 'query', + 'schema' => ['description' => '固定值，不支持修改。', 'type' => 'string', 'required' => false, 'example' => 'Modification is not supported.'], ], [ - 'name' => 'Config', - 'in' => 'formData', - 'schema' => [ - 'description' => '启动Spark SQL Engine的具体配置，以一个JSON来描述KEY-VALUE型配置信息。详情请参见[Spark Conf配置](~~471203~~)。', - 'type' => 'string', - 'required' => false, - 'example' => '{ "spark.shuffle.timeout": ":0s" }', - ], + 'name' => 'ActionInner', + 'in' => 'query', + 'schema' => ['description' => '固定值，不支持修改。', 'type' => 'string', 'required' => false, 'example' => 'Modification is not supported.'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '4'], 'Data' => [ - 'description' => '返回结果。', + 'description' => '返回数据。', 'type' => 'object', 'properties' => [ - 'AppId' => [ - 'description' => 'Spark作业ID。', - 'type' => 'string', - 'example' => 's202301xxxx', - ], - 'State' => [ - 'description' => 'Spark SQL Engine状态：'."\n" - ."\n" - .'- SUBMITTED：提交启动请求。'."\n" - .'- STARTING：启动中。'."\n" - .'- RUNNING：运行中，可以执行SQL。'."\n" - .'- FAILED：引擎出错退出。', - 'type' => 'string', - 'example' => 'SUBMITTED', - ], - 'AppName' => [ - 'description' => 'Spark App名称。', - 'type' => 'string', - 'example' => 'SQLEngine1', + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '4'], + 'MvRecommendTaskModels' => [ + 'description' => '物化视图推荐任务列表。', + 'type' => 'array', + 'items' => ['description' => '物化视图推荐任务详情。', '$ref' => '#/components/schemas/open_struct_MvRecommendTaskModel'], ], ], ], @@ -21117,516 +15138,334 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.App.ExceedQuotaLimitation', - 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', - ], - [ - 'errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', - 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ResourceNegativeError', - 'errorMessage' => 'The requested resource MUST be positive: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidAppFilePath', - 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidDiskConfig', - 'errorMessage' => 'The requested disk mount parameter is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidHostAliasConfig', - 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', - ], - [ - 'errorCode' => 'Spark.Config.InvalidLogOssPath', - 'errorMessage' => 'The OSS address for log storage is illegal: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidRoleArnFormat', - 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', - ], - [ - 'errorCode' => 'Spark.Config.InvalidTimeZone', - 'errorMessage' => 'Unable to parse time zone configuration %s : %s', - ], - [ - 'errorCode' => 'Spark.Config.MainAppFileNotExists', - 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathAccessError', - 'errorMessage' => 'The configured OSS address %s cannot be accessed.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathNotExists', - 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Config.SecurityGroupNotFound', - 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.Config.VswitchNotFound', - 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.Log.InvalidState', - 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', - ], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], ], 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], - ], - [ - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.App.NotFound', - 'errorMessage' => 'The Spark application %s is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], ], 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'staticInfo' => [ - 'noSubstitutionReason' => '无替代API，历史原因导致该API被标记为弃用。', - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202301xxxx\\",\\n \\"State\\": \\"SUBMITTED\\",\\n \\"AppName\\": \\"SQLEngine1\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<StartSparkSQLEngineResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <AppId>s202301xxxx</AppId>\\n <State>SUBMITTED</State>\\n <AppName>SQLEngine1</AppName>\\n </Data>\\n</StartSparkSQLEngineResponse>","errorExample":""}]', - 'title' => '启动Spark SQL引擎', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', - ], - 'KillSparkSQLEngine' => [ - 'summary' => '关闭Spark SQL引擎。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询物化视图推荐任务列表', + 'summary' => '查看物化视图推荐任务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeMvRecommendTasks'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeMvRecommendTasks', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 4,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 4,\\n \\"MvRecommendTaskModels\\": [\\n {\\n \\"Description\\": \\"task desc\\\\n\\",\\n \\"CreatedTime\\": \\"2024-12-12 23:59\\",\\n \\"LastRunAt\\": \\"2024-12-13 00:10\\",\\n \\"TaskName\\": \\"mv_task1\\",\\n \\"ScanQueriesRange\\": 3,\\n \\"SchedulingSettings\\": \\"The 12:30 every day\\",\\n \\"MinRewriteQueryCount\\": 3,\\n \\"MinRewriteQueryPattern\\": 5,\\n \\"SlowQueryThreshold\\": 2\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeOperatorPermission' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => true, + 'operationType' => 'read', + 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '152585', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '214554', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-8vbn8pq537k8w****', - ], - ], - [ - 'name' => 'ResourceGroupName', - 'in' => 'formData', - 'schema' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'spark_test', - ], + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-uf6wjk5xxxxxxxxxx'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380', - ], - 'Data' => [ - 'description' => '是否成功。', - 'type' => 'boolean', - 'example' => 'true', - ], + 'CreatedTime' => ['description' => '创建时间。', 'type' => 'string', 'example' => '2024-02-25T03:35:02Z'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Privileges' => ['description' => '授权详情。', 'type' => 'string', 'example' => 'Control,Data'], + 'ExpiredTime' => ['description' => '授权过期时间。', 'type' => 'string', 'example' => '2024-01-10T02:19:00Z'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-uf6wjk5xxxxxxxxxx'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.App.KillOperationFailed', - 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', - ], - ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + 'title' => '查询服务账号授权情况', + 'summary' => '查询服务账号授权情况。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeOperatorPermission'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - ], - 406 => [ - [ - 'errorCode' => 'Spark.App.KillNotAcceptable', - 'errorMessage' => 'Can\'t kill the application %s in %s state.', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeOperatorPermission', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}'], + ], ], ], ], - 'staticInfo' => [ - 'noSubstitutionReason' => '无替代API，历史原因导致该API被标记为弃用。', - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": true\\n}","errorExample":""},{"type":"xml","example":"<KillSparkSQLEngineResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>false</Data>\\n</KillSparkSQLEngineResponse>","errorExample":""}]', - 'title' => '关闭Spark SQL引擎', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"CreatedTime\\": \\"2024-02-25T03:35:02Z\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Privileges\\": \\"Control,Data\\",\\n \\"ExpiredTime\\": \\"2024-01-10T02:19:00Z\\",\\n \\"DBClusterId\\": \\"amv-uf6wjk5xxxxxxxxxx\\"\\n}","type":"json"}]', ], - 'GetSparkSQLEngineState' => [ - 'summary' => '查询Spark SQL引擎的状态。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeOversizeNonPartitionTableInfos' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => true, + 'operationType' => 'read', + 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '152586', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], + 'abilityTreeCode' => '217358', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'in' => 'query', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'ResourceGroupName', - 'in' => 'formData', - 'schema' => [ - 'description' => 'Job型资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test_instance', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => ['description' => '查询开始时间，UTC时间，格式为：yyyy-MM-ddTHH:mmZ。'."\n" + .'> 仅当SQL审计状态为开启时，才能查询到SQL审计日志，且只支持查询30天内的SQL审计日志。如果中途关闭了SQL审计，再次打开时，仅能查询到再次打开后的SQL审计日志。'."\n", 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2024-05-11T05:44Z'], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => '查询结束时间，格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。'."\n" + .'> 查询结束时间需晚于查询开始时间，且与查询开始时间间隔小于7天。'."\n", 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2024-05-11T05:44Z'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数，取值：'."\n" + ."\n" + .'- 30；'."\n" + .'- 50；'."\n" + .'- 100'."\n" + ."\n" + .'默认值：30。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '30', 'example' => '30', 'default' => '30'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码，取值为大于0且不超过Integer的最大值。默认值为**1**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1'], + ], + [ + 'name' => 'Lang', + 'in' => 'query', + 'schema' => ['description' => '设置下载文件的文件标题以及部分错误信息的语言，支持如下语言：'."\n" + .'- **zh（默认值）**：简体中文。'."\n" + .'- **en**：英文。'."\n" + .'- **ja**：日语。'."\n" + .'- **zh-tw**：繁体中文。', 'type' => 'string', 'required' => false, 'example' => 'zh'], + ], + [ + 'name' => 'Order', + 'in' => 'query', + 'schema' => ['description' => '按指定字段排序，json格式：JSON数组，有序，按顺序输入排列字段和升降序类型：'."\n" + ."\n" + .'如：'."\n" + ."\n" + .'```'."\n" + .'['."\n" + ."\n" + .' {'."\n" + ."\n" + .' "Field":"Name",'."\n" + ."\n" + .' "Type":"Asc"'."\n" + ."\n" + .' }'."\n" + ."\n" + .']'."\n" + .'```'."\n" + ."\n" + .'其中Field表示需要排序的字段名，目前仅支持对"Name" 字段排序。'."\n" + .'Type表示排序类型 Desc为降序，Asc为升序'."\n" + ."\n" + .'均不区分大小写。', 'type' => 'string', 'required' => false, 'example' => '[{"Field":"SchemaName","Type":"Asc"}]'], ], ], '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' => 'xxxx-xxx-xx', - ], - 'Data' => [ - 'description' => 'Spark SQL 引擎状态详情。', - 'type' => 'object', - 'properties' => [ - 'AppId' => [ - 'description' => '应用ID。', - 'type' => 'string', - 'example' => 's202207151211hz0c****', - ], - 'MinExecutor' => [ - 'description' => 'Spark Executor 最小启动量。', - 'type' => 'string', - 'example' => '1', - ], - 'MaxExecutor' => [ - 'description' => 'Spark Executor 最大启动量。', - 'type' => 'string', - 'example' => '3', - ], - 'Jars' => [ - 'description' => '第三方JAR包。', - 'type' => 'string', - 'example' => 'oss://test-bucket/test.jar', - ], - 'SlotNum' => [ - 'description' => 'Spark 应用槽位值。', - 'type' => 'string', - 'example' => '2', - ], - 'Config' => [ - 'description' => 'Spark 应用配置。', - 'type' => 'string', - 'example' => '{"key1": "value1", "key2": "value2"}', - ], - 'State' => [ - 'description' => '应用执行状态，取值说明：'."\n" - .'* SUBMITTED：已提交。'."\n" - .'* STARTING：开始启动。'."\n" - .'* RUNNING：执行中。'."\n" - .'* FAILING：任务失败，清理环境中。'."\n" - .'* FAILED：失败。'."\n" - .'* KILLING：中止任务，清理环境中。'."\n" - .'* KILLED：中止任务。'."\n" - .'* SUCCEEDING：任务执行结束，清理环境中。'."\n" - .'* COMPLETED：已完成。'."\n" - .'* FATAL：意外失败。'."\n" - .'* UNKNOWN：未知错误。', - 'type' => 'string', - 'example' => 'COMPLETED', + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '1'], + 'PageNumber' => ['description' => '页数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'am-bp16t5ci7r74s****'], + 'Tables' => [ + 'description' => '不合理非分区表信息。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'SchemaName' => ['description' => '数据库名称。'."\n" + .' '."\n", 'type' => 'string', 'example' => 'adb_demo'], + 'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'test'], + 'RowCount' => ['description' => '表行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1222'], + 'IndexSize' => ['description' => '普通索引数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '111'], + 'DataSize' => ['description' => '表数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '2921132457984'], + 'LocalDataSize' => ['description' => '热数据量大小，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1223'], + 'PrimaryKeySize' => ['description' => '主键索引大小，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'RemoteDataSize' => ['description' => '冷数据量大小，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '122'], + 'SpaceRatio' => ['description' => '表空间占比，单位：%。'."\n" + ."\n" + .'> 计算公式为：表空间占比 = (表总数据量 / 实例总数据量) * 100。', 'type' => 'number', 'format' => 'double', 'example' => '0.3'], ], - 'SubmittedTimeInMillis' => [ - 'description' => 'Spark SQL 应用的提交时间，Unix时间戳，单位毫秒（ms）。', - 'type' => 'string', - 'example' => '1651213645000', + 'description' => '', + ], + ], + 'DetectionItems' => [ + 'description' => '检测项及检测结果列表。', + 'type' => 'array', + 'items' => [ + 'description' => '检测项信息。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '检测项名。', 'type' => 'string', 'example' => 'Oversized non-partitioned table'], + 'Message' => ['description' => '检测结果信息。', 'type' => 'string', 'example' => 'Multiple oversized non-partitioned tables are detected.'], + 'Status' => ['description' => '检测结果状态。', 'type' => 'string', 'example' => 'NORMAL'."\n" + .'WARNING'."\n" + .'CRITICAL'], ], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', - 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.FailedToKill', - 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', - 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Log.InvalidState', - 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', - ], - ], 404 => [ - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.NotFound', - 'errorMessage' => 'The requested analysis task %s is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.TemplateNotFound', - 'errorMessage' => 'The template %s is not found.', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '检测非分区表不合理', + 'summary' => '调用DescribeOversizeNonPartitionTableInfos接口查看集群非分区表是否存在不合理的情况。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeOversizeNonPartitionTableInfos'], ], ], - 'staticInfo' => [ - 'noSubstitutionReason' => '无替代API，历史原因导致该API被标记为弃用。', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeOversizeNonPartitionTableInfos', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxxx-xxx-xx\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202207151211hz0c****\\",\\n \\"MinExecutor\\": \\"1\\",\\n \\"MaxExecutor\\": \\"3\\",\\n \\"Jars\\": \\"oss://test-bucket/test.jar\\",\\n \\"SlotNum\\": \\"2\\",\\n \\"Config\\": \\"{\\\\\\"key1\\\\\\": \\\\\\"value1\\\\\\", \\\\\\"key2\\\\\\": \\\\\\"value2\\\\\\"}\\",\\n \\"State\\": \\"COMPLETED\\",\\n \\"SubmittedTimeInMillis\\": \\"1651213645000\\"\\n }\\n}","type":"json"}]', - 'title' => '查询Spark SQL引擎状态', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"1\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"DBClusterId\\": \\"am-bp16t5ci7r74s****\\",\\n \\"Tables\\": [\\n {\\n \\"SchemaName\\": \\"adb_demo\\",\\n \\"TableName\\": \\"test\\",\\n \\"RowCount\\": 1222,\\n \\"IndexSize\\": 111,\\n \\"DataSize\\": 2921132457984,\\n \\"LocalDataSize\\": 1223,\\n \\"PrimaryKeySize\\": 123,\\n \\"RemoteDataSize\\": 122,\\n \\"SpaceRatio\\": 0.3\\n }\\n ],\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"Oversized non-partitioned table\\",\\n \\"Message\\": \\"Multiple oversized non-partitioned tables are detected.\\",\\n \\"Status\\": \\"NORMAL\\\\nWARNING\\\\nCRITICAL\\"\\n }\\n ]\\n}","type":"json"}]', ], - 'DescribeSparkCodeOutput' => [ - 'summary' => '获取spark代码的执行结果。', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribePatternPerformance' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '132321', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-uf6li1r3do8m****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~612397~~)接口查询目标地域下集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-uf6210mmev07****', - ], + 'schema' => ['description' => '查询开始时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>。'."\n" + .'> - 当前日期为北京时间2022年8月22日，最早可以查询到北京时间2022年8月9日（UTC时间：2022-08-08T16:00:00Z)的数据，若查询时间早于8月9日（UTC时间：2022-08-08T16:00:00Z)，返回值为空。'."\n" + .'- 查询开始时间和查询结束时间的间隔不能大于24小时。 ', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2022-08-21T02:15:00Z'], ], [ - 'name' => 'JobId', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => 'Spark Job 任务ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '620', - ], + 'schema' => ['description' => '查询结束时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。'."\n" + .'> 查询结束时间需晚于查询开始时间。'."\n", 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2022-08-22T01:06:00Z'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'PatternId', + 'in' => 'query', + 'schema' => ['description' => 'SQL Pattern的ID。'."\n" + .'> 您可以调用[DescribeSQLPatterns](~~321868~~)接口查看指定时间内目标集群下所有的SQL Pattern列表信息，包括SQL Pattern的ID。', 'type' => 'string', 'required' => false, 'example' => '3847585356974******', 'default' => '-1'], ], ], 'responses' => [ @@ -21634,190 +15473,141 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Success' => [ - 'description' => '调用是否成功。'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Output' => [ - 'description' => '执行的输出，为JSON对象格式。', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => '"{\\"schema\\":[\\"id\\",\\"name\\",\\"age\\"],\\"data\\":[\\"{\\\\\\"id\\\\\\":10,\\\\\\"name\\\\\\":\\\\\\"z\\\\\\",\\\\\\"age\\\\\\":123}\\",\\"{\\\\\\"id\\\\\\":2,\\\\\\"name\\\\\\":\\\\\\"b\\\\\\",\\\\\\"age\\\\\\":17}\\",\\"{\\\\\\"id\\\\\\":1,\\\\\\"name\\\\\\":\\\\\\"a\\\\\\",\\\\\\"age\\\\\\":15}\\",\\"{\\\\\\"id\\\\\\":3,\\\\\\"name\\\\\\":\\\\\\"c\\\\\\",\\\\\\"age\\\\\\":222}\\",\\"{\\\\\\"id\\\\\\":10,\\\\\\"name\\\\\\":\\\\\\"z\\\\\\",\\\\\\"age\\\\\\":123}\\"],\\"haveRows\\":true,\\"rowNumber\\":6}"', + 'EndTime' => ['description' => '查询结束时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。', 'type' => 'string', 'example' => '2022-08-22T01:06:00Z'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'F21AF487-B8C9-57E0-8E3A-A92BC3611FB6'], + 'StartTime' => ['description' => '查询开始时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。', 'type' => 'string', 'example' => '2022-08-21T02:15:00Z'], + 'Performances' => [ + 'description' => '详情。', + 'type' => 'array', + 'items' => [ + 'description' => '列表。', + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => '查询的各项性能指标项。取值说明：'."\n" + .'- **AnalyticDB_PatternQueryCount**：Pattern相关查询的总次数。'."\n" + .'- **AnalyticDB_PatternQueryTime**：Pattern相关查询的总耗时。'."\n" + .'- **AnalyticDB_PatternExecutionTime**：Pattern相关查询的执行耗时。'."\n" + .'- **AnalyticDB_PatternPeakMemory**：Pattern相关查询的峰值内存。'."\n" + .'- **AnalyticDB_PatternScanSize**：Pattern相关查询的数据读取量。', 'type' => 'string', 'example' => 'AnalyticDB_PatternExecutionTime'], + 'Unit' => ['description' => '各项性能指标项对应的单位。取值说明：'."\n" + .'- 当性能指标项为查询时间相关（即`Key`值为`AnalyticDB_PatternQueryTime`或`AnalyticDB_PatternExecutionTime`）时，该返回值为**ms**。'."\n" + .'- 当性能指标项为峰值内存相关（即`Key`值为`AnalyticDB_PatternPeakMemory`）时，该返回值为**MB**。'."\n" + .'- 当性能指标项为数据读取量（即`Key`值为`AnalyticDB_PatternScanSize`）时，该返回值为**MB**。'."\n" + .'- 当性能指标项为查询次数（即`Key`值为`AnalyticDB_PatternQueryCount`）时，该返回值为空。', 'type' => 'string', 'example' => 'ms'], + 'Series' => [ + 'description' => '性能指标项下各个性能值的详情。', + 'type' => 'array', + 'items' => [ + 'description' => '列表项。', + 'type' => 'object', + 'properties' => [ + 'Values' => [ + 'description' => '性能值列表。', + 'type' => 'array', + 'items' => ['description' => '不同时间点下的性能值详细信息。', 'type' => 'string', 'example' => '[ "2021-11-18 13:38:00", "224" ]'], + ], + 'Name' => ['description' => '性能值的名称。取值说明：'."\n" + .'- 当`Key`值为`AnalyticDB_PatternQueryCount`时，该参数返回 `pattern_query_count`，即当前Pattern相关SQL的执行次数。'."\n" + .'- 当`Key`值为`AnalyticDB_PatternQueryTime`时，该参数返回：'."\n" + .' - `average_query_time`，即当前Pattern相关SQL的平均总耗时。'."\n" + .' - `max_query_time`，即当前Pattern相关SQL的最大总耗时。'."\n" + .'- 当`Key`值为`AnalyticDB_PatternExecutionTime`时，该参数返回：'."\n" + .' - `average_execution_time`，即当前Pattern相关SQL的平均执行耗时。'."\n" + .' - `max_execution_time`，即当前Pattern相关SQL的最大执行耗时。'."\n" + .'- 当`Key`值为`AnalyticDB_PatternPeakMemory`时，该参数返回：'."\n" + .' - `average_peak_memory`，即当前Pattern相关SQL的平均峰值内存。'."\n" + .' - `max_peak_memory`，即当前Pattern相关SQL的最大峰值内存。'."\n" + .'- 当`Key`值为`AnalyticDB_PatternScanSize`时，该参数返回：'."\n" + .' - `average_scan_size`，即当前Pattern相关SQL的平均读取数据量。'."\n" + .' - `max_scan_size`，即当前Pattern相关SQL的最大数据读取量。', 'type' => 'string', 'example' => 'max_query_time'], + ], + ], + ], + ], + ], ], + 'User' => ['description' => '执行SQL的数据库账号。', 'type' => 'string', 'example' => 'test_user'], + 'AccessIp' => ['description' => '提交Pattern的相关SQL客户端IP地址。', 'type' => 'string', 'example' => '172.16.14.*'], + 'SQLPattern' => ['description' => 'SQL Pattern的具体语句。', 'type' => 'string', 'example' => 'SELECT *nFROM HIVE.`ADB_EXTERNAL_TPCH_10GB`.`External_customer`nLIMIT ?'], + 'Tables' => ['description' => 'SQL Pattern查询涉及的表信息。', 'type' => 'string', 'example' => 'tpch_1g.part;tpch_1g.supplier;tpch_1g.lineitem;tpch_1g.partsupp;tpch_1g.orders;tpch_1g.nation'], + 'FailedCount' => ['description' => '查询时间范围内，Pattern的失败次数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'QueryCount' => ['description' => '查询时间范围内，Pattern的执行次数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1202'], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"Output\\": \\"\\\\\\"{\\\\\\\\\\\\\\"schema\\\\\\\\\\\\\\":[\\\\\\\\\\\\\\"id\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"age\\\\\\\\\\\\\\"],\\\\\\\\\\\\\\"data\\\\\\\\\\\\\\":[\\\\\\\\\\\\\\"{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"id\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":10,\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"z\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"age\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":123}\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"id\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":2,\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"b\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"age\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":17}\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"id\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":1,\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"a\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"age\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":15}\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"id\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":3,\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"c\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"age\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":222}\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"id\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":10,\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"z\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"age\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":123}\\\\\\\\\\\\\\"],\\\\\\\\\\\\\\"haveRows\\\\\\\\\\\\\\":true,\\\\\\\\\\\\\\"rowNumber\\\\\\\\\\\\\\":6}\\\\\\"\\"\\n}","type":"json"}]', - 'title' => '查询产品的代码配置详情', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'DescribeSparkCodeLog' => [ - 'summary' => '查询Spark code的执行日志。', - 'methods' => [ - 'get', - 'post', + 'gatewayOptions' => [ + 'gatewayProtocols' => [], ], - 'schemes' => [ - 'http', - 'https', + 'title' => '查询SQL Pattern的指标', + 'summary' => '查看集群指定时间段内SQL Pattern的各指标（如查询时间、平均内存消耗）详情。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-10-21T12:16:17.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-12-08T02:33:56.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-06-08T03:15:21.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-22T04:03:34.000Z', 'description' => 'OpenAPI 下线'], ], - 'security' => [ - [ - 'AK' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribePatternPerformance'], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], - ], + 'ramActions' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-uf6o6m8p6x7v****', - ], - ], - [ - 'name' => 'JobId', - 'in' => 'query', - 'schema' => [ - 'description' => 'Spark Job 任务ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1248', - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1CD65640-9963-5D60-929C-118F2C84070E', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Log' => [ - 'description' => '日志内容。', - 'type' => 'string', - 'example' => '>>>>>>>> stdout:n++++++++++++++++++executing sql: MSCK REPAIR TABLE `footprint_ethereum`.`dwd_eth_eth_txr_v2_di` n++n', - ], + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribePatternPerformance', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"1CD65640-9963-5D60-929C-118F2C84070E\\",\\n \\"Success\\": true,\\n \\"Log\\": \\">>>>>>>> stdout:n++++++++++++++++++executing sql: MSCK REPAIR TABLE `footprint_ethereum`.`dwd_eth_eth_txr_v2_di` n++n\\"\\n}","type":"json"}]', - 'title' => '查询产品的代码日志', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"EndTime\\": \\"2022-08-22T01:06:00Z\\",\\n \\"RequestId\\": \\"F21AF487-B8C9-57E0-8E3A-A92BC3611FB6\\",\\n \\"StartTime\\": \\"2022-08-21T02:15:00Z\\",\\n \\"Performances\\": [\\n {\\n \\"Key\\": \\"AnalyticDB_PatternExecutionTime\\",\\n \\"Unit\\": \\"ms\\",\\n \\"Series\\": [\\n {\\n \\"Values\\": [\\n \\"[ \\\\\\"2021-11-18 13:38:00\\\\\\", \\\\\\"224\\\\\\" ]\\"\\n ],\\n \\"Name\\": \\"max_query_time\\"\\n }\\n ]\\n }\\n ],\\n \\"User\\": \\"test_user\\",\\n \\"AccessIp\\": \\"172.16.14.*\\",\\n \\"SQLPattern\\": \\"SELECT *nFROM HIVE.`ADB_EXTERNAL_TPCH_10GB`.`External_customer`nLIMIT ?\\",\\n \\"Tables\\": \\"tpch_1g.part;tpch_1g.supplier;tpch_1g.lineitem;tpch_1g.partsupp;tpch_1g.orders;tpch_1g.nation\\",\\n \\"FailedCount\\": 1,\\n \\"QueryCount\\": 1202\\n}","errorExample":""},{"type":"xml","example":"<DescribePatternPerformanceResponse>\\n <EndTime>2022-08-22T01:06:00Z</EndTime>\\n <RequestId>F21AF487-B8C9-57E0-8E3A-A92BC3611FB6</RequestId>\\n <StartTime>2022-08-21T02:15:00Z</StartTime>\\n <Performances>\\n <Key>AnalyticDB_PatternExecutionTime</Key>\\n <Unit>ms</Unit>\\n <Series>\\n <Values>[ \\"2021-11-18 13:38:00\\", \\"224\\" ]</Values>\\n <Name>max_query_time</Name>\\n </Series>\\n </Performances>\\n</DescribePatternPerformanceResponse>","errorExample":""}]', ], - 'DescribeSparkCodeWebUi' => [ - 'summary' => '查询Spark应用的Web UI地址。', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribePerformanceViewAttribute' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'tags' => ['Perth'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '220839', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 调用[DescribeDBClusters](~~612397~~)接口可以查看集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1v6usq6m65****', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'JobId', + 'name' => 'ViewName', 'in' => 'query', - 'schema' => [ - 'description' => 'Spark Job 任务ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1248', - ], + 'schema' => ['description' => '监控视图名称。', 'type' => 'string', 'required' => true, 'example' => 'Custom-All metrics-2 columns-Linked'], ], ], 'responses' => [ @@ -21825,49 +15615,120 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'Message' => [ - 'description' => '应用建议执行结果。取值说明：'."\n" - .'- 请求正常，返回**SUCCESS**。 '."\n" - .'- 请求异常，返回具体异常错误信息。', - 'type' => 'string', - 'example' => 'Success', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '774DDC37-1908-58F6-B9CA-99E3E45965A6', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Url' => [ - 'description' => 'Spark UI地址', - 'type' => 'string', - 'example' => 'https://adb-subuser-cn-hangzhou-1358535755648527-100000648.oss-cn-hangzhou.aliyuncs.com/%3Facl?Expires=1681295967&OSSAccessKeyId=LTAI5tB7NAkm25oiGASu****&Signature=hKAZ1vgvhJ%2FD8hNHTuX%2FOOBWht****', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'E031AABF-BD56-5966-A063-4283EF18DB45'], + 'ViewName' => ['description' => '监控视图名称。', 'type' => 'string', 'example' => 'Custom-All metrics-2 columns-Linked'], + 'CreateFromViewType' => ['description' => '原始图表来源的类型，取值：'."\n" + ."\n" + .'- **Basic**：基础视图'."\n" + .'- **Advanced**：高级视图', 'type' => 'string', 'example' => 'Basic'], + 'ViewDetail' => [ + 'description' => '监控视图详情。', + 'type' => 'object', + 'properties' => [ + 'ChartsPerLine' => ['description' => '每一行展示的图表数。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'ChartLinked' => ['description' => '是否联动图表。取值：'."\n" + ."\n" + .'- true'."\n" + .'- false', 'type' => 'boolean', 'example' => 'true'], + 'Categories' => [ + 'description' => '指标分类列表。', + 'type' => 'array', + 'items' => [ + 'description' => '指标分类。', + 'type' => 'object', + 'properties' => [ + 'Category' => ['description' => '指标分类名，取值：'."\n" + .'* **Node**：节点资源指标'."\n" + .'* **DiskData**：磁盘指标'."\n" + .'* **WorkLoad**：负载指标'."\n" + .'* **ResourceGroup**：资源组指标', 'type' => 'string', 'example' => 'Node'], + 'Keys' => [ + 'description' => '指标列表。', + 'type' => 'array', + 'items' => [ + 'description' => '单个指标配置。', + 'type' => 'object', + 'properties' => [ + 'KeyName' => ['description' => '指标Key。', 'type' => 'string', 'example' => 'AnalyticDB_CPU'], + 'Selected' => ['description' => '是否选中。取值：'."\n" + ."\n" + .'- true'."\n" + .'- false', 'type' => 'boolean', 'example' => 'true'], + 'GroupType' => [ + 'type' => 'array', + 'items' => ['type' => 'string', 'description' => ''], + 'description' => '', + ], + 'Engine' => [ + 'type' => 'array', + 'items' => ['type' => 'string', 'description' => ''], + 'description' => '', + ], + 'EnableAutoMc' => ['type' => 'boolean', 'description' => ''], + ], + ], + ], + ], + ], + ], + ], ], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp198m028ih55xxxx'], + 'FillOriginViewKeys' => ['description' => '查看监控视图时，是否填充原始监控视图完成的Key。取值：'."\n" + ."\n" + .'- true'."\n" + .'- false', 'type' => 'boolean', 'example' => 'true'], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"774DDC37-1908-58F6-B9CA-99E3E45965A6\\",\\n \\"Success\\": true,\\n \\"Url\\": \\"https://adb-subuser-cn-hangzhou-1358535755648527-100000648.oss-cn-hangzhou.aliyuncs.com/%3Facl?Expires=1681295967&OSSAccessKeyId=LTAI5tB7NAkm25oiGASu****&Signature=hKAZ1vgvhJ%2FD8hNHTuX%2FOOBWht****\\"\\n}","type":"json"}]', - 'title' => '查询Spark code的web ui', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'ListSparkTemplateFileIds' => [ - 'summary' => '查询集群所有保存的Spark模板文件ID。', - 'methods' => [ - 'get', - 'post', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'PerformanceViewNotFound', 'errorMessage' => 'Performance view not found.', 'description' => '没有找到指定的监控视图名'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查看监控视图详情', + 'summary' => '查看监控视图详情。', + 'changeSet' => [ + ['createdAt' => '2024-10-16T02:07:34.000Z', 'description' => '响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribePerformanceViewAttribute'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribePerformanceViewAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"E031AABF-BD56-5966-A063-4283EF18DB45\\",\\n \\"ViewName\\": \\"Custom-All metrics-2 columns-Linked\\",\\n \\"CreateFromViewType\\": \\"Basic\\",\\n \\"ViewDetail\\": {\\n \\"ChartsPerLine\\": 2,\\n \\"ChartLinked\\": true,\\n \\"Categories\\": [\\n {\\n \\"Category\\": \\"Node\\",\\n \\"Keys\\": [\\n {\\n \\"KeyName\\": \\"AnalyticDB_CPU\\",\\n \\"Selected\\": true,\\n \\"GroupType\\": [\\n \\"\\"\\n ],\\n \\"Engine\\": [\\n \\"\\"\\n ],\\n \\"EnableAutoMc\\": true\\n }\\n ]\\n }\\n ]\\n },\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\",\\n \\"DBClusterId\\": \\"amv-bp198m028ih55xxxx\\",\\n \\"FillOriginViewKeys\\": true\\n}","type":"json"}]', + ], + 'DescribePerformanceViews' => [ + 'summary' => '获取监控视图列表。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'tags' => ['Perth'], 'security' => [ [ 'AK' => [], @@ -21879,88 +15740,91 @@ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '220841', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-bp11q28kvl688****', - ], + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 调用[DescribeDBClusters](~~612397~~)接口可以查看集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1ub9grke1****'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], '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' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Data' => [ - 'title' => '文件ID列表', - 'description' => '文件ID列表。', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '3A8F6106-6AFD-5A34-9C80-8DE2C42D06E8'], + 'Views' => [ + 'description' => '监控视图列表。', 'type' => 'array', 'items' => [ - 'description' => 'Spark模板文件ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', + 'description' => '单个监控视图信息。', + 'type' => 'object', + 'properties' => [ + 'ViewName' => ['description' => '监控视图名称。', 'type' => 'string', 'example' => 'Custom-1'], + 'CreateTime' => ['description' => '创建时间。', 'type' => 'string', 'example' => '2024-06-18T07:06:53.000+00:00'], + 'UpdateTime' => ['description' => '更新时间。', 'type' => 'string', 'example' => '2024-06-18T07:07:32.000+00:00'], + ], ], ], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取监控视图列表', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribePerformanceViews'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribePerformanceViews', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": [\\n 10\\n ]\\n}","errorExample":""},{"type":"xml","example":"<ListSparkTemplateFileIdsResponse>\\n <Data>10</Data>\\n <Data>20</Data>\\n <Data>30</Data>\\n</ListSparkTemplateFileIdsResponse>","errorExample":""}]', - 'title' => '列出集群中的Spark模板文件ID', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"3A8F6106-6AFD-5A34-9C80-8DE2C42D06E8\\",\\n \\"Views\\": [\\n {\\n \\"ViewName\\": \\"Custom-1\\",\\n \\"CreateTime\\": \\"2024-06-18T07:06:53.000+00:00\\",\\n \\"UpdateTime\\": \\"2024-06-18T07:07:32.000+00:00\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', ], - 'GetSparkAppWebUiAddress' => [ - 'summary' => '查询Spark应用的Web UI地址。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeProcessList' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -21970,35 +15834,60 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'abilityTreeCode' => '119937', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREads4DZDZG'], ], 'parameters' => [ [ - 'name' => 'AppId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'spark app的id', - 'description' => '应用ID。'."\n" - .'> 您可以调用[ListSparkApps](~~455888~~)接口查询Spark的应用ID。', - 'type' => 'string', - 'required' => true, - 'example' => 's202205201533hz1209892000****', - 'maxLength' => 64, - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => 'AnalyticDB MySQL湖仓版集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-xxxxxxxxx'], ], [ - 'name' => 'DBClusterId', + 'name' => 'ShowFull', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有湖仓版集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-uf6g8w25jacm7****', - ], + 'schema' => ['description' => '是否展示完整的SQL语句。取值说明：'."\n" + .'- **True**：展示完整的SQL语句。'."\n" + .'- **False**：只展示SQL语句的前100个字符。'."\n" + ."\n" + .'> 默认值False。', 'type' => 'boolean', 'required' => false, 'example' => 'True'], + ], + [ + 'name' => 'RunningTime', + 'in' => 'query', + 'schema' => ['description' => '按运行时间过滤，展示大于该运行时间的查询。单位：秒。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '20'], + ], + [ + 'name' => 'User', + 'in' => 'query', + 'schema' => ['description' => '数据库账号。', 'type' => 'string', 'required' => false, 'example' => 'admin'], + ], + [ + 'name' => 'Keyword', + 'in' => 'query', + 'schema' => ['description' => '过滤关键字，目前仅支持过滤**SELECT**。', 'type' => 'string', 'required' => false, 'example' => 'SELECT'], + ], + [ + 'name' => 'Order', + 'in' => 'query', + 'schema' => ['description' => '按指定字段排序，JSON格式，`[{"Field":"Time","Type":"Desc" },{ "Field":"User", "Type":"Asc" }]`，取值说明：'."\n" + .'- **Field**：需要排序的字段名，支持Time，User，Host，DB字段。'."\n" + .'- **Type**：排序类型，**Desc**为降序，**Asc**为升序。', 'type' => 'string', 'required' => false, 'example' => '[ { "Field":"Time","Type":"Desc" }, { "Field":"User", "Type":"Asc" }]'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '30', 'example' => '30', 'default' => '30'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码，取值为正整数。默认值为**1**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1'], ], ], 'responses' => [ @@ -22006,141 +15895,76 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380', - ], - 'Data' => [ - 'title' => '', - 'description' => '返回数据。', + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '10'], + 'PageSize' => ['description' => '总页数。', 'type' => 'string', 'example' => '30'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'PageNumber' => ['description' => '页码。', 'type' => 'string', 'example' => '1'], + 'Items' => [ 'type' => 'object', + 'itemNode' => true, 'properties' => [ - 'AppId' => [ - 'title' => 'spark app的id', - 'description' => '应用ID。', - 'type' => 'string', - 'example' => 's202205201533hz1209892000****', - ], - 'ExpirationTimeInMillis' => [ - 'title' => 'spark app的WEB UI的可访问截止时间, 毫秒级时间戳.', - 'description' => '到期时间，Unix时间戳，单位：毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1655801973000', - ], - 'WebUiAddress' => [ - 'title' => 'Spark App的WEB UI的临时访问地址, 有过期时间, 过期后需要再次生成.', - 'description' => 'Spark应用的Web UI地址。', - 'type' => 'string', - 'example' => 'https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****', - ], - 'DBClusterId' => [ - 'title' => '数据库ID'."\n", - 'description' => '数据库ID'."\n", - 'type' => 'string', - 'example' => 'amv-clusterxxx', - 'default' => 'DB_CLUSTER_ID', + 'Process' => [ + 'description' => '正在运行的查询列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'StartTime' => ['description' => '任务的开始时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'example' => '2020-11-19T02:48:15Z'], + 'Time' => ['description' => '查询任务已运行时间。单位：秒。', 'type' => 'integer', 'format' => 'int32', 'example' => '40'], + 'ProcessId' => ['description' => '任务的唯一标识，KILL PROCESS时使用。', 'type' => 'string', 'example' => '202011191048151921681492420315100****'], + 'Host' => ['description' => '发起查询的IP地址。', 'type' => 'string', 'example' => '192.168.XX.XX:12308'], + 'DB' => ['description' => '数据库名。', 'type' => 'string', 'example' => 'adb_demo'], + 'Command' => ['description' => '命令类型，仅支持SELECT类型。', 'type' => 'string', 'example' => 'SELECT'], + 'User' => ['description' => '数据库账户。', 'type' => 'string', 'example' => 'admin'], + 'Id' => ['description' => '工作线程ID。', 'type' => 'integer', 'format' => 'int32', 'example' => '49104'], + 'Info' => ['description' => '正在运行的SQL语句，默认返回前100字符。当传入参数ShowFull为True时，显示全文。', 'type' => 'string', 'example' => 'select * from sbtest1,sbtest2,sbtest3,sbtest4'], + ], + 'description' => '', + ], ], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', - 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.FailedToKill', - 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', - 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Log.InvalidState', - 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', - ], + ['errorCode' => 'IncorrectModuleVersion', 'errorMessage' => 'The specified module version does not support this operation.', 'description' => '模块版本不支持该操作。'], + ['errorCode' => 'AnalyticDBKernelError', 'errorMessage' => 'Calling AnalyticDB Kernel error', 'description' => ''], ], 404 => [ - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.NotFound', - 'errorMessage' => 'The requested analysis task %s is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.TemplateNotFound', - 'errorMessage' => 'The template %s is not found.', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + ], + 'title' => '查看集群正在运行的查询', + 'summary' => '调用 DescribeProcessList 接口查看实例正在运行的查询。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeProcessList'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeProcessList', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202205201533hz1209892000****\\",\\n \\"ExpirationTimeInMillis\\": 1655801973000,\\n \\"WebUiAddress\\": \\"https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****\\",\\n \\"DBClusterId\\": \\"amv-clusterxxx\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkAppWebUiAddressResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <AppId>s202205201533hz1209892000****</AppId>\\n <ExpirationTimeInMillis>1655801973000</ExpirationTimeInMillis>\\n <WebUiAddress>https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****</WebUiAddress>\\n </Data>\\n</GetSparkAppWebUiAddressResponse>","errorExample":""}]', - 'title' => '查询Spark Web UI地址', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"10\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"Items\\": {\\n \\"Process\\": [\\n {\\n \\"StartTime\\": \\"2020-11-19T02:48:15Z\\",\\n \\"Time\\": 40,\\n \\"ProcessId\\": \\"202011191048151921681492420315100****\\",\\n \\"Host\\": \\"192.168.XX.XX:12308\\",\\n \\"DB\\": \\"adb_demo\\",\\n \\"Command\\": \\"SELECT\\",\\n \\"User\\": \\"admin\\",\\n \\"Id\\": 49104,\\n \\"Info\\": \\"select * from sbtest1,sbtest2,sbtest3,sbtest4\\"\\n }\\n ]\\n }\\n}","type":"json"}]', ], - 'ListSparkAppAttempts' => [ - 'summary' => '查询指定Spark应用的重试信息。', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeRegions' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -22150,322 +15974,172 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '154593', + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], ], 'parameters' => [ [ - 'name' => 'AppId', + 'name' => 'AcceptLanguage', 'in' => 'query', 'schema' => [ - 'title' => 'spark app的id', - 'description' => '应用ID。'."\n" - ."\n" - .'> 您可以调用[ListSparkApps](~~455888~~)接口查询所有的应用ID。', + 'description' => '地域名称和可用区名称（即返回数据中LocalName）返回值所使用的语言，取值说明：'."\n" + .'- **zh-CN**：简体中文（默认语言）。'."\n" + .'- **en-US**：英文。'."\n" + .'- **ja**：日文。', 'type' => 'string', - 'required' => true, - 'example' => 's202204132018hzprec1ac****', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'title' => '页码号', - 'description' => '页码，取值为正整数。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'minimum' => '1', - 'example' => '1', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'title' => '每页显示数量', - 'description' => '每页记录数，取值：'."\n" - .'- **10**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int64', 'required' => false, - 'maximum' => '100', - 'minimum' => '1', - 'example' => '10', - 'default' => '10', + 'example' => 'en-US', + 'enum' => ['zh-CN', 'en-US', 'ja'], ], ], [ - 'name' => 'DBClusterId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-uf6o6m8p6x***', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回信息。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Data' => [ - 'description' => '返回数据。', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '421794A3-72A5-5D27-9E8B-A75A4C503E17'], + 'Regions' => [ 'type' => 'object', + 'itemNode' => true, 'properties' => [ - 'AttemptInfoList' => [ - 'description' => '重试信息列表。返回参数说明：'."\n" - .'- **AttemptId**：重试ID。'."\n" - .'- **State**：应用执行状态，取值说明：'."\n" - .' - **SUBMITTED**：已提交。'."\n" - .' - **STARTING**：开始启动。'."\n" - .' - **RUNNING**：执行中。'."\n" - .' - **FAILING**：任务失败，清理环境中。'."\n" - .' - **FAILED**：失败。'."\n" - .' - **KILLING**：中止任务，清理环境中。'."\n" - .' - **KILLED**：中止任务。'."\n" - .' - **SUCCEEDING**：任务执行结束，清理环境中。'."\n" - .' - **COMPLETED**：任务执行结束。'."\n" - .' - **FATAL**：意外失败。'."\n" - .' - **UNKNOWN**：未知错误。'."\n" - .'- **Message**：返回告警信息，无告警时则返回为空。'."\n" - .'- **Data**：Spark应用模板数据。'."\n" - .'- **EstimateExecutionCpuTimeInSeconds**：执行Spark应用消耗CPU的时长，单位毫秒（ms）。'."\n" - .'- **LogRootPath**：日志文件存储路径。'."\n" - .'- **LastAttemptId**：上次重试的ID。'."\n" - .'- **WebUiAddress**：Web UI地址。'."\n" - .'- **SubmittedTimeInMillis**：提交Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **StartedTimeInMillis**：Spark应用的创建时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **LastUpdatedTimeInMillis**：最近一次更新Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **TerminatedTimeInMillis**：Spark应用终止执行的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **DBClusterId**：执行Spark应用的集群ID。'."\n" - .'- **ResourceGroupName**：Job型资源组名称。'."\n" - .'- **DurationInMillis**：Spark应用执行耗时，单位毫秒（ms）。', + 'Region' => [ + 'description' => '地域信息列表。', 'type' => 'array', 'items' => [ - 'description' => '重试信息列表。返回参数说明：'."\n" - .'- **AttemptId**：重试ID。'."\n" - .'- **State**：应用执行状态，取值说明：'."\n" - .' - **SUBMITTED**：已提交。'."\n" - .' - **STARTING**：开始启动。'."\n" - .' - **RUNNING**：执行中。'."\n" - .' - **FAILING**：任务失败，清理环境中。'."\n" - .' - **FAILED**：失败。'."\n" - .' - **KILLING**：中止任务，清理环境中。'."\n" - .' - **KILLED**：中止任务。'."\n" - .' - **SUCCEEDING**：任务执行结束，清理环境中。'."\n" - .' - **COMPLETED**：任务执行结束。'."\n" - .' - **FATAL**：意外失败。'."\n" - .' - **UNKNOWN**：未知错误。'."\n" - .'- **Message**：返回告警信息，无告警时则返回为空。'."\n" - .'- **Data**：Spark应用模板数据。'."\n" - .'- **EstimateExecutionCpuTimeInSeconds**：执行Spark应用消耗CPU的时长，单位毫秒（ms）。'."\n" - .'- **LogRootPath**：日志文件存储路径。'."\n" - .'- **LastAttemptId**：上次重试的ID。'."\n" - .'- **WebUiAddress**：Web UI地址。'."\n" - .'- **SubmittedTimeInMillis**：提交Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **StartedTimeInMillis**：Spark应用的创建时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **LastUpdatedTimeInMillis**：最后一次更新Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **TerminatedTimeInMillis**：Spark应用终止执行的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **DBClusterId**：执行Spark应用的集群ID。'."\n" - .'- **ResourceGroupName**：Job型资源组名称。'."\n" - .'- **DurationInMillis**：Spark应用执行耗时，单位毫秒（ms）。', - '$ref' => '#/components/schemas/SparkAttemptInfo', + 'description' => '地域信息。', + 'type' => 'object', + 'properties' => [ + 'RegionEndpoint' => ['description' => '地域对应的接入地址。', 'type' => 'string', 'example' => 'adb.aliyuncs.com'], + 'LocalName' => ['description' => '地域名称。', 'type' => 'string', 'example' => 'China (Hangzhou)'], + 'RegionId' => ['description' => '地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'Zones' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'Zone' => [ + 'description' => '可用区列表。', + 'type' => 'array', + 'items' => [ + 'description' => '可用区列表。', + 'type' => 'object', + 'properties' => [ + 'ZoneId' => ['description' => '可用区ID。', 'type' => 'string', 'example' => 'cn-hangzhou-h'], + 'VpcEnabled' => ['description' => '目标可用区是否支持VPC，取值说明：'."\n" + .'- **true**：支持。'."\n" + .'- **false**：不支持。', 'type' => 'boolean', 'example' => 'true'], + 'LocalName' => ['description' => '可用区名称。', 'type' => 'string', 'example' => 'Hangzhou Zone H'], + ], + ], + ], + ], + 'description' => '', + ], + ], ], ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '3', - ], ], + 'description' => '', ], ], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], - ], - [ - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], - ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"AttemptInfoList\\": [\\n {\\n \\"AttemptId\\": \\"s202207151211hz0cb4200*****-0001\\",\\n \\"Priority\\": \\"NORMAL\\",\\n \\"State\\": \\"RUNNING\\",\\n \\"Message\\": \\"WARN: Disk is full\\",\\n \\"Detail\\": {\\n \\"DurationInMillis\\": 100,\\n \\"LogRootPath\\": \\"oss://<bucket-name>/logs/driver\\",\\n \\"DBClusterId\\": \\"amv-bp11q28kv****\\",\\n \\"Data\\": \\"{ \\\\\\"name\\\\\\": \\\\\\"SparkPi\\\\\\", \\\\\\"file\\\\\\": \\\\\\"local:///tmp/spark-examples.jar\\\\\\", \\\\\\"className\\\\\\": \\\\\\"org.apache.spark.examples.SparkPi\\\\\\", \\\\\\"args\\\\\\": [ \\\\\\"1000000\\\\\\" ], \\\\\\"conf\\\\\\": { \\\\\\"spark.driver.resourceSpec\\\\\\": \\\\\\"small\\\\\\", \\\\\\"spark.executor.instances\\\\\\": 1, \\\\\\"spark.executor.resourceSpec\\\\\\": \\\\\\"small\\\\\\" } }\\",\\n \\"EstimateExecutionCpuTimeInSeconds\\": 100,\\n \\"LastUpdatedTimeInMillis\\": 1651213645200,\\n \\"RunningStartTimeInMillis\\": 36000,\\n \\"LastAttemptId\\": \\"s202204291426hzpre60cfa*****-0003\\",\\n \\"TerminatedTimeInMillis\\": 1651213645300,\\n \\"ResourceProvisioningDurationInMillis\\": 36000,\\n \\"ExecutionDurationInMillis\\": 36000,\\n \\"WebUiAddress\\": \\"https://sparkui.aliyuncs.com/token=xxx\\",\\n \\"SubmittedTimeInMillis\\": 1651213645000,\\n \\"StartedTimeInMillis\\": 1651213645010,\\n \\"AppType\\": \\"BATCH\\",\\n \\"ResourceGroupName\\": \\"spark-rg\\"\\n }\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 3\\n }\\n}","errorExample":""},{"type":"xml","example":"<ListSparkAppAttemptsResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Data>\\n <AttemptInfoList>\\n <AttemptId>s202207151211hz0cb4200*****-0001</AttemptId>\\n <State>RUNNING</State>\\n <Message>WARN: Disk is full</Message>\\n <Detail>\\n <Data>{ \\"name\\": \\"SparkPi\\", \\"file\\": \\"local:///tmp/spark-examples.jar\\", \\"className\\": \\"org.apache.spark.examples.SparkPi\\", \\"args\\": [ \\"1000000\\" ], \\"conf\\": { \\"spark.driver.resourceSpec\\": \\"small\\", \\"spark.executor.instances\\": 1, \\"spark.executor.resourceSpec\\": \\"small\\" } }</Data>\\n <EstimateExecutionCpuTimeInSeconds>100</EstimateExecutionCpuTimeInSeconds>\\n <LogRootPath>oss://<bucket-name>/logs/driver</LogRootPath>\\n <LastAttemptId>s202204291426hzpre60cfa*****-0003</LastAttemptId>\\n <WebUiAddress>https://sparkui.aliyuncs.com/token=xxx</WebUiAddress>\\n <SubmittedTimeInMillis>1651213645000</SubmittedTimeInMillis>\\n <StartedTimeInMillis>1651213645010</StartedTimeInMillis>\\n <LastUpdatedTimeInMillis>1651213645200</LastUpdatedTimeInMillis>\\n <TerminatedTimeInMillis>1651213645300</TerminatedTimeInMillis>\\n <DBClusterId>amv-bp11q28kv****</DBClusterId>\\n <ResourceGroupName>spark-rg</ResourceGroupName>\\n <DurationInMillis>100</DurationInMillis>\\n </Detail>\\n </AttemptInfoList>\\n <PageNumber>1</PageNumber>\\n <PageSize>10</PageSize>\\n <TotalCount>3</TotalCount>\\n </Data>\\n</ListSparkAppAttemptsResponse>","errorExample":""}]', - 'title' => '查询Spark应用的重试信息', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', - ], - 'CreateSparkTemplate' => [ - 'summary' => '创建Spark应用模板。', - 'methods' => [ - 'post', + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '查询地域和可用区', + 'summary' => '查询AnalyticDB MySQL湖仓版支持的地域和可用区。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-07-24T07:15:09.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-09-15T06:33:47.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeRegions'], + ], ], + 'ramActions' => [], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"421794A3-72A5-5D27-9E8B-A75A4C503E17\\",\\n \\"Regions\\": {\\n \\"Region\\": [\\n {\\n \\"RegionEndpoint\\": \\"adb.aliyuncs.com\\",\\n \\"LocalName\\": \\"China (Hangzhou)\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"Zones\\": {\\n \\"Zone\\": [\\n {\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"VpcEnabled\\": true,\\n \\"LocalName\\": \\"Hangzhou Zone H\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<DescribeRegionsResponse>\\n <RequestId>421794A3-72A5-5D27-9E8B-A75A4C503E17</RequestId>\\n <Regions>\\n <RegionEndpoint>adb.aliyuncs.com</RegionEndpoint>\\n <LocalName>China (Hangzhou)</LocalName>\\n <RegionId>cn-hangzhou</RegionId>\\n <Zones>\\n <ZoneId>cn-hangzhou-h</ZoneId>\\n <VpcEnabled>true</VpcEnabled>\\n <LocalName>Hangzhou Zone H</LocalName>\\n </Zones>\\n </Regions>\\n</DescribeRegionsResponse>","errorExample":""}]', + ], + 'DescribeResourceGroupSpec' => [ + 'summary' => '查询资源组规格相关信息。', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '132061', - 'abilityTreeNodes' => [ - 'FEATUREadsCQJTKP', - ], + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '235394', + 'abilityTreeNodes' => ['FEATUREadsYXZ2UA'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'title' => '模板文件所在数据库ID', - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - 'maxLength' => 64, - ], - ], - [ - 'name' => 'ParentId', - 'in' => 'formData', - 'schema' => [ - 'title' => '父文件夹ID', - 'description' => '应用模板所属的目录ID。'."\n" - .'> 调用[GetSparkTemplateFolderTree](~~456218~~)接口查询目录ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'minimum' => '0', - 'example' => '10', - ], - ], - [ - 'name' => 'Name', - 'in' => 'formData', - 'schema' => [ - 'title' => '模板文件名称', - 'description' => '应用模板名称。长度不超过64个字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'batchfile', - 'maxLength' => 64, - ], + 'in' => 'query', + 'schema' => ['description' => '企业版、基础版或湖仓版集群 ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-8vbo40tl1dxxxxxx'], ], [ - 'name' => 'Type', - 'in' => 'formData', - 'schema' => [ - 'title' => '模板文件类型, 可以为FOLDER或者FILE', - 'description' => '应用模板类型，取值说明：'."\n" - .'- **folder**：目录'."\n" - .'- **file**：应用', - 'type' => 'string', - 'required' => true, - 'example' => 'file', - 'enum' => [], - ], + 'name' => 'ResourceGroupType', + 'in' => 'query', + 'schema' => ['description' => '资源组的类型。', 'type' => 'string', 'required' => true, 'example' => 'ai'], ], [ - 'name' => 'AppType', - 'in' => 'formData', - 'schema' => [ - 'title' => '模板文件内容的类型, 可选值有 BATCH, STREAMING, SQL, 默认为UNDEFINED', - 'description' => '应用类型，取值说明：'."\n" - .'- **SQL**：SQL应用'."\n" - .'- **STREAMING**：流应用'."\n" - .'- **BATCH**：离线应用'."\n" - ."\n" - .'> 当应用模板类型为folder时，无需配置此参数。', - 'type' => 'string', - 'required' => false, - 'example' => 'SQL', - 'default' => 'UNDEFINED', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Data' => [ - 'description' => '应用模板创建结果。', - 'type' => 'object', - 'properties' => [ - 'Succeeded' => [ - 'title' => '是否创建成功', - 'description' => '是否创建成功，取值说明：'."\n" - .'- **True**：成功'."\n" - .'- **False**：失败', - 'type' => 'boolean', - 'example' => 'True', + 'RequestId' => ['title' => 'Id of the request', 'description' => 'requestId', 'type' => 'string', 'example' => '10226189-4391-5B10-97AF-5CA5XXXXXXX'], + 'Specs' => [ + 'description' => '规格列表。', + 'type' => 'array', + 'items' => [ + 'description' => '规格信息。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '规格名称。', 'type' => 'string', 'example' => 'xlarge'], + 'AllocateUnits' => [ + 'description' => '该规格支持的分配单元列表。', + 'type' => 'array', + 'items' => ['description' => '分配单元。', 'type' => 'string', 'example' => '1'], + ], + 'MaxQuantity' => ['description' => '该规格能够使用的最大数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '8'], + 'Type' => [ + 'description' => '资源类型。', + 'type' => 'string', + 'example' => 'GPU', + 'default' => 'GPU', + 'enum' => ['CPU', 'GPU'], + ], ], ], ], @@ -22475,122 +16149,120 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.BadFileType', - 'errorMessage' => 'The requested template %s is not a file.', - ], - ], - 404 => [ - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.TemplateNotFound', - 'errorMessage' => 'The template %s is not found.', - ], + ['errorCode' => 'InvalidPoolName.Malformed', 'errorMessage' => 'The specified parameter PoolName is not valid.', 'description' => 'PoolName参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPoolUser.Malformed', 'errorMessage' => 'The specified parameter PoolUser is not valid.', 'description' => 'PoolUser参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPoolType.Malformed', 'errorMessage' => 'The specified parameter PoolType is not valid.', 'description' => 'PoolType参数不正确，请确认参数是否符合规范。'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], + 408 => [ + ['errorCode' => 'AcsServerTimeOut', 'errorMessage' => 'The request has failed due to Adb Cloud Service time out.', 'description' => '后端服务超时,请稍后尝试。'], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'staticInfo' => ['returnType' => 'synchronous'], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"Succeeded\\": true\\n }\\n}","errorExample":""},{"type":"xml","example":"<CreateSparkTemplateResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Data>\\n <Succeeded>true</Succeeded>\\n </Data>\\n</CreateSparkTemplateResponse>","errorExample":""}]', - 'title' => '创建Spark应用模板', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', - ], - 'DeleteSparkTemplate' => [ - 'summary' => '删除Spark模板文件。', - 'methods' => [ - 'post', + 'title' => '查询资源组规格', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeResourceGroupSpec'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeResourceGroupSpec', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"10226189-4391-5B10-97AF-5CA5XXXXXXX\\",\\n \\"Specs\\": [\\n {\\n \\"Name\\": \\"xlarge\\",\\n \\"AllocateUnits\\": [\\n \\"1\\"\\n ],\\n \\"MaxQuantity\\": 8,\\n \\"Type\\": \\"GPU\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'DescribeResultExportConfig' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', - 'abilityTreeCode' => '132062', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '254784', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], ], 'parameters' => [ [ - 'name' => 'Id', - 'in' => 'formData', - 'schema' => [ - 'title' => '待删除模板文件的ID', - 'description' => '待删除模板文件的目录ID或应用ID。'."\n" - .'> - 您可以调用[GetSparkTemplateFullTree](~~612467~~)接口查询目录ID或应用ID。'."\n" - .'- 输入目录ID时，会删除目录及目录下所有的应用模板文件。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'minimum' => '0', - 'exclusiveMinimum' => true, - 'example' => '725204', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-shenzhen'], ], [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'title' => '模板文件所在数据库的ID', - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - 'maxLength' => 64, - ], + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下所有AnalyticDB MySQL集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-8vbf80pjcz*****'], + ], + [ + 'name' => 'ExportType', + 'in' => 'query', + 'schema' => ['description' => '导出类型，枚举类型，当前可选值为：'."\n" + ."\n" + .'- SLS：标识导出目的为SLS。'."\n" + .'- OSS：标识导出目的为OSS。', 'type' => 'string', 'required' => false, 'example' => 'SLS'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'ResultData<?>', + 'description' => 'ResultData<?>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Success' => ['description' => '请求是否成功。取值说明：'."\n" + .'- **True**：成功。'."\n" + .'- **False**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Message' => ['description' => '调用结果的信息。取值说明：'."\n" + .'- 请求正常，返回**OK**。 '."\n" + .'- 请求异常，返回具体异常信息。', 'type' => 'string', 'example' => 'OK'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => 'InvalidInput'], 'Data' => [ - 'description' => '删除结果。', + 'description' => '返回数据。', 'type' => 'object', 'properties' => [ - 'Succeeded' => [ - 'title' => '是否删除成功', - 'description' => '是否删除成功，取值说明：'."\n" - .'- **True**：删除成功。'."\n" - .'- **False**：删除失败。', - 'type' => 'boolean', - 'example' => 'True', + 'ExportType' => ['description' => '导出类型，枚举类型，当前可选值为：'."\n" + ."\n" + .'- SLS：标识导出目的为SLS。'."\n" + .'- OSS：标识导出目的为OSS。', 'type' => 'string', 'example' => 'OSS'], + 'SlsInfo' => [ + 'description' => '导出类型为SLS时，对应的SLS配置信息。', + 'type' => 'object', + 'properties' => [ + 'SlsProject' => ['description' => 'SLS Project名称。', 'type' => 'string', 'example' => 'test-project'], + 'ResourceGroup' => ['description' => '导出SQL运行的资源组名称。', 'type' => 'string', 'example' => 'aps'], + 'LogstoreTtl' => ['description' => '结果集导出临时生成的logstore的过期时间，单位为天，过期后自动删除。 最小1天，最大30天。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + ], + ], + 'OssInfo' => [ + 'description' => '导出类型为OSS时，对应的OSS信息。', + 'type' => 'object', + 'properties' => [ + 'ExportBasePath' => ['description' => '导出结果存储的OSS路径地址。', 'type' => 'string', 'example' => 'oss://testBucketName/data_result'."\n"], + 'ResourceGroup' => ['description' => '导出SQL运行的资源组名称。', 'type' => 'string', 'example' => 'aps'], + 'ResultFileTtl' => ['description' => 'Oss文件过期时间，单位为天，最小1天，最大30天。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + ], ], ], ], @@ -22598,142 +16270,33 @@ ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', - 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.FailedToKill', - 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', - 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.KillOperationFailed', - 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.Log.IllegalPath', - 'errorMessage' => 'Invalid job log URI: %s.', - ], - [ - 'errorCode' => 'Spark.Log.InvalidState', - 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', - ], - [ - 'errorCode' => 'Spark.Oss.InternalError', - 'errorMessage' => 'An OSS internal error occurred: %s', - ], - [ - 'errorCode' => 'Spark.RoleArn.Invalid', - 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.BadFileType', - 'errorMessage' => 'The requested template %s is not a file.', - ], - ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取结果集导出配置信息', + 'summary' => '获取用户配置的结果集导出信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeResultExportConfig'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.AnalyzeTask.NotFound', - 'errorMessage' => 'The requested analysis task %s is not found.', - ], - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.Log.PodLogNotFound', - 'errorMessage' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.TemplateNotFound', - 'errorMessage' => 'The template %s is not found.', - ], - ], - 406 => [ - [ - 'errorCode' => 'Spark.App.KillNotAcceptable', - 'errorMessage' => 'Can\'t kill the application %s in %s state.', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.Resources.LoadFileFromClasspathFailed', - 'errorMessage' => 'Can\'t load the content from file: %s', - ], - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeResultExportConfig', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"Succeeded\\": true\\n }\\n}","errorExample":""},{"type":"xml","example":"<DeleteSparkTemplateResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Data>\\n <Succeeded>true</Succeeded>\\n </Data>\\n</DeleteSparkTemplateResponse>","errorExample":""}]', - 'title' => '删除Spark模板', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Data\\": {\\n \\"ExportType\\": \\"OSS\\",\\n \\"SlsInfo\\": {\\n \\"SlsProject\\": \\"test-project\\",\\n \\"ResourceGroup\\": \\"aps\\",\\n \\"LogstoreTtl\\": 10\\n },\\n \\"OssInfo\\": {\\n \\"ExportBasePath\\": \\"oss://testBucketName/data_result\\\\n\\",\\n \\"ResourceGroup\\": \\"aps\\",\\n \\"ResultFileTtl\\": 10\\n }\\n }\\n}","type":"json"}]', ], - 'GetSparkTemplateFolderTree' => [ - 'summary' => '查询Spark应用的目录结构。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSQLPatterns' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -22742,98 +16305,202 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '132328', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'title' => '数据库的ID', - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - 'maxLength' => 64, - ], + 'in' => 'query', + 'schema' => ['description' => 'AnalyticDB MySQL湖仓版集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-8vb8de93v9b****'], + ], + [ + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => ['description' => '查询开始时间。UTC时间，格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>。'."\n" + .'> - 仅支持查看最近14天的数据。'."\n" + .'- 查询开始时间和查询结束时间的间隔不能大于24小时。 ', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2022-09-06T03:06:00Z'], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => '查询结束时间。UTC时间，格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>。'."\n" + .'> 查询结束时间需晚于查询开始时间。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2022-09-07T03:06:00Z'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'Keyword', + 'in' => 'query', + 'schema' => ['description' => '查询关键字。', 'type' => 'string', 'required' => false, 'example' => 'SELECT'], + ], + [ + 'name' => 'Order', + 'in' => 'query', + 'schema' => ['description' => '将查询结果按指定字段进行排序。格式为JSON字符串，例如`[{"Field":"AverageQueryTime","Type":"Asc"}]`。其中：'."\n" + .'- `Field`表示排序字段。取值说明：'."\n" + .' - `PatternCreationTime`：查询时间范围内，Pattern的最早提交时间。'."\n" + .' - `AverageQueryTime`：查询时间范围内，Pattern的平均总耗时。'."\n" + .' - `MaxQueryTime`：查询时间范围内，Pattern的最大总耗时。'."\n" + .' - `AverageExecutionTime`: 查询时间范围内，Pattern的平均执行耗时。'."\n" + .' - `MaxExecutionTime`: 查询时间范围内，Pattern的最大执行耗时。'."\n" + .' - `AveragePeakMemory`: 查询时间范围内，Pattern的平均峰值内存。'."\n" + .' - `MaxPeakMemory`: 查询时间范围内，Pattern的最大峰值内存。'."\n" + .' - `AverageScanSize`: 查询时间范围内，Pattern的平均数据读取量。'."\n" + .' - `MaxScanSize`: 查询时间范围内，Pattern的最大数据读取量。'."\n" + .' - `QueryCount`: 查询时间范围内，Pattern的执行次数。'."\n" + .' - `FailedCount`: 查询时间范围内，Pattern的失败次数。'."\n" + ."\n" + .'- `Type`表示排序方式。取值说明（取值不区分大小写）：'."\n" + .' - `Asc`：升序排序。'."\n" + .' - `Desc`： 降序排序。', 'type' => 'string', 'required' => false, 'example' => '[{"Field":"AverageQueryTime","Type":"Asc"}]', 'default' => '[{"Type":"desc","Field":"AveragePeakMemory"}]'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码，取值：大于0且不超过Integer的最大值。'."\n" + .'默认值：1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '2'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数，取值：'."\n" + .'- **10**（默认值）'."\n" + .'- **30**'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'], + ], + [ + 'name' => 'Lang', + 'in' => 'query', + 'schema' => ['description' => '语言配置，取值说明：'."\n" + .'- **zh**：简体中文（默认语言）。'."\n" + .'- **en**：英文。'."\n" + .'- **ja**：日文。'."\n" + .'- **zh-tw**：繁体中文。', 'type' => 'string', 'required' => false, 'example' => 'zh'], + ], + [ + 'name' => 'UserName', + 'in' => 'query', + 'allowEmptyValue' => true, + 'schema' => ['description' => '执行SQL的数据库账号名称。', 'type' => 'string', 'required' => false, 'example' => 'test_user'], + ], + [ + 'name' => 'SqlPatternHash', + 'in' => 'query', + 'schema' => ['type' => 'integer', 'format' => 'int64'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => 'SQL Pattern的详细信息。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Data' => [ - 'title' => '模板文件的结构, 仅包含文件夹, 以树形结构展示.', - 'description' => 'Spark应用的目录结构，以树形结构展示。返回参数说明：'."\n" - .'- **Uid**：阿里云账号的UID。'."\n" - .'- **Type**：应用模板类型。取值说明：'."\n" - .' **FOLDER**：目录。'."\n" - .'- **Parent**：父级。取值说明：'."\n" - .' - **0**：无子目录。'."\n" - .' - **-1**：有子目录。'."\n" - .'- **Children**：子目录结构。'."\n" - .'- **LastModified**：最近一次修改目录中应用的时间，格式为Unix时间戳，单位秒（s）。'."\n" - .'- **Name**：目录名称。'."\n" - .'- **Id**：目录ID。', - 'type' => 'string', - 'example' => '{ "Uid":195813423****, "Type":"FOLDER", "Parent":-1, "Children":[ { "LastModified":1647853173, "Uid":195813423****, "Type":"FOLDER", "Parent":0, "Id":157, "Name":"t" } ], "Id":725204, "Name":"root" }', + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + 'PatternDetails' => [ + 'description' => '列表。', + 'type' => 'array', + 'items' => [ + 'description' => 'SQL Pattern的详细信息。', + 'type' => 'object', + 'properties' => [ + 'SQLPattern' => ['description' => 'SQL Pattern的语句。', 'type' => 'string', 'example' => 'SELECT * FROM KEPLER_META_NODE_STATIC_INFO WHERE elastic_node = ? OR (elastic_node = ? AND enable = ?)'], + 'PatternId' => ['description' => 'SQL Pattern语句的ID。', 'type' => 'string', 'example' => '5575924945138******'], + 'User' => ['description' => '提交Pattern相关的SQL数据库用户名称。', 'type' => 'string', 'example' => 'test'], + 'AccessIp' => ['description' => '提交Pattern的相关SQL客户端IP地址。', 'type' => 'string', 'example' => '192.168.xx.xx'], + 'Tables' => ['description' => 'SQL Pattern扫描的列表信息。', 'type' => 'string', 'example' => 'tpch.orders'], + 'PatternCreationTime' => ['description' => '指定时间范围内，Pattern的最早提交时间。', 'type' => 'string', 'example' => '2022-09-06 05:06:00'], + 'AverageQueryTime' => ['description' => '指定时间范围内，Pattern的平均总耗时。单位：毫秒。', 'type' => 'number', 'format' => 'double', 'example' => '4'], + 'MaxQueryTime' => ['description' => '指定时间范围内，Pattern的最大总耗时。单位：毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '2341'], + 'AverageExecutionTime' => ['description' => '指定时间范围内，Pattern的平均执行时间。单位：毫秒。', 'type' => 'number', 'format' => 'double', 'example' => '234.78'], + 'MaxExecutionTime' => ['description' => '指定时间范围内，Pattern的最大执行时间。单位：毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '2142'], + 'AveragePeakMemory' => ['description' => '指定时间范围内，Pattern的平均峰值内存。单位：Byte。', 'type' => 'number', 'format' => 'double', 'example' => '234.22'], + 'MaxPeakMemory' => ['description' => 'Pattern相关SQL的最大峰值内存，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '234149'], + 'AverageScanSize' => ['description' => '指定时间范围内，Pattern的平均数据读取量。单位：Byte。', 'type' => 'number', 'format' => 'double', 'example' => '234149.23'], + 'MaxScanSize' => ['description' => 'Pattern相关SQL的最大数据读取量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '32212254'], + 'QueryCount' => ['description' => '指定时间范围内，Pattern的执行次数。', 'type' => 'integer', 'format' => 'int64', 'example' => '345'], + 'FailedCount' => ['description' => '指定时间范围内，Pattern的失败次数。', 'type' => 'integer', 'format' => 'int64', 'example' => '18'], + 'Blockable' => ['description' => '能否拦截当前SQL Pattern的运行，取值说明：'."\n" + .'* **true**：支持拦截。'."\n" + .'* **false**：不支持拦截。'."\n" + .'> 目前AnalyticDB MySQL版仅支持Select和Insert相关语句的拦截。', 'type' => 'boolean', 'example' => 'true'], + 'QueryTimeSum' => ['description' => '耗时总量。单位：毫秒。', 'type' => 'number', 'format' => 'double', 'example' => '5'], + 'QueryTimePercentage' => ['description' => '单个Pattern在查询时间范围内的耗时总量，在所有Pattern中的占比。单位：%。', 'type' => 'number', 'format' => 'double', 'example' => '10'], + 'PeakMemorySum' => ['description' => '峰值内存总量，单位：Byte。', 'type' => 'number', 'format' => 'double', 'example' => '5'], + 'PeakMemoryPercentage' => ['description' => '单个 Pattern 在查询时间范围内的 峰值内存总量，在所有 Pattern 中的占比。单位：%。', 'type' => 'number', 'format' => 'double', 'example' => '10'], + 'ScanSizeSum' => ['description' => '数据扫描总量。单位：Byte。', 'type' => 'number', 'format' => 'double', 'example' => '5'], + 'ScanSizePercentage' => ['description' => '单个 Pattern 在查询时间范围内的 数据扫描总量，在所有 Pattern 中的占比。单位：%。', 'type' => 'number', 'format' => 'double', 'example' => '80'], + 'AverageOperatorCost' => ['description' => '平均CPU Cost。单位：毫秒。', 'type' => 'number', 'format' => 'double', 'example' => '5'], + 'MaxOperatorCost' => ['description' => '最大CPU Cost。单位：毫秒。', 'type' => 'number', 'format' => 'double', 'example' => '5'], + 'OperatorCostSum' => ['description' => 'CPU Cost总量。单位：毫秒。', 'type' => 'number', 'format' => 'double', 'example' => '5'], + 'OperatorCostPercentage' => ['description' => 'CPU Cost总量占比。单位：%。', 'type' => 'number', 'format' => 'double', 'example' => '20'], + 'AverageScanCost' => ['description' => '平均扫描耗时。', 'type' => 'number', 'format' => 'double', 'example' => '5'], + 'MaxScanCost' => ['description' => '最大扫描耗时。', 'type' => 'number', 'format' => 'double', 'example' => '5'], + 'ScanCostSum' => ['description' => '数据扫描Cost总量。单位：毫秒。', 'type' => 'number', 'format' => 'double', 'example' => '5'], + 'ScanCostPercentage' => ['description' => '数据扫描Cost总量占比。单位：%。', 'type' => 'number', 'format' => 'double', 'example' => '5'], + ], + ], ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'F3174013-5B7A-5A47-9FE0-6B5D397BD86A'], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], ], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + 'title' => '查询SQL Pattern列表', + 'summary' => '查看指定日期内AnalyticDB MySQL湖仓版集群的SQL Pattern列表。', + 'description' => '- 中心的公网接入地址：`adb.aliyuncs.com`。'."\n" + .'- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2025-06-28T01:09:13.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-08-06T08:01:23.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-05-14T08:33:01.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-12-08T02:33:56.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-06-08T06:16:59.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-22T04:03:34.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSQLPatterns'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeSQLPatterns', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": \\"{ \\\\\\"Uid\\\\\\":195813423****, \\\\\\"Type\\\\\\":\\\\\\"FOLDER\\\\\\", \\\\\\"Parent\\\\\\":-1, \\\\\\"Children\\\\\\":[ { \\\\\\"LastModified\\\\\\":1647853173, \\\\\\"Uid\\\\\\":195813423****, \\\\\\"Type\\\\\\":\\\\\\"FOLDER\\\\\\", \\\\\\"Parent\\\\\\":0, \\\\\\"Id\\\\\\":157, \\\\\\"Name\\\\\\":\\\\\\"t\\\\\\" } ], \\\\\\"Id\\\\\\":725204, \\\\\\"Name\\\\\\":\\\\\\"root\\\\\\" }\\"\\n}","errorExample":""},{"type":"xml","example":"<GetSparkTemplateFolderTreeResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Data>{ \\"Uid\\":195813423****, \\"Type\\":\\"FOLDER\\", \\"Parent\\":-1, \\"Children\\":[ { \\"LastModified\\":1647853173, \\"Uid\\":195813423****, \\"Type\\":\\"FOLDER\\", \\"Parent\\":0, \\"Id\\":157, \\"Name\\":\\"t\\" } ], \\"Id\\":725204, \\"Name\\":\\"root\\" }</Data>\\n</GetSparkTemplateFolderTreeResponse>","errorExample":""}]', - 'title' => '查询Spark应用的目录结构', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"PageNumber\\": 2,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 20,\\n \\"PatternDetails\\": [\\n {\\n \\"SQLPattern\\": \\"SELECT * FROM KEPLER_META_NODE_STATIC_INFO WHERE elastic_node = ? OR (elastic_node = ? AND enable = ?)\\",\\n \\"PatternId\\": \\"5575924945138******\\",\\n \\"User\\": \\"test\\",\\n \\"AccessIp\\": \\"192.168.xx.xx\\",\\n \\"Tables\\": \\"tpch.orders\\",\\n \\"PatternCreationTime\\": \\"2022-09-06 05:06:00\\",\\n \\"AverageQueryTime\\": 4,\\n \\"MaxQueryTime\\": 2341,\\n \\"AverageExecutionTime\\": 234.78,\\n \\"MaxExecutionTime\\": 2142,\\n \\"AveragePeakMemory\\": 234.22,\\n \\"MaxPeakMemory\\": 234149,\\n \\"AverageScanSize\\": 234149.23,\\n \\"MaxScanSize\\": 32212254,\\n \\"QueryCount\\": 345,\\n \\"FailedCount\\": 18,\\n \\"Blockable\\": true,\\n \\"QueryTimeSum\\": 5,\\n \\"QueryTimePercentage\\": 10,\\n \\"PeakMemorySum\\": 5,\\n \\"PeakMemoryPercentage\\": 10,\\n \\"ScanSizeSum\\": 5,\\n \\"ScanSizePercentage\\": 80,\\n \\"AverageOperatorCost\\": 5,\\n \\"MaxOperatorCost\\": 5,\\n \\"OperatorCostSum\\": 5,\\n \\"OperatorCostPercentage\\": 20,\\n \\"AverageScanCost\\": 5,\\n \\"MaxScanCost\\": 5,\\n \\"ScanCostSum\\": 5,\\n \\"ScanCostPercentage\\": 5\\n }\\n ],\\n \\"RequestId\\": \\"F3174013-5B7A-5A47-9FE0-6B5D397BD86A\\",\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeSQLPatternsResponse>\\n <PageNumber>2</PageNumber>\\n <PageSize>10</PageSize>\\n <TotalCount>20</TotalCount>\\n <PatternDetails>\\n <SQLPattern>SELECT * FROM KEPLER_META_NODE_STATIC_INFO WHERE elastic_node = ? OR (elastic_node = ? AND enable = ?)</SQLPattern>\\n <PatternId>5575924945138******</PatternId>\\n <User>test</User>\\n <AccessIp>192.168.xx.xx</AccessIp>\\n <Tables>tpch.orders</Tables>\\n <PatternCreationTime>2022-09-06 05:06:00</PatternCreationTime>\\n <AverageQueryTime>4</AverageQueryTime>\\n <MaxQueryTime>2341</MaxQueryTime>\\n <AverageExecutionTime>234.78</AverageExecutionTime>\\n <MaxExecutionTime>2142</MaxExecutionTime>\\n <AveragePeakMemory>234.22</AveragePeakMemory>\\n <MaxPeakMemory>234149</MaxPeakMemory>\\n <AverageScanSize>234149.23</AverageScanSize>\\n <MaxScanSize>32212254</MaxScanSize>\\n <QueryCount>345</QueryCount>\\n <FailedCount>18</FailedCount>\\n <Blockable>true</Blockable>\\n </PatternDetails>\\n <RequestId>F3174013-5B7A-5A47-9FE0-6B5D397BD86B</RequestId>\\n</DescribeSQLPatternsResponse>","errorExample":""}]', ], - 'GetSparkTemplateFullTree' => [ - 'summary' => '查看Spark应用的目录结构。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSQLWebSocketDomain' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -22845,100 +16512,88 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '180261', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['title' => 'RegionId', 'description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看指定AnalyticDB MySQL数仓版支持的地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], + ], + [ 'name' => 'DBClusterId', - 'in' => 'formData', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'>您可以通过[DescribeDBClusters](~~98094~~)接口查看账号下所有集群的详细信息，包括集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-bp1lw6g669zpi660'], + ], + [ + 'name' => 'Module', + 'in' => 'query', + 'allowEmptyValue' => false, 'schema' => [ - 'title' => '数据库的ID', - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', + 'description' => '应用模块名称。'."\n" + ."\n" + .'- SQLWebSocket：SQL开发。'."\n" + ."\n" + .'- Assistant：智能助手。', 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - 'maxLength' => 64, + 'required' => false, + 'enumValueTitles' => ['SQLWebSocket' => 'SQLWebSocket', 'Assistant' => 'Assistant'], + 'example' => 'Assistant', ], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Data' => [ - 'title' => '模板文件的树形结构', - 'description' => '应用模板的目录结构。返回参数说明：'."\n" - .'- **Uid**：阿里云账号的UID。'."\n" - .'- **Type**：应用模板类型。取值说明：'."\n" - .' - **FOLDER**：目录。'."\n" - .' - **FILE**：应用。'."\n" - .'- **Parent**：父级。取值：'."\n" - .' - **0**：无子目录。'."\n" - .' - **-1**：有子目录。'."\n" - .'- **Children**：子目录结构。'."\n" - .'- **LastModified**：最近一次修改应用的时间，格式为Unix时间戳，单位秒（s）。'."\n" - .'- **AppType**：应用类型。取值说明：'."\n" - .' - **SQL**：SQL应用。'."\n" - .' - **STREAMING**：流应用。'."\n" - .' - **BATCH**：离线应用。'."\n" - .'- **Name**：目录名称或应用名称。'."\n" - .'- **Id**：目录ID或应用ID。', - 'type' => 'string', - 'example' => '{ "Uid": 10415777****, "Type": "FOLDER", "Parent": -1, "Children": [ { "LastModified": 1648544748, "Uid": 104157779****, "Type": "FILE", "Parent": 0, "Id": s202204132****, "AppType": "SQL", "Name": "f" }, { "LastModified": 1648544956, "Uid": 1041577795****, "Type": "FOLDER", "Parent": 0, "Id": 157, "Name": "f3333" } ], "Id": 725204, "Name": "root" }', - ], + 'Code' => ['description' => '状态码。说明 200表示成功。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], + 'RequestId' => ['description' => '阿里云为该请求生成的唯一标识符。', 'type' => 'string', 'example' => 'E03F0806-A67B-5B24-8562-9589F20DEEB5'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Domain' => ['description' => '域名。', 'type' => 'string', 'example' => 'adb-ws-beijing.console.aliyun.com/query'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查看注册的WebSocket域名', + 'summary' => '查看注册的WebSocket域名。', + 'changeSet' => [ + ['createdAt' => '2025-09-16T01:29:23.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2025-09-12T03:57:51.000Z', 'description' => '请求参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSQLWebSocketDomain'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeSQLWebSocketDomain', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": \\"{ \\\\\\"Uid\\\\\\": 10415777****, \\\\\\"Type\\\\\\": \\\\\\"FOLDER\\\\\\", \\\\\\"Parent\\\\\\": -1, \\\\\\"Children\\\\\\": [ { \\\\\\"LastModified\\\\\\": 1648544748, \\\\\\"Uid\\\\\\": 104157779****, \\\\\\"Type\\\\\\": \\\\\\"FILE\\\\\\", \\\\\\"Parent\\\\\\": 0, \\\\\\"Id\\\\\\": s202204132****, \\\\\\"AppType\\\\\\": \\\\\\"SQL\\\\\\", \\\\\\"Name\\\\\\": \\\\\\"f\\\\\\" }, { \\\\\\"LastModified\\\\\\": 1648544956, \\\\\\"Uid\\\\\\": 1041577795****, \\\\\\"Type\\\\\\": \\\\\\"FOLDER\\\\\\", \\\\\\"Parent\\\\\\": 0, \\\\\\"Id\\\\\\": 157, \\\\\\"Name\\\\\\": \\\\\\"f3333\\\\\\" } ], \\\\\\"Id\\\\\\": 725204, \\\\\\"Name\\\\\\": \\\\\\"root\\\\\\" }\\"\\n}","errorExample":""},{"type":"xml","example":"<GetSparkTemplateFullTreeResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Data>{ \\"Uid\\": 10415777****, \\"Type\\": \\"FOLDER\\", \\"Parent\\": -1, \\"Children\\": [ { \\"LastModified\\": 1648544748, \\"Uid\\": 104157779****, \\"Type\\": \\"FILE\\", \\"Parent\\": 0, \\"Id\\": s202204132****, \\"AppType\\": \\"SQL\\", \\"Name\\": \\"f\\" }, { \\"LastModified\\": 1648544956, \\"Uid\\": 1041577795****, \\"Type\\": \\"FOLDER\\", \\"Parent\\": 0, \\"Id\\": 157, \\"Name\\": \\"f3333\\" } ], \\"Id\\": 725204, \\"Name\\": \\"root\\" }</Data>\\n</GetSparkTemplateFullTreeResponse>","errorExample":""}]', - 'title' => '查询Spark应用的目录结构', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"E03F0806-A67B-5B24-8562-9589F20DEEB5\\",\\n \\"Success\\": true,\\n \\"Domain\\": \\"adb-ws-beijing.console.aliyun.com/query\\"\\n}","type":"json"}]', ], - 'GetSparkTemplateFileContent' => [ - 'summary' => '获取Spark应用模板的内容。', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSchemas' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -22948,84 +16603,50 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '190445', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'title' => '数据库的id', - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-8vbn8pq537k8w****', - 'maxLength' => 64, - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'Id', - 'in' => 'formData', - 'schema' => [ - 'title' => '模板文件的ID', - 'description' => '应用模板ID。'."\n" - .'> 调用[GetSparkTemplateFullTree](~~456205~~)接口查询应用模板ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'minimum' => '0', - 'exclusiveMinimum' => true, - 'example' => '725204', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1xxxxxxxx47'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380', - ], - 'Data' => [ - 'description' => '返回数据。', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '25B56BC7-4978-40B3-9E48-4B7067******'], + 'Items' => [ 'type' => 'object', + 'itemNode' => true, 'properties' => [ - 'AppType' => [ - 'description' => '应用类型，取值说明：'."\n" - .'- **SQL**：SQL应用。'."\n" - .'- **STREAMING**：流应用。'."\n" - .'- **BATCH**：离线应用。', - 'type' => 'string', - 'example' => 'SQL', - ], - 'Content' => [ - 'description' => '应用模板内容。', - 'type' => 'string', - 'example' => 'set spark.driver.resourceSpec=medium;set spark.executor.instances=2;set spark.executor.resourceSpec=medium;set spark.app.name=Spark SQL Test;', - ], - 'Id' => [ - 'description' => '应用模板ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '725204', - ], - 'Type' => [ - 'description' => '文件类型，取值说明：'."\n" - .'- **folder**：目录（文件夹）。'."\n" - .'- **file**：文件。', - 'type' => 'string', - 'example' => 'file', - ], - 'ResourceGroupName' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'example' => 'test', + 'Schema' => [ + 'description' => '数据库列表。', + 'type' => 'array', + 'items' => [ + 'description' => '数据库信息。', + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-bp11q28kvl688****'], + 'SchemaName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'adb_demo'], + ], + ], ], ], + 'description' => '', ], ], ], @@ -23033,258 +16654,199 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.BadFileType', - 'errorMessage' => 'The requested template %s is not a file.', - ], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], ], - 404 => [ - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"AppType\\": \\"SQL\\",\\n \\"Content\\": \\"set spark.driver.resourceSpec=medium;set spark.executor.instances=2;set spark.executor.resourceSpec=medium;set spark.app.name=Spark SQL Test;\\",\\n \\"Id\\": 725204,\\n \\"Type\\": \\"file\\",\\n \\"ResourceGroupName\\": \\"test\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkTemplateFileContentResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <AppType>SQL</AppType>\\n <Content>set spark.driver.resourceSpec=medium;set spark.executor.instances=2;set spark.executor.resourceSpec=medium;set spark.app.name=Spark SQL Test;</Content>\\n <Id>725204</Id>\\n <Type>file</Type>\\n <ResourceGroupName>test</ResourceGroupName>\\n </Data>\\n</GetSparkTemplateFileContentResponse>","errorExample":""}]', - 'title' => '查询Spark应用模板的内容', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '枚举实例的库列表', + 'summary' => '查询指定实例的数据库列表信息。', 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', - ], - 'UpdateSparkTemplateFile' => [ - 'summary' => '更新Spark应用模板。', - 'methods' => [ - 'post', + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2025-05-07T05:42:07.000Z', 'description' => '错误码发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSchemas'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:describeAllDataSource', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"25B56BC7-4978-40B3-9E48-4B7067******\\",\\n \\"Items\\": {\\n \\"Schema\\": [\\n {\\n \\"DBClusterId\\": \\"amv-bp11q28kvl688****\\",\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeSparkAppDiagnosisInfo' => [ + 'summary' => '查询Spark应用诊断信息。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '123242', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '189113', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'title' => '数据库的ID', - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-pz5vp4585l466****', - 'maxLength' => 64, - ], + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~98094~~)接口查看目标地域下所有的集群信息，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-uf663j39b0jd2***'], ], [ - 'name' => 'Id', - 'in' => 'formData', - 'schema' => [ - 'title' => '模板文件ID', - 'description' => '应用模板ID。'."\n" - .'> 调用[GetSparkTemplateFullTree](~~456205~~)接口查询应用模板ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'minimum' => '0', - 'exclusiveMinimum' => true, - 'example' => '718056', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'Content', - 'in' => 'formData', - 'schema' => [ - 'title' => '模板文件内容', - 'description' => '应用模板数据。'."\n" - .'> 此参数不填写时，不更新应用模板。如何配置Spark应用模板，请参见[Spark应用配置指南](~~452402~~)。', - 'type' => 'string', - 'required' => false, - 'example' => 'set spark.driver.resourceSpec=medium;set spark.executor.instances=2;set spark.executor.resourceSpec=medium;set spark.app.name=Spark SQL Test;', - ], + 'name' => 'AppId', + 'in' => 'query', + 'schema' => ['description' => '应用ID。'."\n" + ."\n" + .'> 您可以调用[ListSparkApps](~~455888~~)接口查询所有的应用ID。', 'type' => 'string', 'required' => true, 'example' => 's202411061017sh0ad564b000****'], ], [ - 'name' => 'ResourceGroupName', - 'in' => 'formData', - 'schema' => [ - 'title' => '资源组的名称', - 'description' => 'Job型资源组名称。'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'adb', - ], + 'name' => 'Language', + 'in' => 'query', + 'schema' => ['description' => '语言类型，返回结果将以该语言展示。取值如下： '."\n" + ."\n" + .'- en：英文 '."\n" + .'- zh（默认值）：中文', 'type' => 'string', 'deprecated' => false, 'required' => true, 'example' => 'zh'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'C3A9594F-1D40-4472-A96C-8FB8AA20D38C', - ], - 'Data' => [ - 'description' => '更新结果。', - 'type' => 'object', - 'properties' => [ - 'Succeeded' => [ - 'title' => '是否更新成功', - 'description' => '应用模板更新是否成功，取值说明：'."\n" - .'- **True**：更新成功。'."\n" - .'- **False**：更新失败。', - 'type' => 'boolean', - 'example' => 'True', - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'FB5AC339-91F6-5000-8E5A-F47065B01B87'], + 'AppId' => ['description' => '应用ID。'."\n" + .'> 您可以调用[ListSparkApps](~~455888~~)接口查询所有的应用ID。', 'type' => 'string', 'example' => 's202404141952sz6a1391200****'], + 'StartedTime' => ['description' => '执行开始时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '1718329831000'], + 'DurationInMillis' => ['description' => 'Spark应用执行耗时，单位毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '281063'], + 'State' => ['description' => '需要查询的异步导入或导出任务的状态，取值说明如下：'."\n" + .'* **RUNNING**：任务进行中。'."\n" + .'* **FINISHED**：任务执行成功。'."\n" + .'* **FAILED**：任务执行失败。', 'type' => 'string', 'example' => 'FINISHED'], + 'CpuUtilization' => ['description' => 'CPU使用率。单位为百分比（%）。', 'type' => 'number', 'format' => 'double', 'example' => '100'], + 'PeakMemoryInByte' => ['description' => '峰值内存使用量，单位是Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '4096000'], + 'ShuffleWriteInByte' => ['description' => 'Shuffle写过程的数据量，单位是Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '4096000'], + 'ShuffleReadInByte' => ['description' => 'Shuffle读过程涉及到的数据量，单位是Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '4096000'], + 'SpillInByte' => ['description' => '内存不足时，交换写入到磁盘的数据量，单位是Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'JVMGcCostInMillis' => ['description' => 'Java虚拟机执行垃圾回收操作的耗时，单位是毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '81055'], + 'DiagnosisInfoList' => [ + 'description' => 'Spark分析信息列表。', + 'type' => 'array', + 'items' => ['description' => 'Spark分析信息。', '$ref' => '#/components/schemas/Adb4MysqlSparkDiagnosisInfo'], ], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.BadFileType', - 'errorMessage' => 'The requested template %s is not a file.', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.Log.IllegalPath', - 'errorMessage' => 'Invalid job log URI: %s.', - ], - [ - 'errorCode' => 'Spark.Log.InvalidState', - 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', - ], - [ - 'errorCode' => 'Spark.Oss.InternalError', - 'errorMessage' => 'An OSS internal error occurred: %s', - ], - [ - 'errorCode' => 'Spark.RoleArn.Invalid', - 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询Spark应用诊断信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkAppDiagnosisInfo'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.TemplateNotFound', - 'errorMessage' => 'The template %s is not found.', - ], - [ - 'errorCode' => 'Spark.Log.PodLogNotFound', - 'errorMessage' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkAppDiagnosisInfo', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C3A9594F-1D40-4472-A96C-8FB8AA20D38C\\",\\n \\"Data\\": {\\n \\"Succeeded\\": true\\n }\\n}","errorExample":""},{"type":"xml","example":"<UpdateSparkTemplateFileResponse>\\n <RequestId>C3A9594F-1D40-4472-A96C-8FB8AA20D38C</RequestId>\\n <Data>\\n <Succeeded>true</Succeeded>\\n </Data>\\n</UpdateSparkTemplateFileResponse>","errorExample":""}]', - 'title' => '更新Spark应用模板', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FB5AC339-91F6-5000-8E5A-F47065B01B87\\",\\n \\"AppId\\": \\"s202404141952sz6a1391200****\\",\\n \\"StartedTime\\": 1718329831000,\\n \\"DurationInMillis\\": 281063,\\n \\"State\\": \\"FINISHED\\",\\n \\"CpuUtilization\\": 100,\\n \\"PeakMemoryInByte\\": 4096000,\\n \\"ShuffleWriteInByte\\": 4096000,\\n \\"ShuffleReadInByte\\": 4096000,\\n \\"SpillInByte\\": 0,\\n \\"JVMGcCostInMillis\\": 81055,\\n \\"DiagnosisInfoList\\": [\\n {\\n \\"DiagnosisType\\": \\"APPLICATION\\",\\n \\"DiagnosisCode\\": \\"\\",\\n \\"DiagnosisCodeLabel\\": \\"\\",\\n \\"DiagnosisMsg\\": \\"\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', ], - 'DeleteSparkTemplateFile' => [ - 'summary' => '删除Spark模板文件。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSparkAppType' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', - 'abilityTreeCode' => '123240', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '189112', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ - 'name' => 'Id', - 'in' => 'formData', - 'schema' => [ - 'title' => '模板文件的ID', - 'description' => '需要删除模板的文件ID。'."\n" - .'> 调用[GetSparkTemplateFullTree](~~456205~~)接口查询所有现存的模板文件的ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'minimum' => '0', - 'exclusiveMinimum' => true, - 'example' => '284', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~98094~~)接口查看目标地域下所有的集群信息，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-wz9w49b12933****'], ], [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'title' => '数据库的ID', - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1y769u11748****', - 'maxLength' => 64, - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-shenzhen'], + ], + [ + 'name' => 'AppId', + 'in' => 'query', + 'schema' => ['description' => '应用ID。'."\n" + .'> 调用[ListSparkApps](~~612475~~)接口查询Spark应用的ID。', 'type' => 'string', 'required' => true, 'example' => 's202407161205sza4c07c1000****'], ], ], 'responses' => [ @@ -23292,165 +16854,61 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '596AF63B-8798-501E-BA06-CD2184D48A35'], + 'Type' => [ + 'description' => 'Spark应用的类型，可取值如下：'."\n" + .'- BATCH：批处理应用。'."\n" + .'- SQLENGINE：SQL引擎应用。', 'type' => 'string', - 'example' => 'C3A9594F-1D40-4472-A96C-8FB8AA20D38C', - ], - 'Data' => [ - 'description' => '删除结果。', - 'type' => 'object', - 'properties' => [ - 'Succeeded' => [ - 'description' => '是否成功删除，取值说明：'."\n" - .'- **true**：删除成功。'."\n" - .'- **false**：删除失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - ], + 'enumValueTitles' => ['SQLENGINE' => 'SQL引擎应用。', 'BATCH' => '批处理应用。'], + 'example' => 'Batch', ], + 'AccessDeniedDetail' => ['description' => '访问被拒绝的详细原因。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', - 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.FailedToKill', - 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', - 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.KillOperationFailed', - 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Log.IllegalPath', - 'errorMessage' => 'Invalid job log URI: %s.', - ], - [ - 'errorCode' => 'Spark.Log.InvalidState', - 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', - ], - [ - 'errorCode' => 'Spark.Oss.InternalError', - 'errorMessage' => 'An OSS internal error occurred: %s', - ], - [ - 'errorCode' => 'Spark.RoleArn.Invalid', - 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.BadFileType', - 'errorMessage' => 'The requested template %s is not a file.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询Spark应用类型', + 'summary' => '查询Spark应用类型。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkAppType'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.AnalyzeTask.NotFound', - 'errorMessage' => 'The requested analysis task %s is not found.', - ], - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.Log.PodLogNotFound', - 'errorMessage' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.TemplateNotFound', - 'errorMessage' => 'The template %s is not found.', - ], - ], - 406 => [ - [ - 'errorCode' => 'Spark.App.KillNotAcceptable', - 'errorMessage' => 'Can\'t kill the application %s in %s state.', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], - [ - 'errorCode' => 'Spark.Resources.LoadFileFromClasspathFailed', - 'errorMessage' => 'Can\'t load the content from file: %s', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkAppType', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C3A9594F-1D40-4472-A96C-8FB8AA20D38C\\",\\n \\"Data\\": {\\n \\"Succeeded\\": true\\n }\\n}","errorExample":""},{"type":"xml","example":"<DeleteSparkTemplateFileResponse>\\n <RequestId>C3A9594F-1D40-4472-A96C-8FB8AA20D38C</RequestId>\\n <Data>\\n <Succeeded>true</Succeeded>\\n </Data>\\n</DeleteSparkTemplateFileResponse>","errorExample":""}]', - 'title' => '删除Spark模板', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"596AF63B-8798-501E-BA06-CD2184D48A35\\",\\n \\"Type\\": \\"Batch\\",\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', ], - 'GetSparkAppAttemptLog' => [ - 'summary' => '查询Spark应用的重试日志。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSparkAuditLogRecords' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -23459,64 +16917,130 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '235459', + 'abilityTreeNodes' => ['FEATUREadsGAMOR7'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'AttemptId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'spark重试的id', - 'description' => '重试日志的ID。'."\n" - .'> 调用[ListSparkAppAttempts](~~455887~~)接口查询应用的重试历史信息，包含重试日志ID。', - 'type' => 'string', - 'required' => true, - 'example' => 's202207151211hz****-0001', - 'maxLength' => 72, - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + ."\n" + .'> - 您可以调用[DescribeDBClusters](~~454250~~)接口可以查询集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1j7******78j8i'], ], [ - 'name' => 'LogLength', - 'in' => 'formData', - 'schema' => [ - 'title' => '返回尾部日志的行数', - 'description' => '重试日志的行数。取值范围：1~500，默认值为300。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'maximum' => '500', - 'minimum' => '0', - 'exclusiveMinimum' => true, - 'example' => '20', - 'default' => '300', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~612293~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-shanghai'], + ], + [ + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => ['description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。'."\n" + .'> 建议查询开始时间设置为30天内的任意时间点。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2025-09-25T00:00Z'], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => '查询结束时间，需要大于查询开始时间，且与查询开始时间间隔小于1天。'."\n" + .'格式：yyyy-MM-ddTHH:mmZ（UTC时间）。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2025-09-25T01:00Z'], + ], + [ + 'name' => 'User', + 'in' => 'query', + 'schema' => ['description' => 'SQL执行用户名。', 'type' => 'string', 'required' => false, 'example' => 'test_user'], + ], + [ + 'name' => 'Order', + 'in' => 'query', + 'schema' => ['description' => '根据指定字段对SQL语句进行排序，格式为JSON，是一个有序JSON数组，按输入数组的顺序进行复合排序，包含`Field`和`Type`两个字段，例如`[{"Field":"TotalTime", "Type": "desc" }]`。其中：'."\n" + ."\n" + .'- `Field`表示需要排序的字段名，支持如下字段：'."\n" + .' - `ResourceGroupName`：资源组名称。'."\n" + .' - `Status`：SQL执行状态。'."\n" + .' - `User`：SQL执行用户名。'."\n" + .' - `ExecuteTime`：SQL执行开始时间。'."\n" + .' - `TotalTime`：SQL执行时长。'."\n" + .' - `ProcessId`：查询ID。'."\n" + .' - `ClientIp`：访问源地址。'."\n" + .' - `StatementSource`：查询发起来源。'."\n" + ."\n" + .'- `Type`表示排序类型，支持如下取值（取值均不区分大小写）：'."\n" + .' - `Desc`：降序。'."\n" + .' - `Asc`：升序。', 'type' => 'string', 'required' => false, 'example' => '[{\\"Field\\":\\"ExecuteTime\\",\\"Type\\":\\"Desc\\"}]'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '10', 'example' => '30', 'default' => '10'], ], [ 'name' => 'PageNumber', 'in' => 'query', + 'schema' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1'], + ], + [ + 'name' => 'ProxyUser', + 'in' => 'query', + 'schema' => ['description' => '废弃参数。', 'type' => 'string', 'required' => false, 'example' => 'user'], + ], + [ + 'name' => 'ResourceGroupName', + 'in' => 'query', + 'schema' => ['description' => '资源组名称。'."\n" + .'> 您可以调用[DescribeDBResourceGroup](~~612410~~)接口查看集群的资源组ID。', 'type' => 'string', 'required' => false, 'example' => 'test_job'], + ], + [ + 'name' => 'Status', + 'in' => 'query', 'schema' => [ - 'title' => '读取日志的其实偏移量。', - 'description' => '读取日志的其实偏移量。', - 'type' => 'integer', - 'format' => 'int32', + 'description' => 'SQL执行状态。', + 'type' => 'string', 'required' => false, - 'minimum' => '0', - 'example' => '1', - 'default' => '1', + 'enumValueTitles' => ['cancel' => '已取消。', 'finish' => '执行成功。', 'error' => '执行失败。', 'timeout' => '执行超时。'], + 'example' => 'finish', ], ], [ - 'name' => 'PageSize', + 'name' => 'StatementId', + 'in' => 'query', + 'schema' => ['description' => 'Statement ID。', 'type' => 'string', 'required' => false, 'example' => 'fbd22066-1c03-xxxx-aa16-6ae28288****'], + ], + [ + 'name' => 'TotalTime', + 'in' => 'query', + 'schema' => ['description' => 'SQL执行时长，单位：毫秒（ms）。', 'type' => 'string', 'required' => false, 'example' => '3000'], + ], + [ + 'name' => 'SQLText', + 'in' => 'query', + 'schema' => ['description' => 'SQL语句中的关键词。', 'type' => 'string', 'required' => false, 'example' => 'test_table_name'], + ], + [ + 'name' => 'ProcessId', + 'in' => 'query', + 'schema' => ['description' => '查询ID。', 'type' => 'string', 'required' => false, 'example' => '999f2439-6b10-xxxx-a5d3-daf3b35c****'], + ], + [ + 'name' => 'ClientIp', + 'in' => 'query', + 'schema' => ['description' => '访问源地址。', 'type' => 'string', 'required' => false, 'example' => '192.168.XX.XX'], + ], + [ + 'name' => 'StatementSource', 'in' => 'query', 'schema' => [ - 'title' => '一页的日志行数', - 'description' => '单页数据行数。', + 'description' => '查询发起来源。', 'type' => 'string', 'required' => false, - 'example' => '500', - 'default' => '100000', + 'enumValueTitles' => ['SQL_EDITOR' => 'SQL_EDITOR', 'JDBC' => 'JDBC'], + 'example' => 'SQL_EDITOR', ], ], ], @@ -23525,383 +17049,200 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'C3A9594F-1D40-4472-A96C-8FB8AA20D38C', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'LogContent' => [ - 'description' => '日志内容。', - 'type' => 'string', - 'example' => '22/04/22 15:30:49 INFO Utils: Start the dump task because s202207151211hz****-0001 app end, the interval is 238141ms;22/04/22 15:30:49 INFO AbstractConnector: Stopped Spark@5e774d9d{HTTP/1.1, (http/1.1)}{0.0.0.0:4040}', - ], - 'Message' => [ - 'description' => '返回告警信息，如任务执行失败或资源不足等，无告警时则返回为空。', - 'type' => 'string', - 'example' => 'WARNING: log file maybe deleted, please check oss path: oss://TestBucketName/applog/', - ], - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-bp1bg858bo8c****', - ], - 'AppId' => [ - 'description' => '应用ID。', - 'type' => 'string', - 'example' => 's202204132018hzprec1ac61a000****', - ], - 'LogSize' => [ - 'title' => '日志的行数，0代表没有有效日志。', - 'description' => '日志的行数，0代表没有有效日志。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '775946240', + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '100'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'string', 'example' => '30'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '2D5867CF-423F-559F-BBB1-199A289E****'], + 'PageNumber' => ['description' => '页码。', 'type' => 'string', 'example' => '1'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp1j7******78j8i'], + 'Items' => [ + 'description' => 'SQL记录列表。', + 'type' => 'array', + 'items' => [ + 'description' => '详情。', + 'type' => 'object', + 'properties' => [ + 'SQLText' => ['description' => 'SQL语句详情。', 'type' => 'string', 'example' => 'SELECT * FROM adb_hdfs_import_source'], + 'TotalTime' => ['description' => 'SQL执行时长，单位：毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '40000'], + 'ExecuteTime' => ['description' => 'SQL执行开始时间，UTC时间，格式为：yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'example' => '2022-01-23T16:05:08Z'], + 'User' => ['description' => 'SQL执行用户名。', 'type' => 'string', 'example' => 'test_user'], + 'StatementId' => ['description' => 'Statement ID。', 'type' => 'string', 'example' => 'fbd22066-1c03-xxxx-aa16-6ae28288****'], + 'Status' => [ + 'description' => 'SQL执行状态。', + 'type' => 'string', + 'enumValueTitles' => ['cancel' => '已取消。', 'finish' => '执行成功。', 'error' => '执行失败。', 'timeout' => '执行超时。'], + 'example' => 'finish', + ], + 'ResourceGroupName' => ['description' => '资源组名称。', 'type' => 'string', 'example' => 'test_job'], + 'AppId' => ['description' => 'Spark应用ID。', 'type' => 'string', 'example' => 's202411061011hzc5d6476000****'], + 'InnerQueryId' => ['description' => 'Spark 应用内部 query 执行 ID。', 'type' => 'string', 'example' => '1'], + 'IsDiagnosable' => ['description' => '是否可诊断。', 'type' => 'boolean', 'example' => 'true'], + 'ClientIp' => ['description' => '访问源地址。', 'type' => 'string', 'example' => '192.168.XX.XX'], + 'ProcessId' => ['description' => '查询ID。', 'type' => 'string', 'example' => '999f2439-6b10-xxxx-a5d3-daf3b35c****'], + 'StatementSource' => [ + 'description' => '查询发起来源。', + 'type' => 'string', + 'enumValueTitles' => ['SQL_EDITOR' => 'SQL_EDITOR', 'JDBC' => 'JDBC'], + 'example' => 'SQL_EDITOR', + ], + 'ErrorMsg' => ['description' => 'SQL执行错误信息。', 'type' => 'string', 'example' => 'notFoundIp'], + 'ErrorTrace' => ['description' => 'SQL执行错误堆栈。', 'type' => 'string', 'example' => 'notFoundIpException'], ], ], ], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '查询Spark Interactive资源组的SQL审计日志。', + 'summary' => '查询Spark Interactive资源组的SQL审计日志。', + 'description' => '仅当SQL审计状态为开启时，才能查询到SQL审计日志，且只支持查询30天内的SQL审计日志。如果中途关闭了SQL审计，再次打开时，仅能查询到再次打开后的SQL审计日志。'."\n" + ."\n" + .'><notice>本接口只能查询到，通过**Spark Interactive型资源组**执行的SQL审计日志。></notice>', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkAuditLogRecords'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkAuditLogRecords', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C3A9594F-1D40-4472-A96C-8FB8AA20D38C\\",\\n \\"Data\\": {\\n \\"LogContent\\": \\"22/04/22 15:30:49 INFO Utils: Start the dump task because s202207151211hz****-0001 app end, the interval is 238141ms;22/04/22 15:30:49 INFO AbstractConnector: Stopped Spark@5e774d9d{HTTP/1.1, (http/1.1)}{0.0.0.0:4040}\\",\\n \\"Message\\": \\"WARNING: log file maybe deleted, please check oss path: oss://TestBucketName/applog/\\",\\n \\"DBClusterId\\": \\"amv-bp1bg858bo8c****\\",\\n \\"AppId\\": \\"s202204132018hzprec1ac61a000****\\",\\n \\"LogSize\\": 775946240\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkAppAttemptLogResponse>\\n <RequestId>C3A9594F-1D40-4472-A96C-8FB8AA20D38C</RequestId>\\n <Data>\\n <LogContent>22/04/22 15:30:49 INFO Utils: Start the dump task because s202207151211hz****-0001 app end, the interval is 238141ms;22/04/22 15:30:49 INFO AbstractConnector: Stopped Spark@5e774d9d{HTTP/1.1, (http/1.1)}{0.0.0.0:4040}</LogContent>\\n <Message>WARNING: log file maybe deleted, please check oss path: oss://TestBucketName/applog/</Message>\\n </Data>\\n</GetSparkAppAttemptLogResponse>","errorExample":""}]', - 'title' => '查询Spark应用的重试日志', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"100\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"2D5867CF-423F-559F-BBB1-199A289E****\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"DBClusterId\\": \\"amv-bp1j7******78j8i\\",\\n \\"Items\\": [\\n {\\n \\"SQLText\\": \\"SELECT * FROM adb_hdfs_import_source\\",\\n \\"TotalTime\\": 40000,\\n \\"ExecuteTime\\": \\"2022-01-23T16:05:08Z\\",\\n \\"User\\": \\"test_user\\",\\n \\"StatementId\\": \\"fbd22066-1c03-xxxx-aa16-6ae28288****\\",\\n \\"Status\\": \\"finish\\",\\n \\"ResourceGroupName\\": \\"test_job\\",\\n \\"AppId\\": \\"s202411061011hzc5d6476000****\\",\\n \\"InnerQueryId\\": \\"1\\",\\n \\"IsDiagnosable\\": true,\\n \\"ClientIp\\": \\"192.168.XX.XX\\",\\n \\"ProcessId\\": \\"999f2439-6b10-xxxx-a5d3-daf3b35c****\\",\\n \\"StatementSource\\": \\"SQL_EDITOR\\",\\n \\"ErrorMsg\\": \\"notFoundIp\\",\\n \\"ErrorTrace\\": \\"notFoundIpException\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', ], - 'ListSparkApps' => [ - 'summary' => '查看Spark应用列表。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSparkCodeLog' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'title' => '数据库的ID', - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], - ], - [ - 'name' => 'ResourceGroupName', - 'in' => 'query', - 'schema' => [ - 'description' => 'Job型资源组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_instance', - ], - ], - [ - 'name' => 'PageNumber', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => '页码号', - 'description' => '页码，取值为正整数。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'minimum' => '1', - 'example' => '1', - ], + 'schema' => ['title' => 'RegionId', 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'PageSize', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **10**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'maximum' => '100', - 'minimum' => '1', - 'example' => '30', - 'default' => '10', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-uf6o6m8p6x7v****'], ], [ - 'name' => 'Filters', + 'name' => 'JobId', 'in' => 'query', - 'schema' => [ - 'description' => '以JSON格式的字符串来定义过滤条件，在JSON中可以使用的合法的KEY值和业务含义如下：'."\n" - .'- SubmittedTimeRange：开始时间。'."\n" - .'- TerminatedTimeRange： 结束时间。'."\n" - .'- AppStates：Spark作业的状态。'."\n" - .'- AppId：Spark作业的ID。'."\n" - .'- AppNameRegex: Spark作业的名称的正则表达式。'."\n" - .'- Tag：tag信息。'."\n" - .'- ResourceGroupName：资源组名称。'."\n" - ."\n" - .'其中开始时间和结束时间过滤条件，通过如下的子结构来输入范围：'."\n" - .'- Min：时间范围的下限，null代表无限制。'."\n" - .'- Max：时间范围的上限，null代表无限制。', - 'type' => 'string', - 'required' => false, - 'example' => '{'."\n" - .'"SubmittedTimeRang": {'."\n" - .' "Max": 10000,'."\n" - .' "Min": 0'."\n" - .' },'."\n" - .' "TerminatedTimeRange": {'."\n" - .' "Max": 10000,'."\n" - .' "Min": 0'."\n" - .' },'."\n" - .' "AppStates": ["STARTING"],'."\n" - .' "AppId": "adc",'."\n" - .' "AppNameRegex": "cde",'."\n" - .' "AttemptId": "abc-001"'."\n" - .'}', - ], + 'schema' => ['description' => 'Spark Job 任务ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1248'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], - 'TotalCount' => [ - 'description' => '总记录条数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'AppInfoList' => [ - 'description' => '应用信息列表。返回参数说明：'."\n" - .'- **Data**：Spark应用模板数据。'."\n" - .'- **EstimateExecutionCpuTimeInSeconds**：执行Spark应用消耗CPU的时长，单位毫秒（ms）。'."\n" - .'- **LogRootPath**：日志文件存储路径。'."\n" - .'- **LastAttemptId**：重试ID。'."\n" - .'- **WebUiAddress**：Web UI地址。'."\n" - .'- **SubmittedTimeInMillis**：提交Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **StartedTimeInMillis**：Spark应用的创建时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **LastUpdatedTimeInMillis**：最近一次更新Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **TerminatedTimeInMillis**：Spark应用终止执行的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **DBClusterId**：执行Spark应用的集群ID。'."\n" - .'- **ResourceGroupName**：Job型资源组名称。'."\n" - .'- **DurationInMillis**：Spark应用执行耗时，单位毫秒（ms）。', - 'type' => 'array', - 'items' => [ - 'description' => '应用信息列表。返回参数说明：'."\n" - .'- **Data**：Spark应用模板数据。'."\n" - .'- **EstimateExecutionCpuTimeInSeconds**：执行Spark应用消耗CPU的时长，单位毫秒（ms）。'."\n" - .'- **LogRootPath**：日志文件存储路径。'."\n" - .'- **LastAttemptId**：重试ID。'."\n" - .'- **WebUiAddress**：Web UI地址。'."\n" - .'- **SubmittedTimeInMillis**：提交Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **StartedTimeInMillis**：Spark应用的创建时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **LastUpdatedTimeInMillis**：最近一次更新Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **TerminatedTimeInMillis**：Spark应用终止执行的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **DBClusterId**：执行Spark应用的集群ID。'."\n" - .'- **ResourceGroupName**：Job型资源组名称。'."\n" - .'- **DurationInMillis**：Spark应用执行耗时，单位毫秒（ms）。', - 'example' => '{'."\n" - .' "AppId": "test-app-id",'."\n" - .' "State": "Running",'."\n" - .' "Detail": {'."\n" - .' "LastAttemptId": "0001",'."\n" - .' "WebUiAddress": "http://spark-ui:4040",'."\n" - .' "SubmittedTimeInMillis": 1644805200260,'."\n" - .' "DBClusterId": "db",'."\n" - .' "EstimateExecutionCpuTimeInSeconds": 1644812400,'."\n" - .' "AppConf": "{}",'."\n" - .' "StartedTimeInMillis": 1644806400260,'."\n" - .' "LastUpdatedTimeInMillis": 1644808800260,'."\n" - .' "ResourceGroupName": "rg"'."\n" - .' },'."\n" - .' "AppName": "test app name"'."\n" - .' }', - '$ref' => '#/components/schemas/SparkAppInfo', - ], - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - ], - ], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1CD65640-9963-5D60-929C-118F2C84070E'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Log' => ['description' => '日志内容。', 'type' => 'string', 'example' => '>>>>>>>> stdout:n++++++++++++++++++executing sql: MSCK REPAIR TABLE `footprint_ethereum`.`dwd_eth_eth_txr_v2_di` n++n'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + 'title' => '查询产品的代码日志', + 'summary' => '查询Spark code的执行日志。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2022-09-06T02:42:53.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkCodeLog'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkCodeLog', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"AppInfoList\\": [\\n {\\n \\"AppId\\": \\"s202207151211hz0cb4*****\\",\\n \\"AppName\\": \\"Spark Test\\",\\n \\"Priority\\": \\"NORMAL\\",\\n \\"State\\": \\"FAILED\\",\\n \\"Message\\": \\"WARN: Disk is full\\",\\n \\"Detail\\": {\\n \\"DurationInMillis\\": 100,\\n \\"LogRootPath\\": \\"oss://<bucket-name>/logs/driver\\",\\n \\"DBClusterId\\": \\"amv-bp11q28kv****\\",\\n \\"Data\\": \\"{ \\\\\\"name\\\\\\": \\\\\\"SparkPi\\\\\\", \\\\\\"file\\\\\\": \\\\\\"local:///tmp/spark-examples.jar\\\\\\", \\\\\\"className\\\\\\": \\\\\\"org.apache.spark.examples.SparkPi\\\\\\", \\\\\\"args\\\\\\": [ \\\\\\"1000000\\\\\\" ], \\\\\\"conf\\\\\\": { \\\\\\"spark.driver.resourceSpec\\\\\\": \\\\\\"small\\\\\\", \\\\\\"spark.executor.instances\\\\\\": 1, \\\\\\"spark.executor.resourceSpec\\\\\\": \\\\\\"small\\\\\\" } }\\",\\n \\"EstimateExecutionCpuTimeInSeconds\\": 100,\\n \\"LastUpdatedTimeInMillis\\": 1651213645200,\\n \\"RunningStartTimeInMillis\\": 36000,\\n \\"LastAttemptId\\": \\"s202204291426hzpre60cfa*****-0003\\",\\n \\"TerminatedTimeInMillis\\": 1651213645300,\\n \\"ResourceProvisioningDurationInMillis\\": 36000,\\n \\"ExecutionDurationInMillis\\": 36000,\\n \\"WebUiAddress\\": \\"https://sparkui.aliyuncs.com/token=xxx\\",\\n \\"SubmittedTimeInMillis\\": 1651213645000,\\n \\"StartedTimeInMillis\\": 1651213645010,\\n \\"AppType\\": \\"BATCH\\",\\n \\"ResourceGroupName\\": \\"spark-rg\\"\\n },\\n \\"DBClusterId\\": \\"amv-23xxxx\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 1\\n }\\n}","errorExample":""},{"type":"xml","example":"<ListSparkAppsResponse>\\n <PageNumber>1</PageNumber>\\n <PageSize>10</PageSize>\\n <TotalCount>1</TotalCount>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <AppInfoList>\\n <AppId>s202207151211hz0cb4*****</AppId>\\n <AppName>Spark Test</AppName>\\n <State>FAILED</State>\\n <Message>WARN: Disk is full</Message>\\n <Detail>\\n <Data>{ \\"name\\": \\"SparkPi\\", \\"file\\": \\"local:///tmp/spark-examples.jar\\", \\"className\\": \\"org.apache.spark.examples.SparkPi\\", \\"args\\": [ \\"1000000\\" ], \\"conf\\": { \\"spark.driver.resourceSpec\\": \\"small\\", \\"spark.executor.instances\\": 1, \\"spark.executor.resourceSpec\\": \\"small\\" } }</Data>\\n <EstimateExecutionCpuTimeInSeconds>100</EstimateExecutionCpuTimeInSeconds>\\n <LogRootPath>oss://<bucket-name>/logs/driver</LogRootPath>\\n <LastAttemptId>s202204291426hzpre60cfa*****-0003</LastAttemptId>\\n <WebUiAddress>https://sparkui.aliyuncs.com/token=xxx</WebUiAddress>\\n <SubmittedTimeInMillis>1651213645000</SubmittedTimeInMillis>\\n <StartedTimeInMillis>1651213645010</StartedTimeInMillis>\\n <LastUpdatedTimeInMillis>1651213645200</LastUpdatedTimeInMillis>\\n <TerminatedTimeInMillis>1651213645300</TerminatedTimeInMillis>\\n <DBClusterId>amv-bp11q28kv****</DBClusterId>\\n <ResourceGroupName>spark-rg</ResourceGroupName>\\n <DurationInMillis>100</DurationInMillis>\\n </Detail>\\n </AppInfoList>\\n <PageNumber>1</PageNumber>\\n <PageSize>10</PageSize>\\n <TotalCount>1</TotalCount>\\n </Data>\\n</ListSparkAppsResponse>","errorExample":""}]', - 'title' => '查询Spark应用列表', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"1CD65640-9963-5D60-929C-118F2C84070E\\",\\n \\"Success\\": true,\\n \\"Log\\": \\">>>>>>>> stdout:n++++++++++++++++++executing sql: MSCK REPAIR TABLE `footprint_ethereum`.`dwd_eth_eth_txr_v2_di` n++n\\"\\n}","type":"json"}]', ], - 'GetSparkAppInfo' => [ - 'summary' => '查看Spark应用的信息。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSparkCodeOutput' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ - 'name' => 'AppId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'spark app的id', - 'description' => '应用ID。'."\n" - .'> 您可以调用[ListSparkApps](~~455888~~)接口查询Spark应用的ID。', - 'type' => 'string', - 'required' => true, - 'example' => 's202205201533hz1209892000****', - 'maxLength' => 64, - 'minLength' => 0, - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['title' => 'RegionId', 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n\n" - .'> 您可以调用[DescribeDBClusters](~~612397~~)接口查看集群的集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'am-bp11q28kvl688****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~612397~~)接口查询目标地域下集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-uf6210mmev07****'], + ], + [ + 'name' => 'JobId', + 'in' => 'query', + 'schema' => ['description' => 'Spark Job 任务ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '620'], ], ], 'responses' => [ @@ -23909,217 +17250,80 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Success' => ['description' => '调用是否成功。'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Output' => [ + 'description' => '执行的输出，为JSON对象格式。', 'type' => 'string', - 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380', - ], - 'Data' => [ - 'description' => 'Spark应用的信息。返回参数说明：'."\n" - .'- **Data**：Spark应用模板数据。'."\n" - .'- **EstimateExecutionCpuTimeInSeconds**：执行Spark应用消耗CPU的时长，单位毫秒（ms）。'."\n" - .'- **LogRootPath**：日志文件存储路径。'."\n" - .'- **LastAttemptId**：重试ID。'."\n" - .'- **WebUiAddress**：Web UI地址。'."\n" - .'- **SubmittedTimeInMillis**：提交Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **StartedTimeInMillis**：Spark应用的创建时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **LastUpdatedTimeInMillis**：最近一次更新Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **TerminatedTimeInMillis**：Spark应用终止执行的时间，Unix时间戳，单位毫秒（ms）。'."\n" - .'- **DBClusterId**：执行Spark应用的集群ID。'."\n" - .'- **ResourceGroupName**：Job型资源组名称。'."\n" - .'- **DurationInMillis**：Spark应用执行耗时，单位毫秒（ms）。', - 'example' => '{ \\"name\\": \\"SparkPi\\", \\"file\\": \\"local:///tmp/spark-examples.jar\\", \\"className\\": \\"org.apache.spark.examples.SparkPi\\", \\"args\\": [ \\"1000000\\" ], \\"conf\\": { \\"spark.driver.resourceSpec\\": \\"small\\", \\"spark.executor.instances\\": 1, \\"spark.executor.resourceSpec\\": \\"small\\" } }",'."\n" - .' "EstimateExecutionCpuTimeInSeconds" : 100,'."\n" - .' "LogRootPath" : "oss://test/logs/driver",'."\n" - .' "LastAttemptId" : "s202204291426hzpre60cfabb0000004-0003",'."\n" - .' "WebUiAddress" : "https://sparkui.aliyuncs.com/token=xxx",'."\n" - .' "SubmittedTimeInMillis" : 1651213645000,'."\n" - .' "StartedTimeInMillis" : 1651213645010,'."\n" - .' "LastUpdatedTimeInMillis" : 1651213645200,'."\n" - .' "TerminatedTimeInMillis" : 1651213645300,'."\n" - .' "DBClusterId" : "am-dbclusterid",'."\n" - .' "ResourceGroupName" : "spark-rg",'."\n" - .' "DurationInMillis" : 100'."\n" - .' }', - '$ref' => '#/components/schemas/SparkAppInfo', + 'enumValueTitles' => [], + 'example' => '"{\\"schema\\":[\\"id\\",\\"name\\",\\"age\\"],\\"data\\":[\\"{\\\\\\"id\\\\\\":10,\\\\\\"name\\\\\\":\\\\\\"z\\\\\\",\\\\\\"age\\\\\\":123}\\",\\"{\\\\\\"id\\\\\\":2,\\\\\\"name\\\\\\":\\\\\\"b\\\\\\",\\\\\\"age\\\\\\":17}\\",\\"{\\\\\\"id\\\\\\":1,\\\\\\"name\\\\\\":\\\\\\"a\\\\\\",\\\\\\"age\\\\\\":15}\\",\\"{\\\\\\"id\\\\\\":3,\\\\\\"name\\\\\\":\\\\\\"c\\\\\\",\\\\\\"age\\\\\\":222}\\",\\"{\\\\\\"id\\\\\\":10,\\\\\\"name\\\\\\":\\\\\\"z\\\\\\",\\\\\\"age\\\\\\":123}\\"],\\"haveRows\\":true,\\"rowNumber\\":6}"', ], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', - 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.FailedToKill', - 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', - 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.KillOperationFailed', - 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Log.IllegalPath', - 'errorMessage' => 'Invalid job log URI: %s.', - ], - [ - 'errorCode' => 'Spark.Log.InvalidState', - 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', - ], - [ - 'errorCode' => 'Spark.Oss.InternalError', - 'errorMessage' => 'An OSS internal error occurred: %s', - ], - [ - 'errorCode' => 'Spark.RoleArn.Invalid', - 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.BadFileType', - 'errorMessage' => 'The requested template %s is not a file.', - ], - ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + 'title' => '查询产品的代码配置详情', + 'summary' => '获取spark代码的执行结果。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2022-09-06T02:42:53.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkCodeOutput'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.AnalyzeTask.NotFound', - 'errorMessage' => 'The requested analysis task %s is not found.', - ], - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.Log.PodLogNotFound', - 'errorMessage' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.TemplateNotFound', - 'errorMessage' => 'The template %s is not found.', - ], - ], - 406 => [ - [ - 'errorCode' => 'Spark.App.KillNotAcceptable', - 'errorMessage' => 'Can\'t kill the application %s in %s state.', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', - ], - [ - 'errorCode' => 'Spark.Resources.LoadFileFromClasspathFailed', - 'errorMessage' => 'Can\'t load the content from file: %s', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkCodeOutput', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202207151211hz0cb4*****\\",\\n \\"AppName\\": \\"Spark Test\\",\\n \\"Priority\\": \\"NORMAL\\",\\n \\"State\\": \\"FAILED\\",\\n \\"Message\\": \\"WARN: Disk is full\\",\\n \\"Detail\\": {\\n \\"DurationInMillis\\": 100,\\n \\"LogRootPath\\": \\"oss://<bucket-name>/logs/driver\\",\\n \\"DBClusterId\\": \\"amv-bp11q28kv****\\",\\n \\"Data\\": \\"{ \\\\\\"name\\\\\\": \\\\\\"SparkPi\\\\\\", \\\\\\"file\\\\\\": \\\\\\"local:///tmp/spark-examples.jar\\\\\\", \\\\\\"className\\\\\\": \\\\\\"org.apache.spark.examples.SparkPi\\\\\\", \\\\\\"args\\\\\\": [ \\\\\\"1000000\\\\\\" ], \\\\\\"conf\\\\\\": { \\\\\\"spark.driver.resourceSpec\\\\\\": \\\\\\"small\\\\\\", \\\\\\"spark.executor.instances\\\\\\": 1, \\\\\\"spark.executor.resourceSpec\\\\\\": \\\\\\"small\\\\\\" } }\\",\\n \\"EstimateExecutionCpuTimeInSeconds\\": 100,\\n \\"LastUpdatedTimeInMillis\\": 1651213645200,\\n \\"RunningStartTimeInMillis\\": 36000,\\n \\"LastAttemptId\\": \\"s202204291426hzpre60cfa*****-0003\\",\\n \\"TerminatedTimeInMillis\\": 1651213645300,\\n \\"ResourceProvisioningDurationInMillis\\": 36000,\\n \\"ExecutionDurationInMillis\\": 36000,\\n \\"WebUiAddress\\": \\"https://sparkui.aliyuncs.com/token=xxx\\",\\n \\"SubmittedTimeInMillis\\": 1651213645000,\\n \\"StartedTimeInMillis\\": 1651213645010,\\n \\"AppType\\": \\"BATCH\\",\\n \\"ResourceGroupName\\": \\"spark-rg\\"\\n },\\n \\"DBClusterId\\": \\"amv-23xxxx\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkAppInfoResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <AppId>s202207151211hz0cb4*****</AppId>\\n <AppName>Spark Test</AppName>\\n <State>FAILED</State>\\n <Message>WARN: Disk is full</Message>\\n <Detail>\\n <Data>{ \\"name\\": \\"SparkPi\\", \\"file\\": \\"local:///tmp/spark-examples.jar\\", \\"className\\": \\"org.apache.spark.examples.SparkPi\\", \\"args\\": [ \\"1000000\\" ], \\"conf\\": { \\"spark.driver.resourceSpec\\": \\"small\\", \\"spark.executor.instances\\": 1, \\"spark.executor.resourceSpec\\": \\"small\\" } }</Data>\\n <EstimateExecutionCpuTimeInSeconds>100</EstimateExecutionCpuTimeInSeconds>\\n <LogRootPath>oss://<bucket-name>/logs/driver</LogRootPath>\\n <LastAttemptId>s202204291426hzpre60cfa*****-0003</LastAttemptId>\\n <WebUiAddress>https://sparkui.aliyuncs.com/token=xxx</WebUiAddress>\\n <SubmittedTimeInMillis>1651213645000</SubmittedTimeInMillis>\\n <StartedTimeInMillis>1651213645010</StartedTimeInMillis>\\n <LastUpdatedTimeInMillis>1651213645200</LastUpdatedTimeInMillis>\\n <TerminatedTimeInMillis>1651213645300</TerminatedTimeInMillis>\\n <DBClusterId>amv-bp11q28kv****</DBClusterId>\\n <ResourceGroupName>spark-rg</ResourceGroupName>\\n <DurationInMillis>100</DurationInMillis>\\n </Detail>\\n </Data>\\n</GetSparkAppInfoResponse>","errorExample":""}]', - 'title' => '查询Spark应用的信息', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"Output\\": \\"\\\\\\"{\\\\\\\\\\\\\\"schema\\\\\\\\\\\\\\":[\\\\\\\\\\\\\\"id\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"age\\\\\\\\\\\\\\"],\\\\\\\\\\\\\\"data\\\\\\\\\\\\\\":[\\\\\\\\\\\\\\"{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"id\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":10,\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"z\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"age\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":123}\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"id\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":2,\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"b\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"age\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":17}\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"id\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":1,\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"a\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"age\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":15}\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"id\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":3,\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"c\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"age\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":222}\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"id\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":10,\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"z\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"age\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":123}\\\\\\\\\\\\\\"],\\\\\\\\\\\\\\"haveRows\\\\\\\\\\\\\\":true,\\\\\\\\\\\\\\"rowNumber\\\\\\\\\\\\\\":6}\\\\\\"\\"\\n}","type":"json"}]', ], - 'GetSparkAppState' => [ - 'summary' => '查询Spark应用的状态。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSparkCodeWebUi' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ - 'name' => 'AppId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'spark app的id', - 'description' => '应用ID。'."\n" - .'> 可调用[ListSparkApps](~~455888~~)接口查询Spark应用ID。', - 'type' => 'string', - 'required' => true, - 'example' => 's202204191546hzpread6a896000****', - 'maxLength' => 64, - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['title' => 'RegionId', 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~612397~~)接口查询目标地域中所有集群的集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-bp1h405854m****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1v6usq6m65****'], + ], + [ + 'name' => 'JobId', + 'in' => 'query', + 'schema' => ['description' => 'Spark Job 任务ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1248'], ], ], 'responses' => [ @@ -24127,153 +17331,50 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'AppId' => [ - 'description' => '应用ID。', - 'type' => 'string', - 'example' => 's202204191546hzpread6a896000****', - ], - 'AppName' => [ - 'description' => '应用名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'Message' => [ - 'description' => '返回告警信息，如任务执行失败或资源不足等，无告警时则返回为空。', - 'type' => 'string', - 'example' => 'Insufficient resources.', - ], - 'State' => [ - 'title' => 'spark app的状态', - 'description' => '应用执行状态，取值说明：'."\n" - .'- **SUBMITTED**：已提交。'."\n" - .'- **STARTING**：开始启动。'."\n" - .'- **RUNNING**：执行中。'."\n" - .'- **FAILING**：任务失败，清理环境中。'."\n" - .'- **FAILED**：失败。'."\n" - .'- **KILLING**：中止任务，清理环境中。'."\n" - .'- **KILLED**：中止任务。'."\n" - .'- **SUCCEEDING**：任务执行结束，清理环境中。'."\n" - .'- **COMPLETED**：已完成。'."\n" - .'- **FATAL**：意外失败。'."\n" - .'- **UNKNOWN**：未知错误。', - 'type' => 'string', - 'example' => 'COMPLETED', - ], - 'DBClusterId' => [ - 'title' => '数据库ID', - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp1h405854m****', - 'default' => 'DB_CLUSTER_ID', - ], - ], - ], + 'Message' => ['description' => '应用建议执行结果。取值说明：'."\n" + .'- 请求正常，返回**SUCCESS**。 '."\n" + .'- 请求异常，返回具体异常错误信息。', 'type' => 'string', 'example' => 'Success'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '774DDC37-1908-58F6-B9CA-99E3E45965A6'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Url' => ['description' => 'Spark UI地址', 'type' => 'string', 'example' => 'https://adb-subuser-cn-hangzhou-1358535755648527-100000648.oss-cn-hangzhou.aliyuncs.com/%3Facl?Expires=1681295967&OSSAccessKeyId=LTAI5tB7NAkm25oiGASu****&Signature=hKAZ1vgvhJ%2FD8hNHTuX%2FOOBWht****'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', - 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.FailedToKill', - 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', - 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Log.InvalidState', - 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', - ], - ], - 404 => [ - [ - 'errorCode' => 'Spark.AnalyzeTask.NotFound', - 'errorMessage' => 'The requested analysis task %s is not found.', - ], - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.TemplateNotFound', - 'errorMessage' => 'The template %s is not found.', - ], + 'title' => '查询Spark code的web ui', + 'summary' => '查询Spark应用的Web UI地址。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2022-09-06T02:42:53.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkCodeWebUi'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkCodeWebUi', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202204191546hzpread6a896000****\\",\\n \\"AppName\\": \\"test\\",\\n \\"Message\\": \\"Insufficient resources.\\",\\n \\"State\\": \\"COMPLETED\\",\\n \\"DBClusterId\\": \\"amv-bp1h405854m****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkAppStateResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <AppId>s202204191546hzpread6a896000****</AppId>\\n <AppName>test</AppName>\\n <Message>Insufficient resources.</Message>\\n <State>COMPLETED</State>\\n </Data>\\n</GetSparkAppStateResponse>","errorExample":""}]', - 'title' => '查询Spark应用的状态', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。、'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"774DDC37-1908-58F6-B9CA-99E3E45965A6\\",\\n \\"Success\\": true,\\n \\"Url\\": \\"https://adb-subuser-cn-hangzhou-1358535755648527-100000648.oss-cn-hangzhou.aliyuncs.com/%3Facl?Expires=1681295967&OSSAccessKeyId=LTAI5tB7NAkm25oiGASu****&Signature=hKAZ1vgvhJ%2FD8hNHTuX%2FOOBWht****\\"\\n}","type":"json"}]', ], - 'GetSparkAppLog' => [ - 'summary' => '查询Spark应用的日志。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSparkSQLDiagnosisAttribute' => [ + 'summary' => '查询单个Spark SQL的诊断详情。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -24283,74 +17384,42 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '197163', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ - 'name' => 'AppId', - 'in' => 'formData', - 'schema' => [ - 'title' => '应用Id', - 'description' => '应用ID。'."\n" - .'> 调用[ListSparkApps](~~612475~~)接口查询Spark应用的ID。', - 'type' => 'string', - 'required' => true, - 'example' => 's202206061441hz22a35ab000****', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> * 您可以调用[DescribeDBClusters](~~98094~~)接口查看目标地域下所有的集群信息，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-2zeq4788qyy7k662'], ], [ - 'name' => 'LogLength', - 'in' => 'formData', - 'schema' => [ - 'title' => '需要返回的尾部日志行数.', - 'description' => '日志的行数。取值范围为1~500，默认值为300。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'maximum' => '500', - 'minimum' => '0', - 'exclusiveMinimum' => true, - 'example' => '20', - 'default' => '300', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DBClusterId', + 'name' => 'AppId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-2ze6fl8ud7t***', - ], + 'schema' => ['description' => '应用ID。'."\n" + .'> 调用[ListSparkApps](~~612475~~)接口查询Spark应用的ID。', 'type' => 'string', 'required' => true, 'example' => 's202411071444hzdvk486d9d2001****'], ], [ - 'name' => 'PageNumber', + 'name' => 'InnerQueryId', 'in' => 'query', - 'schema' => [ - 'title' => '读取日志的偏移量。', - 'description' => '读取日志的页码号。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'minimum' => '0', - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => 'Spark 应用内部 query 执行 ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'maximum' => '9223372036854775807', 'exclusiveMaximum' => true, 'minimum' => '-2', 'exclusiveMinimum' => true, 'example' => '1'], ], [ - 'name' => 'PageSize', + 'name' => 'Language', 'in' => 'query', - 'schema' => [ - 'description' => '单页数据行数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '500', - 'default' => '100000', - ], + 'schema' => ['description' => '语言类型。系统权限策略的描述将以此语言返回。'."\n" + ."\n" + .'- en：英文。'."\n" + .'- zh：中文。', 'type' => 'string', 'required' => true, 'example' => 'zh'], ], ], 'responses' => [ @@ -24358,527 +17427,301 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'C3A9594F-1D40-4472-A96C-8FB8AA20D38C', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'AppId' => ['description' => '应用ID。'."\n" + .'> 调用[ListSparkApps](~~612475~~)接口查询Spark应用的ID。', 'type' => 'string', 'example' => 's202411071444hzdvk486d9d2001****'], + 'InnerQueryId' => ['description' => 'Spark 应用内部 query 执行 ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'ElapsedTime' => ['description' => '实际运行时间，单位毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'DiagnosisInfos' => [ + 'description' => '诊断建议集合', + 'type' => 'array', + 'items' => ['description' => '诊断建议', '$ref' => '#/components/schemas/Adb4MysqlSparkDiagnosisInfo'], ], - 'Data' => [ - 'description' => '日志详情。', + 'OperatorListSortedByMetrics' => [ + 'description' => '按 metrics 排序后的算子队列', 'type' => 'object', 'properties' => [ - 'LogContent' => [ - 'title' => 'spark app的日志内容, 如配置了重试则为最后一次重试的尾部日志内容.', - 'description' => '日志内容。', - 'type' => 'string', - 'example' => '22/04/22 15:30:49 INFO Utils: Start the dump task because s202206061441hz22a35ab000****-0001 app end, the interval is 238141ms;22/04/22 15:30:49 INFO AbstractConnector: Stopped Spark@5e774d9d{HTTP/1.1, (http/1.1)}{0.0.0.0:4040}', - ], - 'Message' => [ - 'title' => '额外备注信息', - 'description' => '返回告警信息，如任务执行失败或资源不足等，无告警时则返回为空。', - 'type' => 'string', - 'example' => 'WARNING: log file maybe deleted, please check oss path: oss://TestBucketName/applog/', - ], - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-clusterxxx', + 'OperatorListSortedByMaxMemory' => [ + 'description' => '按最大内存消耗排序后的算子队列', + 'type' => 'array', + 'items' => ['description' => 'Spark 算子信息', '$ref' => '#/components/schemas/SparkOperatorInfo'], ], - 'LogSize' => [ - 'description' => '日志的行数，0代表没有有效日志。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '3517972480', + 'OperatorListSortedByExclusiveTime' => [ + 'description' => '按执行时间排序后的算子队列', + 'type' => 'array', + 'items' => ['description' => 'Spark 算子信息', '$ref' => '#/components/schemas/SparkOperatorInfo'], ], ], ], + 'Root' => ['description' => 'Spark 执行计划树', '$ref' => '#/components/schemas/OperatorNode'], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息。', 'type' => 'string', 'example' => '{}'], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.RoleArn.Invalid', - 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', - ], - [ - 'errorCode' => 'Spark.Oss.InternalError', - 'errorMessage' => 'An OSS internal error occurred: %s', - ], - [ - 'errorCode' => 'Spark.Log.IllegalPath', - 'errorMessage' => 'Invalid job log URI: %s.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', - 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.FailedToKill', - 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', - 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Log.InvalidState', - 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '查询SparkSQL诊断详情', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkSQLDiagnosisAttribute'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.Log.PodLogNotFound', - 'errorMessage' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', - ], - [ - 'errorCode' => 'Spark.AnalyzeTask.NotFound', - 'errorMessage' => 'The requested analysis task %s is not found.', - ], - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - [ - 'errorCode' => 'Spark.TemplateFile.FileNotFound', - 'errorMessage' => 'The template file %s is not found.', - ], - [ - 'errorCode' => 'Spark.TemplateFile.TemplateNotFound', - 'errorMessage' => 'The template %s is not found.', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkSQLDiagnosisAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C3A9594F-1D40-4472-A96C-8FB8AA20D38C\\",\\n \\"Data\\": {\\n \\"LogContent\\": \\"22/04/22 15:30:49 INFO Utils: Start the dump task because s202206061441hz22a35ab000****-0001 app end, the interval is 238141ms;22/04/22 15:30:49 INFO AbstractConnector: Stopped Spark@5e774d9d{HTTP/1.1, (http/1.1)}{0.0.0.0:4040}\\",\\n \\"Message\\": \\"WARNING: log file maybe deleted, please check oss path: oss://TestBucketName/applog/\\",\\n \\"DBClusterId\\": \\"amv-clusterxxx\\",\\n \\"LogSize\\": 3517972480\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkAppLogResponse>\\n <RequestId>C3A9594F-1D40-4472-A96C-8FB8AA20D38C</RequestId>\\n <Data>\\n <LogContent>22/04/22 15:30:49 INFO Utils: Start the dump task because s202206061441hz22a35ab000****-0001 app end, the interval is 238141ms;22/04/22 15:30:49 INFO AbstractConnector: Stopped Spark@5e774d9d{HTTP/1.1, (http/1.1)}{0.0.0.0:4040}</LogContent>\\n <Message>WARNING: log file maybe deleted, please check oss path: oss://TestBucketName/applog/</Message>\\n </Data>\\n</GetSparkAppLogResponse>","errorExample":""}]', - 'title' => '查询Spark应用日志', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"AppId\\": \\"s202411071444hzdvk486d9d2001****\\",\\n \\"InnerQueryId\\": 1,\\n \\"ElapsedTime\\": 100,\\n \\"DiagnosisInfos\\": [\\n {\\n \\"DiagnosisType\\": \\"APPLICATION\\",\\n \\"DiagnosisCode\\": \\"\\",\\n \\"DiagnosisCodeLabel\\": \\"\\",\\n \\"DiagnosisMsg\\": \\"\\"\\n }\\n ],\\n \\"OperatorListSortedByMetrics\\": {\\n \\"OperatorListSortedByMaxMemory\\": [\\n {\\n \\"OperatorName\\": \\"\\",\\n \\"MetricValue\\": 0\\n }\\n ],\\n \\"OperatorListSortedByExclusiveTime\\": [\\n {\\n \\"OperatorName\\": \\"\\",\\n \\"MetricValue\\": 0\\n }\\n ]\\n },\\n \\"Root\\": {\\n \\"nodeName\\": \\"\\",\\n \\"id\\": 0,\\n \\"nodeDepth\\": 0,\\n \\"parentId\\": 0,\\n \\"levelWidth\\": 0,\\n \\"nodeWidth\\": 0,\\n \\"stats\\": {\\n \\"parameters\\": \\"\\",\\n \\"bytes\\": 0,\\n \\"outputRows\\": 0,\\n \\"timeCost\\": 0,\\n \\"peakMemory\\": 0\\n },\\n \\"children\\": [\\n {\\n \\"nodeName\\": \\"\\",\\n \\"id\\": 0,\\n \\"nodeDepth\\": 0,\\n \\"parentId\\": 0,\\n \\"levelWidth\\": 0,\\n \\"nodeWidth\\": 0,\\n \\"stats\\": {\\n \\"parameters\\": \\"\\",\\n \\"bytes\\": 0,\\n \\"outputRows\\": 0,\\n \\"timeCost\\": 0,\\n \\"peakMemory\\": 0\\n },\\n \\"children\\": [\\n {\\n \\"nodeName\\": \\"\\",\\n \\"id\\": 0,\\n \\"nodeDepth\\": 0,\\n \\"parentId\\": 0,\\n \\"levelWidth\\": 0,\\n \\"nodeWidth\\": 0,\\n \\"stats\\": {\\n \\"parameters\\": \\"\\",\\n \\"bytes\\": 0,\\n \\"outputRows\\": 0,\\n \\"timeCost\\": 0,\\n \\"peakMemory\\": 0\\n },\\n \\"children\\": []\\n }\\n ]\\n }\\n ]\\n },\\n \\"AccessDeniedDetail\\": \\"{}\\"\\n}","type":"json"}]', ], - 'SubmitSparkApp' => [ - 'summary' => '提交Spark应用。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSparkSQLDiagnosisList' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'get', 'riskType' => 'none', - 'chargeType' => 'paid', - 'abilityTreeCode' => '118686', - 'abilityTreeNodes' => [ - 'FEATUREadsCQJTKP', - ], + 'chargeType' => 'free', + 'abilityTreeCode' => '197113', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ - 'name' => 'AppName', - 'in' => 'formData', - 'schema' => [ - 'title' => 'Spark App的名称', - 'description' => '应用名称，可自定义字符串，长度不能超过64个字符。', - 'type' => 'string', - 'required' => false, - 'example' => 'TestApp', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-2zez35ww415xjwk5'], ], [ - 'name' => 'AppType', - 'in' => 'formData', - 'schema' => [ - 'title' => 'Spark App的类型, 不填写默认为BATCH 批处理类型', - 'description' => '应用类型，取值说明：'."\n" - .'- **SQL**：SQL应用。'."\n" - .'- **STREAMING**：流应用。'."\n" - .'- **BATCH**（默认值）：离线应用。', - 'type' => 'string', - 'required' => false, - 'example' => 'SQL', - 'default' => 'BATCH', - 'enum' => [], - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'Data', - 'in' => 'formData', - 'schema' => [ - 'title' => 'Spark App的配置信息, 定义SQL语句或者执行内容', - 'description' => '应用模板数据。'."\n" - .'> 应用模板配置，请参见[《Spark应用配置指南》](~~452402~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'conf spark.driver.resourceSpec=small; conf spark.executor.instances=1; conf spark.executor.resourceSpec=small; conf spark.app.name=TestApp;', - ], + 'name' => 'StatementId', + 'in' => 'query', + 'schema' => ['description' => 'Spark作业中代码块的唯一ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '123'], ], [ - 'name' => 'AgentSource', - 'in' => 'formData', - 'schema' => [ - 'title' => '客户端类型', - 'description' => '客户端类型。可自定义字符串，长度不能超过64个字符。', - 'type' => 'string', - 'required' => false, - 'example' => 'CONSOLE', - 'default' => 'SDK', - 'enum' => [], - ], + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1'], ], [ - 'name' => 'AgentVersion', - 'in' => 'formData', - 'schema' => [ - 'title' => '客户端版本', - 'description' => '应用程序使用的版本。可自定义字符串，长度不能超过64个字符。', - 'type' => 'string', - 'required' => false, - 'example' => '1.091', - ], + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', 'default' => '20'], ], [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'title' => '数据库的id', - 'description' => '企业版、基础版或湖仓版集群ID。'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口可以查询集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - 'maxLength' => 64, - ], + 'name' => 'Order', + 'in' => 'query', + 'schema' => ['description' => '将查询结果按指定字段进行排序。格式为JSON字符串，例如`[{"Field":"MaxExclusiveTime","Type":"Asc"}]`。其中：'."\n" + .'- `Field`表示排序字段。取值说明：'."\n" + .' - `MaxExclusiveTime`：最大执行时间。'."\n" + .' - `PeakMemory`：内存峰值。'."\n" + .' - `QueryStartTime`： query开始时间。'."\n" + .' - `QueryWallclockTime`：query 执行时间。'."\n" + ."\n" + .'- `Type`表示排序方式。取值说明：'."\n" + .' - `Asc`：升序排序。'."\n" + .' - `Desc`： 降序排序。'."\n" + ."\n" + .'> - 若不设置参数，默认按照`MaxExclusiveTime`字段升序排列。', 'type' => 'string', 'required' => false, 'example' => '[{\\"Field\\":\\"QueryStartTime\\",\\"Type\\":\\"Desc\\"}]'], ], [ - 'name' => 'ResourceGroupName', - 'in' => 'formData', - 'schema' => [ - 'title' => '资源组的名称', - 'description' => 'Job型资源组名称。'."\n" - .'> 您可以调用[DescribeDBResourceGroup](~~612410~~)接口查看集群的资源组ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'adb', - 'maxLength' => 64, - ], + 'name' => 'MinStartTime', + 'in' => 'query', + 'schema' => ['description' => '最小起始时间', 'type' => 'string', 'required' => false, 'example' => '2024-11-28 22:00:00'], ], [ - 'name' => 'TemplateFileId', - 'in' => 'formData', - 'schema' => [ - 'title' => '模板文件id', - 'description' => '应用模板ID。'."\n" - .'> 您可以调用[GetSparkTemplateFullTree](~~456205~~)接口可以查询应用模板ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'minimum' => '0', - 'exclusiveMinimum' => true, - 'example' => '15', - ], + 'name' => 'MaxStartTime', + 'in' => 'query', + 'schema' => ['description' => '最大起始时间', 'type' => 'string', 'required' => false, 'example' => '2024-11-28 23:00:00'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '任务列表。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Data' => [ - 'description' => '数据列表。', - 'type' => 'object', - 'properties' => [ - 'AppId' => [ - 'title' => 'Spark App的id', - 'description' => '应用ID。', - 'type' => 'string', - 'example' => 's202204132018hzprec1ac61a000****', - ], - 'AppName' => [ - 'title' => 'spark app的名称', - 'description' => '应用名称。', - 'type' => 'string', - 'example' => 'TestApp', - ], - 'Message' => [ - 'title' => '备注信息', - 'description' => '返回告警信息，如任务执行失败或资源不足等，无告警时则返回为空。', - 'type' => 'string', - 'example' => 'Insufficient resources.', - ], - 'State' => [ - 'title' => 'spark app的状态', - 'description' => '应用执行状态，取值说明：'."\n" - .'- **SUBMITTED**：已提交。'."\n" - .'- **STARTING**：开始启动。'."\n" - .'- **RUNNING**：执行中。'."\n" - .'- **FAILING**：任务失败，清理环境中。'."\n" - .'- **FAILED**：失败。'."\n" - .'- **KILLING**：中止任务，清理环境中。'."\n" - .'- **KILLED**：中止任务。'."\n" - .'- **SUCCEEDING**：任务执行结束，清理环境中。'."\n" - .'- **COMPLETED**：任务执行结束。'."\n" - .'- **FATAL**：意外失败。'."\n" - .'- **UNKNOWN**：未知错误。', - 'type' => 'string', - 'example' => 'SUBMITTED', - ], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1343'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A91C9D07-7462-5F35-BB47-83629CE6CCAC'], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'SQLDiagnosisList' => [ + 'description' => 'SQL 诊断信息集合', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'State' => ['description' => 'Query 最终执行状态：'."\n" + ."\n" + .'- COMPLETED：完成。'."\n" + .'- CANCELED：取消。'."\n" + .'- ABORTED：中止。'."\n" + .'- FAILED：失败。', 'type' => 'string', 'example' => 'COMPLETED'], + 'SQL' => ['description' => 'SQL语句。', 'type' => 'string', 'example' => 'select * from device where name = \'105506012112790031\''], + 'AppId' => ['description' => '应用ID。'."\n" + .'> 调用[ListSparkApps](~~612475~~)接口查询Spark应用的ID。', 'type' => 'string', 'example' => 's202404291020bjd448ad40002122'], + 'StatementId' => ['description' => 'Spark作业中代码块的唯一ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'InnerQueryId' => ['description' => 'Spark 应用内部 query 执行 ID', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'StartTime' => ['description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', 'type' => 'string', 'example' => '2024-11-20 09:09:00'], + 'ElapsedTime' => ['description' => '实际运行时间，单位毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'MaxExclusiveTime' => ['description' => '最大算子执行时间，单位毫秒', 'type' => 'integer', 'format' => 'int64', 'example' => '90'], + 'PeakMemory' => ['description' => '最大算子内存消耗，单位byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1024'], + 'ScanRowCount' => ['description' => '扫描行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + ], + 'description' => '', ], ], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息。', 'type' => 'string', 'example' => '{}'], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.App.ExceedQuotaLimitation', - 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', - ], - [ - 'errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', - 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', - ], - [ - 'errorCode' => 'Spark.App.InvalidResourceSpec', - 'errorMessage' => 'The requested resource type is not supported:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ParameterConflict', - 'errorMessage' => 'Conflicting parameters submitted:\\n %s', - ], - [ - 'errorCode' => 'Spark.App.ResourceNegativeError', - 'errorMessage' => 'The requested resource MUST be positive: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidAppFilePath', - 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', - ], - [ - 'errorCode' => 'Spark.Config.invalidConnectors', - 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidDiskConfig', - 'errorMessage' => 'The requested disk mount parameter is invalid: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidHostAliasConfig', - 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', - ], - [ - 'errorCode' => 'Spark.Config.InvalidLogOssPath', - 'errorMessage' => 'The OSS address for log storage is illegal: %s', - ], - [ - 'errorCode' => 'Spark.Config.InvalidRoleArnFormat', - 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', - ], - [ - 'errorCode' => 'Spark.Config.InvalidTimeZone', - 'errorMessage' => 'Unable to parse time zone configuration %s : %s', - ], - [ - 'errorCode' => 'Spark.Config.MainAppFileNotExists', - 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathAccessError', - 'errorMessage' => 'The configured OSS address %s cannot be accessed.', - ], - [ - 'errorCode' => 'Spark.Config.OSSPathNotExists', - 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', - ], - [ - 'errorCode' => 'Spark.Config.RoleArnVerifyFailed', - 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', - ], - [ - 'errorCode' => 'Spark.Config.SecurityGroupNotFound', - 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.Config.VswitchNotFound', - 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', - ], - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.RoleArn.Invalid', - 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', - ], - [ - 'errorCode' => 'Spark.SQL.BlankError', - 'errorMessage' => 'Input sql can not be blank string.', - ], - [ - 'errorCode' => 'Spark.SQL.MultipleSQLError', - 'errorMessage' => 'Element in field [sqls] can not contain more than one sql statement: %s.', - ], - [ - 'errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', - 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', - ], - [ - 'errorCode' => 'Spark.SQL.ParserError', - 'errorMessage' => 'Submit spark app failed when parser SQL %s. Error message: %s.', - ], - [ - 'errorCode' => 'Spark.RoleARN.invalid', - 'errorMessage' => 'Current account fails to verify the permissions of the RAM system, please check the help information and configure the appropriate permissions for the current account.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'Spark.Forbidden', - 'errorMessage' => 'No permissions to access the resources: %s', - ], + ], + 'title' => '查询SparkSQL诊断列表', + 'summary' => '查询SparkSQL诊断列表。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkSQLDiagnosisList'], ], + ], + 'ramActions' => [ [ - [ - 'errorCode' => 'Spark.App.ContentNotFound', - 'errorMessage' => 'The requested content %s of the Spark application is not found.', - ], - [ - 'errorCode' => 'Spark.App.NotFound', - 'errorMessage' => 'The Spark application %s is not found.', - ], - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkSQLDiagnosisList', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202204132018hzprec1ac61a000****\\",\\n \\"AppName\\": \\"TestApp\\",\\n \\"Message\\": \\"Insufficient resources.\\",\\n \\"State\\": \\"SUBMITTED\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<SubmitSparkAppResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Data>\\n <AppId>s202204132018hzprec1ac61a000****</AppId>\\n <AppName>TestApp</AppName>\\n <Message>Insufficient resources.</Message>\\n <State>SUBMITTED</State>\\n </Data>\\n</SubmitSparkAppResponse>","errorExample":""}]', - 'title' => '提交Spark应用', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": 1343,\\n \\"RequestId\\": \\"A91C9D07-7462-5F35-BB47-83629CE6CCAC\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"SQLDiagnosisList\\": [\\n {\\n \\"State\\": \\"COMPLETED\\",\\n \\"SQL\\": \\"select * from device where name = \'105506012112790031\'\\",\\n \\"AppId\\": \\"s202404291020bjd448ad40002122\\",\\n \\"StatementId\\": 1,\\n \\"InnerQueryId\\": 1,\\n \\"StartTime\\": \\"2024-11-20 09:09:00\\",\\n \\"ElapsedTime\\": 100,\\n \\"MaxExclusiveTime\\": 90,\\n \\"PeakMemory\\": 1024,\\n \\"ScanRowCount\\": 100\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{}\\"\\n}","type":"json"}]', ], - 'KillSparkApp' => [ - 'summary' => '强行停止运行中的Spark作业。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeSqlPattern' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '132339', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ - 'name' => 'AppId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'Spark App的ID', - 'description' => '需要停止的AppID。', - 'type' => 'string', - 'required' => true, - 'example' => 's202204132018hzprec1ac****', - 'maxLength' => 64, - ], + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => ['description' => '查询开始日期，UTC时间，格式：yyyy-MM-dd。'."\n" + .'> 仅支持查看30天内的数据。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2022-08-30'], + ], + [ + 'name' => 'Order', + 'in' => 'query', + 'schema' => ['description' => '将查询结果按指定字段进行排序。格式为JSON字符串，例如`[{"Field":"Pattern","Type":"Asc"}]`。其中：'."\n" + .'- `Field`表示排序字段。取值说明：'."\n" + .' - `Pattern`：SQL Pattern。'."\n" + .' - `AccessIP`：客户端IP。'."\n" + .' - `User`：用户名。'."\n" + .' - `QueryCount`：查询总数。'."\n" + .' - `AvgPeakMemory`：平均峰值内存，单位：KB。'."\n" + .' - `MaxPeakMemory`：最大峰值内存，单位：KB。'."\n" + .' - `AvgCpuTime`：平均计算耗时，单位：毫秒（ms）。'."\n" + .' - `MaxCpuTime`：最大计算耗时，单位：毫秒（ms）。'."\n" + .' - `AvgStageCount`：平均Stage个数。'."\n" + .' - `MaxStageCount`：最大Stage个数。'."\n" + .' - `AvgTaskCount`：平均Task个数。'."\n" + .' - `MaxTaskCount`：最大Task个数。'."\n" + .' - `AvgScanSize`：平均扫描量，单位：KB。'."\n" + .' - `MaxScanSize`：最大扫描量，单位：KB。'."\n" + ."\n" + .'- `Type`表示排序方式。取值说明：'."\n" + .' - `Asc`：升序排序。'."\n" + .' - `Desc`： 降序排序。'."\n" + ."\n" + .'> - 若不设置参数，默认按照`Pattern`字段升序排列。'."\n" + .'- 若需要按照`AccessIP`字段排序，则`Type`参数必须设置为`accessip`；若需要按照`User`字段排序，则`Type`参数必须留空或设置为`user`。'."\n", 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => '[{"Field":"Pattern","Type":"Asc"}]'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码，取值：大于0且不超过Integer的最大值。'."\n" + .'默认值：1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '2'], + ], + [ + 'name' => 'SqlPattern', + 'in' => 'query', + 'schema' => ['description' => '需要包含的SQL Pattern的关键字。'."\n" + .'> 若该参数不填，默认返回目标集群在`StartTime`参数所设日期内的所有SQL Pattern详情。', 'type' => 'string', 'required' => false, 'example' => 'SELECT'], + ], + [ + 'name' => 'Type', + 'in' => 'query', + 'schema' => ['description' => '按指定维度来聚合SQL Pattern。取值说明：'."\n" + .' - `user`：按用户维度聚合。'."\n" + .' - `accessip`：按访问IP来源聚合。'."\n" + ."\n" + .'> 若该参数不填，默认按照 `user`维度聚合。', 'type' => 'string', 'required' => false, 'example' => 'user'], ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群的集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-bp1ub9grke1****', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1ej1nq9n6****'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数，取值：'."\n" + .'- **10**（默认值）'."\n" + .'- **30**'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ @@ -24886,113 +17729,80 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '69D0810B-F9F5-5F4C-A57F-DF36133B63C9', - ], - 'Data' => [ - 'description' => '返回结果。', - 'type' => 'object', - 'properties' => [ - 'AppId' => [ - 'title' => 'Spark App的ID', - 'description' => '停止执行的AppID。', - 'type' => 'string', - 'example' => 's202204132018hzprec1ac****', - ], - 'AppName' => [ - 'title' => 'Spark App的名称', - 'description' => '任务名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'Message' => [ - 'title' => '特殊注释信息', - 'description' => '分析失败时错误信息。', - 'type' => 'string', - 'example' => '[Advisor] Advisor feature is not available for instance: amv-bp11q28kvl688****', - ], - 'State' => [ - 'title' => 'App的状态信息', - 'description' => '应用执行状态，取值说明：'."\n" - .'- **SUBMITTED**：已提交。'."\n" - .'- **STARTING**：开始启动。'."\n" - .'- **RUNNING**：执行中。'."\n" - .'- **FAILING**：任务失败，清理环境中。'."\n" - .'- **FAILED**：失败。'."\n" - .'- **KILLING**：中止任务，清理环境中。'."\n" - .'- **KILLED**：中止任务。'."\n" - .'- **SUCCEEDING**：任务执行结束，清理环境中。'."\n" - .'- **COMPLETED**：已完成。'."\n" - .'- **FATAL**：意外失败。'."\n" - .'- **UNKNOWN**：未知错误。', - 'type' => 'string', - 'example' => 'KILLED', - ], - 'DBClusterId' => [ - 'title' => '数据库ID', - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp11q28kvl688****', - 'default' => 'DB_CLUSTER_ID', + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '50'], + 'Items' => [ + 'description' => '列表详情。', + 'type' => 'array', + 'items' => [ + 'description' => '列表详情。', + 'type' => 'object', + 'properties' => [ + 'AvgStageCount' => ['description' => '平均扫描行数。', 'type' => 'string', 'example' => '2'], + 'MaxCpuTime' => ['description' => 'SQL的最大运行时间，单位：毫秒（ms）。', 'type' => 'string', 'example' => '17'], + 'AccessIP' => ['description' => '客户端IP。'."\n" + .'> 仅当**Type**参数设置为**accessip**时，返回该参数。', 'type' => 'string', 'example' => '100.104.xx.xx'], + 'AvgScanSize' => ['description' => '平均扫描量，单位：KB。', 'type' => 'string', 'example' => '244'], + 'MaxScanSize' => ['description' => '最大扫描量，单位：KB。', 'type' => 'string', 'example' => '1024'], + 'MaxPeakMemory' => ['description' => '最大峰值内存，单位：KB。', 'type' => 'string', 'example' => '480096'], + 'AvgCpuTime' => ['description' => '平均执行时间，单位：毫秒（ms）。', 'type' => 'string', 'example' => '1.0625'], + 'User' => ['description' => '用户名。'."\n" + .'> 仅当**Type**参数留空或设置为**user**时，返回该参数。', 'type' => 'string', 'example' => 'test_acc'], + 'AvgPeakMemory' => ['description' => '平均峰值内存，单位：KB。', 'type' => 'string', 'example' => '240048'], + 'MaxStageCount' => ['description' => '最大Stage个数。', 'type' => 'string', 'example' => '2'], + 'MaxTaskCount' => ['description' => '最大任务数。', 'type' => 'string', 'example' => '2'], + 'InstanceName' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp1ej1nq9n6****'], + 'QueryCount' => ['description' => '查询总数。', 'type' => 'string', 'example' => '16'], + 'ReportDate' => ['description' => '查询日期。', 'type' => 'string', 'example' => '2022-08-30'], + 'Pattern' => ['description' => 'SQL Pattern。', 'type' => 'string', 'example' => 'SELECT table_name, table_schema AS schema_name, create_time, create_time AS last_ddl_time, table_comment AS description , ceil((data_length + index_length) / ? / ?) AS store_capacity , data_length AS data_bytes, index_length AS index_bytes, table_collation AS collation, auto_increment, table_rows AS num_rows , engine FROM information_schema.tables WHERE table_type != ? AND table_schema = ? AND table_name IN (?) ORDER BY 1'], + 'AvgTaskCount' => ['description' => '平均任务数。', 'type' => 'string', 'example' => '2'], ], ], ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'DB1F6C23-CBCA-5260-9366-BA7BB5EBF6F1'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Invalid parameter value: %s', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], - [ - 'errorCode' => 'Spark.App.KillOperationFailed', - 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', - ], - ], - 404 => [ - [ - 'errorCode' => 'Spark.ObjectNotFound', - 'errorMessage' => 'The object is not found. More information: %s', - ], - ], - 406 => [ - [ - 'errorCode' => 'Spark.App.KillNotAcceptable', - 'errorMessage' => 'Can\'t kill the application %s in %s state.', - ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '查询SQL Pattern详情', + 'summary' => '查看指定日期内AnalyticDB for MySQL集群的SQL Pattern详情。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-09-13T12:07:35.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-22T04:03:32.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSqlPattern'], ], - 500 => [ - [ - 'errorCode' => 'Spark.ServerError', - 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeSqlPattern', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"69D0810B-F9F5-5F4C-A57F-DF36133B63C9\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202204132018hzprec1ac****\\",\\n \\"AppName\\": \\"test\\",\\n \\"Message\\": \\"[Advisor] Advisor feature is not available for instance: amv-bp11q28kvl688****\\",\\n \\"State\\": \\"KILLED\\",\\n \\"DBClusterId\\": \\"amv-bp11q28kvl688****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<KillSparkAppResponse>\\n <RequestId>69D0810B-F9F5-5F4C-A57F-DF36133B63C9</RequestId>\\n <Data>\\n <AppId>s202204132018hzprec1ac****</AppId>\\n <AppName>test</AppName>\\n <Message>[Advisor] Advisor feature is not available for instance: amv-bp11q28kvl688****</Message>\\n <State>running</State>\\n <DBClusterId>amv-bp11q28kvl688****</DBClusterId>\\n </Data>\\n</KillSparkAppResponse>","errorExample":""}]', - 'title' => '强行停止运行中的Spark作业', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" - .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 2,\\n \\"TotalCount\\": 50,\\n \\"Items\\": [\\n {\\n \\"AvgStageCount\\": \\"2\\",\\n \\"MaxCpuTime\\": \\"17\\",\\n \\"AccessIP\\": \\"100.104.xx.xx\\",\\n \\"AvgScanSize\\": \\"244\\",\\n \\"MaxScanSize\\": \\"1024\\",\\n \\"MaxPeakMemory\\": \\"480096\\",\\n \\"AvgCpuTime\\": \\"1.0625\\",\\n \\"User\\": \\"test_acc\\",\\n \\"AvgPeakMemory\\": \\"240048\\",\\n \\"MaxStageCount\\": \\"2\\",\\n \\"MaxTaskCount\\": \\"2\\",\\n \\"InstanceName\\": \\"amv-bp1ej1nq9n6****\\",\\n \\"QueryCount\\": \\"16\\",\\n \\"ReportDate\\": \\"2022-08-30\\",\\n \\"Pattern\\": \\"SELECT table_name, table_schema AS schema_name, create_time, create_time AS last_ddl_time, table_comment AS description , ceil((data_length + index_length) / ? / ?) AS store_capacity , data_length AS data_bytes, index_length AS index_bytes, table_collation AS collation, auto_increment, table_rows AS num_rows , engine FROM information_schema.tables WHERE table_type != ? AND table_schema = ? AND table_name IN (?) ORDER BY 1\\",\\n \\"AvgTaskCount\\": \\"2\\"\\n }\\n ],\\n \\"RequestId\\": \\"DB1F6C23-CBCA-5260-9366-BA7BB5EBF6F1\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeSqlPatternResponse>\\n <PageSize>30</PageSize>\\n <PageNumber>2</PageNumber>\\n <TotalCount>50</TotalCount>\\n <Items>\\n <AvgStageCount>2</AvgStageCount>\\n <MaxCpuTime>17</MaxCpuTime>\\n <AccessIP>100.104.xx.xx</AccessIP>\\n <AvgScanSize>244</AvgScanSize>\\n <MaxScanSize>1024</MaxScanSize>\\n <MaxPeakMemory>480096</MaxPeakMemory>\\n <AvgCpuTime>1.0625</AvgCpuTime>\\n <User>test_acc</User>\\n <AvgPeakMemory>240048</AvgPeakMemory>\\n <MaxStageCount>2</MaxStageCount>\\n <MaxTaskCount>2</MaxTaskCount>\\n <InstanceName>amv-bp1ej1nq9n6****</InstanceName>\\n <QueryCount>16</QueryCount>\\n <ReportDate>2022-08-30</ReportDate>\\n <Pattern>SELECT table_name, table_schema AS schema_name, create_time, create_time AS last_ddl_time, table_comment AS description , ceil((data_length + index_length) / ? / ?) AS store_capacity , data_length AS data_bytes, index_length AS index_bytes, table_collation AS collation, auto_increment, table_rows AS num_rows , engine FROM information_schema.tables WHERE table_type != ? AND table_schema = ? AND table_name IN (?) ORDER BY 1</Pattern>\\n <AvgTaskCount>2</AvgTaskCount>\\n </Items>\\n <RequestId>DB1F6C23-CBCA-5260-9366-BA7BB5EBF6F1</RequestId>\\n</DescribeSqlPatternResponse>","errorExample":""}]', ], - 'CreateOssSubDirectory' => [ - 'summary' => 'OSS创建子目录。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeStorageResourceUsage' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -25000,120 +17810,91 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '125729', - 'abilityTreeNodes' => [ - 'FEATUREadsCORDM7', - ], - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'Path', - 'in' => 'formData', - 'schema' => [ - 'title' => '创建的子目录的完整OSS路径'."\n", - 'description' => '创建目录的完整OSS路径。'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'oss://testBucketName/das_lakehouse', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp10yt0gva71ei7d'], ], [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'>您可以调用[DescribeDBClusters](~~612397~~)接口查看目标地域下所有的集群信息，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp149vz49b36t****', - ], + 'name' => 'StartTime', + 'in' => 'query', + 'schema' => ['description' => '查询开始时间，UTC时间，格式：yyyy-MM-ddTHH:mmZ。', 'type' => 'string', 'required' => true, 'example' => '2022-08-22T01:06:00Z'."\n"], + ], + [ + 'name' => 'EndTime', + 'in' => 'query', + 'schema' => ['description' => '查询结束时间，UTC时间，格式：yyyy-MM-ddTHH:mmZ。', 'type' => 'string', 'required' => true, 'example' => '2022-08-23T01:06:00Z'."\n"], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '响应模式。', + 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', + 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '3A0DE2E0-A37B-5EE4-9136-C4C473714802', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '200', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEAW'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], 'Data' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ - 'ClientCRC' => [ - 'description' => 'Client.CRC校验值。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'ETag' => [ - 'description' => 'OSS路径的标签。', - 'type' => 'string', - 'example' => '1', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '3A0DE2E0-A37B-5EE4-9136-C4C473714802', - ], - 'ServerCRC' => [ - 'description' => '阿里云OSS Bucket的CRC-64值。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp1bg858bo8c****'], + 'StartTime' => ['description' => '查询开始时间，UTC时间，格式：yyyy-MM-ddTHH:mmZ。', 'type' => 'string', 'example' => '2022-08-22T01:06:00Z'."\n"], + 'EndTime' => ['description' => '查询结束时间，UTC时间，格式：yyyy-MM-ddTHH:mmZ。', 'type' => 'string', 'example' => '2022-08-23T01:06:00Z'."\n"], + 'AcuInfo' => [ + 'description' => '集群ACU资源使用情况。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '对应指标项取值的状态，取值说明：'."\n" + .'- `TotalAcuNumber`：总ACU资源数。'."\n" + .'- `ReservedAcuNumber`：预留资源ACU数。', 'type' => 'string', 'example' => 'TotalAcuNumber'], + 'Values' => [ + 'description' => '对应指标项在各时间点的具体取值。', + 'type' => 'array', + 'items' => ['description' => '不同时间点下的性能值详情。', 'type' => 'string', 'example' => '16ACU'], + ], + ], + 'description' => '', + ], ], ], ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：调用成功。'."\n" - .'- **false**：调用失败。', - 'type' => 'boolean', - 'example' => 'True', - ], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"3A0DE2E0-A37B-5EE4-9136-C4C473714802\\",\\n \\"Message\\": \\"Success\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": {\\n \\"ClientCRC\\": 1,\\n \\"ETag\\": \\"1\\",\\n \\"RequestId\\": \\"3A0DE2E0-A37B-5EE4-9136-C4C473714802\\",\\n \\"ServerCRC\\": 1\\n },\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"<CreateOssSubDirectoryResponse>\\n <RequestId>3A0DE2E0-A37B-5EE4-9136-C4C473714802</RequestId>\\n <Message>Success</Message>\\n <HttpStatusCode>200</HttpStatusCode>\\n <Data>\\n <ClientCRC>1</ClientCRC>\\n <ETag>1</ETag>\\n <RequestId>3A0DE2E0-A37B-5EE4-9136-C4C473714802</RequestId>\\n <ServerCRC>1</ServerCRC>\\n </Data>\\n <Success>true</Success>\\n</CreateOssSubDirectoryResponse>","errorExample":""}]', - 'title' => '创建oss目录', - 'description' => '- 中心的公网接入地址：`adb.aliyuncs.com`。'."\n" - .'- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'DescribeViewJobs' => [ - 'summary' => '获取视图任务', - 'methods' => [ - 'get', - 'post', + 'title' => '查询集群存储资源使用情况', + 'summary' => '调用DescribeStorageResourceUsage接口查询集群存储资源使用情况。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeStorageResourceUsage'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeStorageResourceUsage', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEAW\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"DBClusterId\\": \\"amv-bp1bg858bo8c****\\",\\n \\"StartTime\\": \\"2022-08-22T01:06:00Z\\\\n\\",\\n \\"EndTime\\": \\"2022-08-23T01:06:00Z\\\\n\\",\\n \\"AcuInfo\\": [\\n {\\n \\"Name\\": \\"TotalAcuNumber\\",\\n \\"Values\\": [\\n \\"16ACU\\"\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeTableAccessCount' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -25122,250 +17903,132 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ - 'name' => 'SchemaName', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'required' => false, - 'example' => 'demo_db', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-2ze627uzpkh8a8****'], ], [ - 'name' => 'OrderBy', + 'name' => 'TableName', 'in' => 'query', - 'schema' => [ - 'description' => '排序字段。'."\n" - .'类型取值：'."\n" - .'- Asc；'."\n" - .'- Desc；'."\n" - ."\n" - .'域取值：'."\n" - .'- StartTime；'."\n" - .'- EndTime;'."\n" - .'- ScheduledStartTime;', - 'type' => 'string', - 'required' => false, - 'example' => '{\\"Field\\":\\"StartTime\\",\\"Type\\":\\"Desc\\"}', - ], + 'schema' => ['description' => '目标表名。'."\n" + .'> 若该参数留空，则会返回当前日期内目标集群下所有表的使用频次数据。', 'type' => 'string', 'required' => false, 'example' => 'CUSTOMER'], ], [ - 'name' => 'FilterViewName', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '视图名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_mv', - ], + 'schema' => ['description' => '查询开始时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ。'."\n" + .'> 仅支持查看30天内的数据。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2022-09-25T12:10:00Z'], ], [ - 'name' => 'FilterViewType', - 'in' => 'query', - 'schema' => [ - 'description' => '视图类型。'."\n" - ."\n" - .'取值：'."\n" - ."\n" - .'-VIRTUAL_VIEW'."\n" - ."\n" - .'-MATERIALIZED_VIEW'."\n" - ."\n\n" - .'默认值：空', - 'type' => 'string', - 'required' => false, - 'example' => 'MATERIALIZED_VIEW', - ], - ], - [ - 'name' => 'FilterOwner', + 'name' => 'Order', 'in' => 'query', - 'schema' => [ - 'description' => '所有者。', - 'type' => 'string', - 'required' => false, - 'example' => 'admin', - ], + 'schema' => ['description' => '将查询结果按指定字段进行排序。格式为JOSN字符串，例如`[{"Field":"TableSchema","Type":"Asc"}]`。其中：'."\n" + .'- `Field`表示排序字段。支持如下取值：'."\n" + .' - `TableSchema`：表所属的数据库名。'."\n" + .' - `TableName`：表名。'."\n" + .' - `AccessCount`：表被访问的次数。'."\n" + .'- `Type`表示排序方式。支持如下取值：'."\n" + .' - `Asc`：升序排序。'."\n" + .' - `Desc`： 降序排序。'."\n" + ."\n" + .'> 若不设置参数，默认按照目标表所属的数据库升序排列。', 'type' => 'string', 'required' => false, 'example' => '[{"Field":"TableSchema","Type":"Asc"}]'], ], [ 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - ], - ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '实例ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'am-bp1ub9grke1****'."\n", - ], + 'schema' => ['description' => '每页记录数，取值：'."\n" + .'- **10**（默认值）'."\n" + .'- **30**'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], ], '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' => '2A318054-6815-528A-AA94-8AC921******', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '44', - ], - 'Data' => [ - 'description' => '返回结果数据。', - 'type' => 'object', - 'properties' => [ - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '44', - ], - 'MvRefreshJobModels' => [ - 'description' => '刷新任务列表。', - 'type' => 'array', - 'items' => [ - 'description' => '刷新任务详情。', - '$ref' => '#/components/schemas/open_struct_RefreshJobModel', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '6B7D627B-DA23-572D-AD71-256F64698B7D'], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'Items' => [ + 'description' => '表使用详情。', + 'type' => 'array', + 'items' => [ + 'description' => '详情。', + 'type' => 'object', + 'properties' => [ + 'ReportDate' => ['description' => '表使用日期。', 'type' => 'string', 'example' => '2022-09-26'], + 'TableSchema' => ['description' => '表所属的数据库。', 'type' => 'string', 'example' => 'tpch'], + 'AccessCount' => ['description' => '表被访问的次数。', 'type' => 'string', 'example' => '6'], + 'TableName' => ['description' => '表名称。', 'type' => 'string', 'example' => 'CUSTOMER'], + 'InstanceName' => ['description' => '表所属集群的集群ID。', 'type' => 'string', 'example' => 'amv-2ze627uzpkh8a8****'], ], ], ], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], - ], - 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '查询表的访问次数', + 'summary' => '查看指定日期内集群下目标表或所有表被访问次数。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-09-13T12:07:35.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-22T04:03:32.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeTableAccessCount'], ], - 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeTableAccessCount', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2A318054-6815-528A-AA94-8AC921******\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 44,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 44,\\n \\"MvRefreshJobModels\\": [\\n {\\n \\"Status\\": \\"\\",\\n \\"EndTime\\": \\"\\",\\n \\"RefreshModel\\": \\"\\",\\n \\"StartTime\\": \\"\\",\\n \\"RefreshInterval\\": \\"\\",\\n \\"Processid\\": \\"\\",\\n \\"ScheduledStartTime\\": \\"\\",\\n \\"SchemaName\\": \\"\\",\\n \\"ResourceGroup\\": \\"\\",\\n \\"Name\\": \\"\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '查询物化视图刷新任务列表', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"6B7D627B-DA23-572D-AD71-256F64698B7D\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"Items\\": [\\n {\\n \\"ReportDate\\": \\"2022-09-26\\",\\n \\"TableSchema\\": \\"tpch\\",\\n \\"AccessCount\\": \\"6\\",\\n \\"TableName\\": \\"CUSTOMER\\",\\n \\"InstanceName\\": \\"amv-2ze627uzpkh8a8****\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeTableAccessCountResponse>\\n <RequestId>6B7D627B-DA23-572D-AD71-256F64698B7D</RequestId>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n <Items>\\n <ReportDate>2022-09-26</ReportDate>\\n <TableSchema>tpch</TableSchema>\\n <AccessCount>6</AccessCount>\\n <TableName>CUSTOMER</TableName>\\n <InstanceName>amv-2ze627uzpkh8a8****</InstanceName>\\n </Items>\\n</DescribeTableAccessCountResponse>","errorExample":""}]', ], 'DescribeTableDetail' => [ - 'summary' => '调用DescribeTableDetail接口查看表在每个Shard的数据分布情况。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -25378,9 +18041,7 @@ 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '194789', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], 'autoTest' => true, 'tenantRelevance' => 'tenant', ], @@ -25388,43 +18049,22 @@ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-bp1xxxxxxxx47', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-bp1xxxxxxxx47'], ], [ 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], + 'schema' => ['description' => '数据库名。', 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], ], [ 'name' => 'TableName', 'in' => 'query', - 'schema' => [ - 'description' => '表名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['description' => '表名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ @@ -25432,26 +18072,10 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '9', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'string', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'string', - 'example' => '1', - ], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '9'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'string', 'example' => '30'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'PageNumber' => ['description' => '页码。', 'type' => 'string', 'example' => '1'], 'Items' => [ 'description' => '详情。', 'type' => 'object', @@ -25463,62 +18087,55 @@ 'description' => '分区列表。', 'type' => 'object', 'properties' => [ - 'Size' => [ - 'description' => '表大小，行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '9484858', - ], - 'Id' => [ - 'description' => '分区号（只返回分区名数字部分）。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], + 'Size' => ['description' => '表大小，行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '9484858'], + 'Id' => ['description' => '分区号（只返回分区名数字部分）。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], ], ], ], ], ], - 'AvgSize' => [ - 'description' => '平均分区行数。', - 'type' => 'string', - 'example' => '160', - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝的详细原因。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', - ], + 'AvgSize' => ['description' => '平均分区行数。', 'type' => 'string', 'example' => '160'], + 'AccessDeniedDetail' => ['description' => '访问被拒绝的详细原因。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"9\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"Items\\": {\\n \\"Shard\\": [\\n {\\n \\"Size\\": 9484858,\\n \\"Id\\": 1\\n }\\n ]\\n },\\n \\"AvgSize\\": \\"160\\",\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', + 'staticInfo' => ['returnType' => 'synchronous'], 'title' => '查询表详情', - ], - 'GetCreateTableSQL' => [ - 'summary' => '查询某个表的建表语句。', - 'methods' => [ - 'post', - 'get', + 'summary' => '调用DescribeTableDetail接口查看表在每个Shard的数据分布情况。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeTableDetail'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeTableDetail', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'tags' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"9\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"Items\\": {\\n \\"Shard\\": [\\n {\\n \\"Size\\": 9484858,\\n \\"Id\\": 1\\n }\\n ]\\n },\\n \\"AvgSize\\": \\"160\\",\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', + ], + 'DescribeTablePartitionDiagnose' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -25530,105 +18147,145 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '212744', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '186721', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'AnalyticDB MySQL湖仓版（3.0）集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-2ze8mbuai974s4y2', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp171g24yvbxxxxx'], ], [ - 'name' => 'RegionId', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL支持的地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', 'default' => '30'], ], [ - 'name' => 'SchemaName', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '数据库名称。'."\n" - .' '."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], + 'schema' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', 'default' => '1'], ], [ - 'name' => 'TableName', + 'name' => 'Order', 'in' => 'query', - 'schema' => [ - 'description' => '表名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['description' => '将查询结果按指定字段进行排序。格式为JOSN字符串，例如`[{"Field":"TotalSize","Type":"Desc"}]`。其中：'."\n" + .'- `Field`表示排序字段。支持如下取值：'."\n" + .' - `SchemaName`：表所属的数据库名。'."\n" + .' - `TableName`：表名。'."\n" + .' - `TotalSize`：总数据量。'."\n" + .' - `SpaceRatio`：空间占比。'."\n" + .'- `Type`表示排序方式。支持如下取值：'."\n" + .' - `Asc`：升序排序。'."\n" + .' - `Desc`： 降序排序。'."\n" + ."\n" + .'> 若不设置参数，默认按照目标表的总数据量倒序排列。', 'type' => 'string', 'required' => false, 'example' => '[{\\"Field\\":\\"TotalSize\\",\\"Type\\":\\"Desc\\"}]', 'default' => '[{"Field":"SchemaName", "Type": "desc" }]'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'Lang', + 'in' => 'query', + 'schema' => ['description' => '指定请求和接收消息的语言类型，默认为**zh**。取值：'."\n" + .'- **zh**：中文'."\n" + .'- **en**：英文'."\n" + .'- **ja**：日语。'."\n" + .'- **zh-tw**：繁体中文。', 'type' => 'string', 'required' => false, 'example' => 'zh', 'default' => 'zh'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '响应结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '109462AF-B5FA-3D5A-9377-B27E5B******', + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '185'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp171g24yvbxxxxx'], + 'SuggestMaxRecordsPerPartition' => ['description' => '建议每个二级分区的最大行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '640000000'], + 'SuggestMinRecordsPerPartition' => ['description' => '建议每个二级分区的最小行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '64000000'], + 'Items' => [ + 'description' => '详情。', + 'type' => 'array', + 'items' => [ + 'description' => '信息列表。', + 'type' => 'object', + 'properties' => [ + 'TableName' => ['description' => '表名称。', 'type' => 'string', 'example' => 'user'], + 'PartitionDetail' => ['description' => '不合理分区。', 'type' => 'string', 'example' => '[20210110, 20210113,20210123]'], + 'SchemaName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'test_db'], + 'PartitionNumber' => ['description' => '分区个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'TotalSize' => ['description' => '总数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '42949672960'], + 'SpaceRatio' => ['description' => '表空间占比，单位：%。'."\n" + ."\n" + .'> 计算公式为：表空间占比 = 表总数据量 / 实例总数据量 * 100。', 'type' => 'number', 'format' => 'double', 'example' => '66.23'], + ], + ], ], - 'SQL' => [ - 'description' => 'SQL语句。', - 'type' => 'string', - 'example' => 'create table ('."\n" - .' id varchar(32)'."\n" - .');', + 'DetectionItems' => [ + 'description' => '检测项及检测结果列表。', + 'type' => 'array', + 'items' => [ + 'description' => '检测项及检测结果列表。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '检测项名字。', 'type' => 'string', 'example' => '表分区合理性检测'], + 'Message' => ['description' => '检测结果信息。', 'type' => 'string', 'example' => '检测到表存在分区不合理的情况'], + 'Status' => ['description' => '检测结果状态。取值：'."\n" + ."\n" + .'- NORMAL'."\n" + .'- WARNING'."\n" + .'- CRITICAL', 'type' => 'string', 'example' => 'WARNING'], + ], + ], ], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询二级分区诊断新系列', + 'summary' => '调用DescribeTablePartitionDiagnose接口查询分区诊断信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeTablePartitionDiagnose'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeTablePartitionDiagnose', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"109462AF-B5FA-3D5A-9377-B27E5B******\\",\\n \\"SQL\\": \\"create table (\\\\n id varchar(32)\\\\n);\\"\\n}","type":"json"}]', - 'title' => '查询某个表的建表语句', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": 185,\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"DBClusterId\\": \\"amv-bp171g24yvbxxxxx\\",\\n \\"SuggestMaxRecordsPerPartition\\": 640000000,\\n \\"SuggestMinRecordsPerPartition\\": 64000000,\\n \\"Items\\": [\\n {\\n \\"TableName\\": \\"user\\",\\n \\"PartitionDetail\\": \\"[20210110, 20210113,20210123]\\",\\n \\"SchemaName\\": \\"test_db\\",\\n \\"PartitionNumber\\": 2,\\n \\"TotalSize\\": 42949672960,\\n \\"SpaceRatio\\": 66.23\\n }\\n ],\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"表分区合理性检测\\",\\n \\"Message\\": \\"检测到表存在分区不合理的情况\\",\\n \\"Status\\": \\"WARNING\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', ], 'DescribeTableStatistics' => [ - 'summary' => '查看集群的表统计信息。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -25641,9 +18298,7 @@ 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '186727', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], 'autoTest' => true, 'tenantRelevance' => 'tenant', ], @@ -25651,104 +18306,61 @@ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口可以查询集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-****************', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口可以查询集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-****************'], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '30', - 'example' => '30', - 'default' => '30', - ], + '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', - ], + 'schema' => ['description' => '页数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '1'], ], [ 'name' => 'Order', 'in' => 'query', - 'schema' => [ - 'description' => '按指定字段排序，JSON格式：JSON数组，有序，按顺序输入排列字段和升降序类型：'."\n" - ."\n" - .'如：'."\n" - ."\n" - .'```'."\n" - .'['."\n" - ."\n" - .' {'."\n" - ."\n" - .' "Field":"Name",'."\n" - ."\n" - .' "Type":"Asc"'."\n" - ."\n" - .' }'."\n" - ."\n" - .']'."\n" - .'```'."\n" - ."\n" - .'其中Field表示需要排序的字段名，目前仅支持对"Name" 字段排序。'."\n" - .'Type表示排序类型 Desc为降序，Asc为升序'."\n" - ."\n" - .'均不区分大小写。', - 'type' => 'string', - 'required' => false, - 'example' => '[{"Field":"SchemaName","Type":"Desc"}]', - ], + 'schema' => ['description' => '按指定字段排序，JSON格式：JSON数组，有序，按顺序输入排列字段和升降序类型：'."\n" + ."\n" + .'如：'."\n" + ."\n" + .'```'."\n" + .'['."\n" + ."\n" + .' {'."\n" + ."\n" + .' "Field":"Name",'."\n" + ."\n" + .' "Type":"Asc"'."\n" + ."\n" + .' }'."\n" + ."\n" + .']'."\n" + .'```'."\n" + ."\n" + .'其中Field表示需要排序的字段名，目前仅支持对"Name" 字段排序。'."\n" + .'Type表示排序类型 Desc为降序，Asc为升序'."\n" + ."\n" + .'均不区分大小写。', 'type' => 'string', 'required' => false, 'example' => '[{"Field":"SchemaName","Type":"Desc"}]'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~612393~~)接口可以查询地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~612393~~)接口可以查询地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'], ], [ 'name' => 'Keyword', 'in' => 'query', - 'schema' => [ - 'description' => '查询关键字，支持根据表名模糊搜索。', - 'type' => 'string', - 'required' => false, - 'example' => 'you_table_name', - ], + 'schema' => ['description' => '查询关键字，支持根据表名模糊搜索。', 'type' => 'string', 'required' => false, 'example' => 'you_table_name'], ], [ 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '数据库名称。'."\n" - .' '."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['description' => '数据库名称。'."\n" + .' '."\n", 'type' => 'string', 'required' => false, 'example' => 'test'], ], ], 'responses' => [ @@ -25756,31 +18368,11 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '693', - ], - 'PageSize' => [ - 'description' => '本页记录数。', - 'type' => 'string', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '4C4433FF-5D3A-4C3E-A19C-6D93B2******', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'string', - 'example' => '1', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'am-****************', - ], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '693'], + 'PageSize' => ['description' => '本页记录数。', 'type' => 'string', 'example' => '30'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '4C4433FF-5D3A-4C3E-A19C-6D93B2******'], + 'PageNumber' => ['description' => '页码。', 'type' => 'string', 'example' => '1'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'am-****************'], 'Items' => [ 'type' => 'object', 'itemNode' => true, @@ -25792,444 +18384,257 @@ 'description' => '表统计信息详情。', 'type' => 'object', 'properties' => [ - 'SchemaName' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'test_schema', - ], - 'TableName' => [ - 'description' => '表名。', - 'type' => 'string', - 'example' => 'test_table', - ], - 'RowCount' => [ - 'description' => '表行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '3', - ], - 'DataSize' => [ - 'description' => '表数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '15592', - ], - 'IndexSize' => [ - 'description' => '索引数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '3076', - ], - 'PrimaryKeyIndexSize' => [ - 'description' => '主键索引数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '16340', - ], - 'PartitionCount' => [ - 'description' => '分区数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'ColdDataSize' => [ - 'description' => '冷数据总量，单位：byte。'."\n" - .'>3.1.3.4及以上内核版本的集群支持该参数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4428120064', - ], - 'SpaceRatio' => [ - 'description' => '表空间占比，单位：%。'."\n" - ."\n" - .'> 计算公式为：表空间占比 = (表总数据量 / 实例总数据量) * 100。', - 'type' => 'number', - 'format' => 'double', - 'example' => '66.23', - ], - 'TotalSize' => [ - 'description' => '总数据量，单位：Byte。'."\n" - ."\n" - .'> 总数据量的计算，以下2个公式都成立。'."\n" - ."\n" - .'- 公式1：总数据量 = 热数据量 + 冷数据量。'."\n" - .'- 公式2：总数据量 = 表记录数据量 + 普通索引数据量 + 主键索引数据量 + 其他。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1577', - ], - 'HotDataSize' => [ - 'description' => '热数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1048576', - ], - 'OtherSize' => [ - 'description' => '其他，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1048576', - ], + 'SchemaName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'test_schema'], + 'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'test_table'], + 'RowCount' => ['description' => '表行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '3'], + 'DataSize' => ['description' => '表数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '15592'], + 'IndexSize' => ['description' => '索引数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '3076'], + 'PrimaryKeyIndexSize' => ['description' => '主键索引数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '16340'], + 'PartitionCount' => ['description' => '分区数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'ColdDataSize' => ['description' => '冷数据总量，单位：byte。'."\n" + .'>3.1.3.4及以上内核版本的集群支持该参数。', 'type' => 'integer', 'format' => 'int64', 'example' => '4428120064'], + 'SpaceRatio' => ['description' => '表空间占比，单位：%。'."\n" + ."\n" + .'> 计算公式为：表空间占比 = (表总数据量 / 实例总数据量) * 100。', 'type' => 'number', 'format' => 'double', 'example' => '66.23'], + 'TotalSize' => ['description' => '总数据量，单位：Byte。'."\n" + ."\n" + .'> 总数据量的计算，以下2个公式都成立。'."\n" + ."\n" + .'- 公式1：总数据量 = 热数据量 + 冷数据量。'."\n" + .'- 公式2：总数据量 = 表记录数据量 + 普通索引数据量 + 主键索引数据量 + 其他。', 'type' => 'integer', 'format' => 'int64', 'example' => '1577'], + 'HotDataSize' => ['description' => '热数据量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1048576'], + 'OtherSize' => ['description' => '其他，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1048576'], ], ], ], ], + 'description' => '', ], - 'SchemaNames' => [ - 'description' => '数据库名列表。', - 'type' => 'string', - 'example' => '[\'adb_platform\', \'adb_ai\', \'adb_data\']', - ], + 'SchemaNames' => ['description' => '数据库名列表。', 'type' => 'string', 'example' => '[\'adb_platform\', \'adb_ai\', \'adb_data\']'], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"693\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"4C4433FF-5D3A-4C3E-A19C-6D93B2******\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"DBClusterId\\": \\"am-****************\\",\\n \\"Items\\": {\\n \\"TableStatisticRecords\\": [\\n {\\n \\"SchemaName\\": \\"test_schema\\",\\n \\"TableName\\": \\"test_table\\",\\n \\"RowCount\\": 3,\\n \\"DataSize\\": 15592,\\n \\"IndexSize\\": 3076,\\n \\"PrimaryKeyIndexSize\\": 16340,\\n \\"PartitionCount\\": 1,\\n \\"ColdDataSize\\": 4428120064,\\n \\"SpaceRatio\\": 66.23,\\n \\"TotalSize\\": 1577,\\n \\"HotDataSize\\": 1048576,\\n \\"OtherSize\\": 1048576\\n }\\n ]\\n },\\n \\"SchemaNames\\": \\"[\'adb_platform\', \'adb_ai\', \'adb_data\']\\"\\n}","type":"json"}]', + 'staticInfo' => ['returnType' => 'synchronous'], 'title' => '查看表统计信息', - ], - 'DescribeAdbMySqlTableMeta' => [ - 'summary' => '用于查看表元数据信息。', - 'methods' => [ - 'get', - 'post', + 'summary' => '查看集群的表统计信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeTableStatistics'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeTableStatistics', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"693\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"4C4433FF-5D3A-4C3E-A19C-6D93B2******\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"DBClusterId\\": \\"am-****************\\",\\n \\"Items\\": {\\n \\"TableStatisticRecords\\": [\\n {\\n \\"SchemaName\\": \\"test_schema\\",\\n \\"TableName\\": \\"test_table\\",\\n \\"RowCount\\": 3,\\n \\"DataSize\\": 15592,\\n \\"IndexSize\\": 3076,\\n \\"PrimaryKeyIndexSize\\": 16340,\\n \\"PartitionCount\\": 1,\\n \\"ColdDataSize\\": 4428120064,\\n \\"SpaceRatio\\": 66.23,\\n \\"TotalSize\\": 1577,\\n \\"HotDataSize\\": 1048576,\\n \\"OtherSize\\": 1048576\\n }\\n ]\\n },\\n \\"SchemaNames\\": \\"[\'adb_platform\', \'adb_ai\', \'adb_data\']\\"\\n}","type":"json"}]', + ], + 'DescribeTables' => [ + 'summary' => '查询指定数据库的表列表信息。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => '地域ID。'."\n" - ."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'title' => '实例ID', - 'description' => 'AnalyticDB MySQL湖仓版集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'am-bp11q28kvl688****', - ], - ], - [ - 'name' => 'Schema', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'adb_demo', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1xxxxxxxx47'], ], [ - 'name' => 'TableName', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '目标表名。'."\n" - .'> 若该参数留空，则会返回当前日期内目标集群下所有表的使用频次数据。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'schema' => ['description' => '数据库名称。'."\n" + .' '."\n", 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'TableMeta' => [ - 'description' => '表元数据信息', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Items' => [ 'type' => 'object', + 'itemNode' => true, 'properties' => [ - 'TableSchema' => [ - 'description' => '表所属的数据库。', - 'type' => 'string', - 'example' => 'tpch', - ], - 'TableName' => [ - 'description' => '目标表名。'."\n" - .'> 若该参数留空，则会返回当前日期内目标集群下所有表的使用频次数据。', - 'type' => 'string', - 'example' => 'external_supplier', - ], - 'TableType' => [ - 'description' => '表类型。', - 'type' => 'string', - 'example' => 'fact_table', - ], - 'DistributeType' => [ - 'description' => '分布类型。', - 'type' => 'string', - 'example' => 'hash', - ], - 'DistributeColumn' => [ - 'description' => '分布键列。', - 'type' => 'string', - 'example' => 'customer_id', - ], - 'PartitionType' => [ - 'description' => '分区类型。', - 'type' => 'string', - 'example' => 'value', - ], - 'PartitionColumn' => [ - 'description' => '分区列信息。', - 'type' => 'string', - 'example' => 'DATE_FORMAT(login_time, \'%Y%m%d\')', - ], - 'PrimaryKeyColumn' => [ - 'description' => '主键列。', - 'type' => 'string', - 'example' => 'login_time,customer_id,phone_num', - ], - 'TableEngine' => [ - 'description' => '表引擎。', - 'type' => 'string', - 'example' => 'XUANWU', - ], - 'IsDictEncode' => [ - 'description' => '是否字典编码。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'IsHidden' => [ - 'description' => '表示页面是否隐藏。'."\n" - .'- **false**：否。'."\n" - .'- **true**：是。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'IsAllIndex' => [ - 'description' => '是否是全索引。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'IsFullTextDict' => [ - 'description' => '是否全文索引。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'CreateTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2025-03-14 02:18:08.0', - ], - 'UpdateTime' => [ - 'description' => '更新时间。', - 'type' => 'string', - 'example' => '2024-07-25 02:07:23.0', + 'Table' => [ + 'description' => '表列表。', + 'type' => 'array', + 'items' => [ + 'description' => '表信息。', + 'type' => 'object', + 'properties' => [ + 'TableName' => ['description' => '表名称。', 'type' => 'string', 'example' => 'test'], + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-bp1xxxxxxxx47'], + 'SchemaName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'adb_demo'], + ], + ], ], ], + 'description' => '', ], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\",\\n \\"Success\\": true,\\n \\"TableMeta\\": {\\n \\"TableSchema\\": \\"tpch\\",\\n \\"TableName\\": \\"external_supplier\\",\\n \\"TableType\\": \\"fact_table\\",\\n \\"DistributeType\\": \\"hash\\",\\n \\"DistributeColumn\\": \\"customer_id\\",\\n \\"PartitionType\\": \\"value\\",\\n \\"PartitionColumn\\": \\"DATE_FORMAT(login_time, \'%Y%m%d\')\\",\\n \\"PrimaryKeyColumn\\": \\"login_time,customer_id,phone_num\\",\\n \\"TableEngine\\": \\"XUANWU\\",\\n \\"IsDictEncode\\": true,\\n \\"IsHidden\\": true,\\n \\"IsAllIndex\\": false,\\n \\"IsFullTextDict\\": true,\\n \\"CreateTime\\": \\"2025-03-14 02:18:08.0\\",\\n \\"UpdateTime\\": \\"2024-07-25 02:07:23.0\\"\\n }\\n}","type":"json"}]', - 'title' => '查看表元数据信息', - ], - 'DescribeAdbMySqlIndexes' => [ - 'summary' => '用于查看表索引信息。', - 'methods' => [ - 'get', - 'post', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '枚举数据库的表列表', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2025-05-07T05:42:08.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-08-25T03:37:06.000Z', 'description' => '请求参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeTables'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:describeAllDataSource', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Items\\": {\\n \\"Table\\": [\\n {\\n \\"TableName\\": \\"test\\",\\n \\"DBClusterId\\": \\"amv-bp1xxxxxxxx47\\",\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeUserQuota' => [ + 'methods' => ['get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => '地域ID。'."\n" - .'> 您可以调用 [DescribeRegions](~~612393~~) 接口查看集群的地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ 'name' => 'DBClusterId', 'in' => 'query', 'schema' => [ - 'title' => '实例ID', - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看数仓版集群的集群ID。', + 'description' => '集群ID。', 'type' => 'string', 'required' => true, - 'example' => 'am-uf6wjk5xxxxxxxxxx', - ], - ], - [ - 'name' => 'Schema', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'tpch_oss', - 'default' => 'INFORMATION_SCHEMA', + 'example' => 'amv-bp1qjt3o18d8****', + 'enum' => [], ], ], [ - 'name' => 'TableName', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '目标表名。'."\n" - .'> 若该参数留空，则会返回当前日期内目标集群下所有表的使用频次数据。', - 'type' => 'string', - 'required' => false, - 'example' => 'orders', - 'default' => 'COLUMNS', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'Message' => [ - 'description' => '调用结果的信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常信息。', - 'type' => 'string', - 'example' => 'Success', - ], - 'RequestId' => [ - 'description' => '请求ID，阿里云为该请求生成的标识符。', - 'type' => 'string', - 'example' => 'F0983B43-B2EC-536A-8791-142B5CF1E9B6', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Schema' => [ - 'description' => '数据库名。 '."\n" - ."\n" - .'> <br>如填写，后续迁移或同步操作，只会针对该数据库操作。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - 'TableName' => [ - 'description' => '表名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'IndexCount' => [ - 'description' => '索引个数（索引缺失表目前所拥有的索引个数）筛选条件。输入格式为`运算符+分割服“”+索引个数`，例如`>=100`。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'Indexes' => [ - 'description' => '索引列表。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => '索引类型。', - 'type' => 'string', - 'example' => 'normal', - ], - 'Name' => [ - 'description' => '索引名。', - 'type' => 'string', - 'example' => 'ttl', - ], - 'Column' => [ - 'description' => '列名称。', - 'type' => 'string', - 'example' => 'preclcu', - ], - ], - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '0322C7FB-4584-5D2A-BF7F-F9036E940C35'], + 'ElasticACU' => ['description' => '可用弹性ACU。', 'type' => 'string', 'example' => '512 ACU'], + 'ResourceGroupCount' => ['description' => '可用资源组数目。', 'type' => 'string', 'example' => '10'], + 'ReserverdCompteACU' => ['description' => '可用预留计算资源。', 'type' => 'string', 'example' => '48 ACU'], + 'ReserverdStorageACU' => ['description' => '可用存储计算资源。', 'type' => 'string', 'example' => '24 ACU'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"F0983B43-B2EC-536A-8791-142B5CF1E9B6\\",\\n \\"Success\\": true,\\n \\"Schema\\": \\"adb_demo\\",\\n \\"TableName\\": \\"test\\",\\n \\"IndexCount\\": 10,\\n \\"Indexes\\": [\\n {\\n \\"Type\\": \\"normal\\",\\n \\"Name\\": \\"ttl\\",\\n \\"Column\\": \\"preclcu\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '查看表索引信息', - ], - 'DescribeMvRecommendSubTasks' => [ - 'summary' => '查看物化视图子任务', - 'methods' => [ - 'get', - 'post', + 'title' => '查询用户可用配额', + 'summary' => '查询可用配额。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-11-06T09:42:43.000Z', 'description' => '请求参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeUserQuota'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeUserQuota', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"0322C7FB-4584-5D2A-BF7F-F9036E940C35\\",\\n \\"ElasticACU\\": \\"512 ACU\\",\\n \\"ResourceGroupCount\\": \\"10\\",\\n \\"ReserverdCompteACU\\": \\"48 ACU\\",\\n \\"ReserverdStorageACU\\": \\"24 ACU\\"\\n}","type":"json"}]', + ], + 'DescribeViewJobs' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -26241,110 +18646,69 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ - 'name' => 'TaskName', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '物化视图推荐任务的名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'my_task_1', - ], + 'schema' => ['description' => '数据库名。', 'type' => 'string', 'required' => false, 'example' => 'demo_db'], ], [ - 'name' => 'SubtaskId', + 'name' => 'OrderBy', 'in' => 'query', - 'schema' => [ - 'description' => '子任务ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '123', - ], + 'schema' => ['description' => '排序字段。'."\n" + .'类型取值：'."\n" + .'- Asc；'."\n" + .'- Desc；'."\n" + ."\n" + .'域取值：'."\n" + .'- StartTime；'."\n" + .'- EndTime;'."\n" + .'- ScheduledStartTime;', 'type' => 'string', 'required' => false, 'example' => '{\\"Field\\":\\"StartTime\\",\\"Type\\":\\"Desc\\"}'], ], [ - 'name' => 'OrderBy', + 'name' => 'FilterViewName', 'in' => 'query', - 'schema' => [ - 'description' => '排序字段。'."\n" - .'类型取值：'."\n" - .'- Asc；'."\n" - .'- Desc；'."\n" - ."\n" - .'域取值：'."\n" - .'- StartTime;'."\n" - .'- EndTime;', - 'type' => 'string', - 'required' => false, - 'example' => '{\\"Type\\": \\"ASC\\", \\"Field\\": \\"StartTime\\"}', - ], + 'schema' => ['description' => '视图名称。', 'type' => 'string', 'required' => false, 'example' => 'test_mv'], ], [ - 'name' => 'PageNumber', + 'name' => 'FilterViewType', 'in' => 'query', - 'schema' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['description' => '视图类型。'."\n" + ."\n" + .'取值：'."\n" + ."\n" + .'-VIRTUAL_VIEW'."\n" + ."\n" + .'-MATERIALIZED_VIEW'."\n" + ."\n\n" + .'默认值：空', 'type' => 'string', 'required' => false, 'example' => 'MATERIALIZED_VIEW'], ], [ - 'name' => 'PageSize', + 'name' => 'FilterOwner', 'in' => 'query', - 'schema' => [ - 'description' => '本页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - ], + 'schema' => ['description' => '所有者。', 'type' => 'string', 'required' => false, 'example' => 'admin'], ], [ - 'name' => 'DBClusterId', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '集群 ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'am-bp1ub9grke1****', - ], + 'schema' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], ], [ - 'name' => 'RegionId', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '地域 ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30'], ], [ - 'name' => 'From', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '固定值，不支持修改。', - 'type' => 'string', - 'required' => false, - 'example' => '不支持修改', - ], + 'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => false, 'example' => 'am-bp1ub9grke1****'."\n"], ], [ - 'name' => 'ActionInner', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '固定值，不支持修改。', - 'type' => 'string', - 'required' => false, - 'example' => '不支持修改', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ @@ -26354,59 +18718,21 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录条数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '2A318054-6815-528A-AA94-8AC921******'], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '44'], 'Data' => [ - 'description' => '返回数据。', + 'description' => '返回结果数据。', 'type' => 'object', 'properties' => [ - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录条数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4', - ], - 'MvRecommendSubTaskModels' => [ - 'description' => '物化视图推荐任务执行列表。', + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '44'], + 'MvRefreshJobModels' => [ + 'description' => '刷新任务列表。', 'type' => 'array', - 'items' => [ - 'description' => '物化视图推荐任务执行详情。', - '$ref' => '#/components/schemas/open_struct_MvRecommendSubTaskModel', - ], + 'items' => ['description' => '刷新任务详情。', '$ref' => '#/components/schemas/open_struct_RefreshJobModel'], ], ], ], @@ -26416,63 +18742,48 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], ], 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], ], 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', - ], + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 4,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 4,\\n \\"MvRecommendSubTaskModels\\": [\\n {\\n \\"SubQueriesCount\\": 0,\\n \\"Status\\": \\"\\",\\n \\"EndTime\\": \\"\\",\\n \\"StartTime\\": \\"\\",\\n \\"SubtaskId\\": 0,\\n \\"ScanQueriesCount\\": 0,\\n \\"MinRewriteQueryCount\\": 0,\\n \\"MinRewriteQueryPattern\\": 0,\\n \\"SlowQueryThreshold\\": 0\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '查询物化视图推荐任务执行列表', - ], - 'DescribeMVRecommendResults' => [ - 'summary' => '查询物化视图推荐任务结果。', - 'methods' => [ - 'get', - 'post', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询物化视图刷新任务列表', + 'summary' => '获取视图任务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeViewJobs'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeViewJobs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2A318054-6815-528A-AA94-8AC921******\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 44,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 44,\\n \\"MvRefreshJobModels\\": [\\n {\\n \\"Status\\": \\"RUNNING\\",\\n \\"EndTime\\": \\"2025-01-15 10:12:00\\",\\n \\"RefreshModel\\": \\"FAST\\",\\n \\"StartTime\\": \\"2025-01-15 10:11:00\\",\\n \\"RefreshInterval\\": \\"30s\\",\\n \\"Processid\\": \\"2025103010xxxxxxx\\",\\n \\"SchemaName\\": \\"adb_demo\\",\\n \\"ResourceGroup\\": \\"user_default\\",\\n \\"Name\\": \\"demo_mv\\",\\n \\"ScheduledStartTime\\": \\"2025-01-15 10:11:00\\\\n\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'DescribeWorkerDetection' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -26484,1048 +18795,616 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], + 'abilityTreeCode' => '194345', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'SubtaskId', - 'in' => 'query', - 'schema' => [ - 'description' => '子任务ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '123', - ], - ], - [ - 'name' => 'TaskName', - 'in' => 'query', - 'schema' => [ - 'description' => '推荐任务名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'task_n1', - ], - ], - [ - 'name' => 'SubQueryId', - 'in' => 'query', - 'schema' => [ - 'description' => '子查询ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '123', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '本页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - ], - ], - [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'am-bp1ub9grke1****', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-xxxxx'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~612293~~)接口查看地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-beijing'], ], [ - 'name' => 'From', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'description' => '固定值，不支持修改。', - 'type' => 'string', - 'required' => false, - 'example' => '不支持修改', - ], + 'schema' => ['description' => '查询开始时间。格式为<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2021-11-18T00:00Z'], ], [ - 'name' => 'ActionInner', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'description' => '固定值，不支持修改。', - 'type' => 'string', - 'required' => false, - 'example' => '不支持修改', - ], + 'schema' => ['description' => '查询结束时间。格式为<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '2024-04-25T02:04Z'], ], [ - 'name' => 'OrderBy', + 'name' => 'Lang', 'in' => 'query', - 'schema' => [ - 'description' => '排序字段。', - 'type' => 'string', - 'required' => false, - 'example' => '{"Type": "Desc","Field": "AcceleratedQueriesCount"}', - ], + 'schema' => ['description' => '设置建议的显示语言，取值说明：'."\n" + .'- **zh**：简体中文（默认语言）。'."\n" + .'- **en**：英文。', 'type' => 'string', 'required' => false, 'example' => 'zh'], ], ], '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' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'PageNumber' => [ - 'description' => '页码。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值范围如下：'."\n" - .'* **30**（默认值）。'."\n" - .'* **50**。'."\n" - .'* **100**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'MvRecommendResultModels' => [ - 'description' => '物化视图推荐结果列表', - 'type' => 'array', - 'items' => [ - 'description' => '推荐结果详情', - '$ref' => '#/components/schemas/open_struct_MVRecommendResultModel', + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '20'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'E5B37B61-E6C9-5FE0-9374-45BAA548AEF6'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'am-xxxxx'], + 'DetectionItems' => [ + 'description' => '检测项及检测结果列表。', + 'type' => 'array', + 'items' => [ + 'description' => '检测结果。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '检测项名字。', 'type' => 'string', 'example' => '指标检测'], + 'Results' => [ + 'description' => '检测结果。', + 'type' => 'object', + 'properties' => [ + 'SkewedTables' => [ + 'description' => '表倾斜检测。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'SchemaName' => ['description' => '数据库名。', 'type' => 'string', 'example' => 'platfunc'], + 'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'sls_log_cheat_action'], + 'DDL' => ['description' => '建表语句。', 'type' => 'string', 'example' => 'create table test(id varchar)'], + 'PartitionCount' => ['description' => '分区数。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'TotalDataSize' => ['description' => '表数据量，单位Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '2345'], + 'TotalRowCount' => ['description' => '表行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '34'], + 'TotalPkSize' => ['description' => '表主键数据量，单位Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '234'], + 'TotalRemoteDataSize' => ['description' => '冷数据量，单位Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '234'], + 'TotalLocalDataSize' => ['description' => '本地数据量，单位Byte。', 'type' => 'string', 'example' => '2345'], + 'ShardSkewedRows' => ['description' => '表倾斜行数。', 'type' => 'string', 'example' => '1234'], + ], + 'description' => '', + ], + ], + 'PartitionedTables' => [ + 'description' => '分区不合理表集合。', + 'type' => 'array', + 'items' => [ + 'description' => '不合理分区表。', + 'type' => 'object', + 'properties' => [ + 'SchemaName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'nxg'], + 'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'zhw_place_order'], + 'DDL' => ['description' => '建表语句。', 'type' => 'string', 'example' => 'create table test(id varchar)'], + 'PartitionCount' => ['description' => '分区数。', 'type' => 'string', 'example' => '234'], + 'PartitionIds' => ['description' => '不合理分区ID。', 'type' => 'string', 'example' => '[2024,2025]'], + 'TotalDataSize' => ['description' => '表总的数据量。', 'type' => 'integer', 'format' => 'int64', 'example' => '1234'], + ], + ], + ], + 'TopAccessTables' => [ + 'description' => '表访问检测结果集合。', + 'type' => 'array', + 'items' => [ + 'description' => '表访问检测结果。', + 'type' => 'object', + 'properties' => [ + 'MetricName' => ['description' => '检测指标名。', 'type' => 'string', 'example' => 'Peak memory detection'], + 'SearchResults' => [ + 'description' => '表访问检索结果集合。', + 'type' => 'array', + 'items' => [ + 'description' => '表访问检索结果。', + 'type' => 'object', + 'properties' => [ + 'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'tiberias_2copt_origin_order_goods_info'], + 'MaxScanCost' => ['description' => '最大扫描耗时，单位ms。', 'type' => 'integer', 'format' => 'int64', 'example' => '345'], + 'AvgScanCost' => ['description' => '平均扫描耗时，单位ms。', 'type' => 'number', 'format' => 'double', 'example' => '234'], + 'MaxScanSize' => ['description' => '最大数据读取量，单位Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '2345'], + 'AvgScanSize' => ['description' => '平均表读取量，单位Byte。', 'type' => 'number', 'format' => 'double', 'example' => '234'], + 'AccessCount' => ['description' => '表被访问的次数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1111'], + ], + ], + ], + ], + ], + ], + 'OperatorDetails' => [ + 'description' => '算子检测结果集合。', + 'type' => 'array', + 'items' => [ + 'description' => '算子检测结果。', + 'type' => 'object', + 'properties' => [ + 'MetricName' => ['description' => '指标名。', 'type' => 'string', 'example' => 'PeakMemory'], + 'SearchResults' => [ + 'description' => '检索结果集合。', + 'type' => 'array', + 'items' => [ + 'description' => '算子检测结果。', + 'type' => 'object', + 'properties' => [ + 'ProcessId' => ['description' => '返回SQL查询ID，便于用户诊断。', 'type' => 'string', 'example' => '2024041909301402103302422803151411141'], + 'StageId' => ['description' => '阶段ID。', 'type' => 'string', 'example' => 'Stage[2]'], + 'OperatorName' => ['description' => '算子名。', 'type' => 'string', 'example' => 'TableScan'], + 'PeakMemory' => ['description' => '算子消耗的峰值内存，单位Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '23'], + 'OperatorCost' => ['description' => '该阶段内部总的算子耗时，等同于该阶段的CPU Time，可用于判断查询哪些部分消耗了较多的计算资源。单位为毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '23'], + 'InputRows' => ['description' => '算子的输入行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'OutputRows' => ['description' => '算子的输出行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'InputSize' => ['description' => '算子的输入数据量，单位Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'OutputSize' => ['description' => '算子的输出数据量，单位Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'OperatorInfo' => ['description' => '算子属性信息。', 'type' => 'string', 'example' => 'Group By field: id'], + ], + ], + ], + ], + ], + ], + 'OperatorAgg' => [ + 'description' => '算子指标聚合检测结果。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'MetricName' => ['description' => '算子指标聚合检测项名。', 'type' => 'string', 'example' => '峰值内存'], + 'SearchResults' => [ + 'description' => '算子聚合指标检索结果集合。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'OperatorName' => ['description' => '算子名。', 'type' => 'string', 'example' => 'Aggregation'], + 'MaxValue' => ['description' => '算子指标最大值。', 'type' => 'integer', 'format' => 'int64', 'example' => '444'], + 'TotalValue' => ['description' => '算子指标累加值。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'AvgValue' => ['description' => '算子指标平均值。', 'type' => 'number', 'format' => 'double', 'example' => '2234'], + 'OperatorCount' => ['description' => '算子出现次数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1234'], + ], + 'description' => '', + ], + ], + ], + 'description' => '', + ], + ], + ], ], + 'Message' => ['description' => '检测结果信息。', 'type' => 'string', 'example' => 'There are a total of 10 tables with an excessive number of primary keys.'], + 'Status' => ['description' => '检测结果状态。取值：'."\n" + ."\n" + .'- NORMAL'."\n" + .'- WARNING'."\n" + .'- CRITICAL', 'type' => 'string', 'example' => 'WARNING'], ], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '预留节点检测', + 'summary' => '查询存储层诊断结果。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeWorkerDetection'], ], - 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeWorkerDetection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 20,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 20,\\n \\"TotalCount\\": 1,\\n \\"MvRecommendResultModels\\": [\\n {\\n \\"BaseTables\\": [\\n {\\n \\"TableName\\": \\"\\",\\n \\"DataVolumn\\": \\"\\",\\n \\"EnableBinlog\\": true,\\n \\"SchemaName\\": \\"\\"\\n }\\n ],\\n \\"AcceleratedQueriesCount\\": 0,\\n \\"SupportIncrementalRefresh\\": true,\\n \\"SubqueryId\\": 0,\\n \\"SavedScanbytes\\": 0,\\n \\"Subquery\\": \\"\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '查询物化视图推荐结果列表', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"20\\",\\n \\"RequestId\\": \\"E5B37B61-E6C9-5FE0-9374-45BAA548AEF6\\",\\n \\"DBClusterId\\": \\"am-xxxxx\\",\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"指标检测\\",\\n \\"Results\\": {\\n \\"SkewedTables\\": [\\n {\\n \\"SchemaName\\": \\"platfunc\\",\\n \\"TableName\\": \\"sls_log_cheat_action\\",\\n \\"DDL\\": \\"create table test(id varchar)\\",\\n \\"PartitionCount\\": 2,\\n \\"TotalDataSize\\": 2345,\\n \\"TotalRowCount\\": 34,\\n \\"TotalPkSize\\": 234,\\n \\"TotalRemoteDataSize\\": 234,\\n \\"TotalLocalDataSize\\": \\"2345\\",\\n \\"ShardSkewedRows\\": \\"1234\\"\\n }\\n ],\\n \\"PartitionedTables\\": [\\n {\\n \\"SchemaName\\": \\"nxg\\",\\n \\"TableName\\": \\"zhw_place_order\\",\\n \\"DDL\\": \\"create table test(id varchar)\\",\\n \\"PartitionCount\\": \\"234\\",\\n \\"PartitionIds\\": \\"[2024,2025]\\",\\n \\"TotalDataSize\\": 1234\\n }\\n ],\\n \\"TopAccessTables\\": [\\n {\\n \\"MetricName\\": \\"Peak memory detection\\",\\n \\"SearchResults\\": [\\n {\\n \\"TableName\\": \\"tiberias_2copt_origin_order_goods_info\\",\\n \\"MaxScanCost\\": 345,\\n \\"AvgScanCost\\": 234,\\n \\"MaxScanSize\\": 2345,\\n \\"AvgScanSize\\": 234,\\n \\"AccessCount\\": 1111\\n }\\n ]\\n }\\n ],\\n \\"OperatorDetails\\": [\\n {\\n \\"MetricName\\": \\"PeakMemory\\",\\n \\"SearchResults\\": [\\n {\\n \\"ProcessId\\": \\"2024041909301402103302422803151411141\\",\\n \\"StageId\\": \\"Stage[2]\\",\\n \\"OperatorName\\": \\"TableScan\\",\\n \\"PeakMemory\\": 23,\\n \\"OperatorCost\\": 23,\\n \\"InputRows\\": 123,\\n \\"OutputRows\\": 123,\\n \\"InputSize\\": 123,\\n \\"OutputSize\\": 123,\\n \\"OperatorInfo\\": \\"Group By field: id\\"\\n }\\n ]\\n }\\n ],\\n \\"OperatorAgg\\": [\\n {\\n \\"MetricName\\": \\"峰值内存\\",\\n \\"SearchResults\\": [\\n {\\n \\"OperatorName\\": \\"Aggregation\\",\\n \\"MaxValue\\": 444,\\n \\"TotalValue\\": 123,\\n \\"AvgValue\\": 2234,\\n \\"OperatorCount\\": 1234\\n }\\n ]\\n }\\n ]\\n },\\n \\"Message\\": \\"There are a total of 10 tables with an excessive number of primary keys.\\",\\n \\"Status\\": \\"WARNING\\"\\n }\\n ]\\n}","type":"json"}]', ], - 'DescribeMvRecommendTasks' => [ - 'summary' => '查看物化视图推荐任务', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', - ], + 'DetachUserENI' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], + 'abilityTreeNodes' => ['FEATUREadsPOF80W'], ], 'parameters' => [ [ - 'name' => 'TaskName', - 'in' => 'query', - 'schema' => [ - 'description' => '物化视图推荐任务的名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'my_task_1', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - ], - ], - [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-bp11q28kvl688****', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'From', - 'in' => 'query', - 'schema' => [ - 'description' => '固定值，不支持修改。', - 'type' => 'string', - 'required' => false, - 'example' => '不支持修改', - ], - ], - [ - 'name' => 'ActionInner', - 'in' => 'query', - 'schema' => [ - 'description' => '固定值，不支持修改。', - 'type' => 'string', - 'required' => false, - 'example' => '不支持修改', - ], + 'schema' => ['description' => '实例id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-bp11q28kvl688****'], ], ], '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' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4', - ], - 'MvRecommendTaskModels' => [ - 'description' => '物化视图推荐任务列表。', - 'type' => 'array', - 'items' => [ - 'description' => '物化视图推荐任务详情。', - '$ref' => '#/components/schemas/open_struct_MvRecommendTaskModel', - ], - ], - ], - ], + 'RequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + ], + 'title' => '关闭用户ENI', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'summary' => '解绑用户弹性网卡', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DetachUserENI'], ], - 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:DetachUserENI', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 4,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 4,\\n \\"MvRecommendTaskModels\\": [\\n {\\n \\"Description\\": \\"\\",\\n \\"CreatedTime\\": \\"\\",\\n \\"LastRunAt\\": \\"\\",\\n \\"TaskName\\": \\"\\",\\n \\"ScanQueriesRange\\": 0,\\n \\"SchedulingSettings\\": \\"\\",\\n \\"MinRewriteQueryCount\\": 0,\\n \\"MinRewriteQueryPattern\\": 0,\\n \\"SlowQueryThreshold\\": 0\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '查询物化视图推荐任务列表', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', ], - 'CreateMaterializedViewRecommend' => [ - 'summary' => '创建物化视图自动推荐任务。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - ], + 'DisableAdviceService' => [ + 'summary' => '用DisableAdviceService来关闭建议服务。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsTYGUV3', - ], + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], - ], - [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-8vbwm***', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-uf67culrr26q2****'], ], [ - 'name' => 'TaskName', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => '推荐任务名称', - 'description' => '推荐任务名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'task_n1', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-shanghai'], ], - [ - 'name' => 'SchedulingPolicy', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'title' => '推荐的策略，取值"daliy"或"weekly"', - 'description' => '推荐的策略，取值如下：'."\n" - ."\n" - .'daily：按日调度。'."\n" - ."\n" - .'weekly：按周调度。', - 'type' => 'string', - 'required' => true, - 'example' => 'weekly', - 'enum' => [ - 'daily', - 'weekly', + 'title' => 'Schema of Response', + 'description' => '详情。', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '57EC6CCA-A582-572C-A33D-F61845CBC03C'], ], ], ], - [ - 'name' => 'SchedulingDay', - 'in' => 'query', - 'schema' => [ - 'title' => '仅当SchedulingPolicy取值为weekly时有效，取值为：Monday|Tuesday|Wendesday|Thursday|Friday|Saturday|Sunday，多天以逗号分隔符拼接', - 'description' => '仅当SchedulingPolicy取值为weekly时有效，取值如下：'."\n" - ."\n" - .'- Monday'."\n" - .'- Tuesday'."\n" - .'- Wednesday'."\n" - .'- Thursday'."\n" - .'- Friday'."\n" - .'- Saturday'."\n" - .'- Sunday'."\n" - ."\n" - .'多天以逗号分隔符拼接。', - 'type' => 'string', - 'required' => false, - 'example' => 'Monday;Wednesday', - ], - ], - [ - 'name' => 'SpecifiedTime', - 'in' => 'query', - 'schema' => [ - 'title' => '任务的执行时间，格式HH:MM:SS', - 'description' => '任务的执行时间，格式HH:MM:SS。', - 'type' => 'string', - 'required' => true, - 'example' => '10:00:00', - ], - ], - [ - 'name' => 'ScanQueriesRange', - 'in' => 'query', - 'schema' => [ - 'title' => '扫描的时间范围，单位天，默认取值3', - 'description' => '扫描的时间范围，单位天，默认取值3。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '3', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '关闭建议服务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DisableAdviceService'], ], + ], + 'ramActions' => [ [ - 'name' => 'Description', - 'in' => 'query', - 'schema' => [ - 'title' => '推荐任务的描述', - 'description' => '推荐任务的描述。', - 'type' => 'string', - 'required' => false, - 'example' => 'task desc', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:DisableAdviceService', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"57EC6CCA-A582-572C-A33D-F61845CBC03C\\"\\n}","type":"json"}]', + ], + 'DisableElasticPlan' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'SlowQueryThreshold', - 'in' => 'query', - 'schema' => [ - 'title' => '慢查询阈值', - 'description' => '慢查询阈值。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'minimum' => '1', - 'example' => '2', - ], + 'AK' => [], ], + ], + 'deprecated' => false, + 'systemTags' => ['operationType' => 'update'], + 'parameters' => [ [ - 'name' => 'MinRewriteQueryPattern', + 'name' => 'ElasticPlanName', 'in' => 'query', - 'schema' => [ - 'title' => '最小可加速的Pattern数量', - 'description' => '最小可加速的Pattern数量。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'minimum' => '1', - 'example' => '5', - ], + 'schema' => ['description' => '弹性计划名称。'."\n" + .'> 调用[DescribeElasticPlans](~~601334~~)接口可以查看集群的弹性计划名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], ], [ - 'name' => 'MinRewriteQueryCount', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'title' => 'Pattern匹配的最少慢查询个数', - 'description' => 'Pattern匹配的最少慢查询个数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'minimum' => '1', - 'example' => '3', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-wz9509beptiz****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'title' => 'BaseResponse', + 'description' => 'BaseResponse', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', - 'title' => '创建物化视图自动推荐任务', - ], - 'ModifyMaterializedView' => [ - 'summary' => '修改物化视图。', - 'path' => '', - 'methods' => [ - 'post', - 'get', + 'title' => '停用弹性计划', + 'summary' => '停用集群的弹性计划。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-12-12T10:09:37.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-04-13T11:20:15.000Z', 'description' => '错误码发生变更'], ], - 'schemes' => [ - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DisableElasticPlan'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:DisableElasticPlan', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<DisableElasticPlanResponse>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</DisableElasticPlanResponse>","errorExample":""}]', + ], + 'DownloadDiagnosisRecords' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsTYGUV3', - ], + 'abilityTreeCode' => '132341', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', - ], - ], - [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'title' => 'ADB实例ID', - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-******', - ], - ], - [ - 'name' => 'ViewName', - 'in' => 'query', - 'schema' => [ - 'title' => '物化视图名称', - 'description' => '物化视图名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'mv_1', - ], - ], - [ - 'name' => 'DbName', - 'in' => 'query', - 'schema' => [ - 'title' => '物化视图所在DB名', - 'description' => '物化视图所在数据库名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'myDB', - ], - ], - [ - 'name' => 'GroupName', - 'in' => 'query', - 'schema' => [ - 'title' => '物化视图绑定的资源组名称', - 'description' => '物化视图绑定的资源组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'res_1', - ], + 'schema' => ['description' => 'AnalyticDB MySQL湖仓版（3.0）集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1q8bu9a****'], ], [ - 'name' => 'QueryWrite', + 'name' => 'StartTime', 'in' => 'query', - 'schema' => [ - 'title' => '启用/禁用重写功能', - 'description' => '是否开启重写功能。取值如下： '."\n" - .'- true：是。 '."\n" - ."\n" - .'- false：否。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], + 'schema' => ['description' => '查询开始时间，格式为Unix时间戳，单位：毫秒。'."\n" + .'> 仅支持查看最近14天的数据。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '1662364330000'], ], [ - 'name' => 'EnableFailureAlert', + 'name' => 'EndTime', 'in' => 'query', - 'schema' => [ - 'title' => '开启刷新任务失败告警', - 'description' => '开启刷新任务失败告警。取值如下：'."\n" - ."\n" - .'- true：是。 '."\n" - .'- false：否。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 'schema' => ['description' => '查询结束时间，格式为Unix时间戳，单位：毫秒。'."\n" + .'> * 查询结束时间需晚于查询开始时间。'."\n" + .'> * 开始时间与结束时间的间隔不能超过24小时。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '1662450730000'], ], [ - 'name' => 'EnableDelayAlert', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => '开启刷新延迟告警', - 'description' => '开启刷新延迟告警。取值如下：'."\n" - ."\n" - .'- true：是。'."\n" - .'- false：否。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'LatencyTolerance', - 'in' => 'query', - 'schema' => [ - 'title' => '刷新延迟容忍度（分钟）', - 'description' => '刷新延迟容忍度（分钟）。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '2', - ], - ], - ], - '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' => 'CF8BA882-C9D8-5BEF-AAA3-AD03875F3E18', - ], - ], - ], - ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"CF8BA882-C9D8-5BEF-AAA3-AD03875F3E18\\"\\n}","type":"json"}]', - 'title' => '修改物化视图', - ], - 'ModifyMaterializedViewRecommend' => [ - 'summary' => '修改物化视图自动推荐任务。', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'https', - ], - 'security' => [ - [ - 'AK' => [], - ], - ], - 'operationType' => 'write', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsTYGUV3', - ], - ], - 'parameters' => [ - [ - 'name' => 'RegionId', + 'name' => 'QueryCondition', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '指定SQL查询的条件，格式为JOSN字符串，包含`Type`、`Value`、`Min`或`Max`等字段。其中`Type` 表示查询维度（当前仅支持`maxCost`、`status`和`cost`3个取值）；`Value`、`Min`或`Max`表示该维度下的查询范围。具体支持的取值范围如下：'."\n" + .'- ` {"Type":"maxCost","Value":"100"}`：表示查看执行耗时最长的前100条SQL详情，当前`Value`的取值仅支持设置为100。'."\n" + .'- `{"Type":"status","Value":"finished"}`：表示查看已完成的SQL详情。您也可以将`Value`设置为`running`或`failed`来查询正在执行或执行失败的SQL详情。'."\n" + .'- `{"Type":"cost","Min":"10","Max":"200"}`：表示查看执行耗时为10毫秒~200毫秒的SQL详情，您也可以自定义执行耗时的最大值与最小值，单位：毫秒。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '{"Type":"status","Value":"finished"}'], ], [ - 'name' => 'DBClusterId', + 'name' => 'Keyword', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-uf6o*****', - ], + 'schema' => ['description' => '查询关键字。', 'type' => 'string', 'required' => false, 'example' => 'select'], ], [ - 'name' => 'TaskName', + 'name' => 'MinPeakMemory', 'in' => 'query', - 'schema' => [ - 'title' => '推荐任务名称', - 'description' => '物化视图推荐任务的名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'task_n1', - ], + 'schema' => ['description' => '目标SQL的最小峰值内存，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '88000000'], ], [ - 'name' => 'SchedulingPolicy', + 'name' => 'MaxPeakMemory', 'in' => 'query', - 'schema' => [ - 'title' => '推荐的策略，取值"daliy"或"weekly"', - 'description' => '推荐的策略。取值如下： '."\n" - .'- daliy：按日调度。'."\n" - .'- weekly：按周调度。', - 'type' => 'string', - 'required' => false, - 'example' => 'weekly', - 'enum' => [ - 'daily', - 'weekly', - ], - ], + 'schema' => ['description' => '目标SQL的最大峰值内存，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '88000000'], ], [ - 'name' => 'SchedulingDay', + 'name' => 'MinScanSize', 'in' => 'query', - 'schema' => [ - 'title' => '仅当SchedulingPolicy取值为weekly时有效，取值为：Monday|Tuesday|Wendesday|Thursday|Friday|Saturday|Sunday，多天以逗号分隔符拼接', - 'description' => '仅当SchedulingPolicy取值为weekly时有效，取值如下：'."\n" - .'- Monday'."\n" - .'- Tuesday'."\n" - .'- Wednesday'."\n" - .'- Thursday'."\n" - .'- Friday'."\n" - .'- Saturday'."\n" - .'- Sunday'."\n" - ."\n" - .'多天以逗号分隔符拼接。', - 'type' => 'string', - 'required' => false, - 'example' => 'Monday;Wednesday', - ], + 'schema' => ['description' => '目标SQL的最小扫描量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1073741824'], ], [ - 'name' => 'SpecifiedTime', + 'name' => 'MaxScanSize', 'in' => 'query', - 'schema' => [ - 'title' => '任务的执行时间，格式HH:MM:SS', - 'description' => '任务的执行时间，格式HH:MM:SS。', - 'type' => 'string', - 'required' => false, - 'example' => '10:00:00', - ], + 'schema' => ['description' => '目标SQL的最大扫描量，单位：Byte。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '64424509440'], ], [ - 'name' => 'ScanQueriesRange', + 'name' => 'ResourceGroup', 'in' => 'query', - 'schema' => [ - 'title' => '扫描的时间范围，单位天，默认取值3', - 'description' => '扫描的时间范围，单位天，默认取值3。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '3', - ], + 'schema' => ['description' => '目标SQL所属的资源组。'."\n" + .'> 您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL所属的资源组、数据库名、用户名以及访问源地址信息。', 'type' => 'string', 'required' => false, 'example' => 'user_default'], ], [ - 'name' => 'Description', + 'name' => 'UserName', 'in' => 'query', - 'schema' => [ - 'title' => '推荐任务的描述', - 'description' => '推荐任务的描述。', - 'type' => 'string', - 'required' => false, - 'example' => 'task desc', - ], + 'schema' => ['description' => '执行目标SQL的用户名。'."\n" + .'> 您可以调用[DescribeDiagnosisDimensions](~~~~)接口查看符合指定检索条件的SQL所属的资源组、数据库名、用户名以及访问源地址信息。', 'type' => 'string', 'required' => false, 'example' => 'test_user'], ], [ - 'name' => 'SlowQueryThreshold', + 'name' => 'Database', 'in' => 'query', - 'schema' => [ - 'title' => '慢查询阈值', - 'description' => '慢查询阈值。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'minimum' => '1', - 'example' => '2', - ], + 'schema' => ['description' => '执行目标SQL的数据库。'."\n" + .'> 您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL所属的资源组、数据库名、用户名以及访问源地址信息。', 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], ], [ - 'name' => 'MinRewriteQueryPattern', + 'name' => 'ClientIp', 'in' => 'query', - 'schema' => [ - 'title' => '最小可加速的Pattern数量', - 'description' => '最小可加速的Pattern数量。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'minimum' => '1', - 'example' => '5', - ], + 'schema' => ['description' => '访问源地址。'."\n" + .'> 您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL所属的资源组、数据库名、用户名以及访问源地址信息。', 'type' => 'string', 'required' => false, 'example' => '106.11.XX.XX'], ], [ - 'name' => 'MinRewriteQueryCount', + 'name' => 'Lang', 'in' => 'query', - 'schema' => [ - 'title' => 'Pattern匹配的最少慢查询个数', - 'description' => 'Pattern匹配的最少慢查询个数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'minimum' => '1', - 'example' => '3', - ], + 'schema' => ['description' => '语言配置，取值说明：'."\n" + .'- **zh**：简体中文（默认语言）。'."\n" + .'- **en**：英文。'."\n" + .'- **ja**：日文。'."\n" + .'- **zh-tw**：繁体中文。', 'type' => 'string', 'required' => false, 'example' => 'zh'], ], ], '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' => 'F0983B43-B2EC-536A-8791-142B5CF1E9B6', - ], + 'DownloadId' => ['description' => '下载ID。', 'type' => 'integer', 'format' => 'int32', 'example' => '25494'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '845774AC-5D43-53A2-AAB8-C73828E68508'], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F0983B43-B2EC-536A-8791-142B5CF1E9B6\\"\\n}","type":"json"}]', - 'title' => '修改物化视图自动推荐任务', - ], - 'DeleteMaterializedViewRecommend' => [ - 'summary' => '删除物化视图自动推荐任务。', - 'methods' => [ - 'post', - 'get', + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '下载SQL摘要信息', + 'summary' => '下载目标AnalyticDB MySQL湖仓版（3.0）集群中符合指定条件的查询SQL的摘要信息。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-09-13T12:07:35.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-22T04:03:32.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DownloadDiagnosisRecords'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:DownloadDiagnosisRecords', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"DownloadId\\": 25494,\\n \\"RequestId\\": \\"845774AC-5D43-53A2-AAB8-C73828E68508\\"\\n}","errorExample":""},{"type":"xml","example":"<DownloadDiagnosisRecordsResponse>\\n <DownloadId>25494</DownloadId>\\n <RequestId>845774AC-5D43-53A2-AAB8-C73828E68508</RequestId>\\n</DownloadDiagnosisRecordsResponse>","errorExample":""}]', + ], + 'DownloadInstanceCACertificate' => [ + 'summary' => '获取CA证书下载OSS路径，用于连接宽表引擎。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsTYGUV3', - ], + 'abilityTreeCode' => '208235', + 'abilityTreeNodes' => ['FEATUREads4DZDZG'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-wz9842849v6****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'Engine', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-uf66*****', - ], + 'schema' => ['description' => '数据库引擎，取值：'."\n" + ."\n" + .'- **AnalyticDB**（默认）：AnalyticDB for MySQL引擎。'."\n" + .'- **Clickhouse**：宽表引擎。', 'type' => 'string', 'required' => false, 'example' => 'Clickhouse'], ], [ - 'name' => 'TaskName', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => '推荐任务名称', - 'description' => '物化视图推荐任务的名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'my_task_1', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ @@ -27535,32 +19414,54 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', - 'example' => '7B081A85-0568-5E54-82EF-6958C4A3D4B4', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '9CCFAAB4-97B7-5800-B9F2-685EB596E3EF'], + 'DownloadUrl' => ['description' => '证书下载路径。', 'type' => 'string', 'example' => 'https://***/ca.crt'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7B081A85-0568-5E54-82EF-6958C4A3D4B4\\"\\n}","type":"json"}]', - 'title' => '删除物化视图自动推荐任务', - ], - 'DescribeInclinedTables' => [ - 'summary' => '查看集群表倾斜信息。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], ], - 'schemes' => [ - 'http', - 'https', + 'title' => '获取证书下载地址', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DownloadInstanceCACertificate'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DownloadInstanceCACertificate', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9CCFAAB4-97B7-5800-B9F2-685EB596E3EF\\",\\n \\"DownloadUrl\\": \\"https://***/ca.crt\\"\\n}","type":"json"}]', + ], + 'EnableAdviceService' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -27569,13 +19470,10 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '186716', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], 'autoTest' => true, 'tenantRelevance' => 'tenant', ], @@ -27583,329 +19481,167 @@ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下AnalyticDB MySQL湖仓版集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-k2jofo4pi5zhd****', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1q10xxzq2z4****'], ], [ - 'name' => 'TableType', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '表类型，取值说明：'."\n" - .'- **FactTable**：分区表。'."\n" - .'- **DimensionTable**：维度表。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'FactTable', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-shanghai'], ], - [ - 'name' => 'Order', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '按指定字段排序，json格式：JSON数组，有序，按顺序输入排列字段和升降序类型：'."\n" - ."\n" - .'如：'."\n" - ."\n" - .'```'."\n" - .'['."\n" - ."\n" - .' {'."\n" - ."\n" - .' "Field":"Name",'."\n" - ."\n" - .' "Type":"Asc"'."\n" - ."\n" - .' }'."\n" - ."\n" - .']'."\n" - .'```'."\n" - ."\n" - .'其中Field表示需要排序的字段名，目前仅支持对"Name" 字段排序。'."\n" - .'Type表示排序类型 Desc为降序，Asc为升序'."\n" - ."\n" - .'均不区分大小写。', - 'type' => 'string', - 'required' => false, - 'example' => '[ { "Field":"Name", "Type":"Asc" } ]', + 'title' => 'Schema of Response', + 'description' => '详情。', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'E1745C03-7CCE-55CF-932E-08121AAFA6AF'], + ], ], ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '开通建议服务', + 'summary' => '用EnableAdviceService来开启建议服务。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EnableAdviceService'], + ], + ], + 'ramActions' => [ [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）。'."\n" - .'- **50**。'."\n" - .'- **100**。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '10', - 'example' => '30', - 'default' => '30', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:EnableAdviceService', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"E1745C03-7CCE-55CF-932E-08121AAFA6AF\\"\\n}","type":"json"}]', + ], + 'EnableElasticPlan' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码，取值为大于0且不超过integer数据类型的最大值。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], + 'AK' => [], ], + ], + 'deprecated' => false, + 'systemTags' => ['operationType' => 'update'], + 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'ElasticPlanName', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL支持的地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hongkong', - ], + 'schema' => ['description' => '弹性计划名称。'."\n" + .'> 调用[DescribeElasticPlans](~~601334~~)接口可以查看集群的弹性计划名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], ], [ - 'name' => 'Lang', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '设置建议的显示语言，取值说明：'."\n" - .'- **zh（默认值）**：简体中文。'."\n" - .'- **en**：英文。'."\n" - .'- **ja**：日文。'."\n" - .'- **zh-tw**：繁体中文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', - 'default' => 'zh', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-wz9509beptiz****'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'BaseResponse', + 'description' => 'BaseResponse', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '15', - ], - 'PageSize' => [ - 'description' => '总页数。', - 'type' => 'string', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => '请求id。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'PageNumber' => [ - 'description' => '页码，取值为大于0且不超过integer数据类型的最大值。', - 'type' => 'string', - 'example' => '1', - ], - 'Items' => [ - 'description' => '表列表。', - 'type' => 'object', - 'properties' => [ - 'Table' => [ - 'description' => '表列表。', - 'type' => 'array', - 'items' => [ - 'description' => '表列表信息。', - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => '倾斜表检测类型。', - 'type' => 'string', - 'example' => 'Fact', - ], - 'Schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'spark_test', - ], - 'Size' => [ - 'description' => '表大小，行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '200', - ], - 'Name' => [ - 'description' => '表名。', - 'type' => 'string', - 'example' => 'admin_daily_own_statistic_record', - ], - 'IsIncline' => [ - 'description' => '是否倾斜。', - 'type' => 'boolean', - 'example' => 'True', - ], - 'TotalSize' => [ - 'description' => '总数据量，单位：Byte。'."\n" - ."\n" - .'> 总数据量的计算，以下2个公式都成立。'."\n" - ."\n" - .'- 公式1：'."\n" - .'总数据量= 热数据量 + 冷数据量。'."\n" - ."\n" - .'- 公式2：总数据量 = 表记录数据量 + 普通索引数据量 + 主键索引数据量 + 其他。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '53687091200', - ], - 'SpaceRatio' => [ - 'description' => '表空间占比，单位：%。'."\n" - ."\n" - .'> 计算公式为：表空间占比 = (表总数据量 / 实例总数据量) * 100。', - 'type' => 'number', - 'format' => 'double', - 'example' => '0.4', - ], - 'RowCount' => [ - 'description' => '表行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1000', - ], - ], - ], - ], - ], - ], - 'DetectionItems' => [ - 'description' => '检测项及检测结果列表。', - 'type' => 'array', - 'items' => [ - 'description' => '具体检测结果。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '检测项名字。', - 'type' => 'string', - 'example' => '表倾斜', - ], - 'Message' => [ - 'description' => '检测结果消息。', - 'type' => 'string', - 'example' => '检测到有表存在shard倾斜', - ], - 'Status' => [ - 'description' => '检测结果状态。', - 'type' => 'string', - 'example' => 'NORMAL'."\n" - .'WARNNING'."\n" - .'CRITICAL', - ], - ], - ], - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'ACS.ElasticPlan.AutoWorkerPlanExists', 'errorMessage' => 'Failed to enable the elastic plan. The instance already has an active elastic plan.', 'description' => '启用此存储弹性计划失败，当前实例存在启用的存储自动弹性计划。'], + ['errorCode' => 'ACS.ElasticPlan.WorkerPlanExists', 'errorMessage' => 'Failed to enable the elastic plan. At least one active elastic plan already exists.', 'description' => '启用存储自动弹性计划失败，当前存在另外一个启用的存储弹性计划。'], + ['errorCode' => 'ACS.ElasticPlan.InvalidStartTimeInterval', 'errorMessage' => 'The start time of this elastic plan is too closed to another one.', 'description' => '此弹性计划的启用时间和另外一个弹性计划过于接近。'], + ['errorCode' => 'ACS.ElasticPlan.InvalidEndTime', 'errorMessage' => 'The end time should be later than current time.', 'description' => '分时弹性的结束时间应该晚于当前时间。'], + ['errorCode' => 'ACS.ElasticPlan.InvalidTodayPlan', 'errorMessage' => 'Failed to enable this elastic plan. Today\'s schedule time is missed and you should prepare at least %s minutes for us to prepare resource.', 'description' => '启用弹性计划失败。今天的弹性变配功能已经无法于弹性计划配置的变配时间进行触发，请检查配置的时间是否晚于可变配时间（当前时间加上资源准备时间%s分钟）。'], + ['errorCode' => 'ACS.ElasticPlan.InvalidTargetSize', 'errorMessage' => 'Invalid target size.', 'description' => '无效的目标规格'], + ['errorCode' => 'ACS.ElasticPlan.InvalidStartTime', 'errorMessage' => 'Invalid start time.', 'description' => '弹性计划开始时间填写不正确'], + ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"15\\",\\n \\"PageSize\\": \\"30\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"Items\\": {\\n \\"Table\\": [\\n {\\n \\"Type\\": \\"Fact\\",\\n \\"Schema\\": \\"spark_test\\",\\n \\"Size\\": 200,\\n \\"Name\\": \\"admin_daily_own_statistic_record\\",\\n \\"IsIncline\\": true,\\n \\"TotalSize\\": 53687091200,\\n \\"SpaceRatio\\": 0.4,\\n \\"RowCount\\": 1000\\n }\\n ]\\n },\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"表倾斜\\",\\n \\"Message\\": \\"检测到有表存在shard倾斜\\",\\n \\"Status\\": \\"NORMAL\\\\nWARNNING\\\\nCRITICAL\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', - 'title' => '查看表监控', - ], - 'DescribeAdbMySqlColumns' => [ - 'summary' => '查询集群指定表的列信息。', - 'methods' => [ - 'get', - 'post', + 'title' => '启用弹性计划', + 'summary' => '启用集群的弹性计划。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-06-30T02:18:58.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-04-13T11:20:17.000Z', 'description' => '错误码发生变更、响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EnableElasticPlan'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:EnableElasticPlan', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<EnableElasticPlanResponse>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</EnableElasticPlanResponse>","errorExample":""}]', + ], + 'ExecuteSparkReplStatement' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - ], + 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'name' => 'AppId', + 'in' => 'formData', + 'schema' => ['title' => 'Spark App的名称', 'description' => '应用ID。'."\n" + .'> 您可以调用[ListSparkApps](~~455888~~)接口查询Spark的应用ID。', 'type' => 'string', 'required' => false, 'example' => 's202411071444hzdvk486d9d2001****', 'default' => 'ADB-Spark-Application'], ], [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'title' => '实例ID', - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1r053byu48p****', - ], + 'name' => 'Code', + 'in' => 'formData', + 'schema' => ['description' => '需要执行的代码。', 'type' => 'string', 'required' => true, 'example' => 'print(1+1)'], ], [ - 'name' => 'Schema', - 'in' => 'query', + 'name' => 'CodeType', + 'in' => 'formData', 'schema' => [ - 'description' => '数据库名称。', + 'description' => '代码的语言类型，取值如下：'."\n" + .'- SCALA'."\n" + .'- PYTHON', 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - 'default' => 'INFORMATION_SCHEMA', + 'required' => true, + 'enumValueTitles' => [], + 'example' => 'PYTHON', ], ], [ - 'name' => 'TableName', - 'in' => 'query', - 'schema' => [ - 'description' => '表名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - 'default' => 'COLUMNS', - ], + 'name' => 'SessionId', + 'in' => 'formData', + 'schema' => ['description' => '执行代码的会话ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '123'], ], ], 'responses' => [ @@ -27913,225 +19649,281 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A9F013CD-0222-595E-8157-445969B97F03', - ], - 'Success' => [ - 'description' => '调用是否成功。'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - 'TableName' => [ - 'description' => "\n" - .'表名。', - 'type' => 'string', - 'example' => 'test', - ], - 'ColumnCount' => [ - 'description' => '总列数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'Columns' => [ - 'description' => '列信息。', - 'type' => 'array', - 'items' => [ - 'description' => '列信息。', - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => '列的数据类型。', - 'type' => 'string', - 'example' => 'bigint', - ], - 'Name' => [ - 'description' => '列名。', - 'type' => 'string', - 'example' => 'id', - ], - 'Comment' => [ - 'description' => '列注释。', - 'type' => 'string', - 'example' => 'test', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => [ + 'description' => '返回数据体。', + 'type' => 'object', + 'properties' => [ + 'StatementId' => ['description' => 'Spark作业中代码块的唯一ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'Code' => ['description' => '执行的代码。', 'type' => 'string', 'example' => 'print(1+1)'], + 'CodeType' => [ + 'description' => '代码的类型，取值如下：'."\n" + .'- SCALA'."\n" + .'- PYTHON', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => 'PYTHON', + ], + 'CodeState' => [ + 'description' => '代码执行状态，取值如下：'."\n" + .'- CANCELLED：取消执行'."\n" + .'- RUNNING：执行中'."\n" + .'- SUCCEEDED：执行成功'."\n" + .'- ERROR：执行失败', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => 'RUNNING', ], + 'AliyunUid' => ['description' => '集群所属的阿里云主账号。', 'type' => 'integer', 'format' => 'int64', 'example' => '17108278707****'], + 'OutputType' => [ + 'description' => '执行结果的序列化格式，结构为一个JSON，取值如下：'."\n" + .'- TEXT： 输出结果为Apache Livy标准下的文本内容。'."\n" + .'- TABLE：输出结果为Apache Livy标准下的表格内容。', + 'type' => 'string', + 'enumValueTitles' => ['TABLE' => '表格', 'TEXT' => '文本'], + 'example' => 'TEXT', + ], + 'Output' => ['description' => '代码执行结果，一个JSON格式的字符串，格式上符合Apache Livy的输出标准。', 'type' => 'string', 'example' => '{"text/plain": 2}'], + 'Columns' => [ + 'description' => '列名数组。', + 'type' => 'array', + 'items' => ['description' => '列名。', 'type' => 'string', 'example' => 'col1'], + ], + 'Error' => ['description' => '错误消息。', 'type' => 'string', 'example' => 'StackOverflow Exception'], + 'StartTime' => ['description' => '开始时间，格式为Unix时间戳，单位毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1730968125000'], + 'EndTime' => ['description' => '结束时间，格式为Unix时间戳，单位毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1730968125000'], ], ], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"A9F013CD-0222-595E-8157-445969B97F03\\",\\n \\"Success\\": true,\\n \\"Schema\\": \\"adb_demo\\",\\n \\"TableName\\": \\"test\\",\\n \\"ColumnCount\\": 1,\\n \\"Columns\\": [\\n {\\n \\"Type\\": \\"bigint\\",\\n \\"Name\\": \\"id\\",\\n \\"Comment\\": \\"test\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeAdbMySqlColumnsResponse>\\n <Message>Success</Message>\\n <RequestId>A9F013CD-0222-595E-8157-445969B97F03</RequestId>\\n <Success>true</Success>\\n <Schema>adb_demo</Schema>\\n <TableName>test</TableName>\\n <ColumnCount>1</ColumnCount>\\n <Columns>\\n <Type>bigint</Type>\\n <Name>id</Name>\\n <Comment>test</Comment>\\n </Columns>\\n</DescribeAdbMySqlColumnsResponse>","errorExample":""}]', - 'title' => '查询表的列信息', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'DescribeAdbMySqlTables' => [ - 'summary' => '枚举集群指定数据库下所有表信息。', - 'methods' => [ - 'get', - 'post', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.App.ExceedQuotaLimitation', 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', 'description' => ''], + ['errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', 'description' => 'AppType类型不合法，请参考使用文档指定适合业务的AppType，请关注配置类型：%s。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ResourceNegativeError', 'errorMessage' => 'The requested resource MUST be positive: %s', 'description' => ''], + ['errorCode' => 'Spark.Config.InvalidAppFilePath', 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', 'description' => '主驱动文件地址必须是合法的OSS地址，当前的地址是 %s。'], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.InvalidDiskConfig', 'errorMessage' => 'The requested disk mount parameter is invalid: %s', 'description' => '磁盘挂载配置错误。'], + ['errorCode' => 'Spark.Config.InvalidHostAliasConfig', 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', 'description' => '域名映射配置错误。'], + ['errorCode' => 'Spark.Config.InvalidLogOssPath', 'errorMessage' => 'The OSS address for log storage is illegal: %s', 'description' => '存储日志的OSS地址非法。'], + ['errorCode' => 'Spark.Config.InvalidRoleArnFormat', 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', 'description' => '配置的RoleARN格式错误。'], + ['errorCode' => 'Spark.Config.InvalidTimeZone', 'errorMessage' => 'Unable to parse time zone configuration %s : %s', 'description' => '时区配置错误。'], + ['errorCode' => 'Spark.Config.MainAppFileNotExists', 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', 'description' => '主驱动文件缺失，必须保证file或者sqls配置不为空。'], + ['errorCode' => 'Spark.Config.OSSPathAccessError', 'errorMessage' => 'The configured OSS address %s cannot be accessed.', 'description' => '配置的OSS路径无法访问。'], + ['errorCode' => 'Spark.Config.OSSPathNotExists', 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', 'description' => 'OSS路径不存在或当前用户无权限访问。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Config.SecurityGroupNotFound', 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', 'description' => '配置的资源组不存在或者因权限不足无法访问。%s。'], + ['errorCode' => 'Spark.Config.VswitchNotFound', 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', 'description' => '无法找到配置虚拟机交换机，或当前账号权限不足。%s。'], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.RoleArn.Invalid', 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', 'description' => 'RoleArn不存在或子账号未授权。'], + ['errorCode' => 'Spark.SQL.BlankError', 'errorMessage' => 'Input sql can not be blank string.', 'description' => '提交SQL不能为空。'], + ['errorCode' => 'Spark.SQL.MultipleSQLError', 'errorMessage' => 'Element in field [sqls] can not contain more than one sql statement: %s.', 'description' => '提交的Spark SQL包含了多条可执行SQL。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Submit spark app failed when parser SQL %s. Error message: %s.', 'description' => '解析提交的Spark SQL失败。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.App.NotFound', 'errorMessage' => 'The Spark application %s is not found.', 'description' => '未能找到输入的 Spark App。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '执行Spark作业中的部分代码', + 'summary' => '执行Spark作业中的部分代码。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ExecuteSparkReplStatement'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:ExecuteSparkReplStatement', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbClusterId}/resourcegroup/{#resourceGroupName}/sparkapp/{#sparkAppId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"StatementId\\": 123,\\n \\"Code\\": \\"print(1+1)\\",\\n \\"CodeType\\": \\"PYTHON\\",\\n \\"CodeState\\": \\"RUNNING\\",\\n \\"AliyunUid\\": 0,\\n \\"OutputType\\": \\"TEXT\\",\\n \\"Output\\": \\"{\\\\\\"text/plain\\\\\\": 2}\\",\\n \\"Columns\\": [\\n \\"col1\\"\\n ],\\n \\"Error\\": \\"StackOverflow Exception\\",\\n \\"StartTime\\": 1730968125000,\\n \\"EndTime\\": 1730968125000\\n }\\n}","type":"json"}]', + ], + 'ExecuteSparkWarehouseBatchSQL' => [ + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => [], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'paid', + 'abilityTreeCode' => '235566', + 'abilityTreeNodes' => ['FEATUREadsCQJTKP'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'name' => 'Agency', + 'in' => 'formData', + 'schema' => ['description' => '客户标记提交的客户端类型，可以是任意合法的纯英文字符串，如Aliyun Dataworks。', 'type' => 'string', 'required' => false, 'example' => 'Dataworks。', 'default' => 'POPSDK'], ], [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'title' => '实例ID', - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], + ], + [ + 'name' => 'ResourceGroupName', + 'in' => 'formData', + 'schema' => ['description' => '资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], + ], + [ + 'name' => 'Query', + 'in' => 'formData', + 'schema' => ['description' => '需要批量执行的SQL语句。多个SQL之间用英文分号（;）分隔。 执行引擎会按照顺序在同一个会话中依次执行这些SQL。', 'type' => 'string', 'required' => true, 'example' => 'CREATE TABLE user(id INT, name STRING);'."\n" + .'INSERT INTO t VALUE(1, \'Bob\');'."\n" + .'SELECT * FROM t;'], ], [ 'name' => 'Schema', - 'in' => 'query', - 'allowEmptyValue' => false, - 'schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - 'default' => 'INFORMATION_SCHEMA', - ], + 'in' => 'formData', + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], + ], + [ + 'name' => 'ExecuteResultLimit', + 'in' => 'formData', + 'schema' => ['description' => '抽取部分数据写入 OSS。单位为 MB，默认值为 4096。由于压缩后文件的大小难以准确估计，实际写入到OSS中的数据会小于此处的配置值。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '4096', 'default' => '1000'], + ], + [ + 'name' => 'ExecuteTimeLimitInSeconds', + 'in' => 'formData', + 'schema' => ['description' => '最大允许可执行时长，单位为秒（s）。如果一组SQL在提交后长时间未能执行成功，会被标记为超时失败。默认值为360000秒即为100小时。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '3600000', 'default' => '604800'], + ], + [ + 'name' => 'RuntimeConfig', + 'in' => 'formData', + 'schema' => ['description' => '执行SQL时的额外运行参数，输入结构需要是一个JSON字符串。'."\n" + ."\n" + .'这里允许写入所有Apache Spark官方文档中的运行时SQL配置。'."\n" + ."\n" + .'同时此处还包含了用于当前API的控制参数，对写OSS的行为进行控制，说明如下：'."\n" + ."\n" + .'‒ `spark.adb.sqlOutputFormat`: 写入到OSS中的文件格式，默认值是`CSV`。可选值为`CSV`,`JSON`。'."\n" + ."\n" + .'‒ `spark.adb.sqlOutputPartitions`: 写入到OSS中的SQL结果的分区数，默认值为1。'."\n" + ."\n" + .'‒ `spark.adb.sqlOutputLocation`：指定写入OSS的地址，SQL执行结果的抽样会被写入到该地址。此配置为空，则不会讲SQL执行结果的抽样数据写入OSS。'."\n" + ."\n" + .'‒ `spark.adb.sqlIgnorePersistError`：是否忽略写抽样结果时发生的错误，默认值为`false`。当配置为`true`时，执行过程中SQL执行成功，但SQL结果的抽样信息写入OSS失败不会打断执行步骤。', 'type' => 'string', 'required' => false, 'example' => '{'."\n" + .' "OSSURL": "oss://testBucketname/"'."\n" + .'}'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '7A7D49E3-5585-5DF8-B62C-75C46B4991DC', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - 'Tables' => [ - 'description' => '表信息。', - 'type' => 'array', - 'items' => [ - 'description' => '表名称。', - 'type' => 'string', - 'example' => 'test', - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'CBE843D8-964D-5EA3-9D31-822125611B6E'], + 'Data' => ['description' => '返回数据体。', 'example' => 'true', '$ref' => '#/components/schemas/SparkBatchSQL'], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"7A7D49E3-5585-5DF8-B62C-75C46B4991DC\\",\\n \\"Success\\": true,\\n \\"Schema\\": \\"adb_demo\\",\\n \\"Tables\\": [\\n \\"test\\"\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeAdbMySqlTablesResponse>\\n <Message>Success</Message>\\n <RequestId>7A7D49E3-5585-5DF8-B62C-75C46B4991DC</RequestId>\\n <Success>true</Success>\\n <Schema>adb_demo</Schema>\\n <Tables>test</Tables>\\n</DescribeAdbMySqlTablesResponse>","errorExample":""}]', - 'title' => '查询数据库下所有表信息', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ], + 404 => [ + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '批量执行Spark SQL', + 'summary' => '批量执行Spark SQL。', 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'DescribeAdbMySqlSchemas' => [ - 'summary' => '枚举指定集群下所有数据库列表。', - 'methods' => [ - 'get', - 'post', + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ExecuteSparkWarehouseBatchSQL'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:ExecuteSparkWarehouseBatchSQL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"CBE843D8-964D-5EA3-9D31-822125611B6E\\",\\n \\"Data\\": {\\n \\"Uid\\": 0,\\n \\"QuerySubmissionTime\\": 1723521767000,\\n \\"Query\\": \\"SELECT * FROM db.tb\\",\\n \\"QueryId\\": \\"sq172352176****\\",\\n \\"Schema\\": \\"default\\",\\n \\"QueryEndTime\\": 1723521767000,\\n \\"DBClusterId\\": \\"amv-bp17s73f016****\\",\\n \\"QueryState\\": \\"RUNNING\\",\\n \\"Statements\\": [\\n {\\n \\"ResultUri\\": \\"oss://yourbucket/result.json\\",\\n \\"EndTime\\": 1723521767000,\\n \\"AppId\\": \\"s20240122jsdx****\\",\\n \\"StatementId\\": \\"sq1723521767****-0001\\",\\n \\"State\\": \\"RUNNING\\",\\n \\"StartTime\\": 1723521767000,\\n \\"Error\\": \\"table is not found\\",\\n \\"Code\\": \\"SELECT 100\\",\\n \\"Result\\": \\"+---+-----+\\\\n|age| name|\\\\n+---+-----+\\\\n| 14| Tom|\\\\n| 23|Alice|\\\\n+---+-----+\\"\\n }\\n ],\\n \\"ErrMessage\\": \\"schema is not found\\",\\n \\"QueryStartTime\\": 1723521767000,\\n \\"ResourceGroupName\\": \\"spark_rg\\"\\n }\\n}","type":"json"}]', + ], + 'ExistRunningSQLEngine' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', - 'deprecated' => false, + 'deprecated' => true, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '150789', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~612397~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1cit7z8j****'], ], [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'title' => '实例ID', - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1r053byu48p****', - ], + 'name' => 'ResourceGroupName', + 'in' => 'formData', + 'schema' => ['description' => '资源组名称。'."\n" + .'>您可以调用[DescribeDBResourceGroup](~~459446~~)接口查看指定集群的资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'spark_test'], ], ], 'responses' => [ @@ -28139,247 +19931,263 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'FA675D68-14A4-5D9C-8820-92537D9F447E'], + 'Data' => [ + 'description' => '选定资源组是否存在运行中的Spark SQL Engine。'."\n" + ."\n" + .'取值：'."\n" + .'- **True**：存在。'."\n" + .'- **False**：不存在。', 'type' => 'boolean', - 'example' => 'true', - ], - 'Schemas' => [ - 'description' => '数据库列表。', - 'type' => 'array', - 'items' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'adb_demo,adb_test,mysql', - ], + 'enumValueTitles' => ['True' => 'True', 'False' => 'False'], + 'example' => 'True', ], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"Schemas\\": [\\n \\"adb_demo,adb_test,mysql\\"\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeAdbMySqlSchemasResponse>\\n <Message>Success</Message>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Success>true</Success>\\n <Schemas>adb_demo,adb_test,mysql</Schemas>\\n</DescribeAdbMySqlSchemasResponse>","errorExample":""}]', - 'title' => '查询所有数据库列表', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], + ], + 'staticInfo' => ['noSubstitutionReason' => '无替代API，历史原因导致该API被标记为弃用。', 'returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => '检测是否存在运行中的Spark SQLEngine', + 'summary' => '是否有存活的SQL ENGINE。', 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'DescribeTableAccessCount' => [ - 'summary' => '查看指定日期内集群下目标表或所有表被访问次数。', - 'methods' => [ - 'post', - 'get', + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2024-05-06T03:09:35.000Z', 'description' => '响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ExistRunningSQLEngine'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetActiveSparkSession', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FA675D68-14A4-5D9C-8820-92537D9F447E\\",\\n \\"Data\\": true\\n}","type":"json"}]', + ], + 'GenerateSqlBySemanticSql' => [ + 'summary' => '通过语义 SQL 生成执行 SQL', + 'path' => '', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-2ze627uzpkh8a8****', - ], + 'schema' => ['title' => '数仓版集群ID。'."\n" + .'>您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有数仓版集群的集群ID。', 'description' => 'ADB 集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-uf6wjk5xxxxxxxxxx'], ], [ - 'name' => 'TableName', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '目标表名。'."\n" - .'> 若该参数留空，则会返回当前日期内目标集群下所有表的使用频次数据。', - 'type' => 'string', - 'required' => false, - 'example' => 'CUSTOMER', - ], + 'schema' => ['title' => 'schema 名称。', 'description' => 'Schema 名称。', 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], ], [ - 'name' => 'StartTime', + 'name' => 'Sql', 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ。'."\n" - .'> 仅支持查看30天内的数据。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2022-09-25T12:10:00Z', - ], + 'schema' => ['title' => '查询语义视图的 SQL', 'description' => '查询语义视图的 SQL', 'type' => 'string', 'required' => true, 'example' => 'select sum(amount) from sv_sales'], ], - [ - 'name' => 'Order', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '将查询结果按指定字段进行排序。格式为JOSN字符串，例如`[{"Field":"TableSchema","Type":"Asc"}]`。其中：'."\n" - .'- `Field`表示排序字段。支持如下取值：'."\n" - .' - `TableSchema`：表所属的数据库名。'."\n" - .' - `TableName`：表名。'."\n" - .' - `AccessCount`：表被访问的次数。'."\n" - .'- `Type`表示排序方式。支持如下取值：'."\n" - .' - `Asc`：升序排序。'."\n" - .' - `Desc`： 降序排序。'."\n" - ."\n" - .'> 若不设置参数，默认按照目标表所属的数据库升序排列。', - 'type' => 'string', - 'required' => false, - 'example' => '[{"Field":"TableSchema","Type":"Asc"}]', + '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' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => [ + 'title' => '返回数据。', + 'description' => '返回数据。', + 'type' => 'object', + 'properties' => [ + 'GeneratedSql' => ['title' => '生成的可执行 SQL', 'description' => '生成的可执行 SQL', 'type' => 'string', 'example' => 'select sum(amount) from orders'], + 'Success' => ['title' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'description' => '生成请求是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'ErrorMessage' => ['title' => '创建任务失败时的错误提示。', 'description' => '创建任务失败时的错误提示。', 'type' => 'string', 'example' => 'Failed to rewrite semantic SQL: Ambiguous path from \'lineitem\' to \'nation\'. Multiple paths found'], + ], + ], + ], ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ['errorCode' => 'MDS.CatalogAlreadyExist', 'errorMessage' => 'The catalog already exists.', 'description' => '目录已经存在'], + ['errorCode' => 'MDS.SemanticViewNotExist', 'errorMessage' => 'This semantic view does not exist.', 'description' => '此语义视图不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + ['errorCode' => 'MDS.InstanceNotExist', 'errorMessage' => 'ADB instance does not exist.', 'description' => 'ADB 实例不存在'], ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '通过语义 SQL 生成执行 SQL', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"GeneratedSql\\": \\"select sum(amount) from orders\\",\\n \\"Success\\": true,\\n \\"ErrorMessage\\": \\"Failed to rewrite semantic SQL: Ambiguous path from \'lineitem\' to \'nation\'. Multiple paths found\\"\\n }\\n}","type":"json"}]', + ], + 'GetADBSparkNecessaryRAMPermissions' => [ + 'path' => '', + 'methods' => ['post'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **10**（默认值）'."\n" - .'- **30**'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', + ], + 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下所有集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1r053byu48p****'."\n"], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '6B7D627B-DA23-572D-AD71-256F64698B7D', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'Items' => [ - 'description' => '表使用详情。', - 'type' => 'array', - 'items' => [ - 'description' => '详情。', - 'type' => 'object', - 'properties' => [ - 'ReportDate' => [ - 'description' => '表使用日期。', - 'type' => 'string', - 'example' => '2022-09-26', - ], - 'TableSchema' => [ - 'description' => '表所属的数据库。', - 'type' => 'string', - 'example' => 'tpch', - ], - 'AccessCount' => [ - 'description' => '表被访问的次数。', - 'type' => 'string', - 'example' => '6', - ], - 'TableName' => [ - 'description' => '表名称。', - 'type' => 'string', - 'example' => 'CUSTOMER', - ], - 'InstanceName' => [ - 'description' => '表所属集群的集群ID。', - 'type' => 'string', - 'example' => 'amv-2ze627uzpkh8a8****', - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '642F3512-C628-5D0C-8815-F6670C****'], + 'Data' => [ + 'description' => '返回数据。', + 'type' => 'object', + 'properties' => [ + 'Passed' => ['description' => '检查是否具有使用ADB Spark的基本权限。'."\n" + ."\n" + .'- true：通过检查，持有基本权限。'."\n" + .'- false：检查失败，缺少部分权限。', 'type' => 'boolean', 'example' => 'true'], + 'DeniedDetail' => [ + 'description' => '权限检查失败时，返回权限检查失败相关的诊断信息。', + 'type' => 'object', + 'properties' => [ + 'ResourceOwnerId' => ['description' => '资源拥有者的ID。', 'type' => 'string', 'example' => '11685695632****'], + 'Action' => ['description' => '鉴权失败的RAM Action名称。', 'type' => 'string', 'example' => 'ListSparkApps'], + 'PrincipalType' => ['description' => '当前用户的身份类型，取值如下：'."\n" + .'- SubUser：RAM用户。'."\n" + .'- AssumedRoleUser：RAM角色。', 'type' => 'string', 'example' => 'SubUser'], + 'ResourceAuthTargetInfo' => ['description' => '鉴权对象的信息，可以是当前用户的RAM账号ID，或者当前访问者对应的角色信息。', 'type' => 'string', 'example' => '223345695632****'."\n"], + 'PolicyType' => ['description' => '引起无权限的策略类型，取值如下:'."\n" + .'- ControlPolicy ：管控策略。'."\n" + .'- SessionPolicy：临时Token额外添加的一个权限策略。'."\n" + .'- AssumeRolePolicy：RAM角色的授信策略。'."\n" + .'- AccountLevelIdentityBasedPolicy：账号授权范围的主体策略，包含自定义策略和系统策略。'."\n" + .'- ResourceGroupLevelIdentityBasedPolicy：资源组授权范围的主体策略，包含自定义策略和系统策略。', 'type' => 'string', 'example' => 'ControlPolicy'], + 'NoPermissionType' => ['description' => '权限策略拒绝的类型，取值如下：'."\n" + .'- ImplicitDeny：资源持有者未配置相关权限策略给当前用户，缺省拒绝未授权的操作。'."\n" + .'- ExplicitDeny：资源持有者配置的RAM策略明确拒绝了当前用户访问对应的资源。', 'type' => 'string', 'example' => 'ImplicitDeny'], + ], + ], + 'Suggestion' => ['description' => '根据诊断信息，推荐客户在RAM系统中进行的配置。', 'type' => 'string', 'example' => 'Grant the system RAM policy \'AliyunADBDeveloperAccess\' to current RAM user can quickly solve this issue.'], ], ], ], ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Spark parameter is not valid, please check error info: %s.', 'description' => 'Spark参数出现错误,错误信息为: %s.'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"6B7D627B-DA23-572D-AD71-256F64698B7D\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"Items\\": [\\n {\\n \\"ReportDate\\": \\"2022-09-26\\",\\n \\"TableSchema\\": \\"tpch\\",\\n \\"AccessCount\\": \\"6\\",\\n \\"TableName\\": \\"CUSTOMER\\",\\n \\"InstanceName\\": \\"amv-2ze627uzpkh8a8****\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeTableAccessCountResponse>\\n <RequestId>6B7D627B-DA23-572D-AD71-256F64698B7D</RequestId>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n <Items>\\n <ReportDate>2022-09-26</ReportDate>\\n <TableSchema>tpch</TableSchema>\\n <AccessCount>6</AccessCount>\\n <TableName>CUSTOMER</TableName>\\n <InstanceName>amv-2ze627uzpkh8a8****</InstanceName>\\n </Items>\\n</DescribeTableAccessCountResponse>","errorExample":""}]', - 'title' => '查询表的访问次数', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'GetViewDDL' => [ - 'summary' => '查询视图的创建语句。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查看当前用户的Spark基本权限诊断报告', + 'summary' => '查看当前用户的Spark基本权限诊断报告。', + 'description' => 'API诊断报告中包含了当前用户是否具有ADB Spark相关功能需要的所有权限，检测权限的范围可能会超过业务最小需求。当前API的诊断报告用于ADB Spark的环境快速初始化场景。如果需要细粒度配置权限，[请参考ADB Spark细粒度权限配置文档。](https://www.alibabacloud.com/help/zh/analyticdb/analyticdb-for-mysql/user-guide/create-the-aliyunadbsparkprocessingdatarole-role-for-a-ram-user-and-grant-permissions-to-the-role?spm=a2c63.p38356.help-menu-92664.d_2_5_0.48362a487dMzm9#section-y2z-ucd-1ko)', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetADBSparkNecessaryRAMPermissions'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetADBSparkNecessaryRAMPermissions', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"642F3512-C628-5D0C-8815-F6670C****\\",\\n \\"Data\\": {\\n \\"Passed\\": true,\\n \\"DeniedDetail\\": {\\n \\"ResourceOwnerId\\": \\"11685695632****\\",\\n \\"Action\\": \\"ListSparkApps\\",\\n \\"PrincipalType\\": \\"SubUser\\",\\n \\"ResourceAuthTargetInfo\\": \\"223345695632****\\\\n\\",\\n \\"PolicyType\\": \\"ControlPolicy\\",\\n \\"NoPermissionType\\": \\"ImplicitDeny\\"\\n },\\n \\"Suggestion\\": \\"Grant the system RAM policy \'AliyunADBDeveloperAccess\' to current RAM user can quickly solve this issue.\\"\\n }\\n}","type":"json"}]', + ], + 'GetCreateTableSQL' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'tags' => [], 'security' => [ [ 'AK' => [], @@ -28391,138 +20199,83 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '157089', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], + 'abilityTreeCode' => '212744', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], ], 'parameters' => [ [ - 'name' => 'SchemaName', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], + 'schema' => ['description' => 'AnalyticDB MySQL湖仓版（3.0）集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-2ze8mbuai974s4y2'], ], [ - 'name' => 'ViewName', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '视图名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'v_modbus', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL支持的地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DBClusterId', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'am-bp1ub9grke1****', - ], + 'schema' => ['description' => '数据库名称。'."\n" + .' '."\n", 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], ], [ - 'name' => 'RegionId', + 'name' => 'TableName', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '表名。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回结果。', + 'description' => '响应结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '421794A3-72A5-5D27-9E8B-A75A4C503E17', - ], - 'SQL' => [ - 'description' => 'SQL语句详情。', - 'type' => 'string', - 'example' => 'CREATE VIEW `test`.`test_view` AS SELECT'."\n" - .' `id`'."\n" - .', `name`'."\n" - .'FROM'."\n" - .' `test_tbl_adb`', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '109462AF-B5FA-3D5A-9377-B27E5B******'], + 'SQL' => ['description' => 'SQL语句。', 'type' => 'string', 'example' => 'create table ('."\n" + .' id varchar(32)'."\n" + .');'], ], ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], - 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '查询某个表的建表语句', + 'summary' => '查询某个表的建表语句。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetCreateTableSQL'], ], - 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetCreateTableSQL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"421794A3-72A5-5D27-9E8B-A75A4C503E17\\",\\n \\"SQL\\": \\"CREATE VIEW `test`.`test_view` AS SELECT\\\\n `id`\\\\n, `name`\\\\nFROM\\\\n `test_tbl_adb`\\"\\n}","errorExample":""},{"type":"xml","example":"<GetViewDDLResponse>\\n <RequestId>421794A3-72A5-5D27-9E8B-A75A4C503E17</RequestId>\\n <SQL>CREATE VIEW `test`.`test_view` AS SELECT\\n `id`\\n, `name`\\nFROM\\n `test_tbl_adb`</SQL>\\n</GetViewDDLResponse>","errorExample":""}]', - 'title' => '查询视图的创建语句', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"109462AF-B5FA-3D5A-9377-B27E5B******\\",\\n \\"SQL\\": \\"create table (\\\\n id varchar(32)\\\\n);\\"\\n}","type":"json"}]', ], - 'GetViewObjects' => [ - 'summary' => '查询视图信息。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'GetDatabaseObjects' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -28534,139 +20287,62 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '157080', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'am-bp1xxxxxxxx47', - ], - ], - [ - 'name' => 'SchemaName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库名称。'."\n" - .' '."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], - ], - [ 'name' => 'OrderBy', 'in' => 'query', - 'schema' => [ - 'description' => '排序字段。'."\n" - .'类型取值：'."\n" - .'- Asc；'."\n" - .'- Desc；'."\n" - ."\n" - .'域取值：'."\n" - .'-ViewName；'."\n" - ."\n" - .'-CreateTime;'."\n" - ."\n" - .'-UpdateTime;'."\n" - ."\n" - .'默认值：{"Type": "Desc","Field": "ViewName"}；', - 'type' => 'string', - 'required' => false, - 'example' => '{"Type": "Desc","Field": "ViewName"}', - ], + 'schema' => ['description' => '排序字段。'."\n" + .'类型取值：'."\n" + .'- Asc；'."\n" + .'- Desc；'."\n" + ."\n" + .'域取值：'."\n" + .'-DatabseName；'."\n" + .'-CreateTime;'."\n" + .'-UpdateTime;'."\n" + ."\n" + .'默认值：{"Type": "Desc","Field": "DatabaseName"}；', 'type' => 'string', 'required' => false, 'example' => '{'."\n" + .' "Type": "Desc",'."\n" + .' "Field": "DatabaseName"'."\n" + .'}'], ], [ - 'name' => 'FilterViewName', + 'name' => 'FilterSchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '视图名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_filter', - ], + 'schema' => ['description' => '数据库名。', 'type' => 'string', 'required' => false, 'example' => 'test_db'], ], [ 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值范围如下：'."\n" - .'* **30**（默认值）。'."\n" - .'* **50**。'."\n" - .'* **100**。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '30', - 'default' => '30', - ], + 'schema' => ['description' => '每页记录数，取值：'."\n" + ."\n" + .'- 30；'."\n" + .'- 50；'."\n" + .'- 100；'."\n" + ."\n" + .'默认值：30。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '30'], ], [ - 'name' => 'FilterViewType', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '视图类型。'."\n" - ."\n" - .'取值：'."\n" - ."\n" - .'-VIRTUAL_VIEW'."\n" - ."\n" - .'-MATERIALIZED_VIEW'."\n" - ."\n\n" - .'默认值：空', - 'type' => 'string', - 'required' => false, - 'example' => 'VIRTUAL_VIEW', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => false, 'example' => 'am-bp1565u55p32****'], ], [ 'name' => 'FilterOwner', 'in' => 'query', - 'schema' => [ - 'description' => '所有者。', - 'type' => 'string', - 'required' => false, - 'example' => 'admin', - ], + 'schema' => ['description' => '所有者。', 'type' => 'string', 'required' => false, 'example' => 'admin'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'ShowMvBaseTable', - 'in' => 'query', - 'schema' => [ - 'description' => '是否展示物化视图基表信息。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ @@ -28676,66 +20352,31 @@ 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'PageNumber' => [ - 'description' => '页码，取值为大于0且不超过Integer数据类型最大值的正整数。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值范围如下：'."\n" - .'* **30**（默认值）。'."\n" - .'* **50**。'."\n" - .'* **100**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '863D51B7-5321-41D8-A0B6-A088B0******'], + 'PageNumber' => ['description' => '页码，取值为正整数。默认值为**1**。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], 'Data' => [ - 'description' => '返回结构体。', + 'description' => '返回数据。', 'type' => 'object', 'properties' => [ - 'PageNumber' => [ - 'description' => '页码，取值为大于0且不超过Integer数据类型最大值的正整数。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值范围如下：'."\n" - .'* **30**（默认值）。'."\n" - .'* **50**。'."\n" - .'* **100**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'TableSummaryModels' => [ + 'DatabaseSummaryModels' => [ 'description' => '结果数组。', 'type' => 'array', - 'items' => [ - 'description' => '视图概要信息。', - '$ref' => '#/components/schemas/TableSummaryModel', - ], + 'items' => ['description' => '数据库概要信息。', '$ref' => '#/components/schemas/DatabaseSummaryModel'], ], + 'PageNumber' => ['description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数，取值：'."\n" + ."\n" + .'- 30；'."\n" + .'- 50；'."\n" + .'- 100；'."\n" + ."\n" + .'默认值：30。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], ], ], ], @@ -28744,307 +20385,277 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], ], 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], ], 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', - ], + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"TableSummaryModels\\": [\\n {\\n \\"SchemaName\\": \\"\\",\\n \\"TableName\\": \\"\\",\\n \\"TableType\\": \\"\\",\\n \\"TableSize\\": 0,\\n \\"CreateTime\\": \\"\\",\\n \\"UpdateTime\\": \\"\\",\\n \\"SQL\\": \\"\\",\\n \\"Description\\": \\"\\",\\n \\"Owner\\": \\"\\",\\n \\"MvDetailModel\\": {\\n \\"FirstRefreshTime\\": \\"\\",\\n \\"QueryRewriteEnabled\\": true,\\n \\"ExplicitHit\\": 0,\\n \\"IsInactive\\": true,\\n \\"RemoteSize\\": 0,\\n \\"LocalSize\\": 0,\\n \\"RefreshState\\": \\"\\",\\n \\"RefreshInterval\\": \\"\\",\\n \\"ImplicitHit\\": 0,\\n \\"UpdatedAt\\": \\"\\",\\n \\"ResourceGroup\\": \\"\\",\\n \\"BaseTableInfos\\": [\\n {\\n \\"SchemaName\\": \\"\\",\\n \\"TableName\\": \\"\\",\\n \\"BaseTableIsMv\\": true,\\n \\"TableEngine\\": \\"\\"\\n }\\n ],\\n \\"TableEngine\\": \\"\\",\\n \\"BaseTableNames\\": [\\n [\\n \\"\\"\\n ]\\n ],\\n \\"EnableDelayAlert\\": 0,\\n \\"EnableFailureAlert\\": 0,\\n \\"LatencyTolerance\\": 0\\n },\\n \\"CreatedBySource\\": \\"\\",\\n \\"CreatedByUser\\": \\"\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetViewObjectsResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n <Data>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n <TableSummaryModels/>\\n </Data>\\n</GetViewObjectsResponse>","errorExample":""}]', - 'title' => '查询视图信息', + 'title' => '查询数据库信息', + 'summary' => '查询数据库信息。', 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'GetDatabaseObjects' => [ - 'summary' => '查询数据库信息。', - 'methods' => [ - 'get', - 'post', + 'changeSet' => [ + ['createdAt' => '2025-05-07T05:42:07.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-10-25T05:36:00.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-03-22T02:16:06.000Z', 'description' => '错误码发生变更、响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetDatabaseObjects'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getDatabaseObjectsByFilter', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"863D51B7-5321-41D8-A0B6-A088B0******\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"Data\\": {\\n \\"DatabaseSummaryModels\\": [\\n {\\n \\"Owner\\": \\"abc\\",\\n \\"SchemaName\\": \\"testSchema\\",\\n \\"Description\\": \\"description\\",\\n \\"CreateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"UpdateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"CreatedBySource\\": \\"\\",\\n \\"CreatedByUser\\": \\"\\",\\n \\"DbType\\": \\"\\",\\n \\"Location\\": \\"\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetDatabaseObjectsResponse>\\n <RequestId>863D51B7-5321-41D8-A0B6-A088B0******</RequestId>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n <Data>\\n <DatabaseSummaryModels/>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n </Data>\\n</GetDatabaseObjectsResponse>","errorExample":""}]', + ], + 'GetFormationCrawler' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], + 'abilityTreeCode' => '138256', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], ], 'parameters' => [ [ - 'name' => 'OrderBy', - 'in' => 'query', - 'schema' => [ - 'description' => '排序字段。'."\n" - .'类型取值：'."\n" - .'- Asc；'."\n" - .'- Desc；'."\n" - ."\n" - .'域取值：'."\n" - .'-DatabseName；'."\n" - .'-CreateTime;'."\n" - .'-UpdateTime;'."\n" - ."\n" - .'默认值：{"Type": "Desc","Field": "DatabaseName"}；', - 'type' => 'string', - 'required' => false, - 'example' => '{'."\n" - .' "Type": "Desc",'."\n" - .' "Field": "DatabaseName"'."\n" - .'}', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-beijing'], ], [ - 'name' => 'FilterSchemaName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_db', - ], + 'name' => 'CrawlerTaskName', + 'in' => 'formData', + 'schema' => ['description' => '任务名称。', 'type' => 'string', 'required' => false, 'example' => 'test-crawler-dbname'], ], [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1xxxxxxxx47'], ], [ - 'name' => 'PageSize', - 'in' => 'query', + 'name' => 'CrawlerTaskId', + 'in' => 'formData', + 'schema' => ['description' => '任务id。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '247'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - ."\n" - .'- 30；'."\n" - .'- 50；'."\n" - .'- 100；'."\n" - ."\n" - .'默认值：30。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '30', + 'type' => 'object', + 'properties' => [ + 'HttpStatusCode' => ['description' => 'HTTP状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '返回数据。', 'type' => 'string', 'example' => '{'."\n" + .' "crawlerInfo":{'."\n" + .' "scheduleState":"NORMAL",'."\n" + .' "configuration":{},'."\n" + .' "gmtCreated":"2026-07-08T09:05:25.000+00:00",'."\n" + .' "dbName":"sales_db",'."\n" + .' "schemaChangePolicy":{'."\n" + .' "deleteRule":"IGNORE",'."\n" + .' "updateRule":"ONLY_ADD_COLUMN"'."\n" + .' },'."\n" + .' "frequency":{'."\n" + .' "cron":"",'."\n" + .' "type":"run_on_demand"'."\n" + .' },'."\n" + .' "uid":"**",'."\n" + .' "sourceInfo":{'."\n" + .' "ossSourceInfo":{'."\n" + .' "sourceMode":"WAREHOUSE",'."\n" + .' "ossLocations":['."\n" + .' "oss://test-bucket/***/***/"'."\n" + .' ],'."\n" + .' "exclusions":[],'."\n" + .' "inclusions":[]'."\n" + .' }'."\n" + .' },'."\n" + .' "failedCount":0,'."\n" + .' "dbClusterId":"am-bp1xxxxxxxx47",'."\n" + .' "sourceType":"OSSWAREHOUSE",'."\n" + .' "classifiers":[],'."\n" + .' "taskName":"[\\"oss://test-bucket/***/***/\\"] -> sales_db",'."\n" + .' "id":36'."\n" + .' },'."\n" + .' "success":true'."\n" + .'}'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '状态码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '提示信息，成功时为 OK', 'type' => 'string', 'example' => 'OK'], + ], + 'description' => '', ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid. ', 'description' => ''], + ['errorCode' => 'NotExists', 'errorMessage' => 'The formation task does not exist. ', 'description' => ''], + ], + ], + 'title' => '查询元数据发现任务详情', + 'summary' => '查询元数据发现任务详情', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": \\"{\\\\n \\\\\\"crawlerInfo\\\\\\":{\\\\n \\\\\\"scheduleState\\\\\\":\\\\\\"NORMAL\\\\\\",\\\\n \\\\\\"configuration\\\\\\":{},\\\\n \\\\\\"gmtCreated\\\\\\":\\\\\\"2026-07-08T09:05:25.000+00:00\\\\\\",\\\\n \\\\\\"dbName\\\\\\":\\\\\\"sales_db\\\\\\",\\\\n \\\\\\"schemaChangePolicy\\\\\\":{\\\\n \\\\\\"deleteRule\\\\\\":\\\\\\"IGNORE\\\\\\",\\\\n \\\\\\"updateRule\\\\\\":\\\\\\"ONLY_ADD_COLUMN\\\\\\"\\\\n },\\\\n \\\\\\"frequency\\\\\\":{\\\\n \\\\\\"cron\\\\\\":\\\\\\"\\\\\\",\\\\n \\\\\\"type\\\\\\":\\\\\\"run_on_demand\\\\\\"\\\\n },\\\\n \\\\\\"uid\\\\\\":\\\\\\"**\\\\\\",\\\\n \\\\\\"sourceInfo\\\\\\":{\\\\n \\\\\\"ossSourceInfo\\\\\\":{\\\\n \\\\\\"sourceMode\\\\\\":\\\\\\"WAREHOUSE\\\\\\",\\\\n \\\\\\"ossLocations\\\\\\":[\\\\n \\\\\\"oss://test-bucket/***/***/\\\\\\"\\\\n ],\\\\n \\\\\\"exclusions\\\\\\":[],\\\\n \\\\\\"inclusions\\\\\\":[]\\\\n }\\\\n },\\\\n \\\\\\"failedCount\\\\\\":0,\\\\n \\\\\\"dbClusterId\\\\\\":\\\\\\"am-bp1xxxxxxxx47\\\\\\",\\\\n \\\\\\"sourceType\\\\\\":\\\\\\"OSSWAREHOUSE\\\\\\",\\\\n \\\\\\"classifiers\\\\\\":[],\\\\n \\\\\\"taskName\\\\\\":\\\\\\"[\\\\\\\\\\\\\\"oss://test-bucket/***/***/\\\\\\\\\\\\\\"] -> sales_db\\\\\\",\\\\n \\\\\\"id\\\\\\":36\\\\n },\\\\n \\\\\\"success\\\\\\":true\\\\n}\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', + ], + 'GetLakeStorage' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'am-bp1565u55p32****', - ], + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'abilityTreeCode' => '216924', + 'abilityTreeNodes' => ['FEATUREadsQO9FPM'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'FilterOwner', + 'name' => 'LakeStorageId', 'in' => 'query', - 'schema' => [ - 'description' => '所有者。', - 'type' => 'string', - 'required' => false, - 'example' => 'admin', - ], + 'schema' => ['title' => '实例 ID。', 'description' => '实例 ID。', 'type' => 'string', 'required' => false, 'example' => '-'], ], [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-*******'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回结果。', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '863D51B7-5321-41D8-A0B6-A088B0******', - ], - 'PageNumber' => [ - 'description' => '页码，取值为正整数。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '******-3EEC-******-9F06-******'], 'Data' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ - 'DatabaseSummaryModels' => [ - 'description' => '结果数组。', + 'LakeStorageId' => ['title' => '湖存储唯一标识', 'description' => '湖存储唯一标识', 'type' => 'string', 'example' => '-'], + 'Description' => ['title' => '湖存储描述', 'description' => '湖存储描述', 'type' => 'string', 'example' => 'a test db'], + 'DBClusterId' => ['title' => 'ADB实例ID', 'description' => 'ADB实例ID', 'type' => 'string', 'example' => 'amv-*******'], + 'FileSize' => ['title' => '总存储量', 'description' => '总存储量', 'type' => 'string', 'example' => '1'], + 'RowCount' => ['title' => '总数据行数', 'description' => '总数据行数', 'type' => 'integer', 'format' => 'int64', 'example' => '-', 'pattern' => '', 'default' => ''], + 'TableCount' => ['title' => '库表数量', 'description' => '库表数量', 'type' => 'integer', 'format' => 'int32', 'example' => '-', 'pattern' => '', 'default' => ''], + 'PartitionCount' => ['description' => '分区数。', 'type' => 'string', 'example' => '-'], + 'CreatorUid' => ['title' => '创建者UID', 'description' => '创建者UID', 'type' => 'string', 'example' => '123456'], + 'OwnerUid' => ['title' => '拥有者UID', 'description' => '拥有者UID', 'type' => 'string', 'example' => '123456'], + 'OperatorUid' => ['title' => '操作者UID', 'description' => '操作者UID', 'type' => 'string', 'example' => '123456'], + 'Permissions' => [ + 'title' => '湖存储权限', + 'description' => '湖存储权限', 'type' => 'array', 'items' => [ - 'description' => '数据库概要信息。', - '$ref' => '#/components/schemas/DatabaseSummaryModel', + 'title' => '权限项', + 'description' => '权限项', + 'type' => 'object', + 'properties' => [ + 'Read' => ['title' => '读权限', 'description' => '读权限', 'type' => 'boolean', 'example' => 'true'], + 'Write' => ['title' => '写权限', 'description' => '写权限', 'type' => 'boolean', 'example' => 'true'], + 'Account' => ['title' => '账户ID', 'description' => '账户ID', 'type' => 'string', 'example' => 'test', 'pattern' => '^\\d+$', 'default' => ''], + 'Type' => [ + 'title' => '账户类型', + 'description' => '账户类型', + 'type' => 'string', + 'example' => '-', + 'enum' => ['CUSTOMER', 'SUB', 'STS'], + ], + ], + 'example' => '-', ], + 'example' => '-', ], - 'PageNumber' => [ - 'description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值：'."\n" - ."\n" - .'- 30；'."\n" - .'- 50；'."\n" - .'- 100；'."\n" - ."\n" - .'默认值：30。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], + 'CreateTime' => ['title' => '创建时间', 'description' => '创建时间', 'type' => 'string', 'example' => '2023-05-15T07:24:58Z'], + 'UpdateTime' => ['title' => '更新时间', 'description' => '更新时间', 'type' => 'string', 'example' => '2024-10-14T02:28:41Z'], + 'RegionId' => ['title' => '区域ID', 'description' => '区域ID', 'type' => 'string', 'example' => 'cn-hangzhou'], ], + 'example' => '-', ], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Ok**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'SUCCESS'], ], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], - ], - 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取湖存储', + 'summary' => '获取湖存储。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetLakeStorage'], ], - 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetLakeStorage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"863D51B7-5321-41D8-A0B6-A088B0******\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"Data\\": {\\n \\"DatabaseSummaryModels\\": [\\n {\\n \\"Owner\\": \\"\\",\\n \\"SchemaName\\": \\"\\",\\n \\"Description\\": \\"\\",\\n \\"CreateTime\\": \\"\\",\\n \\"UpdateTime\\": \\"\\",\\n \\"CreatedBySource\\": \\"\\",\\n \\"CreatedByUser\\": \\"\\",\\n \\"DbType\\": \\"\\",\\n \\"Location\\": \\"\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetDatabaseObjectsResponse>\\n <RequestId>863D51B7-5321-41D8-A0B6-A088B0******</RequestId>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n <Data>\\n <DatabaseSummaryModels/>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n </Data>\\n</GetDatabaseObjectsResponse>","errorExample":""}]', - 'title' => '查询数据库信息', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Data\\": {\\n \\"LakeStorageId\\": \\"-\\",\\n \\"Description\\": \\"a test db\\",\\n \\"DBClusterId\\": \\"amv-*******\\",\\n \\"FileSize\\": \\"1\\",\\n \\"RowCount\\": 0,\\n \\"TableCount\\": 0,\\n \\"PartitionCount\\": \\"-\\",\\n \\"CreatorUid\\": \\"123456\\",\\n \\"OwnerUid\\": \\"123456\\",\\n \\"OperatorUid\\": \\"123456\\",\\n \\"Permissions\\": [\\n {\\n \\"Read\\": true,\\n \\"Write\\": true,\\n \\"Account\\": \\"test\\",\\n \\"Type\\": \\"-\\"\\n }\\n ],\\n \\"CreateTime\\": \\"2023-05-15T07:24:58Z\\",\\n \\"UpdateTime\\": \\"2024-10-14T02:28:41Z\\",\\n \\"RegionId\\": \\"cn-hangzhou\\"\\n },\\n \\"HttpStatusCode\\": 200,\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"SUCCESS\\"\\n}","type":"json"}]', ], - 'GetTable' => [ - 'summary' => '获取表信息。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'GetSemanticView' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -29056,153 +20667,73 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '160312', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ - 'name' => 'DbName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'dbName', - 'default' => 'MYSQL', - ], - ], - [ - 'name' => 'TableName', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '查询表名。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'tableName', - 'default' => 'USER', - ], + 'schema' => ['title' => '集群ID', 'description' => 'ADB 集群ID', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1d8lbdj22rx****'], ], [ - 'name' => 'DBClusterId', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-*******', - ], + 'schema' => ['title' => 'schema名。', 'description' => 'Schema名称。', 'type' => 'string', 'required' => true, 'example' => 'adb_demo'], ], [ - 'name' => 'RegionId', + 'name' => 'ViewName', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['title' => '语义视图名称。', 'description' => '语义视图名称。', 'type' => 'string', 'required' => true, 'example' => 'sv_name'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回结果。', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Code' => [ - 'description' => '错误码。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'Message' => [ - 'description' => '错误信息。', - 'type' => 'string', - 'example' => '""', - ], - 'Success' => [ - 'description' => '是否成功。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Table' => [ - 'description' => '表详细信息。', - '$ref' => '#/components/schemas/TableModel', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => ['title' => '返回结果数据。', 'description' => '返回结果数据。', 'example' => '69', '$ref' => '#/components/schemas/SemanticViewModel'], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + ['errorCode' => 'MDS.CatalogAlreadyExist', 'errorMessage' => 'The catalog already exists.', 'description' => '目录已经存在'], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ['errorCode' => 'MDS.SemanticViewNotExist', 'errorMessage' => 'This semantic view does not exist.', 'description' => '此语义视图不存在'], ], 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + [ + ['errorCode' => 'MDS.InstanceNotExist', 'errorMessage' => 'ADB instance does not exist.', 'description' => 'ADB 实例不存在'], ], 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', - ], + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Code\\": 0,\\n \\"Message\\": \\"\\\\\\"\\\\\\"\\",\\n \\"Success\\": true,\\n \\"Table\\": {\\n \\"TblId\\": 0,\\n \\"DbName\\": \\"\\",\\n \\"TableName\\": \\"\\",\\n \\"TableType\\": \\"\\",\\n \\"PartitionKeys\\": [\\n {\\n \\"Name\\": \\"\\",\\n \\"Type\\": \\"\\",\\n \\"Comment\\": \\"\\",\\n \\"DatabaseName\\": \\"\\",\\n \\"TableName\\": \\"\\",\\n \\"MappedName\\": \\"\\",\\n \\"DataType\\": \\"\\",\\n \\"CreateTime\\": \\"\\",\\n \\"UpdateTime\\": \\"\\",\\n \\"PkPosition\\": 0,\\n \\"IsPartitionKey\\": true,\\n \\"OrdinalPosition\\": 0,\\n \\"ColumnRawName\\": \\"\\",\\n \\"PhysicalColumnName\\": \\"\\",\\n \\"Nullable\\": true,\\n \\"AutoIncrement\\": true,\\n \\"Precision\\": 0,\\n \\"Scale\\": 0,\\n \\"Primarykey\\": true,\\n \\"DefaultValue\\": \\"\\",\\n \\"Tokenizer\\": \\"\\",\\n \\"Encode\\": \\"\\",\\n \\"Compression\\": \\"\\",\\n \\"Delimiter\\": \\"\\",\\n \\"ValueType\\": \\"\\",\\n \\"CompressFloatUseShort\\": true,\\n \\"OnUpdate\\": \\"\\"\\n }\\n ],\\n \\"Parameters\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"Sd\\": {\\n \\"SdId\\": 0,\\n \\"Location\\": \\"\\",\\n \\"InputFormat\\": \\"\\",\\n \\"OutputFormat\\": \\"\\",\\n \\"Compressed\\": true,\\n \\"NumBuckets\\": 0,\\n \\"SerDeInfo\\": {\\n \\"SerDeId\\": 0,\\n \\"Name\\": \\"\\",\\n \\"Parameters\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"SerializationLib\\": \\"\\"\\n },\\n \\"Parameters\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"StoredAsSubDirectories\\": true\\n },\\n \\"CreateTime\\": \\"\\",\\n \\"ViewOriginalText\\": \\"\\",\\n \\"ViewExpandedText\\": \\"\\",\\n \\"Temporary\\": true,\\n \\"Comment\\": \\"\\",\\n \\"Cols\\": [\\n {\\n \\"Name\\": \\"\\",\\n \\"Type\\": \\"\\",\\n \\"Comment\\": \\"\\",\\n \\"DatabaseName\\": \\"\\",\\n \\"TableName\\": \\"\\",\\n \\"MappedName\\": \\"\\",\\n \\"DataType\\": \\"\\",\\n \\"CreateTime\\": \\"\\",\\n \\"UpdateTime\\": \\"\\",\\n \\"PkPosition\\": 0,\\n \\"IsPartitionKey\\": true,\\n \\"OrdinalPosition\\": 0,\\n \\"ColumnRawName\\": \\"\\",\\n \\"PhysicalColumnName\\": \\"\\",\\n \\"Nullable\\": true,\\n \\"AutoIncrement\\": true,\\n \\"Precision\\": 0,\\n \\"Scale\\": 0,\\n \\"Primarykey\\": true,\\n \\"DefaultValue\\": \\"\\",\\n \\"Tokenizer\\": \\"\\",\\n \\"Encode\\": \\"\\",\\n \\"Compression\\": \\"\\",\\n \\"Delimiter\\": \\"\\",\\n \\"ValueType\\": \\"\\",\\n \\"CompressFloatUseShort\\": true,\\n \\"OnUpdate\\": \\"\\"\\n }\\n ],\\n \\"DistributeColumns\\": [\\n {\\n \\"Name\\": \\"\\",\\n \\"Type\\": \\"\\",\\n \\"Comment\\": \\"\\",\\n \\"DatabaseName\\": \\"\\",\\n \\"TableName\\": \\"\\",\\n \\"MappedName\\": \\"\\",\\n \\"DataType\\": \\"\\",\\n \\"CreateTime\\": \\"\\",\\n \\"UpdateTime\\": \\"\\",\\n \\"PkPosition\\": 0,\\n \\"IsPartitionKey\\": true,\\n \\"OrdinalPosition\\": 0,\\n \\"ColumnRawName\\": \\"\\",\\n \\"PhysicalColumnName\\": \\"\\",\\n \\"Nullable\\": true,\\n \\"AutoIncrement\\": true,\\n \\"Precision\\": 0,\\n \\"Scale\\": 0,\\n \\"Primarykey\\": true,\\n \\"DefaultValue\\": \\"\\",\\n \\"Tokenizer\\": \\"\\",\\n \\"Encode\\": \\"\\",\\n \\"Compression\\": \\"\\",\\n \\"Delimiter\\": \\"\\",\\n \\"ValueType\\": \\"\\",\\n \\"CompressFloatUseShort\\": true,\\n \\"OnUpdate\\": \\"\\"\\n }\\n ],\\n \\"PhysicalTableName\\": \\"\\",\\n \\"PhysicalDatabaseName\\": \\"\\",\\n \\"DistributeType\\": \\"\\",\\n \\"PartitionType\\": \\"\\",\\n \\"PartitionColumn\\": \\"\\",\\n \\"PartitionCount\\": 0,\\n \\"PreviousVersion\\": 0,\\n \\"CurrentVersion\\": 0,\\n \\"UpdateTime\\": \\"\\",\\n \\"TableEngineName\\": \\"\\",\\n \\"IsAllIndex\\": true,\\n \\"BlockSize\\": 0,\\n \\"Compression\\": \\"\\",\\n \\"RawTableName\\": \\"\\",\\n \\"SubpartitionType\\": \\"\\",\\n \\"SubpartitionColumn\\": \\"\\",\\n \\"SubpartitionCount\\": 0,\\n \\"ArchiveType\\": \\"\\",\\n \\"MaxColumnId\\": 0,\\n \\"EnableDfs\\": true,\\n \\"StoragePolicy\\": \\"\\",\\n \\"HotPartitionCount\\": 0,\\n \\"IsFulltextDict\\": true,\\n \\"RtIndexAll\\": true,\\n \\"RouteColumns\\": [],\\n \\"RtEngineType\\": \\"\\",\\n \\"RtModeType\\": \\"\\",\\n \\"RouteType\\": \\"\\",\\n \\"DictEncode\\": true,\\n \\"BucketCount\\": 0,\\n \\"Bucket\\": 0,\\n \\"ViewSecurityMode\\": \\"\\",\\n \\"Indexes\\": [\\n {\\n \\"DatabaseName\\": \\"\\",\\n \\"PhysicalTableName\\": \\"\\",\\n \\"IndexName\\": \\"\\",\\n \\"IndexType\\": \\"\\",\\n \\"IndexColumns\\": [],\\n \\"ColumnOrds\\": [\\n \\"\\"\\n ],\\n \\"Options\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"CreateTime\\": \\"\\",\\n \\"UpdateTime\\": \\"\\"\\n }\\n ],\\n \\"CreatedBySource\\": \\"\\",\\n \\"CreatedByUser\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetTableResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Code>0</Code>\\n <Message>\\"\\"</Message>\\n <Success>true</Success>\\n <Table>\\n <PartitionKeys/>\\n <Sd>\\n <SerDeInfo/>\\n </Sd>\\n <Cols/>\\n <DistributeColumns/>\\n <RouteColumns/>\\n <RouteEffectiveColumn/>\\n <Indexes>\\n <IndexColumns/>\\n </Indexes>\\n </Table>\\n</GetTableResponse>","errorExample":""}]', - 'title' => '查询表信息', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'GetTableColumns' => [ - 'summary' => '查询列信息。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询语义视图', + 'summary' => '查询语义视图', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"ViewSchema\\": \\"sales_db\\",\\n \\"Definition\\": \\"name: revenue_analysis\\\\ndescription: \\\\\\"Semantic view for analyzing revenue across products and customers\\\\\\"\\\\n\\\\ntables:\\\\n - name: customers\\\\n description: \\\\\\"Customer information\\\\\\"\\\\n base_table:\\\\n schema: sales_db\\\\n table: customers\\\\n dimensions:\\\\n - name: customer_name\\\\n synonyms: [\\\\\\"client name\\\\\\", \\\\\\"customer\\\\\\"]\\\\n description: \\\\\\"Full name of the customer\\\\\\"\\\\n expr: c_name\\\\n data_type: VARCHAR\\\\n - name: customer_segment\\\\n synonyms: [\\\\\\"segment\\\\\\", \\\\\\"market segment\\\\\\"]\\\\n description: \\\\\\"Customer market segment\\\\\\"\\\\n expr: c_mktsegment\\\\n data_type: VARCHAR\\\\n is_enum: true\\\\n\\\\n - name: orders\\\\n description: \\\\\\"Order information\\\\\\"\\\\n base_table:\\\\n schema: sales_db\\\\n table: orders\\\\n dimensions:\\\\n - name: order_date\\\\n description: \\\\\\"Date when order was placed\\\\\\"\\\\n expr: o_orderdate\\\\n data_type: DATE\\\\n - name: order_year\\\\n description: \\\\\\"Year when order was placed\\\\\\"\\\\n expr: YEAR(o_orderdate)\\\\n data_type: NUMBER\\\\n facts:\\\\n - name: order_total\\\\n description: \\\\\\"Total order amount\\\\\\"\\\\n expr: o_totalprice\\\\n data_type: NUMBER\\\\n metrics:\\\\n - name: total_orders\\\\n description: \\\\\\"Total number of orders\\\\\\"\\\\n expr: COUNT(*)\\\\n - name: total_revenue\\\\n description: \\\\\\"Total revenue of orders\\\\\\"\\\\n expr: SUM(o_totalprice)\\\\n - name: average_order_value\\\\n description: \\\\\\"Average order value\\\\\\"\\\\n expr: AVG(o_totalprice)\\\\n\\\\nrelationships:\\\\n - name: orders_to_customers\\\\n left_table: orders\\\\n right_table: customers\\\\n relationship_columns:\\\\n - left_column: o_custkey\\\\n right_column: c_custkey\\\\n\\\\nmetrics:\\\\n - name: revenue_per_customer\\\\n description: \\\\\\"Average revenue per customer\\\\\\"\\\\n expr: orders.total_revenue / customers.customer_count\\\\n\\",\\n \\"ViewName\\": \\"revenue_analysis\\",\\n \\"Comment\\": \\"这是一个定义销售额相关指标的视图\\",\\n \\"Score\\": 0.81\\n }\\n}","type":"json"}]', + ], + 'GetSparkAppAttemptLog' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -29210,220 +20741,98 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '157085', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], - ], + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ - 'name' => 'SchemaName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], - ], - [ - 'name' => 'TableName', - 'in' => 'query', - 'schema' => [ - 'description' => '表名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'name' => 'AttemptId', + 'in' => 'formData', + 'schema' => ['title' => 'spark重试的id', 'description' => '重试日志的ID。'."\n" + .'> 调用[ListSparkAppAttempts](~~455887~~)接口查询应用的重试历史信息，包含重试日志ID。', 'type' => 'string', 'required' => true, 'example' => 's202207151211hz****-0001', 'maxLength' => 72], ], [ - 'name' => 'ColumnName', - 'in' => 'query', - 'schema' => [ - 'description' => '列名。', - 'type' => 'string', - 'required' => false, - 'example' => 'assist_user_phone', - ], + 'name' => 'LogLength', + 'in' => 'formData', + 'schema' => ['title' => '返回尾部日志的行数', 'description' => '重试日志的行数。取值范围：1~500，默认值为300。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '500', 'minimum' => '0', 'exclusiveMinimum' => true, 'example' => '20', 'default' => '300'], ], [ 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['title' => '读取日志的其实偏移量。', 'description' => '读取日志的其实偏移量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'minimum' => '0', 'example' => '1', 'default' => '1'], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值范围如下：'."\n" - .'* **30**（默认值）。'."\n" - .'* **50**。'."\n" - .'* **100**。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '30', - ], - ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['title' => '一页的日志行数', 'description' => '单页数据行数。', 'type' => 'string', 'required' => false, 'example' => '500', 'default' => '100000'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'PageNumber' => [ - 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值范围如下：'."\n" - .'* **30**（默认值）。'."\n" - .'* **50**。'."\n" - .'* **100**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '结果中数据的总条数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '15', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'C3A9594F-1D40-4472-A96C-8FB8AA20D38C'], 'Data' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ - 'PageNumber' => [ - 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值范围如下：'."\n" - .'* **30**（默认值）。'."\n" - .'* **50**。'."\n" - .'* **100**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '结果中数据的总条数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '15', - ], - 'Table' => [ - 'description' => '表的详细信息。', - '$ref' => '#/components/schemas/TableDetailModel', - ], + 'LogContent' => ['description' => '日志内容。', 'type' => 'string', 'example' => '22/04/22 15:30:49 INFO Utils: Start the dump task because s202207151211hz****-0001 app end, the interval is 238141ms;22/04/22 15:30:49 INFO AbstractConnector: Stopped Spark@5e774d9d{HTTP/1.1, (http/1.1)}{0.0.0.0:4040}'], + 'Message' => ['description' => '返回告警信息，如任务执行失败或资源不足等，无告警时则返回为空。', 'type' => 'string', 'example' => 'WARNING: log file maybe deleted, please check oss path: oss://TestBucketName/applog/'], + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-bp1bg858bo8c****'], + 'AppId' => ['description' => '应用ID。', 'type' => 'string', 'example' => 's202204132018hzprec1ac61a000****'], + 'LogSize' => ['title' => '日志的行数，0代表没有有效日志。', 'description' => '日志的行数，0代表没有有效日志。', 'type' => 'integer', 'format' => 'int32', 'example' => '775946240'], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], ], 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], ], 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', - ], + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 15,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 15,\\n \\"Table\\": {\\n \\"SchemaName\\": \\"\\",\\n \\"TableName\\": \\"\\",\\n \\"TableType\\": \\"\\",\\n \\"CreateTime\\": \\"\\",\\n \\"UpdateTime\\": \\"\\",\\n \\"Description\\": \\"\\",\\n \\"Owner\\": \\"\\",\\n \\"Columns\\": [\\n {\\n \\"ColumnName\\": \\"\\",\\n \\"Type\\": \\"\\",\\n \\"Description\\": \\"\\",\\n \\"SchemaName\\": \\"\\",\\n \\"TableName\\": \\"\\",\\n \\"CreateTime\\": \\"\\",\\n \\"UpdateTime\\": \\"\\",\\n \\"PartitionKey\\": true,\\n \\"Nullable\\": true,\\n \\"PrimaryKey\\": true,\\n \\"DistributeKey\\": true\\n }\\n ],\\n \\"Catalog\\": \\"\\",\\n \\"CreatedBySource\\": \\"\\",\\n \\"CreatedByUser\\": \\"\\",\\n \\"Location\\": \\"\\",\\n \\"Parameters\\": {\\n \\"key\\": \\"\\"\\n }\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetTableColumnsResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>15</TotalCount>\\n <Data>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>15</TotalCount>\\n <Table>\\n <Columns/>\\n </Table>\\n </Data>\\n</GetTableColumnsResponse>","errorExample":""}]', - 'title' => '查询列信息', + 'title' => '查询Spark应用的重试日志', + 'summary' => '查询Spark应用的重试日志。', 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'GetTableDDL' => [ - 'summary' => '查询建表语句。', - 'methods' => [ - 'post', - 'get', + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2024-01-18T12:41:47.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-09-01T08:38:08.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-07-27T06:45:59.000Z', 'description' => '错误码发生变更、响应参数发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkAppAttemptLog'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkAppAttemptLog', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C3A9594F-1D40-4472-A96C-8FB8AA20D38C\\",\\n \\"Data\\": {\\n \\"LogContent\\": \\"22/04/22 15:30:49 INFO Utils: Start the dump task because s202207151211hz****-0001 app end, the interval is 238141ms;22/04/22 15:30:49 INFO AbstractConnector: Stopped Spark@5e774d9d{HTTP/1.1, (http/1.1)}{0.0.0.0:4040}\\",\\n \\"Message\\": \\"WARNING: log file maybe deleted, please check oss path: oss://TestBucketName/applog/\\",\\n \\"DBClusterId\\": \\"amv-bp1bg858bo8c****\\",\\n \\"AppId\\": \\"s202204132018hzprec1ac61a000****\\",\\n \\"LogSize\\": 775946240\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkAppAttemptLogResponse>\\n <RequestId>C3A9594F-1D40-4472-A96C-8FB8AA20D38C</RequestId>\\n <Data>\\n <LogContent>22/04/22 15:30:49 INFO Utils: Start the dump task because s202207151211hz****-0001 app end, the interval is 238141ms;22/04/22 15:30:49 INFO AbstractConnector: Stopped Spark@5e774d9d{HTTP/1.1, (http/1.1)}{0.0.0.0:4040}</LogContent>\\n <Message>WARNING: log file maybe deleted, please check oss path: oss://TestBucketName/applog/</Message>\\n </Data>\\n</GetSparkAppAttemptLogResponse>","errorExample":""}]', + ], + 'GetSparkAppInfo' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -29431,141 +20840,131 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '157088', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'SchemaName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库名称。'."\n" - .' '."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], - ], - [ - 'name' => 'TableName', - 'in' => 'query', - 'schema' => [ - 'description' => '表名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'name' => 'AppId', + 'in' => 'formData', + 'schema' => ['title' => 'spark app的id', 'description' => '应用ID。'."\n" + .'> 您可以调用[ListSparkApps](~~455888~~)接口查询Spark应用的ID。', 'type' => 'string', 'required' => true, 'example' => 's202205201533hz1209892000****', 'maxLength' => 64, 'minLength' => 0], ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'am-bp1ub9grke1****', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n\n" + .'> 您可以调用[DescribeDBClusters](~~612397~~)接口查看集群的集群ID。', 'type' => 'string', 'required' => false, 'example' => 'am-bp11q28kvl688****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '863D51B7-5321-41D8-A0B6-A088B0******', - ], - 'SQL' => [ - 'description' => 'SQL语句。', - 'type' => 'string', - 'example' => 'create table ('."\n" - .' id varchar(32)'."\n" - .');', - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380'], + 'Data' => ['description' => 'Spark应用的信息。返回参数说明：'."\n" + .'- **Data**：Spark应用模板数据。'."\n" + .'- **EstimateExecutionCpuTimeInSeconds**：执行Spark应用消耗CPU的时长，单位毫秒（ms）。'."\n" + .'- **LogRootPath**：日志文件存储路径。'."\n" + .'- **LastAttemptId**：重试ID。'."\n" + .'- **WebUiAddress**：Web UI地址。'."\n" + .'- **SubmittedTimeInMillis**：提交Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **StartedTimeInMillis**：Spark应用的创建时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **LastUpdatedTimeInMillis**：最近一次更新Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **TerminatedTimeInMillis**：Spark应用终止执行的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **DBClusterId**：执行Spark应用的集群ID。'."\n" + .'- **ResourceGroupName**：Job型资源组名称。'."\n" + .'- **DurationInMillis**：Spark应用执行耗时，单位毫秒（ms）。', 'example' => '{ \\"name\\": \\"SparkPi\\", \\"file\\": \\"local:///tmp/spark-examples.jar\\", \\"className\\": \\"org.apache.spark.examples.SparkPi\\", \\"args\\": [ \\"1000000\\" ], \\"conf\\": { \\"spark.driver.resourceSpec\\": \\"small\\", \\"spark.executor.instances\\": 1, \\"spark.executor.resourceSpec\\": \\"small\\" } }",'."\n" + .' "EstimateExecutionCpuTimeInSeconds" : 100,'."\n" + .' "LogRootPath" : "oss://test/logs/driver",'."\n" + .' "LastAttemptId" : "s202204291426hzpre60cfabb0000004-0003",'."\n" + .' "WebUiAddress" : "https://sparkui.aliyuncs.com/token=xxx",'."\n" + .' "SubmittedTimeInMillis" : 1651213645000,'."\n" + .' "StartedTimeInMillis" : 1651213645010,'."\n" + .' "LastUpdatedTimeInMillis" : 1651213645200,'."\n" + .' "TerminatedTimeInMillis" : 1651213645300,'."\n" + .' "DBClusterId" : "am-dbclusterid",'."\n" + .' "ResourceGroupName" : "spark-rg",'."\n" + .' "DurationInMillis" : 100'."\n" + .' }', '$ref' => '#/components/schemas/SparkAppInfo'], + ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '只允许分析处于终止状态的 Spark app。指定 app 不满足条件。'], + ['errorCode' => 'Spark.AnalyzeTask.FailedToKill', 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', 'description' => '杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。'], + ['errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.KillOperationFailed', 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', 'description' => '杀死 Spark 应用失败，请稍后重试。'], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Log.IllegalPath', 'errorMessage' => 'Invalid job log URI: %s.', 'description' => '配置的Spark日志路径不合法：%s。'], + ['errorCode' => 'Spark.Log.InvalidState', 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'description' => '无法获取指定Spark作业的日志。'], + ['errorCode' => 'Spark.Oss.InternalError', 'errorMessage' => 'An OSS internal error occurred: %s', 'description' => 'OSS内部错误，请求失败。'], + ['errorCode' => 'Spark.RoleArn.Invalid', 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', 'description' => 'RoleArn不存在或子账号未授权。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', 'description' => 'Spark作业信息中的SQL无法解析。'], + ['errorCode' => 'Spark.TemplateFile.BadFileType', 'errorMessage' => 'The requested template %s is not a file.', 'description' => '请求的模板文件ID不是文件类型的。'], ], 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.AnalyzeTask.NotFound', 'errorMessage' => 'The requested analysis task %s is not found.', 'description' => '请求查看的日志分析任务 %s 不存在。'], + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.Log.PodLogNotFound', 'errorMessage' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', 'description' => '无法通过podName找到对应pod的日志 [%s]。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], + ['errorCode' => 'Spark.TemplateFile.TemplateNotFound', 'errorMessage' => 'The template %s is not found.', 'description' => '模板文件未找到。'], + ], + 406 => [ + ['errorCode' => 'Spark.App.KillNotAcceptable', 'errorMessage' => 'Can\'t kill the application %s in %s state.', 'description' => '不能删除处于不可删除状态下的 Spark 应用。'], ], 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', - ], + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ['errorCode' => 'Spark.Resources.LoadFileFromClasspathFailed', 'errorMessage' => 'Can\'t load the content from file: %s', 'description' => '加载资源文件失败。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"863D51B7-5321-41D8-A0B6-A088B0******\\",\\n \\"SQL\\": \\"create table (\\\\n id varchar(32)\\\\n);\\"\\n}","errorExample":""},{"type":"xml","example":"<GetTableDDLResponse>\\n <RequestId>863D51B7-5321-41D8-A0B6-A088B0******</RequestId>\\n <SQL>create table (\\n id varchar(32)\\n);</SQL>\\n</GetTableDDLResponse>","errorExample":""}]', - 'title' => '查询建表语句', + 'title' => '查询Spark应用的信息', + 'summary' => '查看Spark应用的信息。', 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'GetTableObjects' => [ - 'summary' => '查询表信息。', - 'methods' => [ - 'post', - 'get', + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-11-24T09:19:26.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-06-28T01:10:37.000Z', 'description' => '错误码发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkAppInfo'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkAppInfo', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202207151211hz0c****\\",\\n \\"Message\\": \\"WARN: Disk is full.\\",\\n \\"Priority\\": \\"NORMAL\\",\\n \\"State\\": \\"SUBMITTED\\",\\n \\"DBClusterId\\": \\"amv-23xxxx\\",\\n \\"Detail\\": {\\n \\"DurationInMillis\\": 100,\\n \\"LogRootPath\\": \\"oss://<bucket-name>/logs/driver\\",\\n \\"DBClusterId\\": \\"amv-bp11q28kvl688****\\",\\n \\"Data\\": \\"{ \\\\\\"name\\\\\\": \\\\\\"SparkPi\\\\\\", \\\\\\"file\\\\\\": \\\\\\"local:///tmp/spark-examples.jar\\\\\\", \\\\\\"className\\\\\\": \\\\\\"org.apache.spark.examples.SparkPi\\\\\\", \\\\\\"args\\\\\\": [ \\\\\\"1000000\\\\\\" ], \\\\\\"conf\\\\\\": { \\\\\\"spark.driver.resourceSpec\\\\\\": \\\\\\"small\\\\\\", \\\\\\"spark.executor.instances\\\\\\": 1, \\\\\\"spark.executor.resourceSpec\\\\\\": \\\\\\"small\\\\\\" } }\\",\\n \\"EstimateExecutionCpuTimeInSeconds\\": 100,\\n \\"LastUpdatedTimeInMillis\\": 1651213645200,\\n \\"RunningStartTimeInMillis\\": 36000,\\n \\"LastAttemptId\\": \\"s202204291426hzpre60****-0003\\",\\n \\"TerminatedTimeInMillis\\": 1651213645300,\\n \\"ResourceProvisioningDurationInMillis\\": 36000,\\n \\"ExecutionDurationInMillis\\": 36000,\\n \\"WebUiAddress\\": \\"https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****\\",\\n \\"SubmittedTimeInMillis\\": 1651213645000,\\n \\"StartedTimeInMillis\\": 1651213645010,\\n \\"AppType\\": \\"BATCH\\",\\n \\"ResourceGroupName\\": \\"spark-rg\\"\\n },\\n \\"AppName\\": \\"SparkTest\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkAppInfoResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <AppId>s202207151211hz0cb4*****</AppId>\\n <AppName>Spark Test</AppName>\\n <State>FAILED</State>\\n <Message>WARN: Disk is full</Message>\\n <Detail>\\n <Data>{ \\"name\\": \\"SparkPi\\", \\"file\\": \\"local:///tmp/spark-examples.jar\\", \\"className\\": \\"org.apache.spark.examples.SparkPi\\", \\"args\\": [ \\"1000000\\" ], \\"conf\\": { \\"spark.driver.resourceSpec\\": \\"small\\", \\"spark.executor.instances\\": 1, \\"spark.executor.resourceSpec\\": \\"small\\" } }</Data>\\n <EstimateExecutionCpuTimeInSeconds>100</EstimateExecutionCpuTimeInSeconds>\\n <LogRootPath>oss://<bucket-name>/logs/driver</LogRootPath>\\n <LastAttemptId>s202204291426hzpre60cfa*****-0003</LastAttemptId>\\n <WebUiAddress>https://sparkui.aliyuncs.com/token=xxx</WebUiAddress>\\n <SubmittedTimeInMillis>1651213645000</SubmittedTimeInMillis>\\n <StartedTimeInMillis>1651213645010</StartedTimeInMillis>\\n <LastUpdatedTimeInMillis>1651213645200</LastUpdatedTimeInMillis>\\n <TerminatedTimeInMillis>1651213645300</TerminatedTimeInMillis>\\n <DBClusterId>amv-bp11q28kv****</DBClusterId>\\n <ResourceGroupName>spark-rg</ResourceGroupName>\\n <DurationInMillis>100</DurationInMillis>\\n </Detail>\\n </Data>\\n</GetSparkAppInfoResponse>","errorExample":""}]', + ], + 'GetSparkAppLog' => [ + 'summary' => '查询Spark应用的日志。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -29573,214 +20972,175 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '157079', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'SchemaName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库名称。'."\n" - .' '."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], + 'name' => 'AppId', + 'in' => 'formData', + 'schema' => ['title' => '应用Id', 'description' => '应用ID。'."\n" + .'> 调用[ListSparkApps](~~612475~~)接口查询Spark应用的ID。', 'type' => 'string', 'required' => true, 'example' => 's202206061441hz22a35ab000****'], ], [ - 'name' => 'OrderBy', - 'in' => 'query', - 'schema' => [ - 'description' => '排序字段。'."\n" - .'类型取值：'."\n" - .'- Asc；'."\n" - .'- Desc；'."\n" - ."\n" - .'域取值：'."\n" - .'-TableName；'."\n" - .'-TableSize；'."\n" - .'-CreateTime;'."\n" - .'-UpdateTime;'."\n" - ."\n" - .'默认值：{"Type": "Desc","Field": "TableName"}；'."\n" - ."\n", - 'type' => 'string', - 'required' => false, - 'example' => '{"Type": "Desc","Field": "TableName"}', - ], + 'name' => 'LogLength', + 'in' => 'formData', + 'schema' => ['title' => '需要返回的尾部日志行数.', 'description' => '日志的行数。取值范围为1~500，默认值为300。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '500', 'minimum' => '0', 'exclusiveMinimum' => true, 'example' => '20', 'default' => '300'], ], [ - 'name' => 'FilterTblName', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '表名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_tbl', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-2ze6fl8ud7t***'], ], [ 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['title' => '读取日志的偏移量。', 'description' => '读取日志的页码号。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'minimum' => '0', 'example' => '1', 'default' => '1'], ], [ 'name' => 'PageSize', 'in' => 'query', + 'schema' => ['description' => '单页数据行数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '500', 'default' => '100000'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - ."\n" - .'- 30；'."\n" - .'- 50；'."\n" - .'- 100；'."\n" - ."\n" - .'默认值：30。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '30', - 'default' => '30', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'C3A9594F-1D40-4472-A96C-8FB8AA20D38C'], + 'Data' => [ + 'description' => '日志详情。', + 'type' => 'object', + 'properties' => [ + 'LogContent' => ['title' => 'spark app的日志内容, 如配置了重试则为最后一次重试的尾部日志内容.', 'description' => '日志内容。', 'type' => 'string', 'example' => '22/04/22 15:30:49 INFO Utils: Start the dump task because s202206061441hz22a35ab000****-0001 app end, the interval is 238141ms;22/04/22 15:30:49 INFO AbstractConnector: Stopped Spark@5e774d9d{HTTP/1.1, (http/1.1)}{0.0.0.0:4040}'], + 'Message' => ['title' => '额外备注信息', 'description' => '返回告警信息，如任务执行失败或资源不足等，无告警时则返回为空。', 'type' => 'string', 'example' => 'WARNING: log file maybe deleted, please check oss path: oss://TestBucketName/applog/'], + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-clusterxxx'], + 'LogSize' => ['description' => '日志的行数，0代表没有有效日志。', 'type' => 'integer', 'format' => 'int32', 'example' => '3517972480'], + ], + ], + ], + 'description' => '', ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.RoleArn.Invalid', 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', 'description' => 'RoleArn不存在或子账号未授权。'], + ['errorCode' => 'Spark.Oss.InternalError', 'errorMessage' => 'An OSS internal error occurred: %s', 'description' => 'OSS内部错误，请求失败。'], + ['errorCode' => 'Spark.Log.IllegalPath', 'errorMessage' => 'Invalid job log URI: %s.', 'description' => '配置的Spark日志路径不合法：%s。'], + ['errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '只允许分析处于终止状态的 Spark app。指定 app 不满足条件。'], + ['errorCode' => 'Spark.AnalyzeTask.FailedToKill', 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', 'description' => '杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。'], + ['errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Log.InvalidState', 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'description' => '无法获取指定Spark作业的日志。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', 'description' => 'Spark作业信息中的SQL无法解析。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'am-bp1565u55p32****', - ], + ['errorCode' => 'Spark.Log.PodLogNotFound', 'errorMessage' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', 'description' => '无法通过podName找到对应pod的日志 [%s]。'], + ['errorCode' => 'Spark.AnalyzeTask.NotFound', 'errorMessage' => 'The requested analysis task %s is not found.', 'description' => '请求查看的日志分析任务 %s 不存在。'], + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], + ['errorCode' => 'Spark.TemplateFile.TemplateNotFound', 'errorMessage' => 'The template %s is not found.', 'description' => '模板文件未找到。'], ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], + ], + 'title' => '查询Spark应用日志', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2024-01-18T12:41:47.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-11-24T09:19:26.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-06-28T01:10:36.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkAppLog'], + ], + ], + 'ramActions' => [ [ - 'name' => 'FilterTblType', - 'in' => 'query', - 'schema' => [ - 'description' => '表类型。'."\n" - .'取值：'."\n" - ."\n" - .'-DIMENSION_TABLE'."\n" - ."\n" - .'-FACT_TABLE'."\n" - ."\n" - .'-EXTERNAL_TABLE'."\n" - ."\n" - .'默认值：空', - 'type' => 'string', - 'required' => false, - 'example' => 'FACT_TABLE', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkAppLog', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C3A9594F-1D40-4472-A96C-8FB8AA20D38C\\",\\n \\"Data\\": {\\n \\"LogContent\\": \\"22/04/22 15:30:49 INFO Utils: Start the dump task because s202206061441hz22a35ab000****-0001 app end, the interval is 238141ms;22/04/22 15:30:49 INFO AbstractConnector: Stopped Spark@5e774d9d{HTTP/1.1, (http/1.1)}{0.0.0.0:4040}\\",\\n \\"Message\\": \\"WARNING: log file maybe deleted, please check oss path: oss://TestBucketName/applog/\\",\\n \\"DBClusterId\\": \\"amv-clusterxxx\\",\\n \\"LogSize\\": 3517972480\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkAppLogResponse>\\n <RequestId>C3A9594F-1D40-4472-A96C-8FB8AA20D38C</RequestId>\\n <Data>\\n <LogContent>22/04/22 15:30:49 INFO Utils: Start the dump task because s202206061441hz22a35ab000****-0001 app end, the interval is 238141ms;22/04/22 15:30:49 INFO AbstractConnector: Stopped Spark@5e774d9d{HTTP/1.1, (http/1.1)}{0.0.0.0:4040}</LogContent>\\n <Message>WARNING: log file maybe deleted, please check oss path: oss://TestBucketName/applog/</Message>\\n </Data>\\n</GetSparkAppLogResponse>","errorExample":""}]', + ], + 'GetSparkAppMetrics' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'FilterOwner', - 'in' => 'query', - 'schema' => [ - 'description' => '所有者。', - 'type' => 'string', - 'required' => false, - 'example' => 'admin', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'abilityTreeCode' => '169120', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], + ], + 'parameters' => [ [ - 'name' => 'FilterDescription', - 'in' => 'query', - 'schema' => [ - 'description' => '描述。', - 'type' => 'string', - 'required' => false, - 'example' => 'description', - ], + 'name' => 'AppId', + 'in' => 'formData', + 'schema' => ['title' => 'spark app的id', 'description' => '应用ID。', 'type' => 'string', 'required' => true, 'example' => 's202204221525hzca7d8140000003', 'maxLength' => 64], ], [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~612397~~)接口查询目标地域中所有集群的集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-bp1ggnu61d77****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结果。', + 'description' => '结构体', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '863D51B7-5321-41D8-A0B6-A088B0******', - ], - 'PageNumber' => [ - 'description' => '页码，取值为正整数。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], 'Data' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ - 'PageNumber' => [ - 'description' => '页码，取值为正整数。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'TableSummaryModels' => [ - 'description' => '结果数组。', - 'type' => 'array', - 'items' => [ - 'description' => '表概要信息。', - '$ref' => '#/components/schemas/TableSummaryModel', + 'AppId' => ['description' => '应用ID。', 'type' => 'string', 'example' => 's202302051515shfa865f8000****'], + 'AttemptId' => ['description' => 'Spark应用的重试ID。', 'type' => 'string', 'example' => 's202301061000hz57d797b0000201-****'], + 'Finished' => ['description' => '解析是否结束：'."\n" + .'- **true**：已结束。'."\n" + .'- **false**：未结束。', 'type' => 'boolean', 'example' => 'True'], + 'EventLogPath' => ['description' => 'Event日志路径。', 'type' => 'string', 'example' => 'oss://path/to/eventLog'], + 'ScanMetrics' => [ + 'description' => '指标数据。', + 'type' => 'object', + 'properties' => [ + 'OutputRowsCount' => ['description' => '扫描行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'], + 'TotalReadFileSizeInByte' => ['description' => '扫描字节大小。', 'type' => 'integer', 'format' => 'int64', 'example' => '10000'], ], ], ], @@ -29791,62 +21151,95 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '只允许分析处于终止状态的 Spark app。指定 app 不满足条件。'], + ['errorCode' => 'Spark.AnalyzeTask.FailedToKill', 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', 'description' => '杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。'], + ['errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.KillOperationFailed', 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', 'description' => '杀死 Spark 应用失败，请稍后重试。'], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.CancelNotebookStatementFailed', 'errorMessage' => 'Failed to cancel the execution of notebook statements.', 'description' => ''], + ['errorCode' => 'Spark.CloseNotebookKernelFailed', 'errorMessage' => 'Failed to disable the notebook kernel.', 'description' => ''], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.ExecuteNotebookStatementFailed', 'errorMessage' => 'Failed to execute notebook statements.', 'description' => ''], + ['errorCode' => 'Spark.GetNotebookKernelFailed', 'errorMessage' => 'Failed to start the notebook kernel. Try again later.', 'description' => ''], + ['errorCode' => 'Spark.GetNotebookKernelStateFailed', 'errorMessage' => 'Failed to obtain the status of the notebook kernel.', 'description' => 'Notebook Kernel 状态查询失败'], + ['errorCode' => 'Spark.GetNotebookStatementLogFailed', 'errorMessage' => 'Failed to obtain notebook statement logs.', 'description' => ''], + ['errorCode' => 'Spark.GetNotebookStatementResultFailed', 'errorMessage' => 'Failed to obtain notebook statement execution results.', 'description' => ''], + ['errorCode' => 'Spark.GetNotebookStatementUiFailed', 'errorMessage' => 'Failed to obtain notebook statement UI.', 'description' => ''], + ['errorCode' => 'Spark.Log.IllegalPath', 'errorMessage' => 'Invalid job log URI: %s.', 'description' => '配置的Spark日志路径不合法：%s。'], + ['errorCode' => 'Spark.Log.InvalidState', 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'description' => '无法获取指定Spark作业的日志。'], + ['errorCode' => 'Spark.NotebookKernelBusy', 'errorMessage' => 'Too many jobs in the notebook kernel. Try again later.', 'description' => ''], + ['errorCode' => 'Spark.NotebookKernelExpired', 'errorMessage' => 'The notebook kernel has expired. Restart the kernel.', 'description' => ''], + ['errorCode' => 'Spark.NotebookKernelInvalidStatus', 'errorMessage' => 'The status of the notebook kernel is invalid.', 'description' => ''], + ['errorCode' => 'Spark.NotebookKernelNotStartup', 'errorMessage' => 'The notebook kernel has not been started', 'description' => ''], + ['errorCode' => 'Spark.NotebookKernelStarting', 'errorMessage' => 'The notebook kernel is starting. Try again later.', 'description' => ''], + ['errorCode' => 'Spark.NotebookNamingDuplicate', 'errorMessage' => 'The name of the notebook is duplicated, please change the name', 'description' => 'Notebook命名重复，请重新命名。'], + ['errorCode' => 'Spark.NotebookNotFound', 'errorMessage' => 'The notebook is not found', 'description' => 'Notebook不存在，请联系管理员'], + ['errorCode' => 'Spark.NotebookParagraphMissingProgramCode', 'errorMessage' => 'The notebook paragraph program code is missing', 'description' => 'Notebook段落缺少执行代码'], + ['errorCode' => 'Spark.NotebookParagraphNotFound', 'errorMessage' => 'The notebook paragraph is not found', 'description' => 'Notebook段落不存在，请联系管理员'], + ['errorCode' => 'Spark.NotebookParagraphNotRunning', 'errorMessage' => 'The notebook paragraph has not been running', 'description' => 'Notebook段落未运行，请先执行语句'], + ['errorCode' => 'Spark.Oss.InternalError', 'errorMessage' => 'An OSS internal error occurred: %s', 'description' => 'OSS内部错误，请求失败。'], + ['errorCode' => 'Spark.RoleArn.Invalid', 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', 'description' => 'RoleArn不存在或子账号未授权。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', 'description' => 'Spark作业信息中的SQL无法解析。'], + ['errorCode' => 'Spark.TemplateFile.BadFileType', 'errorMessage' => 'The requested template %s is not a file.', 'description' => '请求的模板文件ID不是文件类型的。'], ], 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.AnalyzeTask.NotFound', 'errorMessage' => 'The requested analysis task %s is not found.', 'description' => '请求查看的日志分析任务 %s 不存在。'], + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.Log.PodLogNotFound', 'errorMessage' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', 'description' => '无法通过podName找到对应pod的日志 [%s]。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], + ['errorCode' => 'Spark.TemplateFile.TemplateNotFound', 'errorMessage' => 'The template %s is not found.', 'description' => '模板文件未找到。'], + ], + 406 => [ + ['errorCode' => 'Spark.App.KillNotAcceptable', 'errorMessage' => 'Can\'t kill the application %s in %s state.', 'description' => '不能删除处于不可删除状态下的 Spark 应用。'], ], 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', - ], + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ['errorCode' => 'Spark.Resources.LoadFileFromClasspathFailed', 'errorMessage' => 'Can\'t load the content from file: %s', 'description' => '加载资源文件失败。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"863D51B7-5321-41D8-A0B6-A088B0******\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"TableSummaryModels\\": [\\n {\\n \\"SchemaName\\": \\"\\",\\n \\"TableName\\": \\"\\",\\n \\"TableType\\": \\"\\",\\n \\"TableSize\\": 0,\\n \\"CreateTime\\": \\"\\",\\n \\"UpdateTime\\": \\"\\",\\n \\"SQL\\": \\"\\",\\n \\"Description\\": \\"\\",\\n \\"Owner\\": \\"\\",\\n \\"MvDetailModel\\": {\\n \\"FirstRefreshTime\\": \\"\\",\\n \\"QueryRewriteEnabled\\": true,\\n \\"ExplicitHit\\": 0,\\n \\"IsInactive\\": true,\\n \\"RemoteSize\\": 0,\\n \\"LocalSize\\": 0,\\n \\"RefreshState\\": \\"\\",\\n \\"RefreshInterval\\": \\"\\",\\n \\"ImplicitHit\\": 0,\\n \\"UpdatedAt\\": \\"\\",\\n \\"ResourceGroup\\": \\"\\",\\n \\"BaseTableInfos\\": [\\n {\\n \\"SchemaName\\": \\"\\",\\n \\"TableName\\": \\"\\",\\n \\"BaseTableIsMv\\": true,\\n \\"TableEngine\\": \\"\\"\\n }\\n ],\\n \\"TableEngine\\": \\"\\",\\n \\"BaseTableNames\\": [\\n [\\n \\"\\"\\n ]\\n ],\\n \\"EnableDelayAlert\\": 0,\\n \\"EnableFailureAlert\\": 0,\\n \\"LatencyTolerance\\": 0\\n },\\n \\"CreatedBySource\\": \\"\\",\\n \\"CreatedByUser\\": \\"\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetTableObjectsResponse>\\n <RequestId>863D51B7-5321-41D8-A0B6-A088B0******</RequestId>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n <Data>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n <TableSummaryModels/>\\n </Data>\\n</GetTableObjectsResponse>","errorExample":""}]', - 'title' => '查询表信息', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'CheckSampleDataSet' => [ - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询Spark App指标数据', + 'summary' => '获取Spark App指标数据。', + 'description' => '- 在调用该接口前，必须先调用[PreloadSparkAppMetrics](~~612447~~)接口预加载Spark任务的指标数据，否则会调用失败。'."\n" + .'- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-11-24T09:19:25.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-06-28T01:10:36.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkAppMetrics'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkAppMetrics', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'SparkApplication', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202302051515shfa865f8000****\\",\\n \\"AttemptId\\": \\"s202301061000hz57d797b0000201-****\\",\\n \\"Finished\\": true,\\n \\"EventLogPath\\": \\"oss://path/to/eventLog\\",\\n \\"ScanMetrics\\": {\\n \\"OutputRowsCount\\": 1000,\\n \\"TotalReadFileSizeInByte\\": 10000\\n }\\n }\\n}","type":"json"}]', + ], + 'GetSparkAppState' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -29854,22 +21247,21 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ + 'name' => 'AppId', + 'in' => 'formData', + 'schema' => ['title' => 'spark app的id', 'description' => '应用ID。'."\n" + .'> 可调用[ListSparkApps](~~455888~~)接口查询Spark应用ID。', 'type' => 'string', 'required' => true, 'example' => 's202204191546hzpread6a896000****', 'maxLength' => 64], + ], + [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-wz9r8f67h4cqz41u', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~612397~~)接口查询目标地域中所有集群的集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-bp1h405854m****'], ], ], 'responses' => [ @@ -29877,49 +21269,91 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'Status' => [ - 'description' => '内置数据集状态，取值说明：'."\n" - .'- **SUCCEED**：加载成功。'."\n" - ."\n" - .'- **INIT**：加载中。'."\n" - ."\n" - .'- **FAILED**：加载失败。'."\n" - ."\n" - .'- **UNINITIALIZED**：未加载。', - 'type' => 'string', - 'example' => 'UNINITIALIZED', - ], - 'RequestId' => [ - 'description' => '请求id。', - 'type' => 'string', - 'example' => '0CE655C3-C211-513D-A42F-D4AE2D1A867C', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380'], + 'Data' => [ + 'description' => '返回数据。', + 'type' => 'object', + 'properties' => [ + 'AppId' => ['description' => '应用ID。', 'type' => 'string', 'example' => 's202204191546hzpread6a896000****'], + 'AppName' => ['description' => '应用名称。', 'type' => 'string', 'example' => 'test'], + 'Message' => ['description' => '返回告警信息，如任务执行失败或资源不足等，无告警时则返回为空。', 'type' => 'string', 'example' => 'Insufficient resources.'], + 'State' => ['title' => 'spark app的状态', 'description' => '应用执行状态，取值说明：'."\n" + .'- **SUBMITTED**：已提交。'."\n" + .'- **STARTING**：开始启动。'."\n" + .'- **RUNNING**：执行中。'."\n" + .'- **FAILING**：任务失败，清理环境中。'."\n" + .'- **FAILED**：失败。'."\n" + .'- **KILLING**：中止任务，清理环境中。'."\n" + .'- **KILLED**：中止任务。'."\n" + .'- **SUCCEEDING**：任务执行结束，清理环境中。'."\n" + .'- **COMPLETED**：已完成。'."\n" + .'- **FATAL**：意外失败。'."\n" + .'- **UNKNOWN**：未知错误。', 'type' => 'string', 'example' => 'COMPLETED'], + 'DBClusterId' => ['title' => '数据库ID', 'description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp1h405854m****', 'default' => 'DB_CLUSTER_ID'], + ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '只允许分析处于终止状态的 Spark app。指定 app 不满足条件。'], + ['errorCode' => 'Spark.AnalyzeTask.FailedToKill', 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', 'description' => '杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。'], + ['errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Log.InvalidState', 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'description' => '无法获取指定Spark作业的日志。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', 'description' => 'Spark作业信息中的SQL无法解析。'], + ], 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + ['errorCode' => 'Spark.AnalyzeTask.NotFound', 'errorMessage' => 'The requested analysis task %s is not found.', 'description' => '请求查看的日志分析任务 %s 不存在。'], + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], + ['errorCode' => 'Spark.TemplateFile.TemplateNotFound', 'errorMessage' => 'The template %s is not found.', 'description' => '模板文件未找到。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Status\\": \\"UNINITIALIZED\\",\\n \\"RequestId\\": \\"0CE655C3-C211-513D-A42F-D4AE2D1A867C\\"\\n}","type":"json"}]', - 'title' => '检查内置数据集状态', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeSchemas' => [ - 'summary' => '查询指定实例的数据库列表信息。', - 'methods' => [ - 'post', - 'get', + 'title' => '查询Spark应用的状态', + 'summary' => '查询Spark应用的状态。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。、'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-11-24T09:19:26.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-06-28T01:10:35.000Z', 'description' => '错误码发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkAppState'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkAppState', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202204191546hzpread6a896000****\\",\\n \\"AppName\\": \\"test\\",\\n \\"Message\\": \\"Insufficient resources.\\",\\n \\"State\\": \\"COMPLETED\\",\\n \\"DBClusterId\\": \\"amv-bp1h405854m****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkAppStateResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <AppId>s202204191546hzpread6a896000****</AppId>\\n <AppName>test</AppName>\\n <Message>Insufficient resources.</Message>\\n <State>COMPLETED</State>\\n </Data>\\n</GetSparkAppStateResponse>","errorExample":""}]', + ], + 'GetSparkAppWebUiAddress' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -29929,140 +21363,103 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '190445', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], + 'abilityTreeCode' => '119937', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'name' => 'AppId', + 'in' => 'formData', + 'schema' => ['title' => 'spark app的id', 'description' => '应用ID。'."\n" + .'> 您可以调用[ListSparkApps](~~455888~~)接口查询Spark的应用ID。', 'type' => 'string', 'required' => true, 'example' => 's202205201533hz1209892000****', 'maxLength' => 64], ], [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1xxxxxxxx47', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有湖仓版集群的详情，包括集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-uf6g8w25jacm7****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '25B56BC7-4978-40B3-9E48-4B7067******', - ], - 'Items' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380'], + 'Data' => [ + 'title' => '', + 'description' => '返回数据。', 'type' => 'object', - 'itemNode' => true, 'properties' => [ - 'Schema' => [ - 'description' => '数据库列表。', - 'type' => 'array', - 'items' => [ - 'description' => '数据库信息。', - 'type' => 'object', - 'properties' => [ - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-bp11q28kvl688****', - ], - 'SchemaName' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - ], - ], - ], + 'AppId' => ['title' => 'spark app的id', 'description' => '应用ID。', 'type' => 'string', 'example' => 's202205201533hz1209892000****'], + 'ExpirationTimeInMillis' => ['title' => 'spark app的WEB UI的可访问截止时间, 毫秒级时间戳.', 'description' => '到期时间，Unix时间戳，单位：毫秒（ms）。', 'type' => 'integer', 'format' => 'int64', 'example' => '1655801973000'], + 'WebUiAddress' => ['title' => 'Spark App的WEB UI的临时访问地址, 有过期时间, 过期后需要再次生成.', 'description' => 'Spark应用的Web UI地址。', 'type' => 'string', 'example' => 'https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****'], + 'DBClusterId' => ['title' => '数据库ID'."\n", 'description' => '数据库ID'."\n", 'type' => 'string', 'example' => 'amv-clusterxxx', 'default' => 'DB_CLUSTER_ID'], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '只允许分析处于终止状态的 Spark app。指定 app 不满足条件。'], + ['errorCode' => 'Spark.AnalyzeTask.FailedToKill', 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', 'description' => '杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。'], + ['errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Log.InvalidState', 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'description' => '无法获取指定Spark作业的日志。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', 'description' => 'Spark作业信息中的SQL无法解析。'], ], - 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + 404 => [ + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.AnalyzeTask.NotFound', 'errorMessage' => 'The requested analysis task %s is not found.', 'description' => '请求查看的日志分析任务 %s 不存在。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], + ['errorCode' => 'Spark.TemplateFile.TemplateNotFound', 'errorMessage' => 'The template %s is not found.', 'description' => '模板文件未找到。'], ], 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', - ], + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"25B56BC7-4978-40B3-9E48-4B7067******\\",\\n \\"Items\\": {\\n \\"Schema\\": [\\n {\\n \\"DBClusterId\\": \\"amv-bp11q28kvl688****\\",\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '枚举实例的库列表', + 'title' => '查询Spark Web UI地址', + 'summary' => '查询Spark应用的Web UI地址。', 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'DescribeAllDataSource' => [ - 'summary' => '枚举实例下所有数据库列表、表列表和列列表。', - 'methods' => [ - 'post', - 'get', + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-11-24T09:19:25.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-06-28T01:10:34.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkAppWebUiAddress'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkAppWebUiAddress', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202205201533hz1209892000****\\",\\n \\"ExpirationTimeInMillis\\": 1655801973000,\\n \\"WebUiAddress\\": \\"https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****\\",\\n \\"DBClusterId\\": \\"amv-clusterxxx\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkAppWebUiAddressResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <AppId>s202205201533hz1209892000****</AppId>\\n <ExpirationTimeInMillis>1655801973000</ExpirationTimeInMillis>\\n <WebUiAddress>https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****</WebUiAddress>\\n </Data>\\n</GetSparkAppWebUiAddressResponse>","errorExample":""}]', + ], + 'GetSparkConfigLogPath' => [ + 'summary' => '查询AnalyticDB MySQL Spark中的日志配置结果，包括默认的Spark日志写入地址。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -30074,250 +21471,94 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '190495', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], + 'abilityTreeCode' => '156541', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1pke2pcfavw****', - ], - ], - [ - 'name' => 'SchemaName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库名称。'."\n" - .' '."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], - ], - [ - 'name' => 'TableName', - 'in' => 'query', - 'schema' => [ - 'description' => '表名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'in' => 'formData', + 'schema' => ['title' => '数据库的id', 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp19lm077co*****', 'maxLength' => 64], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'C7EDB8E4-9769-4233-88C7-DCA4C9******', - ], - 'Tables' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Table' => [ - 'description' => '表列表。', - 'type' => 'array', - 'items' => [ - 'description' => '表信息。', - 'type' => 'object', - 'properties' => [ - 'TableName' => [ - 'description' => '逻辑表名。', - 'type' => 'string', - 'example' => 'test', - ], - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-bp1pke2pcfavw****', - ], - 'SchemaName' => [ - 'description' => '数据库名称。'."\n" - .' '."\n", - 'type' => 'string', - 'example' => 'adb_demo', - ], - ], - ], - ], - ], - ], - 'Columns' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'Column' => [ - 'description' => '列列表。', - 'type' => 'array', - 'items' => [ - 'description' => '列信息。', - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => '列的数据类型。', - 'type' => 'string', - 'example' => 'bigint', - ], - 'ColumnName' => [ - 'description' => '列名。', - 'type' => 'string', - 'example' => 'id', - ], - 'TableName' => [ - 'description' => '逻辑表名。', - 'type' => 'string', - 'example' => 'test', - ], - 'AutoIncrementColumn' => [ - 'description' => '列是否自增，取值说明：'."\n" - .'- **true**：自增。'."\n" - .'- **false**：不自增。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-bp1pke2pcfavw****', - ], - 'PrimaryKey' => [ - 'description' => '列是否为主键，取值说明：'."\n" - .'- **true**：主键。'."\n" - .'- **false**：非主键。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'SchemaName' => [ - 'description' => '逻辑库名。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - ], - ], - ], - ], - ], - 'Schemas' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1919-xxx-ssdfsdff'], + 'Data' => [ + 'description' => '返回内容。', 'type' => 'object', - 'itemNode' => true, 'properties' => [ - 'Schema' => [ - 'description' => '数据库列表。', - 'type' => 'array', - 'items' => [ - 'description' => '数据库信息。', - 'type' => 'object', - 'properties' => [ - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-bp1pke2pcfavw****', - ], - 'SchemaName' => [ - 'description' => '逻辑库名。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - ], - ], - ], + 'IsLogPathExists' => ['title' => '是否存在日志地址', 'description' => '是否存在日志地址。', 'type' => 'boolean', 'example' => 'true'], + 'RecordedLogPath' => ['title' => '记录的地址名称', 'description' => '记录的地址名称。', 'type' => 'string', 'example' => 'oss://test/spark-logs/'], + 'ModifiedUid' => ['title' => '修改者ID', 'description' => '修改人的账号ID。', 'type' => 'string', 'example' => '10130223128xxx'], + 'ModifiedTimestamp' => ['title' => '上一次修改时间', 'description' => '上一次修改时间。', 'type' => 'string', 'example' => '1675654361000'], + 'DefaultLogPath' => ['title' => '推荐的默认地址', 'description' => '推荐的默认地址。', 'type' => 'string', 'example' => 'oss://aliyun-oa-adb-spark-****-oss-cn-hanghzou/spark-logs'], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.Config.InvalidAppFilePath', 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', 'description' => '主驱动文件地址必须是合法的OSS地址，当前的地址是 %s。'], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.InvalidDiskConfig', 'errorMessage' => 'The requested disk mount parameter is invalid: %s', 'description' => '磁盘挂载配置错误。'], + ['errorCode' => 'Spark.Config.InvalidHostAliasConfig', 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', 'description' => '域名映射配置错误。'], + ['errorCode' => 'Spark.Config.InvalidLogOssPath', 'errorMessage' => 'The OSS address for log storage is illegal: %s', 'description' => '存储日志的OSS地址非法。'], + ['errorCode' => 'Spark.Config.InvalidRoleArnFormat', 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', 'description' => '配置的RoleARN格式错误。'], + ['errorCode' => 'Spark.Config.InvalidTimeZone', 'errorMessage' => 'Unable to parse time zone configuration %s : %s', 'description' => '时区配置错误。'], + ['errorCode' => 'Spark.Config.MainAppFileNotExists', 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', 'description' => '主驱动文件缺失，必须保证file或者sqls配置不为空。'], + ['errorCode' => 'Spark.Config.OSSPathAccessError', 'errorMessage' => 'The configured OSS address %s cannot be accessed.', 'description' => '配置的OSS路径无法访问。'], + ['errorCode' => 'Spark.Config.OSSPathNotExists', 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', 'description' => 'OSS路径不存在或当前用户无权限访问。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Config.SecurityGroupNotFound', 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', 'description' => '配置的资源组不存在或者因权限不足无法访问。%s。'], + ['errorCode' => 'Spark.Config.VswitchNotFound', 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', 'description' => '无法找到配置虚拟机交换机，或当前账号权限不足。%s。'], ], 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], ], 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', - ], + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C7EDB8E4-9769-4233-88C7-DCA4C9******\\",\\n \\"Tables\\": {\\n \\"Table\\": [\\n {\\n \\"TableName\\": \\"test\\",\\n \\"DBClusterId\\": \\"amv-bp1pke2pcfavw****\\",\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ]\\n },\\n \\"Columns\\": {\\n \\"Column\\": [\\n {\\n \\"Type\\": \\"bigint\\",\\n \\"ColumnName\\": \\"id\\",\\n \\"TableName\\": \\"test\\",\\n \\"AutoIncrementColumn\\": true,\\n \\"DBClusterId\\": \\"amv-bp1pke2pcfavw****\\",\\n \\"PrimaryKey\\": false,\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ]\\n },\\n \\"Schemas\\": {\\n \\"Schema\\": [\\n {\\n \\"DBClusterId\\": \\"amv-bp1pke2pcfavw****\\",\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '枚举数据库列表', + 'title' => '获取Spark日志配置路径', 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'DescribeTables' => [ - 'summary' => '查询指定数据库的表列表信息。', - 'methods' => [ - 'post', - 'get', + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-07-27T06:45:58.000Z', 'description' => '错误码发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkConfigLogPath'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkConfigLogPath', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1919-xxx-ssdfsdff\\",\\n \\"Data\\": {\\n \\"IsLogPathExists\\": true,\\n \\"RecordedLogPath\\": \\"oss://test/spark-logs/\\",\\n \\"ModifiedUid\\": \\"10130223128xxx\\",\\n \\"ModifiedTimestamp\\": \\"1675654361000\\",\\n \\"DefaultLogPath\\": \\"oss://aliyun-oa-adb-spark-****-oss-cn-hanghzou/spark-logs\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkConfigLogPathResponse>\\n <RequestId>1919-xxx-ssdfsdff</RequestId>\\n <Data>\\n <IsLogPathExists>true</IsLogPathExists>\\n <RecordedLogPath>oss://test/spark-logs/</RecordedLogPath>\\n <ModifiedUid>10130223128xxx</ModifiedUid>\\n <ModifiedTimestamp>1675654361000</ModifiedTimestamp>\\n <DefaultLogPath>oss://aliyun-oa-adb-spark-1111-oss-cn-hanghzou/spark-logs</DefaultLogPath>\\n </Data>\\n</GetSparkConfigLogPathResponse>","errorExample":""}]', + ], + 'GetSparkLogAnalyzeTask' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -30325,158 +21566,198 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], - ], + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', + 'name' => 'TaskId', + 'in' => 'formData', + 'schema' => ['title' => 'Spark日志分析任务ID'."\n", 'description' => 'Spark日志分析任务ID。调用接口ListSparkLogAnalyzeTasks可以查询当前ADB集群中提交的所有Spark日志分析任务ID。'."\n", 'type' => 'integer', 'format' => 'int64', 'required' => true, 'minimum' => '0', 'example' => '12'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1DF5AF5B-C803-1861-A0FF-63666A557709'], + 'Data' => ['description' => 'Spark日志分析任务详情。', '$ref' => '#/components/schemas/SparkAnalyzeLogTask'], + ], ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询Spark日志分析任务结果', + 'summary' => '获取Spark日志分析任务结果。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-07-27T06:45:57.000Z', 'description' => '错误码发生变更、响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkLogAnalyzeTask'], + ], + ], + 'ramActions' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1xxxxxxxx47', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkLogAnalyzeTask', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/task/{#SparkTaskId}'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1DF5AF5B-C803-1861-A0FF-63666A557709\\",\\n \\"Data\\": {\\n \\"TaskId\\": 10,\\n \\"UserId\\": 0,\\n \\"SubmittedTimeInMillis\\": 1672123543000,\\n \\"TerminatedTimeInMillis\\": 1672123543000,\\n \\"TaskState\\": \\"WAITING\\",\\n \\"Result\\": {\\n \\"AppErrorCode\\": \\"EXCEEDED_QUOTA\\",\\n \\"AppErrorLog\\": \\"exception: cpu is exceeded limits 12/10\\",\\n \\"AppErrorAdvice\\": \\"Please increase cpu quota for your resource group\\"\\n },\\n \\"StartedTimeInMillis\\": 1672123543000,\\n \\"RuleMatched\\": true,\\n \\"TaskErrMsg\\": \\"Driver log not found\\",\\n \\"DBClusterId\\": \\"amv-adbxxxxx\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkLogAnalyzeTaskResponse>\\n <RequestId>1DF5AF5B-C803-1861-A0FF-63666A557709</RequestId>\\n <Data>\\n <TaskId>10</TaskId>\\n <SubmittedTimeInMillis>1672123543000</SubmittedTimeInMillis>\\n <TerminatedTimeInMillis>1672123543000</TerminatedTimeInMillis>\\n <TaskState>WAITING</TaskState>\\n <Result>\\n <AppErrorCode>EXCEEDED_QUOTA</AppErrorCode>\\n <AppErrorLog>exception: xxxx</AppErrorLog>\\n </Result>\\n <StartedTimeInMillis>1672123543000</StartedTimeInMillis>\\n <RuleMatched>true</RuleMatched>\\n <TaskErrMsg>Driver log not found</TaskErrMsg>\\n <DBClusterId>amv-adbxxxxx</DBClusterId>\\n </Data>\\n</GetSparkLogAnalyzeTaskResponse>","errorExample":""}]', + ], + 'GetSparkReplSession' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'SchemaName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库名称。'."\n" - .' '."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ + [ + 'name' => 'AppId', + 'in' => 'formData', + 'schema' => ['title' => 'Spark App的名称', 'description' => '应用ID。'."\n" + .'> 您可以调用[ListSparkApps](~~455888~~)接口查询所有的应用ID。', 'type' => 'string', 'required' => false, 'example' => 's202411071444hzdvk486d9d200****', 'default' => 'ADB-Spark-Application'], + ], + [ + 'name' => 'SessionId', + 'in' => 'formData', + 'schema' => ['description' => '执行代码的会话ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Items' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '4CE6DF97-AEA4-484F-906F-C407EE3770EB'], + 'Data' => [ + 'description' => '返回数据。', 'type' => 'object', - 'itemNode' => true, 'properties' => [ - 'Table' => [ - 'description' => '表列表。', - 'type' => 'array', - 'items' => [ - 'description' => '表信息。', - 'type' => 'object', - 'properties' => [ - 'TableName' => [ - 'description' => '表名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-bp1xxxxxxxx47', - ], - 'SchemaName' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - ], - ], + 'SessionId' => ['description' => '执行代码的会话ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'State' => [ + 'description' => '当前会话状态，取值如下：'."\n" + .'- IDLE： 空闲'."\n" + .'- BUSY： 繁忙，执行任务中'."\n" + .'- DEAD： 会话关闭', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => 'IDEL', + ], + 'AttemptId' => ['description' => 'Spark应用的重试ID。', 'type' => 'string', 'example' => 's202301061000hz57d797b00002****'], + 'Error' => ['description' => '错误消息。', 'type' => 'string', 'example' => 'Session timed out'], + 'WebUiAddress' => ['description' => 'Spark应用的Web UI地址。', 'type' => 'string', 'example' => 'https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****'], + 'AliyunUid' => ['description' => '实例所属的阿里云账户ID。', 'type' => 'string', 'example' => '178157466101****'], + 'Active' => [ + 'description' => '是否处于活跃状态，取值如下：'."\n" + .'- true： 活跃'."\n" + .'- false：不活跃', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => 'true', ], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + ['errorCode' => 'Spark.App.ExceedQuotaLimitation', 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', 'description' => ''], + ['errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', 'description' => 'AppType类型不合法，请参考使用文档指定适合业务的AppType，请关注配置类型：%s。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ResourceNegativeError', 'errorMessage' => 'The requested resource MUST be positive: %s', 'description' => ''], + ['errorCode' => 'Spark.Config.InvalidAppFilePath', 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', 'description' => '主驱动文件地址必须是合法的OSS地址，当前的地址是 %s。'], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.InvalidDiskConfig', 'errorMessage' => 'The requested disk mount parameter is invalid: %s', 'description' => '磁盘挂载配置错误。'], + ['errorCode' => 'Spark.Config.InvalidHostAliasConfig', 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', 'description' => '域名映射配置错误。'], + ['errorCode' => 'Spark.Config.InvalidLogOssPath', 'errorMessage' => 'The OSS address for log storage is illegal: %s', 'description' => '存储日志的OSS地址非法。'], + ['errorCode' => 'Spark.Config.InvalidRoleArnFormat', 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', 'description' => '配置的RoleARN格式错误。'], + ['errorCode' => 'Spark.Config.InvalidTimeZone', 'errorMessage' => 'Unable to parse time zone configuration %s : %s', 'description' => '时区配置错误。'], + ['errorCode' => 'Spark.Config.MainAppFileNotExists', 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', 'description' => '主驱动文件缺失，必须保证file或者sqls配置不为空。'], + ['errorCode' => 'Spark.Config.OSSPathAccessError', 'errorMessage' => 'The configured OSS address %s cannot be accessed.', 'description' => '配置的OSS路径无法访问。'], + ['errorCode' => 'Spark.Config.OSSPathNotExists', 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', 'description' => 'OSS路径不存在或当前用户无权限访问。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Config.SecurityGroupNotFound', 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', 'description' => '配置的资源组不存在或者因权限不足无法访问。%s。'], + ['errorCode' => 'Spark.Config.VswitchNotFound', 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', 'description' => '无法找到配置虚拟机交换机，或当前账号权限不足。%s。'], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.RoleArn.Invalid', 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', 'description' => 'RoleArn不存在或子账号未授权。'], + ['errorCode' => 'Spark.SQL.BlankError', 'errorMessage' => 'Input sql can not be blank string.', 'description' => '提交SQL不能为空。'], + ['errorCode' => 'Spark.SQL.MultipleSQLError', 'errorMessage' => 'Element in field [sqls] can not contain more than one sql statement: %s.', 'description' => '提交的Spark SQL包含了多条可执行SQL。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Submit spark app failed when parser SQL %s. Error message: %s.', 'description' => '解析提交的Spark SQL失败。'], ], 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.App.NotFound', 'errorMessage' => 'The Spark application %s is not found.', 'description' => '未能找到输入的 Spark App。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], ], 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', - ], + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Items\\": {\\n \\"Table\\": [\\n {\\n \\"TableName\\": \\"test\\",\\n \\"DBClusterId\\": \\"amv-bp1xxxxxxxx47\\",\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '枚举数据库的表列表', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'DescribeColumns' => [ - 'summary' => '查询指定表的列列表信息。', - 'methods' => [ - 'post', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取会话状态', + 'summary' => '获取会话状态。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkReplSession'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:GetSparkReplSession', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbClusterId}/resourcegroup/{#resourceGroupName}/sparkapp/{#sparkAppId}/{#sessionid}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"4CE6DF97-AEA4-484F-906F-C407EE3770EB\\",\\n \\"Data\\": {\\n \\"SessionId\\": 1,\\n \\"State\\": \\"IDEL\\",\\n \\"AttemptId\\": \\"s202301061000hz57d797b00002****\\",\\n \\"Error\\": \\"Session timed out\\",\\n \\"WebUiAddress\\": \\"https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****\\",\\n \\"AliyunUid\\": \\"178157466101****\\",\\n \\"Active\\": \\"true\\"\\n }\\n}","type":"json"}]', + ], + 'GetSparkReplStatement' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -30484,262 +21765,267 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', - ], - ], + 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1xxxxxxxx47', - ], + 'name' => 'AppId', + 'in' => 'formData', + 'schema' => ['title' => 'Spark App的名称', 'description' => '应用ID。'."\n" + .'> 可调用[ListSparkApps](~~455888~~)接口查询Spark应用ID。', 'type' => 'string', 'required' => false, 'example' => 's202411071444hzdvk486d9d200****', 'default' => 'ADB-Spark-Application'], ], [ - 'name' => 'SchemaName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库名称。'."\n" - .' '."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], + 'name' => 'StatementId', + 'in' => 'formData', + 'schema' => ['description' => 'Spark作业中代码块的唯一ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '123'], ], [ - 'name' => 'TableName', - 'in' => 'query', - 'schema' => [ - 'description' => '查询表名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'name' => 'SessionId', + 'in' => 'formData', + 'schema' => ['description' => '执行代码的会话ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-XXX442913CEF', - ], - 'Items' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => [ + 'description' => '返回数据。', 'type' => 'object', - 'itemNode' => true, 'properties' => [ - 'Column' => [ - 'description' => '列列表。', + 'StatementId' => ['description' => '此Spark作业中代码块的唯一ID', 'type' => 'integer', 'format' => 'int64', 'example' => '123'], + 'Code' => ['description' => '执行的代码。', 'type' => 'string', 'example' => 'print(1+1)'], + 'CodeType' => [ + 'description' => '代码的类型，取值如下：'."\n" + .'- PYTHON'."\n" + .'- SCALA', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => 'PYTHON', + ], + 'CodeState' => [ + 'description' => '代码执行状态，取值如下：'."\n" + .'- CANCELLED: 取消执行'."\n" + .'- RUNNING: 执行中'."\n" + .'- SUCCEEDED: 执行完成'."\n" + .'- ERROR: 执行失败', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => 'RUNNING', + ], + 'AliyunUid' => ['description' => '实例所属的阿里云账户ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '144740799645****'], + 'OutputType' => [ + 'description' => '输出结果的类型。', + 'type' => 'string', + 'enumValueTitles' => ['TABLE' => '表。', 'TEXT' => '文本。'], + 'example' => 'TEXT', + ], + 'Output' => ['description' => '输出结果，一个JSON格式的STRING。', 'type' => 'string', 'example' => '{"text/plain": 2}'], + 'Columns' => [ + 'description' => '列名数组。', 'type' => 'array', - 'items' => [ - 'description' => '列信息。', - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => '列数据类型。', - 'type' => 'string', - 'example' => 'bigint', - ], - 'ColumnName' => [ - 'description' => '列名称。', - 'type' => 'string', - 'example' => 'id', - ], - 'TableName' => [ - 'description' => '表名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'AutoIncrementColumn' => [ - 'description' => '列是否自增，取值说明：'."\n" - .'- **true**：自增。'."\n" - .'- **false**：不自增。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-bp111m2cfrdl1****', - ], - 'PrimaryKey' => [ - 'description' => '列是否为主键，取值说明：'."\n" - .'- **true**：主键。'."\n" - .'- **false**：非主键。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'SchemaName' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - ], - ], + 'items' => ['description' => '列名。', 'type' => 'string', 'example' => 'col1'], ], + 'Error' => ['description' => '错误消息。', 'type' => 'string', 'example' => 'stackoverflow error'], + 'StartTime' => ['description' => '任务开始时间，Unix时间戳，单位毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1730968194000'], + 'EndTime' => ['description' => '任务结束时间，Unix时间戳，单位毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1730968194000'], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'MDS.IllegalArgument', - 'errorMessage' => 'Invalid argument.', - ], - [ - 'errorCode' => 'MDS.InvalidPrivilege', - 'errorMessage' => 'No permissions.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaAlreadyExist', - 'errorMessage' => 'The database already exists.', - ], - [ - 'errorCode' => 'MDS.MetaSchemaNotExist', - 'errorMessage' => 'The database does not exist.', - ], - [ - 'errorCode' => 'MDS.MetaTableAlreadyExist', - 'errorMessage' => 'The table already exists.', - ], - [ - 'errorCode' => 'MDS.MetaTableNotExist', - 'errorMessage' => 'The table is not found.', - ], + ['errorCode' => 'Spark.App.ExceedQuotaLimitation', 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', 'description' => ''], + ['errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', 'description' => 'AppType类型不合法，请参考使用文档指定适合业务的AppType，请关注配置类型：%s。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ResourceNegativeError', 'errorMessage' => 'The requested resource MUST be positive: %s', 'description' => ''], + ['errorCode' => 'Spark.Config.InvalidAppFilePath', 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', 'description' => '主驱动文件地址必须是合法的OSS地址，当前的地址是 %s。'], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.InvalidDiskConfig', 'errorMessage' => 'The requested disk mount parameter is invalid: %s', 'description' => '磁盘挂载配置错误。'], + ['errorCode' => 'Spark.Config.InvalidHostAliasConfig', 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', 'description' => '域名映射配置错误。'], + ['errorCode' => 'Spark.Config.InvalidLogOssPath', 'errorMessage' => 'The OSS address for log storage is illegal: %s', 'description' => '存储日志的OSS地址非法。'], + ['errorCode' => 'Spark.Config.InvalidRoleArnFormat', 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', 'description' => '配置的RoleARN格式错误。'], + ['errorCode' => 'Spark.Config.InvalidTimeZone', 'errorMessage' => 'Unable to parse time zone configuration %s : %s', 'description' => '时区配置错误。'], + ['errorCode' => 'Spark.Config.MainAppFileNotExists', 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', 'description' => '主驱动文件缺失，必须保证file或者sqls配置不为空。'], + ['errorCode' => 'Spark.Config.OSSPathAccessError', 'errorMessage' => 'The configured OSS address %s cannot be accessed.', 'description' => '配置的OSS路径无法访问。'], + ['errorCode' => 'Spark.Config.OSSPathNotExists', 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', 'description' => 'OSS路径不存在或当前用户无权限访问。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Config.SecurityGroupNotFound', 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', 'description' => '配置的资源组不存在或者因权限不足无法访问。%s。'], + ['errorCode' => 'Spark.Config.VswitchNotFound', 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', 'description' => '无法找到配置虚拟机交换机，或当前账号权限不足。%s。'], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.RoleArn.Invalid', 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', 'description' => 'RoleArn不存在或子账号未授权。'], + ['errorCode' => 'Spark.SQL.BlankError', 'errorMessage' => 'Input sql can not be blank string.', 'description' => '提交SQL不能为空。'], + ['errorCode' => 'Spark.SQL.MultipleSQLError', 'errorMessage' => 'Element in field [sqls] can not contain more than one sql statement: %s.', 'description' => '提交的Spark SQL包含了多条可执行SQL。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Submit spark app failed when parser SQL %s. Error message: %s.', 'description' => '解析提交的Spark SQL失败。'], ], 403 => [ - [ - 'errorCode' => 'MDS.RamAuthAccessDenied', - 'errorMessage' => 'ram auth access denied.', - ], + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.App.NotFound', 'errorMessage' => 'The Spark application %s is not found.', 'description' => '未能找到输入的 Spark App。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], ], 500 => [ - [ - 'errorCode' => 'MDS.InternalError', - 'errorMessage' => 'An internal MDS error occurred.', - ], - [ - 'errorCode' => 'MDS.MetaVisitError', - 'errorMessage' => 'Failed to access metadata.', - ], + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-XXX442913CEF\\",\\n \\"Items\\": {\\n \\"Column\\": [\\n {\\n \\"Type\\": \\"bigint\\",\\n \\"ColumnName\\": \\"id\\",\\n \\"TableName\\": \\"test\\",\\n \\"AutoIncrementColumn\\": true,\\n \\"DBClusterId\\": \\"amv-bp111m2cfrdl1****\\",\\n \\"PrimaryKey\\": false,\\n \\"SchemaName\\": \\"adb_demo\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '枚举表的列列表', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'LoadSampleDataSet' => [ - 'summary' => '调用LoadSampleDataSet接口加载内置数据集。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取一段代码的执行结果', + 'summary' => '获取一段代码的执行结果。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkReplStatement'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:GetSparkReplStatement', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbClusterId}/resourcegroup/{#resourceGroupName}/sparkapp/{#sparkAppId}/{#sparkStatmentId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"StatementId\\": 123,\\n \\"Code\\": \\"print(1+1)\\",\\n \\"CodeType\\": \\"PYTHON\\",\\n \\"CodeState\\": \\"RUNNING\\",\\n \\"AliyunUid\\": 0,\\n \\"OutputType\\": \\"TEXT\\",\\n \\"Output\\": \\"{\\\\\\"text/plain\\\\\\": 2}\\",\\n \\"Columns\\": [\\n \\"col1\\"\\n ],\\n \\"Error\\": \\"stackoverflow error\\",\\n \\"StartTime\\": 1730968194000,\\n \\"EndTime\\": 1730968194000\\n }\\n}","type":"json"}]', + ], + 'GetSparkSQLEngineState' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', - 'deprecated' => false, + 'operationType' => 'readAndWrite', + 'deprecated' => true, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', + 'abilityTreeCode' => '152586', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 调用[DescribeDBClusters](~~454250~~)接口查看集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-2ze0z517o1mg****', - ], + 'in' => 'formData', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], + ], + [ + 'name' => 'ResourceGroupName', + 'in' => 'formData', + 'schema' => ['description' => 'Job型资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'test_instance'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'FA31BE84-ABE8-554A-A769-5F860C34EE10', - ], - 'DBClusterId' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'example' => 'amv-2ze0z517o1mg****', + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'xxxx-xxx-xx'], + 'Data' => [ + 'description' => 'Spark SQL 引擎状态详情。', + 'type' => 'object', + 'properties' => [ + 'AppId' => ['description' => '应用ID。', 'type' => 'string', 'example' => 's202207151211hz0c****'], + 'MinExecutor' => ['description' => 'Spark Executor 最小启动量。', 'type' => 'string', 'example' => '1'], + 'MaxExecutor' => ['description' => 'Spark Executor 最大启动量。', 'type' => 'string', 'example' => '3'], + 'Jars' => ['description' => '第三方JAR包。', 'type' => 'string', 'example' => 'oss://test-bucket/test.jar'], + 'SlotNum' => ['description' => 'Spark 应用槽位值。', 'type' => 'string', 'example' => '2'], + 'Config' => ['description' => 'Spark 应用配置。', 'type' => 'string', 'example' => '{"key1": "value1", "key2": "value2"}'], + 'State' => ['description' => '应用执行状态，取值说明：'."\n" + .'* SUBMITTED：已提交。'."\n" + .'* STARTING：开始启动。'."\n" + .'* RUNNING：执行中。'."\n" + .'* FAILING：任务失败，清理环境中。'."\n" + .'* FAILED：失败。'."\n" + .'* KILLING：中止任务，清理环境中。'."\n" + .'* KILLED：中止任务。'."\n" + .'* SUCCEEDING：任务执行结束，清理环境中。'."\n" + .'* COMPLETED：已完成。'."\n" + .'* FATAL：意外失败。'."\n" + .'* UNKNOWN：未知错误。', 'type' => 'string', 'example' => 'COMPLETED'], + 'SubmittedTimeInMillis' => ['description' => 'Spark SQL 应用的提交时间，Unix时间戳，单位毫秒（ms）。', 'type' => 'string', 'example' => '1651213645000'], + ], ], ], ], ], ], 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '只允许分析处于终止状态的 Spark app。指定 app 不满足条件。'], + ['errorCode' => 'Spark.AnalyzeTask.FailedToKill', 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', 'description' => '杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。'], + ['errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Log.InvalidState', 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'description' => '无法获取指定Spark作业的日志。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', 'description' => 'Spark作业信息中的SQL无法解析。'], + ], 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.AnalyzeTask.NotFound', 'errorMessage' => 'The requested analysis task %s is not found.', 'description' => '请求查看的日志分析任务 %s 不存在。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], + ['errorCode' => 'Spark.TemplateFile.TemplateNotFound', 'errorMessage' => 'The template %s is not found.', 'description' => '模板文件未找到。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FA31BE84-ABE8-554A-A769-5F860C34EE10\\",\\n \\"DBClusterId\\": \\"amv-2ze0z517o1mg****\\"\\n}","type":"json"}]', - 'title' => '加载内置数据集', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'GetADBSparkNecessaryRAMPermissions' => [ - 'summary' => '查看当前用户的Spark基本权限诊断报告。', - 'path' => '', - 'methods' => [ - 'post', + 'staticInfo' => ['noSubstitutionReason' => '无替代API，历史原因导致该API被标记为弃用。'], + 'title' => '查询Spark SQL引擎状态', + 'summary' => '查询Spark SQL引擎的状态。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-06-28T01:10:33.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkSQLEngineState'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetActiveSparkSession', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxxx-xxx-xx\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202207151211hz0c****\\",\\n \\"MinExecutor\\": \\"1\\",\\n \\"MaxExecutor\\": \\"3\\",\\n \\"Jars\\": \\"oss://test-bucket/test.jar\\",\\n \\"SlotNum\\": \\"2\\",\\n \\"Config\\": \\"{\\\\\\"key1\\\\\\": \\\\\\"value1\\\\\\", \\\\\\"key2\\\\\\": \\\\\\"value2\\\\\\"}\\",\\n \\"State\\": \\"COMPLETED\\",\\n \\"SubmittedTimeInMillis\\": \\"1651213645000\\"\\n }\\n}","type":"json"}]', + ], + 'GetSparkTemplateFileContent' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -30747,138 +22033,88 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsUF9CN9', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下所有集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1r053byu48p****'."\n", - ], + 'schema' => ['title' => '数据库的id', 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-8vbn8pq537k8w****', 'maxLength' => 64], + ], + [ + 'name' => 'Id', + 'in' => 'formData', + 'schema' => ['title' => '模板文件的ID', 'description' => '应用模板ID。'."\n" + .'> 调用[GetSparkTemplateFullTree](~~456205~~)接口查询应用模板ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'minimum' => '0', 'exclusiveMinimum' => true, 'example' => '725204'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '642F3512-C628-5D0C-8815-F6670C****', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380'], 'Data' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ - 'Passed' => [ - 'description' => '检查是否具有使用ADB Spark的基本权限。'."\n" - ."\n" - .'- true：通过检查，持有基本权限。'."\n" - .'- false：检查失败，缺少部分权限。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'DeniedDetail' => [ - 'description' => '权限检查失败时，返回权限检查失败相关的诊断信息。', - 'type' => 'object', - 'properties' => [ - 'ResourceOwnerId' => [ - 'description' => '资源拥有者的ID。', - 'type' => 'string', - 'example' => '11685695632****', - ], - 'Action' => [ - 'description' => '鉴权失败的RAM Action名称。', - 'type' => 'string', - 'example' => 'ListSparkApps', - ], - 'PrincipalType' => [ - 'description' => '当前用户的身份类型，取值如下：'."\n" - .'- SubUser：RAM用户。'."\n" - .'- AssumedRoleUser：RAM角色。', - 'type' => 'string', - 'example' => 'SubUser', - ], - 'ResourceAuthTargetInfo' => [ - 'description' => '鉴权对象的信息，可以是当前用户的RAM账号ID，或者当前访问者对应的角色信息。', - 'type' => 'string', - 'example' => '223345695632****'."\n", - ], - 'PolicyType' => [ - 'description' => '引起无权限的策略类型，取值如下:'."\n" - .'- ControlPolicy ：管控策略。'."\n" - .'- SessionPolicy：临时Token额外添加的一个权限策略。'."\n" - .'- AssumeRolePolicy：RAM角色的授信策略。'."\n" - .'- AccountLevelIdentityBasedPolicy：账号授权范围的主体策略，包含自定义策略和系统策略。'."\n" - .'- ResourceGroupLevelIdentityBasedPolicy：资源组授权范围的主体策略，包含自定义策略和系统策略。', - 'type' => 'string', - 'example' => 'ControlPolicy', - ], - 'NoPermissionType' => [ - 'description' => '权限策略拒绝的类型，取值如下：'."\n" - .'- ImplicitDeny：资源持有者未配置相关权限策略给当前用户，缺省拒绝未授权的操作。'."\n" - .'- ExplicitDeny：资源持有者配置的RAM策略明确拒绝了当前用户访问对应的资源。', - 'type' => 'string', - 'example' => 'ImplicitDeny', - ], - ], - ], - 'Suggestion' => [ - 'description' => '根据诊断信息，推荐客户在RAM系统中进行的配置。', - 'type' => 'string', - 'example' => 'Grant the system RAM policy \'AliyunADBDeveloperAccess\' to current RAM user can quickly solve this issue.', - ], + 'AppType' => ['description' => '应用类型，取值说明：'."\n" + .'- **SQL**：SQL应用。'."\n" + .'- **STREAMING**：流应用。'."\n" + .'- **BATCH**：离线应用。', 'type' => 'string', 'example' => 'SQL'], + 'Content' => ['description' => '应用模板内容。', 'type' => 'string', 'example' => 'set spark.driver.resourceSpec=medium;set spark.executor.instances=2;set spark.executor.resourceSpec=medium;set spark.app.name=Spark SQL Test;'], + 'Id' => ['description' => '应用模板ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '725204'], + 'Type' => ['description' => '文件类型，取值说明：'."\n" + .'- **folder**：目录（文件夹）。'."\n" + .'- **file**：文件。', 'type' => 'string', 'example' => 'file'], + 'ResourceGroupName' => ['description' => '资源组名称。', 'type' => 'string', 'example' => 'test'], ], ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'Spark.InvalidParameter', - 'errorMessage' => 'Spark parameter is not valid, please check error info: %s.', - ], - [ - 'errorCode' => 'Spark.InvalidState', - 'errorMessage' => 'The object of the operation is in an invalid state: %s', - ], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.TemplateFile.BadFileType', 'errorMessage' => 'The requested template %s is not a file.', 'description' => '请求的模板文件ID不是文件类型的。'], + ], + 404 => [ + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"642F3512-C628-5D0C-8815-F6670C****\\",\\n \\"Data\\": {\\n \\"Passed\\": true,\\n \\"DeniedDetail\\": {\\n \\"ResourceOwnerId\\": \\"11685695632****\\",\\n \\"Action\\": \\"ListSparkApps\\",\\n \\"PrincipalType\\": \\"SubUser\\",\\n \\"ResourceAuthTargetInfo\\": \\"223345695632****\\\\n\\",\\n \\"PolicyType\\": \\"ControlPolicy\\",\\n \\"NoPermissionType\\": \\"ImplicitDeny\\"\\n },\\n \\"Suggestion\\": \\"Grant the system RAM policy \'AliyunADBDeveloperAccess\' to current RAM user can quickly solve this issue.\\"\\n }\\n}","type":"json"}]', - 'title' => '查看当前用户的Spark基本权限诊断报告', - 'description' => 'API诊断报告中包含了当前用户是否具有ADB Spark相关功能需要的所有权限，检测权限的范围可能会超过业务最小需求。当前API的诊断报告用于ADB Spark的环境快速初始化场景。如果需要细粒度配置权限，[请参考ADB Spark细粒度权限配置文档。](https://www.alibabacloud.com/help/zh/analyticdb/analyticdb-for-mysql/user-guide/create-the-aliyunadbsparkprocessingdatarole-role-for-a-ram-user-and-grant-permissions-to-the-role?spm=a2c63.p38356.help-menu-92664.d_2_5_0.48362a487dMzm9#section-y2z-ucd-1ko)', - ], - 'KillProcess' => [ - 'summary' => '调用KillProcess接口终止正在进行的任务。', - 'methods' => [ - 'get', + 'title' => '查询Spark应用模板的内容', + 'summary' => '获取Spark应用模板的内容。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkTemplateFileContent'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkTemplateFileContent', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"AppType\\": \\"SQL\\",\\n \\"Content\\": \\"set spark.driver.resourceSpec=medium;set spark.executor.instances=2;set spark.executor.resourceSpec=medium;set spark.app.name=Spark SQL Test;\\",\\n \\"Id\\": 725204,\\n \\"Type\\": \\"file\\",\\n \\"ResourceGroupName\\": \\"test\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetSparkTemplateFileContentResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <AppType>SQL</AppType>\\n <Content>set spark.driver.resourceSpec=medium;set spark.executor.instances=2;set spark.executor.resourceSpec=medium;set spark.app.name=Spark SQL Test;</Content>\\n <Id>725204</Id>\\n <Type>file</Type>\\n <ResourceGroupName>test</ResourceGroupName>\\n </Data>\\n</GetSparkTemplateFileContentResponse>","errorExample":""}]', + ], + 'GetSparkTemplateFolderTree' => [ + 'summary' => '查询Spark应用的目录结构。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -30886,97 +22122,81 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '189978', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', - ], + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-xxxx', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'>您可以调用[DescribeRegions](~~143074~~)接口查看可用地域的地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'ProcessId', - 'in' => 'query', - 'schema' => [ - 'description' => '任务ID。'."\n" - .'> 您可以调用[DescribeProcessList](~~612277~~)接口查看目标SQL的任务ID。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '202011191048151921681492420315100****', - ], + 'in' => 'formData', + 'schema' => ['title' => '数据库的ID', 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****', 'maxLength' => 64], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求id。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => ['title' => '模板文件的结构, 仅包含文件夹, 以树形结构展示.', 'description' => 'Spark应用的目录结构，以树形结构展示。返回参数说明：'."\n" + .'- **Uid**：阿里云账号的UID。'."\n" + .'- **Type**：应用模板类型。取值说明：'."\n" + .' **FOLDER**：目录。'."\n" + .'- **Parent**：父级。取值说明：'."\n" + .' - **0**：无子目录。'."\n" + .' - **-1**：有子目录。'."\n" + .'- **Children**：子目录结构。'."\n" + .'- **LastModified**：最近一次修改目录中应用的时间，格式为Unix时间戳，单位秒（s）。'."\n" + .'- **Name**：目录名称。'."\n" + .'- **Id**：目录ID。', 'type' => 'string', 'example' => '{ "Uid":195813423****, "Type":"FOLDER", "Parent":-1, "Children":[ { "LastModified":1647853173, "Uid":195813423****, "Type":"FOLDER", "Parent":0, "Id":157, "Name":"t" } ], "Id":725204, "Name":"root" }'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], + ], + 'title' => '查询Spark应用的目录结构', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-07-27T06:45:57.000Z', 'description' => '错误码发生变更'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', - 'title' => '终止正在进行的任务', - ], - 'DescribeAdviceServiceEnabled' => [ - 'summary' => '查询建议服务是否开启。', - 'methods' => [ - 'post', - 'get', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkTemplateFolderTree'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkTemplateFolderTree', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": \\"{ \\\\\\"Uid\\\\\\":195813423****, \\\\\\"Type\\\\\\":\\\\\\"FOLDER\\\\\\", \\\\\\"Parent\\\\\\":-1, \\\\\\"Children\\\\\\":[ { \\\\\\"LastModified\\\\\\":1647853173, \\\\\\"Uid\\\\\\":195813423****, \\\\\\"Type\\\\\\":\\\\\\"FOLDER\\\\\\", \\\\\\"Parent\\\\\\":0, \\\\\\"Id\\\\\\":157, \\\\\\"Name\\\\\\":\\\\\\"t\\\\\\" } ], \\\\\\"Id\\\\\\":725204, \\\\\\"Name\\\\\\":\\\\\\"root\\\\\\" }\\"\\n}","errorExample":""},{"type":"xml","example":"<GetSparkTemplateFolderTreeResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Data>{ \\"Uid\\":195813423****, \\"Type\\":\\"FOLDER\\", \\"Parent\\":-1, \\"Children\\":[ { \\"LastModified\\":1647853173, \\"Uid\\":195813423****, \\"Type\\":\\"FOLDER\\", \\"Parent\\":0, \\"Id\\":157, \\"Name\\":\\"t\\" } ], \\"Id\\":725204, \\"Name\\":\\"root\\" }</Data>\\n</GetSparkTemplateFolderTreeResponse>","errorExample":""}]', + ], + 'GetSparkTemplateFullTree' => [ + 'summary' => '查看Spark应用的目录结构。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -30984,86 +22204,86 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', - ], + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-2ze0vp0j6t3to****', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'in' => 'formData', + 'schema' => ['title' => '数据库的ID', 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****', 'maxLength' => 64], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'Message' => [ - 'title' => 'Message', - 'description' => '调用结果的信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常信息。', - 'type' => 'string', - 'example' => 'Success', - ], - 'RequestId' => [ - 'description' => '请求id。', - 'type' => 'string', - 'example' => 'E031AABF-BD56-5966-A063-4283EF18DB45', - ], - 'Result' => [ - 'title' => 'Advice Service Enabled', - 'description' => '建议服务是否开启。取值说明：'."\n" - .'- 开启，返回**True**。 '."\n" - .'- 关闭，返回**False**。', - 'type' => 'boolean', - 'example' => 'False', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => ['title' => '模板文件的树形结构', 'description' => '应用模板的目录结构。返回参数说明：'."\n" + .'- **Uid**：阿里云账号的UID。'."\n" + .'- **Type**：应用模板类型。取值说明：'."\n" + .' - **FOLDER**：目录。'."\n" + .' - **FILE**：应用。'."\n" + .'- **Parent**：父级。取值：'."\n" + .' - **0**：无子目录。'."\n" + .' - **-1**：有子目录。'."\n" + .'- **Children**：子目录结构。'."\n" + .'- **LastModified**：最近一次修改应用的时间，格式为Unix时间戳，单位秒（s）。'."\n" + .'- **AppType**：应用类型。取值说明：'."\n" + .' - **SQL**：SQL应用。'."\n" + .' - **STREAMING**：流应用。'."\n" + .' - **BATCH**：离线应用。'."\n" + .'- **Name**：目录名称或应用名称。'."\n" + .'- **Id**：目录ID或应用ID。', 'type' => 'string', 'example' => '{ "Uid": 10415777****, "Type": "FOLDER", "Parent": -1, "Children": [ { "LastModified": 1648544748, "Uid": 104157779****, "Type": "FILE", "Parent": 0, "Id": s202204132****, "AppType": "SQL", "Name": "f" }, { "LastModified": 1648544956, "Uid": 1041577795****, "Type": "FOLDER", "Parent": 0, "Id": 157, "Name": "f3333" } ], "Id": 725204, "Name": "root" }'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"E031AABF-BD56-5966-A063-4283EF18DB45\\",\\n \\"Result\\": true\\n}","type":"json"}]', - 'title' => '查询建议服务是否开启', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeSparkSQLDiagnosisList' => [ - 'summary' => '查询SparkSQL诊断列表。', - 'methods' => [ - 'post', - 'get', + 'title' => '查询Spark应用的目录结构', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-07-27T06:45:56.000Z', 'description' => '错误码发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkTemplateFullTree'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkTemplateFullTree', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": \\"{ \\\\\\"Uid\\\\\\": 10415777****, \\\\\\"Type\\\\\\": \\\\\\"FOLDER\\\\\\", \\\\\\"Parent\\\\\\": -1, \\\\\\"Children\\\\\\": [ { \\\\\\"LastModified\\\\\\": 1648544748, \\\\\\"Uid\\\\\\": 104157779****, \\\\\\"Type\\\\\\": \\\\\\"FILE\\\\\\", \\\\\\"Parent\\\\\\": 0, \\\\\\"Id\\\\\\": s202204132****, \\\\\\"AppType\\\\\\": \\\\\\"SQL\\\\\\", \\\\\\"Name\\\\\\": \\\\\\"f\\\\\\" }, { \\\\\\"LastModified\\\\\\": 1648544956, \\\\\\"Uid\\\\\\": 1041577795****, \\\\\\"Type\\\\\\": \\\\\\"FOLDER\\\\\\", \\\\\\"Parent\\\\\\": 0, \\\\\\"Id\\\\\\": 157, \\\\\\"Name\\\\\\": \\\\\\"f3333\\\\\\" } ], \\\\\\"Id\\\\\\": 725204, \\\\\\"Name\\\\\\": \\\\\\"root\\\\\\" }\\"\\n}","errorExample":""},{"type":"xml","example":"<GetSparkTemplateFullTreeResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Data>{ \\"Uid\\": 10415777****, \\"Type\\": \\"FOLDER\\", \\"Parent\\": -1, \\"Children\\": [ { \\"LastModified\\": 1648544748, \\"Uid\\": 104157779****, \\"Type\\": \\"FILE\\", \\"Parent\\": 0, \\"Id\\": s202204132****, \\"AppType\\": \\"SQL\\", \\"Name\\": \\"f\\" }, { \\"LastModified\\": 1648544956, \\"Uid\\": 1041577795****, \\"Type\\": \\"FOLDER\\", \\"Parent\\": 0, \\"Id\\": 157, \\"Name\\": \\"f3333\\" } ], \\"Id\\": 725204, \\"Name\\": \\"root\\" }</Data>\\n</GetSparkTemplateFullTreeResponse>","errorExample":""}]', + ], + 'GetSparkWarehouseBatchSQL' => [ + 'summary' => '获取Spark SQL执行结果。', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -31075,243 +22295,82 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '197113', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '235568', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-2zez35ww415xjwk5', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'StatementId', - 'in' => 'query', - 'schema' => [ - 'description' => 'Spark作业中代码块的唯一ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '123', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '20', - ], - ], - [ - 'name' => 'Order', - 'in' => 'query', - 'schema' => [ - 'description' => '将查询结果按指定字段进行排序。格式为JSON字符串，例如`[{"Field":"MaxExclusiveTime","Type":"Asc"}]`。其中：'."\n" - .'- `Field`表示排序字段。取值说明：'."\n" - .' - `MaxExclusiveTime`：最大执行时间。'."\n" - .' - `PeakMemory`：内存峰值。'."\n" - .' - `QueryStartTime`： query开始时间。'."\n" - .' - `QueryWallclockTime`：query 执行时间。'."\n" - ."\n" - .'- `Type`表示排序方式。取值说明：'."\n" - .' - `Asc`：升序排序。'."\n" - .' - `Desc`： 降序排序。'."\n" - ."\n" - .'> - 若不设置参数，默认按照`MaxExclusiveTime`字段升序排列。', - 'type' => 'string', - 'required' => false, - 'example' => '[{\\"Field\\":\\"QueryStartTime\\",\\"Type\\":\\"Desc\\"}]', - ], + 'name' => 'QueryId', + 'in' => 'formData', + 'schema' => ['description' => 'Spark SQ的L执行ID。', 'type' => 'string', 'required' => true, 'example' => 'sq2024123*****'], ], [ - 'name' => 'MinStartTime', - 'in' => 'query', - 'schema' => [ - 'description' => '最小起始时间', - 'type' => 'string', - 'required' => false, - 'example' => '2024-11-28 22:00:00', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-uf6485635f***'], ], [ - 'name' => 'MaxStartTime', - 'in' => 'query', - 'schema' => [ - 'description' => '最大起始时间', - 'type' => 'string', - 'required' => false, - 'example' => '2024-11-28 23:00:00', - ], + 'name' => 'Agency', + 'in' => 'formData', + 'schema' => ['description' => '协助记录客户端名称，最长16个字符的意义字符串。', 'type' => 'string', 'required' => false, 'example' => 'DMS', 'default' => 'POPSDK'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '返回结构体。', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1343', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A91C9D07-7462-5F35-BB47-83629CE6CCAC', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'SQLDiagnosisList' => [ - 'description' => 'SQL 诊断信息集合', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'State' => [ - 'description' => 'Query 最终执行状态：'."\n" - ."\n" - .'- COMPLETED：完成。'."\n" - .'- CANCELED：取消。'."\n" - .'- ABORTED：中止。'."\n" - .'- FAILED：失败。', - 'type' => 'string', - 'example' => 'COMPLETED', - ], - 'SQL' => [ - 'description' => 'SQL语句。', - 'type' => 'string', - 'example' => 'select * from device where name = \'105506012112790031\'', - ], - 'AppId' => [ - 'description' => '应用ID。'."\n" - .'> 调用[ListSparkApps](~~612475~~)接口查询Spark应用的ID。', - 'type' => 'string', - 'example' => 's202404291020bjd448ad40002122', - ], - 'StatementId' => [ - 'description' => 'Spark作业中代码块的唯一ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'InnerQueryId' => [ - 'description' => 'Spark 应用内部 query 执行 ID', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'StartTime' => [ - 'description' => '查询开始时间。格式：<i>yyyy-MM-ddTHH:mmZ</i>（UTC时间）。', - 'type' => 'string', - 'example' => '2024-11-20 09:09:00', - ], - 'ElapsedTime' => [ - 'description' => '实际运行时间，单位毫秒。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'MaxExclusiveTime' => [ - 'description' => '最大算子执行时间，单位毫秒', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '90', - ], - 'PeakMemory' => [ - 'description' => '最大算子内存消耗，单位byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1024', - ], - 'ScanRowCount' => [ - 'description' => '扫描行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - ], - ], - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息。', - 'type' => 'string', - 'example' => '{}', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '3D44EDA0-A9DC-580D-9B5A-019370C075F4'], + 'Data' => ['description' => '返回数据。', 'example' => '{\'DBClusterId\': \'amv-uf6485635fz852mn\', \'Statements\': [{\'Code\': \'show databases\', \'State\': \'FINISHED\', \'StatementId\': \'sq202501141001sh8e12e080006846-0000\', \'Result\': \'+--------------------+n', '$ref' => '#/components/schemas/SparkBatchSQL'], ], ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": 1343,\\n \\"RequestId\\": \\"A91C9D07-7462-5F35-BB47-83629CE6CCAC\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"SQLDiagnosisList\\": [\\n {\\n \\"State\\": \\"COMPLETED\\",\\n \\"SQL\\": \\"select * from device where name = \'105506012112790031\'\\",\\n \\"AppId\\": \\"s202404291020bjd448ad40002122\\",\\n \\"StatementId\\": 1,\\n \\"InnerQueryId\\": 1,\\n \\"StartTime\\": \\"2024-11-20 09:09:00\\",\\n \\"ElapsedTime\\": 100,\\n \\"MaxExclusiveTime\\": 90,\\n \\"PeakMemory\\": 1024,\\n \\"ScanRowCount\\": 100\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{}\\"\\n}","type":"json"}]', - 'title' => '查询SparkSQL诊断列表', - ], - 'DescribeSparkSQLDiagnosisAttribute' => [ - 'summary' => '查询单个Spark SQL的诊断详情。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取Spark SQL执行结果', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkWarehouseBatchSQL'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkWarehouseBatchSQL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"3D44EDA0-A9DC-580D-9B5A-019370C075F4\\",\\n \\"Data\\": {\\n \\"Uid\\": 0,\\n \\"QuerySubmissionTime\\": 1723521767000,\\n \\"Query\\": \\"SELECT * FROM db.tb\\",\\n \\"QueryId\\": \\"sq172352176****\\",\\n \\"Schema\\": \\"default\\",\\n \\"QueryEndTime\\": 1723521767000,\\n \\"DBClusterId\\": \\"amv-bp17s73f016****\\",\\n \\"QueryState\\": \\"RUNNING\\",\\n \\"Statements\\": [\\n {\\n \\"ResultUri\\": \\"oss://yourbucket/result.json\\",\\n \\"EndTime\\": 1723521767000,\\n \\"AppId\\": \\"s20240122jsdx****\\",\\n \\"StatementId\\": \\"sq1723521767****-0001\\",\\n \\"State\\": \\"RUNNING\\",\\n \\"StartTime\\": 1723521767000,\\n \\"Error\\": \\"table is not found\\",\\n \\"Code\\": \\"SELECT 100\\",\\n \\"Result\\": \\"+---+-----+\\\\n|age| name|\\\\n+---+-----+\\\\n| 14| Tom|\\\\n| 23|Alice|\\\\n+---+-----+\\"\\n }\\n ],\\n \\"ErrMessage\\": \\"schema is not found\\",\\n \\"QueryStartTime\\": 1723521767000,\\n \\"ResourceGroupName\\": \\"spark_rg\\"\\n }\\n}","type":"json"}]', + ], + 'GetTable' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -31323,168 +22382,97 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '197163', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '160312', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'DbName', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> * 您可以调用[DescribeDBClusters](~~98094~~)接口查看目标地域下所有的集群信息，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-2zeq4788qyy7k662', - ], + 'schema' => ['description' => '数据库名。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'dbName', 'default' => 'MYSQL'], ], [ - 'name' => 'RegionId', + 'name' => 'TableName', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '查询表名。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'tableName', 'default' => 'USER'], ], [ - 'name' => 'AppId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '应用ID。'."\n" - .'> 调用[ListSparkApps](~~612475~~)接口查询Spark应用的ID。', - 'type' => 'string', - 'required' => true, - 'example' => 's202411071444hzdvk486d9d2001****', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-*******'], ], [ - 'name' => 'InnerQueryId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'Spark 应用内部 query 执行 ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'maximum' => '9223372036854775807', - 'exclusiveMaximum' => true, - 'minimum' => '-2', - 'exclusiveMinimum' => true, - 'example' => '1', - ], - ], - [ - 'name' => 'Language', - 'in' => 'query', - 'schema' => [ - 'description' => '语言类型。系统权限策略的描述将以此语言返回。'."\n" - ."\n" - .'- en：英文。'."\n" - .'- zh：中文。', - 'type' => 'string', - 'required' => true, - 'example' => 'zh', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'AppId' => [ - 'description' => '应用ID。'."\n" - .'> 调用[ListSparkApps](~~612475~~)接口查询Spark应用的ID。', - 'type' => 'string', - 'example' => 's202411071444hzdvk486d9d2001****', - ], - 'InnerQueryId' => [ - 'description' => 'Spark 应用内部 query 执行 ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'ElapsedTime' => [ - 'description' => '实际运行时间，单位毫秒。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'DiagnosisInfos' => [ - 'description' => '诊断建议集合', - 'type' => 'array', - 'items' => [ - 'description' => '诊断建议', - '$ref' => '#/components/schemas/Adb4MysqlSparkDiagnosisInfo', - ], - ], - 'OperatorListSortedByMetrics' => [ - 'description' => '按 metrics 排序后的算子队列', - 'type' => 'object', - 'properties' => [ - 'OperatorListSortedByMaxMemory' => [ - 'description' => '按最大内存消耗排序后的算子队列', - 'type' => 'array', - 'items' => [ - 'description' => 'Spark 算子信息', - '$ref' => '#/components/schemas/SparkOperatorInfo', - ], - ], - 'OperatorListSortedByExclusiveTime' => [ - 'description' => '按执行时间排序后的算子队列', - 'type' => 'array', - 'items' => [ - 'description' => 'Spark 算子信息', - '$ref' => '#/components/schemas/SparkOperatorInfo', - ], - ], - ], - ], - 'Root' => [ - 'description' => 'Spark 执行计划树', - '$ref' => '#/components/schemas/OperatorNode', - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息。', - 'type' => 'string', - 'example' => '{}', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Code' => ['description' => '错误码。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'Message' => ['description' => '错误信息。', 'type' => 'string', 'example' => '""'], + 'Success' => ['description' => '是否成功。', 'type' => 'boolean', 'example' => 'true'], + 'Table' => ['description' => '表详细信息。', '$ref' => '#/components/schemas/TableModel'], ], ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"AppId\\": \\"s202411071444hzdvk486d9d2001****\\",\\n \\"InnerQueryId\\": 1,\\n \\"ElapsedTime\\": 100,\\n \\"DiagnosisInfos\\": [\\n {\\n \\"DiagnosisType\\": \\"APPLICATION\\",\\n \\"DiagnosisCode\\": \\"\\",\\n \\"DiagnosisCodeLabel\\": \\"\\",\\n \\"DiagnosisMsg\\": \\"\\"\\n }\\n ],\\n \\"OperatorListSortedByMetrics\\": {\\n \\"OperatorListSortedByMaxMemory\\": [\\n {\\n \\"OperatorName\\": \\"\\",\\n \\"MetricValue\\": 0\\n }\\n ],\\n \\"OperatorListSortedByExclusiveTime\\": [\\n {\\n \\"OperatorName\\": \\"\\",\\n \\"MetricValue\\": 0\\n }\\n ]\\n },\\n \\"Root\\": {\\n \\"nodeName\\": \\"\\",\\n \\"id\\": 0,\\n \\"nodeDepth\\": 0,\\n \\"parentId\\": 0,\\n \\"levelWidth\\": 0,\\n \\"nodeWidth\\": 0,\\n \\"stats\\": {\\n \\"parameters\\": \\"\\",\\n \\"bytes\\": 0,\\n \\"outputRows\\": 0,\\n \\"timeCost\\": 0,\\n \\"peakMemory\\": 0\\n },\\n \\"children\\": [\\n {\\n \\"nodeName\\": \\"\\",\\n \\"id\\": 0,\\n \\"nodeDepth\\": 0,\\n \\"parentId\\": 0,\\n \\"levelWidth\\": 0,\\n \\"nodeWidth\\": 0,\\n \\"stats\\": {\\n \\"parameters\\": \\"\\",\\n \\"bytes\\": 0,\\n \\"outputRows\\": 0,\\n \\"timeCost\\": 0,\\n \\"peakMemory\\": 0\\n },\\n \\"children\\": [\\n {\\n \\"nodeName\\": \\"\\",\\n \\"id\\": 0,\\n \\"nodeDepth\\": 0,\\n \\"parentId\\": 0,\\n \\"levelWidth\\": 0,\\n \\"nodeWidth\\": 0,\\n \\"stats\\": {\\n \\"parameters\\": \\"\\",\\n \\"bytes\\": 0,\\n \\"outputRows\\": 0,\\n \\"timeCost\\": 0,\\n \\"peakMemory\\": 0\\n },\\n \\"children\\": []\\n }\\n ]\\n }\\n ]\\n },\\n \\"AccessDeniedDetail\\": \\"{}\\"\\n}","type":"json"}]', - 'title' => '查询SparkSQL诊断详情', - ], - 'DescribeOversizeNonPartitionTableInfos' => [ - 'summary' => '调用DescribeOversizeNonPartitionTableInfos接口查看集群非分区表是否存在不合理的情况。', - 'methods' => [ - 'post', - 'get', + 'title' => '查询表信息', + 'summary' => '获取表信息。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2025-05-07T05:42:07.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2024-07-04T08:31:31.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-12-21T06:38:02.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-03-22T02:16:05.000Z', 'description' => '错误码发生变更、响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetTable'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getTable', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Code\\": 0,\\n \\"Message\\": \\"\\\\\\"\\\\\\"\\",\\n \\"Success\\": true,\\n \\"Table\\": {\\n \\"TblId\\": 123,\\n \\"DbName\\": \\"example\\",\\n \\"TableName\\": \\"tableName\\",\\n \\"TableType\\": \\"external_table\\",\\n \\"PartitionKeys\\": [\\n {\\n \\"Name\\": \\"name\\",\\n \\"Type\\": \\"long\\",\\n \\"Comment\\": \\"comment\\",\\n \\"DatabaseName\\": \\"databaseName\\",\\n \\"TableName\\": \\"tableName\\",\\n \\"MappedName\\": \\"mappedName\\",\\n \\"DataType\\": \\"long\\",\\n \\"CreateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"UpdateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"PkPosition\\": -1,\\n \\"IsPartitionKey\\": false,\\n \\"OrdinalPosition\\": -1,\\n \\"ColumnRawName\\": \\"ColumnRawName\\",\\n \\"PhysicalColumnName\\": \\"PhysicalColumnName\\",\\n \\"Nullable\\": true,\\n \\"AutoIncrement\\": true,\\n \\"Precision\\": 1,\\n \\"Scale\\": 1,\\n \\"Primarykey\\": true,\\n \\"DefaultValue\\": \\"default\\",\\n \\"Tokenizer\\": \\"tokenizer\\",\\n \\"Encode\\": \\"encode\\",\\n \\"Compression\\": \\"compression\\",\\n \\"Delimiter\\": \\"delimiter\\",\\n \\"ValueType\\": \\"valueType\\",\\n \\"CompressFloatUseShort\\": false,\\n \\"OnUpdate\\": \\"onUpdate\\"\\n }\\n ],\\n \\"Parameters\\": {\\n \\"key\\": \\"key:value\\"\\n },\\n \\"Sd\\": {\\n \\"SdId\\": 1,\\n \\"Location\\": \\"oss://**************\\",\\n \\"InputFormat\\": \\"org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat\\",\\n \\"OutputFormat\\": \\"org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat\\",\\n \\"Compressed\\": false,\\n \\"NumBuckets\\": 1,\\n \\"SerDeInfo\\": {\\n \\"SerDeId\\": 123,\\n \\"Name\\": \\"example\\",\\n \\"Parameters\\": {\\n \\"key\\": \\"key:value\\"\\n },\\n \\"SerializationLib\\": \\"org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe\\"\\n },\\n \\"Parameters\\": {\\n \\"key\\": \\"key:value\\"\\n },\\n \\"StoredAsSubDirectories\\": false\\n },\\n \\"CreateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"ViewOriginalText\\": \\"ViewOriginalText\\",\\n \\"ViewExpandedText\\": \\"ViewExpandedText\\",\\n \\"Temporary\\": false,\\n \\"Comment\\": \\"description\\",\\n \\"Cols\\": [\\n {\\n \\"Name\\": \\"name\\",\\n \\"Type\\": \\"long\\",\\n \\"Comment\\": \\"comment\\",\\n \\"DatabaseName\\": \\"databaseName\\",\\n \\"TableName\\": \\"tableName\\",\\n \\"MappedName\\": \\"mappedName\\",\\n \\"DataType\\": \\"long\\",\\n \\"CreateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"UpdateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"PkPosition\\": -1,\\n \\"IsPartitionKey\\": false,\\n \\"OrdinalPosition\\": -1,\\n \\"ColumnRawName\\": \\"ColumnRawName\\",\\n \\"PhysicalColumnName\\": \\"PhysicalColumnName\\",\\n \\"Nullable\\": true,\\n \\"AutoIncrement\\": true,\\n \\"Precision\\": 1,\\n \\"Scale\\": 1,\\n \\"Primarykey\\": true,\\n \\"DefaultValue\\": \\"default\\",\\n \\"Tokenizer\\": \\"tokenizer\\",\\n \\"Encode\\": \\"encode\\",\\n \\"Compression\\": \\"compression\\",\\n \\"Delimiter\\": \\"delimiter\\",\\n \\"ValueType\\": \\"valueType\\",\\n \\"CompressFloatUseShort\\": false,\\n \\"OnUpdate\\": \\"onUpdate\\"\\n }\\n ],\\n \\"DistributeColumns\\": [\\n {\\n \\"Name\\": \\"name\\",\\n \\"Type\\": \\"long\\",\\n \\"Comment\\": \\"comment\\",\\n \\"DatabaseName\\": \\"databaseName\\",\\n \\"TableName\\": \\"tableName\\",\\n \\"MappedName\\": \\"mappedName\\",\\n \\"DataType\\": \\"long\\",\\n \\"CreateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"UpdateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"PkPosition\\": -1,\\n \\"IsPartitionKey\\": false,\\n \\"OrdinalPosition\\": -1,\\n \\"ColumnRawName\\": \\"ColumnRawName\\",\\n \\"PhysicalColumnName\\": \\"PhysicalColumnName\\",\\n \\"Nullable\\": true,\\n \\"AutoIncrement\\": true,\\n \\"Precision\\": 1,\\n \\"Scale\\": 1,\\n \\"Primarykey\\": true,\\n \\"DefaultValue\\": \\"default\\",\\n \\"Tokenizer\\": \\"tokenizer\\",\\n \\"Encode\\": \\"encode\\",\\n \\"Compression\\": \\"compression\\",\\n \\"Delimiter\\": \\"delimiter\\",\\n \\"ValueType\\": \\"valueType\\",\\n \\"CompressFloatUseShort\\": false,\\n \\"OnUpdate\\": \\"onUpdate\\"\\n }\\n ],\\n \\"PhysicalTableName\\": \\"physicalTableName\\",\\n \\"PhysicalDatabaseName\\": \\"physicalDatabaseName\\",\\n \\"DistributeType\\": \\"DistributeType\\",\\n \\"PartitionType\\": \\"PartitionType\\",\\n \\"PartitionColumn\\": \\"colName\\",\\n \\"PartitionCount\\": 16,\\n \\"PreviousVersion\\": 1,\\n \\"CurrentVersion\\": 2,\\n \\"UpdateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"TableEngineName\\": \\"hive\\",\\n \\"IsAllIndex\\": true,\\n \\"BlockSize\\": 64,\\n \\"Compression\\": \\"Compression\\",\\n \\"RawTableName\\": \\"RawTableName\\",\\n \\"SubpartitionType\\": \\"SubpartitionColumn\\",\\n \\"SubpartitionColumn\\": \\"SubpartitionColumn\\",\\n \\"SubpartitionCount\\": 64,\\n \\"ArchiveType\\": \\"ArchiveType\\",\\n \\"MaxColumnId\\": 0,\\n \\"EnableDfs\\": false,\\n \\"StoragePolicy\\": \\"StoragePolicy\\",\\n \\"HotPartitionCount\\": 32,\\n \\"IsFulltextDict\\": false,\\n \\"RtIndexAll\\": false,\\n \\"RouteColumns\\": [],\\n \\"RtEngineType\\": \\"RtEngineType\\",\\n \\"RtModeType\\": \\"RtModeType\\",\\n \\"RouteType\\": \\"routeType\\",\\n \\"DictEncode\\": false,\\n \\"BucketCount\\": 16,\\n \\"Bucket\\": 16,\\n \\"ViewSecurityMode\\": \\"ViewSecurityMode\\",\\n \\"Indexes\\": [\\n {\\n \\"DatabaseName\\": \\"exampleDatabase\\",\\n \\"PhysicalTableName\\": \\"physicalDatabase\\",\\n \\"IndexName\\": \\"indexName\\",\\n \\"IndexType\\": \\"NORMAL\\",\\n \\"IndexColumns\\": [],\\n \\"ColumnOrds\\": [\\n \\"ASC/DESC\\"\\n ],\\n \\"Options\\": {\\n \\"key\\": \\"key:value\\"\\n },\\n \\"CreateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"UpdateTime\\": \\"2023-01-05 13:17:55\\"\\n }\\n ],\\n \\"CreatedBySource\\": \\"\\",\\n \\"CreatedByUser\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetTableResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Code>0</Code>\\n <Message>\\"\\"</Message>\\n <Success>true</Success>\\n <Table>\\n <PartitionKeys/>\\n <Sd>\\n <SerDeInfo/>\\n </Sd>\\n <Cols/>\\n <DistributeColumns/>\\n <RouteColumns/>\\n <RouteEffectiveColumn/>\\n <Indexes>\\n <IndexColumns/>\\n </Indexes>\\n </Table>\\n</GetTableResponse>","errorExample":""}]', + ], + 'GetTableColumns' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -31496,264 +22484,74 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '217358', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '157085', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'schema' => ['description' => '数据库名。', 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], ], [ - 'name' => 'RegionId', + 'name' => 'TableName', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '表名。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ - 'name' => 'StartTime', + 'name' => 'ColumnName', 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间，UTC时间，格式为：yyyy-MM-ddTHH:mmZ。'."\n" - .'> 仅当SQL审计状态为开启时，才能查询到SQL审计日志，且只支持查询30天内的SQL审计日志。如果中途关闭了SQL审计，再次打开时，仅能查询到再次打开后的SQL审计日志。'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2024-05-11T05:44Z', - ], + 'schema' => ['description' => '列名。', 'type' => 'string', 'required' => false, 'example' => 'assist_user_phone'], ], [ - 'name' => 'EndTime', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间，格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。'."\n" - .'> 查询结束时间需晚于查询开始时间，且与查询开始时间间隔小于7天。'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2024-05-11T05:44Z', - ], + 'schema' => ['description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - ."\n" - .'- 30；'."\n" - .'- 50；'."\n" - .'- 100'."\n" - ."\n" - .'默认值：30。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '30', - 'example' => '30', - 'default' => '30', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码，取值为大于0且不超过Integer的最大值。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - ], + 'schema' => ['description' => '每页记录数，取值范围如下：'."\n" + .'* **30**（默认值）。'."\n" + .'* **50**。'."\n" + .'* **100**。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '30'], ], [ - 'name' => 'Lang', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '设置下载文件的文件标题以及部分错误信息的语言，支持如下语言：'."\n" - .'- **zh（默认值）**：简体中文。'."\n" - .'- **en**：英文。'."\n" - .'- **ja**：日语。'."\n" - .'- **zh-tw**：繁体中文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'Order', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '按指定字段排序，json格式：JSON数组，有序，按顺序输入排列字段和升降序类型：'."\n" - ."\n" - .'如：'."\n" - ."\n" - .'```'."\n" - .'['."\n" - ."\n" - .' {'."\n" - ."\n" - .' "Field":"Name",'."\n" - ."\n" - .' "Type":"Asc"'."\n" - ."\n" - .' }'."\n" - ."\n" - .']'."\n" - .'```'."\n" - ."\n" - .'其中Field表示需要排序的字段名，目前仅支持对"Name" 字段排序。'."\n" - .'Type表示排序类型 Desc为降序，Asc为升序'."\n" - ."\n" - .'均不区分大小写。', - 'type' => 'string', - 'required' => false, - 'example' => '[{"Field":"SchemaName","Type":"Asc"}]', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '1', - ], - 'PageNumber' => [ - 'description' => '页数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'am-bp16t5ci7r74s****', - ], - 'Tables' => [ - 'description' => '不合理非分区表信息。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'SchemaName' => [ - 'description' => '数据库名称。'."\n" - .' '."\n", - 'type' => 'string', - 'example' => 'adb_demo', - ], - 'TableName' => [ - 'description' => '表名。', - 'type' => 'string', - 'example' => 'test', - ], - 'RowCount' => [ - 'description' => '表行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1222', - ], - 'IndexSize' => [ - 'description' => '普通索引数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '111', - ], - 'DataSize' => [ - 'description' => '表数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2921132457984', - ], - 'LocalDataSize' => [ - 'description' => '热数据量大小，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1223', - ], - 'PrimaryKeySize' => [ - 'description' => '主键索引大小，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '123', - ], - 'RemoteDataSize' => [ - 'description' => '冷数据量大小，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '122', - ], - 'SpaceRatio' => [ - 'description' => '表空间占比，单位：%。'."\n" - ."\n" - .'> 计算公式为：表空间占比 = (表总数据量 / 实例总数据量) * 100。', - 'type' => 'number', - 'format' => 'double', - 'example' => '0.3', - ], - ], - ], - ], - 'DetectionItems' => [ - 'description' => '检测项及检测结果列表。', - 'type' => 'array', - 'items' => [ - 'description' => '检测项信息。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '检测项名。', - 'type' => 'string', - 'example' => '非分区表过大', - ], - 'Message' => [ - 'description' => '检测结果信息。', - 'type' => 'string', - 'example' => '检测到多个非分区表过大', - ], - 'Status' => [ - 'description' => '检测结果状态。', - 'type' => 'string', - 'example' => 'NORMAL'."\n" - .'WARNING'."\n" - .'CRITICAL', - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'PageNumber' => ['description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数，取值范围如下：'."\n" + .'* **30**（默认值）。'."\n" + .'* **50**。'."\n" + .'* **100**。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '结果中数据的总条数。', 'type' => 'integer', 'format' => 'int64', 'example' => '15'], + 'Data' => [ + 'description' => '返回数据。', + 'type' => 'object', + 'properties' => [ + 'PageNumber' => ['description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数，取值范围如下：'."\n" + .'* **30**（默认值）。'."\n" + .'* **50**。'."\n" + .'* **100**。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '结果中数据的总条数。', 'type' => 'integer', 'format' => 'int64', 'example' => '15'], + 'Table' => ['description' => '表的详细信息。', '$ref' => '#/components/schemas/TableDetailModel'], ], ], ], @@ -31761,29 +22559,54 @@ ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '查询列信息', + 'summary' => '查询列信息。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2025-05-07T05:42:08.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-10-25T05:36:00.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-03-22T02:16:05.000Z', 'description' => '错误码发生变更、响应参数发生变更'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"1\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"DBClusterId\\": \\"am-bp16t5ci7r74s****\\",\\n \\"Tables\\": [\\n {\\n \\"SchemaName\\": \\"adb_demo\\",\\n \\"TableName\\": \\"test\\",\\n \\"RowCount\\": 1222,\\n \\"IndexSize\\": 111,\\n \\"DataSize\\": 2921132457984,\\n \\"LocalDataSize\\": 1223,\\n \\"PrimaryKeySize\\": 123,\\n \\"RemoteDataSize\\": 122,\\n \\"SpaceRatio\\": 0.3\\n }\\n ],\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"非分区表过大\\",\\n \\"Message\\": \\"检测到多个非分区表过大\\",\\n \\"Status\\": \\"NORMAL\\\\nWARNING\\\\nCRITICAL\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '检测非分区表不合理', - ], - 'DescribeTablePartitionDiagnose' => [ - 'summary' => '调用DescribeTablePartitionDiagnose接口查询分区诊断信息。', - 'methods' => [ - 'post', - 'get', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetTableColumns'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getTableColumns', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 15,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 15,\\n \\"Table\\": {\\n \\"SchemaName\\": \\"schemaName\\",\\n \\"TableName\\": \\"tableName\\",\\n \\"TableType\\": \\"PHYSICAL_SCHEMA_NAME\\",\\n \\"CreateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"UpdateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"Description\\": \\"Description\\",\\n \\"Owner\\": \\"abc\\",\\n \\"Columns\\": [\\n {\\n \\"ColumnName\\": \\"example\\",\\n \\"Type\\": \\"string\\",\\n \\"Description\\": \\"description\\",\\n \\"SchemaName\\": \\"schemaName\\",\\n \\"TableName\\": \\"tableName\\",\\n \\"CreateTime\\": \\"2023-01-05\'T\'13:17:55\'Z\'\\",\\n \\"UpdateTime\\": \\"2023-01-05\'T\'13:17:55\'Z\'\\",\\n \\"PartitionKey\\": true,\\n \\"Nullable\\": false,\\n \\"PrimaryKey\\": true,\\n \\"DistributeKey\\": false\\n }\\n ],\\n \\"Catalog\\": \\"oss\\",\\n \\"CreatedBySource\\": \\"\\",\\n \\"CreatedByUser\\": \\"\\",\\n \\"Location\\": \\"\\",\\n \\"Parameters\\": {\\n \\"key\\": \\"\\"\\n }\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetTableColumnsResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>15</TotalCount>\\n <Data>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>15</TotalCount>\\n <Table>\\n <Columns/>\\n </Table>\\n </Data>\\n</GetTableColumnsResponse>","errorExample":""}]', + ], + 'GetTableDDL' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -31795,249 +22618,96 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '186721', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '157088', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp171g24yvbxxxxx', - ], + 'schema' => ['description' => '数据库名称。'."\n" + .' '."\n", 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], ], [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', - ], - ], - [ - 'name' => 'PageNumber', + 'name' => 'TableName', 'in' => 'query', - 'schema' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => '表名。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ - 'name' => 'Order', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '将查询结果按指定字段进行排序。格式为JOSN字符串，例如`[{"Field":"TotalSize","Type":"Desc"}]`。其中：'."\n" - .'- `Field`表示排序字段。支持如下取值：'."\n" - .' - `SchemaName`：表所属的数据库名。'."\n" - .' - `TableName`：表名。'."\n" - .' - `TotalSize`：总数据量。'."\n" - .' - `SpaceRatio`：空间占比。'."\n" - .'- `Type`表示排序方式。支持如下取值：'."\n" - .' - `Asc`：升序排序。'."\n" - .' - `Desc`： 降序排序。'."\n" - ."\n" - .'> 若不设置参数，默认按照目标表的总数据量倒序排列。', - 'type' => 'string', - 'required' => false, - 'example' => '[{\\"Field\\":\\"TotalSize\\",\\"Type\\":\\"Desc\\"}]', - 'default' => '[{"Field":"SchemaName", "Type": "desc" }]', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1ub9grke1****'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'Lang', - 'in' => 'query', - 'schema' => [ - 'description' => '指定请求和接收消息的语言类型，默认为**zh**。取值：'."\n" - .'- **zh**：中文'."\n" - .'- **en**：英文'."\n" - .'- **ja**：日语。'."\n" - .'- **zh-tw**：繁体中文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', - 'default' => 'zh', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '185', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp171g24yvbxxxxx', - ], - 'SuggestMaxRecordsPerPartition' => [ - 'description' => '建议每个二级分区的最大行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '640000000', - ], - 'SuggestMinRecordsPerPartition' => [ - 'description' => '建议每个二级分区的最小行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '64000000', - ], - 'Items' => [ - 'description' => '详情。', - 'type' => 'array', - 'items' => [ - 'description' => '信息列表。', - 'type' => 'object', - 'properties' => [ - 'TableName' => [ - 'description' => '表名称。', - 'type' => 'string', - 'example' => 'user', - ], - 'PartitionDetail' => [ - 'description' => '不合理分区。', - 'type' => 'string', - 'example' => '[20210110, 20210113,20210123]', - ], - 'SchemaName' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'test_db', - ], - 'PartitionNumber' => [ - 'description' => '分区个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'TotalSize' => [ - 'description' => '总数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '42949672960', - ], - 'SpaceRatio' => [ - 'description' => '表空间占比，单位：%。'."\n" - ."\n" - .'> 计算公式为：表空间占比 = 表总数据量 / 实例总数据量 * 100。', - 'type' => 'number', - 'format' => 'double', - 'example' => '66.23', - ], - ], - ], - ], - 'DetectionItems' => [ - 'description' => '检测项及检测结果列表。', - 'type' => 'array', - 'items' => [ - 'description' => '检测项及检测结果列表。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '检测项名字。', - 'type' => 'string', - 'example' => '表分区合理性检测', - ], - 'Message' => [ - 'description' => '检测结果信息。', - 'type' => 'string', - 'example' => '检测到表存在分区不合理的情况', - ], - 'Status' => [ - 'description' => '检测结果状态。取值：'."\n" - ."\n" - .'- NORMAL'."\n" - .'- WARNING'."\n" - .'- CRITICAL', - 'type' => 'string', - 'example' => 'WARNING', - ], - ], - ], - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '863D51B7-5321-41D8-A0B6-A088B0******'], + 'SQL' => ['description' => 'SQL语句。', 'type' => 'string', 'example' => 'create table ('."\n" + .' id varchar(32)'."\n" + .');'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": 185,\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"DBClusterId\\": \\"amv-bp171g24yvbxxxxx\\",\\n \\"SuggestMaxRecordsPerPartition\\": 640000000,\\n \\"SuggestMinRecordsPerPartition\\": 64000000,\\n \\"Items\\": [\\n {\\n \\"TableName\\": \\"user\\",\\n \\"PartitionDetail\\": \\"[20210110, 20210113,20210123]\\",\\n \\"SchemaName\\": \\"test_db\\",\\n \\"PartitionNumber\\": 2,\\n \\"TotalSize\\": 42949672960,\\n \\"SpaceRatio\\": 66.23\\n }\\n ],\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"表分区合理性检测\\",\\n \\"Message\\": \\"检测到表存在分区不合理的情况\\",\\n \\"Status\\": \\"WARNING\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', - 'title' => '查询二级分区诊断新系列', - ], - 'DescribeSparkAppDiagnosisInfo' => [ - 'summary' => '查询Spark应用诊断信息。', - 'methods' => [ - 'post', - 'get', + 'title' => '查询建表语句', + 'summary' => '查询建表语句。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2025-05-07T05:42:07.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-10-25T05:36:00.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-03-22T02:16:05.000Z', 'description' => '错误码发生变更、响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetTableDDL'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getTableDDL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"863D51B7-5321-41D8-A0B6-A088B0******\\",\\n \\"SQL\\": \\"create table (\\\\n id varchar(32)\\\\n);\\"\\n}","errorExample":""},{"type":"xml","example":"<GetTableDDLResponse>\\n <RequestId>863D51B7-5321-41D8-A0B6-A088B0******</RequestId>\\n <SQL>create table (\\n id varchar(32)\\n);</SQL>\\n</GetTableDDLResponse>","errorExample":""}]', + ], + 'GetTableObjects' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -32049,185 +22719,174 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '189113', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '157079', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ + 'name' => 'SchemaName', + 'in' => 'query', + 'schema' => ['description' => '数据库名称。'."\n" + .' '."\n", 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], + ], + [ + 'name' => 'OrderBy', + 'in' => 'query', + 'schema' => ['description' => '排序字段。'."\n" + .'类型取值：'."\n" + .'- Asc；'."\n" + .'- Desc；'."\n" + ."\n" + .'域取值：'."\n" + .'-TableName；'."\n" + .'-TableSize；'."\n" + .'-CreateTime;'."\n" + .'-UpdateTime;'."\n" + ."\n" + .'默认值：{"Type": "Desc","Field": "TableName"}；'."\n" + ."\n", 'type' => 'string', 'required' => false, 'example' => '{"Type": "Desc","Field": "TableName"}'], + ], + [ + 'name' => 'FilterTblName', + 'in' => 'query', + 'schema' => ['description' => '表名。', 'type' => 'string', 'required' => false, 'example' => 'test_tbl'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1', 'default' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '每页记录数，取值：'."\n" + ."\n" + .'- 30；'."\n" + .'- 50；'."\n" + .'- 100；'."\n" + ."\n" + .'默认值：30。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '30', 'default' => '30'], + ], + [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~98094~~)接口查看目标地域下所有的集群信息，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-uf663j39b0jd2***', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1565u55p32****'], ], [ - 'name' => 'RegionId', + 'name' => 'FilterTblType', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '表类型。'."\n" + .'取值：'."\n" + ."\n" + .'-DIMENSION_TABLE'."\n" + ."\n" + .'-FACT_TABLE'."\n" + ."\n" + .'-EXTERNAL_TABLE'."\n" + ."\n" + .'默认值：空', 'type' => 'string', 'required' => false, 'example' => 'FACT_TABLE'], ], [ - 'name' => 'AppId', + 'name' => 'FilterOwner', 'in' => 'query', - 'schema' => [ - 'description' => '应用ID。'."\n" - ."\n" - .'> 您可以调用[ListSparkApps](~~455888~~)接口查询所有的应用ID。', - 'type' => 'string', - 'required' => true, - 'example' => 's202411061017sh0ad564b000****', - ], + 'schema' => ['description' => '所有者。', 'type' => 'string', 'required' => false, 'example' => 'admin'], ], [ - 'name' => 'Language', + 'name' => 'FilterDescription', 'in' => 'query', - 'schema' => [ - 'description' => '语言类型，返回结果将以该语言展示。取值如下： '."\n" - ."\n" - .'- en：英文 '."\n" - .'- zh（默认值）：中文', - 'type' => 'string', - 'deprecated' => false, - 'required' => true, - 'example' => 'zh', - ], + 'schema' => ['description' => '描述。', 'type' => 'string', 'required' => false, 'example' => 'description'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'FB5AC339-91F6-5000-8E5A-F47065B01B87', - ], - 'AppId' => [ - 'description' => '应用ID。'."\n" - .'> 您可以调用[ListSparkApps](~~455888~~)接口查询所有的应用ID。', - 'type' => 'string', - 'example' => 's202404141952sz6a1391200****', - ], - 'StartedTime' => [ - 'description' => '执行开始时间。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1718329831000', - ], - 'DurationInMillis' => [ - 'description' => 'Spark应用执行耗时，单位毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '281063', - ], - 'State' => [ - 'description' => '需要查询的异步导入或导出任务的状态，取值说明如下：'."\n" - .'* **RUNNING**：任务进行中。'."\n" - .'* **FINISHED**：任务执行成功。'."\n" - .'* **FAILED**：任务执行失败。', - 'type' => 'string', - 'example' => 'FINISHED', - ], - 'CpuUtilization' => [ - 'description' => 'CPU使用率。单位为百分比（%）。', - 'type' => 'number', - 'format' => 'double', - 'example' => '100', - ], - 'PeakMemoryInByte' => [ - 'description' => '峰值内存使用量，单位是Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4096000', - ], - 'ShuffleWriteInByte' => [ - 'description' => 'Shuffle写过程的数据量，单位是Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4096000', - ], - 'ShuffleReadInByte' => [ - 'description' => 'Shuffle读过程涉及到的数据量，单位是Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4096000', - ], - 'SpillInByte' => [ - 'description' => '内存不足时，交换写入到磁盘的数据量，单位是Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'JVMGcCostInMillis' => [ - 'description' => 'Java虚拟机执行垃圾回收操作的耗时，单位是毫秒。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '81055', - ], - 'DiagnosisInfoList' => [ - 'description' => 'Spark分析信息列表。', - 'type' => 'array', - 'items' => [ - 'description' => 'Spark分析信息。', - '$ref' => '#/components/schemas/Adb4MysqlSparkDiagnosisInfo', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '863D51B7-5321-41D8-A0B6-A088B0******'], + 'PageNumber' => ['description' => '页码，取值为正整数。默认值为**1**。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'Data' => [ + 'description' => '返回数据。', + 'type' => 'object', + 'properties' => [ + 'PageNumber' => ['description' => '页码，取值为正整数。默认值为**1**。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'TableSummaryModels' => [ + 'description' => '结果数组。', + 'type' => 'array', + 'items' => ['description' => '表概要信息。', '$ref' => '#/components/schemas/TableSummaryModel'], + ], ], ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', - ], ], ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '查询表信息', + 'summary' => '查询表信息。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2025-05-07T05:42:08.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2024-08-20T09:30:04.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-10-25T05:36:00.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-03-22T02:16:05.000Z', 'description' => '错误码发生变更、响应参数发生变更'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FB5AC339-91F6-5000-8E5A-F47065B01B87\\",\\n \\"AppId\\": \\"s202404141952sz6a1391200****\\",\\n \\"StartedTime\\": 1718329831000,\\n \\"DurationInMillis\\": 281063,\\n \\"State\\": \\"FINISHED\\",\\n \\"CpuUtilization\\": 100,\\n \\"PeakMemoryInByte\\": 4096000,\\n \\"ShuffleWriteInByte\\": 4096000,\\n \\"ShuffleReadInByte\\": 4096000,\\n \\"SpillInByte\\": 0,\\n \\"JVMGcCostInMillis\\": 81055,\\n \\"DiagnosisInfoList\\": [\\n {\\n \\"DiagnosisType\\": \\"APPLICATION\\",\\n \\"DiagnosisCode\\": \\"\\",\\n \\"DiagnosisCodeLabel\\": \\"\\",\\n \\"DiagnosisMsg\\": \\"\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', - 'title' => '查询Spark应用诊断信息', - ], - 'EnableAdviceService' => [ - 'summary' => '用EnableAdviceService来开启建议服务。', - 'methods' => [ - 'post', - 'get', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetTableObjects'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getTableObjects', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"863D51B7-5321-41D8-A0B6-A088B0******\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"TableSummaryModels\\": [\\n {\\n \\"SchemaName\\": \\"schemaName\\",\\n \\"TableName\\": \\"tableName\\",\\n \\"TableType\\": \\"PHYSICAL_SCHEMA_NAME\\",\\n \\"TableSize\\": 1234,\\n \\"CreateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"UpdateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"SQL\\": \\"create table(a varchar)\\",\\n \\"Description\\": \\"descrtiption\\",\\n \\"Owner\\": \\"abc\\",\\n \\"MvDetailModel\\": {\\n \\"FirstRefreshTime\\": \\"2025-01-01 09:00:00\\",\\n \\"QueryRewriteEnabled\\": false,\\n \\"ExplicitHit\\": 5,\\n \\"IsInactive\\": false,\\n \\"RemoteSize\\": 1234,\\n \\"LocalSize\\": 1234,\\n \\"RefreshState\\": \\"FAST\\",\\n \\"RefreshInterval\\": \\"(now() + INTERVAL \'10\' SECOND)\\",\\n \\"ImplicitHit\\": 20,\\n \\"UpdatedAt\\": \\"2025-01-01 10:00:00\\",\\n \\"ResourceGroup\\": \\"user_default\\",\\n \\"BaseTableInfos\\": [\\n {\\n \\"SchemaName\\": \\"test_db\\",\\n \\"TableName\\": \\"test_tbl\\",\\n \\"BaseTableIsMv\\": false,\\n \\"TableEngine\\": \\"XUANWU\\"\\n }\\n ],\\n \\"TableEngine\\": \\"XUANWU\\",\\n \\"BaseTableNames\\": [\\n [\\n \\"t1\\"\\n ]\\n ],\\n \\"EnableDelayAlert\\": 0,\\n \\"EnableFailureAlert\\": 0,\\n \\"LatencyTolerance\\": 2\\n },\\n \\"CreatedBySource\\": \\"\\",\\n \\"CreatedByUser\\": \\"\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetTableObjectsResponse>\\n <RequestId>863D51B7-5321-41D8-A0B6-A088B0******</RequestId>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n <Data>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n <TableSummaryModels/>\\n </Data>\\n</GetTableObjectsResponse>","errorExample":""}]', + ], + 'GetViewDDL' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -32236,71 +22895,101 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '157089', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ + 'name' => 'SchemaName', + 'in' => 'query', + 'schema' => ['description' => '数据库名。', 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], + ], + [ + 'name' => 'ViewName', + 'in' => 'query', + 'schema' => ['description' => '视图名称。', 'type' => 'string', 'required' => false, 'example' => 'v_modbus'], + ], + [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1q10xxzq2z4****', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1ub9grke1****'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-shanghai', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '详情。', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'E1745C03-7CCE-55CF-932E-08121AAFA6AF', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '421794A3-72A5-5D27-9E8B-A75A4C503E17'], + 'SQL' => ['description' => 'SQL语句详情。', 'type' => 'string', 'example' => 'CREATE VIEW `test`.`test_view` AS SELECT'."\n" + .' `id`'."\n" + .', `name`'."\n" + .'FROM'."\n" + .' `test_tbl_adb`'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"E1745C03-7CCE-55CF-932E-08121AAFA6AF\\"\\n}","type":"json"}]', - 'title' => '开通建议服务', - ], - 'DescribeAppliedAdvices' => [ - 'summary' => '显示已采纳的优化建议。', - 'methods' => [ - 'post', - 'get', + 'title' => '查询视图的创建语句', + 'summary' => '查询视图的创建语句。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2025-05-07T05:42:07.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-10-25T05:36:00.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-03-22T02:16:05.000Z', 'description' => '错误码发生变更、响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetViewDDL'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getViewDDL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"421794A3-72A5-5D27-9E8B-A75A4C503E17\\",\\n \\"SQL\\": \\"CREATE VIEW `test`.`test_view` AS SELECT\\\\n `id`\\\\n, `name`\\\\nFROM\\\\n `test_tbl_adb`\\"\\n}","errorExample":""},{"type":"xml","example":"<GetViewDDLResponse>\\n <RequestId>421794A3-72A5-5D27-9E8B-A75A4C503E17</RequestId>\\n <SQL>CREATE VIEW `test`.`test_view` AS SELECT\\n `id`\\n, `name`\\nFROM\\n `test_tbl_adb`</SQL>\\n</GetViewDDLResponse>","errorExample":""}]', + ], + 'GetViewObjects' => [ + 'summary' => '查询视图信息。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -32312,394 +23001,252 @@ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '193678', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '157080', + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-uf6g8w25jacm7****', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1xxxxxxxx47'], ], [ - 'name' => 'RegionId', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '数据库名称。'."\n" + .' '."\n", 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], ], [ - 'name' => 'StartTime', + 'name' => 'OrderBy', 'in' => 'query', - 'schema' => [ - 'title' => 'StartTime', - 'description' => '查询建议的开始日期，格式为 yyyyMMdd。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '20220811', - ], + 'schema' => ['description' => '排序字段。'."\n" + .'类型取值：'."\n" + .'- Asc；'."\n" + .'- Desc；'."\n" + ."\n" + .'域取值：'."\n" + .'-ViewName；'."\n" + ."\n" + .'-CreateTime;'."\n" + ."\n" + .'-UpdateTime;'."\n" + ."\n" + .'默认值：{"Type": "Desc","Field": "ViewName"}；', 'type' => 'string', 'required' => false, 'example' => '{"Type": "Desc","Field": "ViewName"}'], ], [ - 'name' => 'EndTime', + 'name' => 'FilterViewName', 'in' => 'query', - 'schema' => [ - 'title' => 'EndTime', - 'description' => '查询建议的结束日期，格式为 yyyyMMdd。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '20220824', - ], + 'schema' => ['description' => '视图名称。', 'type' => 'string', 'required' => false, 'example' => 'test_filter'], ], [ - 'name' => 'Lang', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'title' => 'Lang', - 'description' => '设置建议的显示语言，取值说明：'."\n" - .'- **zh**：简体中文（默认语言）。'."\n" - .'- **en**：英文。'."\n" - .'- **ja**：日文。'."\n" - .'- **zh-tw**：繁体中文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', - ], + 'schema' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1', 'default' => '1'], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'title' => 'PageSize', - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '30', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'title' => 'PageNumber', - 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['description' => '每页记录数，取值范围如下：'."\n" + .'* **30**（默认值）。'."\n" + .'* **50**。'."\n" + .'* **100**。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '30', 'default' => '30'], ], [ - 'name' => 'AdviceType', + 'name' => 'FilterViewType', 'in' => 'query', - 'schema' => [ - 'description' => '建议的类型，取值说明：'."\n" - .'- **INDEX**：索引优化。'."\n" - .'- **TIERING**：冷热数据优化。', - 'type' => 'string', - 'required' => false, - 'example' => 'INDEX', - ], + 'schema' => ['description' => '视图类型。'."\n" + ."\n" + .'取值：'."\n" + ."\n" + .'-VIRTUAL_VIEW'."\n" + ."\n" + .'-MATERIALIZED_VIEW'."\n" + ."\n\n" + .'默认值：空', 'type' => 'string', 'required' => false, 'example' => 'VIRTUAL_VIEW'], ], [ - 'name' => 'Keyword', + 'name' => 'FilterOwner', 'in' => 'query', - 'schema' => [ - 'description' => '查询关键字，支持根据表名模糊搜索。', - 'type' => 'string', - 'required' => false, - 'example' => 'you_table_name', - ], + 'schema' => ['description' => '所有者。', 'type' => 'string', 'required' => false, 'example' => 'admin'], ], [ - 'name' => 'SchemaTableName', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库名和表名。格式为**数据库.表**。', - 'type' => 'string', - 'required' => false, - 'example' => 'tpch.lineitem', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'Order', + 'name' => 'ShowMvBaseTable', 'in' => 'query', - 'schema' => [ - 'description' => '将查询结果按指定字段进行排序。格式为JSON字符串，例如`[{"Field":"SchemaName","Type":"Asc"}]`。其中：'."\n" - .'- `Field`表示排序字段。支持如下取值：'."\n" - .' - `SchemaName`：数据库名。'."\n" - .' - `TableName`：表名。'."\n" - .' - `JobStatus`：表Build任务状态。'."\n" - .' - `SubmitTime`：建议下发的时间。'."\n" - .' - `Benefit`：预期优化收益。'."\n" - .'- `Type`表示排序方式。支持如下取值：'."\n" - .' - `Asc`：升序排序。'."\n" - .' - `Desc`： 降序排序。'."\n" - ."\n" - .'> 若不设置参数，默认按照优化建议下发的时间降序排列。', - 'type' => 'string', - 'required' => false, - 'example' => '[{\\"Field\\":\\"AdviceType\\",\\"Type\\":\\"Desc\\"}]', - ], + 'schema' => ['description' => '是否展示物化视图基表信息。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回对象。', + 'title' => 'Schema of Response', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'Items' => [ - 'title' => 'Items', - 'description' => '详情。', - 'type' => 'array', - 'items' => [ - 'description' => '建议列表。', - 'type' => 'object', - 'properties' => [ - 'AdviceId' => [ - 'title' => 'AdviceId', - 'description' => '建议ID。', - 'type' => 'string', - 'example' => '7417db9c-914d-43f3-a123-4d0e448f****', - ], - 'SubmitTime' => [ - 'title' => 'SubmitTime', - 'description' => '建议下发的时间，格式：yyMMddHHmm（UTC时间）。', - 'type' => 'string', - 'example' => '2208131600', - ], - 'SubmitStatus' => [ - 'title' => 'SubmitStatus', - 'description' => '建议的下发状态。'."\n" - .'取值说明：'."\n" - .'- **SUCCEED**：成功。'."\n" - .'- **FAILED**：失败。', - 'type' => 'string', - 'example' => 'SUCCEED', - ], - 'SQL' => [ - 'title' => 'SQL', - 'description' => '应用建议的SQL语句。', - 'type' => 'string', - 'example' => 'alter table `schema1`.`table1` drop key col1_1_idx', - ], - 'RollbackSQL' => [ - 'title' => 'RollbackSQL', - 'description' => '回滚建议的SQL语句。', - 'type' => 'string', - 'example' => 'alter table `schema1`.`table1` add key col1_1_idx(col1)', - ], - 'JobStatus' => [ - 'title' => 'JobStatus', - 'description' => '执行建议的任务的状态。'."\n" - .'取值说明：'."\n" - .'- **SUCCEED**：成功。'."\n" - .'- **FAILED**：失败。', - 'type' => 'string', - 'example' => 'SUCCEED', - ], - 'Benefit' => [ - 'title' => 'Benefit', - 'description' => '建议的收益。', - 'type' => 'string', - 'example' => '节省0.4 GB的存储空间', - ], - 'BuildSQL' => [ - 'title' => 'Benefit', - 'description' => '执行Build任务的SQL语句。', - 'type' => 'string', - 'example' => 'build table `schema1`.`table1`', - ], - 'TotalCount' => [ - 'title' => 'TotalCount', - 'description' => '返回的结果总数，取值为：大于等于0且不超过Integer数据类型的最大值，默认值为0。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'title' => 'PageSize', - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'PageNumber' => [ - 'title' => 'PageNumber', - 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'SchemaName' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - 'TableName' => [ - 'description' => '表名。', - 'type' => 'string', - 'example' => 'test', - ], - 'IndexFields' => [ - 'type' => 'string', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'PageNumber' => ['description' => '页码，取值为大于0且不超过Integer数据类型最大值的正整数。默认值为**1**。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数，取值范围如下：'."\n" + .'* **30**（默认值）。'."\n" + .'* **50**。'."\n" + .'* **100**。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'Data' => [ + 'description' => '返回结构体。', + 'type' => 'object', + 'properties' => [ + 'PageNumber' => ['description' => '页码，取值为大于0且不超过Integer数据类型最大值的正整数。默认值为**1**。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数，取值范围如下：'."\n" + .'* **30**（默认值）。'."\n" + .'* **50**。'."\n" + .'* **100**。', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'TableSummaryModels' => [ + 'description' => '结果数组。', + 'type' => 'array', + 'items' => ['description' => '视图概要信息。', '$ref' => '#/components/schemas/TableSummaryModel'], ], ], ], - 'PageNumber' => [ - 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '84489769-3065-5A28-A4CB-977CD426F1C3', - ], - 'TotalCount' => [ - 'description' => '返回的结果总数，取值为：大于等于0且不超过Integer数据类型的最大值，默认值为0。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'SchemaTableNames' => [ - 'description' => '数据库名和表名的字符串拼接。', - 'type' => 'array', - 'items' => [ - 'description' => '数据库名和表名的字符串拼接。', - 'type' => 'string', - 'example' => '['."\n" - .' "tpch.lineitem",'."\n" - .' "tpch.partsupp",'."\n" - .' "tpch.orders"'."\n" - .']', - ], - ], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], + ], + ], + 'title' => '查询视图信息', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'changeSet' => [ + ['createdAt' => '2025-07-28T15:32:08.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2025-05-07T05:42:07.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2025-04-10T10:59:24.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-10-25T05:36:00.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-03-22T02:16:05.000Z', 'description' => '错误码发生变更、响应参数发生变更'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Items\\": [\\n {\\n \\"AdviceId\\": \\"7417db9c-914d-43f3-a123-4d0e448f****\\",\\n \\"SubmitTime\\": \\"2208131600\\",\\n \\"SubmitStatus\\": \\"SUCCEED\\",\\n \\"SQL\\": \\"alter table `schema1`.`table1` drop key col1_1_idx\\",\\n \\"RollbackSQL\\": \\"alter table `schema1`.`table1` add key col1_1_idx(col1)\\",\\n \\"JobStatus\\": \\"SUCCEED\\",\\n \\"Benefit\\": \\"节省0.4 GB的存储空间\\",\\n \\"BuildSQL\\": \\"build table `schema1`.`table1`\\",\\n \\"TotalCount\\": 1,\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"SchemaName\\": \\"adb_demo\\",\\n \\"TableName\\": \\"test\\",\\n \\"IndexFields\\": \\"\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"84489769-3065-5A28-A4CB-977CD426F1C3\\",\\n \\"TotalCount\\": 1,\\n \\"SchemaTableNames\\": [\\n \\"[\\\\n \\\\\\"tpch.lineitem\\\\\\",\\\\n \\\\\\"tpch.partsupp\\\\\\",\\\\n \\\\\\"tpch.orders\\\\\\"\\\\n]\\"\\n ]\\n}","type":"json"}]', - 'title' => '显示已采纳的优化', - ], - 'DisableAdviceService' => [ - 'summary' => '用DisableAdviceService来关闭建议服务。', - 'methods' => [ - 'post', - 'get', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetViewObjects'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getViewObjects', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"Data\\": {\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"TableSummaryModels\\": [\\n {\\n \\"SchemaName\\": \\"schemaName\\",\\n \\"TableName\\": \\"tableName\\",\\n \\"TableType\\": \\"PHYSICAL_SCHEMA_NAME\\",\\n \\"TableSize\\": 1234,\\n \\"CreateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"UpdateTime\\": \\"2023-01-05 13:17:55\\",\\n \\"SQL\\": \\"create table(a varchar)\\",\\n \\"Description\\": \\"descrtiption\\",\\n \\"Owner\\": \\"abc\\",\\n \\"MvDetailModel\\": {\\n \\"FirstRefreshTime\\": \\"2025-01-01 09:00:00\\",\\n \\"QueryRewriteEnabled\\": false,\\n \\"ExplicitHit\\": 5,\\n \\"IsInactive\\": false,\\n \\"RemoteSize\\": 1234,\\n \\"LocalSize\\": 1234,\\n \\"RefreshState\\": \\"FAST\\",\\n \\"RefreshInterval\\": \\"(now() + INTERVAL \'10\' SECOND)\\",\\n \\"ImplicitHit\\": 20,\\n \\"UpdatedAt\\": \\"2025-01-01 10:00:00\\",\\n \\"ResourceGroup\\": \\"user_default\\",\\n \\"BaseTableInfos\\": [\\n {\\n \\"SchemaName\\": \\"test_db\\",\\n \\"TableName\\": \\"test_tbl\\",\\n \\"BaseTableIsMv\\": false,\\n \\"TableEngine\\": \\"XUANWU\\"\\n }\\n ],\\n \\"TableEngine\\": \\"XUANWU\\",\\n \\"BaseTableNames\\": [\\n [\\n \\"t1\\"\\n ]\\n ],\\n \\"EnableDelayAlert\\": 0,\\n \\"EnableFailureAlert\\": 0,\\n \\"LatencyTolerance\\": 2\\n },\\n \\"CreatedBySource\\": \\"\\",\\n \\"CreatedByUser\\": \\"\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetViewObjectsResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n <Data>\\n <PageNumber>1</PageNumber>\\n <PageSize>30</PageSize>\\n <TotalCount>1</TotalCount>\\n <TableSummaryModels/>\\n </Data>\\n</GetViewObjectsResponse>","errorExample":""}]', + ], + 'GrantOperatorPermission' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '214575', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-uf67culrr26q2****', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1565u55p32****'], ], [ - 'name' => 'RegionId', + 'name' => 'ExpiredTime', + 'in' => 'query', + 'schema' => ['description' => '服务账号权限过期时间。UTC时间，格式为yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2022-11-30T00:00:00Z'], + ], + [ + 'name' => 'Privileges', 'in' => 'query', 'schema' => [ - 'description' => '地域ID。', + 'description' => '权限名称。取值说明：'."\n" + .'- **Control**：配置权限，查看和修改集群配置。'."\n" + .'- **Data**：数据权限，查看表结构、索引和SQL。', 'type' => 'string', 'required' => true, - 'example' => 'cn-shanghai', + 'docRequired' => true, + 'enumValueTitles' => ['Control' => 'Control', 'Data' => 'Data'], + 'example' => 'Control', ], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '详情。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '57EC6CCA-A582-572C-A33D-F61845CBC03C', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A438072A-E2E7-5509-9A3F-66293512A820'], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'RelatedTaskNotFinish', 'errorMessage' => 'The related task does not finish.', 'description' => '关联任务未完成，禁止该操作。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"57EC6CCA-A582-572C-A33D-F61845CBC03C\\"\\n}","type":"json"}]', - 'title' => '关闭建议服务', - ], - 'BatchApplyAdviceByIdList' => [ - 'summary' => '批量应用优化建议。', - 'methods' => [ - 'post', - 'get', + 'title' => '授予服务账号权限', + 'summary' => '用户授予服务账号权限，供值班定位问题。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GrantOperatorPermission'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:GrantOperatorPermission', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"A438072A-E2E7-5509-9A3F-66293512A820\\"\\n}","type":"json"}]', + ], + 'KillProcess' => [ + 'methods' => ['get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -32708,74 +23255,32 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '193683', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '189978', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-uf6g8w25jacm7****', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-xxxx'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => 'regionId', - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'AdviceIdList', - 'in' => 'query', - 'schema' => [ - 'description' => '待批量应用的建议 ID 列表，多个建议 ID 之间用半角逗号（,）分隔。', - 'type' => 'string', - 'required' => false, - 'example' => 'c2589ff3-e86c-4f19-80c8-2aeb7dd9****,53414470-ebf4-4a53-a312-8a1ad8fd****,6e8dce84-fec8-4b0b-9c04-b0cea12c****,b3b9703d-55ca-47e0-96dd-6a4a9dbf****', - ], - ], - [ - 'name' => 'AdviceDate', - 'in' => 'query', - 'schema' => [ - 'title' => 'AdviceDate', - 'description' => '建议生成的日期。格式：yyyyMMdd。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '20221115', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'>您可以调用[DescribeRegions](~~143074~~)接口查看可用地域的地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'ApplyType', - 'in' => 'query', - 'schema' => [ - 'type' => 'string', - 'required' => false, - ], - ], - [ - 'name' => 'BuildImmediately', + 'name' => 'ProcessId', 'in' => 'query', - 'schema' => [ - 'type' => 'boolean', - 'required' => false, - ], + 'schema' => ['description' => '任务ID。'."\n" + .'> 您可以调用[DescribeProcessList](~~612277~~)接口查看目标SQL的任务ID。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '202011191048151921681492420315100****'], ], ], 'responses' => [ @@ -32783,469 +23288,409 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求id。', - 'type' => 'string', - 'example' => '86F92D26-B774-5FA1-8E53-82CBEEEBB012', - 'title' => 'Id of the request', - ], + 'RequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], ], - 'title' => 'Schema of Response', + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '终止正在进行的任务', + 'summary' => '调用KillProcess接口终止正在进行的任务。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'KillProcess'], + ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:KillProcess', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"SUCCESS\\",\\n \\"RequestId\\": \\"86F92D26-B774-5FA1-8E53-82CBEEEBB012\\"\\n}","type":"json"}]', - 'title' => '批量应用优化建议', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', ], - 'ApplyAdviceById' => [ - 'summary' => '应用单条优化建议。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'KillSparkApp' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '193679', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - ], + 'systemTags' => ['operationType' => 'delete'], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-uf6g8w25jacm7****', - ], + 'name' => 'AppId', + 'in' => 'formData', + 'schema' => ['title' => 'Spark App的ID', 'description' => '需要停止的AppID。', 'type' => 'string', 'required' => true, 'example' => 's202204132018hzprec1ac****', 'maxLength' => 64], ], [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'title' => 'regionId', - 'description' => '地域 ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群的集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-bp1ub9grke1****'], ], - [ - 'name' => 'AdviceId', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'title' => 'AdviceId', - 'description' => '建议 ID。', - 'type' => 'string', - 'required' => false, - 'example' => '0baf1f52-53df-487f-8292-99a03716****', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '69D0810B-F9F5-5F4C-A57F-DF36133B63C9'], + 'Data' => [ + 'description' => '返回结果。', + 'type' => 'object', + 'properties' => [ + 'AppId' => ['title' => 'Spark App的ID', 'description' => '停止执行的AppID。', 'type' => 'string', 'example' => 's202204132018hzprec1ac****'], + 'AppName' => ['title' => 'Spark App的名称', 'description' => '任务名称。', 'type' => 'string', 'example' => 'test'], + 'Message' => ['title' => '特殊注释信息', 'description' => '分析失败时错误信息。', 'type' => 'string', 'example' => '[Advisor] Advisor feature is not available for instance: amv-bp11q28kvl688****'], + 'State' => ['title' => 'App的状态信息', 'description' => '应用执行状态，取值说明：'."\n" + .'- **SUBMITTED**：已提交。'."\n" + .'- **STARTING**：开始启动。'."\n" + .'- **RUNNING**：执行中。'."\n" + .'- **FAILING**：任务失败，清理环境中。'."\n" + .'- **FAILED**：失败。'."\n" + .'- **KILLING**：中止任务，清理环境中。'."\n" + .'- **KILLED**：中止任务。'."\n" + .'- **SUCCEEDING**：任务执行结束，清理环境中。'."\n" + .'- **COMPLETED**：已完成。'."\n" + .'- **FATAL**：意外失败。'."\n" + .'- **UNKNOWN**：未知错误。', 'type' => 'string', 'example' => 'KILLED'], + 'DBClusterId' => ['title' => '数据库ID', 'description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp11q28kvl688****', 'default' => 'DB_CLUSTER_ID'], + ], + ], + ], + 'description' => '', ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.App.KillOperationFailed', 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', 'description' => '杀死 Spark 应用失败，请稍后重试。'], + ], + 404 => [ + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ], + 406 => [ + ['errorCode' => 'Spark.App.KillNotAcceptable', 'errorMessage' => 'Can\'t kill the application %s in %s state.', 'description' => '不能删除处于不可删除状态下的 Spark 应用。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], + ], + 'title' => '强行停止运行中的Spark作业', + 'summary' => '强行停止运行中的Spark作业。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-11-24T09:19:25.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-06-28T01:10:31.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'KillSparkApp'], + ], + ], + 'ramActions' => [ [ - 'name' => 'AdviceDate', - 'in' => 'query', - 'schema' => [ - 'title' => 'AdviceDate', - 'description' => '建议生成的日期。格式：yyyyMMdd', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '20221101', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:KillSparkApp', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"69D0810B-F9F5-5F4C-A57F-DF36133B63C9\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202204132018hzprec1ac****\\",\\n \\"AppName\\": \\"test\\",\\n \\"Message\\": \\"[Advisor] Advisor feature is not available for instance: amv-bp11q28kvl688****\\",\\n \\"State\\": \\"KILLED\\",\\n \\"DBClusterId\\": \\"amv-bp11q28kvl688****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<KillSparkAppResponse>\\n <RequestId>69D0810B-F9F5-5F4C-A57F-DF36133B63C9</RequestId>\\n <Data>\\n <AppId>s202204132018hzprec1ac****</AppId>\\n <AppName>test</AppName>\\n <Message>[Advisor] Advisor feature is not available for instance: amv-bp11q28kvl688****</Message>\\n <State>running</State>\\n <DBClusterId>amv-bp11q28kvl688****</DBClusterId>\\n </Data>\\n</KillSparkAppResponse>","errorExample":""}]', + ], + 'KillSparkLogAnalyzeTask' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'ApplyType', - 'in' => 'query', - 'schema' => [ - 'type' => 'string', - 'required' => false, - ], + 'AK' => [], ], + ], + 'deprecated' => false, + 'systemTags' => ['operationType' => 'delete', 'riskType' => 'high', 'chargeType' => 'free'], + 'parameters' => [ [ - 'name' => 'BuildImmediately', - 'in' => 'query', - 'schema' => [ - 'type' => 'boolean', - 'required' => false, - ], + 'name' => 'TaskId', + 'in' => 'formData', + 'schema' => ['title' => 'Spark日志分析任务ID'."\n", 'description' => 'Spark日志分析任务ID。可以通过调用ListSparkLogAnalyzeTasks查询当前集群中所有的分析任务的ID和状态。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'minimum' => '0', 'example' => '15'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求id。', - 'type' => 'string', - 'example' => '5DC10091-348D-12B1-906D-AB49D658012E', - 'title' => 'Id of the request', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1DF5AF5B-C803-1861-A0FF-63666A557709'], + 'Data' => ['description' => 'Spark日志分析任务详情。', '$ref' => '#/components/schemas/SparkAnalyzeLogTask'], ], - 'title' => 'Schema of Response', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"SUCCESS\\",\\n \\"RequestId\\": \\"5DC10091-348D-12B1-906D-AB49D658012E\\"\\n}","type":"json"}]', - 'title' => '应用单条优化建议', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeAvailableAdvices' => [ - 'summary' => '用DescribeAvailableAdvices来显示可用优化建议。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '终止Spark日志分析任务', + 'summary' => '终止一个Spark分析任务，返回尝试终止后的任务详情。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-07-27T06:45:55.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'KillSparkLogAnalyzeTask'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:KillSparkLogAnalyzeTask', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/task/{#SparkTaskId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1DF5AF5B-C803-1861-A0FF-63666A557709\\",\\n \\"Data\\": {\\n \\"TaskId\\": 10,\\n \\"UserId\\": 0,\\n \\"SubmittedTimeInMillis\\": 1672123543000,\\n \\"TerminatedTimeInMillis\\": 1672123543000,\\n \\"TaskState\\": \\"WAITING\\",\\n \\"Result\\": {\\n \\"AppErrorCode\\": \\"EXCEEDED_QUOTA\\",\\n \\"AppErrorLog\\": \\"exception: cpu is exceeded limits 12/10\\",\\n \\"AppErrorAdvice\\": \\"Please increase cpu quota for your resource group\\"\\n },\\n \\"StartedTimeInMillis\\": 1672123543000,\\n \\"RuleMatched\\": true,\\n \\"TaskErrMsg\\": \\"Driver log not found\\",\\n \\"DBClusterId\\": \\"amv-adbxxxxx\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<KillSparkLogAnalyzeTaskResponse>\\n <RequestId>1DF5AF5B-C803-1861-A0FF-63666A557709</RequestId>\\n <Data>\\n <TaskId>10</TaskId>\\n <SubmittedTimeInMillis>1672123543000</SubmittedTimeInMillis>\\n <TerminatedTimeInMillis>1672123543000</TerminatedTimeInMillis>\\n <TaskState>WAITING</TaskState>\\n <Result>\\n <AppErrorCode>EXCEEDED_QUOTA</AppErrorCode>\\n <AppErrorLog>exception: xxxx</AppErrorLog>\\n </Result>\\n <StartedTimeInMillis>1672123543000</StartedTimeInMillis>\\n <RuleMatched>true</RuleMatched>\\n <TaskErrMsg>Driver log not found</TaskErrMsg>\\n <DBClusterId>amv-adbxxxxx</DBClusterId>\\n </Data>\\n</KillSparkLogAnalyzeTaskResponse>","errorExample":""}]', + ], + 'KillSparkSQLEngine' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', - 'deprecated' => false, + 'operationType' => 'readAndWrite', + 'deprecated' => true, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '193677', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, + 'abilityTreeCode' => '152585', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-bp198m028ih55****', - ], + 'in' => 'formData', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-8vbn8pq537k8w****'], ], [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'name' => 'ResourceGroupName', + 'in' => 'formData', + 'schema' => ['description' => '资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'spark_test'], ], - [ - 'name' => 'AdviceDate', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'title' => 'AdviceDate', - 'description' => '建议的生成日期，格式为yyyyMMdd。'."\n" - ."\n" - .'> 数据是每天凌晨分析后生成，因此要填T-1以上的时间才查询得到数据。譬如当前是20240627，那么应该传20240626或者更早的时间。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'docRequired' => true, - 'example' => '20221124', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380'], + 'Data' => ['description' => '是否成功。', 'type' => 'boolean', 'example' => 'true'], + ], ], ], - [ - 'name' => 'Lang', - 'in' => 'query', - 'schema' => [ - 'title' => 'Lang', - 'description' => '设置建议的显示语言，取值说明：'."\n" - .'- **zh**：简体中文（默认语言）。'."\n" - .'- **en**：英文。'."\n" - .'- **ja**：日文。'."\n" - .'- **zh-tw**：繁体中文。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'zh', - 'default' => 'zh', - ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.App.KillOperationFailed', 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', 'description' => '杀死 Spark 应用失败，请稍后重试。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], ], [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'title' => 'PageSize', - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'docRequired' => true, - 'example' => '30', - 'default' => '100', - ], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], ], + 406 => [ + ['errorCode' => 'Spark.App.KillNotAcceptable', 'errorMessage' => 'Can\'t kill the application %s in %s state.', 'description' => '不能删除处于不可删除状态下的 Spark 应用。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], + ], + 'staticInfo' => ['noSubstitutionReason' => '无替代API，历史原因导致该API被标记为弃用。', 'returnType' => 'synchronous'], + 'title' => '关闭Spark SQL引擎', + 'summary' => '关闭Spark SQL引擎。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-06-28T01:10:30.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'KillSparkSQLEngine'], + ], + ], + 'ramActions' => [ [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'title' => 'PageNumber', - 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'docRequired' => true, - 'example' => '1', - 'default' => '1', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:KillSparkEngine', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": true\\n}","errorExample":""},{"type":"xml","example":"<KillSparkSQLEngineResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>false</Data>\\n</KillSparkSQLEngineResponse>","errorExample":""}]', + ], + 'ListApsWebhook' => [ + 'path' => '', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'AdviceType', - 'in' => 'query', - 'schema' => [ - 'description' => '建议的类型，取值说明：'."\n" - .'- **INDEX**：索引优化。'."\n" - .'- **TIERING**：冷热数据优化。', - 'type' => 'string', - 'required' => false, - 'example' => 'INDEX', - ], + 'AK' => [], ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsBIVU9O', 'FEATUREadsY28JLD'], + ], + 'parameters' => [ [ - 'name' => 'Keyword', - 'in' => 'query', - 'schema' => [ - 'description' => '查询关键字，支持根据表名模糊搜索。', - 'type' => 'string', - 'required' => false, - 'example' => 'you_table_name', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-8vbuyjhrih**'], ], [ - 'name' => 'SchemaTableName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库名和表名的字符串拼接。', - 'type' => 'string', - 'required' => false, - 'example' => 'tpch.lineitem', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'Order', - 'in' => 'query', - 'schema' => [ - 'description' => '将查询结果按指定字段进行排序。格式为JSON字符串，例如`[{"Field":"SchemaName","Type":"Asc"}]`。其中：'."\n" - .'- `Field`表示排序字段。支持如下取值：'."\n" - .' - `SchemaName`：数据库名。'."\n" - .' - `TableName`：表名。'."\n" - .' - `Benefit`：预期优化收益。'."\n" - .'- `Type`表示排序方式。支持如下取值：'."\n" - .' - `Asc`：升序排序。'."\n" - .' - `Desc`： 降序排序。'."\n" - ."\n" - .'> 若不设置参数，默认按照”预期优化收益“降序排列。', - 'type' => 'string', - 'required' => false, - 'example' => '[{\\"Field\\":\\"AdviceType\\",\\"Type\\":\\"Desc\\"}]', - ], + 'name' => 'JobType', + 'in' => 'formData', + 'schema' => ['description' => '**JobType** '."\n" + .'任务类型SLS/OSS导出任务：ResultExport。', 'type' => 'string', 'required' => false, 'example' => 'ResultExport'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回对象。', + 'description' => '返回消息。', 'type' => 'object', 'properties' => [ - 'Items' => [ - 'title' => 'Items', - 'description' => '详情。', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'exampleRequestId'], + 'HttpStatusCode' => ['description' => 'http状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Message' => ['description' => '返回消息。', 'type' => 'string', 'example' => 'OK'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => '200'], + 'Success' => ['description' => '是否成功。', 'type' => 'boolean', 'example' => 'True'], + 'Webhook' => [ + 'description' => 'Webhook数组。', 'type' => 'array', 'items' => [ - 'description' => '建议列表。', + 'description' => 'Webhook数组。', 'type' => 'object', 'properties' => [ - 'AdviceId' => [ - 'title' => 'AdviceId', - 'description' => '建议ID。', - 'type' => 'string', - 'example' => 'dcd04135-0925-4aed-a5a7-e7d92cb1****', - ], - 'AdviceDate' => [ - 'title' => 'AdviceDate', - 'description' => '建议生成的时间，格式：yyyyMMdd。', - 'type' => 'string', - 'example' => '20221124', - ], - 'AdviceType' => [ - 'title' => 'AdviceType', - 'description' => '建议的类型，取值说明：'."\n" - .'- **INDEX**：索引优化。'."\n" - .'- **TIERING**：冷热数据优化。', - 'type' => 'string', - 'example' => 'INDEX', - ], - 'SQL' => [ - 'title' => 'SQL', - 'description' => '应用建议的SQL语句。', - 'type' => 'string', - 'example' => 'alter table `schema1`.`table1` drop key col1_1_idx', - ], - 'Reason' => [ - 'title' => 'Reason', - 'description' => '生成优化建议的原因。', - 'type' => 'string', - 'example' => '15天未使用，历史使用统计概率小于1%', - ], - 'Benefit' => [ - 'title' => 'Benefit', - 'description' => '建议的收益。', - 'type' => 'string', - 'example' => '节省0.4 GB的存储空间。', - ], - 'TotalCount' => [ - 'title' => 'TotalCount', - 'description' => '返回的结果总数，取值为：大于等于0且不超过Integer数据类型的最大值，默认值为0。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10192', - ], - 'PageSize' => [ - 'title' => 'PageSize', - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'PageNumber' => [ - 'title' => 'PageNumber', - 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'SchemaName' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - 'TableName' => [ - 'description' => '表名。', - 'type' => 'string', - 'example' => 'test_table', - ], - 'IndexFields' => [ - 'type' => 'string', - ], + 'WebhookType' => ['description' => 'Webhook 类型。', 'type' => 'string', 'example' => 'dingtalk'], + 'WebhookId' => ['description' => '要删除的webhook id。', 'type' => 'string', 'example' => '**35***'], + 'Url' => ['description' => '请求地址。', 'type' => 'string', 'example' => 'https://example.com/webhook'], + 'Key' => ['description' => '加签密钥。', 'type' => 'string', 'example' => 'your_secret_key'], + 'Name' => ['description' => 'webhook名称。', 'type' => 'string', 'example' => 'webhook_name'], ], ], ], - 'PageNumber' => [ - 'title' => 'PageNumber', - 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'PageSize' => [ - 'title' => 'PageSize', - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '96A55627-28E9-5E47-B8F6-D786BE551349', - ], - 'TotalCount' => [ - 'description' => '返回的结果总数，取值为：大于等于0且不超过Integer数据类型的最大值，默认值为0。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10192', - ], - 'SchemaTableNames' => [ - 'description' => '数据库名和表名的字符串拼接。', - 'type' => 'array', - 'items' => [ - 'description' => '数据库名和表名的字符串拼接。', - 'type' => 'string', - 'example' => '['."\n" - .' "tpch.lineitem",'."\n" - .' "tpch.partsupp",'."\n" - .' "tpch.orders"'."\n" - .']', - ], - ], ], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'MissingParameter.PageSize', - 'errorMessage' => 'The PageSize parameter is required.', - ], + 'errorCodes' => [], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询Webhook', + 'summary' => '用于查询指定数据库集群下的Webhook配置信息。', + 'description' => '通过此API，您可以根据`RegionId`、`DBClusterId`以及可选的`JobType`来获取已配置的Webhook列表。其中，`JobType`参数指定了任务类型（例如SLS/OSS导出任务），如果提供，则返回与该任务类型相关的Webhook；如果不提供，则返回所有类型的Webhook。'."\n" + ."\n" + .'注意：确保您提供的`RegionId`和`DBClusterId`是正确的，否则可能无法正确获取到Webhook信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListApsWebhook'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:ListApsWebhook', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Items\\": [\\n {\\n \\"AdviceId\\": \\"dcd04135-0925-4aed-a5a7-e7d92cb1****\\",\\n \\"AdviceDate\\": \\"20221124\\",\\n \\"AdviceType\\": \\"INDEX\\",\\n \\"SQL\\": \\"alter table `schema1`.`table1` drop key col1_1_idx\\",\\n \\"Reason\\": \\"15天未使用，历史使用统计概率小于1%\\",\\n \\"Benefit\\": \\"节省0.4 GB的存储空间。\\",\\n \\"TotalCount\\": 10192,\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 1,\\n \\"SchemaName\\": \\"adb_demo\\",\\n \\"TableName\\": \\"test_table\\",\\n \\"IndexFields\\": \\"\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"96A55627-28E9-5E47-B8F6-D786BE551349\\",\\n \\"TotalCount\\": 10192,\\n \\"SchemaTableNames\\": [\\n \\"[\\\\n \\\\\\"tpch.lineitem\\\\\\",\\\\n \\\\\\"tpch.partsupp\\\\\\",\\\\n \\\\\\"tpch.orders\\\\\\"\\\\n]\\"\\n ]\\n}","type":"json"}]', - 'title' => '显示可用优化建议', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"exampleRequestId\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": true,\\n \\"Webhook\\": [\\n {\\n \\"WebhookType\\": \\"dingtalk\\",\\n \\"WebhookId\\": \\"**35***\\",\\n \\"Url\\": \\"https://example.com/webhook\\",\\n \\"Key\\": \\"your_secret_key\\",\\n \\"Name\\": \\"webhook_name\\"\\n }\\n ]\\n}","type":"json"}]', ], - 'DescribeDiagnosisSQLInfo' => [ - 'summary' => '查看某个SQL的执行详情，包括执行计划、运行信息、资源使用、自诊断结果等。', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [], + 'ListLakeStorages' => [ + 'methods' => ['get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -33255,375 +23700,345 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '132343', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '216928', + 'abilityTreeNodes' => ['FEATUREadsQO9FPM'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下AnalyticDB MySQL集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1r053by****', - ], - ], - [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL支持的地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'ProcessId', + 'name' => 'Filter', 'in' => 'query', - 'schema' => [ - 'description' => '查询ID。'."\n" - .'> 您可以调用[DescribeDiagnosisRecords](~~308207~~)接口查看指定的AnalyticDB MySQL集群中SQL摘要信息，包括查询ID。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '20210702164322172016168****', - 'default' => '2023091317073501108614302703151362858', - ], + 'schema' => ['title' => '查询过滤参数，多个过滤参数之间是且的关系。例如:过滤实例名称为i-a123、i-b123，且实例状态为Stopped：&Filter.1.Name=InstanceName&Filter.1.Value.1=i-a123&Filter.1.Value.2=i-b123&Filter.2.Name=Status&Filter.2.Value=Stopped。', 'description' => '查询过滤参数，多个过滤参数之间是且的关系。例如:过滤实例名称为i-a123、i-b123，且实例状态为Stopped：&Filter.1.Name=InstanceName&Filter.1.Value.1=i-a123&Filter.1.Value.2=i-b123&Filter.2.Name=Status&Filter.2.Value=Stopped。', 'type' => 'string', 'required' => false, 'example' => '-'], ], [ - 'name' => 'ProcessStartTime', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => 'SQL语句的执行开始时间，格式为Unix时间戳，单位为毫秒（ms）。'."\n" - .'> 您可以调用[DescribeDiagnosisRecords](~~308207~~)接口查看指定的AnalyticDB MySQL集群中SQL摘要信息，包括SQL语句的执行开始时间。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'docRequired' => true, - 'example' => '1625215402000', - 'default' => '-1', - ], + 'schema' => ['title' => '返回结果的最大个数。', 'description' => '返回结果的最大个数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], ], [ - 'name' => 'ProcessState', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'SQL语句的状态，取值如下：'."\n" - .'- **running**：执行中。'."\n" - .'- **finished**：已完成。'."\n" - .'- **failed**：执行失败。'."\n" - .'> 您可以调用[DescribeDiagnosisRecords](~~308207~~)接口查看指定的AnalyticDB MySQL集群中SQL摘要信息，包括SQL语句的状态信息。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'running', - 'default' => 'running', - ], + 'schema' => ['description' => '每页大小。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30'], ], [ - 'name' => 'Lang', - 'in' => 'query', - 'schema' => [ - 'description' => '设置下载文件的文件标题以及部分错误信息的语言，支持如下语言：'."\n" - .'- **zh**：简体中文。'."\n" - .'- **en**：英文。'."\n" - .'- **ja**：日语。'."\n" - .'- **zh-tw**：繁体中文。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'zh', - ], - ], - [ - 'name' => 'ProcessRcHost', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '执行SQL语句的AnalyticDB MySQL前端节点IP和端口信息。'."\n" - .'> 您可以调用[DescribeDiagnosisRecords](~~308207~~)接口查看指定的AnalyticDB MySQL集群中SQL摘要信息，包括前端节点IP和端口信息。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '192.45.***.***:3145', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-*******'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'DiagnosisSQLInfo' => [ - 'description' => 'SQL的执行详情，包括详细的SQL语句、统计信息、执行计划和算子信息等。', - 'type' => 'string', - 'example' => '{ "DiagnosisSQLInfo": { "hasSharedStage": false, "resourceGroup": "user_default", "cost": 274, "queuedTime": 0, "outputDataSize": 9, "scheduled": true, "query": "/*+display=tpch_q14*/SELECT 100.00 * SUM(CASE WHEN p_type LIKE \'PROMO%\' THEN l_extendedprice * (1 - l_discount) ELSE 0 END) / SUM(l_extendedprice * (1 - l_discount)) AS promo_revenue FROM lineitem l, part p WHERE l_partkey = p_partkey AND l_shipdate >= DATE \'1995-09-01\' AND l_shipdate < DATE \'1995-09-01\' + INTERVAL \'1\' MONTH", "outputRows": 1, "userName": "test_user", "parentId": 0, "maxOutputRows": 200000, "scanSize": 8247470, "peakMemory": 13188295, "startTime": 1626330527632, "state": "FINISHED", "endTime": 1626330527905, "writeTableRows": 0, "scanRows": 351966 } }', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1', - ], - 'StageInfos' => [ - 'description' => '查询的分阶段执行信息。', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '****-964D-****-9D31-****'], + 'TotalCount' => ['title' => '总记录数。', 'description' => '总记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'PageNumber' => ['title' => '当总结果个数大于MaxResults时，用于翻页的token。', 'description' => '当总结果个数大于MaxResults时，用于翻页的token。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '每页大小。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'Items' => [ + 'title' => '数组，返回示例目录。', + 'description' => '数组，返回示例目录。', 'type' => 'array', 'items' => [ - 'description' => '查询的分阶段执行信息。', + 'title' => 'LakeStorageItemType', + 'description' => 'LakeStorageItemType', 'type' => 'object', 'properties' => [ - 'InputRows' => [ - 'description' => 'Stage总的输入行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2341', - ], - 'InputDataSize' => [ - 'description' => 'Stage总的输入数据量，单位为Bytes。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2341', - ], - 'OutputRows' => [ - 'description' => 'Stage总的输出行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2341', - ], - 'OutputDataSize' => [ - 'description' => 'Stage总的输出数据量，单位为Bytes。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2341', - ], - 'PeakMemory' => [ - 'description' => 'Stage总的峰值内存，单位为Bytes。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2341', - ], - 'OperatorCost' => [ - 'description' => 'Stage的算子累积耗时，单位为毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2341', - ], - 'StageId' => [ - 'description' => 'StageID。', - 'type' => 'string', - 'example' => 'Stage[26]', - ], - 'State' => [ - 'description' => 'Stage状态。', - 'type' => 'string', - 'example' => 'RUNNING', - ], - 'Progress' => [ - 'description' => 'Stage的执行进度。', - 'type' => 'number', - 'format' => 'double', - 'example' => '0.3', - ], - 'ExecutionType' => [ - 'type' => 'string', + 'OwnerUid' => ['title' => '拥有者UID', 'description' => '拥有者UID', 'type' => 'string', 'example' => '123456'], + 'DBClusterId' => ['title' => 'ADB实例ID', 'description' => 'ADB实例ID', 'type' => 'string', 'example' => 'amv-*******'], + 'TotalRows' => ['title' => '总数据行数', 'description' => '总数据行数', 'type' => 'integer', 'format' => 'int64', 'example' => '30', 'pattern' => '', 'default' => ''], + 'OperatorUid' => ['title' => '操作者UID', 'description' => '操作者UID', 'type' => 'string', 'example' => '123456'], + 'Permissions' => [ + 'title' => '湖存储权限', + 'description' => '湖存储权限', + 'type' => 'array', + 'items' => [ + 'title' => '权限项', + 'description' => '权限项', + 'type' => 'object', + 'properties' => [ + 'Read' => ['title' => '读权限', 'description' => '读权限', 'type' => 'boolean', 'example' => 'true'], + 'Write' => ['title' => '写权限', 'description' => '写权限', 'type' => 'boolean', 'example' => 'false'], + 'Account' => ['title' => '账户ID', 'description' => '账户ID', 'type' => 'string', 'example' => '-', 'pattern' => '^\\d+$', 'default' => ''], + 'Type' => [ + 'title' => '账户类型', + 'description' => '账户类型', + 'type' => 'string', + 'example' => '-', + 'enum' => ['CUSTOMER', 'SUB', 'STS'], + ], + ], + 'example' => '-', + ], + 'example' => '-', ], + 'TableCount' => ['title' => '库表数量', 'description' => '库表数量', 'type' => 'integer', 'format' => 'int32', 'example' => '30', 'pattern' => '', 'default' => ''], + 'Description' => ['title' => '湖存储描述', 'description' => '湖存储描述', 'type' => 'string', 'example' => 'Create a role to run ROS StackGroups.'], + 'LakeStorageId' => ['title' => '湖存储唯一标识', 'description' => '湖存储唯一标识', 'type' => 'string', 'example' => '-'], + 'CreateTime' => ['title' => '创建时间', 'description' => '创建时间', 'type' => 'string', 'example' => '2021-04-01T09:50:18Z'], + 'TotalStorage' => ['title' => '总存储量', 'description' => '总存储量', 'type' => 'string', 'example' => '111333'], + 'CreatorUid' => ['title' => '创建者UID', 'description' => '创建者UID', 'type' => 'string', 'example' => '123456'], + 'UpdateTime' => ['title' => '更新时间', 'description' => '更新时间', 'type' => 'string', 'example' => '2024-03-15T02:24:32'], + 'RegionId' => ['title' => '区域ID', 'description' => '区域ID', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'FileSize' => ['description' => '数据文件大小。', 'type' => 'string', 'example' => '651'], ], + 'example' => '-', ], + 'example' => '-', ], + 'Success' => ['description' => '预检查结果，返回值说明：'."\n" + ."\n" + .'- **success**：检查通过。'."\n" + .'- **false**：检查不通过。', 'type' => 'boolean', 'example' => 'true'], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Ok**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'Success'], ], ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"DiagnosisSQLInfo\\": \\"{ \\\\\\"DiagnosisSQLInfo\\\\\\": { \\\\\\"hasSharedStage\\\\\\": false, \\\\\\"resourceGroup\\\\\\": \\\\\\"user_default\\\\\\", \\\\\\"cost\\\\\\": 274, \\\\\\"queuedTime\\\\\\": 0, \\\\\\"outputDataSize\\\\\\": 9, \\\\\\"scheduled\\\\\\": true, \\\\\\"query\\\\\\": \\\\\\"/*+display=tpch_q14*/SELECT 100.00 * SUM(CASE WHEN p_type LIKE \'PROMO%\' THEN l_extendedprice * (1 - l_discount) ELSE 0 END) / SUM(l_extendedprice * (1 - l_discount)) AS promo_revenue FROM lineitem l, part p WHERE l_partkey = p_partkey AND l_shipdate >= DATE \'1995-09-01\' AND l_shipdate < DATE \'1995-09-01\' + INTERVAL \'1\' MONTH\\\\\\", \\\\\\"outputRows\\\\\\": 1, \\\\\\"userName\\\\\\": \\\\\\"test_user\\\\\\", \\\\\\"parentId\\\\\\": 0, \\\\\\"maxOutputRows\\\\\\": 200000, \\\\\\"scanSize\\\\\\": 8247470, \\\\\\"peakMemory\\\\\\": 13188295, \\\\\\"startTime\\\\\\": 1626330527632, \\\\\\"state\\\\\\": \\\\\\"FINISHED\\\\\\", \\\\\\"endTime\\\\\\": 1626330527905, \\\\\\"writeTableRows\\\\\\": 0, \\\\\\"scanRows\\\\\\": 351966 } }\\",\\n \\"RequestId\\": \\"1\\",\\n \\"StageInfos\\": [\\n {\\n \\"InputRows\\": 2341,\\n \\"InputDataSize\\": 2341,\\n \\"OutputRows\\": 2341,\\n \\"OutputDataSize\\": 2341,\\n \\"PeakMemory\\": 2341,\\n \\"OperatorCost\\": 2341,\\n \\"StageId\\": \\"Stage[26]\\",\\n \\"State\\": \\"RUNNING\\",\\n \\"Progress\\": 0.3,\\n \\"ExecutionType\\": \\"\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"<DescribeDiagnosisSQLInfoResponse>\\n <DiagnosisSQLInfo>{ \\"DiagnosisSQLInfo\\": { \\"hasSharedStage\\": false, \\"resourceGroup\\": \\"user_default\\", \\"cost\\": 274, \\"queuedTime\\": 0, \\"outputDataSize\\": 9, \\"scheduled\\": true, \\"query\\": \\"/*+display=tpch_q14*/SELECT 100.00 * SUM(CASE WHEN p_type LIKE \'PROMO%\' THEN l_extendedprice * (1 - l_discount) ELSE 0 END) / SUM(l_extendedprice * (1 - l_discount)) AS promo_revenue FROM lineitem l, part p WHERE l_partkey = p_partkey AND l_shipdate &gt;= DATE \'1995-09-01\' AND l_shipdate &lt; DATE \'1995-09-01\' + INTERVAL \'1\' MONTH\\", \\"outputRows\\": 1, \\"userName\\": \\"test_user\\", \\"parentId\\": 0, \\"maxOutputRows\\": 200000, \\"scanSize\\": 8247470, \\"peakMemory\\": 13188295, \\"startTime\\": 1626330527632, \\"state\\": \\"FINISHED\\", \\"endTime\\": 1626330527905, \\"writeTableRows\\": 0, \\"scanRows\\": 351966 } }</DiagnosisSQLInfo>\\n <RequestId>1</RequestId>\\n <StageInfos>\\n <InputRows>123</InputRows>\\n <InputDataSize>2341</InputDataSize>\\n <OutputRows>231</OutputRows>\\n <OutputDataSize>12344</OutputDataSize>\\n <PeakMemory>3421</PeakMemory>\\n <OperatorCost>2341</OperatorCost>\\n <StageId>Stage[26]</StageId>\\n <State>RUNNING</State>\\n <Progress>0.3</Progress>\\n </StageInfos>\\n</DescribeDiagnosisSQLInfoResponse>","errorExample":""}]', - 'title' => '查看SQL执行详情', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeDiagnosisDimensions' => [ - 'summary' => '查看AnalyticDB MySQL湖仓版（3.0）集群符合指定检索条件的SQL在资源组、数据库名、用户名以及访问源地址等维度下的去重统计信息。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '列取湖存储', + 'summary' => '列取湖存储。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListLakeStorages'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListLakeStorages', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"****-964D-****-9D31-****\\",\\n \\"TotalCount\\": 30,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"Items\\": [\\n {\\n \\"OwnerUid\\": \\"123456\\",\\n \\"DBClusterId\\": \\"amv-*******\\",\\n \\"TotalRows\\": 30,\\n \\"OperatorUid\\": \\"123456\\",\\n \\"Permissions\\": [\\n {\\n \\"Read\\": true,\\n \\"Write\\": false,\\n \\"Account\\": \\"-\\",\\n \\"Type\\": \\"-\\"\\n }\\n ],\\n \\"TableCount\\": 30,\\n \\"Description\\": \\"Create a role to run ROS StackGroups.\\",\\n \\"LakeStorageId\\": \\"-\\",\\n \\"CreateTime\\": \\"2021-04-01T09:50:18Z\\",\\n \\"TotalStorage\\": \\"111333\\",\\n \\"CreatorUid\\": \\"123456\\",\\n \\"UpdateTime\\": \\"2024-03-15T02:24:32\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"FileSize\\": \\"651\\"\\n }\\n ],\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Success\\"\\n}","type":"json"}]', + ], + 'ListResultExportJobHistory' => [ + 'summary' => '调用ListResultExportJobHistory接口查询当前RAM用户结果集导出执行历史记录列表。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '132346', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '219537', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], ], 'parameters' => [ [ + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], + ], + [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的集群ID。'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bt6u59zcmd945****', - ], + 'in' => 'formData', + 'schema' => ['description' => 'AnalyticDB MySQL湖仓版（3.0）集群ID。'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-7xv5ty5m9o4v****'], + ], + [ + 'name' => 'PageNumber', + 'in' => 'formData', + 'schema' => ['description' => '页码，取值为大于0且不超过Integer最大值的整数。', 'type' => 'string', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'formData', + 'schema' => ['description' => '每页记录数，取值：'."\n" + .'- **30**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'string', 'required' => false, 'example' => '30'], ], [ 'name' => 'StartTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间，格式为Unix时间戳，单位：毫秒。'."\n" - .'> 仅支持查看最近14天的数据，查询超过14天前的数据返回结果为空。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '1625220210000', - ], + 'in' => 'formData', + 'schema' => ['description' => '查询开始时间。格式为<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', 'type' => 'string', 'required' => false, 'example' => '2022-01-01T12:01:00Z'], ], [ 'name' => 'EndTime', - 'in' => 'query', + 'in' => 'formData', + 'schema' => ['description' => '查询结束时间，UTC时间，格式为：yyyy-MM-ddTHH:mmZ。'."\n" + ."\n" + .'> 查询结束时间需晚于查询开始时间。', 'type' => 'string', 'required' => false, 'example' => '2023-05-25T06:54:00Z'], + ], + [ + 'name' => 'Order', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '查询结束时间，格式为Unix时间戳，单位：毫秒。'."\n" + 'description' => '根据指定字段对SQL语句进行排序，格式为JSON，是一个有序JSON数组，按输入数组的顺序进行复合排序，包含`Field`和`Type`两个字段，例如`[{"Field":"CreateTimee", "Type": "desc" }]`。其中：'."\n" ."\n" - .'> * 查询结束时间需晚于查询开始时间。'."\n" - .'> * 开始时间与结束时间的间隔不能超过24小时。', - 'type' => 'string', + .'- `Field`表示需要排序的字段名，支持如下字段：'."\n" + .' - `CreateTime`：执行开始时间。'."\n" + .' - `Status`：执行状态。'."\n" + .' - `DatabaseUser`：用户名称。'."\n" + .' - `TimeCost`：执行耗时。'."\n" + .' - `ResourceGroup`：资源组。'."\n" + .' - `ExportRows`：导出行数。'."\n" + .' - `Progress`：导出进度。'."\n" + ."\n\n" + .'- `Type`表示排序类型，支持如下取值（取值均不区分大小写）：'."\n" + .' - `Desc`：降序。'."\n" + .' - `Asc`：升序。', + 'type' => 'object', + 'properties' => [ + 'Field' => ['description' => '排序字段名称，支持的排序字段如下：'."\n" + ."\n" + .'- CreateTime'."\n" + .'- DatabaseUser'."\n" + .'- TimeCost'."\n" + .'- ResourceGroup'."\n" + .'- Status'."\n" + .'- Progress'."\n" + .'- ExportRows', 'type' => 'string', 'required' => false, 'example' => 'DatabaseUser'], + 'Type' => ['description' => '排序类型，取值：'."\n" + .'- **Desc**：降序'."\n" + .'- **Asc**：升序', 'type' => 'string', 'required' => false, 'example' => 'Desc'], + ], 'required' => false, - 'docRequired' => true, - 'example' => '1625220213000', ], ], [ - 'name' => 'RegionId', - 'in' => 'query', + 'name' => 'StatusList', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定AnalyticDB MySQL湖仓版（3.0）集群的地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', + 'description' => '任务执行状态列表（支持按照状态进行筛选）。', + 'type' => 'array', + 'items' => ['description' => '支持的状态有：'."\n" + .'1. **SUBMITTED**：任务提交成功。'."\n" + .'2. **RUNNING**：任务正在运行中。'."\n" + .'3. **SUCCEEDED**：任务执行成功。'."\n" + .'4. **FAILED**：任务执行失败。', 'type' => 'string', 'required' => false, 'example' => 'RUNNING'], + 'required' => false, ], ], [ - 'name' => 'QueryCondition', - 'in' => 'query', - 'schema' => [ - 'description' => 'SQL查询的条件，格式为JOSN字符串，包含`Type`、`Value`、`Min`或`Max`等字段。其中`Type` 表示查询维度（当前仅支持3个取值：`maxCost`、`status`和`cost`）；`Value`、`Min`或`Max`表示该维度下的查询范围。取值说明：'."\n" - .'- ` {"Type":"maxCost","Value":"100"}`：表示查看执行耗时最长的前100条SQL详情，当前`Value`的取值仅支持设置为100。'."\n" - .'- `{"Type":"status","Value":"finished"}`：表示查看已完成的SQL详情。您也可以将`Value`设置为`running`或`failed`来查询正在执行或执行失败的SQL详情。'."\n" - .'- `{"Type":"cost","Min":"10","Max":"200"}`：表示查看执行耗时为10毫秒~200毫秒的SQL详情，您也可以自定义执行耗时的最大值与最小值，单位：毫秒（ms）。', - 'type' => 'string', - 'required' => false, - 'example' => '{"Type":"maxCost","Value":"100"}', - ], + 'name' => 'ResourceGroup', + 'in' => 'formData', + 'schema' => ['description' => '任务执行资源组（支持按照资源组进行筛选）。', 'type' => 'string', 'required' => false, 'example' => 'user_default'], ], [ - 'name' => 'Lang', - 'in' => 'query', - 'schema' => [ - 'description' => '语言配置，取值说明：'."\n" - .'- **zh-CN**：简体中文（默认语言）。'."\n" - .'- **en-US**：英文。'."\n" - .'- **ja**：日文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh-CN', - ], + 'name' => 'DatabaseUser', + 'in' => 'formData', + 'schema' => ['description' => '数据库用户。', 'type' => 'string', 'required' => false, 'example' => 'test1'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'ResultData<?>', + 'description' => '返回详细信息。', 'type' => 'object', 'properties' => [ - 'ClientIps' => [ - 'description' => '访问源地址。', - 'type' => 'array', - 'items' => [ - 'description' => '访问源地址。', - 'type' => 'string', - 'example' => '106.11.xx.xx', - ], - ], - 'ResourceGroups' => [ - 'description' => '资源组名称。', - 'type' => 'array', - 'items' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'example' => 'user_defaul', - ], - ], - 'UserNames' => [ - 'description' => '用户名。', - 'type' => 'array', - 'items' => [ - 'description' => '用户名。', - 'type' => 'string', - 'example' => 'test_user', - ], - ], - 'Databases' => [ - 'description' => '数据库名称。', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**Ok**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'OK'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => 'InvalidInput'], + 'Items' => [ + 'description' => '列表详情。', 'type' => 'array', 'items' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'adb_demo', + 'description' => '结果集导出详情。', + 'type' => 'object', + 'properties' => [ + 'DBClusterId' => ['description' => 'AnalyticDB MySQL湖仓版（3.0）集群ID。', 'type' => 'string', 'example' => 'amv-7xv5ty5m9o4v****'], + 'AliUid' => ['description' => 'RAM账号ID。', 'type' => 'string', 'example' => '120010511678****'], + 'Sql' => ['description' => '结果集导出任务中使用的SQL语句详情。', 'type' => 'string', 'example' => 'SELECT * FROM `ADB_SampleData_TPCH`.`supplier` LIMIT 20'], + 'CreateTime' => ['description' => '结果集导出任务创建时间。UTC时间，格式为<i>yyyy-mm-ddThh:mm:ssZ</i>。', 'type' => 'string', 'example' => '2022-04-01T09:50:18Z'], + 'StartTime' => ['description' => '任务的开始时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'example' => '2021-07-03T04:00:00Z'], + 'EndTime' => ['description' => '查询结束时间。UTC时间，格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>。'."\n" + .'> 查询结束时间需晚于查询开始时间。', 'type' => 'string', 'example' => '2023-06-15T02:13:00Z'], + 'DatabaseUser' => ['description' => 'RAM用户关联的数据库账号名称。', 'type' => 'string', 'example' => 'ram_user'], + 'TimeCost' => ['description' => '数据导出耗时，单位是毫秒。'."\n" + ."\n" + .'> 从数据导出任务启动开始算，直到导出结束。', 'type' => 'integer', 'format' => 'int64', 'example' => '560'], + 'ExportJobId' => ['description' => '结果集导出任务唯一标识。', 'type' => 'string', 'example' => 'export_2024051319271219802100800401300****'."\n"], + 'ResourceGroup' => ['description' => '任务执行资源组。', 'type' => 'string', 'example' => 'test'], + 'Status' => ['description' => '导出任务执行状态，枚举类型，分为以下几种状态：'."\n" + .'1. **SUBMITTED**：任务提交成功。'."\n" + .'2. **RUNNING**：任务正在运行中。'."\n" + .'3. **SUCCEEDED**：任务执行成功。'."\n" + .'4. **FAILED**：任务执行失败。', 'type' => 'string', 'example' => 'RUNNING'], + 'ExportPath' => ['description' => '结果集完整地址。', 'type' => 'string', 'example' => 'oss://testBucketName/export_test/result_export/2024/05/13/202405131528400210090110690315154****/result.csv'], + 'Progress' => ['description' => '导出进度。单位为百分比（%），取值范围[0,100]。', 'type' => 'string', 'example' => '30'], + 'ProcessId' => ['description' => '返回SQL查询ID，便于用户诊断。'."\n" + .'> 您可以通过调用[DescribeDiagnosisSQLInfo](~~612495~~)接口进行查询诊断。', 'type' => 'string', 'example' => '202306121421111720161451770345339****'], + 'ExportRows' => ['description' => '导出行数，接口调用成功才返回该参数。', 'type' => 'string', 'example' => '10000'], + 'Message' => ['description' => '结果集导出SQL执行错误信息，只在任务执行失败时才返回该信息。', 'type' => 'string', 'example' => 'Failed to execute SQL'], + 'Engine' => ['description' => '任务执行的引擎，目前只支持XIHE。', 'type' => 'string', 'example' => 'XIHE'], + 'Schema' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'lake_db'], + 'ExportType' => ['description' => '导出类型。', 'type' => 'string', 'example' => '-'], + 'IsExpired' => ['description' => '是否已过期：'."\n" + ."\n" + .'- **false**: 未过期，'."\n" + .'- **true**: 已过期', 'type' => 'boolean'], + ], ], ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'DEA97C6B-D7A4-5E69-9EFC-D7F88737CED5', - ], + 'PageNumber' => ['description' => '页号，和传入的值一致。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '本页记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '174'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '列出结果集导出历史任务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListResultExportJobHistory'], + ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListResultExportJobHistory', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"ClientIps\\": [\\n \\"106.11.xx.xx\\"\\n ],\\n \\"ResourceGroups\\": [\\n \\"user_defaul\\"\\n ],\\n \\"UserNames\\": [\\n \\"test_user\\"\\n ],\\n \\"Databases\\": [\\n \\"adb_demo\\"\\n ],\\n \\"RequestId\\": \\"DEA97C6B-D7A4-5E69-9EFC-D7F88737CED5\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeDiagnosisDimensionsResponse>\\n <ClientIps>[\\"106.11.xx.xx\\",\\"106.11.xx.xx\\"]</ClientIps>\\n <ResourceGroups>user_defaul</ResourceGroups>\\n <UserNames>test_user</UserNames>\\n <Databases>adb_demo</Databases>\\n <RequestId>DEA97C6B-D7A4-5E69-9EFC-D7F88737CED5</RequestId>\\n</DescribeDiagnosisDimensionsResponse>","errorExample":""}]', - 'title' => '查询不同维度的SQL去重统计信息', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Items\\": [\\n {\\n \\"DBClusterId\\": \\"amv-7xv5ty5m9o4v****\\",\\n \\"AliUid\\": \\"120010511678****\\",\\n \\"Sql\\": \\"SELECT * FROM `ADB_SampleData_TPCH`.`supplier` LIMIT 20\\",\\n \\"CreateTime\\": \\"2022-04-01T09:50:18Z\\",\\n \\"StartTime\\": \\"2021-07-03T04:00:00Z\\",\\n \\"EndTime\\": \\"2023-06-15T02:13:00Z\\",\\n \\"DatabaseUser\\": \\"ram_user\\",\\n \\"TimeCost\\": 560,\\n \\"ExportJobId\\": \\"export_2024051319271219802100800401300****\\\\n\\",\\n \\"ResourceGroup\\": \\"test\\",\\n \\"Status\\": \\"RUNNING\\",\\n \\"ExportPath\\": \\"oss://testBucketName/export_test/result_export/2024/05/13/202405131528400210090110690315154****/result.csv\\",\\n \\"Progress\\": \\"30\\",\\n \\"ProcessId\\": \\"202306121421111720161451770345339****\\",\\n \\"ExportRows\\": \\"10000\\",\\n \\"Message\\": \\"Failed to execute SQL\\",\\n \\"Engine\\": \\"XIHE\\",\\n \\"Schema\\": \\"lake_db\\",\\n \\"ExportType\\": \\"-\\",\\n \\"IsExpired\\": true\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 174\\n}","type":"json"}]', ], - 'DownloadDiagnosisRecords' => [ - 'summary' => '下载目标AnalyticDB MySQL湖仓版（3.0）集群中符合指定条件的查询SQL的摘要信息。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'ListSemanticViewNames' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -33632,227 +24047,249 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '132341', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'AnalyticDB MySQL湖仓版（3.0）集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1q8bu9a****', - ], - ], - [ - 'name' => 'StartTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间，格式为Unix时间戳，单位：毫秒。'."\n" - .'> 仅支持查看最近14天的数据。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '1662364330000', - ], - ], - [ - 'name' => 'EndTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间，格式为Unix时间戳，单位：毫秒。'."\n" - .'> * 查询结束时间需晚于查询开始时间。'."\n" - .'> * 开始时间与结束时间的间隔不能超过24小时。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '1662450730000', - ], + 'schema' => ['title' => 'ADB集群ID。', 'description' => 'ADB集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp*****'], ], [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'QueryCondition', + 'name' => 'SchemaName', 'in' => 'query', - 'schema' => [ - 'description' => '指定SQL查询的条件，格式为JOSN字符串，包含`Type`、`Value`、`Min`或`Max`等字段。其中`Type` 表示查询维度（当前仅支持`maxCost`、`status`和`cost`3个取值）；`Value`、`Min`或`Max`表示该维度下的查询范围。具体支持的取值范围如下：'."\n" - .'- ` {"Type":"maxCost","Value":"100"}`：表示查看执行耗时最长的前100条SQL详情，当前`Value`的取值仅支持设置为100。'."\n" - .'- `{"Type":"status","Value":"finished"}`：表示查看已完成的SQL详情。您也可以将`Value`设置为`running`或`failed`来查询正在执行或执行失败的SQL详情。'."\n" - .'- `{"Type":"cost","Min":"10","Max":"200"}`：表示查看执行耗时为10毫秒~200毫秒的SQL详情，您也可以自定义执行耗时的最大值与最小值，单位：毫秒。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '{"Type":"status","Value":"finished"}', - ], + 'schema' => ['title' => '语义视图所属的 Schema 名', 'description' => '语义视图所属的 Schema 名', 'type' => 'string', 'required' => false, 'example' => 'adb_demo'], ], - [ - 'name' => 'Keyword', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '查询关键字。', - 'type' => 'string', - 'required' => false, - 'example' => 'select', + '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' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => [ + 'description' => '返回结果数据。', + 'type' => 'array', + 'items' => [ + 'description' => '返回结果数据。', + 'type' => 'object', + 'properties' => [ + 'ViewSchema' => ['description' => '语义视图所在的 schema', 'type' => 'string', 'example' => 'sales_db'], + 'ViewName' => ['description' => '语义视图名称', 'type' => 'string', 'example' => 'revenue_analysis'], + 'Comment' => ['description' => '语义视图注解', 'type' => 'string', 'example' => '这是一个定义销售额相关指标的视图'], + ], + ], + ], + ], ], ], - [ - 'name' => 'MinPeakMemory', - 'in' => 'query', - 'schema' => [ - 'description' => '目标SQL的最小峰值内存，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '88000000', - ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'MDS.CatalogAlreadyExist', 'errorMessage' => 'The catalog already exists.', 'description' => '目录已经存在'], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ['errorCode' => 'MDS.SemanticViewAlreadyExist', 'errorMessage' => 'The semantic view already exists.', 'description' => '此语义视图已经存在'], + ['errorCode' => 'MDS.SemanticViewNotExist', 'errorMessage' => 'This semantic view does not exist.', 'description' => '此语义视图不存在'], ], - [ - 'name' => 'MaxPeakMemory', - 'in' => 'query', - 'schema' => [ - 'description' => '目标SQL的最大峰值内存，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '88000000', - ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], ], [ - 'name' => 'MinScanSize', - 'in' => 'query', - 'schema' => [ - 'description' => '目标SQL的最小扫描量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1073741824', - ], + ['errorCode' => 'MDS.InstanceNotExist', 'errorMessage' => 'ADB instance does not exist.', 'description' => 'ADB 实例不存在'], ], - [ - 'name' => 'MaxScanSize', - 'in' => 'query', - 'schema' => [ - 'description' => '目标SQL的最大扫描量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '64424509440', - ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查看语义视图列表', + 'summary' => '查看语义视图列表', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": [\\n {\\n \\"ViewSchema\\": \\"sales_db\\",\\n \\"ViewName\\": \\"revenue_analysis\\",\\n \\"Comment\\": \\"这是一个定义销售额相关指标的视图\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'ListSparkAppAttempts' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'ResourceGroup', - 'in' => 'query', - 'schema' => [ - 'description' => '目标SQL所属的资源组。'."\n" - .'> 您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL所属的资源组、数据库名、用户名以及访问源地址信息。', - 'type' => 'string', - 'required' => false, - 'example' => 'user_default', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'list'], + 'parameters' => [ [ - 'name' => 'UserName', + 'name' => 'AppId', 'in' => 'query', - 'schema' => [ - 'description' => '执行目标SQL的用户名。'."\n" - .'> 您可以调用[DescribeDiagnosisDimensions](~~~~)接口查看符合指定检索条件的SQL所属的资源组、数据库名、用户名以及访问源地址信息。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_user', - ], + 'schema' => ['title' => 'spark app的id', 'description' => '应用ID。'."\n" + ."\n" + .'> 您可以调用[ListSparkApps](~~455888~~)接口查询所有的应用ID。', 'type' => 'string', 'required' => true, 'example' => 's202204132018hzprec1ac****'], ], [ - 'name' => 'Database', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '执行目标SQL的数据库。'."\n" - .'> 您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL所属的资源组、数据库名、用户名以及访问源地址信息。', - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', - ], + 'schema' => ['title' => '页码号', 'description' => '页码，取值为正整数。默认值为**1**。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'minimum' => '1', 'example' => '1'], ], [ - 'name' => 'ClientIp', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '访问源地址。'."\n" - .'> 您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL所属的资源组、数据库名、用户名以及访问源地址信息。', - 'type' => 'string', - 'required' => false, - 'example' => '106.11.XX.XX', - ], + 'schema' => ['title' => '每页显示数量', 'description' => '每页记录数，取值：'."\n" + .'- **10**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '100', 'minimum' => '1', 'example' => '10', 'default' => '10'], ], [ - 'name' => 'Lang', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '语言配置，取值说明：'."\n" - .'- **zh**：简体中文（默认语言）。'."\n" - .'- **en**：英文。'."\n" - .'- **ja**：日文。'."\n" - .'- **zh-tw**：繁体中文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => false, 'example' => 'amv-uf6o6m8p6x***'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'DownloadId' => [ - 'description' => '下载ID。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '25494', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '845774AC-5D43-53A2-AAB8-C73828E68508', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => [ + 'description' => '返回数据。', + 'type' => 'object', + 'properties' => [ + 'AttemptInfoList' => [ + 'description' => '重试信息列表。返回参数说明：'."\n" + .'- **AttemptId**：重试ID。'."\n" + .'- **State**：应用执行状态，取值说明：'."\n" + .' - **SUBMITTED**：已提交。'."\n" + .' - **STARTING**：开始启动。'."\n" + .' - **RUNNING**：执行中。'."\n" + .' - **FAILING**：任务失败，清理环境中。'."\n" + .' - **FAILED**：失败。'."\n" + .' - **KILLING**：中止任务，清理环境中。'."\n" + .' - **KILLED**：中止任务。'."\n" + .' - **SUCCEEDING**：任务执行结束，清理环境中。'."\n" + .' - **COMPLETED**：任务执行结束。'."\n" + .' - **FATAL**：意外失败。'."\n" + .' - **UNKNOWN**：未知错误。'."\n" + .'- **Message**：返回告警信息，无告警时则返回为空。'."\n" + .'- **Data**：Spark应用模板数据。'."\n" + .'- **EstimateExecutionCpuTimeInSeconds**：执行Spark应用消耗CPU的时长，单位毫秒（ms）。'."\n" + .'- **LogRootPath**：日志文件存储路径。'."\n" + .'- **LastAttemptId**：上次重试的ID。'."\n" + .'- **WebUiAddress**：Web UI地址。'."\n" + .'- **SubmittedTimeInMillis**：提交Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **StartedTimeInMillis**：Spark应用的创建时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **LastUpdatedTimeInMillis**：最近一次更新Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **TerminatedTimeInMillis**：Spark应用终止执行的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **DBClusterId**：执行Spark应用的集群ID。'."\n" + .'- **ResourceGroupName**：Job型资源组名称。'."\n" + .'- **DurationInMillis**：Spark应用执行耗时，单位毫秒（ms）。', + 'type' => 'array', + 'items' => ['description' => '重试信息列表。返回参数说明：'."\n" + .'- **AttemptId**：重试ID。'."\n" + .'- **State**：应用执行状态，取值说明：'."\n" + .' - **SUBMITTED**：已提交。'."\n" + .' - **STARTING**：开始启动。'."\n" + .' - **RUNNING**：执行中。'."\n" + .' - **FAILING**：任务失败，清理环境中。'."\n" + .' - **FAILED**：失败。'."\n" + .' - **KILLING**：中止任务，清理环境中。'."\n" + .' - **KILLED**：中止任务。'."\n" + .' - **SUCCEEDING**：任务执行结束，清理环境中。'."\n" + .' - **COMPLETED**：任务执行结束。'."\n" + .' - **FATAL**：意外失败。'."\n" + .' - **UNKNOWN**：未知错误。'."\n" + .'- **Message**：返回告警信息，无告警时则返回为空。'."\n" + .'- **Data**：Spark应用模板数据。'."\n" + .'- **EstimateExecutionCpuTimeInSeconds**：执行Spark应用消耗CPU的时长，单位毫秒（ms）。'."\n" + .'- **LogRootPath**：日志文件存储路径。'."\n" + .'- **LastAttemptId**：上次重试的ID。'."\n" + .'- **WebUiAddress**：Web UI地址。'."\n" + .'- **SubmittedTimeInMillis**：提交Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **StartedTimeInMillis**：Spark应用的创建时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **LastUpdatedTimeInMillis**：最后一次更新Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **TerminatedTimeInMillis**：Spark应用终止执行的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **DBClusterId**：执行Spark应用的集群ID。'."\n" + .'- **ResourceGroupName**：Job型资源组名称。'."\n" + .'- **DurationInMillis**：Spark应用执行耗时，单位毫秒（ms）。', '$ref' => '#/components/schemas/SparkAttemptInfo'], + ], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '3'], + ], ], ], ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"DownloadId\\": 25494,\\n \\"RequestId\\": \\"845774AC-5D43-53A2-AAB8-C73828E68508\\"\\n}","errorExample":""},{"type":"xml","example":"<DownloadDiagnosisRecordsResponse>\\n <DownloadId>25494</DownloadId>\\n <RequestId>845774AC-5D43-53A2-AAB8-C73828E68508</RequestId>\\n</DownloadDiagnosisRecordsResponse>","errorExample":""}]', - 'title' => '下载SQL摘要信息', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeDiagnosisRecords' => [ - 'summary' => '调用DownloadDiagnosisRecords接口查看目标AnalyticDB MySQL集群中符合指定条件的SQL摘要信息。', - 'methods' => [ - 'post', - 'get', + 'title' => '查询Spark应用的重试信息', + 'summary' => '查询指定Spark应用的重试信息。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-11-24T09:19:25.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-06-28T01:10:29.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-07-19T03:21:06.000Z', 'description' => '请求参数发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListSparkAppAttempts'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListSparkAppAttempts', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"AttemptInfoList\\": [\\n {\\n \\"AttemptId\\": \\"s202207151211hz****-0001\\",\\n \\"Message\\": \\"WARN: Disk is full\\",\\n \\"Priority\\": \\"NORMAL\\",\\n \\"State\\": \\"SUBMITTED\\",\\n \\"Detail\\": {\\n \\"DurationInMillis\\": 100,\\n \\"LogRootPath\\": \\"oss://<bucket-name>/logs/driver\\",\\n \\"DBClusterId\\": \\"amv-bp11q28kvl688****\\",\\n \\"Data\\": \\"{ \\\\\\"name\\\\\\": \\\\\\"SparkPi\\\\\\", \\\\\\"file\\\\\\": \\\\\\"local:///tmp/spark-examples.jar\\\\\\", \\\\\\"className\\\\\\": \\\\\\"org.apache.spark.examples.SparkPi\\\\\\", \\\\\\"args\\\\\\": [ \\\\\\"1000000\\\\\\" ], \\\\\\"conf\\\\\\": { \\\\\\"spark.driver.resourceSpec\\\\\\": \\\\\\"small\\\\\\", \\\\\\"spark.executor.instances\\\\\\": 1, \\\\\\"spark.executor.resourceSpec\\\\\\": \\\\\\"small\\\\\\" } }\\",\\n \\"EstimateExecutionCpuTimeInSeconds\\": 100,\\n \\"LastUpdatedTimeInMillis\\": 1651213645200,\\n \\"RunningStartTimeInMillis\\": 36000,\\n \\"LastAttemptId\\": \\"s202204291426hzpre60****-0003\\",\\n \\"TerminatedTimeInMillis\\": 1651213645300,\\n \\"ResourceProvisioningDurationInMillis\\": 36000,\\n \\"ExecutionDurationInMillis\\": 36000,\\n \\"WebUiAddress\\": \\"https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****\\",\\n \\"SubmittedTimeInMillis\\": 1651213645000,\\n \\"StartedTimeInMillis\\": 1651213645010,\\n \\"AppType\\": \\"BATCH\\",\\n \\"ResourceGroupName\\": \\"spark-rg\\"\\n }\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 3\\n }\\n}","errorExample":""},{"type":"xml","example":"<ListSparkAppAttemptsResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Data>\\n <AttemptInfoList>\\n <AttemptId>s202207151211hz0cb4200*****-0001</AttemptId>\\n <State>RUNNING</State>\\n <Message>WARN: Disk is full</Message>\\n <Detail>\\n <Data>{ \\"name\\": \\"SparkPi\\", \\"file\\": \\"local:///tmp/spark-examples.jar\\", \\"className\\": \\"org.apache.spark.examples.SparkPi\\", \\"args\\": [ \\"1000000\\" ], \\"conf\\": { \\"spark.driver.resourceSpec\\": \\"small\\", \\"spark.executor.instances\\": 1, \\"spark.executor.resourceSpec\\": \\"small\\" } }</Data>\\n <EstimateExecutionCpuTimeInSeconds>100</EstimateExecutionCpuTimeInSeconds>\\n <LogRootPath>oss://<bucket-name>/logs/driver</LogRootPath>\\n <LastAttemptId>s202204291426hzpre60cfa*****-0003</LastAttemptId>\\n <WebUiAddress>https://sparkui.aliyuncs.com/token=xxx</WebUiAddress>\\n <SubmittedTimeInMillis>1651213645000</SubmittedTimeInMillis>\\n <StartedTimeInMillis>1651213645010</StartedTimeInMillis>\\n <LastUpdatedTimeInMillis>1651213645200</LastUpdatedTimeInMillis>\\n <TerminatedTimeInMillis>1651213645300</TerminatedTimeInMillis>\\n <DBClusterId>amv-bp11q28kv****</DBClusterId>\\n <ResourceGroupName>spark-rg</ResourceGroupName>\\n <DurationInMillis>100</DurationInMillis>\\n </Detail>\\n </AttemptInfoList>\\n <PageNumber>1</PageNumber>\\n <PageSize>10</PageSize>\\n <TotalCount>3</TotalCount>\\n </Data>\\n</ListSparkAppAttemptsResponse>","errorExample":""}]', + ], + 'ListSparkApps' => [ + 'summary' => '查看Spark应用列表。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -33864,486 +24301,352 @@ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '131519', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '企业版、基础版或湖仓版集群ID。'."\n" - ."\n" - .'> 您可以通过[DescribeDBClusters](~~612397~~)接口查看账号下所有集群的详细信息，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1scs48yc125****', - ], + 'schema' => ['title' => '数据库的ID', 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'StartTime', + 'name' => 'ResourceGroupName', 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间，格式为Unix时间戳，单位：毫秒。'."\n" - .'> 仅支持查看14天内的数据。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '1632931200000', - ], + 'schema' => ['description' => 'Job型资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'test_instance'], ], [ - 'name' => 'EndTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间，格式为Unix时间戳，单位：毫秒。'."\n" - .'> * 查询结束时间需晚于查询开始时间。'."\n" - .'> * 开始时间与结束时间的间隔不能超过24小时。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '1633017540000', - ], - ], - [ - 'name' => 'RegionId', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['title' => '页码号', 'description' => '页码，取值为正整数。默认值为**1**。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'minimum' => '1', 'example' => '1'], ], [ - 'name' => 'QueryCondition', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => 'SQL查询的条件，格式为JOSN字符串，包含`Type`、`Value`、`Min`或`Max`等字段。其中`Type` 表示查询维度（当前仅支持3个取值：`maxCost`、`status`和`cost`）；`Value`、`Min`或`Max`表示该维度下的查询范围。取值说明：'."\n" - .'- ` {"Type":"maxCost","Value":"100"}`：表示查看执行耗时最长的前100条SQL详情，当前`Value`的取值仅支持设置为100。'."\n" - .'- `{"Type":"status","Value":"finished"}`：表示查看已完成的SQL详情。您也可以将`Value`设置为`running`或`failed`来查询正在执行或执行失败的SQL详情。'."\n" - .'- `{"Type":"cost","Min":"10","Max":"200"}`：表示查看执行耗时为10毫秒~200毫秒的SQL详情，您也可以自定义执行耗时的最大值与最小值，单位：毫秒。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '{"Type":"status","Value":"finished"}', - ], + 'schema' => ['description' => '每页记录数，取值：'."\n" + .'- **10**（默认值）'."\n" + .'- **50**'."\n" + .'- **100**', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '100', 'minimum' => '1', 'example' => '30', 'default' => '10'], ], [ - 'name' => 'Keyword', + 'name' => 'Filters', 'in' => 'query', - 'schema' => [ - 'description' => '按SQL语句中包含的关键字过滤。', - 'type' => 'string', - 'required' => false, - 'example' => 'select', - ], + 'schema' => ['description' => '以JSON格式的字符串来定义过滤条件，在JSON中可以使用的合法的KEY值和业务含义如下：'."\n" + .'- SubmittedTimeRange：开始时间。'."\n" + .'- TerminatedTimeRange： 结束时间。'."\n" + .'- AppStates：Spark作业的状态。'."\n" + .'- AppId：Spark作业的ID。'."\n" + .'- AppNameRegex: Spark作业的名称的正则表达式。'."\n" + .'- Tag：tag信息。'."\n" + .'- ResourceGroupName：资源组名称。'."\n" + ."\n" + .'其中开始时间和结束时间过滤条件，通过如下的子结构来输入范围：'."\n" + .'- Min：时间范围的下限，null代表无限制。'."\n" + .'- Max：时间范围的上限，null代表无限制。', 'type' => 'string', 'required' => false, 'example' => '{'."\n" + .'"SubmittedTimeRang": {'."\n" + .' "Max": 10000,'."\n" + .' "Min": 0'."\n" + .' },'."\n" + .' "TerminatedTimeRange": {'."\n" + .' "Max": 10000,'."\n" + .' "Min": 0'."\n" + .' },'."\n" + .' "AppStates": ["STARTING"],'."\n" + .' "AppId": "adc",'."\n" + .' "AppNameRegex": "cde",'."\n" + .' "AttemptId": "abc-001"'."\n" + .'}'], ], - [ - 'name' => 'MinPeakMemory', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ + 'headers' => [], 'schema' => [ - 'description' => 'SQL语句的最小峰值内存，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '0', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'], + 'TotalCount' => ['description' => '总记录条数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380'], + 'Data' => [ + 'description' => '返回数据。', + 'type' => 'object', + 'properties' => [ + 'AppInfoList' => [ + 'description' => '应用信息列表。返回参数说明：'."\n" + .'- **Data**：Spark应用模板数据。'."\n" + .'- **EstimateExecutionCpuTimeInSeconds**：执行Spark应用消耗CPU的时长，单位毫秒（ms）。'."\n" + .'- **LogRootPath**：日志文件存储路径。'."\n" + .'- **LastAttemptId**：重试ID。'."\n" + .'- **WebUiAddress**：Web UI地址。'."\n" + .'- **SubmittedTimeInMillis**：提交Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **StartedTimeInMillis**：Spark应用的创建时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **LastUpdatedTimeInMillis**：最近一次更新Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **TerminatedTimeInMillis**：Spark应用终止执行的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **DBClusterId**：执行Spark应用的集群ID。'."\n" + .'- **ResourceGroupName**：Job型资源组名称。'."\n" + .'- **DurationInMillis**：Spark应用执行耗时，单位毫秒（ms）。', + 'type' => 'array', + 'items' => ['description' => '应用信息列表。返回参数说明：'."\n" + .'- **Data**：Spark应用模板数据。'."\n" + .'- **EstimateExecutionCpuTimeInSeconds**：执行Spark应用消耗CPU的时长，单位毫秒（ms）。'."\n" + .'- **LogRootPath**：日志文件存储路径。'."\n" + .'- **LastAttemptId**：重试ID。'."\n" + .'- **WebUiAddress**：Web UI地址。'."\n" + .'- **SubmittedTimeInMillis**：提交Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **StartedTimeInMillis**：Spark应用的创建时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **LastUpdatedTimeInMillis**：最近一次更新Spark应用的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **TerminatedTimeInMillis**：Spark应用终止执行的时间，Unix时间戳，单位毫秒（ms）。'."\n" + .'- **DBClusterId**：执行Spark应用的集群ID。'."\n" + .'- **ResourceGroupName**：Job型资源组名称。'."\n" + .'- **DurationInMillis**：Spark应用执行耗时，单位毫秒（ms）。', 'example' => '{'."\n" + .' "AppId": "test-app-id",'."\n" + .' "State": "Running",'."\n" + .' "Detail": {'."\n" + .' "LastAttemptId": "0001",'."\n" + .' "WebUiAddress": "http://spark-ui:4040",'."\n" + .' "SubmittedTimeInMillis": 1644805200260,'."\n" + .' "DBClusterId": "db",'."\n" + .' "EstimateExecutionCpuTimeInSeconds": 1644812400,'."\n" + .' "AppConf": "{}",'."\n" + .' "StartedTimeInMillis": 1644806400260,'."\n" + .' "LastUpdatedTimeInMillis": 1644808800260,'."\n" + .' "ResourceGroupName": "rg"'."\n" + .' },'."\n" + .' "AppName": "test app name"'."\n" + .' }', '$ref' => '#/components/schemas/SparkAppInfo'], + ], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + ], + ], + ], ], ], - [ - 'name' => 'MaxPeakMemory', - 'in' => 'query', - 'schema' => [ - 'description' => 'SQL语句的最大峰值内存，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '89000000', - ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], ], - [ - 'name' => 'MinScanSize', - 'in' => 'query', - 'schema' => [ - 'description' => 'SQL语句的最小扫描量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '0', - ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], ], [ - 'name' => 'MaxScanSize', - 'in' => 'query', - 'schema' => [ - 'description' => '目标SQL的最大扫描量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1024000000', - ], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], ], - [ - 'name' => 'ResourceGroup', - 'in' => 'query', - 'schema' => [ - 'description' => 'SQL语句所属的资源组。'."\n" - .'> 您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL语句所属的资源组、数据库名、用户名以及访问源地址信息。', - 'type' => 'string', - 'required' => false, - 'example' => 'user_default', - ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], - [ - 'name' => 'UserName', - 'in' => 'query', - 'schema' => [ - 'description' => '执行SQL语句的用户名。'."\n" - .'您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL语句所属的资源组、数据库名、用户名以及访问源地址信息。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_user', - ], + ], + 'title' => '查询Spark应用列表', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2025-02-11T03:16:58.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-06-28T01:10:29.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-07-19T03:21:07.000Z', 'description' => '请求参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListSparkApps'], ], + ], + 'ramActions' => [ [ - 'name' => 'Database', - 'in' => 'query', - 'schema' => [ - 'description' => '执行SQL语句的数据库。'."\n" - .'> 您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL语句所属的资源组、数据库名、用户名以及访问源地址信息。', - 'type' => 'string', - 'required' => false, - 'example' => 'adb_demo', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListSparkApps', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"AppInfoList\\": [\\n {\\n \\"AppId\\": \\"s202207151211hz0c****\\",\\n \\"Message\\": \\"WARN: Disk is full.\\",\\n \\"Priority\\": \\"NORMAL\\",\\n \\"State\\": \\"SUBMITTED\\",\\n \\"DBClusterId\\": \\"amv-23xxxx\\",\\n \\"Detail\\": {\\n \\"DurationInMillis\\": 100,\\n \\"LogRootPath\\": \\"oss://<bucket-name>/logs/driver\\",\\n \\"DBClusterId\\": \\"amv-bp11q28kvl688****\\",\\n \\"Data\\": \\"{ \\\\\\"name\\\\\\": \\\\\\"SparkPi\\\\\\", \\\\\\"file\\\\\\": \\\\\\"local:///tmp/spark-examples.jar\\\\\\", \\\\\\"className\\\\\\": \\\\\\"org.apache.spark.examples.SparkPi\\\\\\", \\\\\\"args\\\\\\": [ \\\\\\"1000000\\\\\\" ], \\\\\\"conf\\\\\\": { \\\\\\"spark.driver.resourceSpec\\\\\\": \\\\\\"small\\\\\\", \\\\\\"spark.executor.instances\\\\\\": 1, \\\\\\"spark.executor.resourceSpec\\\\\\": \\\\\\"small\\\\\\" } }\\",\\n \\"EstimateExecutionCpuTimeInSeconds\\": 100,\\n \\"LastUpdatedTimeInMillis\\": 1651213645200,\\n \\"RunningStartTimeInMillis\\": 36000,\\n \\"LastAttemptId\\": \\"s202204291426hzpre60****-0003\\",\\n \\"TerminatedTimeInMillis\\": 1651213645300,\\n \\"ResourceProvisioningDurationInMillis\\": 36000,\\n \\"ExecutionDurationInMillis\\": 36000,\\n \\"WebUiAddress\\": \\"https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****\\",\\n \\"SubmittedTimeInMillis\\": 1651213645000,\\n \\"StartedTimeInMillis\\": 1651213645010,\\n \\"AppType\\": \\"BATCH\\",\\n \\"ResourceGroupName\\": \\"spark-rg\\"\\n },\\n \\"AppName\\": \\"SparkTest\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 1\\n }\\n}","errorExample":""},{"type":"xml","example":"<ListSparkAppsResponse>\\n <PageNumber>1</PageNumber>\\n <PageSize>10</PageSize>\\n <TotalCount>1</TotalCount>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <AppInfoList>\\n <AppId>s202207151211hz0cb4*****</AppId>\\n <AppName>Spark Test</AppName>\\n <State>FAILED</State>\\n <Message>WARN: Disk is full</Message>\\n <Detail>\\n <Data>{ \\"name\\": \\"SparkPi\\", \\"file\\": \\"local:///tmp/spark-examples.jar\\", \\"className\\": \\"org.apache.spark.examples.SparkPi\\", \\"args\\": [ \\"1000000\\" ], \\"conf\\": { \\"spark.driver.resourceSpec\\": \\"small\\", \\"spark.executor.instances\\": 1, \\"spark.executor.resourceSpec\\": \\"small\\" } }</Data>\\n <EstimateExecutionCpuTimeInSeconds>100</EstimateExecutionCpuTimeInSeconds>\\n <LogRootPath>oss://<bucket-name>/logs/driver</LogRootPath>\\n <LastAttemptId>s202204291426hzpre60cfa*****-0003</LastAttemptId>\\n <WebUiAddress>https://sparkui.aliyuncs.com/token=xxx</WebUiAddress>\\n <SubmittedTimeInMillis>1651213645000</SubmittedTimeInMillis>\\n <StartedTimeInMillis>1651213645010</StartedTimeInMillis>\\n <LastUpdatedTimeInMillis>1651213645200</LastUpdatedTimeInMillis>\\n <TerminatedTimeInMillis>1651213645300</TerminatedTimeInMillis>\\n <DBClusterId>amv-bp11q28kv****</DBClusterId>\\n <ResourceGroupName>spark-rg</ResourceGroupName>\\n <DurationInMillis>100</DurationInMillis>\\n </Detail>\\n </AppInfoList>\\n <PageNumber>1</PageNumber>\\n <PageSize>10</PageSize>\\n <TotalCount>1</TotalCount>\\n </Data>\\n</ListSparkAppsResponse>","errorExample":""}]', + ], + 'ListSparkLogAnalyzeTasks' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'ClientIp', - 'in' => 'query', - 'schema' => [ - 'description' => '访问源地址。'."\n" - .'> 您可以调用[DescribeDiagnosisDimensions](~~308210~~)接口查看符合指定检索条件的SQL语句所属的资源组、数据库名、用户名以及访问源地址信息。', - 'type' => 'string', - 'required' => false, - 'example' => '59.82.XX.XX', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ [ - 'name' => 'Order', - 'in' => 'query', - 'schema' => [ - 'description' => '根据指定字段对SQL语句进行排序，格式为JSON，是一个有序JSON数组，按输入数组的顺序进行复合排序，包含`Field`和`Type`两个字段，例如`[{"Field":"StartTime", "Type": "desc" }]`。其中：'."\n" - ."\n" - .'- `Field`表示需要排序的字段名，支持如下字段：'."\n" - .' - `StartTime`：执行开始时间。'."\n" - .' - `Status`：执行状态。'."\n" - .' - `UserName`：用户名称。'."\n" - .' - `Cost`：执行耗时。'."\n" - .' - `PeakMemory`：峰值内存。'."\n" - .' - `ScanSize`：扫描数据量。'."\n" - .' - `Database`：数据库名称。'."\n" - .' - `ClientIp`：访问源地址.'."\n" - .' - `ResourceGroup`：资源组。'."\n" - .' - `QueueTime`：排队耗时。'."\n" - .' - `OutputRows`：输出行数。'."\n" - .' - `OutputDataSize`：输出数据量。'."\n" - .' - `ResourceCostRank`：SQL内部算子的耗时排名（仅当`QueryCondition`取值为`{"Type":"status","Value":"running"}`时，支持使用该字段）。'."\n" - ."\n" - .'- `Type`表示排序类型，支持如下取值（取值均不区分大小写）：'."\n" - .' - `Desc`：降序。'."\n" - .' - `Asc`：升序。', - 'type' => 'string', - 'required' => false, - 'example' => '[{"Field":"StartTime", "Type": "desc" }]', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['title' => '集群ID', 'description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-9scxs****'], ], [ 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'in' => 'formData', + 'schema' => ['title' => '页码号', 'description' => '页码号。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'minimum' => '1', 'example' => '1'], ], [ 'name' => 'PageSize', - 'in' => 'query', + 'in' => 'formData', + 'schema' => ['title' => '每页数量', 'description' => '每页返回分析任务数量。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '100', 'minimum' => '1', 'example' => '20', 'default' => '10'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1DF5AF5B-C803-1861-A0FF-63666A557709'], + 'Data' => [ + 'description' => '返回结果数据。', + 'type' => 'object', + 'properties' => [ + 'TaskList' => [ + 'title' => '分析任务列表', + 'description' => 'Spark日志分析任务列表。', + 'type' => 'array', + 'items' => ['description' => 'Spark日志分析任务详情列表。', '$ref' => '#/components/schemas/SparkAnalyzeLogTask'], + ], + 'PageNumber' => ['title' => '页码号', 'description' => '页码号。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['title' => '每页数量', 'description' => '每页数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], + 'TotalCount' => ['title' => 'Task总数', 'description' => '集群中Spark日志分析任务总数。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + ], + ], + ], ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询Spark日志分析任务列表', + 'summary' => '获取所有的Spark日志分析任务列表。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-07-27T06:45:54.000Z', 'description' => '错误码发生变更、响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListSparkLogAnalyzeTasks'], + ], + ], + 'ramActions' => [ [ - 'name' => 'Lang', - 'in' => 'query', - 'schema' => [ - 'description' => '设置下载文件的文件标题以及部分错误信息的语言，支持如下语言：'."\n" - .'- **zh**：简体中文（默认语言）。'."\n" - .'- **en**：英文。'."\n" - .'- **ja**：日文。'."\n" - .'- **zh-tw**：繁体中文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListSparkLogAnalyzeTasks', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1DF5AF5B-C803-1861-A0FF-63666A557709\\",\\n \\"Data\\": {\\n \\"TaskList\\": [\\n {\\n \\"TaskId\\": 10,\\n \\"UserId\\": 0,\\n \\"SubmittedTimeInMillis\\": 1672123543000,\\n \\"TerminatedTimeInMillis\\": 1672123543000,\\n \\"TaskState\\": \\"WAITING\\",\\n \\"Result\\": {\\n \\"AppErrorCode\\": \\"EXCEEDED_QUOTA\\",\\n \\"AppErrorLog\\": \\"exception: cpu is exceeded limits 12/10\\",\\n \\"AppErrorAdvice\\": \\"Please increase cpu quota for your resource group\\"\\n },\\n \\"StartedTimeInMillis\\": 1672123543000,\\n \\"RuleMatched\\": true,\\n \\"TaskErrMsg\\": \\"Driver log not found\\",\\n \\"DBClusterId\\": \\"amv-adbxxxxx\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 20,\\n \\"TotalCount\\": 100\\n }\\n}","errorExample":""},{"type":"xml","example":"<ListSparkLogAnalyzeTasksResponse>\\n <RequestId>1DF5AF5B-C803-1861-A0FF-63666A557709</RequestId>\\n <Data>\\n <TaskList>\\n <TaskId>10</TaskId>\\n <SubmittedTimeInMillis>1672123543000</SubmittedTimeInMillis>\\n <TerminatedTimeInMillis>1672123543000</TerminatedTimeInMillis>\\n <TaskState>WAITING</TaskState>\\n <Result>\\n <AppErrorCode>EXCEEDED_QUOTA</AppErrorCode>\\n <AppErrorLog>exception: xxxx</AppErrorLog>\\n </Result>\\n <StartedTimeInMillis>1672123543000</StartedTimeInMillis>\\n <RuleMatched>true</RuleMatched>\\n <TaskErrMsg>Driver log not found</TaskErrMsg>\\n <DBClusterId>amv-adbxxxxx</DBClusterId>\\n </TaskList>\\n <PageNumber>1</PageNumber>\\n <PageSize>20</PageSize>\\n <TotalCount>100</TotalCount>\\n </Data>\\n</ListSparkLogAnalyzeTasksResponse>","errorExample":""}]', + ], + 'ListSparkTemplateFileIds' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'PatternId', - 'in' => 'query', - 'schema' => [ - 'description' => 'SQL Pattern的ID。', - 'type' => 'string', - 'required' => false, - 'example' => '5575924945138******', - ], + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ + [ + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => false, 'example' => 'amv-bp11q28kvl688****'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'PageNumber' => [ - 'description' => '页码，取值为大于0且不超过Integer数据类型的最大值。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'Querys' => [ - 'description' => 'SQL语句详情列表。', + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => [ + 'title' => '文件ID列表', + 'description' => '文件ID列表。', 'type' => 'array', - 'items' => [ - 'description' => '列表。', - 'type' => 'object', - 'properties' => [ - 'SQL' => [ - 'description' => 'SQL语句详情。'."\n" - .'> 出于性能考虑，当前SQL语句最长支持显示5120个字符，超出限制的SQL语句会被截断。您可以调用[DownloadDiagnosisRecords](~~308212~~)接口下载符合指定条件的SQL语句的摘要信息，包括完整的SQL语句。', - 'type' => 'string', - 'example' => 'SELECT count(*)\\nFROM nation', - ], - 'SQLTruncatedThreshold' => [ - 'description' => 'SQL语句的截断阈值，固定为5120个字符。超过该长度的SQL语句会被截断。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '5120', - ], - 'Status' => [ - 'description' => 'SQL语句的状态，取值为：'."\n" - .'- **running**：执行中。'."\n" - .'- **finished**：已完成。'."\n" - .'- **failed**：执行失败。', - 'type' => 'string', - 'example' => 'finished', - ], - 'OutputDataSize' => [ - 'description' => '返回数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '9', - ], - 'Cost' => [ - 'description' => '查询的总耗时。单位：毫秒。'."\n" - .'> 该耗时指标是`QueuedTime`、`TotalPlanningTime`和`ExecutionTime`三个耗时指标的累加值。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], - 'OutputRows' => [ - 'description' => '返回行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'RcHost' => [ - 'description' => '执行SQL语句的AnalyticDB MySQL前端节点IP和端口信息。', - 'type' => 'string', - 'example' => '10.0.XX.XX:3004', - ], - 'ScanSize' => [ - 'description' => '扫描数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '9', - ], - 'ProcessId' => [ - 'description' => '查询ID。', - 'type' => 'string', - 'example' => '2021093000414401000000023503151******', - ], - 'StartTime' => [ - 'description' => 'SQL语句的执行开始时间，格式为Unix时间戳，单位：毫秒。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1632933704000', - ], - 'SQLTruncated' => [ - 'description' => '查询结果的长度是否超过阈值（即是否被截断），取值说明：'."\n" - .'- **true**：查询结果的长度超过阈值。'."\n" - .'- **false**：查询结果的长度未超过阈值。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'Database' => [ - 'description' => '执行SQL语句的数据库名称。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - 'ScanRows' => [ - 'description' => '扫描行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'ResourceCostRank' => [ - 'description' => 'SQL语句内部算子的耗时排名。'."\n" - .'> 仅状态为执行中，即`Status`取值为`running`的SQL语句支持返回该字段。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'ClientIp' => [ - 'description' => '访问源地址。', - 'type' => 'string', - 'example' => '59.82.XX.XX', - ], - 'PeakMemory' => [ - 'description' => '峰值内存，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '16648', - ], - 'QueueTime' => [ - 'description' => '查询执行前的排队时间，单位：毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '6', - ], - 'ResourceGroup' => [ - 'description' => 'SQL语句所属的资源池。', - 'type' => 'string', - 'example' => 'user_default', - ], - 'UserName' => [ - 'description' => '执行SQL语句的用户名。', - 'type' => 'string', - 'example' => 'test_user', - ], - 'ExecutionTime' => [ - 'description' => '查询执行的耗时，单位：毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '6', - ], - 'TotalPlanningTime' => [ - 'description' => '生成执行计划的耗时，单位：毫秒（ms）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4', - ], - 'EtlWriteRows' => [ - 'description' => 'ETL任务写表的行数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'TotalStages' => [ - 'description' => '查询生成的总Stage数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'QueryProperties' => [ - 'description' => '当前查询最终生效的属性列表。'."\n" - ."\n" - .'> 常用属性列表，可以参考官方文档，[Config和Hint配置参数](~~408955~~)。', - 'type' => 'array', - 'items' => [ - 'description' => '属性键值描述。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '属性名称。', - 'type' => 'string', - 'example' => 'max_select_items_count', - ], - 'Value' => [ - 'description' => '属性值。', - 'type' => 'string', - 'example' => '1024', - ], - ], - ], - ], - 'PatternId' => [ - 'description' => 'SQL Pattern的ID。'."\n" - .'> 您可以调用[DescribePatternPerformance](~~612503~~)接口查看指定时间内该SQLPattern执行的详细指标。', - 'type' => 'string', - 'example' => '-5575924945138******', - ], - ], - ], - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '7F88BEFA-CF0B-5C95-8BB1-92EC9F09E40D', + 'items' => ['description' => 'Spark模板文件ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'], ], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'title' => '列出集群中的Spark模板文件ID', + 'summary' => '查询集群所有保存的Spark模板文件ID。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-07-27T06:45:54.000Z', 'description' => '错误码发生变更'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 1,\\n \\"Querys\\": [\\n {\\n \\"SQL\\": \\"SELECT count(*)\\\\\\\\nFROM nation\\",\\n \\"SQLTruncatedThreshold\\": 5120,\\n \\"Status\\": \\"finished\\",\\n \\"OutputDataSize\\": 9,\\n \\"Cost\\": 10,\\n \\"OutputRows\\": 1,\\n \\"RcHost\\": \\"10.0.XX.XX:3004\\",\\n \\"ScanSize\\": 9,\\n \\"ProcessId\\": \\"2021093000414401000000023503151******\\",\\n \\"StartTime\\": 1632933704000,\\n \\"SQLTruncated\\": false,\\n \\"Database\\": \\"adb_demo\\",\\n \\"ScanRows\\": 1,\\n \\"ResourceCostRank\\": 1,\\n \\"ClientIp\\": \\"59.82.XX.XX\\",\\n \\"PeakMemory\\": 16648,\\n \\"QueueTime\\": 6,\\n \\"ResourceGroup\\": \\"user_default\\",\\n \\"UserName\\": \\"test_user\\",\\n \\"ExecutionTime\\": 6,\\n \\"TotalPlanningTime\\": 4,\\n \\"EtlWriteRows\\": 0,\\n \\"TotalStages\\": 2,\\n \\"QueryProperties\\": [\\n {\\n \\"Name\\": \\"max_select_items_count\\",\\n \\"Value\\": \\"1024\\"\\n }\\n ],\\n \\"PatternId\\": \\"-5575924945138******\\"\\n }\\n ],\\n \\"RequestId\\": \\"7F88BEFA-CF0B-5C95-8BB1-92EC9F09E40D\\"\\n}","type":"json"}]', - 'title' => '查看SQL摘要信息', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeDownloadRecords' => [ - 'summary' => '查看目标AnalyticDB MySQL湖仓版（3.0）集群中最近5次的SQL查询下载任务列表。', - 'methods' => [ - 'post', - 'get', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListSparkTemplateFileIds'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListSparkTemplateFileIds', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": [\\n 10\\n ]\\n}","errorExample":""},{"type":"xml","example":"<ListSparkTemplateFileIdsResponse>\\n <Data>10</Data>\\n <Data>20</Data>\\n <Data>30</Data>\\n</ListSparkTemplateFileIdsResponse>","errorExample":""}]', + ], + 'ListSparkWarehouseBatchSQL' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -34355,120 +24658,101 @@ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '132356', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '236211', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-8vb6ha79k6e****', - ], + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1ub9grke1****'], ], [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'name' => 'ResourceGroupName', + 'in' => 'formData', + 'schema' => ['description' => '开启了Spark引擎的Interactive型资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], ], [ - 'name' => 'Lang', - 'in' => 'query', - 'schema' => [ - 'description' => '语言配置，取值说明：'."\n" - .'- **zh**：简体中文（默认语言）。'."\n" - .'- **en**：英文。'."\n" - .'- **ja**：日文。'."\n" - .'- **zh-tw**：繁体中文。', - 'type' => 'string', - 'deprecated' => true, - 'required' => false, - 'example' => 'zh', - ], + 'name' => 'PageNumber', + 'in' => 'formData', + 'schema' => ['description' => '当前页数。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1', 'default' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'formData', + 'schema' => ['description' => '每页记录数。', 'type' => 'string', 'required' => false, 'example' => '30', 'default' => '10'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'Records' => [ - 'description' => '详情。', - 'type' => 'array', - 'items' => [ - 'description' => '下载列表详情。', - 'type' => 'object', - 'properties' => [ - 'Status' => [ - 'description' => '任务状态，取值为：'."\n" - .'- **running**：正在下载。'."\n" - .'- **finished**：已完成。'."\n" - .'- **failed**：下载失败。', - 'type' => 'string', - 'example' => 'finished', - ], - 'DownloadId' => [ - 'description' => '下载任务ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '636890', - ], - 'ExceptionMsg' => [ - 'description' => '下载任务失败时返回的异常信息。', - 'type' => 'string', - 'example' => 'The query result is empty.', - ], - 'Url' => [ - 'description' => '文件下载地址。', - 'type' => 'string', - 'example' => 'https://perth-download-task.oss-cn-beijing.aliyuncs.com/adbmysql/query-sql-logs/amv-*********/20210805104301-20210805164302.xlsx?Expires=1943514161&OSSAccessKeyId=*********&Signature=******"', - ], - 'FileName' => [ - 'description' => '下载文件名。', - 'type' => 'string', - 'example' => '20210806094635-20210806095135', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => [ + 'description' => '返回结果数据。', + 'type' => 'object', + 'properties' => [ + 'Total' => ['description' => '总条数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'PageNumber' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'PageSize' => ['description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], + 'Queries' => [ + 'description' => 'Spark SQL执行列表。', + 'type' => 'array', + 'items' => ['description' => 'Spark SQL结果的结构体。', 'example' => '[{\\"doc_id\\":[\\"1293619227704606720\\"]}]', '$ref' => '#/components/schemas/SparkBatchSQL'], ], ], ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D761DA51-12F8-5457-AAA9-F52B9F436D2D', - ], - 'AccessDeniedDetail' => [ - 'type' => 'string', - ], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"Records\\": [\\n {\\n \\"Status\\": \\"finished\\",\\n \\"DownloadId\\": 636890,\\n \\"ExceptionMsg\\": \\"The query result is empty.\\",\\n \\"Url\\": \\"https://perth-download-task.oss-cn-beijing.aliyuncs.com/adbmysql/query-sql-logs/amv-*********/20210805104301-20210805164302.xlsx?Expires=1943514161&OSSAccessKeyId=*********&Signature=******\\\\\\"\\",\\n \\"FileName\\": \\"20210806094635-20210806095135\\"\\n }\\n ],\\n \\"RequestId\\": \\"D761DA51-12F8-5457-AAA9-F52B9F436D2D\\",\\n \\"AccessDeniedDetail\\": \\"\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeDownloadRecordsResponse>\\n <Records>\\n <Status>finished</Status>\\n <DownloadId>636890</DownloadId>\\n <ExceptionMsg>The query result is empty.</ExceptionMsg>\\n <Url>https://perth-download-task.oss-cn-beijing.aliyuncs.com/adbmysql/query-sql-logs/amv-*********/20210805104301-20210805164302.xlsx?Expires=1943514161&OSSAccessKeyId=*********&Signature=******\\"</Url>\\n <FileName>20210806094635-20210806095135</FileName>\\n </Records>\\n <RequestId>D761DA51-12F8-5457-AAA9-F52B9F436D2D</RequestId>\\n</DescribeDownloadRecordsResponse>","errorExample":""}]', - 'title' => '查看最近5次的SQL查询下载任务列表', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeSqlPattern' => [ - 'summary' => '查看指定日期内AnalyticDB for MySQL集群的SQL Pattern详情。', - 'methods' => [ - 'post', - 'get', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '分页查询所有执行的Spark SQL', + 'summary' => '分页查询所有执行的Spark SQL。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListSparkWarehouseBatchSQL'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListSparkWarehouseBatchSQL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"Total\\": 0,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 20,\\n \\"Queries\\": [\\n {\\n \\"Uid\\": 0,\\n \\"QuerySubmissionTime\\": 1723521767000,\\n \\"Query\\": \\"SELECT * FROM db.tb\\",\\n \\"QueryId\\": \\"sq172352176****\\",\\n \\"Schema\\": \\"default\\",\\n \\"QueryEndTime\\": 1723521767000,\\n \\"DBClusterId\\": \\"amv-bp17s73f016****\\",\\n \\"QueryState\\": \\"RUNNING\\",\\n \\"Statements\\": [\\n {\\n \\"ResultUri\\": \\"oss://yourbucket/result.json\\",\\n \\"EndTime\\": 1723521767000,\\n \\"AppId\\": \\"s20240122jsdx****\\",\\n \\"StatementId\\": \\"sq1723521767****-0001\\",\\n \\"State\\": \\"RUNNING\\",\\n \\"StartTime\\": 1723521767000,\\n \\"Error\\": \\"table is not found\\",\\n \\"Code\\": \\"SELECT 100\\",\\n \\"Result\\": \\"+---+-----+\\\\n|age| name|\\\\n+---+-----+\\\\n| 14| Tom|\\\\n| 23|Alice|\\\\n+---+-----+\\"\\n }\\n ],\\n \\"ErrMessage\\": \\"schema is not found\\",\\n \\"QueryStartTime\\": 1723521767000,\\n \\"ResourceGroupName\\": \\"spark_rg\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'ListTagResources' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -34480,131 +24764,136 @@ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '132339', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeNodes' => ['FEATUREadsSUMGII'], ], 'parameters' => [ [ - 'name' => 'StartTime', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '查询开始日期，UTC时间，格式：yyyy-MM-dd。'."\n" - .'> 仅支持查看30天内的数据。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2022-08-30', - ], + 'schema' => ['description' => '地域ID，您可通过接口[DescribeRegions](~~143074~~)查看可用的地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'Order', + 'name' => 'ResourceType', 'in' => 'query', - 'schema' => [ - 'description' => '将查询结果按指定字段进行排序。格式为JSON字符串，例如`[{"Field":"Pattern","Type":"Asc"}]`。其中：'."\n" - .'- `Field`表示排序字段。取值说明：'."\n" - .' - `Pattern`：SQL Pattern。'."\n" - .' - `AccessIP`：客户端IP。'."\n" - .' - `User`：用户名。'."\n" - .' - `QueryCount`：查询总数。'."\n" - .' - `AvgPeakMemory`：平均峰值内存，单位：KB。'."\n" - .' - `MaxPeakMemory`：最大峰值内存，单位：KB。'."\n" - .' - `AvgCpuTime`：平均计算耗时，单位：毫秒（ms）。'."\n" - .' - `MaxCpuTime`：最大计算耗时，单位：毫秒（ms）。'."\n" - .' - `AvgStageCount`：平均Stage个数。'."\n" - .' - `MaxStageCount`：最大Stage个数。'."\n" - .' - `AvgTaskCount`：平均Task个数。'."\n" - .' - `MaxTaskCount`：最大Task个数。'."\n" - .' - `AvgScanSize`：平均扫描量，单位：KB。'."\n" - .' - `MaxScanSize`：最大扫描量，单位：KB。'."\n" - ."\n" - .'- `Type`表示排序方式。取值说明：'."\n" - .' - `Asc`：升序排序。'."\n" - .' - `Desc`： 降序排序。'."\n" - ."\n" - .'> - 若不设置参数，默认按照`Pattern`字段升序排列。'."\n" - .'- 若需要按照`AccessIP`字段排序，则`Type`参数必须设置为`accessip`；若需要按照`User`字段排序，则`Type`参数必须留空或设置为`user`。'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => '[{"Field":"Pattern","Type":"Asc"}]', - ], + 'schema' => ['description' => '资源类型定义。唯一取值：**dbclusterlakeversion**。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'dbclusterlakeversion'], ], [ - 'name' => 'PageNumber', + 'name' => 'NextToken', 'in' => 'query', - 'schema' => [ - 'description' => '页码，取值：大于0且不超过Integer的最大值。'."\n" - .'默认值：1。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '2', - ], + 'schema' => ['description' => '用来返回更多结果。第一次查询不需要提供这个参数，如果一次查询没有返回全部结果，则可在后续查询中传入前一次返回的 Token 继续查询。', 'type' => 'string', 'required' => false, 'example' => '212db86sca4384811e0b5e8707ec21345'], ], [ - 'name' => 'SqlPattern', + 'name' => 'ResourceId', 'in' => 'query', + 'style' => 'repeatList', 'schema' => [ - 'description' => '需要包含的SQL Pattern的关键字。'."\n" - .'> 若该参数不填，默认返回目标集群在`StartTime`参数所设日期内的所有SQL Pattern详情。', - 'type' => 'string', + 'description' => '集群ID。支持同时传入多个集群ID，N的取值范围为：1~50。'."\n" + .'> ResourceId.N参数和Tag.N.Key参数至少传入一个。', + 'type' => 'array', + 'items' => ['description' => '集群ID。支持同时传入多个集群ID，N的取值范围为：1~50。'."\n" + .'> ResourceId.N参数和Tag.N.Key参数至少传入一个。', 'type' => 'string', 'required' => false, 'example' => 'amv-bp1l20nxxxxxxxxxx'], 'required' => false, - 'example' => 'SELECT', + 'maxItems' => 51, ], ], [ - 'name' => 'Type', + 'name' => 'Tag', 'in' => 'query', + 'style' => 'repeatList', 'schema' => [ - 'description' => '按指定维度来聚合SQL Pattern。取值说明：'."\n" - .' - `user`：按用户维度聚合。'."\n" - .' - `accessip`：按访问IP来源聚合。'."\n" - ."\n" - .'> 若该参数不填，默认按照 `user`维度聚合。', - 'type' => 'string', + 'description' => '标签。', + 'type' => 'array', + 'items' => [ + 'description' => '标签列表信息。', + 'type' => 'object', + 'properties' => [ + 'Key' => ['description' => '标签键。支持同时传入多个标签键，不允许传入空字符串。N的取值范围为：1~20。'."\n" + ."\n" + .'> ResourceId.N参数和Tag.N.Key参数至少传入一个。'."\n", 'type' => 'string', 'required' => false, 'example' => 'testkey1'], + 'Value' => ['description' => '标签键对应的标签值。支持同时传入多个标签值，允许传入空字符串。N的取值范围为：1~20。', 'type' => 'string', 'required' => false, 'example' => 'testvalue1'], + ], + 'required' => false, + ], 'required' => false, - 'example' => 'user', + 'maxItems' => 21, ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1ej1nq9n6****', + 'type' => 'object', + 'properties' => [ + 'NextToken' => ['description' => '用来返回更多结果。如果一次查询没有返回全部结果，则可在后续查询中传入前一次返回的 token 继续查询。', 'type' => 'string', 'example' => '212db86sca4384811e0b5e8707ec21345'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '184DE106-CB2C-4DD2-B57F-396652E6C8F8'], + 'TagResources' => [ + 'type' => 'object', + 'itemNode' => true, + 'properties' => [ + 'TagResource' => [ + 'description' => '查询到的集群和标签的信息。', + 'type' => 'array', + 'items' => [ + 'description' => '列表。', + 'type' => 'object', + 'properties' => [ + 'ResourceType' => ['description' => '资源类型。', 'type' => 'string', 'example' => 'dbclusterlakeversion'], + 'TagValue' => ['description' => '标签键对应的标签值。', 'type' => 'string', 'example' => 'testvalue1'], + 'ResourceId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp1l20nxxxxxxxxxx'], + 'TagKey' => ['description' => '标签键。', 'type' => 'string', 'example' => 'testkey1'], + ], + ], + ], + ], + 'description' => '', + ], + ], + 'description' => '', ], ], + ], + 'title' => '查询标签列表', + 'summary' => '调用ListTagResources查询一个或多个AnalyticDB MySQL集群已绑定的标签列表，或者查询一个或多个标签绑定的AnalyticDB MySQL集群列表。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListTagResources'], + ], + ], + 'ramActions' => [ [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **10**（默认值）'."\n" - .'- **30**'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListTagResources', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"NextToken\\": \\"212db86sca4384811e0b5e8707ec21345\\",\\n \\"RequestId\\": \\"184DE106-CB2C-4DD2-B57F-396652E6C8F8\\",\\n \\"TagResources\\": {\\n \\"TagResource\\": [\\n {\\n \\"ResourceType\\": \\"dbclusterlakeversion\\",\\n \\"TagValue\\": \\"testvalue1\\",\\n \\"ResourceId\\": \\"amv-bp1l20nxxxxxxxxxx\\",\\n \\"TagKey\\": \\"testkey1\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'LoadSampleDataSet' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'RegionId', + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ + [ + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 调用[DescribeDBClusters](~~454250~~)接口查看集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-2ze0z517o1mg****'], ], ], 'responses' => [ @@ -34612,765 +24901,471 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '50', - ], - 'Items' => [ - 'description' => '列表详情。', - 'type' => 'array', - 'items' => [ - 'description' => '列表详情。', - 'type' => 'object', - 'properties' => [ - 'AvgStageCount' => [ - 'description' => '平均扫描行数。', - 'type' => 'string', - 'example' => '2', - ], - 'MaxCpuTime' => [ - 'description' => 'SQL的最大运行时间，单位：毫秒（ms）。', - 'type' => 'string', - 'example' => '17', - ], - 'AccessIP' => [ - 'description' => '客户端IP。'."\n" - .'> 仅当**Type**参数设置为**accessip**时，返回该参数。', - 'type' => 'string', - 'example' => '100.104.xx.xx', - ], - 'AvgScanSize' => [ - 'description' => '平均扫描量，单位：KB。', - 'type' => 'string', - 'example' => '244', - ], - 'MaxScanSize' => [ - 'description' => '最大扫描量，单位：KB。', - 'type' => 'string', - 'example' => '1024', - ], - 'MaxPeakMemory' => [ - 'description' => '最大峰值内存，单位：KB。', - 'type' => 'string', - 'example' => '480096', - ], - 'AvgCpuTime' => [ - 'description' => '平均执行时间，单位：毫秒（ms）。', - 'type' => 'string', - 'example' => '1.0625', - ], - 'User' => [ - 'description' => '用户名。'."\n" - .'> 仅当**Type**参数留空或设置为**user**时，返回该参数。', - 'type' => 'string', - 'example' => 'test_acc', - ], - 'AvgPeakMemory' => [ - 'description' => '平均峰值内存，单位：KB。', - 'type' => 'string', - 'example' => '240048', - ], - 'MaxStageCount' => [ - 'description' => '最大Stage个数。', - 'type' => 'string', - 'example' => '2', - ], - 'MaxTaskCount' => [ - 'description' => '最大任务数。', - 'type' => 'string', - 'example' => '2', - ], - 'InstanceName' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp1ej1nq9n6****', - ], - 'QueryCount' => [ - 'description' => '查询总数。', - 'type' => 'string', - 'example' => '16', - ], - 'ReportDate' => [ - 'description' => '查询日期。', - 'type' => 'string', - 'example' => '2022-08-30', - ], - 'Pattern' => [ - 'description' => 'SQL Pattern。', - 'type' => 'string', - 'example' => 'SELECT table_name, table_schema AS schema_name, create_time, create_time AS last_ddl_time, table_comment AS description , ceil((data_length + index_length) / ? / ?) AS store_capacity , data_length AS data_bytes, index_length AS index_bytes, table_collation AS collation, auto_increment, table_rows AS num_rows , engine FROM information_schema.tables WHERE table_type != ? AND table_schema = ? AND table_name IN (?) ORDER BY 1', - ], - 'AvgTaskCount' => [ - 'description' => '平均任务数。', - 'type' => 'string', - 'example' => '2', - ], - ], - ], - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'DB1F6C23-CBCA-5260-9366-BA7BB5EBF6F1', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'FA31BE84-ABE8-554A-A769-5F860C34EE10'], + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-2ze0z517o1mg****'], ], + 'description' => '', ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"PageSize\\": 30,\\n \\"PageNumber\\": 2,\\n \\"TotalCount\\": 50,\\n \\"Items\\": [\\n {\\n \\"AvgStageCount\\": \\"2\\",\\n \\"MaxCpuTime\\": \\"17\\",\\n \\"AccessIP\\": \\"100.104.xx.xx\\",\\n \\"AvgScanSize\\": \\"244\\",\\n \\"MaxScanSize\\": \\"1024\\",\\n \\"MaxPeakMemory\\": \\"480096\\",\\n \\"AvgCpuTime\\": \\"1.0625\\",\\n \\"User\\": \\"test_acc\\",\\n \\"AvgPeakMemory\\": \\"240048\\",\\n \\"MaxStageCount\\": \\"2\\",\\n \\"MaxTaskCount\\": \\"2\\",\\n \\"InstanceName\\": \\"amv-bp1ej1nq9n6****\\",\\n \\"QueryCount\\": \\"16\\",\\n \\"ReportDate\\": \\"2022-08-30\\",\\n \\"Pattern\\": \\"SELECT table_name, table_schema AS schema_name, create_time, create_time AS last_ddl_time, table_comment AS description , ceil((data_length + index_length) / ? / ?) AS store_capacity , data_length AS data_bytes, index_length AS index_bytes, table_collation AS collation, auto_increment, table_rows AS num_rows , engine FROM information_schema.tables WHERE table_type != ? AND table_schema = ? AND table_name IN (?) ORDER BY 1\\",\\n \\"AvgTaskCount\\": \\"2\\"\\n }\\n ],\\n \\"RequestId\\": \\"DB1F6C23-CBCA-5260-9366-BA7BB5EBF6F1\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeSqlPatternResponse>\\n <PageSize>30</PageSize>\\n <PageNumber>2</PageNumber>\\n <TotalCount>50</TotalCount>\\n <Items>\\n <AvgStageCount>2</AvgStageCount>\\n <MaxCpuTime>17</MaxCpuTime>\\n <AccessIP>100.104.xx.xx</AccessIP>\\n <AvgScanSize>244</AvgScanSize>\\n <MaxScanSize>1024</MaxScanSize>\\n <MaxPeakMemory>480096</MaxPeakMemory>\\n <AvgCpuTime>1.0625</AvgCpuTime>\\n <User>test_acc</User>\\n <AvgPeakMemory>240048</AvgPeakMemory>\\n <MaxStageCount>2</MaxStageCount>\\n <MaxTaskCount>2</MaxTaskCount>\\n <InstanceName>amv-bp1ej1nq9n6****</InstanceName>\\n <QueryCount>16</QueryCount>\\n <ReportDate>2022-08-30</ReportDate>\\n <Pattern>SELECT table_name, table_schema AS schema_name, create_time, create_time AS last_ddl_time, table_comment AS description , ceil((data_length + index_length) / ? / ?) AS store_capacity , data_length AS data_bytes, index_length AS index_bytes, table_collation AS collation, auto_increment, table_rows AS num_rows , engine FROM information_schema.tables WHERE table_type != ? AND table_schema = ? AND table_name IN (?) ORDER BY 1</Pattern>\\n <AvgTaskCount>2</AvgTaskCount>\\n </Items>\\n <RequestId>DB1F6C23-CBCA-5260-9366-BA7BB5EBF6F1</RequestId>\\n</DescribeSqlPatternResponse>","errorExample":""}]', - 'title' => '查询SQL Pattern详情', + 'title' => '加载内置数据集', + 'summary' => '调用LoadSampleDataSet接口加载内置数据集。', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeSQLPatterns' => [ - 'summary' => '查看指定日期内AnalyticDB MySQL湖仓版集群的SQL Pattern列表。', - 'methods' => [ - 'post', - 'get', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'LoadSampleDataSet'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:LoadSampleDataSet', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FA31BE84-ABE8-554A-A769-5F860C34EE10\\",\\n \\"DBClusterId\\": \\"amv-2ze0z517o1mg****\\"\\n}","type":"json"}]', + ], + 'ModifyAccountDescription' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '132328', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeCode' => '130693', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => 'AnalyticDB MySQL湖仓版集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-8vb8de93v9b****', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'StartTime', + 'name' => 'AccountName', 'in' => 'query', - 'schema' => [ - 'description' => '查询开始时间。UTC时间，格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>。'."\n" - .'> - 仅支持查看最近14天的数据。'."\n" - .'- 查询开始时间和查询结束时间的间隔不能大于24小时。 ', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2022-09-06T03:06:00Z', - ], + 'schema' => ['description' => '数据库账号。'."\n" + .'> 您可以调用[DescribeAccounts](~~612430~~)接口查看指定集群的数据库账号信息，包括数据库账号。', 'type' => 'string', 'required' => true, 'example' => 'testacc'], ], [ - 'name' => 'EndTime', + 'name' => 'AccountDescription', 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间。UTC时间，格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>。'."\n" - .'> 查询结束时间需晚于查询开始时间。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2022-09-07T03:06:00Z', - ], + 'schema' => ['description' => '账号描述。'."\n" + .'- 不能以`http://`、`https:// `开头。'."\n" + .'- 长度为2~256个字符。', 'type' => 'string', 'required' => true, 'example' => 'AccDesc'], ], [ - 'name' => 'RegionId', + 'name' => 'Engine', 'in' => 'query', 'schema' => [ - 'description' => '地域ID。', + 'description' => '数据库引擎，取值：'."\n" + ."\n" + .'- **AnalyticDB**（默认）：AnalyticDB MySQL引擎。'."\n" + .'- **Clickhouse**：宽表引擎。', 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', + 'required' => false, + 'enumValueTitles' => [], + 'example' => 'Clickhouse', ], ], - [ - 'name' => 'Keyword', - 'in' => 'query', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '查询关键字。', - 'type' => 'string', - 'required' => false, - 'example' => 'SELECT', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + ], ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidAccountDescription.Malformed', 'errorMessage' => 'The specified parameter AccountDescription is not valid.', 'description' => 'AccountDescription参数不正确，请确认参数是否符合规范。'."\n"], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'ACS.InvalidParameter.%s', 'errorMessage' => 'Parameter %s is invalid.', 'description' => '输入的参数无效'], + ], + ], + 'title' => '修改数据库账号的备注信息', + 'summary' => '修改目标集群的数据库账号的备注信息。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-06-13T13:53:51.000Z', 'description' => '错误码发生变更、请求参数发生变更'], + ['createdAt' => '2023-03-31T07:03:59.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:51:57.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyAccountDescription'], + ], + ], + 'ramActions' => [ [ - 'name' => 'Order', - 'in' => 'query', - 'schema' => [ - 'description' => '将查询结果按指定字段进行排序。格式为JSON字符串，例如`[{"Field":"AverageQueryTime","Type":"Asc"}]`。其中：'."\n" - .'- `Field`表示排序字段。取值说明：'."\n" - .' - `PatternCreationTime`：查询时间范围内，Pattern的最早提交时间。'."\n" - .' - `AverageQueryTime`：查询时间范围内，Pattern的平均总耗时。'."\n" - .' - `MaxQueryTime`：查询时间范围内，Pattern的最大总耗时。'."\n" - .' - `AverageExecutionTime`: 查询时间范围内，Pattern的平均执行耗时。'."\n" - .' - `MaxExecutionTime`: 查询时间范围内，Pattern的最大执行耗时。'."\n" - .' - `AveragePeakMemory`: 查询时间范围内，Pattern的平均峰值内存。'."\n" - .' - `MaxPeakMemory`: 查询时间范围内，Pattern的最大峰值内存。'."\n" - .' - `AverageScanSize`: 查询时间范围内，Pattern的平均数据读取量。'."\n" - .' - `MaxScanSize`: 查询时间范围内，Pattern的最大数据读取量。'."\n" - .' - `QueryCount`: 查询时间范围内，Pattern的执行次数。'."\n" - .' - `FailedCount`: 查询时间范围内，Pattern的失败次数。'."\n" - ."\n" - .'- `Type`表示排序方式。取值说明（取值不区分大小写）：'."\n" - .' - `Asc`：升序排序。'."\n" - .' - `Desc`： 降序排序。', - 'type' => 'string', - 'required' => false, - 'example' => '[{"Field":"AverageQueryTime","Type":"Asc"}]', - 'default' => '[{"Type":"desc","Field":"AveragePeakMemory"}]', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyAccountDescription', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyAccountDescriptionResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n</ModifyAccountDescriptionResponse>","errorExample":""}]', + ], + 'ModifyAccountPrivileges' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'PageNumber', + 'AK' => [], + ], + ], + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'abilityTreeCode' => '159109', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '页码，取值：大于0且不超过Integer的最大值。'."\n" - .'默认值：1。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '2', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'PageSize', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **10**（默认值）'."\n" - .'- **30**'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '10', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1k5p066e1a****'], ], [ - 'name' => 'Lang', + 'name' => 'AccountName', 'in' => 'query', - 'schema' => [ - 'description' => '语言配置，取值说明：'."\n" - .'- **zh**：简体中文（默认语言）。'."\n" - .'- **en**：英文。'."\n" - .'- **ja**：日文。'."\n" - .'- **zh-tw**：繁体中文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', - ], + 'schema' => ['description' => '数据库账号名称。', 'type' => 'string', 'required' => true, 'example' => 'account1'], ], [ - 'name' => 'UserName', + 'name' => 'AccountPrivileges', 'in' => 'query', - 'allowEmptyValue' => true, + 'style' => 'json', 'schema' => [ - 'type' => 'string', - 'required' => false, + 'description' => '授予的权限列表。', + 'type' => 'array', + 'items' => [ + 'description' => '权限详情。', + 'type' => 'object', + 'properties' => [ + 'PrivilegeObject' => [ + 'description' => '权限对象，为库表列的三元组。', + 'type' => 'object', + 'properties' => [ + 'Database' => ['description' => '授权的数据库，当为库、表和列权限级别时此参数必传。', 'type' => 'string', 'required' => false, 'example' => 'tsdb1'], + 'Table' => ['description' => '授权的表，当为表和列权限级别时此参数必传。', 'type' => 'string', 'required' => false, 'example' => 'table1'], + 'Column' => ['description' => '授权的列，当为列权限级别时此参数必传。', 'type' => 'string', 'required' => false, 'example' => 'column1'], + ], + 'required' => false, + ], + 'Privileges' => [ + 'description' => '授予的权限列表。', + 'type' => 'array', + 'items' => ['description' => '权限，来自接口`DescribeEnabledPrivileges`。', 'type' => 'string', 'required' => false, 'example' => 'select'], + 'required' => false, + ], + 'PrivilegeType' => ['description' => '权限级别，来自接口`DescribeEnabledPrivileges`。', 'type' => 'string', 'required' => false, 'example' => 'Global'], + ], + 'required' => false, + ], + 'required' => true, ], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => 'SQL Pattern的详细信息。', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'PatternDetails' => [ - 'description' => '列表。', - 'type' => 'array', - 'items' => [ - 'description' => 'SQL Pattern的详细信息。', - 'type' => 'object', - 'properties' => [ - 'SQLPattern' => [ - 'description' => 'SQL Pattern的语句。', - 'type' => 'string', - 'example' => 'SELECT * FROM KEPLER_META_NODE_STATIC_INFO WHERE elastic_node = ? OR (elastic_node = ? AND enable = ?)', - ], - 'PatternId' => [ - 'description' => 'SQL Pattern语句的ID。', - 'type' => 'string', - 'example' => '5575924945138******', - ], - 'User' => [ - 'description' => '提交Pattern相关的SQL数据库用户名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'AccessIp' => [ - 'description' => '提交Pattern的相关SQL客户端IP地址。', - 'type' => 'string', - 'example' => '192.168.xx.xx', - ], - 'Tables' => [ - 'description' => 'SQL Pattern扫描的列表信息。', - 'type' => 'string', - 'example' => 'tpch.orders', - ], - 'PatternCreationTime' => [ - 'description' => '指定时间范围内，Pattern的最早提交时间。', - 'type' => 'string', - 'example' => '2022-09-06 05:06:00', - ], - 'AverageQueryTime' => [ - 'description' => '指定时间范围内，Pattern的平均总耗时。单位：毫秒。', - 'type' => 'number', - 'format' => 'double', - 'example' => '4', - ], - 'MaxQueryTime' => [ - 'description' => '指定时间范围内，Pattern的最大总耗时。单位：毫秒。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2341', - ], - 'AverageExecutionTime' => [ - 'description' => '指定时间范围内，Pattern的平均执行时间。单位：毫秒。', - 'type' => 'number', - 'format' => 'double', - 'example' => '234.78', - ], - 'MaxExecutionTime' => [ - 'description' => '指定时间范围内，Pattern的最大执行时间。单位：毫秒。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2142', - ], - 'AveragePeakMemory' => [ - 'description' => '指定时间范围内，Pattern的平均峰值内存。单位：Byte。', - 'type' => 'number', - 'format' => 'double', - 'example' => '234.22', - ], - 'MaxPeakMemory' => [ - 'description' => 'Pattern相关SQL的最大峰值内存，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '234149', - ], - 'AverageScanSize' => [ - 'description' => '指定时间范围内，Pattern的平均数据读取量。单位：Byte。', - 'type' => 'number', - 'format' => 'double', - 'example' => '234149.23', - ], - 'MaxScanSize' => [ - 'description' => 'Pattern相关SQL的最大数据读取量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '32212254', - ], - 'QueryCount' => [ - 'description' => '指定时间范围内，Pattern的执行次数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '345', - ], - 'FailedCount' => [ - 'description' => '指定时间范围内，Pattern的失败次数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '18', - ], - 'Blockable' => [ - 'description' => '能否拦截当前SQL Pattern的运行，取值说明：'."\n" - .'* **true**：支持拦截。'."\n" - .'* **false**：不支持拦截。'."\n" - .'> 目前AnalyticDB MySQL版仅支持Select和Insert相关语句的拦截。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'QueryTimeSum' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'QueryTimePercentage' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'PeakMemorySum' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'PeakMemoryPercentage' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'ScanSizeSum' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'ScanSizePercentage' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'AverageOperatorCost' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'MaxOperatorCost' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'OperatorCostSum' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'OperatorCostPercentage' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'AverageScanCost' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'MaxScanCost' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'ScanCostSum' => [ - 'type' => 'number', - 'format' => 'double', - ], - 'ScanCostPercentage' => [ - 'type' => 'number', - 'format' => 'double', - ], - ], - ], - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'F3174013-5B7A-5A47-9FE0-6B5D397BD86A', - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息；只有Ram校验失败才会返回此字段。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1*****************7",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "2***************9",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .'}', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID', 'type' => 'string', 'example' => '9DD88DE7-824F-1082-AA57-575AFC6517A8'], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"PageNumber\\": 2,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 20,\\n \\"PatternDetails\\": [\\n {\\n \\"SQLPattern\\": \\"SELECT * FROM KEPLER_META_NODE_STATIC_INFO WHERE elastic_node = ? OR (elastic_node = ? AND enable = ?)\\",\\n \\"PatternId\\": \\"5575924945138******\\",\\n \\"User\\": \\"test\\",\\n \\"AccessIp\\": \\"192.168.xx.xx\\",\\n \\"Tables\\": \\"tpch.orders\\",\\n \\"PatternCreationTime\\": \\"2022-09-06 05:06:00\\",\\n \\"AverageQueryTime\\": 4,\\n \\"MaxQueryTime\\": 2341,\\n \\"AverageExecutionTime\\": 234.78,\\n \\"MaxExecutionTime\\": 2142,\\n \\"AveragePeakMemory\\": 234.22,\\n \\"MaxPeakMemory\\": 234149,\\n \\"AverageScanSize\\": 234149.23,\\n \\"MaxScanSize\\": 32212254,\\n \\"QueryCount\\": 345,\\n \\"FailedCount\\": 18,\\n \\"Blockable\\": true,\\n \\"QueryTimeSum\\": 0,\\n \\"QueryTimePercentage\\": 0,\\n \\"PeakMemorySum\\": 0,\\n \\"PeakMemoryPercentage\\": 0,\\n \\"ScanSizeSum\\": 0,\\n \\"ScanSizePercentage\\": 0,\\n \\"AverageOperatorCost\\": 0,\\n \\"MaxOperatorCost\\": 0,\\n \\"OperatorCostSum\\": 0,\\n \\"OperatorCostPercentage\\": 0,\\n \\"AverageScanCost\\": 0,\\n \\"MaxScanCost\\": 0,\\n \\"ScanCostSum\\": 0,\\n \\"ScanCostPercentage\\": 0\\n }\\n ],\\n \\"RequestId\\": \\"F3174013-5B7A-5A47-9FE0-6B5D397BD86A\\",\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeSQLPatternsResponse>\\n <PageNumber>2</PageNumber>\\n <PageSize>10</PageSize>\\n <TotalCount>20</TotalCount>\\n <PatternDetails>\\n <SQLPattern>SELECT * FROM KEPLER_META_NODE_STATIC_INFO WHERE elastic_node = ? OR (elastic_node = ? AND enable = ?)</SQLPattern>\\n <PatternId>5575924945138******</PatternId>\\n <User>test</User>\\n <AccessIp>192.168.xx.xx</AccessIp>\\n <Tables>tpch.orders</Tables>\\n <PatternCreationTime>2022-09-06 05:06:00</PatternCreationTime>\\n <AverageQueryTime>4</AverageQueryTime>\\n <MaxQueryTime>2341</MaxQueryTime>\\n <AverageExecutionTime>234.78</AverageExecutionTime>\\n <MaxExecutionTime>2142</MaxExecutionTime>\\n <AveragePeakMemory>234.22</AveragePeakMemory>\\n <MaxPeakMemory>234149</MaxPeakMemory>\\n <AverageScanSize>234149.23</AverageScanSize>\\n <MaxScanSize>32212254</MaxScanSize>\\n <QueryCount>345</QueryCount>\\n <FailedCount>18</FailedCount>\\n <Blockable>true</Blockable>\\n </PatternDetails>\\n <RequestId>F3174013-5B7A-5A47-9FE0-6B5D397BD86B</RequestId>\\n</DescribeSQLPatternsResponse>","errorExample":""}]', - 'title' => '查询SQL Pattern列表', - 'description' => '- 中心的公网接入地址：`adb.aliyuncs.com`。'."\n" - .'- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'DescribePatternPerformance' => [ - 'summary' => '查看集群指定时间段内SQL Pattern的各指标（如查询时间、平均内存消耗）详情。', - 'methods' => [ - 'post', - 'get', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'ACS.Privilege.ModifyFailed', 'errorMessage' => 'Failed to modify the account privilege. Make sure that bound account have sufficient database privileges.', 'description' => '修改账户权限失败，请检查发起请求的用户绑定的数据库账户是否有足够的数据库权限。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'ACS.Parameter.Malformed', 'errorMessage' => 'The following required parameters are not specified: %s', 'description' => '没有指定所需的参数。'], + ['errorCode' => 'ACS.InvalidParameter.%s', 'errorMessage' => 'Parameter %s is invalid.', 'description' => '输入的参数无效'], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => ''], + ['errorCode' => 'ACS.User.NotBindDatabaseAccount', 'errorMessage' => 'The user has not been associated with a database account.', 'description' => '用户没有绑定数据库账户。'], + ], + ], + 'title' => ' 修改数据库账户的权限', + 'summary' => '修改某一数据库账户的权限。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-04-09T11:07:49.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-04-20T14:39:16.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-03-24T06:25:38.000Z', 'description' => '请求参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyAccountPrivileges'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyAccountPrivileges', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9DD88DE7-824F-1082-AA57-575AFC6517A8\\"\\n}","type":"json"}]', + ], + 'ModifyApsDatasoure' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '132321', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsY28JLD'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'query', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-*******'], + ], + [ + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-shanghai'], + ], + [ + 'name' => 'DatasourceId', + 'in' => 'formData', + 'schema' => ['description' => '数据源ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1'], + ], + [ + 'name' => 'DatasourceName', + 'in' => 'formData', + 'schema' => ['description' => '数据源名称。', 'type' => 'string', 'required' => false, 'example' => 'sls-******'], + ], + [ + 'name' => 'DatasourceDescription', + 'in' => 'formData', + 'schema' => ['description' => '数据源描述。', 'type' => 'string', 'required' => false, 'example' => 'test'], + ], + [ + 'name' => 'SlsInfo', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-uf6li1r3do8m****', + 'description' => '日志服务（SLS）信息。', + 'type' => 'object', + 'properties' => [ + 'SourceRegionId' => ['description' => '源地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'], + 'Across' => ['description' => '是否跨账号。取值：'."\n" + ."\n" + .'- **true** ：当前网络实例为跨账号资源。'."\n" + .'- **false** ：当前网络实例为本账号资源。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'AcrossUid' => ['description' => '跨账号UID。', 'type' => 'string', 'required' => false, 'example' => '123456'], + 'AcrossRole' => ['description' => '跨账号角色。', 'type' => 'string', 'required' => false, 'example' => 'test-role'], + ], + 'required' => false, + 'example' => '-', ], ], [ - 'name' => 'StartTime', - 'in' => 'query', + 'name' => 'KafkaInfo', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '查询开始时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>。'."\n" - .'> - 当前日期为北京时间2022年8月22日，最早可以查询到北京时间2022年8月9日（UTC时间：2022-08-08T16:00:00Z)的数据，若查询时间早于8月9日（UTC时间：2022-08-08T16:00:00Z)，返回值为空。'."\n" - .'- 查询开始时间和查询结束时间的间隔不能大于24小时。 ', - 'type' => 'string', + 'description' => '-', + 'type' => 'object', + 'properties' => [ + 'KafkaClusterId' => ['description' => 'kafka实例ID。', 'type' => 'string', 'required' => false, 'example' => '-'], + 'KafkaTopic' => ['description' => 'kafka topic名称。', 'type' => 'string', 'required' => false, 'example' => 'test-topic'], + ], 'required' => false, - 'docRequired' => true, - 'example' => '2022-08-21T02:15:00Z', + 'example' => '-', ], ], [ - 'name' => 'EndTime', - 'in' => 'query', + 'name' => 'LakehouseId', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '查询结束时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。'."\n" - .'> 查询结束时间需晚于查询开始时间。'."\n", - 'type' => 'string', + 'description' => 'Lakehouse ID。', + 'type' => 'object', + 'properties' => [ + 'Vswitch' => ['description' => '交换机名称。', 'type' => 'string', 'required' => false, 'example' => 'vsw-******'], + 'SecurityGroup' => ['description' => '安全组名称。', 'type' => 'string', 'required' => false, 'example' => 'sg-******'], + 'VpcId' => ['description' => 'vpc id。', 'type' => 'string', 'required' => false, 'example' => 'vpc-******'], + ], 'required' => false, - 'docRequired' => true, - 'example' => '2022-08-22T01:06:00Z', + 'example' => '123', ], ], [ - 'name' => 'RegionId', - 'in' => 'query', + 'name' => 'RdsMysqlInfo', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', + 'description' => '已废弃数据源信息。', + 'type' => 'object', + 'properties' => [ + 'UserName' => ['description' => '-', 'type' => 'string', 'required' => false, 'example' => '-'], + 'Password' => ['description' => '-', 'type' => 'string', 'required' => false, 'example' => '-'], + 'RegionId' => ['description' => '-', 'type' => 'string', 'required' => false, 'example' => '-'], + 'ConnectUrl' => ['description' => '-', 'type' => 'string', 'required' => false, 'example' => '-'], + ], + 'required' => false, + 'example' => '-', ], ], [ - 'name' => 'PatternId', - 'in' => 'query', + 'name' => 'PolarDBMysqlInfo', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => 'SQL Pattern的ID。'."\n" - .'> 您可以调用[DescribeSQLPatterns](~~321868~~)接口查看指定时间内目标集群下所有的SQL Pattern列表信息，包括SQL Pattern的ID。', - 'type' => 'string', + 'description' => '已废弃数据源信息。', + 'type' => 'object', + 'properties' => [ + 'UserName' => ['description' => '-', 'type' => 'string', 'required' => false, 'example' => '-'], + 'Password' => ['description' => '-', 'type' => 'string', 'required' => false, 'example' => '-'], + 'RegionId' => ['description' => '-', 'type' => 'string', 'required' => false, 'example' => '-'], + 'ConnectUrl' => ['description' => '-', 'type' => 'string', 'required' => false, 'example' => '-'], + ], 'required' => false, - 'example' => '3847585356974******', - 'default' => '-1', + 'example' => '-', ], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'EndTime' => [ - 'description' => '查询结束时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。', - 'type' => 'string', - 'example' => '2022-08-22T01:06:00Z', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'F21AF487-B8C9-57E0-8E3A-A92BC3611FB6', - ], - 'StartTime' => [ - 'description' => '查询开始时间，UTC时间，格式：<i>yyyy-MM-ddTHH:mmZ</i>。', - 'type' => 'string', - 'example' => '2022-08-21T02:15:00Z', - ], - 'Performances' => [ - 'description' => '详情。', - 'type' => 'array', - 'items' => [ - 'description' => '列表。', - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => '查询的各项性能指标项。取值说明：'."\n" - .'- **AnalyticDB_PatternQueryCount**：Pattern相关查询的总次数。'."\n" - .'- **AnalyticDB_PatternQueryTime**：Pattern相关查询的总耗时。'."\n" - .'- **AnalyticDB_PatternExecutionTime**：Pattern相关查询的执行耗时。'."\n" - .'- **AnalyticDB_PatternPeakMemory**：Pattern相关查询的峰值内存。'."\n" - .'- **AnalyticDB_PatternScanSize**：Pattern相关查询的数据读取量。', - 'type' => 'string', - 'example' => 'AnalyticDB_PatternExecutionTime', - ], - 'Unit' => [ - 'description' => '各项性能指标项对应的单位。取值说明：'."\n" - .'- 当性能指标项为查询时间相关（即`Key`值为`AnalyticDB_PatternQueryTime`或`AnalyticDB_PatternExecutionTime`）时，该返回值为**ms**。'."\n" - .'- 当性能指标项为峰值内存相关（即`Key`值为`AnalyticDB_PatternPeakMemory`）时，该返回值为**MB**。'."\n" - .'- 当性能指标项为数据读取量（即`Key`值为`AnalyticDB_PatternScanSize`）时，该返回值为**MB**。'."\n" - .'- 当性能指标项为查询次数（即`Key`值为`AnalyticDB_PatternQueryCount`）时，该返回值为空。', - 'type' => 'string', - 'example' => 'ms', - ], - 'Series' => [ - 'description' => '性能指标项下各个性能值的详情。', - 'type' => 'array', - 'items' => [ - 'description' => '列表项。', - 'type' => 'object', - 'properties' => [ - 'Values' => [ - 'description' => '性能值列表。', - 'type' => 'array', - 'items' => [ - 'description' => '不同时间点下的性能值详细信息。', - 'type' => 'string', - 'example' => '[ "2021-11-18 13:38:00", "224" ]', - ], - ], - 'Name' => [ - 'description' => '性能值的名称。取值说明：'."\n" - .'- 当`Key`值为`AnalyticDB_PatternQueryCount`时，该参数返回 `pattern_query_count`，即当前Pattern相关SQL的执行次数。'."\n" - .'- 当`Key`值为`AnalyticDB_PatternQueryTime`时，该参数返回：'."\n" - .' - `average_query_time`，即当前Pattern相关SQL的平均总耗时。'."\n" - .' - `max_query_time`，即当前Pattern相关SQL的最大总耗时。'."\n" - .'- 当`Key`值为`AnalyticDB_PatternExecutionTime`时，该参数返回：'."\n" - .' - `average_execution_time`，即当前Pattern相关SQL的平均执行耗时。'."\n" - .' - `max_execution_time`，即当前Pattern相关SQL的最大执行耗时。'."\n" - .'- 当`Key`值为`AnalyticDB_PatternPeakMemory`时，该参数返回：'."\n" - .' - `average_peak_memory`，即当前Pattern相关SQL的平均峰值内存。'."\n" - .' - `max_peak_memory`，即当前Pattern相关SQL的最大峰值内存。'."\n" - .'- 当`Key`值为`AnalyticDB_PatternScanSize`时，该参数返回：'."\n" - .' - `average_scan_size`，即当前Pattern相关SQL的平均读取数据量。'."\n" - .' - `max_scan_size`，即当前Pattern相关SQL的最大数据读取量。', - 'type' => 'string', - 'example' => 'max_query_time', - ], - ], - ], - ], - ], - ], - ], - 'User' => [ - 'type' => 'string', - ], - 'AccessIp' => [ - 'type' => 'string', - ], - 'SQLPattern' => [ - 'type' => 'string', - ], - 'Tables' => [ - 'type' => 'string', - ], - 'FailedCount' => [ - 'type' => 'integer', - 'format' => 'int64', - ], - 'QueryCount' => [ - 'type' => 'integer', - 'format' => 'int64', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'A3EB3BCD-D974-52D4-B75C-BB06505916CB'], + 'Data' => ['description' => '资源组信息列表。', 'type' => 'string', 'example' => '150'], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'string', 'example' => '200'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：调用成功。'."\n" + .'- **false**：调用失败。', 'type' => 'string', 'example' => 'True'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => 'InvalidInput'."\n"], + 'Message' => ['description' => '应用建议执行结果。取值说明：'."\n" + .'- 请求正常，返回**SUCCESS**。 '."\n" + .'- 请求异常，返回具体异常错误信息。', 'type' => 'string', 'example' => 'OK'], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"EndTime\\": \\"2022-08-22T01:06:00Z\\",\\n \\"RequestId\\": \\"F21AF487-B8C9-57E0-8E3A-A92BC3611FB6\\",\\n \\"StartTime\\": \\"2022-08-21T02:15:00Z\\",\\n \\"Performances\\": [\\n {\\n \\"Key\\": \\"AnalyticDB_PatternExecutionTime\\",\\n \\"Unit\\": \\"ms\\",\\n \\"Series\\": [\\n {\\n \\"Values\\": [\\n \\"[ \\\\\\"2021-11-18 13:38:00\\\\\\", \\\\\\"224\\\\\\" ]\\"\\n ],\\n \\"Name\\": \\"max_query_time\\"\\n }\\n ]\\n }\\n ],\\n \\"User\\": \\"\\",\\n \\"AccessIp\\": \\"\\",\\n \\"SQLPattern\\": \\"\\",\\n \\"Tables\\": \\"\\",\\n \\"FailedCount\\": 0,\\n \\"QueryCount\\": 0\\n}","errorExample":""},{"type":"xml","example":"<DescribePatternPerformanceResponse>\\n <EndTime>2022-08-22T01:06:00Z</EndTime>\\n <RequestId>F21AF487-B8C9-57E0-8E3A-A92BC3611FB6</RequestId>\\n <StartTime>2022-08-21T02:15:00Z</StartTime>\\n <Performances>\\n <Key>AnalyticDB_PatternExecutionTime</Key>\\n <Unit>ms</Unit>\\n <Series>\\n <Values>[ \\"2021-11-18 13:38:00\\", \\"224\\" ]</Values>\\n <Name>max_query_time</Name>\\n </Series>\\n </Performances>\\n</DescribePatternPerformanceResponse>","errorExample":""}]', - 'title' => '查询SQL Pattern的指标', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeDBClusterSpaceSummary' => [ - 'summary' => '查看实例的空间概览信息，包括总数据量、热数据量、冷数据量、数据增长量等。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改APS数据源', + 'summary' => '修改APS数据源。', + 'description' => '### 注意事项'."\n" + .'- 该接口仅适用于32核及以上规格的弹性模式集群版（新版）集群。'."\n" + .'- 不支持修改默认资源组USER_DEFAULT的节点数量。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyApsDatasoure'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyApsDatasoure', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'tags' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"A3EB3BCD-D974-52D4-B75C-BB06505916CB\\",\\n \\"Data\\": \\"150\\",\\n \\"HttpStatusCode\\": \\"200\\",\\n \\"Success\\": \\"True\\",\\n \\"Code\\": \\"InvalidInput\\\\n\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', + ], + 'ModifyApsJob' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '212723', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'operationType' => 'update', + 'abilityTreeCode' => '183077', + 'abilityTreeNodes' => ['FEATUREadsH8FO36'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-wz9v5sa7mm79z4l2', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'name' => 'ApsJobId', + 'in' => 'formData', + 'schema' => ['description' => '任务ID。', 'type' => 'string', 'required' => true, 'example' => 'aps-bj1xxxxxx'], + ], + [ + 'name' => 'DbList', + 'in' => 'formData', + 'schema' => ['description' => '同步对象列表。'."\n" + ."\n", 'type' => 'string', 'required' => true, 'example' => '{"EntireInstance":true}'], + ], + [ + 'name' => 'PartitionList', + 'in' => 'formData', + 'schema' => ['description' => '分区列表。', 'type' => 'string', 'required' => false, 'example' => '{}'], ], ], 'responses' => [ @@ -35378,292 +25373,148 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'TotalSize' => [ - 'description' => '总数据量，单位：Byte。'."\n" - ."\n" - .'> 计算公式为：总数据量 = 热数据总量 + 冷数据总量。', - 'type' => 'string', - 'example' => '8388608', - ], - 'HotData' => [ - 'description' => '热数据。', - 'type' => 'object', - 'properties' => [ - 'TotalSize' => [ - 'description' => '热数据总量，单位：Byte。'."\n" - ."\n" - .'> 计算公式为：热数据总量 = 表记录数据量 + 普通索引数据量 + 主键索引数据量 + 其他。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4194304', - ], - 'DataSize' => [ - 'description' => '表记录数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1048576', - ], - 'IndexSize' => [ - 'description' => '普通索引数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1048576', - ], - 'PrimaryKeyIndexSize' => [ - 'description' => '主键索引数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1048576', - ], - 'OtherSize' => [ - 'description' => '其他，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1048576', - ], - ], - ], - 'ColdData' => [ - 'description' => '冷数据。', - 'type' => 'object', - 'properties' => [ - 'TotalSize' => [ - 'description' => '冷数据总量，单位：Byte。'."\n" - ."\n" - .'> 计算公式为：冷数据总量 = 表记录数据量 + 普通索引数据量 + 主键索引数据量 + 其他。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4194304', - ], - 'DataSize' => [ - 'description' => '表记录数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1048576', - ], - 'IndexSize' => [ - 'description' => '普通索引数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1048576', - ], - 'PrimaryKeyIndexSize' => [ - 'description' => '主键索引数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1048576', - ], - 'OtherSize' => [ - 'description' => '其他，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1048576', - ], - ], - ], - 'DataGrowth' => [ - 'description' => '数据增长量。', - 'type' => 'object', - 'properties' => [ - 'DayGrowth' => [ - 'description' => '近1天增长量，单位：Byte。'."\n" - ."\n" - .'> 计算公式为：近1天增长量 = 当前总数据量 - 1天前总数据量。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1048576', - ], - 'WeekGrowth' => [ - 'description' => '近7天日均增长量，单位：Byte。'."\n" - ."\n" - .'> 计算公式为：近7天日均增长量 = (当前总数据量 - 7天前总数据量) / 7。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1048576', - ], - ], - ], - ], - ], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'ApsJobId' => ['description' => '任务ID。', 'type' => 'string', 'example' => 'aps-bj1xxxxxx'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '******-3EEC-******-9F06-******'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'True'], + 'ErrCode' => ['description' => '错误码。', 'type' => 'string', 'example' => 'Success'], + 'ErrMessage' => ['description' => '调用错误时返回对应的错误信息。', 'type' => 'string', 'example' => 'OK'], + 'Code' => ['description' => '状态码。说明 200表示成功。', 'type' => 'string', 'example' => 'InvalidInput'."\n"], + 'Message' => ['description' => '调用结果的信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常信息。', 'type' => 'string', 'example' => 'SUCCESS'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改aps任务', + 'summary' => '修改aps任务。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyApsJob'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyApsJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"TotalSize\\": \\"8388608\\",\\n \\"HotData\\": {\\n \\"TotalSize\\": 4194304,\\n \\"DataSize\\": 1048576,\\n \\"IndexSize\\": 1048576,\\n \\"PrimaryKeyIndexSize\\": 1048576,\\n \\"OtherSize\\": 1048576\\n },\\n \\"ColdData\\": {\\n \\"TotalSize\\": 4194304,\\n \\"DataSize\\": 1048576,\\n \\"IndexSize\\": 1048576,\\n \\"PrimaryKeyIndexSize\\": 1048576,\\n \\"OtherSize\\": 1048576\\n },\\n \\"DataGrowth\\": {\\n \\"DayGrowth\\": 1048576,\\n \\"WeekGrowth\\": 1048576\\n }\\n }\\n}","type":"json"}]', - 'title' => '查看集群的空间概览', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"ApsJobId\\": \\"aps-bj1xxxxxx\\",\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"ErrCode\\": \\"Success\\",\\n \\"ErrMessage\\": \\"OK\\",\\n \\"Code\\": \\"InvalidInput\\\\n\\",\\n \\"Message\\": \\"SUCCESS\\"\\n}","type":"json"}]', ], - 'DescribeExcessivePrimaryKeys' => [ - 'summary' => '查看集群存在主键过多的表信息。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'ModifyApsSlsADBJob' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '217360', - 'abilityTreeNodes' => [ - 'FEATUREadsDAZVRM', - ], - 'autoTest' => true, - 'tenantRelevance' => 'tenant', + 'abilityTreeCode' => '209632', + 'abilityTreeNodes' => ['FEATUREads1II0UT'], ], 'parameters' => [ [ + 'name' => 'WorkloadId', + 'in' => 'formData', + 'schema' => ['description' => '数据链路任务ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'aps-******'], + ], + [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查询目标地域中所有集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'am-bp1xxxxxxxx47', - ], + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-*******'], ], [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可通过接口[DescribeRegions](~~143074~~)查看可用的地域ID。'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'name' => 'StartingOffsets', + 'in' => 'formData', + 'schema' => ['description' => '起始位点。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'end_cursor'], ], [ - 'name' => 'StartTime', - 'in' => 'query', + 'name' => 'Columns', + 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '查询开始时间。格式为<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', - 'type' => 'string', + 'description' => '列信息。', + 'type' => 'array', + 'items' => [ + 'description' => '列信息。', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '名称。', 'type' => 'string', 'required' => false, 'example' => 'test_name'], + 'MapName' => ['description' => '映射名称。', 'type' => 'string', 'required' => false, 'example' => 'map_name'], + 'Type' => ['description' => '列数据类型。', 'type' => 'string', 'required' => false, 'example' => 'bigint'], + 'MapType' => ['description' => '映射类型。', 'type' => 'string', 'required' => false, 'example' => 'bigint'], + ], + 'required' => false, + 'example' => '-', + ], 'required' => false, - 'docRequired' => true, - 'example' => '2019-06-01T16:00:00Z', + 'example' => '-', ], ], [ - 'name' => 'EndTime', - 'in' => 'query', - 'schema' => [ - 'description' => '查询结束时间。格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => '2019-06-01T16:00:00Z', - ], + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。'."\n", 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值范围如下：'."\n" - .'* **30**（默认值）。'."\n" - .'* **50**。'."\n" - .'* **100**。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '10', - 'example' => '30', - 'default' => '10', - ], + 'name' => 'WorkloadName', + 'in' => 'formData', + 'schema' => ['description' => '工作负载名。', 'type' => 'string', 'required' => false, 'example' => 'test-name'], ], [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - ], + 'name' => 'DbName', + 'in' => 'formData', + 'schema' => ['description' => '数据库名。', 'type' => 'string', 'required' => false, 'example' => 'dbName'], ], [ - 'name' => 'Lang', - 'in' => 'query', - 'schema' => [ - 'description' => '设置下载文件的文件标题以及部分错误信息的语言，支持如下语言：'."\n" - .'- **zh（默认值）**：简体中文。'."\n" - .'- **en**：英文。'."\n" - .'- **ja**：日文。'."\n" - .'- **zh-tw**：繁体中文。', - 'type' => 'string', - 'required' => false, - 'example' => 'zh', - ], + 'name' => 'TableName', + 'in' => 'formData', + 'schema' => ['description' => '表名。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ - 'name' => 'Order', - 'in' => 'query', - 'schema' => [ - 'description' => '按指定字段排序，json格式：JSON数组，有序，按顺序输入排列字段和升降序类型：'."\n" - ."\n" - .'如：'."\n" - ."\n" - .'```'."\n" - .'['."\n" - ."\n" - .' {'."\n" - ."\n" - .' "Field":"Name",'."\n" - ."\n" - .' "Type":"Asc"'."\n" - ."\n" - .' }'."\n" - ."\n" - .']'."\n" - .'```'."\n" - ."\n" - .'其中Field表示需要排序的字段名，目前仅支持对"Name" 字段排序。'."\n" - .'Type表示排序类型 Desc为降序，Asc为升序'."\n" - ."\n" - .'均不区分大小写。', - 'type' => 'string', - 'required' => false, - 'example' => '[{"Field":"TableName", "Type": "Desc" }]', - ], + 'name' => 'DirtyDataProcessPattern', + 'in' => 'formData', + 'schema' => ['description' => '脏数据处理模式。', 'type' => 'string', 'required' => false, 'example' => 'STOP'], + ], + [ + 'name' => 'ExactlyOnce', + 'in' => 'formData', + 'schema' => ['description' => '是否开启精确一致。', 'type' => 'string', 'required' => false, 'example' => 'true'], + ], + [ + 'name' => 'UnixTimestampConvert', + 'in' => 'formData', + 'schema' => ['description' => '时间戳转换。', 'type' => 'string', 'required' => false, 'example' => '-'], + ], + [ + 'name' => 'UserName', + 'in' => 'formData', + 'schema' => ['description' => '用户名。', 'type' => 'string', 'required' => false, 'example' => 'user-name'], + ], + [ + 'name' => 'Password', + 'in' => 'formData', + 'schema' => ['description' => '密码。', 'type' => 'string', 'required' => false, 'example' => 'test_123'], ], ], 'responses' => [ @@ -35671,433 +25522,277 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '总数。', - 'type' => 'string', - 'example' => '300', - ], - 'PageNumber' => [ - 'description' => '页号，和传入的值一致。', - 'type' => 'integer', - 'format' => 'int32', - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数，取值范围如下：'."\n" - .'* **30**（默认值）。'."\n" - .'* **50**。'."\n" - .'* **100**。', - 'type' => 'integer', - 'format' => 'int32', - 'maximum' => '100', - 'minimum' => '10', - 'example' => '30', - 'default' => '10', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '863D51B7-5321-41D8-A0B6-A088B0******', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'am-bp1ub9grke1****', - ], - 'Tables' => [ - 'description' => '主键过多表列表', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'TableName' => [ - 'description' => '表名。', - 'type' => 'string', - 'example' => 'test', - ], - 'SchemaName' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'example' => 'adb_demo', - ], - 'ColumnCount' => [ - 'description' => '总列数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '21', - ], - 'PrimaryKeyCount' => [ - 'description' => '主键字段个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'PrimaryKeyColumns' => [ - 'description' => '主键字段列表。', - 'type' => 'string', - 'example' => 'id,date'."\n", - ], - 'SpaceRatio' => [ - 'description' => '表空间占比，单位：%。'."\n" - ."\n" - .'> 计算公式为：表空间占比 = (表总数据量 / 实例总数据量) * 100。', - 'type' => 'number', - 'format' => 'double', - 'example' => '23', - ], - 'TotalSize' => [ - 'description' => '冷数据总量，单位：Byte。'."\n" - ."\n" - .'> 计算公式为：冷数据总量 = 表记录数据量 + 普通索引数据量 + 主键索引数据量 + 其他。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4', - ], - 'PrimaryKeyIndexSize' => [ - 'description' => '主键索引数据量，单位：Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '222', - ], - ], - ], - ], - 'DetectionItems' => [ - 'description' => '检测项及检测结果列表。', - 'type' => 'array', - 'items' => [ - 'description' => '检测项及检测结果列表。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '检测项名字。', - 'type' => 'string', - 'example' => '主键过多检测', - ], - 'Message' => [ - 'description' => '检测结果信息。', - 'type' => 'string', - 'example' => '检测到多个表存在主键过多的问题', - ], - 'Status' => [ - 'description' => '检测结果状态。', - 'type' => 'string', - 'example' => 'NORMAL'."\n" - .'WARNNING'."\n" - .'CRITICAL', - ], - ], - ], - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息。', - 'type' => 'string', - 'example' => '{'."\n" - .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" - .' "AuthPrincipalOwnerId": "1906102576997697",'."\n" - .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcNqPqHV6lwR4INiAGjIvK1ngXxN1O+6ORRB6A8YvztEOGywOk81ZmuNk0YrNy+qk7+UVDTHeXKsy8h9e/ePY/LMidj0RCmDpo/YpCumd0UGe0qEPe2U+UJAm/+UHlnEFLVg6BP3yIB5D++MCy7mgWm8Kwyhk62IeYly4hQ+5IpXjkh1GQXuDgLVVPVpxEek9n30vnCUL4KsaMgfa7dgojb+3TM8xGsD2zVK5STJNrsXclscIJEqyNXd7CBYiRJVZi1HPO6drN9WW0chLpCSTgjO8n0bNanZaxXKumW9PSwV58UoSFASeMWfZK3TLngX+oq8nGmnTwcJosVjfF4RGzAnS1IXt0Q9N2WHDnpwyLBU/nOz7Hsy8IZ+h+OVjsBTXSM9688/vOF707a5mNzpETvQeGRcua3A5livcKAM2cML0yeUs/Zyj/+BGqtVa+wektspDHC/CECh6R5lxQjRmUdPawY8VDs2onmdLuEH8DdmYt+Yv/jBFBUMWOyAluzkPYcX5nuQKouCIUJUFTSbsJsuH5CTIh7Ls5rbmkj+T1qTVz8gnDR8LxwaqoMSna+elXgVyOOxXtMkenVntsmoC3p/4G7yTPL1hu8JyWGIIvZHZGGLXGEH7FeSuMV8buKxPGFWG3arG8e9LGvDdz5dgTien4y6G5AQ0o1iQdXDos5VWdH3u7k5PrsvdEOpvMi6uSd8a42na80FsYlgGlwM5upydcWUC5Un2HCkJpT1xgk2L6shdVTrK6bidRrqE784FhW9bBQePzGaxSupPENZya0VUctRt+7uq3QwIn4y5jzjgX0E0jgmqPrgiVDjBesMQZYfGPCGysWYWYzfoh+G6V7N2VVGtNnGUwNWzM0WJBPONAgxPv+AmixFRCQ==",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthPrincipalDisplayName": "202515810214480629",'."\n" - .' "NoPermissionType": "ImplicitDeny",'."\n" - .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" - .' }', - ], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '返回数据。', 'type' => 'object'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '******-3EEC-******-9F06-******'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：调用成功。'."\n" + .'- **false**：调用失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => 'InvalidInput'], + 'Message' => ['description' => '应用建议执行结果。取值说明：'."\n" + .'- 请求正常，返回**SUCCESS**。 '."\n" + .'- 请求异常，返回具体异常错误信息。', 'type' => 'string', 'example' => 'SUCCESS'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改sls投递adb数仓任务', + 'summary' => '修改sls投递adb数仓任务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyApsSlsADBJob'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyApsSlsADBJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": \\"300\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"RequestId\\": \\"863D51B7-5321-41D8-A0B6-A088B0******\\",\\n \\"DBClusterId\\": \\"am-bp1ub9grke1****\\",\\n \\"Tables\\": [\\n {\\n \\"TableName\\": \\"test\\",\\n \\"SchemaName\\": \\"adb_demo\\",\\n \\"ColumnCount\\": 21,\\n \\"PrimaryKeyCount\\": 2,\\n \\"PrimaryKeyColumns\\": \\"id,date\\\\n\\",\\n \\"SpaceRatio\\": 23,\\n \\"TotalSize\\": 4,\\n \\"PrimaryKeyIndexSize\\": 222\\n }\\n ],\\n \\"DetectionItems\\": [\\n {\\n \\"Name\\": \\"主键过多检测\\",\\n \\"Message\\": \\"检测到多个表存在主键过多的问题\\",\\n \\"Status\\": \\"NORMAL\\\\nWARNNING\\\\nCRITICAL\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1906102576997697\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcNqPqHV6lwR4INiAGjIvK1ngXxN1O+6ORRB6A8YvztEOGywOk81ZmuNk0YrNy+qk7+UVDTHeXKsy8h9e/ePY/LMidj0RCmDpo/YpCumd0UGe0qEPe2U+UJAm/+UHlnEFLVg6BP3yIB5D++MCy7mgWm8Kwyhk62IeYly4hQ+5IpXjkh1GQXuDgLVVPVpxEek9n30vnCUL4KsaMgfa7dgojb+3TM8xGsD2zVK5STJNrsXclscIJEqyNXd7CBYiRJVZi1HPO6drN9WW0chLpCSTgjO8n0bNanZaxXKumW9PSwV58UoSFASeMWfZK3TLngX+oq8nGmnTwcJosVjfF4RGzAnS1IXt0Q9N2WHDnpwyLBU/nOz7Hsy8IZ+h+OVjsBTXSM9688/vOF707a5mNzpETvQeGRcua3A5livcKAM2cML0yeUs/Zyj/+BGqtVa+wektspDHC/CECh6R5lxQjRmUdPawY8VDs2onmdLuEH8DdmYt+Yv/jBFBUMWOyAluzkPYcX5nuQKouCIUJUFTSbsJsuH5CTIh7Ls5rbmkj+T1qTVz8gnDR8LxwaqoMSna+elXgVyOOxXtMkenVntsmoC3p/4G7yTPL1hu8JyWGIIvZHZGGLXGEH7FeSuMV8buKxPGFWG3arG8e9LGvDdz5dgTien4y6G5AQ0o1iQdXDos5VWdH3u7k5PrsvdEOpvMi6uSd8a42na80FsYlgGlwM5upydcWUC5Un2HCkJpT1xgk2L6shdVTrK6bidRrqE784FhW9bBQePzGaxSupPENZya0VUctRt+7uq3QwIn4y5jzjgX0E0jgmqPrgiVDjBesMQZYfGPCGysWYWYzfoh+G6V7N2VVGtNnGUwNWzM0WJBPONAgxPv+AmixFRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"202515810214480629\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n }\\"\\n}","type":"json"}]', - 'title' => '检测主键过多表', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n },\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Message\\": \\"SUCCESS\\"\\n}","type":"json"}]', ], - 'ModifyDBClusterMaintainTime' => [ - 'summary' => '修改指定集群的可维护时间段。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'ModifyApsWorkloadName' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'abilityTreeCode' => '170156', + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsY28JLD'], ], 'parameters' => [ [ + 'name' => 'RegionId', + 'in' => 'formData', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], + ], + [ 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1r053byu48p****', - ], + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-*******'], ], [ - 'name' => 'MaintainTime', - 'in' => 'query', - 'schema' => [ - 'description' => '集群的可维护时间段，格式为hh:mmZ-hh:mmZ。'."\n" - .'> 时间间隔只能为1小时，且需要设置为整点。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '22:00Z-23:00Z', - ], + 'name' => 'WorkloadId', + 'in' => 'formData', + 'schema' => ['description' => '数据链路任务ID。', 'type' => 'string', 'required' => true, 'example' => 'aps-******'], + ], + [ + 'name' => 'WorkloadName', + 'in' => 'formData', + 'schema' => ['description' => '工作负载名。', 'type' => 'string', 'required' => true, 'example' => 'sls-2024***93014'], ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '65BDA532-28AF-4122-AA39-B382721EEE64', - ], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '返回数据。', 'type' => 'string', 'example' => '123'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '******-3EEC-******-9F06-******'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：调用成功。'."\n" + .'- **false**：调用失败。', 'type' => 'boolean', 'example' => 'True'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => 'InvalidInput'."\n"], + 'Message' => ['description' => '应用建议执行结果。取值说明：'."\n" + .'- 请求正常，返回**SUCCESS**。 '."\n" + .'- 请求异常，返回具体异常错误信息。', 'type' => 'string', 'example' => 'SUCCESS'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'InvalidMaintainTime.Malformed', - 'errorMessage' => 'The specified parameter MaintainTime is not valid.', + 'title' => '修改APS工作负载名称', + 'summary' => '修改APS工作负载名称。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyApsWorkloadName'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyApsWorkloadName', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"65BDA532-28AF-4122-AA39-B382721EEE64\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyDBClusterMaintainTimeResponse>\\n <RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>\\n</ModifyDBClusterMaintainTimeResponse>","errorExample":""}]', - 'title' => '修改可维护时间段', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": \\"123\\",\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\\\n\\",\\n \\"Message\\": \\"SUCCESS\\"\\n}","type":"json"}]', ], - 'ModifyDBClusterResourceGroup' => [ - 'summary' => '修改集群所属的阿里云资源组。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'ModifyAuditLogConfig' => [ + 'summary' => '修改集群的SQL审计日志设置。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '132366', + 'abilityTreeNodes' => ['FEATUREadsGAMOR7'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bpxxxxx', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看目标地域下所有集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-t4nj8619bz2w3****'], ], [ - 'name' => 'NewResourceGroupId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '需要移入云资源实例的资源组ID。'."\n" - ."\n" - .'> 资源组是在阿里云账号下进行资源分组管理的一种机制，资源组能够帮助您解决单个云账号内的资源分组和授权管理等复杂性问题。更多信息，请参见[什么是资源管理](~~94475~~)。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'rg-acxxxxx', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'AuditLogStatus', + 'in' => 'query', + 'schema' => ['description' => '修改SQL审计日志的状态。取值说明：'."\n" + .'- **on**：开启SQL审计。'."\n" + .'- **off**：关闭SQL审计。'."\n" + ."\n" + .'> SQL审计功能关闭后，SQL审计日志会被清空。请先查询和导出SQL审计日志，再关闭SQL审计功能。具体操作，请参见[DescribeAuditLogRecords](~~612426~~)。当再次打开审计日志，审计日志将从最近一次打开审计日志的时间开始展示。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'on'], + ], + [ + 'name' => 'EngineType', + 'in' => 'query', + 'schema' => ['description' => '计算引擎类型。取值说明：'."\n" + ."\n" + .'- XIHE（**默认值**）：羲和计算引擎。'."\n" + .'- SPARK：Spark计算引擎。', 'type' => 'string', 'required' => false, 'example' => 'XIHE'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => '列表详情。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '65BDA532-28AF-4122-AA39-B382721EEE64', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'CDC59E56-BD07-56CA-A05F-B7907DE5C862'], + 'UpdateSucceed' => ['description' => '是否已更新SQL审计的开启状态。取值说明：'."\n" + .'- **true**：状态已更新。'."\n" + .'- **false**：状态更新失败。', 'type' => 'boolean', 'example' => 'true'], ], ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', - ], - [ - 'errorCode' => 'InvalidPreferredBackupTime.Malformed', - 'errorMessage' => 'The specified parameter PreferredBackupTime is not valid.', - ], - [ - 'errorCode' => 'InvalidPreferredBackupPeriod.Malformed', - 'errorMessage' => 'The specified parameter PreferredBackupPeriod is not valid.', - ], - [ - 'errorCode' => 'InvalidBackupRetentionPeriod.Malformed', - 'errorMessage' => 'The specified parameter BackupRetentionPeriod is not valid.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"65BDA532-28AF-4122-AA39-B382721EEE64\\"\\n}","type":"json"}]', - 'title' => '修改集群所属的资源组', - ], - 'ListTagResources' => [ - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改SQL审计日志设置', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-08-20T07:40:34.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-22T04:03:32.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyAuditLogConfig'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyAuditLogConfig', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CDC59E56-BD07-56CA-A05F-B7907DE5C862\\",\\n \\"UpdateSucceed\\": true\\n}","errorExample":""},{"type":"xml","example":"<ModifyAuditLogConfigResponse>\\n <RequestId>CDC59E56-BD07-56CA-A05F-B7907DE5C862</RequestId>\\n <UpdateSucceed>true</UpdateSucceed>\\n</ModifyAuditLogConfigResponse>","errorExample":""}]', + ], + 'ModifyAutoRenewalAttribute' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'paid', + 'abilityTreeCode' => '10841', + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID，您可通过接口[DescribeRegions](~~143074~~)查看可用的地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-uf6pl56w1j8h****'], ], [ - 'name' => 'ResourceType', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '资源类型定义。唯一取值：**dbclusterlakeversion**。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'dbclusterlakeversion', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'NextToken', + 'name' => 'AutoRenewalStatus', 'in' => 'query', - 'schema' => [ - 'description' => '用来返回更多结果。第一次查询不需要提供这个参数，如果一次查询没有返回全部结果，则可在后续查询中传入前一次返回的 Token 继续查询。', - 'type' => 'string', - 'required' => false, - 'example' => '212db86sca4384811e0b5e8707ec21345', - ], + 'schema' => ['description' => '自动续费状态，取值说明：'."\n" + ."\n" + .'- **AutoRenewal**：自动续费。'."\n" + .'- **Normal**：手动续费，集群到期前通过短信提醒。'."\n" + .'- **NotRenewal**：到期不续费，集群到期前无提醒，只在到期前第三天发送不续费提醒。', 'type' => 'string', 'required' => false, 'example' => 'AutoRenewal', 'default' => 'AutoRenewal'], ], [ - 'name' => 'ResourceId', + 'name' => 'AutoRenewalPeriod', 'in' => 'query', - 'style' => 'repeatList', - 'schema' => [ - 'description' => '集群ID。支持同时传入多个集群ID，N的取值范围为：1~50。'."\n" - .'> ResourceId.N参数和Tag.N.Key参数至少传入一个。', - 'type' => 'array', - 'items' => [ - 'description' => '集群ID。支持同时传入多个集群ID，N的取值范围为：1~50。'."\n" - .'> ResourceId.N参数和Tag.N.Key参数至少传入一个。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-bp1l20nxxxxxxxxxx', - ], - 'required' => false, - 'maxItems' => 51, - ], + 'schema' => ['description' => '自动续费时长，默认值为1，取值说明：'."\n" + ."\n" + .'- 当**AutoRenewalPeriod**为**Month**时，取值为1~11（整数）。'."\n" + .'- 当**AutoRenewalPeriod**为**Year**时，取值为1、2、3、5（整数）。'."\n" + .'> 续费的时间越长价格越优惠，续费1年的实际价格会比10个月或11个月更划算。', 'type' => 'string', 'required' => false, 'example' => '1'], ], [ - 'name' => 'Tag', + 'name' => 'AutoRenewalPeriodUnit', 'in' => 'query', - 'style' => 'repeatList', - 'schema' => [ - 'description' => '标签。', - 'type' => 'array', - 'items' => [ - 'description' => '标签列表信息。', - 'type' => 'object', - 'properties' => [ - 'Key' => [ - 'description' => '标签键。支持同时传入多个标签键，不允许传入空字符串。N的取值范围为：1~20。'."\n" - ."\n" - .'> ResourceId.N参数和Tag.N.Key参数至少传入一个。'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'testkey1', - ], - 'Value' => [ - 'description' => '标签键对应的标签值。支持同时传入多个标签值，允许传入空字符串。N的取值范围为：1~20。', - 'type' => 'string', - 'required' => false, - 'example' => 'testvalue1', - ], - ], - 'required' => false, - ], - 'required' => false, - 'maxItems' => 21, - ], + 'schema' => ['description' => '自动续费时长，取值说明：'."\n" + ."\n" + .'- Year：年。'."\n" + .'- Month：月。', 'type' => 'string', 'required' => false, 'example' => 'Year', 'default' => 'Month'], ], ], 'responses' => [ @@ -36105,664 +25800,431 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'NextToken' => [ - 'description' => '用来返回更多结果。如果一次查询没有返回全部结果，则可在后续查询中传入前一次返回的 token 继续查询。', - 'type' => 'string', - 'example' => '212db86sca4384811e0b5e8707ec21345', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '184DE106-CB2C-4DD2-B57F-396652E6C8F8', - ], - 'TagResources' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'TagResource' => [ - 'description' => '查询到的集群和标签的信息。', - 'type' => 'array', - 'items' => [ - 'description' => '列表。', - 'type' => 'object', - 'properties' => [ - 'ResourceType' => [ - 'description' => '资源类型。', - 'type' => 'string', - 'example' => 'dbclusterlakeversion', - ], - 'TagValue' => [ - 'description' => '标签键对应的标签值。', - 'type' => 'string', - 'example' => 'testvalue1', - ], - 'ResourceId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp1l20nxxxxxxxxxx', - ], - 'TagKey' => [ - 'description' => '标签键。', - 'type' => 'string', - 'example' => 'testkey1', - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '421794A3-72A5-5D27-9E8B-A75A4C503E17'], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"NextToken\\": \\"212db86sca4384811e0b5e8707ec21345\\",\\n \\"RequestId\\": \\"184DE106-CB2C-4DD2-B57F-396652E6C8F8\\",\\n \\"TagResources\\": {\\n \\"TagResource\\": [\\n {\\n \\"ResourceType\\": \\"dbclusterlakeversion\\",\\n \\"TagValue\\": \\"testvalue1\\",\\n \\"ResourceId\\": \\"amv-bp1l20nxxxxxxxxxx\\",\\n \\"TagKey\\": \\"testkey1\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '查询标签列表', - 'summary' => '调用ListTagResources查询一个或多个AnalyticDB MySQL集群已绑定的标签列表，或者查询一个或多个标签绑定的AnalyticDB MySQL集群列表。', - ], - 'DescribeAutoRenewalAttribute' => [ - 'summary' => '查询包年包月集群自动续费状态。', - 'methods' => [ - 'post', + 'title' => '设置包年包月集群自动续费状态', + 'summary' => '设置包年包月集群自动续费状态。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyAutoRenewalAttribute'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyAutoRenewalAttribute', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"421794A3-72A5-5D27-9E8B-A75A4C503E17\\"\\n}","type":"json"}]', + ], + 'ModifyBackupPolicy' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '10788', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '155194', + 'abilityTreeNodes' => ['FEATUREadsM6VDCK'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-bp1xxxxxxxx47'], ], [ - 'name' => 'DBClusterId', + 'name' => 'PreferredBackupTime', 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'description' => '集群 ID列表。', - 'type' => 'array', - 'items' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'am-bp1u8c0mgfg58****', - ], - 'required' => false, - ], + 'schema' => ['description' => '执行全量备份的开始时间，格式为HH:mmZ-HH:mmZ（UTC时间）。'."\n" + ."\n" + .'> 时间范围限制为1小时。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '18:00Z-19:00Z'], ], [ - 'name' => 'PageSize', + 'name' => 'PreferredBackupPeriod', 'in' => 'query', - 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - 'default' => '30', - ], + 'schema' => ['description' => '全量备份周期，多个取值用英文逗号（,）隔开。取值说明：'."\n" + .'- **Monday**：周一。'."\n" + .'- **Tuesday**：周二。'."\n" + .'- **Wednesday**：周三。'."\n" + .'- **Thursday**：周四。'."\n" + .'- **Friday**：周五。'."\n" + .'- **Saturday**：周六。'."\n" + .'- **Sunday**：周日。'."\n" + ."\n" + .'> 为保证数据安全，最少选择两个。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'Monday,Wednesday,Friday,Sunday'], ], [ - 'name' => 'PageNumber', + 'name' => 'BackupRetentionPeriod', 'in' => 'query', - 'schema' => [ - 'description' => '页码，取值为大于0且不超过Integer数据类型最大值的正整数。默认值为**1**。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => '全量备份保留天数，取值范围为：7~730。'."\n" + .'> 本参数不填写，默认为7天。', 'type' => 'string', 'required' => false, 'example' => '7', 'default' => '7'], ], [ - 'name' => 'ResourceGroupId', + 'name' => 'EnableBackupLog', 'in' => 'query', - 'schema' => [ - 'description' => '资源组ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'rg-4690g37929****', - ], + 'schema' => ['description' => '是否开启日志（实时）备份。取值说明：'."\n" + .'- **Enable**：开启。'."\n" + .'- **Disable**：关闭。'."\n" + .'> 本参数不填写，默认开启。', 'type' => 'string', 'required' => false, 'example' => 'Enable'], + ], + [ + 'name' => 'LogBackupRetentionPeriod', + 'in' => 'query', + 'schema' => ['description' => '日志（实时）数据备份保留天数，取值范围为：7~730。'."\n" + .'> 本参数不填写，默认为7天。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '730', 'minimum' => '7', 'example' => '7', 'default' => '7'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalRecordCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'PageRecordCount' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'BA0F6761-7A8C-59F8-9624-FB56788C0EDF', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'Items' => [ - 'type' => 'object', - 'itemNode' => true, - 'properties' => [ - 'AutoRenewalAttribute' => [ - 'description' => '自动续费详情列表。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-uf6485635fz8****', - ], - 'AutoRenewalPeriodUnit' => [ - 'description' => '自动续费时长的单位，取值说明：'."\n" - ."\n" - .'- **Year**：年。'."\n" - .'- **Month**：月。', - 'type' => 'string', - 'example' => 'Year', - ], - 'AutoRenewalPeriod' => [ - 'description' => '自动续费时长。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'AutoRenewalStatus' => [ - 'description' => '自动续费状态，取值说明：'."\n" - ."\n" - .'- **AutoRenewal**：自动续费。'."\n" - .'- **Normal**：手动续费，集群到期前通过短信提醒。'."\n" - .'- **NotRenewal**：到期不续费，集群到期前无提醒，只在到期前第三天发送不续费提醒。', - 'type' => 'string', - 'example' => 'AutoRenewal', - ], - 'AutoRenewalEnabled' => [ - 'description' => '是否开启自动续费，取值说明：'."\n" - ."\n" - .'- **true**：开启。'."\n" - .'- **false**：关闭。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RegionId' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'example' => 'cn-shenzhen', - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalRecordCount\\": 20,\\n \\"PageRecordCount\\": 30,\\n \\"RequestId\\": \\"BA0F6761-7A8C-59F8-9624-FB56788C0EDF\\",\\n \\"PageNumber\\": 1,\\n \\"Items\\": {\\n \\"AutoRenewalAttribute\\": [\\n {\\n \\"DBClusterId\\": \\"amv-uf6485635fz8****\\",\\n \\"AutoRenewalPeriodUnit\\": \\"Year\\",\\n \\"AutoRenewalPeriod\\": 1,\\n \\"AutoRenewalStatus\\": \\"AutoRenewal\\",\\n \\"AutoRenewalEnabled\\": true,\\n \\"RegionId\\": \\"cn-shenzhen\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '查询包年包月集群自动续费状态', - ], - 'ModifyAutoRenewalAttribute' => [ - 'summary' => '设置包年包月集群自动续费状态。', - 'methods' => [ - 'post', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPreferredBackupTime.Malformed', 'errorMessage' => 'The specified parameter PreferredBackupTime is not valid.', 'description' => 'PreferredBackupTime参数不正确，请确认参数是否符合规范。'."\n"], + ['errorCode' => 'InvalidPreferredBackupPeriod.Malformed', 'errorMessage' => 'The specified parameter PreferredBackupPeriod is not valid.', 'description' => 'PreferredBackupPeriod'], + ['errorCode' => 'InvalidBackupRetentionPeriod.Malformed', 'errorMessage' => 'The specified parameter "BackupRetentionPeriod" should be within [7-%s] days.', 'description' => '数据备份保留天数错误：%s'], + ], ], - 'schemes' => [ - 'https', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '修改集群备份策略', + 'summary' => '修改集群的备份策略。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-10-12T03:26:48.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2024-10-12T01:59:17.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-11-16T06:02:18.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyBackupPolicy'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyBackupPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', + ], + 'ModifyClickhouseEngine' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'paid', - 'abilityTreeCode' => '10841', - 'abilityTreeNodes' => [ - 'FEATUREadsQEKELU', - ], + 'abilityTreeCode' => '208236', + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-uf6pl56w1j8h****', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'AutoRenewalStatus', - 'in' => 'query', - 'schema' => [ - 'description' => '自动续费状态，取值说明：'."\n" - ."\n" - .'- **AutoRenewal**：自动续费。'."\n" - .'- **Normal**：手动续费，集群到期前通过短信提醒。'."\n" - .'- **NotRenewal**：到期不续费，集群到期前无提醒，只在到期前第三天发送不续费提醒。', - 'type' => 'string', - 'required' => false, - 'example' => 'AutoRenewal', - 'default' => 'AutoRenewal', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'AutoRenewalPeriod', + 'name' => 'Enabled', 'in' => 'query', 'schema' => [ - 'description' => '自动续费时长，默认值为1，取值说明：'."\n" - ."\n" - .'- 当**AutoRenewalPeriod**为**Month**时，取值为1~11（整数）。'."\n" - .'- 当**AutoRenewalPeriod**为**Year**时，取值为1、2、3、5（整数）。'."\n" - .'> 续费的时间越长价格越优惠，续费1年的实际价格会比10个月或11个月更划算。', - 'type' => 'string', + 'description' => '是否开启宽表引擎。'."\n" + .'取值说明：'."\n" + .'- true：开启。'."\n" + .'- false：不开启。', + 'type' => 'boolean', 'required' => false, - 'example' => '1', + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], + 'example' => 'true', ], ], [ - 'name' => 'AutoRenewalPeriodUnit', + 'name' => 'CacheSize', 'in' => 'query', - 'schema' => [ - 'description' => '自动续费时长，取值说明：'."\n" - ."\n" - .'- Year：年。'."\n" - .'- Month：月。', - 'type' => 'string', - 'required' => false, - 'example' => 'Year', - 'default' => 'Month', - ], + 'schema' => ['description' => '宽表引擎云盘缓存空间大小，单位为GB，默认为100GB，取值范围为[100,1000]。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '200'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '421794A3-72A5-5D27-9E8B-A75A4C503E17', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'D761DA51-12F8-5457-AAA9-F52B9F436D2D'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"421794A3-72A5-5D27-9E8B-A75A4C503E17\\"\\n}","type":"json"}]', - 'title' => '设置包年包月集群自动续费状态', - ], - 'DescribeApsResourceGroups' => [ - 'summary' => '获取数据同步时所用资源组的详细信息。', - 'methods' => [ - 'get', - 'post', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'ACS.InvalidParameter.%s', 'errorMessage' => 'Parameter %s is invalid.', 'description' => '输入的参数无效'], + ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '开启和修改宽表引擎', + 'summary' => '为AnalyticDB MySQL实例开启宽表引擎；如果宽表引擎已开启，则修改宽表引擎的缓存大小。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyClickhouseEngine'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyClickhouseEngine', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D761DA51-12F8-5457-AAA9-F52B9F436D2D\\"\\n}","type":"json"}]', + ], + 'ModifyClusterAccessWhiteList' => [ + 'summary' => '修改指定集群的IP白名单。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '146751', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsY28JLD', - ], + 'abilityTreeNodes' => ['FEATUREadsG383TB'], ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'>您可以调用[DescribeDBClusters](~~612397~~)接口查看集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp1t6rym21****', - ], + 'name' => 'SecurityIps', + 'in' => 'query', + 'schema' => ['description' => '集群的IP白名单，多个IP地址之间以英文逗号（,）隔开，不可重复，最多500个。支持如下两种格式：'."\n" + .'- IP地址形式，例如：10.23.xx.xx。'."\n" + .'- CIDR形式，例如：10.23.xx.xx/24（无类域间路由，24表示了地址中前缀的长度，范围为1~32）。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '10.23.xx.xx'], ], [ - 'name' => 'WorkloadId', - 'in' => 'formData', + 'name' => 'DBClusterIPArrayName', + 'in' => 'query', + 'schema' => ['description' => 'IP白名单分组名称，默认操作Default分组。'."\n" + ."\n" + .'- IP白名单分组名称以小写字母开头、以数字或小写字母结尾，可包含小写字母、数字及下划线（_），长度为2~32个字符。'."\n" + .'- 单个集群最多支持50个白名单分组。', 'type' => 'string', 'required' => false, 'example' => 'test', 'default' => 'default'], + ], + [ + 'name' => 'DBClusterIPArrayAttribute', + 'in' => 'query', + 'schema' => ['description' => '白名单分组属性，默认为空。'."\n" + .'> 控制台不显示带有“hidden”属性的分组，带有该标签的分组通常是用于访问DTS、PolarDB服务的。', 'type' => 'string', 'required' => false, 'example' => 'hidden'], + ], + [ + 'name' => 'ModifyMode', + 'in' => 'query', 'schema' => [ - 'description' => '数据同步任务ID。', + 'description' => '修改白名单的方式，取值：'."\n" + .'- **Cover**（默认值）：覆盖原IP白名单。'."\n" + .'- **Append**：追加IP。'."\n" + .'- **Delete**：删除IP。', 'type' => 'string', 'required' => false, - 'example' => 'aps-hz1686v37sx****', + 'example' => 'Cover', + 'default' => 'Cover', + 'enum' => ['Cover', 'Append', 'Delete'], ], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '响应模式。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '6FC370D7-1D4C-5A8E-805E-F73366382C66', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回Success。'."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP状态码。'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '200', - ], - 'Data' => [ - 'description' => '资源组信息列表。', - 'type' => 'object', - 'properties' => [ - 'Step' => [ - 'description' => '资源组的步长，单位ACU。'."\n" - .'- 当GroupType为**Interactive**时，步长为16 ACU。'."\n" - .'- 当GroupType为**Job**时，步长为8 ACU。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '8', - ], - 'ResourceGroups' => [ - 'description' => '资源组列表。', - 'type' => 'array', - 'items' => [ - 'description' => '资源组列表。', - 'type' => 'object', - 'properties' => [ - 'CuOptions' => [ - 'description' => '资源梯度值列表。', - 'type' => 'array', - 'items' => [ - 'description' => '资源梯度值。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '无', - ], - ], - 'MaxComputeResource' => [ - 'description' => '最大计算预留资源，单位ACU。'."\n" - .'- 当GroupType为**Interactive**时，计算预留资源最大为集群当前未分配资源，步长为16 ACU。'."\n" - .'- 当GroupType为**Job**时，计算预留资源最大为集群当前未分配资源，步长为8 ACU。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '512', - ], - 'LeftComputeResource' => [ - 'description' => '剩余计算资源，单位ACU。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '512', - ], - 'MinComputeResource' => [ - 'description' => '最小计算预留资源，单位ACU。'."\n" - .'- 当GroupType为**Interactive**时，计算预留资源最小为16 ACU。'."\n" - .'- 当GroupType为**Job**时，计算预留资源最小为0 ACU。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'GroupName' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'GroupType' => [ - 'description' => '资源组类型，取值：'."\n" - .'- **Interactive**'."\n" - .'- **Job**'."\n" - .'> 关于湖仓版资源组的详细信息，请参见[资源组介绍](~~428610~~)。', - 'type' => 'string', - 'example' => 'Job', - ], - 'Available' => [ - 'description' => '资源组是否可用。取值说明：'."\n" - .'- **True**：可用。'."\n" - .'- **False**：不可用。', - 'type' => 'boolean', - 'example' => 'True', - ], - ], - ], - ], - ], - ], - 'Success' => [ - 'description' => '请求是否成功。取值说明：'."\n" - .'- **True**：成功。'."\n" - .'- **False**：失败。', - 'type' => 'boolean', - 'example' => 'True', - ], + 'TaskId' => ['description' => '任务ID。', 'type' => 'integer', 'format' => 'int32', 'example' => '1564657730'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '370D09FD-442A-5225-AAD3-7362CAE39177'], + 'DBClusterId' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'example' => 'amv-bp11q28kvl688****'], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"6FC370D7-1D4C-5A8E-805E-F73366382C66\\",\\n \\"Message\\": \\"Success\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": {\\n \\"Step\\": 8,\\n \\"ResourceGroups\\": [\\n {\\n \\"CuOptions\\": [\\n 0\\n ],\\n \\"MaxComputeResource\\": 512,\\n \\"LeftComputeResource\\": 512,\\n \\"MinComputeResource\\": 0,\\n \\"GroupName\\": \\"test\\",\\n \\"GroupType\\": \\"Job\\",\\n \\"Available\\": true\\n }\\n ]\\n },\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"<DescribeApsResourceGroupsResponse>\\n <RequestId>6FC370D7-1D4C-5A8E-805E-F73366382C66</RequestId>\\n <Message>Success</Message>\\n <HttpStatusCode>200</HttpStatusCode>\\n <Data>\\n <Step>8</Step>\\n <ResourceGroups>\\n <MaxComputeResource>512</MaxComputeResource>\\n <MinComputeResource>0</MinComputeResource>\\n <GroupName>test</GroupName>\\n <GroupType>Job</GroupType>\\n <Available>true</Available>\\n </ResourceGroups>\\n </Data>\\n <Success>true</Success>\\n</DescribeApsResourceGroupsResponse>","errorExample":""}]', - 'title' => '查询资源组信息', - 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', - ], - 'DescribeApsJobDetail' => [ - 'summary' => 'DescribeApsJobDetail。', - 'methods' => [ - 'post', - 'get', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'SecurityIPList.Duplicate', 'errorMessage' => 'The specified IP address is duplicate.', 'description' => '指定安全访问白名单IP重复'], + ['errorCode' => 'InvalidDBClusterIPArrayName.Malformed', 'errorMessage' => 'The specified parameter DBClusterIPArrayName is not valid.', 'description' => 'DBClusterIPArrayName参数不正确，请确认参数是否符合规范。'."\n"], + ['errorCode' => 'InvalidSecurityIPList.Malformed', 'errorMessage' => 'The specified SecurityIPList is incorrectly formatted.', 'description' => '安全组参数不正确。'], + ['errorCode' => 'InvalidSecurityIPList.Duplicate', 'errorMessage' => 'Specified security IP list is not valid: Duplicate IP address in the list', 'description' => 'IP地址重复，请确认输入是否合法'."\n"], + ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], + ], + 'title' => '修改白名单', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2025-04-08T07:03:05.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-03-31T07:03:57.000Z', 'description' => '错误码发生变更、响应参数发生变更'], + ['createdAt' => '2022-06-11T16:51:52.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyClusterAccessWhiteList'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyClusterAccessWhiteList', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"TaskId\\": 1564657730,\\n \\"RequestId\\": \\"370D09FD-442A-5225-AAD3-7362CAE39177\\",\\n \\"DBClusterId\\": \\"amv-bp11q28kvl688****\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyClusterAccessWhiteListResponse>\\n <TaskId>1564657730</TaskId>\\n <RequestId>370D09FD-442A-5225-AAD3-7362CAE39177</RequestId>\\n <DBClusterId>amv-bp11q28kvl688****</DBClusterId>\\n</ModifyClusterAccessWhiteListResponse>","errorExample":""}]', + ], + 'ModifyCompactionServiceSwitch' => [ + 'summary' => '修改集群查询加速配置远程Build服务开关。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - 'abilityTreeCode' => '180625', - 'abilityTreeNodes' => [ - 'FEATUREadsH8FO36', - ], - ], + 'systemTags' => ['operationType' => 'update'], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp14t95lun0w****'], ], [ - 'name' => 'ApsJobId', - 'in' => 'formData', + 'name' => 'EnableCompactionService', + 'in' => 'query', 'schema' => [ - 'description' => '任务ID。', - 'type' => 'string', + 'description' => '是否开启远程Build服务。', + 'type' => 'boolean', 'required' => true, - 'example' => 'aps-******', + 'docRequired' => true, + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], + 'example' => 'true', ], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-E606-4A42-BF6D-******', - ], - 'APSJobDetail' => [ - 'description' => '任务详情。', - 'type' => 'object', - 'properties' => [ - 'SourceEndpointRegion' => [ - 'description' => '源数据库地域。'."\n", - 'type' => 'string', - 'example' => 'cn-beijing', - ], - 'SourceEndpointInstanceID' => [ - 'description' => '源数据库实例ID。', - 'type' => 'string', - 'example' => 'pc-*******', - ], - 'DestinationEndpointRegion' => [ - 'description' => '目标实例所属地域。', - 'type' => 'string', - 'example' => 'cn-beijing', - ], - 'DestinationEndpointInstanceID' => [ - 'description' => '目标端数据库实例ID。', - 'type' => 'string', - 'example' => 'amv-******', - ], - 'PartitionList' => [ - 'description' => '分区列表。', - 'type' => 'string', - 'example' => '{}', - ], - 'DbList' => [ - 'description' => '同步对象列表。'."\n" - ."\n", - 'type' => 'string', - 'example' => '{}', - ], - 'TargetTableMode' => [ - 'description' => '目标表模式。', - 'type' => 'string', - 'example' => '0', - ], - 'Status' => [ - 'description' => '状态。', - 'type' => 'string', - 'example' => 'Running', - ], - ], - 'example' => '-', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '21ABF219-10E0-571B-94B8-9C9AE5022BF8'], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidInput', - 'errorMessage' => 'The specified parameter is invalid.', - ], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidMaintainTime.Malformed', 'errorMessage' => 'The specified parameter MaintainTime is not valid.', 'description' => 'MaintainTime参数不正确，请确认参数是否符合规范。'."\n"], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-E606-4A42-BF6D-******\\",\\n \\"APSJobDetail\\": {\\n \\"SourceEndpointRegion\\": \\"cn-beijing\\",\\n \\"SourceEndpointInstanceID\\": \\"pc-*******\\",\\n \\"DestinationEndpointRegion\\": \\"cn-beijing\\",\\n \\"DestinationEndpointInstanceID\\": \\"amv-******\\",\\n \\"PartitionList\\": \\"{}\\",\\n \\"DbList\\": \\"{}\\",\\n \\"TargetTableMode\\": \\"0\\",\\n \\"Status\\": \\"Running\\"\\n }\\n}","type":"json"}]', - 'title' => '查询APS任务详情', - ], - 'CreateApsWebhook' => [ - 'summary' => '用于为指定数据库集群和任务类型创建新的Webhook。', - 'path' => '', - 'methods' => [ - 'post', + 'title' => '修改远程Build服务开关', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyCompactionServiceSwitch'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyCompactionServiceSwitch', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"21ABF219-10E0-571B-94B8-9C9AE5022BF8\\"\\n}","type":"json"}]', + ], + 'ModifyDBCluster' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -36771,411 +26233,358 @@ 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'update', 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsBIVU9O', - 'FEATUREadsY28JLD', - ], + 'chargeType' => 'paid', + 'abilityTreeCode' => '132381', + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'in' => 'query', + 'schema' => ['description' => '湖仓版集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看湖仓版集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1r053byu48p****'], ], [ 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群所属地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定湖仓版集群的地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'JobType', - 'in' => 'formData', - 'schema' => [ - 'description' => '任务类型。取值如下'."\n" - .'任务类型SLS/OSS导出任务：ResultExport。', - 'type' => 'string', - 'required' => true, - 'example' => 'ResultExport', - ], + 'name' => 'StorageResource', + 'in' => 'query', + 'schema' => ['description' => '存储预留资源。取值范围：0ACU～2064ACU，步长：24。1 ACU约等于1核4 GB。'."\n" + .'> 参数填写时，需要带单位。', 'type' => 'string', 'required' => false, 'example' => '24ACU'], ], [ - 'name' => 'Webhook', - 'in' => 'formData', - 'style' => 'json', + 'name' => 'ComputeResource', + 'in' => 'query', + 'schema' => ['description' => '计算预留资源。取值范围：0ACU～4096ACU，步长：16。1 ACU约等于1核4 GB。'."\n" + .'> 参数填写时，需要带单位。', 'type' => 'string', 'required' => false, 'example' => '16ACU'], + ], + [ + 'name' => 'EnableDefaultResourcePool', + 'in' => 'query', + 'schema' => ['description' => '计算预留资源是否全部分配给默认资源组（user_default），取值说明：'."\n" + .'- true（默认值）：是'."\n" + .'- false：否', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + ], + [ + 'name' => 'ProductForm', + 'in' => 'query', 'schema' => [ - 'description' => 'Webhook数组。', - 'type' => 'array', - 'items' => [ - 'description' => 'Webhook信息。', - 'type' => 'object', - 'properties' => [ - 'WebhookType' => [ - 'description' => '通知方式。取值如下： dingtalk：钉钉。 lark：飞书。', - 'type' => 'string', - 'required' => true, - 'example' => 'dingtalk', - ], - 'Url' => [ - 'description' => '请求地址。', - 'type' => 'string', - 'required' => true, - 'example' => 'https://example.com/webhook', - ], - 'Key' => [ - 'description' => '加签密钥。', - 'type' => 'string', - 'required' => false, - 'example' => '***', - ], - 'Name' => [ - 'description' => 'Webhook名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'MyWebhookName', - ], - ], - 'required' => false, - ], + 'description' => '产品形态。取值为：'."\n" + .'- **IntegrationForm**：融合形态。'."\n" + .'- **LegacyForm**：湖仓版。', + 'type' => 'string', 'required' => false, + 'example' => 'LegacyForm', + 'default' => 'LegacyForm', + 'enum' => ['IntegrationForm', 'LegacyForm'], ], ], + [ + 'name' => 'ReservedNodeSize', + 'in' => 'query', + 'schema' => ['description' => '存储预留资源节点规格，支持8ACU，12ACU，16ACU'."\n" + .'> 参数填写时，需要带单位，仅ProductForm取值为IntegrationForm时，填写该参数。', 'type' => 'string', 'required' => false, 'example' => '8ACU'], + ], + [ + 'name' => 'ReservedNodeCount', + 'in' => 'query', + 'schema' => ['description' => '预留节点数。 '."\n" + .'- 企业版默认为3节点，步长为3。'."\n" + .'- 基础版默认为1节点。'."\n" + .'> 仅ProductForm取值为IntegrationForm时，填写该参数', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '3'], + ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。'."\n", - 'type' => 'string', - 'example' => '1234567890abcdef', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'string', - 'example' => '[]', - ], - 'HttpStatusCode' => [ - 'description' => 'http状态码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '返回消息。', - 'type' => 'string', - 'example' => 'OK', - ], - 'Code' => [ - 'description' => '请求返回Code。', - 'type' => 'string', - 'example' => '200', - ], - 'Success' => [ - 'description' => '是否成功。', - 'type' => 'boolean', - 'example' => 'true', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '0D6BF3E2-41D8-57F6-9A62-A13A70377952'], + 'DBClusterId' => ['description' => '湖仓版集群ID。', 'type' => 'string', 'example' => 'amv-bp1r053byu48p****'], + 'OrderId' => ['description' => '订单ID。', 'type' => 'string', 'example' => '2035629****'], ], + 'description' => '', ], ], ], - 'errorCodes' => [], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'ACS.Cluster.InvalidWorkerState', 'errorMessage' => 'The state of the worker does not support this operation.', 'description' => '当前存储节点的状态不支持此操作'], + ['errorCode' => 'ACS.Cluster.ElasticPlanJobsExists', 'errorMessage' => 'Operation failed. Ongoing elastic plan jobs exist.', 'description' => '无法执行此操作：存在正在运行的存储弹性计划作业'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1234567890abcdef\\",\\n \\"Data\\": \\"[]\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": true\\n}","type":"json"}]', - 'title' => '创建Webhook', - ], - 'DeleteApsWebhook' => [ - 'summary' => '用于删除指定数据库集群中的特定Webhook。', - 'methods' => [ - 'post', + 'title' => '集群升降配', + 'summary' => '对湖仓版集群进行升降配。', + 'description' => '### 注意事项'."\n" + .'- 扩缩容期间，会禁止`submit job`提交异步任务。如果业务依赖相关功能，请根据业务情况选择时段执行扩缩容。'."\n" + .'- 扩缩容操作会对数据进行重分布迁移，迁移时长与数据量成正比，扩缩容期间服务不中断。集群从大规格缩容到小规格时，数据迁移时长通常需要数小时甚至数十小时，数据量大时请谨慎缩容。'."\n" + .'- 如果集群已加载内置数据集，在缩容时请确保集群具有至少24 ACU的存储预留资源，否则内置数据集无法使用。'."\n" + .'- 扩缩容即将结束时，可能会发生连接闪断，建议您在业务低峰期扩缩容，或确保您的应用有自动重连机制。'."\n" + .'- 不支持将湖仓版变配为数仓版。支持将数仓版变配为湖仓版，详情请参见数仓版变配湖仓版。'."\n" + .'- 当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-09-18T14:10:59.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-05-09T03:29:13.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-07-27T11:22:29.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-06-21T03:39:26.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-05-08T16:28:06.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-04-13T11:20:16.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-11-03T03:01:24.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-11T16:51:52.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBCluster'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBCluster', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"0D6BF3E2-41D8-57F6-9A62-A13A70377952\\",\\n \\"DBClusterId\\": \\"amv-bp1r053byu48p****\\",\\n \\"OrderId\\": \\"2035629****\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyDBClusterResponse>\\n <RequestId>0D6BF3E2-41D8-57F6-9A62-A13A70377952</RequestId>\\n <DBClusterId>amv-bp1r053byu48p****</DBClusterId>\\n <OrderId>2035629****</OrderId>\\n</ModifyDBClusterResponse>","errorExample":""}]', + ], + 'ModifyDBClusterDescription' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'delete', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsBIVU9O', - 'FEATUREadsY28JLD', - ], + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-uf63i4ij56b***', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1r053byu48p****'], ], [ - 'name' => 'WebhookId', - 'in' => 'formData', - 'schema' => [ - 'description' => '待删除的Webhook的ID。', - 'type' => 'string', - 'required' => true, - 'example' => '***1*595*', - ], + 'name' => 'DBClusterDescription', + 'in' => 'query', + 'schema' => ['description' => '集群描述。'."\n" + ."\n" + .'- 不能以`http://`或者`https`开头；'."\n" + .'- 长度为2~256个字符。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'adb_test'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。'."\n", - 'type' => 'string', - 'example' => 'exampleRequestId', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'string', - 'example' => '[]', - ], - 'HttpStatusCode' => [ - 'description' => 'http状态码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '返回消息。', - 'type' => 'string', - 'example' => '操作成功', - ], - 'DBClusterId' => [ - 'description' => '实例ID。', - 'type' => 'string', - 'example' => 'amv-uf63i4ij56b***'."\n", - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => '200', - ], - 'Success' => [ - 'description' => '是否成功。', - 'type' => 'boolean', - 'example' => 'true', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '17F57FEE-EA4F-4337-8D2E-9C23CAA63D74'], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidDBClusterDescription.Malformed', 'errorMessage' => 'The specified parameter DBClusterDescription is not valid.', 'description' => 'DBClusterDescription参数不正确，请确认参数是否符合规范。'."\n"], + ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"exampleRequestId\\",\\n \\"Data\\": \\"[]\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"操作成功\\",\\n \\"DBClusterId\\": \\"amv-uf63i4ij56b***\\\\n\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": true\\n}","type":"json"}]', - 'title' => '删除Webhook接口', - 'description' => '本API允许用户通过提供`RegionId`、`DBClusterId`以及`WebhookId`来删除一个已存在的Webhook配置。请确保提供的参数值准确无误，以免误删重要设置。', - ], - 'UpdateApsWebhook' => [ - 'summary' => '用于更新指定数据库集群的Webhook配置信息。', - 'path' => '', - 'methods' => [ - 'post', + 'title' => '变更集群描述', + 'summary' => '修改指定集群的描述信息，方便集群的维护管理。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-03-31T07:03:57.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:51:36.000Z', 'description' => 'OpenAPI 下线'], ], - 'schemes' => [ - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBClusterDescription'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBClusterDescription', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"17F57FEE-EA4F-4337-8D2E-9C23CAA63D74\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyDBClusterDescriptionResponse>\\n <RequestId>17F57FEE-EA4F-4337-8D2E-9C23CAA63D74</RequestId>\\n</ModifyDBClusterDescriptionResponse>","errorExample":""}]', + ], + 'ModifyDBClusterMaintainTime' => [ + 'summary' => '修改指定集群的可维护时间段。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsBIVU9O', - 'FEATUREadsY28JLD', - ], + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'exampleDBClusterId', - ], + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1r053byu48p****'], ], [ - 'name' => 'RegionId', - 'in' => 'formData', + 'name' => 'MaintainTime', + 'in' => 'query', + 'schema' => ['description' => '集群的可维护时间段，格式为hh:mmZ-hh:mmZ。'."\n" + .'> 时间间隔只能为1小时，且需要设置为整点。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '22:00Z-23:00Z'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'exampleRegionId', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '65BDA532-28AF-4122-AA39-B382721EEE64'], + ], + 'description' => '', ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidMaintainTime.Malformed', 'errorMessage' => 'The specified parameter MaintainTime is not valid.', 'description' => 'MaintainTime参数不正确，请确认参数是否符合规范。'."\n"], + ], + ], + 'title' => '修改可维护时间段', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-03-31T07:03:57.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:51:52.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBClusterMaintainTime'], + ], + ], + 'ramActions' => [ [ - 'name' => 'Webhook', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => 'Webhook数组。', - 'type' => 'array', - 'items' => [ - 'description' => 'Webhook数组。', - 'type' => 'object', - 'properties' => [ - 'WebhookId' => [ - 'description' => 'Webhook ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '**355****', - ], - 'Url' => [ - 'description' => '请求地址。', - 'type' => 'string', - 'required' => false, - 'example' => 'https://example.com/webhook', - ], - 'Key' => [ - 'description' => '加签密钥。', - 'type' => 'string', - 'required' => false, - 'example' => 'ABC**', - ], - 'WebhookType' => [ - 'description' => '通知方式。 dingtalk：钉钉。 lark：飞书。', - 'type' => 'string', - 'required' => false, - 'example' => 'dingtalk', - ], - 'Name' => [ - 'description' => 'Webhook名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'exampleWebhookName', - ], - ], - 'required' => false, + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBClusterMaintainTime', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], - 'required' => false, ], ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"65BDA532-28AF-4122-AA39-B382721EEE64\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyDBClusterMaintainTimeResponse>\\n <RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>\\n</ModifyDBClusterMaintainTimeResponse>","errorExample":""}]', + ], + 'ModifyDBClusterResourceGroup' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'update'], + 'parameters' => [ + [ + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bpxxxxx'], + ], + [ + 'name' => 'NewResourceGroupId', + 'in' => 'query', + 'schema' => ['description' => '需要移入云资源实例的资源组ID。'."\n" + ."\n" + .'> 资源组是在阿里云账号下进行资源分组管理的一种机制，资源组能够帮助您解决单个云账号内的资源分组和授权管理等复杂性问题。更多信息，请参见[什么是资源管理](~~94475~~)。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'rg-acxxxxx'], + ], + ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。'."\n", - 'type' => 'string', - 'example' => 'exampleRequestId', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'string', - 'example' => '-', - ], - 'HttpStatusCode' => [ - 'description' => 'http状态码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '返回消息。', - 'type' => 'string', - 'example' => '操作成功', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp11q28kvl688****', - ], - 'Code' => [ - 'description' => '返回结果编码。', - 'type' => 'string', - 'example' => '200', - ], - 'Success' => [ - 'description' => '是否成功。', - 'type' => 'boolean', - 'example' => 'true', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '65BDA532-28AF-4122-AA39-B382721EEE64'], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPreferredBackupTime.Malformed', 'errorMessage' => 'The specified parameter PreferredBackupTime is not valid.', 'description' => 'PreferredBackupTime参数不正确，请确认参数是否符合规范。'."\n"], + ['errorCode' => 'InvalidPreferredBackupPeriod.Malformed', 'errorMessage' => 'The specified parameter PreferredBackupPeriod is not valid.', 'description' => 'PreferredBackupPeriod'], + ['errorCode' => 'InvalidBackupRetentionPeriod.Malformed', 'errorMessage' => 'The specified parameter BackupRetentionPeriod is not valid.', 'description' => 'BackupRetentionPeriod参数不正确，请确认参数是否符合规范。'."\n"], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"exampleRequestId\\",\\n \\"Data\\": \\"-\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"操作成功\\",\\n \\"DBClusterId\\": \\"amv-bp11q28kvl688****\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": true\\n}","type":"json"}]', - 'title' => '更新Webhook配置', - ], - 'ListApsWebhook' => [ - 'summary' => '用于查询指定数据库集群下的Webhook配置信息。', - 'path' => '', - 'methods' => [ - 'get', - 'post', + 'title' => '修改集群所属的资源组', + 'summary' => '修改集群所属的阿里云资源组。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBClusterResourceGroup'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBClusterResourceGroup', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"65BDA532-28AF-4122-AA39-B382721EEE64\\"\\n}","type":"json"}]', + ], + 'ModifyDBClusterSSL' => [ + 'summary' => '修改集群的SSL链路配置。', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -37184,1795 +26593,1293 @@ 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsBIVU9O', - 'FEATUREadsY28JLD', - ], + 'abilityTreeCode' => '216076', + 'abilityTreeNodes' => ['FEATUREadsG383TB'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-8vbuyjhrih**', - ], + 'in' => 'query', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-************'], ], [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'name' => 'EnableSSL', + 'in' => 'query', + 'schema' => ['description' => '是否开启SSL链路加密功能，取值：'."\n" + ."\n" + .'- **true**：开启。'."\n" + .'- **false**：关闭。', 'type' => 'boolean', 'required' => true, 'docRequired' => true, 'example' => 'true'], ], [ - 'name' => 'JobType', - 'in' => 'formData', - 'schema' => [ - 'description' => '**JobType** '."\n" - .'任务类型SLS/OSS导出任务：ResultExport。', - 'type' => 'string', - 'required' => false, - 'example' => 'ResultExport', - ], + 'name' => 'ConnectionString', + 'in' => 'query', + 'schema' => ['description' => '需要创建或更新服务器证书的内网或外网连接地址。', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'amv-***********.ads.aliyuncs.com'], + ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回消息。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'exampleRequestId', - ], - 'HttpStatusCode' => [ - 'description' => 'http状态码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '返回消息。', - 'type' => 'string', - 'example' => 'OK', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => '200', - ], - 'Success' => [ - 'description' => '是否成功。', - 'type' => 'boolean', - 'example' => 'True', - ], - 'Webhook' => [ - 'description' => 'Webhook数组。', - 'type' => 'array', - 'items' => [ - 'description' => 'Webhook数组。', - 'type' => 'object', - 'properties' => [ - 'WebhookType' => [ - 'description' => 'Webhook 类型。', - 'type' => 'string', - 'example' => 'dingtalk', - ], - 'WebhookId' => [ - 'description' => '要删除的webhook id。', - 'type' => 'string', - 'example' => '**35***', - ], - 'Url' => [ - 'description' => '请求地址。', - 'type' => 'string', - 'example' => 'https://example.com/webhook', - ], - 'Key' => [ - 'description' => '加签密钥。', - 'type' => 'string', - 'example' => 'your_secret_key', - ], - 'Name' => [ - 'description' => 'webhook名称。', - 'type' => 'string', - 'example' => 'webhook_name', - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], ], + 'description' => '', ], ], ], - 'errorCodes' => [], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"exampleRequestId\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": true,\\n \\"Webhook\\": [\\n {\\n \\"WebhookType\\": \\"dingtalk\\",\\n \\"WebhookId\\": \\"**35***\\",\\n \\"Url\\": \\"https://example.com/webhook\\",\\n \\"Key\\": \\"your_secret_key\\",\\n \\"Name\\": \\"webhook_name\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '查询Webhook', - 'description' => '通过此API，您可以根据`RegionId`、`DBClusterId`以及可选的`JobType`来获取已配置的Webhook列表。其中，`JobType`参数指定了任务类型（例如SLS/OSS导出任务），如果提供，则返回与该任务类型相关的Webhook；如果不提供，则返回所有类型的Webhook。'."\n" - ."\n" - .'注意：确保您提供的`RegionId`和`DBClusterId`是正确的，否则可能无法正确获取到Webhook信息。', - ], - 'CreateApsKafkaHudiJob' => [ - 'summary' => '创建APS Kafka入湖任务。', - 'methods' => [ - 'get', - 'post', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改ADB实例的SSL配置', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBClusterSSL'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBClusterSSL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', + ], + 'ModifyDBClusterVip' => [ + 'summary' => '修改集群访问的VIP。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'update', 'riskType' => 'none', - 'chargeType' => 'paid', - 'abilityTreeCode' => '157674', - 'abilityTreeNodes' => [ - 'FEATUREadsY28JLD', - ], + 'chargeType' => 'free', + 'abilityTreeCode' => '212368', + 'abilityTreeNodes' => ['FEATUREads3N2V5J'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp11q28kvl688****', - ], + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下AnalyticDB MySQL湖仓版集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-2ze8mbuai97*****'], ], [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'name' => 'VPCId', + 'in' => 'query', + 'schema' => ['description' => '专有网络VPC ID。'."\n" + ."\n" + .'> - **VPC**所在地域与集群属于同一地域。', 'type' => 'string', 'required' => true, 'example' => 'vpc-bp1at5ze0t5u3xtqn****'], ], [ - 'name' => 'PartitionSpecs', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => '分区信息。', - 'type' => 'array', - 'items' => [ - 'description' => '"SourceColumn": 源端分区字段名。'."\n" - .'"Strategy": 策略。'."\n" - .'1) 按照格式化日期: "ParseAsTimeAndFormat"。'."\n" - .'2) 指定分区字段："CustomSpecify"。'."\n" - ."\0\n" - .'"SourceTypeFormat": 源端类型格式。'."\n" - .'"TargetTypeFormat": 目标端类型格式。'."\n" - .'"TargetColumn": 目标端分区字段名。'."\n" - ."\n" - .'其中SourceTypeFormat枚举及含义如下，右侧对应时间精度。'."\n" - .'APSLiteralTimestampMilliSecond ->毫秒级精度。'."\n" - .'APSLiteralTimestampMicroSecond -> 微秒级精度。'."\n" - .'APSLiteralTimestampSecond -> 秒级精度。'."\n" - .'APSMIDyyyyMMddHHmmssSSS -> yyyy-MM-dd HH:mm:ss.SSS。'."\n" - .'APSMIDyyyyMMddHHmmss -> yyyy-MM-dd HH:mm:ss'."\n" - .'APSMIDyyyyMMdd -> yyyy-MM-dd。'."\n" - .'APSyyyyMMddHHmmss -> yyyyMMddHHmmss。'."\n" - ."\0".'APSyyyyMMdd -> yyyyMMdd。'."\n" - .'APSyyyyMM -> yyyyMM。'."\n" - .'APSSLAyyyyMMdd -> yyyy/MM/dd。'."\n" - .'APSSLAMMddyyyy -> MM/dd/yyyy。', - 'type' => 'object', - 'required' => false, - 'example' => '[{ "SourceColumn": "NetOutFlow", "Strategy": "ParseAsTimeAndFormat", "SourceTypeFormat": "APSLiteralTimestampSecond", "TargetTypeFormat": "yyyy-MM-dd", "TargetColumn": "NetOutFlow" }]', - ], - 'required' => false, - ], + 'name' => 'VSwitchId', + 'in' => 'query', + 'schema' => ['description' => '虚拟交换机ID。'."\n" + .'> - 传入的新虚拟交换机必须与集群属于同一个可用区。', 'type' => 'string', 'required' => true, 'example' => 'vsw-bp1aadw9k19x6cis9****'], ], [ - 'name' => 'Columns', - 'in' => 'formData', - 'style' => 'json', + 'name' => 'ConnectString', + 'in' => 'query', + 'schema' => ['description' => '连接串地址。', 'type' => 'string', 'required' => false, 'example' => 'amv-2ze8mbuai974s4y2500000169.ads.aliyuncs.com'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '列信息。', - 'type' => 'array', - 'items' => [ - 'description' => '列信息。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '源端字段名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'a', - ], - 'MapName' => [ - 'description' => '目标端字段名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'b', - ], - 'Type' => [ - 'description' => '源端字段类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'string', - ], - 'MapType' => [ - 'description' => '目标端字段类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'string', - ], - ], - 'required' => false, + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-****-4A42-BF6D-8A4442913CEF'], ], - 'required' => true, ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'ACS.Cluster.InvalidState', 'errorMessage' => 'The state of the cluster does not support this operation.', 'description' => '集群的状态不支持当前操作。'], + ['errorCode' => 'InvalidConnectionString.Malformed', 'errorMessage' => 'The specified parameter "ConnectionString" is not valid.', 'description' => '参数ConnectionString不合法'], + ['errorCode' => 'InvalidConnectionString.UnSupported', 'errorMessage' => 'The specified parameter "ConnectionString" Only support vpc address.', 'description' => '参数ConnectString只支持VPC地址'], + ['errorCode' => 'ACS.InvalidParameter.%s', 'errorMessage' => 'Parameter %s is invalid.', 'description' => '输入的参数无效'], + ['errorCode' => 'ACS.UnsupportedAvailableZone', 'errorMessage' => 'The specified available zone is not supported.', 'description' => '不支持的可用区.'], + ], + 403 => [ + ['errorCode' => 'ACS.ServerError', 'errorMessage' => 'ADB Cloud Service failed to process your request.', 'description' => 'ADB Cloud Service 服务错误'], + ], [ - 'name' => 'PrimaryKeyDefinition', - 'in' => 'formData', - 'schema' => [ - 'description' => '主键设置。包含uuid策略和映射策略。解释如下。'."\n" - .'Uuid策略： "Strategy": "uuid"。'."\n" - .'映射策略：'."\n" - .'"Strategy": "mapping",'."\n" - .'"Values":['."\n" - .' "f1",'."\n" - .' "f2"'."\n" - .'],'."\n" - .'"RecordVersionField","xxx"'."\n" - .'其中RecordVersionField的含义是HUDI记录版本。', - 'type' => 'string', - 'required' => false, - 'example' => '"Strategy": "mapping"', - ], + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改集群访问VIP', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBClusterVip'], + ], + ], + 'ramActions' => [ [ - 'name' => 'WorkloadName', - 'in' => 'formData', - 'schema' => [ - 'description' => 'Workload的名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBClusterVip', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-****-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', + ], + 'ModifyDBResourceGroup' => [ + 'summary' => '变更集群的资源组。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'LakehouseId', - 'in' => 'formData', - 'schema' => [ - 'description' => 'Lakehouse的ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '123', - ], + 'AK' => [], ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'paid', + 'abilityTreeCode' => '136445', + 'abilityTreeNodes' => ['FEATUREadsYXZ2UA'], + ], + 'parameters' => [ [ - 'name' => 'ResourceGroup', - 'in' => 'formData', - 'schema' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'aps', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版的集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1r053byu48p****'], ], [ - 'name' => 'HudiAdvancedConfig', - 'in' => 'formData', - 'schema' => [ - 'description' => '目标端HUDI配置。', - 'type' => 'string', - 'required' => false, - 'example' => 'hoodie.keep.min.commits=20', - ], + 'name' => 'GroupName', + 'in' => 'query', + 'schema' => ['description' => '资源组名称。'."\n" + .'> 您可以调用[DescribeDBResourceGroup](~~459446~~)接口查看指定集群的资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], ], [ - 'name' => 'AdvancedConfig', - 'in' => 'formData', + 'name' => 'GroupType', + 'in' => 'query', 'schema' => [ - 'description' => '高级配置。', + 'description' => '资源组类型，取值：'."\n" + .'- **Interactive**'."\n" + .'- **Job**'."\n" + .'> 关于湖仓版资源组的详细信息，请参见[资源组介绍](~~428610~~)。', 'type' => 'string', - 'required' => false, - 'example' => '-', + 'required' => true, + 'docRequired' => true, + 'example' => 'Interactive', + 'enum' => [], ], ], [ - 'name' => 'FullComputeUnit', - 'in' => 'formData', - 'schema' => [ - 'description' => '全量同步配置。', - 'type' => 'string', - 'required' => false, - 'example' => '2ACU', - ], + 'name' => 'MinComputeResource', + 'in' => 'query', + 'schema' => ['title' => '', 'description' => '最小计算预留资源。'."\n" + .'- 当资源组类型为Interactive时，计算预留资源最小为16ACU。'."\n" + .'- 当资源组类型为Job时，计算预留资源最小为0ACU。', 'type' => 'string', 'required' => false, 'example' => '0ACU'], ], [ - 'name' => 'IncrementalComputeUnit', - 'in' => 'formData', - 'schema' => [ - 'description' => '增量同步配置。', - 'type' => 'string', - 'required' => true, - 'example' => '2ACU', - ], + 'name' => 'MaxComputeResource', + 'in' => 'query', + 'schema' => ['description' => '最大计算预留资源。'."\n" + .'- 当资源组类型为Interactive时，计算预留资源最大为集群当前未分配资源，步长为16ACU。'."\n" + .'- 当资源组类型为Job时，计算预留资源最大为集群当前未分配资源，步长为8ACU。', 'type' => 'string', 'required' => false, 'example' => '48ACU'], ], [ - 'name' => 'KafkaClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => 'Kafka实例ID。可以在Kafka控制台获取。', - 'type' => 'string', - 'required' => false, - 'example' => 'xxx', - ], + 'name' => 'ClusterSizeResource', + 'in' => 'query', + 'schema' => ['description' => '预留参数（不涉及）。', 'type' => 'string', 'required' => false, 'example' => '无'], ], [ - 'name' => 'KafkaTopic', - 'in' => 'formData', - 'schema' => [ - 'description' => 'Kafka Topic ID。可以在Kafka控制台获取。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'name' => 'MinClusterCount', + 'in' => 'query', + 'schema' => ['description' => '预留参数（不涉及）。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '无'."\n"], ], [ - 'name' => 'StartingOffsets', - 'in' => 'formData', - 'schema' => [ - 'description' => 'Kafka起始消费位点。'."\n" - .'枚举如下：'."\n" - .'begin_cursor/end_cursor/timestamp'."\n" - .'分别对应最早/最近/指定时间。', - 'type' => 'string', - 'required' => true, - 'example' => 'begincursor', - ], + 'name' => 'MaxClusterCount', + 'in' => 'query', + 'schema' => ['description' => '预留参数（不涉及）。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '无'], ], [ - 'name' => 'MaxOffsetsPerTrigger', - 'in' => 'formData', - 'schema' => [ - 'description' => '单次消费条数。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '50000', - ], + 'name' => 'ClusterMode', + 'in' => 'query', + 'schema' => ['description' => '预留参数（不涉及）。', 'type' => 'string', 'required' => false, 'example' => '无'], ], [ - 'name' => 'DbName', - 'in' => 'formData', - 'schema' => [ - 'description' => '用户自定义的数据库名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'testDB', - ], + 'name' => 'EnableSpot', + 'in' => 'query', + 'schema' => ['description' => '资源组是否开启竞价实例功能。开启竞价实例后资源单价降低，但是有概率被释放。仅Job型资源组可以开启。取值：'."\n" + .'- **True**：开启竞价实例功能。'."\n" + .'- **False**：关闭竞价实例功能。', 'type' => 'boolean', 'required' => false, 'example' => 'True'], ], [ - 'name' => 'TableName', - 'in' => 'formData', - 'schema' => [ - 'description' => '用户自定义的表名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'testTB', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定群的地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'OutputFormat', - 'in' => 'formData', + 'name' => 'Rules', + 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => '输出数据格式。', - 'type' => 'string', + 'description' => '作业投递规则。', + 'type' => 'array', + 'items' => [ + 'description' => '规则信息列表。', + 'type' => 'object', + 'properties' => [ + 'GroupName' => ['description' => '资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'user_default'], + 'QueryTime' => ['description' => '查询执行时间阈值，单位为毫秒（ms）。', 'type' => 'string', 'required' => false, 'example' => '180000'."\n"], + 'TargetGroupName' => ['description' => '目标资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'job'."\n"], + ], + 'required' => false, + ], 'required' => false, - 'example' => 'HUDI', ], ], [ - 'name' => 'TargetType', - 'in' => 'formData', - 'schema' => [ - 'description' => '目标端类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'OSS', - ], + 'name' => 'EngineParams', + 'in' => 'query', + 'style' => 'json', + 'schema' => ['description' => '引擎配置。', 'type' => 'object', 'required' => false, 'example' => '{\\"spark.adb.version\\":\\"3.5\\"}'], ], [ - 'name' => 'TargetGenerateRule', - 'in' => 'formData', - 'schema' => [ - 'description' => '目标生成规则。', - 'type' => 'string', - 'required' => false, - 'example' => 'xxx', - ], + 'name' => 'AutoStopInterval', + 'in' => 'query', + 'schema' => ['description' => '自动停止时间', 'type' => 'string', 'required' => false, 'example' => '5m'], ], [ - 'name' => 'AcrossUid', - 'in' => 'formData', - 'schema' => [ - 'description' => '源端Kafka所属的阿里云账号的ID。', - 'type' => 'string', - 'required' => false, - 'example' => '123************', - ], + 'name' => 'SpecName', + 'in' => 'query', + 'schema' => ['description' => '预留参数，不涉及。', 'type' => 'string', 'required' => false, 'example' => 'Reserved parameter. Not applicable.'], ], [ - 'name' => 'AcrossRole', - 'in' => 'formData', - 'schema' => [ - 'description' => '可信实体为阿里云账号的RAM角色。如何创建RAM角色，请参见创建可信实体为阿里云账号的RAM角色。'."\n" - .'RAM角色中已将AnalyticDB MySQL所属阿里云账号设置为Kafka所属阿里云账号的信任云账号。', - 'type' => 'string', - 'required' => false, - 'example' => 'aps', - ], + 'name' => 'MinGpuQuantity', + 'in' => 'query', + 'schema' => ['description' => '预留参数，不涉及。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => 'Reserved parameter. Not applicable.'], ], [ - 'name' => 'SourceRegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'name' => 'MaxGpuQuantity', + 'in' => 'query', + 'schema' => ['description' => '预留参数，不涉及。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => 'Reserved parameter. Not applicable.'], ], [ - 'name' => 'JsonParseLevel', - 'in' => 'formData', - 'schema' => [ - 'description' => '设置JSON的嵌套解析层数，取值如下。'."\n" - .'0：不做解析。'."\n" - .'1：解析一层。'."\n" - .'2：解析两层。'."\n" - .'3：解析三层。'."\n" - .'4：解析四层。'."\n" - .'默认会解析一层。JSON的嵌套解析策略具体可见 JSON解析层级和Schema字段推断示例。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '0', - ], + 'name' => 'TargetResourceGroupName', + 'in' => 'query', + 'schema' => ['description' => '预留参数，不涉及。', 'type' => 'string', 'required' => false, 'example' => 'Reserved parameter. Not applicable.'], ], [ - 'name' => 'DataOutputFormat', - 'in' => 'formData', - 'schema' => [ - 'description' => '枚举值及说明。'."\n" - .'Single：源端是单行的Json记录。'."\n" - .'Multi：源端是Json数组。需要输出单条Json记录。', - 'type' => 'string', - 'required' => false, - 'example' => 'Single', - ], + 'name' => 'Status', + 'in' => 'query', + 'schema' => ['description' => '资源组状态。**starting** 表示启动资源组，**stopping**表示停止资源组', 'type' => 'string', 'required' => false, 'example' => 'starting'], ], [ - 'name' => 'OssLocation', - 'in' => 'formData', + 'name' => 'RayConfig', + 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => '目的端湖仓地址，完整OSS路径。', - 'type' => 'string', + 'description' => 'Ray配置信息(当资源组为ai资源组且对应引擎为RayCluster时需要填写)', + 'type' => 'object', + 'properties' => [ + 'EnableUserEni' => ['description' => '开启ENI。', 'type' => 'boolean', 'required' => false], + 'HeadSpecType' => [ + 'description' => 'Head节点资源类型。', + 'type' => 'string', + 'required' => false, + 'example' => 'CPU', + 'default' => 'CPU', + 'enum' => ['CPU', 'GPU'], + ], + 'HeadSpec' => ['description' => 'Head节点规格。', 'type' => 'string', 'required' => false, 'example' => 'xlarge'], + 'HeadAllocateUnit' => ['description' => 'Head节点分配单元。', 'type' => 'string', 'required' => false, 'example' => '1'], + 'HeadDiskCapacity' => ['description' => 'Head节点磁盘大小。', 'type' => 'string', 'required' => false, 'example' => '100G'], + 'Category' => [ + 'description' => 'Ray集群类型，取值说明：'."\n" + ."\n" + .'- BASIC：基础类型，非高可用'."\n" + ."\n" + .'- HIGH_AVAILABILITY：高可用类型', + 'type' => 'string', + 'required' => false, + 'example' => 'BASIC', + 'enum' => ['BASIC', 'HIGH_AVAILABILITY'], + ], + 'WorkerGroups' => [ + 'description' => 'Ray Worker组配置信息列表。', + 'type' => 'array', + 'items' => [ + 'description' => 'Ray Worker组配置信息。', + 'type' => 'object', + 'properties' => [ + 'AllocateUnit' => ['description' => '分配单元', 'type' => 'string', 'required' => false, 'example' => '1'], + 'GroupName' => ['description' => 'Worker组名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], + 'MaxWorkerQuantity' => ['description' => '最大Worker数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '2'], + 'MinWorkerQuantity' => ['description' => '最小Worker数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], + 'WorkerDiskCapacity' => ['description' => 'Worker节点的磁盘大小。', 'type' => 'string', 'required' => false, 'example' => '100G'], + 'WorkerSpecName' => ['description' => 'Worker节点规格。', 'type' => 'string', 'required' => false, 'example' => 'xlarge'], + 'WorkerSpecType' => [ + 'description' => 'Worker节点资源类型。', + 'type' => 'string', + 'required' => false, + 'example' => 'GPU', + 'enum' => ['CPU', 'GPU'], + ], + ], + 'required' => false, + ], + 'required' => false, + ], + 'AppConfig' => [ + 'title' => 'Ray应用配置', + 'description' => 'Ray应用配置', + 'type' => 'object', + 'properties' => [ + 'AppName' => ['title' => '应用名称', 'description' => '应用名称', 'type' => 'string', 'required' => false, 'example' => 'app01'], + 'AppType' => ['title' => '应用类型', 'description' => '应用类型', 'type' => 'string', 'required' => false, 'example' => 'IsaacLab'], + 'ImageSelector' => [ + 'title' => '镜像配置', + 'description' => '镜像配置', + 'type' => 'object', + 'properties' => [ + 'Image' => ['title' => '镜像名', 'description' => '镜像名', 'type' => 'string', 'required' => false, 'example' => 'lab2.10.0-ray2.43.0'], + 'InferenceEngine' => ['title' => '推理引擎', 'description' => '推理引擎', 'type' => 'string', 'required' => false, 'example' => 'vLLM'], + 'LlmModel' => ['title' => 'LLM模型', 'description' => 'LLM模型', 'type' => 'string', 'required' => false, 'example' => 'Deepseek-R1'], + ], + 'required' => false, + ], + ], + 'required' => false, + ], + 'StorageMounts' => [ + 'title' => '存储挂载列表', + 'description' => '存储挂载列表', + 'type' => 'array', + 'items' => [ + 'title' => '存储挂载', + 'description' => '存储挂载', + 'type' => 'object', + 'properties' => [ + 'StorageId' => ['title' => '存储ID', 'description' => '存储ID', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], + 'MountPath' => ['title' => '挂载路径', 'description' => '挂载路径', 'type' => 'string', 'required' => false, 'example' => '/mnt/data01'], + ], + 'required' => false, + ], + 'required' => false, + ], + 'UserDefinedRequirements' => ['type' => 'string'], + ], 'required' => false, - 'example' => 'oss://test-xx-zzz/yyy/', ], ], [ - 'name' => 'DatasourceId', - 'in' => 'formData', + 'name' => 'GpuElasticPlan', + 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => '数据源ID。', - 'type' => 'integer', - 'format' => 'int64', + 'description' => 'gpu分时弹性计划', + 'type' => 'object', + 'properties' => [ + 'Enabled' => ['description' => '创建后是否立即启用弹性计划。'."\n" + .'取值说明：'."\n" + .'- **true**：立即启用。'."\n" + .'- **false**：不启用。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'Rules' => [ + 'description' => '规则列表。', + 'type' => 'array', + 'items' => [ + 'description' => '规则', + 'type' => 'object', + 'properties' => [ + 'StartCronExpression' => ['description' => '启动时间，Cron表达式，间隔不低于1小时。', 'type' => 'string', 'required' => false, 'example' => '0 0 2 * * ?'], + 'EndCronExpression' => ['description' => '结束时间，Cron 表达式，间隔不低于 1 小时。', 'type' => 'string', 'required' => false, 'example' => '0 0 3 * * ?'], + ], + 'required' => false, + ], + 'required' => false, + ], + ], 'required' => false, - 'example' => '1', ], ], [ - 'name' => 'DataFormatType', - 'in' => 'formData', + 'name' => 'AtmConfig', + 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'title' => 'Kafka消息类型，支持的消息类型为：json、general_canal_json、mongo_canal_json、dataworks_json和shareplex_json', - 'description' => 'Kafka消息类型，支持的消息类型为：json、general_canal_json、mongo_canal_json、dataworks_json和shareplex_json', - 'type' => 'string', - 'required' => false, - 'example' => 'json', + 'title' => 'PromQL资源组配置', + 'type' => 'object', + 'properties' => [ + 'SelectNodeSpec' => ['title' => '查询节点规格（[0-9+]ACU）', 'type' => 'string', 'example' => '8ACU'], + 'SelectNodeNum' => ['title' => '查询节点数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'SelectNodeCacheSize' => ['title' => '查询节点缓存大小（GB）', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'StorageNodeSpec' => ['title' => '存储节点规格（[0-9+]ACU）', 'type' => 'string', 'example' => '8ACU'], + 'StorageNodeNum' => ['title' => '存储节点数量', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'StorageNodeDiskSize' => ['title' => '存储节点盘大小', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'StorageNodeDiskType' => [ + 'title' => '存储节点盘类型（essd_pl1，essd_pl2）', + 'type' => 'string', + 'example' => 'essd_pl1', + 'enum' => ['essd_pl1', 'essd_pl2'], + ], + 'InsertNodeSpec' => ['title' => '插入节点规格（[0-9+]ACU）', 'type' => 'string', 'example' => '8ACU'], + 'InsertNodeNum' => ['title' => '插入节点数量', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'AuthNodeSpec' => ['title' => '认证节点规格（[0-9+]ACU）', 'type' => 'string', 'example' => '8ACU'], + 'AuthNodeNum' => ['title' => '认证节点数量', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + ], ], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'HttpStatusCode' => [ - 'description' => 'HTTP状态码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Data' => [ - 'description' => '返回创建的任务ID。', - 'type' => 'string', - 'example' => 'xxx', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1A943417-5B0E-1DB9-A8**-A566****C3', - ], - 'Success' => [ - 'description' => '是否请求成功。'."\n" - .'True：成功。False：不成功。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Code' => [ - 'description' => '同HTTP状态码。', - 'type' => 'string', - 'example' => '200', - ], - 'Message' => [ - 'description' => '返回消息。', - 'type' => 'string', - 'example' => 'ok', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '805F14E1-0186-520E-A6D5-30188D94E8DA'], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": \\"xxx\\",\\n \\"RequestId\\": \\"1A943417-5B0E-1DB9-A8**-A566****C3\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"ok\\"\\n}","errorExample":""},{"type":"xml","example":"<CreateApsKafkaHudiJobResponse>\\n <HttpStatusCode>200</HttpStatusCode>\\n <Data>xxx</Data>\\n <RequestId>1A943417-5B0E-1DB9-A8**-A566****C3</RequestId>\\n <Success>true</Success>\\n <Code>200</Code>\\n <Message>ok</Message>\\n</CreateApsKafkaHudiJobResponse>","errorExample":""}]', - 'title' => '创建APS Kafka入湖任务', - ], - 'ListApsLifecycleStrategy' => [ - 'summary' => '获取当前ADB实例生命周期管理策略列表。', - 'methods' => [ - 'post', - 'get', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidPoolName.Malformed', 'errorMessage' => 'The specified parameter PoolName is not valid.', 'description' => 'PoolName参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPoolUser.Malformed', 'errorMessage' => 'The specified parameter PoolUser is not valid.', 'description' => 'PoolUser参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPoolType.Malformed', 'errorMessage' => 'The specified parameter PoolType is not valid.', 'description' => 'PoolType参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidMinComputeResource.Malformed', 'errorMessage' => 'The specified parameter MinComputeResource is not valid.', 'description' => 'MinComputeResource参数不正确，请确认参数是否符合规范。'."\n"], + ['errorCode' => 'InvalidMaxComputeResource.Malformed', 'errorMessage' => 'The specified parameter MaxComputeResource is not valid.', 'description' => 'MaxComputeResource参数不正确，请确认参数是否符合规范。'."\n"], + ['errorCode' => 'ACS.ResourceGroup.ElasticPlanExists', 'errorMessage' => 'This resource group does not support this operation. Elastic plans that have been enabled already exist.', 'description' => '当前资源组不支持此操作：存在启用的弹性计划。'], + ['errorCode' => 'ACS.ResourceGroup.InvalidResourceGroupState', 'errorMessage' => 'The state of this resource group does not support this operation.', 'description' => '当前状态的资源组不支持此操作。'], + ], + ], + 'gatewayOptions' => [ + 'gatewayProtocols' => [], + ], + 'title' => '修改资源组', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2025-12-02T15:07:18.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2025-10-17T13:49:01.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2025-08-20T12:54:57.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2025-03-31T12:12:58.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-10-15T17:29:25.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-08-13T16:32:41.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-03-25T02:12:25.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2024-01-26T02:37:32.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-12-19T08:51:25.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-09-25T10:08:40.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-04-13T11:20:16.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-03-31T07:03:57.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:51:36.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBResourceGroup'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBResourceGroup', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"805F14E1-0186-520E-A6D5-30188D94E8DA\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyDBResourceGroupResponse>\\n <RequestId>805F14E1-0186-520E-A6D5-30188D94E8DA</RequestId>\\n</ModifyDBResourceGroupResponse>","errorExample":""}]', + ], + 'ModifyElasticPlan' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'abilityTreeCode' => '200829', - 'abilityTreeNodes' => [ - 'FEATUREadsNQ1ZDK', - ], - ], + 'systemTags' => ['operationType' => 'update'], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-*******', - ], + 'name' => 'ElasticPlanName', + 'in' => 'query', + 'schema' => ['description' => '弹性计划名称。'."\n" + .'> 调用[DescribeElasticPlans](~~601334~~)接口可以查看指定集群的弹性计划名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], ], [ 'name' => 'StartTime', - 'in' => 'formData', - 'schema' => [ - 'description' => '查询开始时间。格式为yyyy-MM-ddTHH:mmZ（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'example' => '2024-01-01T11:22Z', - ], + 'in' => 'query', + 'schema' => ['description' => '开始时间。'."\n" + ."\n" + .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'required' => false, 'example' => '2022-01-01T12:01:00Z'], ], [ 'name' => 'EndTime', - 'in' => 'formData', - 'schema' => [ - 'description' => '查询终止时间。格式为yyyy-MM-ddTHH:mmZ（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'example' => '2024-01-02T11:22Z', - ], + 'in' => 'query', + 'schema' => ['description' => '结束时间。'."\n" + ."\n" + .'> 格式为yyyy-MM-ddTHH:mm:ssZ。', 'type' => 'string', 'required' => false, 'example' => '2025-01-01T12:01:00Z'], ], [ - 'name' => 'PageNumber', - 'in' => 'formData', - 'schema' => [ - 'description' => '页号。', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], + 'name' => 'CronExpression', + 'in' => 'query', + 'schema' => ['description' => 'Cron表达式，表示弹性计划的变配周期和变配时间。', 'type' => 'string', 'required' => false, 'example' => '0 20 14 * * ?'], ], [ - 'name' => 'PageSize', - 'in' => 'formData', - 'schema' => [ - 'description' => '页大小。', - 'type' => 'string', - 'required' => false, - 'example' => '30', - ], + 'name' => 'TargetSize', + 'in' => 'query', + 'schema' => ['description' => '目标规格。'."\n" + .'> - 只有弹性资源类型为**存储加速服务弹性计划**并且启用了**存储加速服务(EIU)按比例默认弹性**，可以不填写该参数。其它情况下，该参数为必填项。'."\n" + .'- 调用[DescribeElasticPlanSpecifications](~~601278~~)接口可以查看弹性计划支持的弹性变配规格。', 'type' => 'string', 'required' => false, 'example' => '32ACU'], + ], + [ + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-wz9509beptiz****'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'ResultData<?>', - 'description' => 'ResultData<?>', + 'title' => 'BaseResponse', + 'description' => 'BaseResponse', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**OK**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'OK', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => '200', - ], - 'Items' => [ - 'description' => '任务列表。', - 'type' => 'array', - 'items' => [ - 'description' => '列表详情。', - 'type' => 'object', - 'properties' => [ - 'OperationTables' => [ - 'description' => '-', - 'type' => 'array', - 'items' => [ - 'description' => '-', - 'type' => 'object', - 'properties' => [ - 'DatabaseName' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'ProcessAll' => [ - 'description' => '是否全选，如果设置为true，则表示选择当前库中所有表。', - 'type' => 'string', - 'example' => 'true', - ], - 'TableNames' => [ - 'description' => '数据表的名称。', - 'type' => 'array', - 'items' => [ - 'description' => '数据表的名称。', - 'type' => 'string', - 'example' => 'test', - ], - ], - ], - ], - ], - 'StrategyDesc' => [ - 'description' => '生命周期管理策略描述内容。', - 'type' => 'string', - 'example' => 'test', - ], - 'StrategyName' => [ - 'description' => '生命周期管理策略名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'StrategyType' => [ - 'description' => '生命周期管理策略类型。', - 'type' => 'string', - 'example' => 'KEEP_BY_TIME', - ], - 'StrategyValue' => [ - 'description' => '生命周期管理策略值，KEEP_BY_TIME对应的值。', - 'type' => 'string', - 'example' => '10', - ], - 'Status' => [ - 'description' => '生命周期管理策略的状态，两个枚举值分别为：'."\n" - .'1. on：标识启用当前策略'."\n" - .'2. off：表示禁用当前策略', - 'type' => 'string', - 'example' => 'on', - ], - 'CreatedTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2021-06-30T02:44:27Z', - ], - 'ModifiedTime' => [ - 'description' => '修改时间。', - 'type' => 'string', - 'example' => '2021-07-03T06:33:00Z', - ], - 'ApsJobId' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => 'aps-******', - ], - 'StrategyDatabases' => [ - 'description' => '生命周期管理的库个数统计。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '5', - ], - 'StrategyTables' => [ - 'description' => '生命周期管理的表个数统计。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '5', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-*******', - ], - ], - ], - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'TotalCount' => [ - 'description' => '总记录条数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A5C433C2-001F-58E3-99F5-3274C14DF8BD'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"200\\",\\n \\"Items\\": [\\n {\\n \\"OperationTables\\": [\\n {\\n \\"DatabaseName\\": \\"test\\",\\n \\"ProcessAll\\": \\"true\\",\\n \\"TableNames\\": [\\n \\"test\\"\\n ]\\n }\\n ],\\n \\"StrategyDesc\\": \\"test\\",\\n \\"StrategyName\\": \\"test\\",\\n \\"StrategyType\\": \\"KEEP_BY_TIME\\",\\n \\"StrategyValue\\": \\"10\\",\\n \\"Status\\": \\"on\\",\\n \\"CreatedTime\\": \\"2021-06-30T02:44:27Z\\",\\n \\"ModifiedTime\\": \\"2021-07-03T06:33:00Z\\",\\n \\"ApsJobId\\": \\"aps-******\\",\\n \\"StrategyDatabases\\": 5,\\n \\"StrategyTables\\": 5,\\n \\"DBClusterId\\": \\"amv-*******\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 10\\n}","type":"json"}]', - 'title' => '获取当前ADB实例生命周期管理策略列表', - ], - 'GetApsManagedDatabases' => [ - 'summary' => '获取数据库列表。', - 'methods' => [ - 'post', - 'get', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], + ], + 'title' => '修改弹性计划', + 'summary' => '修改集群的弹性计划。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2023-12-12T10:09:37.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-04-13T11:20:15.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyElasticPlan'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyElasticPlan', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5C433C2-001F-58E3-99F5-3274C14DF8BD\\"\\n}","errorExample":""},{"type":"xml","example":"<ModifyElasticPlanResponse>\\n <RequestId>A5C433C2-001F-58E3-99F5-3274C14DF8BD</RequestId>\\n</ModifyElasticPlanResponse>","errorExample":""}]', + ], + 'ModifyEssdCacheConfig' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '200691', - 'abilityTreeNodes' => [ - 'FEATUREadsNQ1ZDK', - ], - ], + 'systemTags' => ['operationType' => 'update'], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => 'ADB实例ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-******', - ], + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp10yt0gva71ei7d'], ], [ - 'name' => 'RegionId', - 'in' => 'formData', + 'name' => 'EnableEssdCache', + 'in' => 'query', 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', + 'description' => '是否开启云盘缓存。', + 'type' => 'boolean', 'required' => true, - 'example' => 'cn-hangzhou', + 'docRequired' => true, + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], + 'example' => 'true', ], ], + [ + 'name' => 'EssdCacheSize', + 'in' => 'query', + 'schema' => ['description' => '云盘缓存大小，单位为GB。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'docRequired' => true, 'example' => '500'], + ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'string', - 'example' => '-', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '115F9CCA-EF2E-5F91-AB60-4961D52FEAB4'], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidMaintainTime.Malformed', 'errorMessage' => 'The specified parameter MaintainTime is not valid.', 'description' => 'MaintainTime参数不正确，请确认参数是否符合规范。'."\n"], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"Success\\",\\n \\"Success\\": true,\\n \\"Data\\": \\"-\\"\\n}","type":"json"}]', - 'title' => '获取APS管理的数据库列表', - ], - 'CreateApsSlsADBJob' => [ - 'summary' => '创建一个SLS到ADB数仓的APS链路。', - 'methods' => [ - 'get', - 'post', + 'title' => '修改云盘缓存', + 'summary' => '修改集群加速配置，EIU云盘空间缓存大小。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyEssdCacheConfig'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyEssdCacheConfig', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"115F9CCA-EF2E-5F91-AB60-4961D52FEAB4\\"\\n}","type":"json"}]', + ], + 'ModifyLakeCacheSize' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', - 'abilityTreeCode' => '207599', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - ], + 'operationType' => 'get', + 'abilityTreeCode' => '214852', + 'abilityTreeNodes' => ['FEATUREadsCQJTKP'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-*********', - ], + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp10yt0gva71ei7d'], ], [ - 'name' => 'RegionId', - 'in' => 'formData', + 'name' => 'EnableLakeCache', + 'in' => 'query', 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', + 'description' => '是否开启湖存储加速', + 'type' => 'boolean', 'required' => true, - 'example' => 'cn-hangzhou', + 'docRequired' => true, + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], + 'example' => 'true', ], ], [ - 'name' => 'PartitionSpecs', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => '分区信息。', - 'type' => 'array', - 'items' => [ - 'description' => '分区信息。', - 'type' => 'object', - 'required' => false, - 'example' => '-', - ], - 'required' => false, - 'example' => '-', - ], + 'name' => 'Capacity', + 'in' => 'query', + 'schema' => ['description' => '缓存空间大小设置，单位为GB', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '100'], ], - [ - 'name' => 'Columns', - 'in' => 'formData', - 'style' => 'json', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '列信息。', - 'type' => 'array', - 'items' => [ - 'description' => '列信息。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '列名。', - 'type' => 'string', - 'required' => false, - 'example' => 'id', - ], - 'MapName' => [ - 'description' => '映射名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], - 'Type' => [ - 'description' => '列数据类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'bigint', - ], - 'MapType' => [ - 'description' => '映射类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'int', + 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', + 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '494486CE-6F49-574E-B304-29127EA12E36'], + 'Code' => ['description' => '状态码。说明 200表示成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => [ + 'description' => '返回结果数据。', + 'type' => 'object', + 'properties' => [ + 'Instances' => [ + 'description' => '共享湖存储缓存空间的集群列表', + 'type' => 'array', + 'items' => ['description' => '集群ID', 'type' => 'string', 'example' => 'amv-bp10yt0gva71ei7d'], + ], + 'Capacity' => ['description' => '湖存储缓存空间大小，单位为GB', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'DataSize' => ['description' => '已使用的湖存储缓存空间容量，单位为GB', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], ], ], - 'required' => false, - 'example' => '-', ], - 'required' => true, - 'example' => '-', ], ], - [ - 'name' => 'PrimaryKeyDefinition', - 'in' => 'formData', - 'schema' => [ - 'description' => '主键定义。', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], - ], - [ - 'name' => 'WorkloadName', - 'in' => 'formData', - 'schema' => [ - 'description' => '工作负载名。', - 'type' => 'string', - 'required' => true, - 'example' => 'sls-******', - ], + ], + 'title' => '修改湖存储缓存空间', + 'summary' => '修改集群湖存储加速缓存空间大小。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyLakeCacheSize'], ], + ], + 'ramActions' => [ [ - 'name' => 'LakehouseId', - 'in' => 'formData', - 'schema' => [ - 'description' => 'lakehosue ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '123', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:ModifyLakeCacheSize', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"494486CE-6F49-574E-B304-29127EA12E36\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"Instances\\": [\\n \\"amv-bp10yt0gva71ei7d\\"\\n ],\\n \\"Capacity\\": 100,\\n \\"DataSize\\": 100\\n }\\n}","type":"json"}]', + ], + 'ModifyMaterializedView' => [ + 'path' => '', + 'methods' => ['post', 'get'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'ResourceGroup', - 'in' => 'formData', - 'schema' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'AK' => [], ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREadsTYGUV3'], + ], + 'parameters' => [ [ - 'name' => 'AdvancedConfig', - 'in' => 'formData', - 'schema' => [ - 'description' => '高级配置。', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing'], ], [ - 'name' => 'HudiAdvancedConfig', - 'in' => 'formData', - 'schema' => [ - 'description' => 'huid高级配置。', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['title' => 'ADB实例ID', 'description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-******'], ], [ - 'name' => 'FullComputeUnit', - 'in' => 'formData', - 'schema' => [ - 'description' => '全量acu。', - 'type' => 'string', - 'required' => false, - 'example' => '16', - ], + 'name' => 'ViewName', + 'in' => 'query', + 'schema' => ['title' => '物化视图名称', 'description' => '物化视图名称。', 'type' => 'string', 'required' => true, 'example' => 'mv_1'], ], [ - 'name' => 'IncrementalComputeUnit', - 'in' => 'formData', - 'schema' => [ - 'description' => '增量acu。', - 'type' => 'string', - 'required' => false, - 'example' => '168', - ], + 'name' => 'DbName', + 'in' => 'query', + 'schema' => ['title' => '物化视图所在DB名', 'description' => '物化视图所在数据库名称。', 'type' => 'string', 'required' => true, 'example' => 'myDB'], ], [ - 'name' => 'Project', - 'in' => 'formData', - 'schema' => [ - 'description' => '项目名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'name' => 'GroupName', + 'in' => 'query', + 'schema' => ['title' => '物化视图绑定的资源组名称', 'description' => '物化视图绑定的资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'res_1'], ], [ - 'name' => 'Store', - 'in' => 'formData', - 'schema' => [ - 'description' => 'sls Store。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'name' => 'QueryWrite', + 'in' => 'query', + 'schema' => ['title' => '启用/禁用重写功能', 'description' => '是否开启重写功能。取值如下： '."\n" + .'- true：是。 '."\n" + ."\n" + .'- false：否。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], ], [ - 'name' => 'StartingOffsets', - 'in' => 'formData', - 'schema' => [ - 'description' => '投递起始位点。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - ], + 'name' => 'EnableFailureAlert', + 'in' => 'query', + 'schema' => ['title' => '开启刷新任务失败告警', 'description' => '开启刷新任务失败告警。取值如下：'."\n" + ."\n" + .'- true：是。 '."\n" + .'- false：否。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], ], [ - 'name' => 'MaxOffsetsPerTrigger', - 'in' => 'formData', - 'schema' => [ - 'description' => '最大位点。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '-', - ], + 'name' => 'EnableDelayAlert', + 'in' => 'query', + 'schema' => ['title' => '开启刷新延迟告警', 'description' => '开启刷新延迟告警。取值如下：'."\n" + ."\n" + .'- true：是。'."\n" + .'- false：否。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], ], [ - 'name' => 'DbName', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'required' => true, - 'example' => 'dbName', - ], + 'name' => 'LatencyTolerance', + 'in' => 'query', + 'schema' => ['title' => '刷新延迟容忍度（分钟）', 'description' => '刷新延迟容忍度（分钟）。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '2'], ], - [ - 'name' => 'TableName', - 'in' => 'formData', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => "\n" - .'表名。', - 'type' => 'string', - 'required' => true, - 'example' => 'test', + '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' => 'CF8BA882-C9D8-5BEF-AAA3-AD03875F3E18'], + ], ], ], - [ - 'name' => 'OutputFormat', - 'in' => 'formData', - 'schema' => [ - 'description' => '输出格式。', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改物化视图', + 'summary' => '修改物化视图。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyMaterializedView'], ], + ], + 'ramActions' => [ [ - 'name' => 'TargetType', - 'in' => 'formData', - 'schema' => [ - 'description' => '目标端类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'ADB', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyMaterializedView', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"CF8BA882-C9D8-5BEF-AAA3-AD03875F3E18\\"\\n}","type":"json"}]', + ], + 'ModifyMaterializedViewRecommend' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ [ - 'name' => 'TargetGenerateRule', - 'in' => 'formData', - 'schema' => [ - 'description' => '目标端生成规则。', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], + 'AK' => [], ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREadsTYGUV3'], + ], + 'parameters' => [ [ - 'name' => 'AcrossUid', - 'in' => 'formData', - 'schema' => [ - 'description' => '跨账号UID。', - 'type' => 'string', - 'required' => false, - 'example' => '123456', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'AcrossRole', - 'in' => 'formData', - 'schema' => [ - 'description' => '跨账号角色名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test-role', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-uf6o*****'], ], [ - 'name' => 'SourceRegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '源集群所处地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', - ], + 'name' => 'TaskName', + 'in' => 'query', + 'schema' => ['title' => '推荐任务名称', 'description' => '物化视图推荐任务的名称。', 'type' => 'string', 'required' => true, 'example' => 'task_n1'], ], [ - 'name' => 'OssLocation', - 'in' => 'formData', + 'name' => 'SchedulingPolicy', + 'in' => 'query', 'schema' => [ - 'description' => 'oss地址。', + 'title' => '推荐的策略，取值"daliy"或"weekly"', + 'description' => '推荐的策略。取值如下： '."\n" + .'- daliy：按日调度。'."\n" + .'- weekly：按周调度。', 'type' => 'string', 'required' => false, - 'example' => 'oss://test*', + 'example' => 'weekly', + 'enum' => ['daily', 'weekly'], ], ], [ - 'name' => 'DatasourceId', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据源ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '327', - ], + 'name' => 'SchedulingDay', + 'in' => 'query', + 'schema' => ['title' => '仅当SchedulingPolicy取值为weekly时有效，取值为：Monday|Tuesday|Wendesday|Thursday|Friday|Saturday|Sunday，多天以逗号分隔符拼接', 'description' => '仅当SchedulingPolicy取值为weekly时有效，取值如下：'."\n" + .'- Monday'."\n" + .'- Tuesday'."\n" + .'- Wednesday'."\n" + .'- Thursday'."\n" + .'- Friday'."\n" + .'- Saturday'."\n" + .'- Sunday'."\n" + ."\n" + .'多天以逗号分隔符拼接。', 'type' => 'string', 'required' => false, 'example' => 'Monday;Wednesday'], ], [ - 'name' => 'DirtyDataProcessPattern', - 'in' => 'formData', - 'schema' => [ - 'description' => '脏数据处理模式。', - 'type' => 'string', - 'required' => false, - 'example' => 'STOP', - ], + 'name' => 'SpecifiedTime', + 'in' => 'query', + 'schema' => ['title' => '任务的执行时间，格式HH:MM:SS', 'description' => '任务的执行时间，格式HH:MM:SS。', 'type' => 'string', 'required' => false, 'example' => '10:00:00'], ], [ - 'name' => 'ExactlyOnce', - 'in' => 'formData', - 'schema' => [ - 'description' => '精确一致。', - 'type' => 'string', - 'required' => false, - 'example' => 'false', - ], + 'name' => 'ScanQueriesRange', + 'in' => 'query', + 'schema' => ['title' => '扫描的时间范围，单位天，默认取值3', 'description' => '扫描的时间范围，单位天，默认取值3。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '3'], ], [ - 'name' => 'UnixTimestampConvert', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => '时间戳转换。', - 'type' => 'object', - 'properties' => [ - 'Convert' => [ - 'description' => '转换。', - 'type' => 'string', - 'required' => false, - 'example' => 'false。', - ], - 'Format' => [ - 'description' => '格式。', - 'type' => 'string', - 'required' => false, - 'example' => "\0".'APSyyyyMMdd', - ], - 'Transform' => [ - 'description' => '转换开关。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - ], - 'required' => false, - 'example' => '-', - ], + 'name' => 'Description', + 'in' => 'query', + 'schema' => ['title' => '推荐任务的描述', 'description' => '推荐任务的描述。', 'type' => 'string', 'required' => false, 'example' => 'task desc'], ], [ - 'name' => 'UserName', - 'in' => 'formData', - 'schema' => [ - 'description' => '用户名。', - 'type' => 'string', - 'required' => true, - 'example' => 'user_test', - ], + 'name' => 'SlowQueryThreshold', + 'in' => 'query', + 'schema' => ['title' => '慢查询阈值', 'description' => '慢查询阈值。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'minimum' => '1', 'example' => '2'], ], [ - 'name' => 'Password', - 'in' => 'formData', - 'schema' => [ - 'description' => '密码。', - 'type' => 'string', - 'required' => true, - 'example' => 'test_user', - ], + 'name' => 'MinRewriteQueryPattern', + 'in' => 'query', + 'schema' => ['title' => '最小可加速的Pattern数量', 'description' => '最小可加速的Pattern数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'minimum' => '1', 'example' => '5'], ], [ - 'name' => 'DirtyDataHandleMode', - 'in' => 'formData', - 'schema' => [ - 'description' => '脏数据处理模式。', - 'type' => 'string', - 'required' => true, - 'example' => '-', - ], + 'name' => 'MinRewriteQueryCount', + 'in' => 'query', + 'schema' => ['title' => 'Pattern匹配的最少慢查询个数', 'description' => 'Pattern匹配的最少慢查询个数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'minimum' => '1', 'example' => '3'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'string', - 'example' => '-', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'Success' => [ - 'description' => '预检查结果，返回值说明：'."\n" - ."\n" - .'- **success**：检查通过。'."\n" - .'- **false**：检查不通过。', - 'type' => 'boolean', - 'example' => 'True', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => 'InvalidInput', - ], - 'Message' => [ - 'description' => '调用结果的信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常信息。', - 'type' => 'string', - 'example' => 'Success', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'F0983B43-B2EC-536A-8791-142B5CF1E9B6'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": \\"-\\",\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Message\\": \\"Success\\"\\n}","type":"json"}]', - 'title' => '创建一个SLS到ADB数仓的APS链路', - ], - 'ListApsOptimizationTasks' => [ - 'summary' => '获取指定类型湖存储优化策略执行过的任务列表。湖存储优化策略会周期性调度执行优化任务。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改物化视图自动推荐任务', + 'summary' => '修改物化视图自动推荐任务。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyMaterializedViewRecommend'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyMaterializedViewRecommend', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F0983B43-B2EC-536A-8791-142B5CF1E9B6\\"\\n}","type":"json"}]', + ], + 'ModifyPerformanceView' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'tags' => ['Perth'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', - 'abilityTreeCode' => '200821', - 'abilityTreeNodes' => [ - 'FEATUREadsNQ1ZDK', - ], + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '220840', + 'abilityTreeNodes' => ['FEATUREadsDAZVRM'], + 'autoTest' => true, + 'tenantRelevance' => 'tenant', ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-*******', - ], - ], - [ - 'name' => 'StrategyType', - 'in' => 'formData', - 'schema' => [ - 'description' => '生命周期管理策略类型。'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'StrategyValue', - ], - ], - [ - 'name' => 'StartTime', - 'in' => 'formData', - 'schema' => [ - 'description' => '查询开始时间。格式为yyyy-MM-ddTHH:mmZ（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'example' => '2022-01-23T02:18Z', - ], + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + ."\n" + .'> 调用[DescribeDBClusters](~~612397~~)接口可以查看集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1ub9grke1****'], ], [ - 'name' => 'EndTime', - 'in' => 'formData', - 'schema' => [ - 'description' => '查询终止时间。格式为yyyy-MM-ddTHH:mmZ（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'example' => '2022-09-30T00:15Z', - ], + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'PageNumber', - 'in' => 'formData', - 'schema' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'name' => 'ViewName', + 'in' => 'query', + 'schema' => ['description' => '监控视图名称。', 'type' => 'string', 'required' => true, 'example' => 'Custom-All metrics-2 columns-Linked'], ], [ - 'name' => 'PageSize', - 'in' => 'formData', - 'schema' => [ - 'description' => '每页大小。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - ], - ], - ], - 'responses' => [ - 200 => [ + 'name' => 'ViewDetail', + 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'title' => 'PageResult<?>', - 'description' => 'PageResult<?>', + 'description' => '监控视图详情。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'Items' => [ - 'description' => '信息列表。', + 'ChartsPerLine' => ['description' => '每一行展示的图表数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '3'], + 'ChartLinked' => ['description' => '是否联动图表。取值：'."\n" + ."\n" + .'- true'."\n" + .'- false', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'Categories' => [ + 'description' => '指标分类列表。', 'type' => 'array', 'items' => [ - 'description' => '-', + 'description' => '指标分类。', 'type' => 'object', 'properties' => [ - 'ComputeUnit' => [ - 'description' => '任务使用的计算资源。', - 'type' => 'string', - 'example' => '2', - ], - 'CreatedTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2022-01-23T02:18Z', - ], - 'ModifiedTime' => [ - 'description' => '修改时间。', - 'type' => 'string', - 'example' => '2022-09-30T00:15Z', - ], - 'TaskDesc' => [ - 'description' => '任务描述。', - 'type' => 'string', - 'example' => 'test', - ], - 'TaskDuration' => [ - 'description' => '任务执行时长。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1000', - ], - 'TaskId' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => 'sj-hz******', - ], - 'TaskMessage' => [ - 'description' => '任务执行错误信息。', - 'type' => 'string', - 'example' => '-', - ], - 'TaskStatus' => [ - 'description' => '任务执行状态，枚举类型，分为以下几种状态：'."\n" - .'1. NEW：任务刚新建，还未运行'."\n" - .'2. RUNNING：任务正在运行中'."\n" - .'3. SUCCESS：任务执行成功'."\n" - .'4. STOPPED：任务暂停中'."\n" - .'5. FAILED：任务执行失败', - 'type' => 'string', - 'example' => 'RUNNING', - ], - 'StrategyType' => [ - 'description' => '生命周期管理策略类型。', - 'type' => 'string', - 'example' => 'StrategyValue', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-*******', + 'Category' => ['description' => '指标分类名，取值：'."\n" + .'* **Node**：节点资源指标'."\n" + .'* **DiskData**：磁盘指标'."\n" + .'* **WorkLoad**：负载指标'."\n" + .'* **ResourceGroup**：资源组指标', 'type' => 'string', 'required' => false, 'example' => 'Node'], + 'Keys' => [ + 'description' => '指标列表', + 'type' => 'array', + 'items' => [ + 'description' => '单个指标配置。', + 'type' => 'object', + 'properties' => [ + 'KeyName' => ['description' => '指标Key。', 'type' => 'string', 'required' => false, 'example' => 'AnalyticDB_CPU'], + 'Selected' => ['description' => '是否选中。取值：'."\n" + ."\n" + .'- true'."\n" + .'- false', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + ], + 'required' => false, + ], + 'required' => false, ], ], - 'example' => '-', + 'required' => false, ], - 'example' => '-', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页大小。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '15', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：调用成功。'."\n" - .'- **false**：调用失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => 'InvalidInput', - ], - 'Message' => [ - 'description' => '应用建议执行结果。取值说明：'."\n" - .'- 请求正常，返回**SUCCESS**。 '."\n" - .'- 请求异常，返回具体异常错误信息。', - 'type' => 'string', - 'example' => 'SUCCESS', + 'required' => false, ], ], + 'required' => true, ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Items\\": [\\n {\\n \\"ComputeUnit\\": \\"2\\",\\n \\"CreatedTime\\": \\"2022-01-23T02:18Z\\",\\n \\"ModifiedTime\\": \\"2022-09-30T00:15Z\\",\\n \\"TaskDesc\\": \\"test\\",\\n \\"TaskDuration\\": 1000,\\n \\"TaskId\\": \\"sj-hz******\\",\\n \\"TaskMessage\\": \\"-\\",\\n \\"TaskStatus\\": \\"RUNNING\\",\\n \\"StrategyType\\": \\"StrategyValue\\",\\n \\"DBClusterId\\": \\"amv-*******\\"\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 15,\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Message\\": \\"SUCCESS\\"\\n}","type":"json"}]', - 'title' => '获取指定类型湖存储优化策略执行过的任务列表。', - ], - 'ListApsOptimizationStrategy' => [ - 'summary' => '获取当前ADB实例湖存储优化策略列表。', - 'methods' => [ - 'post', - 'get', + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'C7EDB8E4-9769-4233-88C7-DCA4C9******'], + 'ModifyStatus' => ['description' => '修改结果，取值：'."\n" + ."\n" + .'- **SUCCESS**：成功'."\n" + .'- **FAILED**：失败', 'type' => 'string', 'example' => 'SUCCESS'], + 'AccessDeniedDetail' => ['description' => '访问被拒绝详细信息；只有校验RAM失败后，字段才会返回。', 'type' => 'string', 'example' => '{'."\n" + .' "PolicyType": "AccountLevelIdentityBasedPolicy",'."\n" + .' "AuthPrincipalOwnerId": "1*****************7",'."\n" + .' "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",'."\n" + .' "AuthPrincipalType": "SubUser",'."\n" + .' "AuthPrincipalDisplayName": "2***************9",'."\n" + .' "NoPermissionType": "ImplicitDeny",'."\n" + .' "AuthAction": "adb:DescribeExcessivePrimaryKeys"'."\n" + .'}'], + ], + 'description' => '', + ], + ], ], - 'schemes' => [ - 'http', - 'https', + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改自定义监控视图', + 'summary' => '修改自定义监控视图。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyPerformanceView'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyPerformanceView', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C7EDB8E4-9769-4233-88C7-DCA4C9******\\",\\n \\"ModifyStatus\\": \\"SUCCESS\\",\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"AccountLevelIdentityBasedPolicy\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"1*****************7\\\\\\",\\\\n \\\\\\"EncodedDiagnosticMessage\\\\\\": \\\\\\"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"2***************9\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"ImplicitDeny\\\\\\",\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"adb:DescribeExcessivePrimaryKeys\\\\\\"\\\\n}\\"\\n}","type":"json"}]', + ], + 'ModifySqlTemplatePosition' => [ + 'summary' => '用于修改SQL模板的目录位置', + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'abilityTreeCode' => '200834', - 'abilityTreeNodes' => [ - 'FEATUREadsNQ1ZDK', - ], - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'in' => 'query', + 'schema' => ['title' => 'RegionId', 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-*******', - ], + 'in' => 'query', + 'schema' => ['title' => '实例ID', 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-uf6wjk5xxxxxxxxxx'], + ], + [ + 'name' => 'TemplateId', + 'in' => 'query', + 'schema' => ['title' => '分组Id', 'description' => '模板ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '210208'], + ], + [ + 'name' => 'TargetTemplateGroupId', + 'in' => 'query', + 'schema' => ['title' => '参数模板Id', 'description' => '模板分组ID', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'ResultData<?>', - 'description' => 'ResultData<?>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：调用成功。'."\n" - .'- **false**：调用失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '应用建议执行结果。取值说明：'."\n" - .'- 请求正常，返回**SUCCESS**。 '."\n" - .'- 请求异常，返回具体异常错误信息。', - 'type' => 'string', - 'example' => 'Success', - ], - 'Code' => [ - 'description' => '需要执行的代码。', - 'type' => 'string', - 'example' => 'InvalidInput', - ], - 'Data' => [ - 'description' => '返回结果。', - 'type' => 'array', - 'items' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'StrategyDesc' => [ - 'description' => '生命周期管理策略描述内容。', - 'type' => 'string', - 'example' => 'test', - ], - 'StrategyName' => [ - 'description' => '生命周期管理策略名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'StrategyType' => [ - 'description' => '生命周期管理策略类型，目前只有一个值StrategyValue。', - 'type' => 'string', - 'example' => 'StrategyValue', - ], - 'Status' => [ - 'description' => '生命周期管理策略的状态，两个枚举值分别为：'."\n" - .'1. on：标识启用当前策略'."\n" - .'2. off：表示禁用当前策略', - 'type' => 'string', - 'example' => 'off', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-23xxxx', - ], - ], - 'example' => '-', - ], - 'example' => '-', - ], + 'Message' => ['description' => '调用结果的信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常信息。', 'type' => 'string', 'example' => 'success'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '5DC10091-348D-12B1-906D-AB49D658012E'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"Success\\",\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Data\\": [\\n {\\n \\"StrategyDesc\\": \\"test\\",\\n \\"StrategyName\\": \\"test\\",\\n \\"StrategyType\\": \\"StrategyValue\\",\\n \\"Status\\": \\"off\\",\\n \\"DBClusterId\\": \\"amv-23xxxx\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '获取当前ADB实例湖存储优化策略列表。', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改SQL模板位置', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeAPSADBInstances' => [ - 'summary' => '获取APS联邦分析ADB实例列表。', - 'methods' => [ - 'get', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifySqlTemplatePosition'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:ModifySqlTemplatePosition', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"5DC10091-348D-12B1-906D-AB49D658012E\\",\\n \\"Success\\": true\\n}","type":"json"}]', + ], + 'ModifyUserEniVswitchOptions' => [ + 'path' => '', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', - 'abilityTreeCode' => '204210', - 'abilityTreeNodes' => [ - 'FEATUREadsH8FO36', - ], + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREads3N2V5J'], ], 'parameters' => [ [ - 'name' => 'PageNumber', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '页数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'docRequired' => true, - 'maximum' => '10000', - 'minimum' => '1', - 'example' => '1', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~454314~~)接口查看指定集群的地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'PageSize', + 'name' => 'DbClusterId', 'in' => 'query', - 'schema' => [ - 'description' => '本页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'docRequired' => true, - 'maximum' => '1000', - 'minimum' => '1', - 'example' => '30', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'name' => 'VSwitchOptions', + 'in' => 'formData', + 'schema' => ['description' => '可选交换机列表。 交换机需要与ENI所属同一个VPC和可用区内，最多可填3个交换机，交换机之间用英文逗号（,）分隔。'."\n" + .'> * 所填写的交换机列表将覆盖已有ENI交换机列表。'."\n" + .'> * 您可以调用[DescribeDBClusterAttribute](~~612399~~)接口查看指定集群的ENI网络信息。', 'type' => 'string', 'required' => true, 'example' => 'vsw-rj9ixufmywqq98z******,vsw-rj95ij6wcz656v7******'."\n"], ], ], 'responses' => [ @@ -38982,310 +27889,203 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'string', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页大小。', - 'type' => 'string', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '返回的结果总数。', - 'type' => 'string', - 'example' => '100', - ], - 'Items' => [ - 'description' => '列表。', - 'type' => 'array', - 'items' => [ - 'description' => '-', - 'type' => 'object', - 'properties' => [ - 'DBClusterId' => [ - 'description' => 'AnalyticDB MySQL 湖仓版（3.0）集群 ID。', - 'type' => 'string', - 'example' => 'am-bp1********', - ], - 'DBClusterDescription' => [ - 'description' => '集群的描述信息。', - 'type' => 'string', - 'example' => 'adb_test', - ], - 'ZoneId' => [ - 'description' => '集群所在的可用区ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou-h', - ], - 'ComputeResource' => [ - 'description' => '计算预留资源规格。', - 'type' => 'string', - 'example' => '16ACU', - ], - 'StorageResource' => [ - 'description' => '存储预留资源规格。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '24ACU', - ], - 'ReservedACU' => [ - 'description' => '集群剩余可分配计算预留资源。', - 'type' => 'string', - 'example' => '24ACU', - ], - 'DBClusterStatus' => [ - 'description' => '集群状态。', - 'type' => 'string', - 'example' => 'Running', - ], - ], - ], - 'example' => '-', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => '0', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP状态码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Message' => ['description' => '调用结果的信息。取值说明：'."\n" + .'- 请求正常，返回**Success**。 '."\n" + .'- 请求异常，返回具体异常信息。', 'type' => 'string', 'example' => 'Success'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => '200'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：调用成功。'."\n" + .'- **false**：调用失败。', 'type' => 'boolean', 'example' => 'true'], ], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidInput', - 'errorMessage' => 'The specified parameter is invalid.', - ], + 'errorCodes' => [], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改用户ENI交换机列表', + 'summary' => '修改ENI交换机。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyUserEniVswitchOptions'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyUserEniVswitchOptions', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"PageSize\\": \\"30\\",\\n \\"TotalCount\\": \\"100\\",\\n \\"Items\\": [\\n {\\n \\"DBClusterId\\": \\"am-bp1********\\",\\n \\"DBClusterDescription\\": \\"adb_test\\",\\n \\"ZoneId\\": \\"cn-hangzhou-h\\",\\n \\"ComputeResource\\": \\"16ACU\\",\\n \\"StorageResource\\": 0,\\n \\"ReservedACU\\": \\"24ACU\\",\\n \\"DBClusterStatus\\": \\"Running\\"\\n }\\n ],\\n \\"Success\\": true,\\n \\"Code\\": \\"0\\",\\n \\"Message\\": \\"Success\\",\\n \\"HttpStatusCode\\": 200\\n}","type":"json"}]', - 'title' => '获取联邦分析支持的ADB实例列表', - 'description' => '根据性能参数查看某个集群、某时间段范围内的性能监控数据。采集粒度为30秒。支持对慢SQL进行查询，提供SQL查询时长、扫描行数、扫描量等监控内容。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"Success\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": true\\n}","type":"json"}]', ], - 'ModifyApsSlsADBJob' => [ - 'summary' => '修改sls投递adb数仓任务', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'PreloadSparkAppMetrics' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '209632', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - ], + 'operationType' => 'create', + 'abilityTreeCode' => '169119', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], ], 'parameters' => [ [ - 'name' => 'WorkloadId', + 'name' => 'AppId', 'in' => 'formData', - 'schema' => [ - 'description' => '数据链路任务ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'aps-******', - ], + 'schema' => ['title' => 'spark app的id', 'description' => 'Spark应用的ID。', 'type' => 'string', 'required' => true, 'example' => 's202204221525hzca7d8140000003', 'maxLength' => 64], ], [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-*******', - ], - ], - [ - 'name' => 'StartingOffsets', - 'in' => 'formData', - 'schema' => [ - 'description' => '起始位点。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'end_cursor', - ], + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看集群ID。', 'type' => 'string', 'required' => false, 'example' => 'amv-bp1mfe9qmsw1dzyg'], ], - [ - 'name' => 'Columns', - 'in' => 'formData', - 'style' => 'json', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '列信息。', - 'type' => 'array', - 'items' => [ - 'description' => '列信息。', - 'type' => 'object', - 'properties' => [ - 'Name' => [ - 'description' => '名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_name', - ], - 'MapName' => [ - 'description' => '映射名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'map_name', - ], - 'Type' => [ - 'description' => '列数据类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'bigint', - ], - 'MapType' => [ - 'description' => '映射类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'bigint', + 'description' => '结构体', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '84489769-3065-5A28-A4CB-977CD426F1C3'], + 'Data' => [ + 'description' => '返回数据。', + 'type' => 'object', + 'properties' => [ + 'AppId' => ['description' => '应用ID。', 'type' => 'string', 'example' => 's202212181815shaccb8be0000253'], + 'AttemptId' => ['description' => 'Spark应用的重试ID。', 'type' => 'string', 'example' => 's202301061000hz57d797b0000201-0001'], + 'Finished' => ['description' => '解析是否结束：'."\n" + .'- true：表示已结束。'."\n" + .'- false：表示未结束。', 'type' => 'boolean', 'example' => 'True'], + 'EventLogPath' => ['description' => 'Event日志路径。', 'type' => 'string', 'example' => 'oss://path/to/eventLog'], + 'ScanMetrics' => [ + 'description' => '指标数据。', + 'type' => 'object', + 'properties' => [ + 'OutputRowsCount' => ['description' => '扫描行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'], + 'TotalReadFileSizeInByte' => ['description' => '扫描字节大小。', 'type' => 'integer', 'format' => 'int64', 'example' => '10000'], + ], + ], ], ], - 'required' => false, - 'example' => '-', ], - 'required' => false, - 'example' => '-', ], ], - [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '只允许分析处于终止状态的 Spark app。指定 app 不满足条件。'], + ['errorCode' => 'Spark.AnalyzeTask.FailedToKill', 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', 'description' => '杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。'], + ['errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.KillOperationFailed', 'errorMessage' => 'Failed to kill the application %s, please retry in a few seconds.', 'description' => '杀死 Spark 应用失败，请稍后重试。'], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Log.InvalidState', 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'description' => '无法获取指定Spark作业的日志。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', 'description' => 'Spark作业信息中的SQL无法解析。'], + ['errorCode' => 'Spark.TemplateFile.BadFileType', 'errorMessage' => 'The requested template %s is not a file.', 'description' => '请求的模板文件ID不是文件类型的。'], ], - [ - 'name' => 'WorkloadName', - 'in' => 'formData', - 'schema' => [ - 'description' => '工作负载名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test-name', - ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], ], [ - 'name' => 'DbName', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'required' => false, - 'example' => 'dbName', - ], + ['errorCode' => 'Spark.AnalyzeTask.NotFound', 'errorMessage' => 'The requested analysis task %s is not found.', 'description' => '请求查看的日志分析任务 %s 不存在。'], + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], + ['errorCode' => 'Spark.TemplateFile.TemplateNotFound', 'errorMessage' => 'The template %s is not found.', 'description' => '模板文件未找到。'], ], - [ - 'name' => 'TableName', - 'in' => 'formData', - 'schema' => [ - 'description' => '表名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 406 => [ + ['errorCode' => 'Spark.App.KillNotAcceptable', 'errorMessage' => 'Can\'t kill the application %s in %s state.', 'description' => '不能删除处于不可删除状态下的 Spark 应用。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], + ], + 'title' => '预加载Spark App指标数据', + 'summary' => '预加载Spark App 指标数据。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-11-24T09:19:25.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-06-28T01:10:28.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'PreloadSparkAppMetrics'], + ], + ], + 'ramActions' => [ [ - 'name' => 'DirtyDataProcessPattern', - 'in' => 'formData', - 'schema' => [ - 'description' => '脏数据处理模式。', - 'type' => 'string', - 'required' => false, - 'example' => 'STOP', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:PreloadSparkAppMetrics', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'SparkApplication', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"84489769-3065-5A28-A4CB-977CD426F1C3\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202212181815shaccb8be0000253\\",\\n \\"AttemptId\\": \\"s202301061000hz57d797b0000201-0001\\",\\n \\"Finished\\": true,\\n \\"EventLogPath\\": \\"oss://path/to/eventLog\\",\\n \\"ScanMetrics\\": {\\n \\"OutputRowsCount\\": 1000,\\n \\"TotalReadFileSizeInByte\\": 10000\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"<PreloadSparkAppMetricsResponse>\\n <RequestId>84489769-3065-5A28-A4CB-977CD426F1C3</RequestId>\\n <Data>\\n <AppId>s202212181815shaccb8be0000253</AppId>\\n <AttemptId>s202301061000hz57d797b0000201-0001</AttemptId>\\n <Finished>true</Finished>\\n <EventLogPath>oss://path/to/eventLog</EventLogPath>\\n <ScanMetrics>\\n <OutputRowsCount>1000</OutputRowsCount>\\n <TotalReadFileSizeInByte>10000</TotalReadFileSizeInByte>\\n </ScanMetrics>\\n </Data>\\n</PreloadSparkAppMetricsResponse>","errorExample":""}]', + ], + 'QueryFormationInstsByTaskID' => [ + 'summary' => '查询元数据发现任务实例列表', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'ExactlyOnce', - 'in' => 'formData', - 'schema' => [ - 'description' => '是否开启精确一致。', - 'type' => 'string', - 'required' => false, - 'example' => 'true', - ], + 'AK' => [], ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'abilityTreeCode' => '138511', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], + ], + 'parameters' => [ [ - 'name' => 'UnixTimestampConvert', + 'name' => 'RegionId', 'in' => 'formData', - 'schema' => [ - 'description' => '时间戳转换。', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], + 'schema' => ['description' => '地域id，您可通过[describeregions](~~143074~~)查看可用的地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'UserName', + 'name' => 'TaskId', 'in' => 'formData', - 'schema' => [ - 'description' => '用户名。', - 'type' => 'string', - 'required' => false, - 'example' => 'user-name', - ], + 'schema' => ['description' => '任务id。', 'type' => 'string', 'required' => true, 'example' => '123'], ], [ - 'name' => 'Password', + 'name' => 'DBClusterId', 'in' => 'formData', - 'schema' => [ - 'description' => '密码。', - 'type' => 'string', - 'required' => false, - 'example' => 'test_123', - ], + 'schema' => ['description' => '实例id。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1r053byu48p****'], ], ], 'responses' => [ @@ -39293,474 +28093,314 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], + 'HttpStatusCode' => ['description' => 'http状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：调用成功。'."\n" - .'- **false**：调用失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => 'InvalidInput', - ], - 'Message' => [ - 'description' => '应用建议执行结果。取值说明：'."\n" - .'- 请求正常，返回**SUCCESS**。 '."\n" - .'- 请求异常，返回具体异常错误信息。', - 'type' => 'string', - 'example' => 'SUCCESS', + 'description' => '返回任务列表。', + 'type' => 'array', + 'items' => [ + 'description' => '已废弃。详细信息在Items。', + 'type' => 'object', + 'properties' => [ + 'LastTaskInstID' => ['description' => '最近一次任务的实例id。', 'type' => 'string', 'example' => '1223'], + 'Schema' => ['description' => '系统为实例分配的schemaid。', 'type' => 'string', 'example' => 'default'], + 'CreateTime' => ['description' => '任务的创建时间。', 'type' => 'string', 'example' => '2023-05-15T07:24:58Z'], + 'TaskName' => ['description' => '任务名称。', 'type' => 'string', 'example' => 'doc_test_daily'], + 'SourceType' => ['description' => '任务来源，取值如下：-**system**：系统。-**custom**：自定义。', 'type' => 'string', 'example' => 'shareScreen'], + 'LastTaskInstState' => ['description' => '最近一次任务实例状态。', 'type' => 'string', 'example' => 'FINISH'], + 'TaskType' => ['description' => '任务类型。', 'type' => 'string', 'example' => 'Update\\"\''], + 'SyncTime' => ['description' => '同步时间，精确到毫秒，格式：yyyy-mm-ddthh:mm:ssz。', 'type' => 'string', 'example' => '2026-01-20t10:01:01z'], + 'LastTaskInstMessage' => ['description' => '最近一次任务的错误信息。', 'type' => 'string', 'example' => 'error'], + 'LastTaskInstCostTime' => ['description' => '最近一次任务的执行时间。', 'type' => 'string', 'example' => '8'], + 'TaskId' => ['description' => '任务id。', 'type' => 'string', 'example' => '10'], + 'ScheduleState' => ['description' => '任务状态。', 'type' => 'string', 'example' => 'NORMAL'], + ], + ], ], - ], - ], - ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n },\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Message\\": \\"SUCCESS\\"\\n}","type":"json"}]', - 'title' => '修改sls投递adb数仓任务', - ], - 'DescribeApsMigrationWorkloads' => [ - 'summary' => '查询APS迁移任务工作负载列表。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'RequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Success' => ['description' => '是否成功。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '状态码，200表示成功。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '提示信息，成功时为 OK', 'type' => 'string', 'example' => 'OK'], + 'PageNumber' => ['description' => '页码。', 'type' => 'string', 'example' => '1'], + 'PageSize' => ['description' => '总页数。', 'type' => 'string', 'example' => '30'], + 'TotalCount' => ['description' => '总记录数。', 'type' => 'string', 'example' => '1'], + 'Items' => [ + 'description' => '任务列表。', + 'type' => 'array', + 'items' => ['description' => '任务列表。', 'type' => 'object', 'example' => '{'."\n" + .' "gmtModified":"2026-07-08T12:00:43.000+00:00",'."\n" + .' "gmtCreated":"2026-07-08T12:00:33.000+00:00",'."\n" + .' "type":"CRAWLER",'."\n" + .' "message":"{\\"summary\\":\\"Table created:1; Table updated:0; add partition num:0; invalid dir num:0; source list warned:0; can not infer file:0; generate ddl failed:0; syncMeta failed:0.\\",\\"reportDetail\\":[]}",'."\n" + .' "content":"{\\"scheduleState\\":\\"STOP\\",\\"stat\\":{\\"actualStartTime\\":\\"2026-07-08 20:00:40\\",\\"stage\\":\\"SUCCESS\\",\\"isKilled\\":false,\\"timeCost\\":2},\\"configuration\\":{\\"adb.crawler.csv.columns.specify.delimiter.char\\":\\"auto\\",\\"adb.crawler.csv.columns.specify.quote.char\\":\\"auto\\"},\\"gmtCreated\\":1783501525000,\\"dbName\\":\\"sales_db\\",\\"schemaChangePolicy\\":{\\"deleteRule\\":\\"IGNORE\\",\\"updateRule\\":\\"ONLY_ADD_COLUMN\\"},\\"frequency\\":{\\"cron\\":\\"\\",\\"type\\":\\"run_on_demand\\"},\\"uid\\":\\"***\\",\\"sourceInfo\\":{\\"ossSourceInfo\\":{\\"sourceMode\\":\\"WAREHOUSE\\",\\"ossLocations\\":[\\"oss://crawler-test/***/***/\\"],\\"exclusions\\":[],\\"inclusions\\":[]}},\\"failedCount\\":0,\\"dbClusterId\\":\\"amv-bp***\\",\\"sourceType\\":\\"OSSWAREHOUSE\\",\\"classifiers\\":[\\"csv\\"],\\"taskName\\":\\"[\\\\\\"oss://crawler-test/***/***/\\\\\\"] -> sales_db\\",\\"id\\":36}",'."\n" + .' "parentId":-1,'."\n" + .' "retryTimes":0,'."\n" + .' "uid":"***",'."\n" + .' "dbClusterId":"amv-bp***",'."\n" + .' "sourceType":"OSSWAREHOUSE",'."\n" + .' "name":"[\\"oss://crawler-test/***/***/\\"] -> sales_db",'."\n" + .' "timeCostInSeconds":2,'."\n" + .' "startTime":"2026-07-08T12:00:33.000+00:00",'."\n" + .' "id":46872,'."\n" + .' "state":"SUCCESS",'."\n" + .' "operatorUid":"***",'."\n" + .' "taskId":36'."\n" + .'}'], + ], + ], + 'description' => '', + ], + ], + ], + 'title' => '查询元数据发现任务实例列表', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": [\\n {\\n \\"LastTaskInstID\\": \\"1223\\",\\n \\"Schema\\": \\"default\\",\\n \\"CreateTime\\": \\"2023-05-15T07:24:58Z\\",\\n \\"TaskName\\": \\"doc_test_daily\\",\\n \\"SourceType\\": \\"shareScreen\\",\\n \\"LastTaskInstState\\": \\"FINISH\\",\\n \\"TaskType\\": \\"Update\\\\\\\\\\\\\\"\'\\",\\n \\"SyncTime\\": \\"2026-01-20t10:01:01z\\",\\n \\"LastTaskInstMessage\\": \\"error\\",\\n \\"LastTaskInstCostTime\\": \\"8\\",\\n \\"TaskId\\": \\"10\\",\\n \\"ScheduleState\\": \\"NORMAL\\"\\n }\\n ],\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"PageSize\\": \\"30\\",\\n \\"TotalCount\\": \\"1\\",\\n \\"Items\\": [\\n {\\n \\"gmtModified\\": \\"2026-07-08T12:00:43.000+00:00\\",\\n \\"gmtCreated\\": \\"2026-07-08T12:00:33.000+00:00\\",\\n \\"type\\": \\"CRAWLER\\",\\n \\"message\\": \\"{\\\\\\"summary\\\\\\":\\\\\\"Table created:1; Table updated:0; add partition num:0; invalid dir num:0; source list warned:0; can not infer file:0; generate ddl failed:0; syncMeta failed:0.\\\\\\",\\\\\\"reportDetail\\\\\\":[]}\\",\\n \\"content\\": \\"{\\\\\\"scheduleState\\\\\\":\\\\\\"STOP\\\\\\",\\\\\\"stat\\\\\\":{\\\\\\"actualStartTime\\\\\\":\\\\\\"2026-07-08 20:00:40\\\\\\",\\\\\\"stage\\\\\\":\\\\\\"SUCCESS\\\\\\",\\\\\\"isKilled\\\\\\":false,\\\\\\"timeCost\\\\\\":2},\\\\\\"configuration\\\\\\":{\\\\\\"adb.crawler.csv.columns.specify.delimiter.char\\\\\\":\\\\\\"auto\\\\\\",\\\\\\"adb.crawler.csv.columns.specify.quote.char\\\\\\":\\\\\\"auto\\\\\\"},\\\\\\"gmtCreated\\\\\\":1783501525000,\\\\\\"dbName\\\\\\":\\\\\\"sales_db\\\\\\",\\\\\\"schemaChangePolicy\\\\\\":{\\\\\\"deleteRule\\\\\\":\\\\\\"IGNORE\\\\\\",\\\\\\"updateRule\\\\\\":\\\\\\"ONLY_ADD_COLUMN\\\\\\"},\\\\\\"frequency\\\\\\":{\\\\\\"cron\\\\\\":\\\\\\"\\\\\\",\\\\\\"type\\\\\\":\\\\\\"run_on_demand\\\\\\"},\\\\\\"uid\\\\\\":\\\\\\"***\\\\\\",\\\\\\"sourceInfo\\\\\\":{\\\\\\"ossSourceInfo\\\\\\":{\\\\\\"sourceMode\\\\\\":\\\\\\"WAREHOUSE\\\\\\",\\\\\\"ossLocations\\\\\\":[\\\\\\"oss://crawler-test/***/***/\\\\\\"],\\\\\\"exclusions\\\\\\":[],\\\\\\"inclusions\\\\\\":[]}},\\\\\\"failedCount\\\\\\":0,\\\\\\"dbClusterId\\\\\\":\\\\\\"amv-bp***\\\\\\",\\\\\\"sourceType\\\\\\":\\\\\\"OSSWAREHOUSE\\\\\\",\\\\\\"classifiers\\\\\\":[\\\\\\"csv\\\\\\"],\\\\\\"taskName\\\\\\":\\\\\\"[\\\\\\\\\\\\\\"oss://crawler-test/***/***/\\\\\\\\\\\\\\"] -> sales_db\\\\\\",\\\\\\"id\\\\\\":36}\\",\\n \\"parentId\\": -1,\\n \\"retryTimes\\": 0,\\n \\"uid\\": \\"***\\",\\n \\"dbClusterId\\": \\"amv-bp***\\",\\n \\"sourceType\\": \\"OSSWAREHOUSE\\",\\n \\"name\\": \\"[\\\\\\"oss://crawler-test/***/***/\\\\\\"] -> sales_db\\",\\n \\"timeCostInSeconds\\": 2,\\n \\"startTime\\": \\"2026-07-08T12:00:33.000+00:00\\",\\n \\"id\\": 46872,\\n \\"state\\": \\"SUCCESS\\",\\n \\"operatorUid\\": \\"***\\",\\n \\"taskId\\": 36\\n }\\n ]\\n}","type":"json"}]', + ], + 'QueryFormationTaskByID' => [ + 'summary' => '根据 ID 查询元数据发现任务ByID', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', + 'abilityTreeCode' => '138855', + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsY28JLD'], ], 'parameters' => [ [ - 'name' => 'PageNumber', + 'name' => 'RegionId', 'in' => 'formData', - 'schema' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'docRequired' => true, - 'maximum' => '10000', - 'minimum' => '1', - 'example' => '1', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'PageSize', + 'name' => 'TaskType', 'in' => 'formData', - 'schema' => [ - 'description' => '每页大小。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'docRequired' => true, - 'maximum' => '1000', - 'minimum' => '1', - 'example' => '30', - ], + 'schema' => ['description' => '任务类型。', 'type' => 'string', 'required' => true, 'example' => '["CRAWLER"]'], ], [ - 'name' => 'DBClusterId', + 'name' => 'TaskId', 'in' => 'formData', - 'schema' => [ - 'description' => '实例ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-*******', - ], + 'schema' => ['description' => '任务id。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '36'], ], [ - 'name' => 'WorkloadName', + 'name' => 'DBClusterId', 'in' => 'formData', + 'schema' => ['description' => '实例id。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1ub9grke1****'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '工作负载名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', + 'type' => 'object', + 'properties' => [ + 'HttpStatusCode' => ['description' => 'http状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '任务详情。', 'type' => 'string', 'example' => '{'."\n" + .' "id": 123,'."\n" + .' "taskName": "sale_db",'."\n" + .' "scheduleState": "NORMAL",'."\n" + .' "frequency": {"type": "custom", "cron": "0 0/1 * * * ?"},'."\n" + .' "failedCount": 0,'."\n" + .' "lastTaskInstContent": "{\\"task_inst_id\\":67890,\\"state\\":\\"SUCCESS\\"}"'."\n" + .' }'], + 'RequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => '5DC10091-348D-12B1-906D-AB49D658012E'], + 'Success' => ['description' => '是否成功。-true：成功。-false：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '状态码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '错误信息。', 'type' => 'string', 'example' => 'OK'], + ], + 'description' => '', ], ], + ], + 'title' => '根据 ID 查询元数据发现任务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": \\"{\\\\n \\\\\\"id\\\\\\": 123,\\\\n \\\\\\"taskName\\\\\\": \\\\\\"sale_db\\\\\\",\\\\n \\\\\\"scheduleState\\\\\\": \\\\\\"NORMAL\\\\\\",\\\\n \\\\\\"frequency\\\\\\": {\\\\\\"type\\\\\\": \\\\\\"custom\\\\\\", \\\\\\"cron\\\\\\": \\\\\\"0 0/1 * * * ?\\\\\\"},\\\\n \\\\\\"failedCount\\\\\\": 0,\\\\n \\\\\\"lastTaskInstContent\\\\\\": \\\\\\"{\\\\\\\\\\\\\\"task_inst_id\\\\\\\\\\\\\\":67890,\\\\\\\\\\\\\\"state\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"SUCCESS\\\\\\\\\\\\\\"}\\\\\\"\\\\n }\\",\\n \\"RequestId\\": \\"5DC10091-348D-12B1-906D-AB49D658012E\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', + ], + 'QueryFormationTasksByType' => [ + 'summary' => '根据任务类型查询元数据发现任务', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'list', + 'abilityTreeCode' => '138509', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], + ], + 'parameters' => [ [ - 'name' => 'OssLocation', + 'name' => 'RegionId', 'in' => 'formData', - 'schema' => [ - 'description' => 'oss地址。', - 'type' => 'string', - 'required' => false, - 'example' => 'oss://******', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'StartTime', + 'name' => 'TaskType', 'in' => 'formData', - 'schema' => [ - 'description' => '查询开始时间。', - 'type' => 'string', - 'required' => false, - 'example' => '2021-06-20T16:00:00Z', - ], + 'schema' => ['description' => '任务类型。', 'type' => 'string', 'required' => true, 'example' => '["CRAWLER"]'], ], [ - 'name' => 'EndTime', + 'name' => 'DBClusterId', 'in' => 'formData', - 'schema' => [ - 'description' => '查询结束时间。', - 'type' => 'string', - 'required' => false, - 'example' => '2021-07-20T16:00:00Z', - ], + 'schema' => ['description' => '集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-uf6g8w25jacm7****'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-57F0-9F06-******', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '本页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '0', - ], - 'MigrationWorkloads' => [ - 'description' => '迁移工作负载列表。', + 'HttpStatusCode' => ['description' => 'http状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => [ + 'description' => '任务列表。', 'type' => 'array', 'items' => [ + 'description' => '返回数据。', 'type' => 'object', 'properties' => [ - 'ModifyTime' => [ - 'description' => '任务修改的时间。', - 'type' => 'string', - 'example' => '2021-06-21T02:15:16Z', - ], - 'CreateTime' => [ - 'description' => '任务创建时间。', - 'type' => 'string', - 'example' => '2021-06-21T02:15:16Z', - ], - 'Id' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => '123', - ], - 'State' => [ - 'description' => '状态。', - 'type' => 'string', - 'example' => 'COMPLETED', - ], - 'OssLocation' => [ - 'description' => 'oss地址。', - 'type' => 'string', - 'example' => 'oss://******', - ], - 'TargetType' => [ - 'description' => '目标类型。', - 'type' => 'string', - 'example' => 'OSS', - ], - 'WorkloadSubType' => [ - 'description' => '子任务类型。', - 'type' => 'string', - 'example' => 'test', - ], - 'Name' => [ - 'description' => '名称。', - 'type' => 'string', - 'example' => 'TEST-001', - ], - 'AcuCount' => [ - 'description' => 'acu数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '-', - ], - 'MaxRT' => [ - 'description' => '最大响应时间。', - 'type' => 'string', - 'example' => '1000', - ], - 'FailedMsg' => [ - 'description' => '错误消息。', - 'type' => 'string', - 'example' => '-', - ], + 'LastTaskInstID' => ['description' => '最近一次任务的实例id。', 'type' => 'string', 'example' => '46872'], + 'Schema' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'sales_db'], + 'CreateTime' => ['description' => '创建时间', 'type' => 'string', 'example' => '2026-07-08 17:05:25'], + 'TaskName' => ['description' => '任务名称。', 'type' => 'string', 'example' => '[\\"oss://test-bucket/**/**/\\"] -> sales_db'], + 'SourceType' => ['description' => '源类型', 'type' => 'string', 'example' => 'OSSWAREHOUSE'], + 'LastTaskInstState' => ['description' => '最近一次任务实例状态。', 'type' => 'string', 'example' => 'SUCCESS'], + 'TaskType' => ['description' => '任务类型。', 'type' => 'string', 'example' => 'CRAWLER'], + 'SyncTime' => ['description' => '调度频率', 'type' => 'string', 'example' => '{\\"cron\\":\\"\\",\\"type\\":\\"run_on_demand\\"}'], + 'LastTaskInstMessage' => ['description' => '最近一次任务的错误信息。', 'type' => 'string', 'example' => 'xxx'], + 'LastTaskInstCostTime' => ['description' => '最近一次任务的执行时间。', 'type' => 'string', 'example' => '2'], + 'TaskId' => ['description' => '任务ID。', 'type' => 'string', 'example' => '10'], + 'ScheduleState' => ['description' => '调度状态。', 'type' => 'string', 'example' => 'STOP'], ], ], ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：调用成功。'."\n" + .'- **false**：调用失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '状态码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '提示信息，成功时为 OK。', 'type' => 'string', 'example' => 'OK'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidInput', - 'errorMessage' => 'The specified parameter is invalid.', - ], - ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '根据任务类型查询元数据发现任务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-3EEC-57F0-9F06-******\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalCount\\": 0,\\n \\"MigrationWorkloads\\": [\\n {\\n \\"ModifyTime\\": \\"2021-06-21T02:15:16Z\\",\\n \\"CreateTime\\": \\"2021-06-21T02:15:16Z\\",\\n \\"Id\\": \\"123\\",\\n \\"State\\": \\"COMPLETED\\",\\n \\"OssLocation\\": \\"oss://******\\",\\n \\"TargetType\\": \\"OSS\\",\\n \\"WorkloadSubType\\": \\"test\\",\\n \\"Name\\": \\"TEST-001\\",\\n \\"AcuCount\\": 0,\\n \\"MaxRT\\": \\"1000\\",\\n \\"FailedMsg\\": \\"-\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '查询APS迁移任务工作负载列表', + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": [\\n {\\n \\"LastTaskInstID\\": \\"46872\\",\\n \\"Schema\\": \\"sales_db\\",\\n \\"CreateTime\\": \\"2026-07-08 17:05:25\\",\\n \\"TaskName\\": \\"[\\\\\\\\\\\\\\"oss://test-bucket/**/**/\\\\\\\\\\\\\\"] -> sales_db\\",\\n \\"SourceType\\": \\"OSSWAREHOUSE\\",\\n \\"LastTaskInstState\\": \\"SUCCESS\\",\\n \\"TaskType\\": \\"CRAWLER\\",\\n \\"SyncTime\\": \\"{\\\\\\\\\\\\\\"cron\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"type\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"run_on_demand\\\\\\\\\\\\\\"}\\",\\n \\"LastTaskInstMessage\\": \\"xxx\\",\\n \\"LastTaskInstCostTime\\": \\"2\\",\\n \\"TaskId\\": \\"10\\",\\n \\"ScheduleState\\": \\"STOP\\"\\n }\\n ],\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', ], - 'DescribeApsHiveWorkload' => [ - 'summary' => '查询APS Hive工作负载详情。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'ReleaseClusterPublicConnection' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', - 'abilityTreeCode' => '170284', - 'abilityTreeNodes' => [ - 'FEATUREadsBIVU9O', - ], + 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '131192', + 'abilityTreeNodes' => ['FEATUREads4DZDZG'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-*******', - ], + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'WorkloadId', - 'in' => 'formData', + 'name' => 'Engine', + 'in' => 'query', 'schema' => [ - 'description' => '数据链路任务ID。', + 'description' => '数据库引擎，取值：'."\n" + ."\n" + .'- **AnalyticDB**（默认）：AnalyticDB for MySQL引擎。'."\n" + .'- **Clickhouse**：宽表引擎。', 'type' => 'string', - 'required' => true, - 'example' => 'aps-******', + 'required' => false, + 'enumValueTitles' => ['AnalyticDB' => 'AnalyticDB', 'Clickhouse' => 'Clickhouse'], + 'example' => 'Clickhouse', ], ], [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'name' => 'ResourceGroupName', + 'in' => 'query', + 'schema' => ['type' => 'string'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '86F92D26-B774-5FA1-8E53-******', - ], - 'ApsWorkload' => [ - 'description' => '任务信息。', - 'type' => 'object', - 'properties' => [ - 'RegionId' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-*******', - ], - 'WorkloadId' => [ - 'description' => '数据链路任务ID。', - 'type' => 'string', - 'example' => 'aps-******', - ], - 'WorkloadName' => [ - 'description' => '工作负载名。', - 'type' => 'string', - 'example' => 'test', - ], - 'ResourceGroup' => [ - 'description' => 'SQL语句所属的资源池。', - 'type' => 'string', - 'example' => 'test', - ], - 'FullComputeUnit' => [ - 'description' => '迁移所需acu数。', - 'type' => 'string', - 'example' => '16', - ], - 'SyncAllowExpression' => [ - 'description' => '手动匹配源端库表白名单表达式。', - 'type' => 'string', - 'example' => 'abc', - ], - 'SyncDenyExpression' => [ - 'description' => '手动匹配源端库表黑名单表达式。', - 'type' => 'string', - 'example' => 'def', - ], - 'TargetType' => [ - 'description' => '目标类型。', - 'type' => 'string', - 'example' => 'OSS', - ], - 'OssLocation' => [ - 'description' => 'oss地址。', - 'type' => 'string', - 'example' => 'oss://******', - ], - 'ConflictStrategy' => [ - 'description' => '目的端存在同名库表处理策略。', - 'type' => 'string', - 'example' => 'Intercept', - ], - 'AdvancedConfig' => [ - 'description' => '高级配置。', - 'type' => 'string', - 'example' => 'test.adv.config=value', - ], - 'DatasourceId' => [ - 'description' => '数据源ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '8', - ], - 'DatasourceName' => [ - 'description' => '数据源名称。', - 'type' => 'string', - 'example' => 'sls-******', - ], - 'Parallelism' => [ - 'description' => '并行度。'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2', - ], - 'WorkloadTypeName' => [ - 'description' => '工作负载名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'State' => [ - 'description' => '状态。', - 'type' => 'string', - 'example' => 'COMPLETED', - ], - 'CreateTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '-', - ], - 'MetaStoreUri' => [ - 'description' => 'hive meta store url。', - 'type' => 'string', - 'example' => '-', - ], - 'Vswitch' => [ - 'description' => '交换机（vSwitch）名称。', - 'type' => 'string', - 'example' => 'vsw-******', - ], - 'EmrClusterId' => [ - 'description' => 'EMR集群ID。', - 'type' => 'string', - 'example' => '-', - ], - ], - 'example' => '-', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A94B6C02-7BD4-5D67-9776-3AC8317E8DD5'], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidInput', - 'errorMessage' => 'The specified parameter is invalid.', - ], + 404 => [ + ['errorCode' => 'InvalidDBCluster.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '释放公网地址', + 'summary' => '释放指定集群的公网连接地址。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-06-13T13:53:51.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-06-11T16:51:57.000Z', 'description' => 'OpenAPI 下线'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"86F92D26-B774-5FA1-8E53-******\\",\\n \\"ApsWorkload\\": {\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"DBClusterId\\": \\"amv-*******\\",\\n \\"WorkloadId\\": \\"aps-******\\",\\n \\"WorkloadName\\": \\"test\\",\\n \\"ResourceGroup\\": \\"test\\",\\n \\"FullComputeUnit\\": \\"16\\",\\n \\"SyncAllowExpression\\": \\"abc\\",\\n \\"SyncDenyExpression\\": \\"def\\",\\n \\"TargetType\\": \\"OSS\\",\\n \\"OssLocation\\": \\"oss://******\\",\\n \\"ConflictStrategy\\": \\"Intercept\\",\\n \\"AdvancedConfig\\": \\"test.adv.config=value\\",\\n \\"DatasourceId\\": 8,\\n \\"DatasourceName\\": \\"sls-******\\",\\n \\"Parallelism\\": 2,\\n \\"WorkloadTypeName\\": \\"test\\",\\n \\"State\\": \\"COMPLETED\\",\\n \\"CreateTime\\": \\"-\\",\\n \\"MetaStoreUri\\": \\"-\\",\\n \\"Vswitch\\": \\"vsw-******\\",\\n \\"EmrClusterId\\": \\"-\\"\\n }\\n}","type":"json"}]', - 'title' => '查询APS Hive工作负载详情', - ], - 'CreateApsCopyWorkload' => [ - 'summary' => '创建APS复制链路。', - 'methods' => [ - 'get', - 'post', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ReleaseClusterPublicConnection'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:ReleaseClusterPublicConnection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A94B6C02-7BD4-5D67-9776-3AC8317E8DD5\\"\\n}","errorExample":""},{"type":"xml","example":"<ReleaseClusterPublicConnectionResponse>\\n <RequestId>A94B6C02-7BD4-5D67-9776-3AC8317E8DD5</RequestId>\\n</ReleaseClusterPublicConnectionResponse>","errorExample":""}]', + ], + 'RenameSemanticView' => [ + 'summary' => '修改语义视图名', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -39769,194 +28409,120 @@ 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', - 'abilityTreeCode' => '186455', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsY28JLD', - ], + 'operationType' => 'update', + 'riskType' => 'high', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREadsTYGUV3'], ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], - ], - [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '实例ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'am-bp1xxxxxxxx47', - ], - ], - [ - 'name' => 'WorkloadType', - 'in' => 'formData', - 'schema' => [ - 'description' => '任务类型。', - 'type' => 'string', - 'required' => true, - 'example' => 'SLS_INGESTION_ADB', - ], + 'in' => 'query', + 'schema' => ['title' => '集群ID。', 'description' => 'ADB集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1u8c0mgfg58****'], ], [ - 'name' => 'DatasourceId', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据源ID。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '123', - ], + 'name' => 'NewSchemaName', + 'in' => 'query', + 'schema' => ['title' => '语义视图所在的新 schema 名', 'description' => '语义视图所在的新 Schema 名', 'type' => 'string', 'required' => true, 'example' => 'adb_sv'], ], [ - 'name' => 'DbName', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名。', - 'type' => 'string', - 'required' => false, - 'example' => 'dbName', - ], + 'name' => 'NewViewName', + 'in' => 'query', + 'schema' => ['title' => '语义视图新名称', 'description' => '语义视图新名称', 'type' => 'string', 'required' => true, 'example' => 'new_sv_name'], ], [ - 'name' => 'TableName', - 'in' => 'formData', - 'schema' => [ - 'description' => '表名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'name' => 'OldSchemaName', + 'in' => 'query', + 'schema' => ['title' => '语义视图原来所在的 schema 名称', 'description' => '语义视图原来所在的 Schema 名称', 'type' => 'string', 'required' => true, 'example' => 'adb_sv_old'], ], [ - 'name' => 'WorkloadId', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据链路任务ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'aps-******', - ], + 'name' => 'OldViewName', + 'in' => 'query', + 'schema' => ['title' => '语义视图原来的名称', 'description' => '语义视图原来的名称', 'type' => 'string', 'required' => true, 'example' => 'old_sv_name'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'HttpStatusCode' => [ - 'description' => 'HTTP状态码。'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：调用成功。'."\n" - .'- **false**：调用失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => 'InvalidInput', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回Success。'."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'Data' => [ - 'description' => '删除的应用信息。', - 'type' => 'object', - 'example' => '-', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Message\\": \\"Success\\",\\n \\"Data\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n}","type":"json"}]', - 'title' => '创建APS复制链路', - ], - 'DescribeApsDatasource' => [ - 'summary' => '查询过APS数据源详情。', - 'methods' => [ - 'post', - 'get', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'MDS.CatalogAlreadyExist', 'errorMessage' => 'The catalog already exists.', 'description' => '目录已经存在'], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ['errorCode' => 'MDS.SemanticViewAlreadyExist', 'errorMessage' => 'The semantic view already exists.', 'description' => '此语义视图已经存在'], + ['errorCode' => 'MDS.SemanticViewNotExist', 'errorMessage' => 'This semantic view does not exist.', 'description' => '此语义视图不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + [ + ['errorCode' => 'MDS.InstanceNotExist', 'errorMessage' => 'ADB instance does not exist.', 'description' => 'ADB 实例不存在'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改语义视图名', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', + ], + 'ReplaceSemanticView' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', + 'operationType' => 'update', + 'riskType' => 'high', 'chargeType' => 'free', - 'abilityTreeCode' => '168878', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsY28JLD', - ], + 'abilityTreeNodes' => ['FEATUREadsTYGUV3'], ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-beijing', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['title' => '集群ID。'."\n" + .'> 调用[DescribeDBClusters](~~454250~~)接口可以查看集群ID。', 'description' => 'ADB集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1u8c0mgfg58****'], ], [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => 'ADB实例ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'am-*******', - ], + 'name' => 'SchemaName', + 'in' => 'query', + 'schema' => ['title' => 'schema名称。'."\n" + .' '."\n", 'description' => 'Schema名称。', 'type' => 'string', 'required' => true, 'example' => 'adb_demo'], ], [ - 'name' => 'DatasourceId', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据源ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1', - ], + 'name' => 'ViewName', + 'in' => 'query', + 'schema' => ['title' => '语义视图名称。', 'description' => '语义视图名称。', 'type' => 'string', 'required' => true, 'example' => 'sales_sv'], + ], + [ + 'name' => 'Definition', + 'in' => 'query', + 'schema' => ['title' => '语义视图定义信息', 'description' => '语义视图定义信息', 'type' => 'string', 'required' => true, 'example' => 'YAML 内容'], ], ], 'responses' => [ @@ -39966,251 +28532,46 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-**D8-5***-A***-****587', - ], - 'ApsDatasource' => [ - 'description' => '-', - 'type' => 'object', - 'properties' => [ - 'DatasourceName' => [ - 'description' => '数据源的名称。', - 'type' => 'string', - 'example' => 'kafka-2024***', - ], - 'CreateTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2024-04-12T15:03:38Z', - ], - 'DatasourceType' => [ - 'description' => '数据源类型。', - 'type' => 'string', - 'example' => 'KAFKA', - ], - 'DatasourceDescription' => [ - 'description' => '数据源描述。', - 'type' => 'string', - 'example' => 'test', - ], - 'SlsInfo' => [ - 'description' => '日志服务（SLS）项目。', - 'type' => 'object', - 'properties' => [ - 'SourceRegionId' => [ - 'description' => '生产站点所属的地域ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'Project' => [ - 'description' => 'sls项目名称。', - 'type' => 'string', - 'example' => '***', - ], - 'Store' => [ - 'description' => 'sls logstore名称。', - 'type' => 'string', - 'example' => '***', - ], - 'Across' => [ - 'description' => '是否跨账号。取值：'."\n" - ."\n" - .'- **true** ：当前网络实例为跨账号资源。'."\n" - .'- **false** ：当前网络实例为本账号资源。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'AcrossUid' => [ - 'description' => '跨账号UID。', - 'type' => 'string', - 'example' => '123456', - ], - 'AcrossRole' => [ - 'description' => '跨账号角色名。', - 'type' => 'string', - 'example' => 'test', - ], - ], - 'example' => '-', - ], - 'KafkaInfo' => [ - 'description' => 'kafka实例信息。', - 'type' => 'object', - 'properties' => [ - 'KafkaClusterId' => [ - 'description' => 'kafka实例ID。', - 'type' => 'string', - 'example' => '-', - ], - 'KafkaTopic' => [ - 'description' => 'kafka topic', - 'type' => 'string', - 'example' => '[{\'value\': \'hongxian_test\'}]', - ], - ], - 'example' => '-', - ], - 'HiveInfo' => [ - 'description' => 'hive数据源信息。', - 'type' => 'object', - 'properties' => [ - 'MetaStoreUri' => [ - 'description' => 'hive meta store url。', - 'type' => 'string', - 'example' => '-', - ], - 'Vswitch' => [ - 'description' => '交换机ID。', - 'type' => 'string', - 'example' => 'vsw-******', - ], - 'SecurityGroup' => [ - 'description' => '安全组ID。', - 'type' => 'string', - 'example' => 'sg-******', - ], - 'EmrClusterId' => [ - 'description' => 'EMR集群ID', - 'type' => 'string', - 'example' => '-', - ], - ], - 'example' => '-', - ], - 'RdsMysqlInfo' => [ - 'description' => '目前已不再支持。', - 'type' => 'object', - 'properties' => [ - 'UserName' => [ - 'description' => '-', - 'type' => 'string', - 'example' => '-', - ], - 'RegionId' => [ - 'description' => '-', - 'type' => 'string', - 'example' => '-', - ], - 'InstanceId' => [ - 'description' => '-', - 'type' => 'string', - 'example' => '-', - ], - 'ConnectUrl' => [ - 'description' => '-', - 'type' => 'string', - 'example' => '-', - ], - 'SecurityGroup' => [ - 'description' => '-', - 'type' => 'string', - 'example' => '-', - ], - ], - 'example' => '-', - ], - 'PolarDBMysqlInfo' => [ - 'description' => '目前已不再支持。', - 'type' => 'object', - 'properties' => [ - 'UserName' => [ - 'description' => '-', - 'type' => 'string', - 'example' => '-', - ], - 'RegionId' => [ - 'description' => '-', - 'type' => 'string', - 'example' => '-', - ], - 'InstanceId' => [ - 'description' => '-', - 'type' => 'string', - 'example' => '-', - ], - 'ConnectUrl' => [ - 'description' => '-', - 'type' => 'string', - 'example' => '-', - ], - 'SecurityGroup' => [ - 'description' => '-', - 'type' => 'string', - 'example' => '-', - ], - 'Across' => [ - 'description' => '-', - 'type' => 'boolean', - 'example' => '-', - ], - 'AcrossUid' => [ - 'description' => '-', - 'type' => 'string', - 'example' => '-', - ], - 'AcrossRole' => [ - 'description' => '-', - 'type' => 'string', - 'example' => '-', - ], - ], - 'example' => '-', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-******', - ], - 'DatabricksInfo' => [ - 'description' => 'databricks信息。', - 'type' => 'object', - 'properties' => [ - 'accessToken' => [ - 'description' => '访问databrick的令牌。', - 'type' => 'string', - 'example' => '******', - ], - 'workspaceURL' => [ - 'description' => '工作空间URL。', - 'type' => 'string', - 'example' => '-', - ], - ], - 'example' => '-', - ], - ], - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidInput', - 'errorMessage' => 'The specified parameter is invalid.', - ], + ['errorCode' => 'MDS.CatalogAlreadyExist', 'errorMessage' => 'The catalog already exists.', 'description' => '目录已经存在'], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ['errorCode' => 'MDS.SemanticViewNotExist', 'errorMessage' => 'This semantic view does not exist.', 'description' => '此语义视图不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + [ + ['errorCode' => 'MDS.InstanceNotExist', 'errorMessage' => 'ADB instance does not exist.', 'description' => 'ADB 实例不存在'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '更新语义视图定义', + 'summary' => '更新语义视图定义', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-**D8-5***-A***-****587\\",\\n \\"ApsDatasource\\": {\\n \\"DatasourceName\\": \\"kafka-2024***\\",\\n \\"CreateTime\\": \\"2024-04-12T15:03:38Z\\",\\n \\"DatasourceType\\": \\"KAFKA\\",\\n \\"DatasourceDescription\\": \\"test\\",\\n \\"SlsInfo\\": {\\n \\"SourceRegionId\\": \\"cn-hangzhou\\",\\n \\"Project\\": \\"***\\",\\n \\"Store\\": \\"***\\",\\n \\"Across\\": false,\\n \\"AcrossUid\\": \\"123456\\",\\n \\"AcrossRole\\": \\"test\\"\\n },\\n \\"KafkaInfo\\": {\\n \\"KafkaClusterId\\": \\"-\\",\\n \\"KafkaTopic\\": \\"[{\'value\': \'hongxian_test\'}]\\"\\n },\\n \\"HiveInfo\\": {\\n \\"MetaStoreUri\\": \\"-\\",\\n \\"Vswitch\\": \\"vsw-******\\",\\n \\"SecurityGroup\\": \\"sg-******\\",\\n \\"EmrClusterId\\": \\"-\\"\\n },\\n \\"RdsMysqlInfo\\": {\\n \\"UserName\\": \\"-\\",\\n \\"RegionId\\": \\"-\\",\\n \\"InstanceId\\": \\"-\\",\\n \\"ConnectUrl\\": \\"-\\",\\n \\"SecurityGroup\\": \\"-\\"\\n },\\n \\"PolarDBMysqlInfo\\": {\\n \\"UserName\\": \\"-\\",\\n \\"RegionId\\": \\"-\\",\\n \\"InstanceId\\": \\"-\\",\\n \\"ConnectUrl\\": \\"-\\",\\n \\"SecurityGroup\\": \\"-\\",\\n \\"Across\\": true,\\n \\"AcrossUid\\": \\"-\\",\\n \\"AcrossRole\\": \\"-\\"\\n },\\n \\"DBClusterId\\": \\"amv-******\\",\\n \\"DatabricksInfo\\": {\\n \\"accessToken\\": \\"******\\",\\n \\"workspaceURL\\": \\"-\\"\\n }\\n }\\n}","type":"json"}]', - 'title' => '查询过APS数据源详情', + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', ], - 'CreateAPSJob' => [ - 'summary' => '创建APS任务。', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'ResetAccountPassword' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -40219,136 +28580,126 @@ 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '180008', - 'abilityTreeNodes' => [ - 'FEATUREadsH8FO36', - ], + 'abilityTreeCode' => '130691', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'>您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-shanghai', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****'], ], [ - 'name' => 'SourceEndpointInstanceID', - 'in' => 'formData', - 'schema' => [ - 'description' => '源数据库实例ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'pc-xxxxx', - ], + 'name' => 'AccountName', + 'in' => 'query', + 'schema' => ['description' => '数据库账号。'."\n" + .'> 您可以调用[DescribeAccounts](~~612430~~)接口查看指定集群的数据库账号信息，包括数据库账号。', 'type' => 'string', 'required' => true, 'example' => 'test_accout'], ], [ - 'name' => 'SourceEndpointRegion', - 'in' => 'formData', - 'schema' => [ - 'description' => '源数据库地域。'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', - ], + 'name' => 'AccountPassword', + 'in' => 'query', + 'schema' => ['description' => '数据库账号密码。'."\n" + .'- 由大写字母、小写字母、数字、特殊字符中的任意三种组成。'."\n" + .'- 特殊符号包含：`!@#$%^&*()_+-=`'."\n" + .'- 密码长度为8~32个字符。', 'type' => 'string', 'required' => true, 'example' => 'Test_accout1'], ], [ - 'name' => 'SourceEndpointUserName', - 'in' => 'formData', - 'schema' => [ - 'description' => '源端用户名。', - 'type' => 'string', - 'required' => false, - 'example' => 'xxxx', - ], + 'name' => 'AccountDescription', + 'in' => 'query', + 'schema' => ['description' => '账号描述。'."\n" + .'- 不能以`http://`和`https://` 开头。'."\n" + .'- 长度为2~256个字符。', 'type' => 'string', 'required' => false, 'example' => 'AccDesc'], ], [ - 'name' => 'SourceEndpointPassword', - 'in' => 'formData', + 'name' => 'Engine', + 'in' => 'query', 'schema' => [ - 'description' => '源端密码。', + 'description' => '数据库引擎，取值：'."\n" + ."\n" + .'- **AnalyticDB**（默认）：AnalyticDB MySQL引擎。'."\n" + .'- **Clickhouse**：宽表引擎。', 'type' => 'string', 'required' => false, - 'example' => '******', - ], - ], - [ - 'name' => 'DestinationEndpointInstanceID', - 'in' => 'formData', - 'schema' => [ - 'description' => '目标端数据库实例ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-xxxxx', + 'enumValueTitles' => [], + 'example' => 'Clickhouse', ], ], - [ - 'name' => 'DestinationEndpointPassword', - 'in' => 'formData', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '目标端实例密码。', - 'type' => 'string', - 'required' => false, - 'example' => '******', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + ], ], ], - [ - 'name' => 'DestinationEndpointUserName', - 'in' => 'formData', - 'schema' => [ - 'description' => '目标端实例用户名。', - 'type' => 'string', - 'required' => false, - 'example' => '******', - ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidAccountPassword.Malformed', 'errorMessage' => 'The specified parameter AccountPassword is not valid.', 'description' => 'AccountPassword参数不正确，请确认参数是否符合规范。'."\n"], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'ACS.Sql.CannotConnect', 'errorMessage' => 'Cannot connect instance which type is %s.', 'description' => '无法连接到给定类型的子实例。'], ], - [ - 'name' => 'DbList', - 'in' => 'formData', - 'schema' => [ - 'description' => '同步对象列表。'."\n" - ."\n", - 'type' => 'string', - 'required' => true, - 'example' => '{"EntireInstance":true}', - ], + ], + 'title' => '重置数据库账号的密码', + 'summary' => '重置指定集群的数据库账号密码。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [ + ['createdAt' => '2024-06-13T13:53:52.000Z', 'description' => '错误码发生变更、请求参数发生变更'], + ['createdAt' => '2023-03-31T07:03:59.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:52:03.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ResetAccountPassword'], ], + ], + 'ramActions' => [ [ - 'name' => 'ApsJobName', - 'in' => 'formData', - 'schema' => [ - 'description' => '任务名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'aps-xxxxx', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ResetAccountPassword', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","errorExample":""},{"type":"xml","example":"<ResetAccountPasswordResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n</ResetAccountPasswordResponse>","errorExample":""}]', + ], + 'RevokeOperatorPermission' => [ + 'summary' => '取消服务账号的授权。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'PartitionList', - 'in' => 'formData', - 'schema' => [ - 'description' => '分区列表。', - 'type' => 'string', - 'required' => false, - 'example' => '{}', - ], + 'AK' => [], ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '214578', + 'abilityTreeNodes' => ['FEATUREadsF4WPVU'], + ], + 'parameters' => [ [ - 'name' => 'TargetTableMode', - 'in' => 'formData', - 'schema' => [ - 'description' => '目标表模式。', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'amv-bp1mfe9qmsw1dzyg'], ], ], 'responses' => [ @@ -40356,64 +28707,42 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'ApsJobId' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => 'aps-bj1xxxxxx', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D1B8ED33-5E9B-512D-B188-1579ED6xxx', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'True', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => 'InvalidInput', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**OK**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'OK', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'asynchronous', - 'callback' => 'adb::2021-12-01::DescribeApsJobDetail', - 'callbackInterval' => 6000, - 'maxCallbackTimes' => 100, + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'RelatedTaskNotFinish', 'errorMessage' => 'The related task does not finish.', 'description' => '关联任务未完成，禁止该操作。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"ApsJobId\\": \\"aps-bj1xxxxxx\\",\\n \\"RequestId\\": \\"D1B8ED33-5E9B-512D-B188-1579ED6xxx\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', - 'title' => '创建APS任务', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'StartApsJob' => [ - 'summary' => '启动APS任务。', - 'methods' => [ - 'post', + 'title' => '取消授权服务账号', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'RevokeOperatorPermission'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:RevokeOperatorPermission', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', + ], + 'RunMaterializedViewRecommend' => [ + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -40423,258 +28752,180 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', - 'riskType' => 'high', + 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '185195', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsY28JLD', - ], + 'abilityTreeNodes' => ['FEATUREadsTYGUV3'], ], 'parameters' => [ [ 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'in' => 'query', + 'schema' => ['description' => '实例所在Region ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'ApsJobId', - 'in' => 'formData', - 'schema' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'aps-******', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'am-bp1u8c0mgfg58****'], + ], + [ + 'name' => 'TaskName', + 'in' => 'query', + 'schema' => ['title' => '推荐任务名称，批量操作以逗号分隔。', 'description' => '推荐任务名称，批量操作以逗号分隔。', 'type' => 'string', 'required' => true, 'example' => 'task1'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'ApsJobId' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => 'aps-******', - ], - 'RequestId' => [ - 'description' => '请求的ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'True', - ], - 'ErrCode' => [ - 'description' => '调用出错时返回的错误码。'."\n" - ."\n", - 'type' => 'string', - 'example' => '0', - ], - 'ErrMessage' => [ - 'description' => '调用错误时返回对应的错误信息。', - 'type' => 'string', - 'example' => 'OK', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**OK**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'OK', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A444291****'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"ApsJobId\\": \\"aps-******\\",\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"ErrCode\\": \\"0\\",\\n \\"ErrMessage\\": \\"OK\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', - 'title' => '启动APS任务', - ], - 'SuspendApsJob' => [ - 'summary' => '暂停APS任务。', - 'methods' => [ - 'post', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '手动执行物化视图自动推荐任务', + 'summary' => '手动运行物化视图自动推荐任务。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'RunMaterializedViewRecommend'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:RunMaterializedViewRecommend', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A444291****\\"\\n}","type":"json"}]', + ], + 'SearchSemanticViews' => [ + 'summary' => '检索语义视图', + 'path' => '', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '183067', - 'abilityTreeNodes' => [ - 'FEATUREadsY28JLD', - 'FEATUREads1II0UT', - ], + 'abilityTreeNodes' => ['FEATUREads8FGISX'], ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['title' => 'ADB集群ID。', 'description' => 'ADB集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp*****'], ], [ - 'name' => 'ApsJobId', - 'in' => 'formData', - 'schema' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'aps-bj1xxxxxx', - ], + 'name' => 'QueryText', + 'in' => 'query', + 'schema' => ['title' => '待搜索文本内容。', 'description' => '待搜索文本内容。', 'type' => 'string', 'required' => false, 'example' => '销售额'], + ], + [ + 'name' => 'TopK', + 'in' => 'query', + 'schema' => ['title' => '要返回的最相关文档的数量。', 'description' => '要返回的最相关文档的数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '3', 'default' => '3'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'ApsJobId' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => 'aps-bj1xxxxxx', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'Success' => [ - 'description' => '请求是否成功。取值说明：'."\n" - .'- **True**：成功。'."\n" - .'- **False**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'ErrCode' => [ - 'description' => '调用出错时返回的错误码。'."\n", - 'type' => 'string', - 'example' => 'Success', - ], - 'ErrMessage' => [ - 'description' => '调用错误时返回的错误信息。'."\n", - 'type' => 'string', - 'example' => 'OK', + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => [ + 'title' => '返回数据体。', + 'description' => '返回数据体。', + 'type' => 'array', + 'items' => ['title' => '返回数据。', 'description' => '返回数据。', 'example' => '-', '$ref' => '#/components/schemas/SemanticViewModel'], ], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"ApsJobId\\": \\"aps-bj1xxxxxx\\",\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"ErrCode\\": \\"Success\\",\\n \\"ErrMessage\\": \\"OK\\"\\n}","type":"json"}]', - 'title' => '暂停APS任务', - ], - 'ModifyApsJob' => [ - 'summary' => '修改aps任务。', - 'methods' => [ - 'get', - 'post', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'MDS.CatalogAlreadyExist', 'errorMessage' => 'The catalog already exists.', 'description' => '目录已经存在'], + ['errorCode' => 'MDS.IllegalArgument', 'errorMessage' => 'Invalid argument.', 'description' => '用户使用了非法参数'], + ['errorCode' => 'MDS.InvalidPrivilege', 'errorMessage' => 'No permissions.', 'description' => '用户无权限进行操作'], + ['errorCode' => 'MDS.MetaSchemaAlreadyExist', 'errorMessage' => 'The database already exists.', 'description' => '数据库已存在'], + ['errorCode' => 'MDS.MetaSchemaNotExist', 'errorMessage' => 'The database does not exist.', 'description' => '操作的数据库不存在'], + ['errorCode' => 'MDS.MetaTableAlreadyExist', 'errorMessage' => 'The table already exists.', 'description' => '操作的表已经存在'], + ['errorCode' => 'MDS.MetaTableNotExist', 'errorMessage' => 'The table is not found.', 'description' => '操作的表不存在'], + ['errorCode' => 'MDS.SemanticViewAlreadyExist', 'errorMessage' => 'The semantic view already exists.', 'description' => '此语义视图已经存在'], + ['errorCode' => 'MDS.SemanticViewNotExist', 'errorMessage' => 'This semantic view does not exist.', 'description' => '此语义视图不存在'], + ], + 403 => [ + ['errorCode' => 'MDS.RamAuthAccessDenied', 'errorMessage' => 'ram auth access denied.', 'description' => 'RAM鉴权失败'], + ], + [ + ['errorCode' => 'MDS.InstanceNotExist', 'errorMessage' => 'ADB instance does not exist.', 'description' => 'ADB 实例不存在'], + ], + 500 => [ + ['errorCode' => 'MDS.InternalError', 'errorMessage' => 'An internal MDS error occurred.', 'description' => 'MDS服务内部错误'], + ['errorCode' => 'MDS.MetaVisitError', 'errorMessage' => 'Failed to access metadata.', 'description' => '访问元数据失败'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '检索语义视图', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": [\\n {\\n \\"ViewSchema\\": \\"sales_db\\",\\n \\"Definition\\": \\"name: revenue_analysis\\\\ndescription: \\\\\\"Semantic view for analyzing revenue across products and customers\\\\\\"\\\\n\\\\ntables:\\\\n - name: customers\\\\n description: \\\\\\"Customer information\\\\\\"\\\\n base_table:\\\\n schema: sales_db\\\\n table: customers\\\\n dimensions:\\\\n - name: customer_name\\\\n synonyms: [\\\\\\"client name\\\\\\", \\\\\\"customer\\\\\\"]\\\\n description: \\\\\\"Full name of the customer\\\\\\"\\\\n expr: c_name\\\\n data_type: VARCHAR\\\\n - name: customer_segment\\\\n synonyms: [\\\\\\"segment\\\\\\", \\\\\\"market segment\\\\\\"]\\\\n description: \\\\\\"Customer market segment\\\\\\"\\\\n expr: c_mktsegment\\\\n data_type: VARCHAR\\\\n is_enum: true\\\\n\\\\n - name: orders\\\\n description: \\\\\\"Order information\\\\\\"\\\\n base_table:\\\\n schema: sales_db\\\\n table: orders\\\\n dimensions:\\\\n - name: order_date\\\\n description: \\\\\\"Date when order was placed\\\\\\"\\\\n expr: o_orderdate\\\\n data_type: DATE\\\\n - name: order_year\\\\n description: \\\\\\"Year when order was placed\\\\\\"\\\\n expr: YEAR(o_orderdate)\\\\n data_type: NUMBER\\\\n facts:\\\\n - name: order_total\\\\n description: \\\\\\"Total order amount\\\\\\"\\\\n expr: o_totalprice\\\\n data_type: NUMBER\\\\n metrics:\\\\n - name: total_orders\\\\n description: \\\\\\"Total number of orders\\\\\\"\\\\n expr: COUNT(*)\\\\n - name: total_revenue\\\\n description: \\\\\\"Total revenue of orders\\\\\\"\\\\n expr: SUM(o_totalprice)\\\\n - name: average_order_value\\\\n description: \\\\\\"Average order value\\\\\\"\\\\n expr: AVG(o_totalprice)\\\\n\\\\nrelationships:\\\\n - name: orders_to_customers\\\\n left_table: orders\\\\n right_table: customers\\\\n relationship_columns:\\\\n - left_column: o_custkey\\\\n right_column: c_custkey\\\\n\\\\nmetrics:\\\\n - name: revenue_per_customer\\\\n description: \\\\\\"Average revenue per customer\\\\\\"\\\\n expr: orders.total_revenue / customers.customer_count\\\\n\\",\\n \\"ViewName\\": \\"revenue_analysis\\",\\n \\"Comment\\": \\"这是一个定义销售额相关指标的视图\\",\\n \\"Score\\": 0.81\\n }\\n ]\\n}","type":"json"}]', + ], + 'SetSparkAppLogRootPath' => [ + 'summary' => '更改用户Spark的日志配置。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', - 'abilityTreeCode' => '183077', - 'abilityTreeNodes' => [ - 'FEATUREadsH8FO36', - ], + 'abilityTreeCode' => '156583', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], ], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'DBClusterId', 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['title' => '数据库的id', 'description' => 'AnalyticDB for MySQL集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp169ea59k****', 'maxLength' => 64], ], [ - 'name' => 'ApsJobId', - 'in' => 'formData', - 'schema' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'aps-bj1xxxxxx', - ], - ], - [ - 'name' => 'DbList', + 'name' => 'OssLogPath', 'in' => 'formData', - 'schema' => [ - 'description' => '同步对象列表。'."\n" - ."\n", - 'type' => 'string', - 'required' => true, - 'example' => '{"EntireInstance":true}', - ], + 'schema' => ['description' => 'OSS日志地址。', 'type' => 'string', 'required' => false, 'example' => 'oss://testBucketname/to/log'], ], [ - 'name' => 'PartitionList', + 'name' => 'UseDefaultOss', 'in' => 'formData', - 'schema' => [ - 'description' => '分区列表。', - 'type' => 'string', - 'required' => false, - 'example' => '{}', - ], + 'schema' => ['description' => '是否使用默认生成的OSS地址。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], ], ], 'responses' => [ @@ -40682,71 +28933,81 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'ApsJobId' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => 'aps-bj1xxxxxx', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'True', - ], - 'ErrCode' => [ - 'description' => '错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'ErrMessage' => [ - 'description' => '调用错误时返回对应的错误信息。', - 'type' => 'string', - 'example' => 'OK', - ], - 'Code' => [ - 'description' => '状态码。说明 200表示成功。', - 'type' => 'string', - 'example' => 'InvalidInput'."\n", - ], - 'Message' => [ - 'description' => '调用结果的信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常信息。', - 'type' => 'string', - 'example' => 'SUCCESS', + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380'], + 'Data' => [ + 'description' => '返回数据体。', + 'type' => 'object', + 'properties' => [ + 'IsLogPathExists' => ['title' => '是否存在日志地址', 'description' => '是否存在日志地址。', 'type' => 'boolean', 'example' => 'true'], + 'RecordedLogPath' => ['title' => '记录的地址名称', 'description' => '记录的地址名称。', 'type' => 'string', 'example' => 'oss://testBucketname/to/log'], + 'ModifiedUid' => ['title' => '修改者ID', 'description' => '修改者ID。', 'type' => 'string', 'example' => '11111111'], + 'ModifiedTimestamp' => ['title' => '上一次修改时间', 'description' => '上一次修改时间。', 'type' => 'string', 'example' => '1675236908'], + 'DefaultLogPath' => ['title' => '推荐的默认地址', 'description' => '推荐的默认地址。', 'type' => 'string', 'example' => 'oss://testBucketname/to/log'], + ], ], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '只允许分析处于终止状态的 Spark app。指定 app 不满足条件。'], + ['errorCode' => 'Spark.AnalyzeTask.FailedToKill', 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', 'description' => '杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。'], + ['errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Log.InvalidState', 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'description' => '无法获取指定Spark作业的日志。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Failed to parse the SQL %s. Error message: %s.', 'description' => 'Spark作业信息中的SQL无法解析。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s.', 'description' => '操作对象处于非合法状态 %s。'], + ], + 404 => [ + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.AnalyzeTask.NotFound', 'errorMessage' => 'The requested analysis task %s is not found.', 'description' => '请求查看的日志分析任务 %s 不存在。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], + ['errorCode' => 'Spark.TemplateFile.TemplateNotFound', 'errorMessage' => 'The template %s is not found.', 'description' => '模板文件未找到。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"ApsJobId\\": \\"aps-bj1xxxxxx\\",\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"ErrCode\\": \\"Success\\",\\n \\"ErrMessage\\": \\"OK\\",\\n \\"Code\\": \\"InvalidInput\\\\n\\",\\n \\"Message\\": \\"SUCCESS\\"\\n}","type":"json"}]', - 'title' => '修改aps任务', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DeleteApsJob' => [ - 'summary' => '删除aps任务。', - 'methods' => [ - 'post', + 'title' => '更改用户Spark的日志配置', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2024-09-04T08:10:53.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-06-28T01:10:27.000Z', 'description' => '错误码发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SetSparkAppLogRootPath'], + ], ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:SetSparkAppLogRootPath', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"IsLogPathExists\\": true,\\n \\"RecordedLogPath\\": \\"oss://testBucketname/to/log\\",\\n \\"ModifiedUid\\": \\"11111111\\",\\n \\"ModifiedTimestamp\\": \\"1675236908\\",\\n \\"DefaultLogPath\\": \\"oss://testBucketname/to/log\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<SetSparkAppLogRootPathResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <IsLogPathExists>true</IsLogPathExists>\\n <RecordedLogPath>oss://path/to/log</RecordedLogPath>\\n <ModifiedUid>1111111</ModifiedUid>\\n <ModifiedTimestamp>1675236908</ModifiedTimestamp>\\n <DefaultLogPath>oss://path/to/log</DefaultLogPath>\\n </Data>\\n</SetSparkAppLogRootPathResponse>","errorExample":""}]', + ], + 'StartApsJob' => [ + 'summary' => '启动APS任务。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -40758,33 +29019,19 @@ 'operationType' => 'none', 'riskType' => 'high', 'chargeType' => 'free', - 'abilityTreeCode' => '183073', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsY28JLD', - ], + 'abilityTreeCode' => '185195', + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsY28JLD'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'>您可以调用[DescribeRegions](~~143074~~)接口查看地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'ApsJobId', 'in' => 'formData', - 'schema' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'aps-*****', - ], + 'schema' => ['description' => '任务ID。', 'type' => 'string', 'required' => true, 'example' => 'aps-******'], ], ], 'responses' => [ @@ -40792,430 +29039,148 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'HttpStatusCode' => [ - 'description' => 'HTTP状态码。'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'ApsJobId' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => 'aps-*****', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '****-****-5D14-AC9F-*********', - ], - 'Success' => [ - 'description' => '是否成功。', - 'type' => 'boolean', - 'example' => 'True', - ], - 'ErrCode' => [ - 'description' => '调用出错时返回的错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'ErrMessage' => [ - 'description' => '调用错误时返回对应的错误信息。', - 'type' => 'string', - 'example' => 'OK', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常信息。', - 'type' => 'string', - 'example' => 'OK', - ], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'ApsJobId' => ['description' => '任务ID。', 'type' => 'string', 'example' => 'aps-******'], + 'RequestId' => ['description' => '请求的ID。', 'type' => 'string', 'example' => '******-3EEC-******-9F06-******'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'True'], + 'ErrCode' => ['description' => '调用出错时返回的错误码。'."\n" + ."\n", 'type' => 'string', 'example' => '0'], + 'ErrMessage' => ['description' => '调用错误时返回对应的错误信息。', 'type' => 'string', 'example' => 'OK'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**OK**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'OK'], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"ApsJobId\\": \\"aps-*****\\",\\n \\"RequestId\\": \\"****-****-5D14-AC9F-*********\\",\\n \\"Success\\": true,\\n \\"ErrCode\\": \\"Success\\",\\n \\"ErrMessage\\": \\"OK\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', - 'title' => '删除APS任务', - 'description' => '- 删除备份集是异步操作，前端显示会有延迟，需要等待约10-20分钟才会生效。'."\n" - .'- 单次最大允许删除100个备份集。如果要删超过100个备份集，请分2次调用。'."\n" - .'- 为保证数据安全性，系统会强制保留1个有效备份集。当要删除仅有的备份集时，接口会禁止。', - ], - 'CreateApsDatasoure' => [ - 'summary' => '创建APS数据源。', - 'methods' => [ - 'get', - 'post', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '启动APS任务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'StartApsJob'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:StartApsJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"ApsJobId\\": \\"aps-******\\",\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"ErrCode\\": \\"0\\",\\n \\"ErrMessage\\": \\"OK\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', + ], + 'StartFormationCrawler' => [ + 'summary' => '手动触发一次元数据发现任务', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '168860', - 'abilityTreeNodes' => [ - 'FEATUREadsBIVU9O', - 'FEATUREadsY28JLD', - 'FEATUREads1II0UT', - ], + 'abilityTreeCode' => '137130', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-xxxxx', - ], - ], - [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-shanghai', - ], - ], - [ - 'name' => 'DatasourceType', + 'name' => 'CrawlerTaskId', 'in' => 'formData', - 'schema' => [ - 'description' => '数据源类型。', - 'type' => 'string', - 'required' => true, - 'example' => 'KAFKA', - ], + 'schema' => ['description' => '任务id。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'docRequired' => true, 'maximum' => '10000', 'minimum' => '1', 'example' => '247'], ], [ - 'name' => 'DatasourceName', + 'name' => 'CrawlerTaskName', 'in' => 'formData', - 'schema' => [ - 'description' => '数据源名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'sls-******', - ], + 'schema' => ['description' => '任务名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'test-crawler-dbname'], ], [ - 'name' => 'DatasourceDescription', + 'name' => 'DBClusterId', 'in' => 'formData', - 'schema' => [ - 'description' => '数据源描述。', - 'type' => 'string', - 'required' => false, - 'example' => 'description', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => false, 'example' => 'am-bp1pke2pcfavw****'], ], [ - 'name' => 'Mode', + 'name' => 'RegionId', 'in' => 'formData', - 'schema' => [ - 'description' => '模式。'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'ALI_CLOUD_INSTANCE', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看可用地域的地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], - [ - 'name' => 'SlsInfo', - 'in' => 'formData', - 'style' => 'json', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '创建的日志服务（SLS）信息。', 'type' => 'object', 'properties' => [ - 'SourceRegionId' => [ - 'description' => '源集群所处地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', - ], - 'Project' => [ - 'description' => '日志服务（SLS）项目。', - 'type' => 'string', - 'required' => false, - 'example' => 'test-project', - ], - 'Store' => [ - 'description' => 'sls logstore。', - 'type' => 'string', - 'required' => false, - 'example' => 'test-store', - ], - 'Across' => [ - 'description' => '是否跨账号。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - 'AcrossUid' => [ - 'description' => '跨账号UID。', - 'type' => 'string', - 'required' => false, - 'example' => 'xxxx', - ], - 'AcrossRole' => [ - 'description' => '跨账号角色名。', - 'type' => 'string', - 'required' => false, - 'example' => 'yyy', - ], + 'RequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => '2FED790E-FB61-4721-8C1C-07C627FA5A19'], + 'Data' => ['description' => '返回数据。', 'type' => 'string', 'example' => '69'], + 'TaskId' => ['description' => '任务id。', 'type' => 'integer', 'format' => 'int64', 'example' => '1564657730'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'True'], ], - 'required' => false, - 'example' => '-', + 'description' => '', ], ], - [ - 'name' => 'KafkaInfo', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => 'Kafka信息。', - 'type' => 'object', - 'properties' => [ - 'KafkaClusterId' => [ - 'description' => 'kafka实例ID。', - 'type' => 'string', - 'required' => false, - 'example' => '******', - ], - 'KafkaTopic' => [ - 'description' => '分配kafka topic名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], - ], - 'required' => false, - 'example' => '-', - ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid.', 'description' => ''], + ['errorCode' => 'AlreadyRunning', 'errorMessage' => 'The crawler instance is already running.', 'description' => ''], + ['errorCode' => 'NotExists', 'errorMessage' => 'The formation task does not exist. ', 'description' => ''], ], - [ - 'name' => 'HiveInfo', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => 'Hive数据源信息。', - 'type' => 'object', - 'properties' => [ - 'MetaStoreUri' => [ - 'description' => 'meta store 连接地址。', - 'type' => 'string', - 'required' => false, - 'example' => '******', - ], - 'Vswitch' => [ - 'description' => '交换机ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'vsw-bp1*****k', - ], - 'SecurityGroup' => [ - 'description' => '安全组。', - 'type' => 'string', - 'required' => false, - 'example' => 'sg-uf*******h', - ], - 'ClusterId' => [ - 'description' => '实例ID', - 'type' => 'string', - 'required' => false, - 'example' => '******', - ], - 'HostConfig' => [ - 'description' => '主机配置。', - 'type' => 'string', - 'required' => false, - 'example' => '******', - ], - ], - 'required' => false, - 'example' => '-', - ], + 500 => [ + ['errorCode' => 'ServerStoreError', 'errorMessage' => 'A server storage error occurred. ', 'description' => ''], ], + ], + 'title' => '手动执行元数据发现任务', + 'description' => '### 使用说明'."\n" + .'您在使用云原生数据仓库AnalyticDB MySQL版集群过程中需要阿里云技术支持时，如果技术支持过程中需要对您的集群进行操作，您需要授权AnalyticDB MySQL集群的服务账号，技术支持人员才可以通过服务账号提供技术支持服务。在授权有效期结束后，服务账号的权限会被自动回收。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2FED790E-FB61-4721-8C1C-07C627FA5A19\\",\\n \\"Data\\": \\"69\\",\\n \\"TaskId\\": 1564657730,\\n \\"Success\\": true\\n}","type":"json"}]', + ], + 'StartSparkReplSession' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'RdsMysqlInfo', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => 'rds mysql数据源信息。', - 'type' => 'object', - 'properties' => [ - 'InstanceId' => [ - 'description' => '实例ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'rm-xxxxxxx', - ], - 'UserName' => [ - 'description' => '用户名。', - 'type' => 'string', - 'required' => false, - 'example' => '用户名。', - ], - 'Password' => [ - 'description' => '密码。', - 'type' => 'string', - 'required' => false, - 'example' => '******', - ], - 'RegionId' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-shanghai', - ], - 'ConnectUrl' => [ - 'description' => '只读实例连接地址。', - 'type' => 'string', - 'required' => false, - 'example' => '******', - ], - 'SecurityGroup' => [ - 'description' => '安全组。', - 'type' => 'string', - 'required' => false, - 'example' => 'sg-******', - ], - ], - 'required' => false, - 'example' => '-', - ], + 'AK' => [], ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ [ - 'name' => 'PolarDBMysqlInfo', + 'name' => 'DBClusterId', 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => 'polardb mysql数据源信息。', - 'type' => 'object', - 'properties' => [ - 'InstanceId' => [ - 'description' => '实例ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'pc-bp*********', - ], - 'UserName' => [ - 'description' => '用户名。', - 'type' => 'string', - 'required' => false, - 'example' => 'test-user-name', - ], - 'Password' => [ - 'description' => '密码。', - 'type' => 'string', - 'required' => false, - 'example' => '***', - ], - 'RegionId' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-shanghai', - ], - 'ConnectUrl' => [ - 'description' => '私有定制RDS连接地址。', - 'type' => 'string', - 'required' => false, - 'example' => '****', - ], - 'SecurityGroup' => [ - 'description' => '安全组。', - 'type' => 'string', - 'required' => false, - 'example' => 'sg-******', - ], - 'Across' => [ - 'description' => '是否跨账号。取值：'."\n" - ."\n" - .'- **true** ：当前网络实例为跨账号资源。'."\n" - .'- **false** ：当前网络实例为本账号资源。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - 'AcrossUid' => [ - 'description' => '跨账号UID。', - 'type' => 'string', - 'required' => false, - 'example' => '123456789*', - ], - 'AcrossRole' => [ - 'description' => '跨账号角色。', - 'type' => 'string', - 'required' => false, - 'example' => 'test-role', - ], - ], - 'required' => false, - 'example' => '-', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp1mfe9qm****'], ], [ - 'name' => 'PolarDBXInfo', + 'name' => 'ResourceGroupName', 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => 'polardbx数据源信息。', - 'type' => 'object', - 'properties' => [ - 'InstanceId' => [ - 'description' => 'OceanBase 集群 ID。', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], - ], - 'required' => false, - 'example' => '-', - ], + 'schema' => ['description' => 'Job型资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'test'], ], [ - 'name' => 'DatabricksInfo', + 'name' => 'Config', 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => 'databricks数据源信息。', - 'type' => 'object', - 'properties' => [ - 'AccessToken' => [ - 'description' => '访问令牌。', - 'type' => 'string', - 'required' => false, - 'example' => '******', - ], - 'WorkspaceURL' => [ - 'description' => '工作空间URL。', - 'type' => 'string', - 'required' => false, - 'example' => 'xxxxx', - ], - ], - 'required' => false, - 'example' => '-', - ], + 'schema' => ['description' => '启动Spark的具体配置，格式为JSON。详情请参见[Spark Conf配置](~~471203~~)。', 'type' => 'string', 'required' => true, 'example' => '{ "spark.shuffle.timeout": ":0s" }'], ], ], 'responses' => [ @@ -41223,372 +29188,318 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'C1797FEA-B7D6-5ED6-A24B-2C8C5F4D7361'], 'Data' => [ - 'description' => '集群资源具体使用详情。', - 'type' => 'string', - 'example' => '69', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '65D2***-45C1-5C18-**********', - ], - 'Success' => [ - 'description' => '预检查结果，返回值说明：'."\n" - ."\n" - .'- **success**：检查通过。'."\n" - .'- **false**：检查不通过。', - 'type' => 'boolean', - 'example' => 'True', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'OK', - ], - 'DBClusterId' => [ - 'description' => '集群ID。'."\n", - 'type' => 'string', - 'example' => 'amv-7xxxxx', + 'description' => '返回数据。', + 'type' => 'object', + 'properties' => [ + 'SessionId' => ['description' => '执行代码的会话ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'AttemptId' => ['description' => 'Spark应用的重试ID。', 'type' => 'string', 'example' => 's202301061000h****'], + 'Error' => ['description' => '错误消息。', 'type' => 'string', 'example' => 'session time out'], + 'WebUiAddress' => ['description' => 'Spark应用的Web UI地址。', 'type' => 'string', 'example' => 'https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****'], + 'State' => [ + 'description' => '会话状态，取值如下：'."\n" + .'- IDLE: 会话空闲'."\n" + .'- BUSY: 会话繁忙，有任务在执行'."\n" + .'- DEAD: 会话关闭', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => 'IDLE', + ], + 'AliyunUid' => ['description' => '集群所属的阿里云主账号。', 'type' => 'string', 'example' => '178157466******'], + ], ], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.App.ExceedQuotaLimitation', 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', 'description' => ''], + ['errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', 'description' => 'AppType类型不合法，请参考使用文档指定适合业务的AppType，请关注配置类型：%s。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ResourceNegativeError', 'errorMessage' => 'The requested resource MUST be positive: %s', 'description' => ''], + ['errorCode' => 'Spark.Config.InvalidAppFilePath', 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', 'description' => '主驱动文件地址必须是合法的OSS地址，当前的地址是 %s。'], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.InvalidDiskConfig', 'errorMessage' => 'The requested disk mount parameter is invalid: %s', 'description' => '磁盘挂载配置错误。'], + ['errorCode' => 'Spark.Config.InvalidHostAliasConfig', 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', 'description' => '域名映射配置错误。'], + ['errorCode' => 'Spark.Config.InvalidLogOssPath', 'errorMessage' => 'The OSS address for log storage is illegal: %s', 'description' => '存储日志的OSS地址非法。'], + ['errorCode' => 'Spark.Config.InvalidRoleArnFormat', 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', 'description' => '配置的RoleARN格式错误。'], + ['errorCode' => 'Spark.Config.InvalidTimeZone', 'errorMessage' => 'Unable to parse time zone configuration %s : %s', 'description' => '时区配置错误。'], + ['errorCode' => 'Spark.Config.MainAppFileNotExists', 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', 'description' => '主驱动文件缺失，必须保证file或者sqls配置不为空。'], + ['errorCode' => 'Spark.Config.OSSPathAccessError', 'errorMessage' => 'The configured OSS address %s cannot be accessed.', 'description' => '配置的OSS路径无法访问。'], + ['errorCode' => 'Spark.Config.OSSPathNotExists', 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', 'description' => 'OSS路径不存在或当前用户无权限访问。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Config.SecurityGroupNotFound', 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', 'description' => '配置的资源组不存在或者因权限不足无法访问。%s。'], + ['errorCode' => 'Spark.Config.VswitchNotFound', 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', 'description' => '无法找到配置虚拟机交换机，或当前账号权限不足。%s。'], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.RoleArn.Invalid', 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', 'description' => 'RoleArn不存在或子账号未授权。'], + ['errorCode' => 'Spark.SQL.BlankError', 'errorMessage' => 'Input sql can not be blank string.', 'description' => '提交SQL不能为空。'], + ['errorCode' => 'Spark.SQL.MultipleSQLError', 'errorMessage' => 'Element in field [sqls] can not contain more than one sql statement: %s.', 'description' => '提交的Spark SQL包含了多条可执行SQL。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Submit spark app failed when parser SQL %s. Error message: %s.', 'description' => '解析提交的Spark SQL失败。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.App.NotFound', 'errorMessage' => 'The Spark application %s is not found.', 'description' => '未能找到输入的 Spark App。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": \\"69\\",\\n \\"RequestId\\": \\"65D2***-45C1-5C18-**********\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\",\\n \\"DBClusterId\\": \\"amv-7xxxxx\\"\\n}","type":"json"}]', - 'title' => '创建APS数据源', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'ModifyApsDatasoure' => [ - 'summary' => '修改APS数据源。', - 'methods' => [ - 'get', - 'post', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '启动一个Spark会话', + 'summary' => '启动一个Spark会话。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'StartSparkReplSession'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:SubmitSparkApp', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#resourcegroup}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C1797FEA-B7D6-5ED6-A24B-2C8C5F4D7361\\",\\n \\"Data\\": {\\n \\"SessionId\\": 1,\\n \\"AttemptId\\": \\"s202301061000h****\\",\\n \\"Error\\": \\"session time out\\",\\n \\"WebUiAddress\\": \\"https://adbsparkui-cn-hangzhou.aliyuncs.com/?token=****\\",\\n \\"State\\": \\"IDLE\\",\\n \\"AliyunUid\\": \\"178157466******\\"\\n }\\n}","type":"json"}]', + ], + 'StartSparkSQLEngine' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', - 'deprecated' => false, + 'operationType' => 'readAndWrite', + 'deprecated' => true, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'create', 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsY28JLD', - ], + 'chargeType' => 'paid', + 'abilityTreeCode' => '152577', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-*******', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-abcd****'], ], [ - 'name' => 'RegionId', + 'name' => 'ResourceGroupName', 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-shanghai', - ], + 'schema' => ['description' => '资源组名称。', 'type' => 'string', 'required' => true, 'example' => 'spark-rg-name'], ], [ - 'name' => 'DatasourceId', + 'name' => 'MinExecutor', 'in' => 'formData', - 'schema' => [ - 'description' => '数据源ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1', - ], + 'schema' => ['description' => '执行SQL时拉起的最小Exectuor数量，配置为0意味着当不需要执行SQL时不会常驻Exectuor。取值范围为0到2000，当配置数量超过资源组承载总量时会导致服务启动失败。此处配置值必须小于MaxExecutor的配置值。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1', 'default' => '0'], ], [ - 'name' => 'DatasourceName', + 'name' => 'MaxExecutor', 'in' => 'formData', - 'schema' => [ - 'description' => '数据源名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'sls-******', - ], + 'schema' => ['description' => '执行SQL时启动的最大的Exector数量。取值范围为1到2000，当配置数量超过资源组承载总量时会导致服务启动失败。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '10'], ], [ - 'name' => 'DatasourceDescription', + 'name' => 'Jars', 'in' => 'formData', - 'schema' => [ - 'description' => '数据源描述。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['description' => '启动SQL引擎时需要引入的第三方JAR包列表，以逗号分隔的JAR包所在的OSS地址。', 'type' => 'string', 'required' => false, 'example' => 'oss://testBuckname/test.jar,oss://testBuckname/test2.jar'], ], [ - 'name' => 'SlsInfo', + 'name' => 'SlotNum', 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => '日志服务（SLS）信息。', - 'type' => 'object', - 'properties' => [ - 'SourceRegionId' => [ - 'description' => '源地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', - ], - 'Across' => [ - 'description' => '是否跨账号。取值：'."\n" - ."\n" - .'- **true** ：当前网络实例为跨账号资源。'."\n" - .'- **false** ：当前网络实例为本账号资源。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - 'AcrossUid' => [ - 'description' => '跨账号UID。', - 'type' => 'string', - 'required' => false, - 'example' => '123456', - ], - 'AcrossRole' => [ - 'description' => '跨账号角色。', - 'type' => 'string', - 'required' => false, - 'example' => 'test-role', - ], - ], - 'required' => false, - 'example' => '-', - ], + 'schema' => ['description' => '最大槽位数，即最多可以维持多少个Spark Session来执行SQL。取值范围为1到500。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '100', 'default' => '50'], ], [ - 'name' => 'KafkaInfo', + 'name' => 'Config', 'in' => 'formData', - 'style' => 'json', + 'schema' => ['description' => '启动Spark SQL Engine的具体配置，以一个JSON来描述KEY-VALUE型配置信息。详情请参见[Spark Conf配置](~~471203~~)。', 'type' => 'string', 'required' => false, 'example' => '{ "spark.shuffle.timeout": ":0s" }'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '-', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'KafkaClusterId' => [ - 'description' => 'kafka实例ID。', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], - 'KafkaTopic' => [ - 'description' => 'kafka topic名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test-topic', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'D65A809F-34CE-4550-9BC1-0ED21ETG380'], + 'Data' => [ + 'description' => '返回结果。', + 'type' => 'object', + 'properties' => [ + 'AppId' => ['description' => 'Spark作业ID。', 'type' => 'string', 'example' => 's202301xxxx'], + 'State' => ['description' => 'Spark SQL Engine状态：'."\n" + ."\n" + .'- SUBMITTED：提交启动请求。'."\n" + .'- STARTING：启动中。'."\n" + .'- RUNNING：运行中，可以执行SQL。'."\n" + .'- FAILED：引擎出错退出。', 'type' => 'string', 'example' => 'SUBMITTED'], + 'AppName' => ['description' => 'Spark App名称。', 'type' => 'string', 'example' => 'SQLEngine1'], + ], ], ], - 'required' => false, - 'example' => '-', ], ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.App.ExceedQuotaLimitation', 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', 'description' => ''], + ['errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', 'description' => 'AppType类型不合法，请参考使用文档指定适合业务的AppType，请关注配置类型：%s。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ResourceNegativeError', 'errorMessage' => 'The requested resource MUST be positive: %s', 'description' => ''], + ['errorCode' => 'Spark.Config.InvalidAppFilePath', 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', 'description' => '主驱动文件地址必须是合法的OSS地址，当前的地址是 %s。'], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.InvalidDiskConfig', 'errorMessage' => 'The requested disk mount parameter is invalid: %s', 'description' => '磁盘挂载配置错误。'], + ['errorCode' => 'Spark.Config.InvalidHostAliasConfig', 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', 'description' => '域名映射配置错误。'], + ['errorCode' => 'Spark.Config.InvalidLogOssPath', 'errorMessage' => 'The OSS address for log storage is illegal: %s', 'description' => '存储日志的OSS地址非法。'], + ['errorCode' => 'Spark.Config.InvalidRoleArnFormat', 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', 'description' => '配置的RoleARN格式错误。'], + ['errorCode' => 'Spark.Config.InvalidTimeZone', 'errorMessage' => 'Unable to parse time zone configuration %s : %s', 'description' => '时区配置错误。'], + ['errorCode' => 'Spark.Config.MainAppFileNotExists', 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', 'description' => '主驱动文件缺失，必须保证file或者sqls配置不为空。'], + ['errorCode' => 'Spark.Config.OSSPathAccessError', 'errorMessage' => 'The configured OSS address %s cannot be accessed.', 'description' => '配置的OSS路径无法访问。'], + ['errorCode' => 'Spark.Config.OSSPathNotExists', 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', 'description' => 'OSS路径不存在或当前用户无权限访问。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Config.SecurityGroupNotFound', 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', 'description' => '配置的资源组不存在或者因权限不足无法访问。%s。'], + ['errorCode' => 'Spark.Config.VswitchNotFound', 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', 'description' => '无法找到配置虚拟机交换机，或当前账号权限不足。%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.Log.InvalidState', 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'description' => '无法获取指定Spark作业的日志。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], [ - 'name' => 'LakehouseId', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => 'Lakehouse ID。', - 'type' => 'object', - 'properties' => [ - 'Vswitch' => [ - 'description' => '交换机名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'vsw-******', - ], - 'SecurityGroup' => [ - 'description' => '安全组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'sg-******', - ], - 'VpcId' => [ - 'description' => 'vpc id。', - 'type' => 'string', - 'required' => false, - 'example' => 'vpc-******', - ], + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.App.NotFound', 'errorMessage' => 'The Spark application %s is not found.', 'description' => '未能找到输入的 Spark App。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], + ], + 'staticInfo' => ['noSubstitutionReason' => '无替代API，历史原因导致该API被标记为弃用。'], + 'title' => '启动Spark SQL引擎', + 'summary' => '启动Spark SQL引擎。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-07-27T02:58:13.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2023-06-28T01:10:26.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'StartSparkSQLEngine'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:StartSparkEngine', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], - 'required' => false, - 'example' => '123', ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D65A809F-34CE-4550-9BC1-0ED21ETG380\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202301xxxx\\",\\n \\"State\\": \\"SUBMITTED\\",\\n \\"AppName\\": \\"SQLEngine1\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<StartSparkSQLEngineResponse>\\n <RequestId>D65A809F-34CE-4550-9BC1-0ED21ETG380</RequestId>\\n <Data>\\n <AppId>s202301xxxx</AppId>\\n <State>SUBMITTED</State>\\n <AppName>SQLEngine1</AppName>\\n </Data>\\n</StartSparkSQLEngineResponse>","errorExample":""}]', + ], + 'StopFormationCrawler' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'RdsMysqlInfo', + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'none', + 'abilityTreeCode' => '138506', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], + ], + 'parameters' => [ + [ + 'name' => 'RegionId', 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => '已废弃数据源信息。', - 'type' => 'object', - 'properties' => [ - 'UserName' => [ - 'description' => '-', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], - 'Password' => [ - 'description' => '-', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], - 'RegionId' => [ - 'description' => '-', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], - 'ConnectUrl' => [ - 'description' => '-', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], - ], - 'required' => false, - 'example' => '-', - ], + 'schema' => ['description' => '地域id，您可通过接口[describeregions](~~143074~~)查看可用的地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'PolarDBMysqlInfo', + 'name' => 'CrawlerTaskName', 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => '已废弃数据源信息。', - 'type' => 'object', - 'properties' => [ - 'UserName' => [ - 'description' => '-', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], - 'Password' => [ - 'description' => '-', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], - 'RegionId' => [ - 'description' => '-', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], - 'ConnectUrl' => [ - 'description' => '-', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], - ], - 'required' => false, - 'example' => '-', - ], + 'schema' => ['description' => '任务名称。', 'type' => 'string', 'required' => true, 'example' => 'test-crawler-dbname'], + ], + [ + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '实例id。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1xxxxxxxx47'], + ], + [ + 'name' => 'CrawlerTaskId', + 'in' => 'formData', + 'schema' => ['description' => '任务id。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '21'], ], ], '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' => 'A3EB3BCD-D974-52D4-B75C-BB06505916CB', - ], - 'Data' => [ - 'description' => '资源组信息列表。', - 'type' => 'string', - 'example' => '150', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'string', - 'example' => '200', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：调用成功。'."\n" - .'- **false**：调用失败。', - 'type' => 'string', - 'example' => 'True', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => 'InvalidInput'."\n", - ], - 'Message' => [ - 'description' => '应用建议执行结果。取值说明：'."\n" - .'- 请求正常，返回**SUCCESS**。 '."\n" - .'- 请求异常，返回具体异常错误信息。', - 'type' => 'string', - 'example' => 'OK', - ], + 'HttpStatusCode' => ['description' => 'http状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '创建成功的任务id。', 'type' => 'string', 'example' => 'true'], + 'RequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => '9CCFAAB4-97B7-5800-B9F2-685EB596E3EF'], + 'Success' => ['description' => '是否成功。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '状态码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '错误信息。', 'type' => 'string', 'example' => 'Success'], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"A3EB3BCD-D974-52D4-B75C-BB06505916CB\\",\\n \\"Data\\": \\"150\\",\\n \\"HttpStatusCode\\": \\"200\\",\\n \\"Success\\": \\"True\\",\\n \\"Code\\": \\"InvalidInput\\\\n\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', - 'title' => '修改APS数据源', - 'description' => '### 注意事项'."\n" - .'- 该接口仅适用于32核及以上规格的弹性模式集群版（新版）集群。'."\n" - .'- 不支持修改默认资源组USER_DEFAULT的节点数量。', - ], - 'ModifyApsWorkloadName' => [ - 'summary' => '修改APS工作负载名称。', - 'methods' => [ - 'get', - 'post', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid. ', 'description' => ''], + ['errorCode' => 'NotExists', 'errorMessage' => 'The formation task does not exist. ', 'description' => ''], + ['errorCode' => 'NotRunning', 'errorMessage' => 'The instance is not running.', 'description' => ''], + ], + 500 => [ + ['errorCode' => 'ServerStoreError', 'errorMessage' => 'A server storage error occurred.', 'description' => ''], + ], ], - 'schemes' => [ - 'http', - 'https', + 'title' => '停止正在执行的元数据发现任务', + 'summary' => '停掉当前正在执行的元数据发现任务', + 'description' => '仅停正在跑的任务，不停止后续cron调度。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": \\"true\\",\\n \\"RequestId\\": \\"9CCFAAB4-97B7-5800-B9F2-685EB596E3EF\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Success\\"\\n}","type":"json"}]', + ], + 'SubmitResultExportJob' => [ + 'summary' => '调用SubmitResultExportJob接口提交SQL查询并导出结果集。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -41597,290 +29508,206 @@ 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '170156', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsY28JLD', - ], + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '219535', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'>您可以调用[DescribeRegions](~~143074~~)接口查看集群的地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'DBClusterId', 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-*******', - ], + 'schema' => ['description' => 'AnalyticDB MySQL湖仓版（3.0）集群ID。'."\n" + .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查询目标地域中所有AnalyticDB MySQL湖仓版（3.0）集群的集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp10a0ng21t5****'], ], [ - 'name' => 'WorkloadId', + 'name' => 'Engine', 'in' => 'formData', - 'schema' => [ - 'description' => '数据链路任务ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'aps-******', - ], + 'schema' => ['description' => '任务执行的引擎，目前只支持XIHE。', 'type' => 'string', 'required' => false, 'example' => 'XIHE'], ], [ - 'name' => 'WorkloadName', + 'name' => 'ResourceGroup', 'in' => 'formData', - 'schema' => [ - 'description' => '工作负载名。', - 'type' => 'string', - 'required' => true, - 'example' => 'sls-2024***93014', - ], + 'schema' => ['description' => '导出任务执行资源组。', 'type' => 'string', 'required' => false, 'example' => 'user_default'], + ], + [ + 'name' => 'Schema', + 'in' => 'formData', + 'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => true, 'example' => 'tpch_oss'], + ], + [ + 'name' => 'SQL', + 'in' => 'formData', + 'schema' => ['description' => '仅支持执行SELECT语句，其他SQL语句会导致接口调用失败。', 'type' => 'string', 'required' => true, 'example' => 'SELECT * FROM `fotor_com_datastore_resource`.`fotor_ai_create_task` where `date` = \'2023-05-13\' LIMIT 10;'], + ], + [ + 'name' => 'ExportType', + 'in' => 'formData', + 'schema' => ['description' => '导出类型。', 'type' => 'string', 'required' => false, 'example' => 'SLS'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ + 'title' => 'ResultData<?>', + 'description' => '返回详细信息。', 'type' => 'object', 'properties' => [ - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'string', - 'example' => '123', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：调用成功。'."\n" - .'- **false**：调用失败。', - 'type' => 'boolean', - 'example' => 'True', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => 'InvalidInput'."\n", - ], - 'Message' => [ - 'description' => '应用建议执行结果。取值说明：'."\n" - .'- 请求正常，返回**SUCCESS**。 '."\n" - .'- 请求异常，返回具体异常错误信息。', - 'type' => 'string', - 'example' => 'SUCCESS', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：调用成功。'."\n" + .'- **false**：调用失败。', 'type' => 'boolean', 'example' => 'true'], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + .'- 请求正常，返回**OK**。 '."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'OK'], + 'Code' => ['description' => '接口状态或POP错误码。', 'type' => 'string', 'example' => 'InvalidInput'."\n"], + 'Data' => ['description' => '结果集导出任务ID。', 'type' => 'string', 'example' => 'export_202405131927121980210080040****'."\n"], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": \\"123\\",\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\\\n\\",\\n \\"Message\\": \\"SUCCESS\\"\\n}","type":"json"}]', - 'title' => '修改APS工作负载名称', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeApsDatasources' => [ - 'summary' => '查询APS数据源列表。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '提交结果集导出任务', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SubmitResultExportJob'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:SubmitResultExportJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"InvalidInput\\\\n\\",\\n \\"Data\\": \\"export_202405131927121980210080040****\\\\n\\"\\n}","type":"json"}]', + ], + 'SubmitSparkApp' => [ + 'summary' => '提交Spark应用。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'create', 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsY28JLD', - 'FEATUREadsCORDM7', - ], + 'chargeType' => 'paid', + 'abilityTreeCode' => '118686', + 'abilityTreeNodes' => ['FEATUREadsCQJTKP'], ], 'parameters' => [ [ - 'name' => 'PageNumber', + 'name' => 'AppName', 'in' => 'formData', - 'schema' => [ - 'description' => '页数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'docRequired' => true, - 'maximum' => '10000', - 'minimum' => '1', - 'example' => '1', - ], + 'schema' => ['title' => 'Spark App的名称', 'description' => '应用名称，可自定义字符串，长度不能超过64个字符。', 'type' => 'string', 'required' => false, 'example' => 'TestApp'], ], [ - 'name' => 'PageSize', + 'name' => 'AppType', 'in' => 'formData', 'schema' => [ - 'description' => '页大小。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'docRequired' => true, - 'maximum' => '1000', - 'minimum' => '1', - 'example' => '30', + 'title' => 'Spark App的类型, 不填写默认为BATCH 批处理类型', + 'description' => '应用类型，取值说明：'."\n" + .'- **SQL**：SQL应用。'."\n" + .'- **STREAMING**：流应用。'."\n" + .'- **BATCH**（默认值）：离线应用。', + 'type' => 'string', + 'required' => false, + 'example' => 'SQL', + 'default' => 'BATCH', + 'enum' => [], ], ], [ - 'name' => 'RegionId', + 'name' => 'Data', 'in' => 'formData', - 'schema' => [ - 'description' => '区域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['title' => 'Spark App的配置信息, 定义SQL语句或者执行内容', 'description' => '应用模板数据。'."\n" + .'> 应用模板配置，请参见[《Spark应用配置指南》](~~452402~~)。', 'type' => 'string', 'required' => true, 'example' => 'conf spark.driver.resourceSpec=small; conf spark.executor.instances=1; conf spark.executor.resourceSpec=small; conf spark.app.name=TestApp;'], ], [ - 'name' => 'DBClusterId', + 'name' => 'AgentSource', 'in' => 'formData', 'schema' => [ - 'description' => 'ADB实例ID。', + 'title' => '客户端类型', + 'description' => '客户端类型。可自定义字符串，长度不能超过64个字符。', 'type' => 'string', 'required' => false, - 'example' => 'amv-******', + 'example' => 'CONSOLE', + 'default' => 'SDK', + 'enum' => [], ], ], [ - 'name' => 'DatasourceType', + 'name' => 'AgentVersion', 'in' => 'formData', - 'schema' => [ - 'description' => '数据源类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'SLS', - ], + 'schema' => ['title' => '客户端版本', 'description' => '应用程序使用的版本。可自定义字符串，长度不能超过64个字符。', 'type' => 'string', 'required' => false, 'example' => '1.091'], ], [ - 'name' => 'DatasourceName', + 'name' => 'DBClusterId', 'in' => 'formData', - 'schema' => [ - 'description' => '数据源名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['title' => '数据库的id', 'description' => '企业版、基础版或湖仓版集群ID。'."\n" + ."\n" + .'> 您可以调用[DescribeDBClusters](~~454250~~)接口可以查询集群ID。', 'type' => 'string', 'required' => true, 'example' => 'amv-bp11q28kvl688****', 'maxLength' => 64], ], [ - 'name' => 'StartTime', + 'name' => 'ResourceGroupName', 'in' => 'formData', - 'schema' => [ - 'description' => '开始时间。', - 'type' => 'string', - 'required' => false, - 'example' => '2024-01-01', - ], + 'schema' => ['title' => '资源组的名称', 'description' => 'Job型资源组名称。'."\n" + .'> 您可以调用[DescribeDBResourceGroup](~~612410~~)接口查看集群的资源组ID。', 'type' => 'string', 'required' => true, 'example' => 'adb', 'maxLength' => 64], ], [ - 'name' => 'EndTime', + 'name' => 'TemplateFileId', 'in' => 'formData', - 'schema' => [ - 'description' => '结束时间。', - 'type' => 'string', - 'required' => false, - 'example' => '2024-01-30', - ], + 'schema' => ['title' => '模板文件id', 'description' => '应用模板ID。'."\n" + .'> 您可以调用[GetSparkTemplateFullTree](~~456205~~)接口可以查询应用模板ID。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'minimum' => '0', 'exclusiveMinimum' => true, 'example' => '15'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '任务列表。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-5213-******-B608-******', - ], - 'PageNumber' => [ - 'description' => '页数。', - 'type' => 'string', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页的记录数。', - 'type' => 'string', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '返回的结果总数。', - 'type' => 'string', - 'example' => '1', - ], - 'ApsDatasources' => [ - 'description' => '数据源数组。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'DatasourceName' => [ - 'description' => '目标数据源的名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'CreateTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2024-01-10 14:44:33', - ], - 'DatasourceType' => [ - 'description' => '数据源类型。', - 'type' => 'string', - 'example' => 'SLS', - ], - 'DatasourceDescription' => [ - 'description' => '数据源描述。', - 'type' => 'string', - 'example' => 'test', - ], - 'DatasourceId' => [ - 'description' => '数据源ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'HasJob' => [ - 'description' => '是否有任务在使用这个数据源。', - 'type' => 'boolean', - 'example' => 'false', - ], - ], - 'example' => '-', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Data' => [ + 'description' => '数据列表。', + 'type' => 'object', + 'properties' => [ + 'AppId' => ['title' => 'Spark App的id', 'description' => '应用ID。', 'type' => 'string', 'example' => 's202204132018hzprec1ac61a000****'], + 'AppName' => ['title' => 'spark app的名称', 'description' => '应用名称。', 'type' => 'string', 'example' => 'TestApp'], + 'Message' => ['title' => '备注信息', 'description' => '返回告警信息，如任务执行失败或资源不足等，无告警时则返回为空。', 'type' => 'string', 'example' => 'Insufficient resources.'], + 'State' => ['title' => 'spark app的状态', 'description' => '应用执行状态，取值说明：'."\n" + .'- **SUBMITTED**：已提交。'."\n" + .'- **STARTING**：开始启动。'."\n" + .'- **RUNNING**：执行中。'."\n" + .'- **FAILING**：任务失败，清理环境中。'."\n" + .'- **FAILED**：失败。'."\n" + .'- **KILLING**：中止任务，清理环境中。'."\n" + .'- **KILLED**：中止任务。'."\n" + .'- **SUCCEEDING**：任务执行结束，清理环境中。'."\n" + .'- **COMPLETED**：任务执行结束。'."\n" + .'- **FATAL**：意外失败。'."\n" + .'- **UNKNOWN**：未知错误。', 'type' => 'string', 'example' => 'SUBMITTED'], ], - 'example' => '-', ], ], ], @@ -41888,176 +29715,246 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidInput', - 'errorMessage' => 'The specified parameter is invalid.', - ], + ['errorCode' => 'Spark.App.ExceedQuotaLimitation', 'errorMessage' => 'The requested resource exceeds the maximum limit: %s', 'description' => ''], + ['errorCode' => 'Spark.App.InvalidAppTypeWhenSubmit', 'errorMessage' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', 'description' => 'AppType类型不合法，请参考使用文档指定适合业务的AppType，请关注配置类型：%s。'], + ['errorCode' => 'Spark.App.InvalidResourceSpec', 'errorMessage' => 'The requested resource type is not supported:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ParameterConflict', 'errorMessage' => 'Conflicting parameters submitted:\\n %s', 'description' => ''], + ['errorCode' => 'Spark.App.ResourceNegativeError', 'errorMessage' => 'The requested resource MUST be positive: %s', 'description' => ''], + ['errorCode' => 'Spark.Config.InvalidAppFilePath', 'errorMessage' => 'The main driver file MUST be a valid OSS path. Current is %s.', 'description' => '主驱动文件地址必须是合法的OSS地址，当前的地址是 %s。'], + ['errorCode' => 'Spark.Config.invalidConnectors', 'errorMessage' => 'The spark.adb.connectors configuration is invalid: %s', 'description' => 'spark.adb.connectors配置不正确。'], + ['errorCode' => 'Spark.Config.InvalidDiskConfig', 'errorMessage' => 'The requested disk mount parameter is invalid: %s', 'description' => '磁盘挂载配置错误。'], + ['errorCode' => 'Spark.Config.InvalidHostAliasConfig', 'errorMessage' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', 'description' => '域名映射配置错误。'], + ['errorCode' => 'Spark.Config.InvalidLogOssPath', 'errorMessage' => 'The OSS address for log storage is illegal: %s', 'description' => '存储日志的OSS地址非法。'], + ['errorCode' => 'Spark.Config.InvalidRoleArnFormat', 'errorMessage' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', 'description' => '配置的RoleARN格式错误。'], + ['errorCode' => 'Spark.Config.InvalidTimeZone', 'errorMessage' => 'Unable to parse time zone configuration %s : %s', 'description' => '时区配置错误。'], + ['errorCode' => 'Spark.Config.MainAppFileNotExists', 'errorMessage' => 'The main driver file is missing, [file] or [sqls] must be configured.', 'description' => '主驱动文件缺失，必须保证file或者sqls配置不为空。'], + ['errorCode' => 'Spark.Config.OSSPathAccessError', 'errorMessage' => 'The configured OSS address %s cannot be accessed.', 'description' => '配置的OSS路径无法访问。'], + ['errorCode' => 'Spark.Config.OSSPathNotExists', 'errorMessage' => 'The OSS address %s requested does not exist or the permissions are insufficient.', 'description' => 'OSS路径不存在或当前用户无权限访问。'], + ['errorCode' => 'Spark.Config.RoleArnVerifyFailed', 'errorMessage' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'description' => 'RoleARN参数校验失败。'], + ['errorCode' => 'Spark.Config.SecurityGroupNotFound', 'errorMessage' => 'The security group in the configuration does not exist or cannot be accessed. %s.', 'description' => '配置的资源组不存在或者因权限不足无法访问。%s。'], + ['errorCode' => 'Spark.Config.VswitchNotFound', 'errorMessage' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', 'description' => '无法找到配置虚拟机交换机，或当前账号权限不足。%s。'], + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.RoleArn.Invalid', 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', 'description' => 'RoleArn不存在或子账号未授权。'], + ['errorCode' => 'Spark.SQL.BlankError', 'errorMessage' => 'Input sql can not be blank string.', 'description' => '提交SQL不能为空。'], + ['errorCode' => 'Spark.SQL.MultipleSQLError', 'errorMessage' => 'Element in field [sqls] can not contain more than one sql statement: %s.', 'description' => '提交的Spark SQL包含了多条可执行SQL。'], + ['errorCode' => 'Spark.SQL.NotFoundExecutableSQLError', 'errorMessage' => 'No executable statements are submitted. Please check the input SQL.', 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['errorCode' => 'Spark.SQL.ParserError', 'errorMessage' => 'Submit spark app failed when parser SQL %s. Error message: %s.', 'description' => '解析提交的Spark SQL失败。'], + ['errorCode' => 'Spark.RoleARN.invalid', 'errorMessage' => 'Current account fails to verify the permissions of the RAM system, please check the help information and configure the appropriate permissions for the current account.', 'description' => '请确保您当前的 RAM 用户 （ram_user_id %s） 已被授予系统策略“AliyunADBDeveloperAccess”。然后按照“在阿里云帐户内执行授权”部分进行作。这将自动初始化您的云帐户中名为“aliyunadbsparkprocessingdatarole”的系统角色。更多详细信息：https://www.alibabacloud.com/help/en/analyticdb/analyticdb-for-mysql/user-guide/create-the-aliyunadbsparkprocessingdatarole-role-for-a-ram-user-and-grant-permissions-to-the-role'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.App.ContentNotFound', 'errorMessage' => 'The requested content %s of the Spark application is not found.', 'description' => '找不到指定Spark作业的提交内容。'], + ['errorCode' => 'Spark.App.NotFound', 'errorMessage' => 'The Spark application %s is not found.', 'description' => '未能找到输入的 Spark App。'], + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '提交Spark应用', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2025-05-27T07:29:50.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2024-06-11T03:28:06.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-07-27T02:58:13.000Z', 'description' => '错误码发生变更、响应参数发生变更'], + ['createdAt' => '2023-06-28T01:10:40.000Z', 'description' => '请求参数发生变更'], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-5213-******-B608-******\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"PageSize\\": \\"30\\",\\n \\"TotalCount\\": \\"1\\",\\n \\"ApsDatasources\\": [\\n {\\n \\"DatasourceName\\": \\"test\\",\\n \\"CreateTime\\": \\"2024-01-10 14:44:33\\",\\n \\"DatasourceType\\": \\"SLS\\",\\n \\"DatasourceDescription\\": \\"test\\",\\n \\"DatasourceId\\": 1,\\n \\"HasJob\\": false\\n }\\n ]\\n}","type":"json"}]', - 'title' => '查询APS数据源列表', - ], - 'CreateApsHiveJob' => [ - 'summary' => '创建APS Hive任务。', - 'methods' => [ - 'post', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SubmitSparkApp'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:SubmitSparkApp', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'SparkApplication', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"AppId\\": \\"s202204132018hzprec1ac61a000****\\",\\n \\"AppName\\": \\"TestApp\\",\\n \\"Message\\": \\"Insufficient resources.\\",\\n \\"State\\": \\"SUBMITTED\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<SubmitSparkAppResponse>\\n <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>\\n <Data>\\n <AppId>s202204132018hzprec1ac61a000****</AppId>\\n <AppName>TestApp</AppName>\\n <Message>Insufficient resources.</Message>\\n <State>SUBMITTED</State>\\n </Data>\\n</SubmitSparkAppResponse>","errorExample":""}]', + ], + 'SubmitSparkLogAnalyzeTask' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - 'abilityTreeCode' => '170254', - 'abilityTreeNodes' => [ - 'FEATUREadsBIVU9O', - ], - ], + 'systemTags' => ['operationType' => 'create'], 'parameters' => [ [ - 'name' => 'DBClusterId', + 'name' => 'AppId', 'in' => 'formData', - 'schema' => [ - 'description' => 'AnalyticDB for MySQL集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-****', - ], + 'schema' => ['title' => 'Spark App ID'."\n", 'description' => 'Spark应用ID。'."\n", 'type' => 'string', 'required' => true, 'example' => 's202301121553hzd9c6f7xxxx'], ], - [ - 'name' => 'RegionId', - 'in' => 'formData', + ], + 'responses' => [ + 200 => [ + 'headers' => [], 'schema' => [ - 'description' => '运维事件所在地域的地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-beijing', + 'title' => 'Schema of Response', + 'description' => '返回结果。', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1DF5AF5B-C803-1861-A0FF-63666A557709'], + 'Data' => ['description' => 'Spark日志分析任务详情。', '$ref' => '#/components/schemas/SparkAnalyzeLogTask'], + ], ], ], - [ - 'name' => 'WorkloadName', - 'in' => 'formData', - 'schema' => [ - 'description' => '工作负载名。', - 'type' => 'string', - 'required' => true, - 'example' => 'xxx-20240224100253', - ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.AnalyzeTask.AppStateNotAccepted', 'errorMessage' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '只允许分析处于终止状态的 Spark app。指定 app 不满足条件。'], + ['errorCode' => 'Spark.AnalyzeTask.FailedToKill', 'errorMessage' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', 'description' => '杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。'], + ['errorCode' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', 'errorMessage' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'description' => '仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。'], ], - [ - 'name' => 'ResourceGroup', - 'in' => 'formData', - 'schema' => [ - 'description' => '资源组名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'user_default', - ], + 404 => [ + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ['errorCode' => 'Spark.AnalyzeTask.NotFound', 'errorMessage' => 'The requested analysis task %s is not found.', 'description' => '请求查看的日志分析任务 %s 不存在。'], ], - [ - 'name' => 'FullComputeUnit', - 'in' => 'formData', - 'schema' => [ - 'description' => '迁移所需acu数。', - 'type' => 'string', - 'required' => true, - 'example' => '16', - ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '提交Spark日志分析任务', + 'summary' => '提交一个Spark日志分析任务,，服务端会开启指定Spark作业日志的分析流程并返回分析结果。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-06-28T01:10:26.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SubmitSparkLogAnalyzeTask'], + ], + ], + 'ramActions' => [ [ - 'name' => 'DatasourceId', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据源ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '40', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:SubmitSparkLogAnalyzeTask', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1DF5AF5B-C803-1861-A0FF-63666A557709\\",\\n \\"Data\\": {\\n \\"TaskId\\": 10,\\n \\"UserId\\": 0,\\n \\"SubmittedTimeInMillis\\": 1672123543000,\\n \\"TerminatedTimeInMillis\\": 1672123543000,\\n \\"TaskState\\": \\"WAITING\\",\\n \\"Result\\": {\\n \\"AppErrorCode\\": \\"EXCEEDED_QUOTA\\",\\n \\"AppErrorLog\\": \\"exception: cpu is exceeded limits 12/10\\",\\n \\"AppErrorAdvice\\": \\"Please increase cpu quota for your resource group\\"\\n },\\n \\"StartedTimeInMillis\\": 1672123543000,\\n \\"RuleMatched\\": true,\\n \\"TaskErrMsg\\": \\"Driver log not found\\",\\n \\"DBClusterId\\": \\"amv-adbxxxxx\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<SubmitSparkLogAnalyzeTaskResponse>\\n <RequestId>xxx-xxx-xxxx</RequestId>\\n <Data>\\n <TaskId>10</TaskId>\\n <SubmittedTimeInMillis>1672123543000</SubmittedTimeInMillis>\\n <TerminatedTimeInMillis>1672123543000</TerminatedTimeInMillis>\\n <TaskState>WAITING</TaskState>\\n <Result>\\n <AppErrorCode>EXCEEDED_QUOTA</AppErrorCode>\\n <AppErrorLog>exception: xxxx</AppErrorLog>\\n </Result>\\n <StartedTimeInMillis>1672123543000</StartedTimeInMillis>\\n <RuleMatched>true</RuleMatched>\\n <TaskErrMsg>Driver log not found</TaskErrMsg>\\n </Data>\\n</SubmitSparkLogAnalyzeTaskResponse>","errorExample":""}]', + ], + 'SuspendApsJob' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'SyncAllowExpression', - 'in' => 'formData', - 'schema' => [ - 'description' => '允许同步对象的表达式。', - 'type' => 'string', - 'required' => false, - 'example' => '*', - ], + 'AK' => [], ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '183067', + 'abilityTreeNodes' => ['FEATUREadsY28JLD', 'FEATUREads1II0UT'], + ], + 'parameters' => [ [ - 'name' => 'SyncDenyExpression', + 'name' => 'RegionId', 'in' => 'formData', - 'schema' => [ - 'description' => '允许同步对象的表达式。', - 'type' => 'string', - 'required' => false, - 'example' => 'abc', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'TargetType', + 'name' => 'ApsJobId', 'in' => 'formData', + 'schema' => ['description' => '任务ID。', 'type' => 'string', 'required' => true, 'example' => 'aps-bj1xxxxxx'], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '目标端类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'OSS', + 'type' => 'object', + 'properties' => [ + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'ApsJobId' => ['description' => '任务ID。', 'type' => 'string', 'example' => 'aps-bj1xxxxxx'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '******-3EEC-******-9F06-******'], + 'Success' => ['description' => '请求是否成功。取值说明：'."\n" + .'- **True**：成功。'."\n" + .'- **False**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'ErrCode' => ['description' => '调用出错时返回的错误码。'."\n", 'type' => 'string', 'example' => 'Success'], + 'ErrMessage' => ['description' => '调用错误时返回的错误信息。'."\n", 'type' => 'string', 'example' => 'OK'], + ], + 'description' => '', ], ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '暂停APS任务', + 'summary' => '暂停APS任务。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SuspendApsJob'], + ], + ], + 'ramActions' => [ [ - 'name' => 'OssLocation', - 'in' => 'formData', - 'schema' => [ - 'description' => '目的端湖仓地址，完整OSS路径。', - 'type' => 'string', - 'required' => true, - 'example' => 'oss://test-test*/*0516/', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:SuspendApsJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"ApsJobId\\": \\"aps-bj1xxxxxx\\",\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Success\\": true,\\n \\"ErrCode\\": \\"Success\\",\\n \\"ErrMessage\\": \\"OK\\"\\n}","type":"json"}]', + ], + 'UnbindAccount' => [ + 'summary' => '解绑RAM用户与集群的数据库普通账号。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ [ - 'name' => 'ConflictStrategy', - 'in' => 'formData', - 'schema' => [ - 'description' => '目的端存在同名库表处理策略。', - 'type' => 'string', - 'required' => false, - 'example' => 'Intercept：报错拦截，暂停迁移'."\n" - .'Ignore：忽略并继续执行，仍然迁移相关库表'."\n" - .'Skip：跳过相关库表，只迁移其他库表', - ], + 'AK' => [], ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'update'], + 'parameters' => [ [ - 'name' => 'AdvancedConfig', - 'in' => 'formData', - 'schema' => [ - 'description' => '高级配置。', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-wz99d9nh5****'], ], [ - 'name' => 'Parallelism', - 'in' => 'formData', - 'schema' => [ - 'description' => '并行任务数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '8', - ], + 'name' => 'AccountName', + 'in' => 'query', + 'schema' => ['description' => '数据库账号。'."\n" + .'> 您可以调用[DescribeAccounts](~~612430~~)接口查看指定集群的数据库账号信息，包括数据库账号。', 'type' => 'string', 'required' => true, 'example' => 'test_accout'], ], ], 'responses' => [ @@ -42067,197 +29964,125 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '2895BB82-B2C1-408E-AA73-DB8D59******', - ], - 'Data' => [ - 'description' => '工作负载返回数据。', - 'type' => 'string', - 'example' => '-', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'string', - 'example' => '200', - ], - 'Success' => [ - 'description' => '请求是否成功。取值说明：'."\n" - .'- **True**：成功。'."\n" - .'- **False**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => 'InvalidInput', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回Success。'."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '93E85E5C-C805-5837-8713-05B69A504EE5'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidAccountName.Malformed', 'errorMessage' => 'The specified parameter AccountName is not valid.', 'description' => 'AccountName不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2895BB82-B2C1-408E-AA73-DB8D59******\\",\\n \\"Data\\": \\"-\\",\\n \\"HttpStatusCode\\": \\"200\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Message\\": \\"Success\\"\\n}","type":"json"}]', - 'title' => '创建APS Hive任务', + 'title' => '解绑RAM用户与数据库账号', 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeApsProgress' => [ - 'summary' => '查询APS进度。', - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2023-03-31T07:03:59.000Z', 'description' => '错误码发生变更'], + ['createdAt' => '2022-06-11T16:51:57.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'UnbindAccount'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:UnbindAccount', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"93E85E5C-C805-5837-8713-05B69A504EE5\\"\\n}","errorExample":""},{"type":"xml","example":"<UnbindAccountResponse>\\n <RequestId>93E85E5C-C805-5837-8713-05B69A504EE5</RequestId>\\n</UnbindAccountResponse>","errorExample":""}]', + ], + 'UnbindDBResourceGroupWithUser' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', + 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeCode' => '171313', - 'abilityTreeNodes' => [ - 'FEATUREadsH8FO36', - ], + 'abilityTreeNodes' => ['FEATUREadsYXZ2UA'], ], 'parameters' => [ [ 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '实例ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-******', - ], + 'in' => 'query', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1ub9grke1****'], ], [ - 'name' => 'WorkloadId', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据链路任务ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'aps-******', - ], + 'name' => 'GroupName', + 'in' => 'query', + 'schema' => ['description' => '资源组名称。', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'name' => 'GroupUser', + 'in' => 'query', + 'schema' => ['description' => '解绑的数据库账号。', 'type' => 'string', 'required' => false, 'example' => 'user1'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'TotalTableCount' => [ - 'description' => '表总数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'SuccessTableCount' => [ - 'description' => '成功迁移表总数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'SuccessPercentage' => [ - 'description' => '成功百分比。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '100', - ], - 'ApsHiveProgress' => [ - 'description' => '迁移进度。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'DbName' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'TbName' => [ - 'description' => '表名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'Progress' => [ - 'description' => '进度。', - 'type' => 'string', - 'example' => '95', - ], - 'Speed' => [ - 'description' => '迁移速度。', - 'type' => 'string', - 'example' => '2', - ], - ], - 'example' => '-', - ], - 'example' => '-', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidInput', - 'errorMessage' => 'The specified parameter is invalid.', - ], + ['errorCode' => 'InvalidPoolName.Malformed', 'errorMessage' => 'The specified parameter PoolName is not valid.', 'description' => 'PoolName参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidPoolUser.Malformed', 'errorMessage' => 'The specified parameter PoolUser is not valid.', 'description' => 'PoolUser参数不正确，请确认参数是否符合规范。'], + ['errorCode' => 'InvalidDBClusterId.NotFound', 'errorMessage' => 'The DBClusterId provided does not exist in our records.', 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['errorCode' => 'InvalidDBClusterId.Malformed', 'errorMessage' => 'The specified parameter DBClusterId is not valid.', 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"TotalTableCount\\": 10,\\n \\"SuccessTableCount\\": 10,\\n \\"SuccessPercentage\\": 100,\\n \\"ApsHiveProgress\\": [\\n {\\n \\"DbName\\": \\"test\\",\\n \\"TbName\\": \\"test\\",\\n \\"Progress\\": \\"95\\",\\n \\"Speed\\": \\"2\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '查询APS进度', - ], - 'DeleteApsDatasoure' => [ - 'summary' => '删除APS数据源。', - 'methods' => [ - 'get', - 'post', + 'title' => '解绑资源组和用户', + 'summary' => '为AnalyticDB MySQL集群的资源组解绑数据库账号。', + 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'UnbindDBResourceGroupWithUser'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:UnbindDBResourceGroupWithUser', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', + ], + 'UpdateApsWebhook' => [ + 'path' => '', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -42267,41 +30092,41 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', - 'abilityTreeCode' => '168866', - 'abilityTreeNodes' => [ - 'FEATUREadsQO9FPM', - ], + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREads1II0UT', 'FEATUREadsBIVU9O', 'FEATUREadsY28JLD'], ], 'parameters' => [ [ 'name' => 'DBClusterId', 'in' => 'formData', - 'schema' => [ - 'description' => 'ADB实例ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-******', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'exampleDBClusterId'], ], [ 'name' => 'RegionId', 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'exampleRegionId'], ], [ - 'name' => 'DatasourceId', + 'name' => 'Webhook', 'in' => 'formData', + 'style' => 'json', 'schema' => [ - 'description' => '数据源ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1', + 'description' => 'Webhook数组。', + 'type' => 'array', + 'items' => [ + 'description' => 'Webhook数组。', + 'type' => 'object', + 'properties' => [ + 'WebhookId' => ['description' => 'Webhook ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '**355****'], + 'Url' => ['description' => '请求地址。', 'type' => 'string', 'required' => false, 'example' => 'https://example.com/webhook'], + 'Key' => ['description' => '加签密钥。', 'type' => 'string', 'required' => false, 'example' => 'ABC**'], + 'WebhookType' => ['description' => '通知方式。 dingtalk：钉钉。 lark：飞书。', 'type' => 'string', 'required' => false, 'example' => 'dingtalk'], + 'Name' => ['description' => 'Webhook名称。', 'type' => 'string', 'required' => false, 'example' => 'exampleWebhookName'], + ], + 'required' => false, + ], + 'required' => false, ], ], ], @@ -42312,441 +30137,165 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'FAE98A4F-****-****-BF6D-67EEAC9C39DE', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'string', - 'example' => '7', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP状态码。'."\n", - 'type' => 'string', - 'example' => '200', - ], - 'Success' => [ - 'description' => '请求是否成功。取值说明：'."\n" - .'- **True**：成功。'."\n" - .'- **False**：失败。', - 'type' => 'string', - 'example' => 'True', - ], - 'Code' => [ - 'description' => '返回码。', - 'type' => 'string', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常信息。', - 'type' => 'string', - 'example' => 'OK', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。'."\n", 'type' => 'string', 'example' => 'exampleRequestId'], + 'Data' => ['description' => '返回数据。', 'type' => 'string', 'example' => '-'], + 'HttpStatusCode' => ['description' => 'http状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Message' => ['description' => '返回消息。', 'type' => 'string', 'example' => 'Operation succeeded'], + 'DBClusterId' => ['description' => '集群ID。', 'type' => 'string', 'example' => 'amv-bp11q28kvl688****'], + 'Code' => ['description' => '返回结果编码。', 'type' => 'string', 'example' => '200'], + 'Success' => ['description' => '是否成功。', 'type' => 'boolean', 'example' => 'true'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FAE98A4F-****-****-BF6D-67EEAC9C39DE\\",\\n \\"Data\\": \\"7\\",\\n \\"HttpStatusCode\\": \\"200\\",\\n \\"Success\\": \\"True\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', - 'title' => '删除APS数据源', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'DescribeApsJobs' => [ - 'summary' => '查询APS任务列表。', - 'methods' => [ - 'post', - 'get', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '更新Webhook配置', + 'summary' => '用于更新指定数据库集群的Webhook配置信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'UpdateApsWebhook'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:UpdateApsWebhook', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"exampleRequestId\\",\\n \\"Data\\": \\"-\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"Operation succeeded\\",\\n \\"DBClusterId\\": \\"amv-bp11q28kvl688****\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": true\\n}","type":"json"}]', + ], + 'UpdateFormationCrawler' => [ + 'summary' => '更新元数据发现任务信息', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', - 'abilityTreeCode' => '180030', - 'abilityTreeNodes' => [ - 'FEATUREadsH8FO36', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '138505', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], ], 'parameters' => [ [ - 'name' => 'PageNumber', - 'in' => 'formData', - 'schema' => [ - 'description' => '页数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'docRequired' => true, - 'maximum' => '10000', - 'minimum' => '1', - 'example' => '1', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'formData', - 'schema' => [ - 'description' => '每页大小。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'docRequired' => true, - 'maximum' => '1000', - 'minimum' => '1', - 'example' => '30', - ], - ], - [ 'name' => 'RegionId', 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', - ], + 'schema' => ['description' => '地域ID。'."\n" + .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-beijing'], ], [ - 'name' => 'CreateTimeStart', + 'name' => 'CrawlerInfo', 'in' => 'formData', - 'schema' => [ - 'description' => '起始创建时间。', - 'type' => 'string', - 'required' => false, - 'example' => '2022-03-23T01:10Z', - ], + 'schema' => ['description' => 'Crawler 完整配置信息的 JSON 字符串。此字段为最核心参数，其内部 JSON 结构详见 CrawlerInfo 结构定义 章节。', 'type' => 'string', 'required' => true, 'example' => '{"sourceType":"OSSWAREHOUSE","dbName":"sales_db","sourceInfo":{"ossSourceInfo":{"sourceMode":"WAREHOUSE","ossLocations":"oss://test-bucket/***/***/","inclusions":[],"exclusions":[]}},"classifiers":"[]","frequency":{"type":"run_on_demand","cron":""},"configuration":"","schemaChangePolicy":{"updateRule":"ONLY_ADD_COLUMN","deleteRule":"IGNORE"}}'], ], [ - 'name' => 'CreateTimeEnd', + 'name' => 'DBClusterId', 'in' => 'formData', - 'schema' => [ - 'description' => '截止创建时间。', - 'type' => 'string', - 'required' => false, - 'example' => '2022-04-23T01:10Z', - ], + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1r053byu48p****'], ], [ - 'name' => 'ApsJobName', + 'name' => 'CrawlerTaskId', 'in' => 'formData', - 'schema' => [ - 'description' => '任务名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'aps-xxxxx', - ], + 'schema' => ['description' => '任务ID。', 'type' => 'string', 'required' => false, 'example' => '21'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-7F9D-5DBD-993E-******', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'string', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页记录数。', - 'type' => 'string', - 'example' => '30', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '0', - ], - 'APSJobs' => [ - 'description' => '任务列表。', - 'type' => 'array', - 'items' => [ - 'description' => '-', - 'type' => 'object', - 'properties' => [ - 'Status' => [ - 'description' => '任务状态。', - 'type' => 'string', - 'example' => '-', - ], - 'ApsJobName' => [ - 'description' => '任务名称。', - 'type' => 'string', - 'example' => 'data-sync-******', - ], - 'DestinationInstanceID' => [ - 'description' => '目标端实例ID。', - 'type' => 'string', - 'example' => 'amv-*******', - ], - 'SourceInstanceID' => [ - 'description' => '源端实例ID。', - 'type' => 'string', - 'example' => 'pc-******', - ], - 'Delay' => [ - 'description' => '同步延迟时间。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'CreateTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '2022-06-28 15:00:04', - ], - 'Projress' => [ - 'description' => '进展。', - 'type' => 'string', - 'example' => '30 ：进度 30%', - ], - 'ApsJobId' => [ - 'description' => '任务ID。', - 'type' => 'string', - 'example' => 'aps-******', - ], - 'SubStatus' => [ - 'description' => '子任务状态。', - 'type' => 'string', - 'example' => '-', - ], - 'ErrMessage' => [ - 'description' => '错误信息。', - 'type' => 'string', - 'example' => 'OK', - ], - ], - 'example' => '-', - ], - 'example' => '-', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'True', - ], - 'Code' => [ - 'description' => '后端错误码。', - 'type' => 'string', - 'example' => 'ok', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'OK', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => 'ok', - ], + 'HttpStatusCode' => ['description' => 'HTTP状态码。'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '请求是否处理成功。', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '状态码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + ."\n" + .'- 请求正常，返回OK。'."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'OK'], + 'TaskId' => ['description' => '任务ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '15'], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidInput', - 'errorMessage' => 'The specified parameter is invalid.', - ], + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid. ', 'description' => ''], + ['errorCode' => 'NotExists', 'errorMessage' => 'The formation task does not exist. ', 'description' => ''], + ], + 500 => [ + ['errorCode' => 'ServerStoreError', 'errorMessage' => 'A server storage error occurred.', 'description' => ''], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '更新元数据发现任务信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-7F9D-5DBD-993E-******\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"PageSize\\": \\"30\\",\\n \\"TotalCount\\": \\"0\\",\\n \\"APSJobs\\": [\\n {\\n \\"Status\\": \\"-\\",\\n \\"ApsJobName\\": \\"data-sync-******\\",\\n \\"DestinationInstanceID\\": \\"amv-*******\\",\\n \\"SourceInstanceID\\": \\"pc-******\\",\\n \\"Delay\\": 0,\\n \\"CreateTime\\": \\"2022-06-28 15:00:04\\",\\n \\"Projress\\": \\"30 ：进度 30%\\",\\n \\"ApsJobId\\": \\"aps-******\\",\\n \\"SubStatus\\": \\"-\\",\\n \\"ErrMessage\\": \\"OK\\"\\n }\\n ],\\n \\"Success\\": true,\\n \\"Code\\": \\"ok\\",\\n \\"Message\\": \\"OK\\",\\n \\"HttpStatusCode\\": 0\\n}","type":"json"}]', - 'title' => '查询APS任务列表', + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": true,\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\",\\n \\"TaskId\\": 15\\n}","type":"json"}]', ], - 'DescribeApsActionLogs' => [ - 'summary' => '查询集群实时数据接入任务的日志详细信息。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'UpdateFormationCrawlerScheduleState' => [ + 'summary' => '暂停 / 恢复元数据发现周期调度', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '154388', - 'abilityTreeNodes' => [ - 'FEATUREads1II0UT', - 'FEATUREadsY28JLD', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '138507', + 'abilityTreeNodes' => ['FEATUREadsCORDM7'], ], 'parameters' => [ [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '<props="china">企业版、基础版或湖仓版的集群ID。</props>'."\n" - .'<props="intl">湖仓版集群ID。</props>'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~454250~~)接口查看集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp1r053byu48p****', - ], - ], - [ 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。'."\n" - ."\n" - .'> 您可以调用[DescribeRegions](~~454314~~)接口查看地域ID。'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'StartTime', - 'in' => 'query', - 'schema' => [ - 'description' => '日志的开始时间，格式：**yyyy-MM-ddTHH:mmZ**（UTC时间）。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2023-02-11T08:30Z', - ], - ], - [ - 'name' => 'EndTime', - 'in' => 'query', - 'schema' => [ - 'description' => '日志的结束时间，格式：**yyyy-MM-ddTHH:mmZ**（UTC时间）。'."\n" - ."\n" - .'> 查询日志时，结束时间需大于开始时间，且与开始时间最大间隔不超过30天。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '2023-02-11T09:30Z', - ], - ], - [ - 'name' => 'WorkloadId', - 'in' => 'query', - 'schema' => [ - 'description' => '数据链路任务ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'aps-hz109vpvt4fg8528d****', - ], - ], - [ - 'name' => 'Keyword', - 'in' => 'query', - 'schema' => [ - 'description' => '查询的关键字。在日志查询时模糊匹配。', - 'type' => 'string', - 'required' => false, - 'example' => 'table_test', - ], + 'in' => 'formData', + 'schema' => ['description' => '地域ID。'."\n" + .'>您可以调用[DescribeRegions](~~143074~~)接口查看集群的地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'Stage', - 'in' => 'query', - 'schema' => [ - 'description' => '任务阶段。取值：'."\n" - ."\n" - .'- **StructureMigrate**：结构迁移。'."\n" - .'- **FullDataSync**：全量同步。'."\n" - .'- **IncrementalSync**：增量同步。'."\n" - ."\n" - .'> 未指定该参数时，默认查询所有的任务阶段。', - 'type' => 'string', - 'required' => false, - 'example' => 'FullDataSync', - ], + 'name' => 'CrawlerTaskName', + 'in' => 'formData', + 'schema' => ['description' => 'crawlertask名称。', 'type' => 'string', 'required' => true, 'example' => 'test-crawler-dbname'], ], [ - 'name' => 'State', - 'in' => 'query', - 'schema' => [ - 'description' => '日志类型。多个日志类型用英文逗号（,）分隔。取值：'."\n" - ."\n" - .'- **INFO**：信息。'."\n" - .'- **WARN**：警告。'."\n" - .'- **ERROR**：错误。'."\n" - ."\n" - .'> 未指定该参数时，默认查询所有的日志类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'INFO,WARN,ERROR', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['description' => '集群ID。', 'type' => 'string', 'required' => true, 'example' => 'am-bp1565u55p32****'], ], [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页的记录数。取值：'."\n" - ."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '10', - 'example' => '30', - 'default' => '10', - ], + 'name' => 'ScheduleState', + 'in' => 'formData', + 'schema' => ['description' => '调度状态。'."\n" + ."\n" + .'- 恢复：NORMAL'."\n" + ."\n" + .'- 暂停：DISABLED', 'type' => 'string', 'required' => true, 'example' => 'DISABLED'], ], [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '页码。取值为大于0且不超过Integer数据类型的正整数。默认值为1。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '2147483647', - 'minimum' => '1', - 'example' => '1', - ], + 'name' => 'CrawlerTaskId', + 'in' => 'formData', + 'schema' => ['description' => '任务ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '247'], ], ], 'responses' => [ @@ -42754,113 +30303,39 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A5EDBA27-AF3E-5966-9503-FD1557E19167', - ], - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp1r053byu48p****', - ], - 'WorkloadId' => [ - 'description' => '数据链路任务ID。', - 'type' => 'string', - 'example' => 'aps-hz109vpvt4fg8528d****', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'string', - 'example' => '3', - ], - 'PageSize' => [ - 'description' => '每页的记录数。', - 'type' => 'string', - 'example' => '30', - ], - 'PageNumber' => [ - 'description' => '页码。', - 'type' => 'string', - 'example' => '1', - ], - 'ActionLogs' => [ - 'description' => '日志列表。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Time' => [ - 'description' => '日志时间。格式：**yyyy-MM-ddTHH:mm:ssZ**（UTC时间）。', - 'type' => 'string', - 'example' => '2023-02-01T05:46:30Z', - ], - 'Stage' => [ - 'description' => '任务阶段。取值：'."\n" - ."\n" - .'- **StructureMigrate**：结构迁移。'."\n" - .'- **FullDataSync**：全量同步。'."\n" - .'- **IncrementalSync**：增量同步。', - 'type' => 'string', - 'example' => 'FullDataSync', - ], - 'State' => [ - 'description' => '日志类型。多个日志类型用英文逗号（,）分隔。取值：'."\n" - ."\n" - .'- **INFO**：信息。'."\n" - .'- **WARN**：警告。'."\n" - .'- **ERROR**：错误。', - 'type' => 'string', - 'example' => 'INFO,WARN,ERROR', - ], - 'Context' => [ - 'description' => '日志的内容。', - 'type' => 'string', - 'example' => 'DDL migration job finished', - ], - ], - ], - ], - 'AccessDeniedDetail' => [ - 'description' => '访问被拒绝详细信息。', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => '{'."\n" - .' "AuthAction": "xxx",'."\n" - .' "AuthPrincipalDisplayName": "sampleName",'."\n" - .' "AuthPrincipalOwnerId": "111111111111111111",'."\n" - .' "AuthPrincipalType": "SubUser",'."\n" - .' "AuthResource": "xxx",'."\n" - .' "NoPermissionType": "xxx",'."\n" - .' "PolicyType": "xxx"'."\n" - .'}', - ], + 'HttpStatusCode' => ['description' => 'http状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Data' => ['description' => '结果。', 'type' => 'boolean', 'example' => 'true'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '642F3512-C628-5D0C-8815-F6670CEA00D4'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '状态码。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '提示信息，成功时为 OK。', 'type' => 'string', 'example' => 'OK'], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidDBCluster.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', - ], + 400 => [ + ['errorCode' => 'InvalidInput', 'errorMessage' => 'The specified parameter is invalid. ', 'description' => ''], + ['errorCode' => 'NotExists', 'errorMessage' => 'The formation task does not exist. ', 'description' => ''], + ], + 500 => [ + ['errorCode' => 'ServerStoreError', 'errorMessage' => 'A server storage error occurred.', 'description' => ''], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A5EDBA27-AF3E-5966-9503-FD1557E19167\\",\\n \\"DBClusterId\\": \\"amv-bp1r053byu48p****\\",\\n \\"WorkloadId\\": \\"aps-hz109vpvt4fg8528d****\\",\\n \\"TotalCount\\": \\"3\\",\\n \\"PageSize\\": \\"30\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"ActionLogs\\": [\\n {\\n \\"Time\\": \\"2023-02-01T05:46:30Z\\",\\n \\"Stage\\": \\"FullDataSync\\",\\n \\"State\\": \\"INFO,WARN,ERROR\\",\\n \\"Context\\": \\"DDL migration job finished\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": \\"{\\\\n \\\\\\"AuthAction\\\\\\": \\\\\\"xxx\\\\\\",\\\\n \\\\\\"AuthPrincipalDisplayName\\\\\\": \\\\\\"sampleName\\\\\\",\\\\n \\\\\\"AuthPrincipalOwnerId\\\\\\": \\\\\\"111111111111111111\\\\\\",\\\\n \\\\\\"AuthPrincipalType\\\\\\": \\\\\\"SubUser\\\\\\",\\\\n \\\\\\"AuthResource\\\\\\": \\\\\\"xxx\\\\\\",\\\\n \\\\\\"NoPermissionType\\\\\\": \\\\\\"xxx\\\\\\",\\\\n \\\\\\"PolicyType\\\\\\": \\\\\\"xxx\\\\\\"\\\\n}\\"\\n}","errorExample":""},{"type":"xml","example":"<DescribeApsActionLogsResponse>\\n <RequestId>A5EDBA27-AF3E-5966-9503-FD1557E19167</RequestId>\\n <DBClusterId>amv-bp1r053byu48p****</DBClusterId>\\n <WorkloadId>aps-hz109vpvt4fg8528d****</WorkloadId>\\n <TotalCount>3</TotalCount>\\n <PageSize>20</PageSize>\\n <PageNumber>1</PageNumber>\\n <ActionLogs>\\n <Time>2022-09-01T05:46:30Z</Time>\\n <Stage>FullDataSync</Stage>\\n <State>INFO,WARN,ERROR</State>\\n <Context>DDL migration job finished</Context>\\n </ActionLogs>\\n</DescribeApsActionLogsResponse>","errorExample":""}]', - 'title' => '查询实时数据接入任务的日志', - 'description' => '- 中心的公网接入地址：`adb.aliyuncs.com`。'."\n" - .'- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" - .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。', + 'title' => '暂停 / 恢复元数据发现周期调度', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'ramActions' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"HttpStatusCode\\": 200,\\n \\"Data\\": true,\\n \\"RequestId\\": \\"642F3512-C628-5D0C-8815-F6670CEA00D4\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', ], 'UpdateLakeStorage' => [ - 'summary' => '更新湖存储。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], @@ -42871,53 +30346,28 @@ 'systemTags' => [ 'operationType' => 'update', 'abilityTreeCode' => '216927', - 'abilityTreeNodes' => [ - 'FEATUREadsQO9FPM', - ], + 'abilityTreeNodes' => ['FEATUREadsQO9FPM'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-shenzhen', - ], + 'schema' => ['description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-shenzhen'], ], [ 'name' => 'Description', 'in' => 'formData', - 'schema' => [ - 'title' => '湖存储描述', - 'description' => '湖存储描述', - 'type' => 'string', - 'required' => false, - 'example' => 'test', - ], + 'schema' => ['title' => '湖存储描述', 'description' => '湖存储描述', 'type' => 'string', 'required' => false, 'example' => 'test'], ], [ 'name' => 'LakeStorageId', 'in' => 'formData', - 'schema' => [ - 'title' => '湖存储唯一标识', - 'description' => '湖存储唯一标识', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], + 'schema' => ['title' => '湖存储唯一标识', 'description' => '湖存储唯一标识', 'type' => 'string', 'required' => false, 'example' => '-'], ], [ 'name' => 'DBClusterId', 'in' => 'formData', - 'schema' => [ - 'title' => 'ADB实例ID', - 'description' => 'ADB实例ID', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-*******', - ], + 'schema' => ['title' => 'ADB实例ID', 'description' => 'ADB实例ID', 'type' => 'string', 'required' => false, 'example' => 'amv-*******'], ], [ 'name' => 'Permissions', @@ -42932,39 +30382,16 @@ 'description' => '权限项', 'type' => 'object', 'properties' => [ - 'Read' => [ - 'title' => '读权限', - 'description' => '读权限', - 'type' => 'boolean', - 'required' => true, - 'example' => 'true', - ], - 'Write' => [ - 'title' => '写权限', - 'description' => '写权限', - 'type' => 'boolean', - 'required' => true, - 'example' => 'false', - ], - 'Account' => [ - 'title' => '账户ID', - 'description' => '账户ID', - 'type' => 'string', - 'required' => true, - 'example' => 'test', - 'pattern' => '^\\d+$', - 'default' => '', - ], + 'Read' => ['title' => '读权限', 'description' => '读权限', 'type' => 'boolean', 'required' => true, 'example' => 'true'], + 'Write' => ['title' => '写权限', 'description' => '写权限', 'type' => 'boolean', 'required' => true, 'example' => 'false'], + 'Account' => ['title' => '账户ID', 'description' => '账户ID', 'type' => 'string', 'required' => true, 'example' => 'test', 'pattern' => '^\\d+$', 'default' => ''], 'Type' => [ 'title' => '账户类型', 'description' => '账户类型', 'type' => 'string', 'required' => true, 'example' => 'SUB', - 'enum' => [ - 'Service', - 'User', - ], + 'enum' => ['Service', 'User'], ], ], 'required' => false, @@ -42982,81 +30409,21 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '******-3EEC-******-9F06-******'], 'Data' => [ 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'LakeStorageId' => [ - 'title' => '湖存储唯一标识', - 'description' => '湖存储唯一标识', - 'type' => 'string', - 'example' => '-', - ], - 'Description' => [ - 'title' => '湖存储描述', - 'description' => '湖存储描述', - 'type' => 'string', - 'example' => 'test', - ], - 'DBClusterId' => [ - 'title' => 'ADB实例ID', - 'description' => 'ADB实例ID', - 'type' => 'string', - 'example' => 'amv-23xxxx', - ], - 'FileSize' => [ - 'title' => '总存储量', - 'description' => '总存储量', - 'type' => 'string', - 'example' => '142', - ], - 'RowCount' => [ - 'title' => '总数据行数', - 'description' => '总数据行数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '>=', - 'pattern' => '', - 'default' => '', - ], - 'TableCount' => [ - 'title' => '库表数量', - 'description' => '库表数量', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1234', - 'pattern' => '', - 'default' => '', - ], - 'PartitionCount' => [ - 'description' => '分区数。', - 'type' => 'string', - 'example' => '0', - ], - 'CreatorUid' => [ - 'title' => '创建者UID', - 'description' => '创建者UID', - 'type' => 'string', - 'example' => '123456', - ], - 'OwnerUid' => [ - 'title' => '拥有者UID', - 'description' => '拥有者UID', - 'type' => 'string', - 'example' => '123456', - ], - 'OperatorUid' => [ - 'title' => '操作者UID', - 'description' => '操作者UID', - 'type' => 'string', - 'example' => '123456', - ], + 'LakeStorageId' => ['title' => '湖存储唯一标识', 'description' => '湖存储唯一标识', 'type' => 'string', 'example' => '-'], + 'Description' => ['title' => '湖存储描述', 'description' => '湖存储描述', 'type' => 'string', 'example' => 'test'], + 'DBClusterId' => ['title' => 'ADB实例ID', 'description' => 'ADB实例ID', 'type' => 'string', 'example' => 'amv-23xxxx'], + 'FileSize' => ['title' => '总存储量', 'description' => '总存储量', 'type' => 'string', 'example' => '142'], + 'RowCount' => ['title' => '总数据行数', 'description' => '总数据行数', 'type' => 'integer', 'format' => 'int64', 'example' => '>=', 'pattern' => '', 'default' => ''], + 'TableCount' => ['title' => '库表数量', 'description' => '库表数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1234', 'pattern' => '', 'default' => ''], + 'PartitionCount' => ['description' => '分区数。', 'type' => 'string', 'example' => '0'], + 'CreatorUid' => ['title' => '创建者UID', 'description' => '创建者UID', 'type' => 'string', 'example' => '123456'], + 'OwnerUid' => ['title' => '拥有者UID', 'description' => '拥有者UID', 'type' => 'string', 'example' => '123456'], + 'OperatorUid' => ['title' => '操作者UID', 'description' => '操作者UID', 'type' => 'string', 'example' => '123456'], 'Permissions' => [ 'title' => '湖存储权限', 'description' => '湖存储权限', @@ -43066,36 +30433,15 @@ 'description' => '权限项', 'type' => 'object', 'properties' => [ - 'Read' => [ - 'title' => '读权限', - 'description' => '读权限', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Write' => [ - 'title' => '写权限', - 'description' => '写权限', - 'type' => 'boolean', - 'example' => 'false', - ], - 'Account' => [ - 'title' => '账户ID', - 'description' => '账户ID', - 'type' => 'string', - 'example' => 'test', - 'pattern' => '^\\d+$', - 'default' => '', - ], + 'Read' => ['title' => '读权限', 'description' => '读权限', 'type' => 'boolean', 'example' => 'true'], + 'Write' => ['title' => '写权限', 'description' => '写权限', 'type' => 'boolean', 'example' => 'false'], + 'Account' => ['title' => '账户ID', 'description' => '账户ID', 'type' => 'string', 'example' => 'test', 'pattern' => '^\\d+$', 'default' => ''], 'Type' => [ 'title' => '账户类型', 'description' => '账户类型', 'type' => 'string', 'example' => 'SUB', - 'enum' => [ - 'CUSTOMER', - 'SUB', - 'STS', - ], + 'enum' => ['CUSTOMER', 'SUB', 'STS'], ], ], 'example' => '-', @@ -43104,139 +30450,87 @@ 'maxItems' => 20, 'minItems' => 0, ], - 'CreateTime' => [ - 'title' => '创建时间', - 'description' => '创建时间', - 'type' => 'string', - 'example' => '2023-05-15T07:24:58Z', - ], - 'UpdateTime' => [ - 'title' => '更新时间', - 'description' => '更新时间', - 'type' => 'string', - 'example' => '2024-07-01T09:22:17Z', - ], - 'RegionId' => [ - 'title' => '区域ID', - 'description' => '区域ID', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], + 'CreateTime' => ['title' => '创建时间', 'description' => '创建时间', 'type' => 'string', 'example' => '2023-05-15T07:24:58Z'], + 'UpdateTime' => ['title' => '更新时间', 'description' => '更新时间', 'type' => 'string', 'example' => '2024-07-01T09:22:17Z'], + 'RegionId' => ['title' => '区域ID', 'description' => '区域ID', 'type' => 'string', 'example' => 'cn-hangzhou'], ], 'example' => '-', ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Code' => [ - 'description' => '状态码。说明 200表示成功。', - 'type' => 'string', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - ."\n" - .'- 请求正常，返回OK。'."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'OK', - ], + 'HttpStatusCode' => ['description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Success' => ['description' => '调用是否成功，取值说明：'."\n" + .'- **true**：成功。'."\n" + .'- **false**：失败。', 'type' => 'boolean', 'example' => 'true'], + 'Code' => ['description' => '状态码。说明 200表示成功。', 'type' => 'string', 'example' => '200'], + 'Message' => ['description' => '调用结果的附加信息。取值说明：'."\n" + ."\n" + .'- 请求正常，返回OK。'."\n" + .'- 请求异常，返回具体异常错误码。', 'type' => 'string', 'example' => 'OK'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Data\\": {\\n \\"LakeStorageId\\": \\"-\\",\\n \\"Description\\": \\"test\\",\\n \\"DBClusterId\\": \\"amv-23xxxx\\",\\n \\"FileSize\\": \\"142\\",\\n \\"RowCount\\": 0,\\n \\"TableCount\\": 1234,\\n \\"PartitionCount\\": \\"0\\",\\n \\"CreatorUid\\": \\"123456\\",\\n \\"OwnerUid\\": \\"123456\\",\\n \\"OperatorUid\\": \\"123456\\",\\n \\"Permissions\\": [\\n {\\n \\"Read\\": true,\\n \\"Write\\": false,\\n \\"Account\\": \\"test\\",\\n \\"Type\\": \\"SUB\\"\\n }\\n ],\\n \\"CreateTime\\": \\"2023-05-15T07:24:58Z\\",\\n \\"UpdateTime\\": \\"2024-07-01T09:22:17Z\\",\\n \\"RegionId\\": \\"cn-hangzhou\\"\\n },\\n \\"HttpStatusCode\\": 200,\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', + 'staticInfo' => ['returnType' => 'synchronous'], 'title' => '更新湖存储', - ], - 'ListLakeStorages' => [ - 'summary' => '列取湖存储。', - 'methods' => [ - 'get', + 'summary' => '更新湖存储。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'UpdateLakeStorage'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:UpdateLakeStorage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Data\\": {\\n \\"LakeStorageId\\": \\"-\\",\\n \\"Description\\": \\"test\\",\\n \\"DBClusterId\\": \\"amv-23xxxx\\",\\n \\"FileSize\\": \\"142\\",\\n \\"RowCount\\": 0,\\n \\"TableCount\\": 1234,\\n \\"PartitionCount\\": \\"0\\",\\n \\"CreatorUid\\": \\"123456\\",\\n \\"OwnerUid\\": \\"123456\\",\\n \\"OperatorUid\\": \\"123456\\",\\n \\"Permissions\\": [\\n {\\n \\"Read\\": true,\\n \\"Write\\": false,\\n \\"Account\\": \\"test\\",\\n \\"Type\\": \\"SUB\\"\\n }\\n ],\\n \\"CreateTime\\": \\"2023-05-15T07:24:58Z\\",\\n \\"UpdateTime\\": \\"2024-07-01T09:22:17Z\\",\\n \\"RegionId\\": \\"cn-hangzhou\\"\\n },\\n \\"HttpStatusCode\\": 200,\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"OK\\"\\n}","type":"json"}]', + ], + 'UpdateSparkTemplateFile' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', - 'abilityTreeCode' => '216928', - 'abilityTreeNodes' => [ - 'FEATUREadsQO9FPM', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '123242', + 'abilityTreeNodes' => ['FEATUREadsUF9CN9'], ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'Filter', - 'in' => 'query', - 'schema' => [ - 'title' => '查询过滤参数，多个过滤参数之间是且的关系。例如:过滤实例名称为i-a123、i-b123，且实例状态为Stopped：&Filter.1.Name=InstanceName&Filter.1.Value.1=i-a123&Filter.1.Value.2=i-b123&Filter.2.Name=Status&Filter.2.Value=Stopped。', - 'description' => '查询过滤参数，多个过滤参数之间是且的关系。例如:过滤实例名称为i-a123、i-b123，且实例状态为Stopped：&Filter.1.Name=InstanceName&Filter.1.Value.1=i-a123&Filter.1.Value.2=i-b123&Filter.2.Name=Status&Filter.2.Value=Stopped。', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], + 'name' => 'DBClusterId', + 'in' => 'formData', + 'schema' => ['title' => '数据库的ID', 'description' => '<props="china">企业版、基础版或湖仓版集群ID。</props>'."\n" + .'<props="intl">湖仓版集群ID。</props>', 'type' => 'string', 'required' => true, 'example' => 'amv-pz5vp4585l466****', 'maxLength' => 64], ], [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'title' => '返回结果的最大个数。', - 'description' => '返回结果的最大个数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], + 'name' => 'Id', + 'in' => 'formData', + 'schema' => ['title' => '模板文件ID', 'description' => '应用模板ID。'."\n" + .'> 调用[GetSparkTemplateFullTree](~~456205~~)接口查询应用模板ID。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'minimum' => '0', 'exclusiveMinimum' => true, 'example' => '718056'], ], [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '每页大小。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '30', - ], + 'name' => 'Content', + 'in' => 'formData', + 'schema' => ['title' => '模板文件内容', 'description' => '应用模板数据。'."\n" + .'> 此参数不填写时，不更新应用模板。如何配置Spark应用模板，请参见[Spark应用配置指南](~~452402~~)。', 'type' => 'string', 'required' => false, 'example' => 'set spark.driver.resourceSpec=medium;set spark.executor.instances=2;set spark.executor.resourceSpec=medium;set spark.app.name=Spark SQL Test;'], ], [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-*******', - ], + 'name' => 'ResourceGroupName', + 'in' => 'formData', + 'schema' => ['title' => '资源组的名称', 'description' => 'Job型资源组名称。'."\n", 'type' => 'string', 'required' => false, 'example' => 'adb'], ], ], 'responses' => [ @@ -43246,263 +30540,117 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '****-964D-****-9D31-****', - ], - 'TotalCount' => [ - 'title' => '总记录数。', - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'PageNumber' => [ - 'title' => '当总结果个数大于MaxResults时，用于翻页的token。', - 'description' => '当总结果个数大于MaxResults时，用于翻页的token。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '每页大小。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'Items' => [ - 'title' => '数组，返回示例目录。', - 'description' => '数组，返回示例目录。', - 'type' => 'array', - 'items' => [ - 'title' => 'LakeStorageItemType', - 'description' => 'LakeStorageItemType', - 'type' => 'object', - 'properties' => [ - 'OwnerUid' => [ - 'title' => '拥有者UID', - 'description' => '拥有者UID', - 'type' => 'string', - 'example' => '123456', - ], - 'DBClusterId' => [ - 'title' => 'ADB实例ID', - 'description' => 'ADB实例ID', - 'type' => 'string', - 'example' => 'amv-*******', - ], - 'TotalRows' => [ - 'title' => '总数据行数', - 'description' => '总数据行数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - 'pattern' => '', - 'default' => '', - ], - 'OperatorUid' => [ - 'title' => '操作者UID', - 'description' => '操作者UID', - 'type' => 'string', - 'example' => '123456', - ], - 'Permissions' => [ - 'title' => '湖存储权限', - 'description' => '湖存储权限', - 'type' => 'array', - 'items' => [ - 'title' => '权限项', - 'description' => '权限项', - 'type' => 'object', - 'properties' => [ - 'Read' => [ - 'title' => '读权限', - 'description' => '读权限', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Write' => [ - 'title' => '写权限', - 'description' => '写权限', - 'type' => 'boolean', - 'example' => 'false', - ], - 'Account' => [ - 'title' => '账户ID', - 'description' => '账户ID', - 'type' => 'string', - 'example' => '-', - 'pattern' => '^\\d+$', - 'default' => '', - ], - 'Type' => [ - 'title' => '账户类型', - 'description' => '账户类型', - 'type' => 'string', - 'example' => '-', - 'enum' => [ - 'CUSTOMER', - 'SUB', - 'STS', - ], - ], - ], - 'example' => '-', - ], - 'example' => '-', - ], - 'TableCount' => [ - 'title' => '库表数量', - 'description' => '库表数量', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - 'pattern' => '', - 'default' => '', - ], - 'Description' => [ - 'title' => '湖存储描述', - 'description' => '湖存储描述', - 'type' => 'string', - 'example' => 'Create a role to run ROS StackGroups.', - ], - 'LakeStorageId' => [ - 'title' => '湖存储唯一标识', - 'description' => '湖存储唯一标识', - 'type' => 'string', - 'example' => '-', - ], - 'CreateTime' => [ - 'title' => '创建时间', - 'description' => '创建时间', - 'type' => 'string', - 'example' => '2021-04-01T09:50:18Z', - ], - 'TotalStorage' => [ - 'title' => '总存储量', - 'description' => '总存储量', - 'type' => 'string', - 'example' => '111333', - ], - 'CreatorUid' => [ - 'title' => '创建者UID', - 'description' => '创建者UID', - 'type' => 'string', - 'example' => '123456', - ], - 'UpdateTime' => [ - 'title' => '更新时间', - 'description' => '更新时间', - 'type' => 'string', - 'example' => '2024-03-15T02:24:32', - ], - 'RegionId' => [ - 'title' => '区域ID', - 'description' => '区域ID', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'FileSize' => [ - 'description' => '数据文件大小。', - 'type' => 'string', - 'example' => '651', - ], - ], - 'example' => '-', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'C3A9594F-1D40-4472-A96C-8FB8AA20D38C'], + 'Data' => [ + 'description' => '更新结果。', + 'type' => 'object', + 'properties' => [ + 'Succeeded' => ['title' => '是否更新成功', 'description' => '应用模板更新是否成功，取值说明：'."\n" + .'- **True**：更新成功。'."\n" + .'- **False**：更新失败。', 'type' => 'boolean', 'example' => 'True'], ], - 'example' => '-', - ], - 'Success' => [ - 'description' => '预检查结果，返回值说明：'."\n" - ."\n" - .'- **success**：检查通过。'."\n" - .'- **false**：检查不通过。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Ok**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', ], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'Spark.InvalidParameter', 'errorMessage' => 'Invalid parameter value: %s', 'description' => '输入参数不正确：%s。'], + ['errorCode' => 'Spark.TemplateFile.BadFileType', 'errorMessage' => 'The requested template %s is not a file.', 'description' => '请求的模板文件ID不是文件类型的。'], + ['errorCode' => 'Spark.InvalidState', 'errorMessage' => 'The object of the operation is in an invalid state: %s', 'description' => '操作对象处于非合法状态。'], + ['errorCode' => 'Spark.Log.IllegalPath', 'errorMessage' => 'Invalid job log URI: %s.', 'description' => '配置的Spark日志路径不合法：%s。'], + ['errorCode' => 'Spark.Log.InvalidState', 'errorMessage' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'description' => '无法获取指定Spark作业的日志。'], + ['errorCode' => 'Spark.Oss.InternalError', 'errorMessage' => 'An OSS internal error occurred: %s', 'description' => 'OSS内部错误，请求失败。'], + ['errorCode' => 'Spark.RoleArn.Invalid', 'errorMessage' => '%s is not found, or the RAM role has not been authorized.', 'description' => 'RoleArn不存在或子账号未授权。'], + ], + 403 => [ + ['errorCode' => 'Spark.Forbidden', 'errorMessage' => 'No permissions to access the resources: %s', 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ], + [ + ['errorCode' => 'Spark.ObjectNotFound', 'errorMessage' => 'The object is not found. More information: %s', 'description' => '操作对象不存在。关联信息：%s。'], + ['errorCode' => 'Spark.TemplateFile.FileNotFound', 'errorMessage' => 'The template file %s is not found.', 'description' => '未能找到输入的模板文件。'], + ['errorCode' => 'Spark.TemplateFile.TemplateNotFound', 'errorMessage' => 'The template %s is not found.', 'description' => '模板文件未找到。'], + ['errorCode' => 'Spark.Log.PodLogNotFound', 'errorMessage' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', 'description' => '无法通过podName找到对应pod的日志 [%s]。'], + ], + 500 => [ + ['errorCode' => 'Spark.ServerError', 'errorMessage' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"****-964D-****-9D31-****\\",\\n \\"TotalCount\\": 30,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"Items\\": [\\n {\\n \\"OwnerUid\\": \\"123456\\",\\n \\"DBClusterId\\": \\"amv-*******\\",\\n \\"TotalRows\\": 30,\\n \\"OperatorUid\\": \\"123456\\",\\n \\"Permissions\\": [\\n {\\n \\"Read\\": true,\\n \\"Write\\": false,\\n \\"Account\\": \\"-\\",\\n \\"Type\\": \\"-\\"\\n }\\n ],\\n \\"TableCount\\": 30,\\n \\"Description\\": \\"Create a role to run ROS StackGroups.\\",\\n \\"LakeStorageId\\": \\"-\\",\\n \\"CreateTime\\": \\"2021-04-01T09:50:18Z\\",\\n \\"TotalStorage\\": \\"111333\\",\\n \\"CreatorUid\\": \\"123456\\",\\n \\"UpdateTime\\": \\"2024-03-15T02:24:32\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"FileSize\\": \\"651\\"\\n }\\n ],\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Success\\"\\n}","type":"json"}]', - 'title' => '列取湖存储', - ], - 'GetLakeStorage' => [ - 'summary' => '获取湖存储。', - 'methods' => [ - 'get', - 'post', + 'title' => '更新Spark应用模板', + 'summary' => '更新Spark应用模板。', + 'description' => '- 地域的公网接入地址：`adb.<region-id>.aliyuncs.com`。示例：`adb.cn-hangzhou.aliyuncs.com`。'."\n" + .'- 地域的VPC接入地址：`adb-vpc.<region-id>.aliyuncs.com`。示例：`adb-vpc.cn-hangzhou.aliyuncs.com`。'."\n" + .'> 如果华北1（青岛）、华南1（深圳）、华南3（广州）、中国香港发起请求时，遇到409错误，请联系技术支持。', + 'changeSet' => [ + ['createdAt' => '2023-06-28T01:10:25.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'UpdateSparkTemplateFile'], + ], ], - 'schemes' => [ - 'https', + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:UpdateSparkTemplateFile', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'SparkTemplate', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/template/{#TemplateId}'], + ], + ], + ], ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C3A9594F-1D40-4472-A96C-8FB8AA20D38C\\",\\n \\"Data\\": {\\n \\"Succeeded\\": true\\n }\\n}","errorExample":""},{"type":"xml","example":"<UpdateSparkTemplateFileResponse>\\n <RequestId>C3A9594F-1D40-4472-A96C-8FB8AA20D38C</RequestId>\\n <Data>\\n <Succeeded>true</Succeeded>\\n </Data>\\n</UpdateSparkTemplateFileResponse>","errorExample":""}]', + ], + 'UpgradeKernelVersion' => [ + 'summary' => '升级目标AnalyticDB MySQL版集群的内核版本。', + 'path' => '', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '216924', - 'abilityTreeNodes' => [ - 'FEATUREadsQO9FPM', - ], + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREadsQEKELU'], ], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', - ], + 'name' => 'DBClusterId', + 'in' => 'query', + 'schema' => ['description' => '集群ID。'."\n" + ."\n" + .'> 您可以通过[DescribeDBClusters](~~129857~~)接口查看账号下AnalyticDB MySQL数仓版集群的集群ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'am-uf6g8w25jacm7****'], ], [ - 'name' => 'LakeStorageId', + 'name' => 'DBVersion', 'in' => 'query', - 'schema' => [ - 'title' => '实例 ID。', - 'description' => '实例 ID。', - 'type' => 'string', - 'required' => false, - 'example' => '-', - ], + 'schema' => ['description' => '需要升级到的目标内核版本。'."\n" + .'> 您可以调用**DescribeKernelVersion**接口查询集群支持的内核版本列表。', 'type' => 'string', 'required' => false, 'example' => '3.1.9'], ], [ - 'name' => 'DBClusterId', + 'name' => 'SwitchMode', 'in' => 'query', 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', + 'description' => '执行时间，取值：'."\n" + .'* **0**：立即执行，默认值。'."\n" + .'* **1**：在可维护时间段执行。'."\n" + ."\n" + .'> 您可以调用[ModifyDBClusterMaintainTime](~~612236~~)修改集群的可维护时间段。', + 'type' => 'integer', + 'format' => 'int32', 'required' => false, - 'example' => 'amv-*******', + 'example' => '0', + 'enum' => ['0', '1'], ], ], ], @@ -43513,2292 +30661,4508 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '******-3EEC-******-9F06-******', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'LakeStorageId' => [ - 'title' => '湖存储唯一标识', - 'description' => '湖存储唯一标识', - 'type' => 'string', - 'example' => '-', - ], - 'Description' => [ - 'title' => '湖存储描述', - 'description' => '湖存储描述', - 'type' => 'string', - 'example' => 'a test db', - ], - 'DBClusterId' => [ - 'title' => 'ADB实例ID', - 'description' => 'ADB实例ID', - 'type' => 'string', - 'example' => 'amv-*******', - ], - 'FileSize' => [ - 'title' => '总存储量', - 'description' => '总存储量', - 'type' => 'string', - 'example' => '1', - ], - 'RowCount' => [ - 'title' => '总数据行数', - 'description' => '总数据行数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '-', - 'pattern' => '', - 'default' => '', - ], - 'TableCount' => [ - 'title' => '库表数量', - 'description' => '库表数量', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '-', - 'pattern' => '', - 'default' => '', - ], - 'PartitionCount' => [ - 'description' => '分区数。', - 'type' => 'string', - 'example' => '-', - ], - 'CreatorUid' => [ - 'title' => '创建者UID', - 'description' => '创建者UID', - 'type' => 'string', - 'example' => '123456', - ], - 'OwnerUid' => [ - 'title' => '拥有者UID', - 'description' => '拥有者UID', - 'type' => 'string', - 'example' => '123456', - ], - 'OperatorUid' => [ - 'title' => '操作者UID', - 'description' => '操作者UID', - 'type' => 'string', - 'example' => '123456', - ], - 'Permissions' => [ - 'title' => '湖存储权限', - 'description' => '湖存储权限', - 'type' => 'array', - 'items' => [ - 'title' => '权限项', - 'description' => '权限项', - 'type' => 'object', - 'properties' => [ - 'Read' => [ - 'title' => '读权限', - 'description' => '读权限', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Write' => [ - 'title' => '写权限', - 'description' => '写权限', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Account' => [ - 'title' => '账户ID', - 'description' => '账户ID', - 'type' => 'string', - 'example' => 'test', - 'pattern' => '^\\d+$', - 'default' => '', - ], - 'Type' => [ - 'title' => '账户类型', - 'description' => '账户类型', - 'type' => 'string', - 'example' => '-', - 'enum' => [ - 'CUSTOMER', - 'SUB', - 'STS', - ], - ], - ], - 'example' => '-', - ], - 'example' => '-', - ], - 'CreateTime' => [ - 'title' => '创建时间', - 'description' => '创建时间', - 'type' => 'string', - 'example' => '2023-05-15T07:24:58Z', - ], - 'UpdateTime' => [ - 'title' => '更新时间', - 'description' => '更新时间', - 'type' => 'string', - 'example' => '2024-10-14T02:28:41Z', - ], - 'RegionId' => [ - 'title' => '区域ID', - 'description' => '区域ID', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - ], - 'example' => '-', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Ok**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'SUCCESS', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A444FFFFFF'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '升级集群内核版本', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'UpgradeKernelVersion'], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******-3EEC-******-9F06-******\\",\\n \\"Data\\": {\\n \\"LakeStorageId\\": \\"-\\",\\n \\"Description\\": \\"a test db\\",\\n \\"DBClusterId\\": \\"amv-*******\\",\\n \\"FileSize\\": \\"1\\",\\n \\"RowCount\\": 0,\\n \\"TableCount\\": 0,\\n \\"PartitionCount\\": \\"-\\",\\n \\"CreatorUid\\": \\"123456\\",\\n \\"OwnerUid\\": \\"123456\\",\\n \\"OperatorUid\\": \\"123456\\",\\n \\"Permissions\\": [\\n {\\n \\"Read\\": true,\\n \\"Write\\": true,\\n \\"Account\\": \\"test\\",\\n \\"Type\\": \\"-\\"\\n }\\n ],\\n \\"CreateTime\\": \\"2023-05-15T07:24:58Z\\",\\n \\"UpdateTime\\": \\"2024-10-14T02:28:41Z\\",\\n \\"RegionId\\": \\"cn-hangzhou\\"\\n },\\n \\"HttpStatusCode\\": 200,\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"SUCCESS\\"\\n}","type":"json"}]', - 'title' => '获取湖存储', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:UpgradeKernelVersion', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A444FFFFFF\\"\\n}","type":"json"}]', ], - 'CreateLakeStorage' => [ - 'summary' => '创建湖存储。', - 'methods' => [ - 'post', + ], + 'endpoints' => [ + ['regionId' => 'cn-chengdu', 'regionName' => '西南1（成都）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.cn-chengdu.aliyuncs.com', 'endpoint' => 'adb.cn-chengdu.aliyuncs.com', 'vpc' => ''], + ['regionId' => 'cn-wulanchabu', 'regionName' => '华北6（乌兰察布）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.cn-wulanchabu.aliyuncs.com', 'endpoint' => 'adb.cn-wulanchabu.aliyuncs.com', 'vpc' => 'adb-vpc.cn-wulanchabu.aliyuncs.com'], + ['regionId' => 'cn-beijing', 'regionName' => '华北2（北京）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.cn-beijing.aliyuncs.com', 'endpoint' => 'adb.cn-beijing.aliyuncs.com', 'vpc' => 'adb-vpc.cn-beijing.aliyuncs.com'], + ['regionId' => 'cn-qingdao', 'regionName' => '华北1（青岛）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.cn-qingdao.aliyuncs.com', 'endpoint' => 'adb.cn-qingdao.aliyuncs.com', 'vpc' => 'adb-vpc.cn-qingdao.aliyuncs.com'], + ['regionId' => 'cn-shanghai', 'regionName' => '华东2（上海）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.cn-shanghai.aliyuncs.com', 'endpoint' => 'adb.cn-shanghai.aliyuncs.com', 'vpc' => 'adb-vpc.cn-shanghai.aliyuncs.com'], + ['regionId' => 'cn-hongkong', 'regionName' => '中国香港', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.cn-hongkong.aliyuncs.com', 'endpoint' => 'adb.cn-hongkong.aliyuncs.com', 'vpc' => 'adb-vpc.cn-hongkong.aliyuncs.com'], + ['regionId' => 'cn-zhangjiakou', 'regionName' => '华北3（张家口）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.cn-zhangjiakou.aliyuncs.com', 'endpoint' => 'adb.cn-zhangjiakou.aliyuncs.com', 'vpc' => 'adb-vpc.cn-zhangjiakou.aliyuncs.com'], + ['regionId' => 'cn-shenzhen', 'regionName' => '华南1（深圳）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.cn-shenzhen.aliyuncs.com', 'endpoint' => 'adb.cn-shenzhen.aliyuncs.com', 'vpc' => 'adb-vpc.cn-shenzhen.aliyuncs.com'], + ['regionId' => 'ap-northeast-2', 'regionName' => '韩国（首尔）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.ap-northeast-2.aliyuncs.com', 'endpoint' => 'adb.ap-northeast-2.aliyuncs.com', 'vpc' => 'adb-vpc.ap-northeast-2.aliyuncs.com'], + ['regionId' => 'ap-northeast-1', 'regionName' => '日本（东京）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.ap-northeast-1.aliyuncs.com', 'endpoint' => 'adb.ap-northeast-1.aliyuncs.com', 'vpc' => 'adb-vpc.ap-northeast-1.aliyuncs.com'], + ['regionId' => 'cn-guangzhou', 'regionName' => '华南3（广州）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.cn-guangzhou.aliyuncs.com', 'endpoint' => 'adb.cn-guangzhou.aliyuncs.com', 'vpc' => 'adb-vpc.cn-guangzhou.aliyuncs.com'], + ['regionId' => 'ap-southeast-1', 'regionName' => '新加坡', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.ap-southeast-1.aliyuncs.com', 'endpoint' => 'adb.ap-southeast-1.aliyuncs.com', 'vpc' => 'adb-vpc.ap-southeast-1.aliyuncs.com'], + ['regionId' => 'ap-southeast-2', 'regionName' => '澳大利亚（悉尼）已关停', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.ap-southeast-2.aliyuncs.com', 'endpoint' => 'adb.ap-southeast-2.aliyuncs.com', 'vpc' => 'adb-vpc.ap-southeast-2.aliyuncs.com'], + ['regionId' => 'ap-southeast-3', 'regionName' => '马来西亚（吉隆坡）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.ap-southeast-3.aliyuncs.com', 'endpoint' => 'adb.ap-southeast-3.aliyuncs.com', 'vpc' => 'adb-vpc.ap-southeast-3.aliyuncs.com'], + ['regionId' => 'cn-huhehaote', 'regionName' => '华北5（呼和浩特）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.cn-huhehaote.aliyuncs.com', 'endpoint' => 'adb.cn-huhehaote.aliyuncs.com', 'vpc' => 'adb-vpc.cn-huhehaote.aliyuncs.com'], + ['regionId' => 'ap-southeast-5', 'regionName' => '印度尼西亚（雅加达）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.ap-southeast-5.aliyuncs.com', 'endpoint' => 'adb.ap-southeast-5.aliyuncs.com', 'vpc' => 'adb-vpc.ap-southeast-5.aliyuncs.com'], + ['regionId' => 'ap-southeast-6', 'regionName' => '菲律宾（马尼拉）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.ap-southeast-6.aliyuncs.com', 'endpoint' => 'adb.ap-southeast-6.aliyuncs.com', 'vpc' => 'adb-vpc.ap-southeast-6.aliyuncs.com'], + ['regionId' => 'ap-southeast-7', 'regionName' => '泰国（曼谷）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.ap-southeast-7.aliyuncs.com', 'endpoint' => 'adb.ap-southeast-7.aliyuncs.com', 'vpc' => 'adb-vpc.ap-southeast-7.aliyuncs.com'], + ['regionId' => 'cn-hangzhou', 'regionName' => '华东1（杭州）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'adb.aliyuncs.com', 'endpoint' => 'adb.aliyuncs.com', 'vpc' => 'adb-vpc.cn-hangzhou.aliyuncs.com'], + ['regionId' => 'us-east-1', 'regionName' => '美国（弗吉尼亚）', 'areaId' => 'europeAmerica', 'areaName' => '欧洲与美洲', 'public' => 'adb.us-east-1.aliyuncs.com', 'endpoint' => 'adb.us-east-1.aliyuncs.com', 'vpc' => 'adb-vpc.us-east-1.aliyuncs.com'], + ['regionId' => 'eu-west-1', 'regionName' => '英国（伦敦）', 'areaId' => 'europeAmerica', 'areaName' => '欧洲与美洲', 'public' => 'adb.eu-west-1.aliyuncs.com', 'endpoint' => 'adb.eu-west-1.aliyuncs.com', 'vpc' => 'adb-vpc.eu-west-1.aliyuncs.com'], + ['regionId' => 'us-west-1', 'regionName' => '美国（硅谷）', 'areaId' => 'europeAmerica', 'areaName' => '欧洲与美洲', 'public' => 'adb.us-west-1.aliyuncs.com', 'endpoint' => 'adb.us-west-1.aliyuncs.com', 'vpc' => 'adb-vpc.us-west-1.aliyuncs.com'], + ['regionId' => 'eu-central-1', 'regionName' => '德国（法兰克福）', 'areaId' => 'europeAmerica', 'areaName' => '欧洲与美洲', 'public' => 'adb.eu-central-1.aliyuncs.com', 'endpoint' => 'adb.eu-central-1.aliyuncs.com', 'vpc' => 'adb-vpc.eu-central-1.aliyuncs.com'], + ['regionId' => 'na-south-1', 'regionName' => '墨西哥', 'areaId' => 'europeAmerica', 'areaName' => '欧洲与美洲', 'public' => 'adb.na-south-1.aliyuncs.com', 'endpoint' => 'adb.na-south-1.aliyuncs.com', 'vpc' => 'adb-vpc.na-south-1.aliyuncs.com'], + ['regionId' => 'me-central-1', 'regionName' => '沙特（利雅得）', 'areaId' => 'middleEast', 'areaName' => '中东', 'public' => 'adb.me-central-1.aliyuncs.com', 'endpoint' => 'adb.me-central-1.aliyuncs.com', 'vpc' => 'adb-vpc.me-central-1.aliyuncs.com'], + ['regionId' => 'ap-south-1', 'regionName' => '印度（孟买）已关停', 'areaId' => 'middleEast', 'areaName' => '中东', 'public' => 'adb.ap-south-1.aliyuncs.com', 'endpoint' => 'adb.ap-south-1.aliyuncs.com', 'vpc' => 'adb-vpc.ap-south-1.aliyuncs.com'], + ['regionId' => 'cn-hangzhou-finance', 'regionName' => '华东1 金融云', 'areaId' => 'industryCloud', 'areaName' => '行业云', 'public' => 'adb.aliyuncs.com', 'endpoint' => 'adb.aliyuncs.com', 'vpc' => 'adb-vpc.cn-hangzhou-finance.aliyuncs.com'], + ['regionId' => 'cn-shenzhen-finance-1', 'regionName' => '华南1 金融云', 'areaId' => 'industryCloud', 'areaName' => '行业云', 'public' => 'adb.cn-shenzhen-finance-1.aliyuncs.com', 'endpoint' => 'adb.cn-shenzhen-finance-1.aliyuncs.com', 'vpc' => 'adb-vpc.cn-shenzhen-finance-1.aliyuncs.com'], + ['regionId' => 'cn-beijing-finance-1', 'regionName' => '华北2 金融云（邀测）', 'areaId' => 'industryCloud', 'areaName' => '行业云', 'public' => 'adb.aliyuncs.com', 'endpoint' => 'adb.aliyuncs.com', 'vpc' => 'adb-vpc.cn-beijing-finance-1.aliyuncs.com'], + ['regionId' => 'cn-shanghai-finance-1', 'regionName' => '华东2 金融云', 'areaId' => 'industryCloud', 'areaName' => '行业云', 'public' => 'adb.cn-shanghai-finance-1.aliyuncs.com', 'endpoint' => 'adb.cn-shanghai-finance-1.aliyuncs.com', 'vpc' => 'adb-vpc.cn-shanghai-finance-1.aliyuncs.com'], + ['regionId' => 'cn-north-2-gov-1', 'regionName' => '北京政务云', 'areaId' => 'industryCloud', 'areaName' => '行业云', 'public' => 'adb.cn-north-2-gov-1.aliyuncs.com', 'endpoint' => 'adb.cn-north-2-gov-1.aliyuncs.com', 'vpc' => 'adb-vpc.cn-north-2-gov-1.aliyuncs.com'], + ], + 'errorCodes' => [ + ['code' => 'AccessDenied', 'message' => 'Unauthorized access.', 'http_code' => 400, 'description' => '没有访问权限。'], + ['code' => 'AccountLimitExceeded', 'message' => 'The maximum number of accounts is exceeded.', 'http_code' => 400, 'description' => '超过账号数量限制。'], + ['code' => 'ACS.Account.NotExist', 'message' => 'The account is not found.', 'http_code' => 400, 'description' => '用户账户不存在。'], + ['code' => 'ACS.Account.UserHasBind', 'message' => 'The user has been associated with another database account %s.', 'http_code' => 400, 'description' => '用户已绑定到另一个账户'], + ['code' => 'ACS.AssumeRoleError', 'message' => 'The AliyunAdbFullAccess permission is required for the RAM role to manage clusters.', 'http_code' => 400, 'description' => ' 操作集群前请授予子账号AliyunAdbFullAccess权限'], + ['code' => 'ACS.Clickhouse.ClickhouseEngineNotAllowed', 'message' => 'ClickHouse engine not allowed.', 'http_code' => 400, 'description' => '不允许开启clickhouse引擎'."\n"], + ['code' => 'ACS.Clickhouse.ClickhouseEngineNotAllowed', 'message' => 'Clickhouse engine not allowed cause %s.', 'http_code' => 400, 'description' => '不允许开启Clickhouse引擎'], + ['code' => 'ACS.Cluster.ElasticPlanJobsExists', 'message' => 'Operation failed. Ongoing elastic plan jobs exist.', 'http_code' => 400, 'description' => '无法执行此操作：存在正在运行的存储弹性计划作业'], + ['code' => 'ACS.Cluster.InvalidState', 'message' => 'The state of the cluster does not support this operation.', 'http_code' => 400, 'description' => '集群的状态不支持当前操作。'], + ['code' => 'ACS.Cluster.InvalidWorkerState', 'message' => 'The state of the worker does not support this operation.', 'http_code' => 400, 'description' => '当前存储节点的状态不支持此操作'], + ['code' => 'ACS.Connection.CannotCreate', 'message' => 'Instance type %s cannot create connection.', 'http_code' => 400, 'description' => '子实例类型不支持创建连接'], + ['code' => 'ACS.DescribeDBClusterAttributeFailed', 'message' => 'DescribeDBClusterAttributeFailed.', 'http_code' => 400, 'description' => '未找到对应的实例'], + ['code' => 'ACS.ElasticPlan.AutoWorkerPlanExists', 'message' => 'Failed to enable the elastic plan. The instance already has an active elastic plan.', 'http_code' => 400, 'description' => '启用此存储弹性计划失败，当前实例存在启用的存储自动弹性计划。'], + ['code' => 'ACS.ElasticPlan.InvalidEndTime', 'message' => 'The end time should be later than current time.', 'http_code' => 400, 'description' => '分时弹性的结束时间应该晚于当前时间。'], + ['code' => 'ACS.ElasticPlan.InvalidStartTime', 'message' => 'Invalid start time.', 'http_code' => 400, 'description' => '弹性计划开始时间填写不正确'], + ['code' => 'ACS.ElasticPlan.InvalidStartTimeInterval', 'message' => 'The start time of this elastic plan is too closed to another one.', 'http_code' => 400, 'description' => '此弹性计划的启用时间和另外一个弹性计划过于接近。'], + ['code' => 'ACS.ElasticPlan.InvalidTargetSize', 'message' => 'Invalid target size.', 'http_code' => 400, 'description' => '无效的目标规格'], + ['code' => 'ACS.ElasticPlan.InvalidTodayPlan', 'message' => 'Failed to enable this elastic plan. Today\'s schedule time is missed and you should prepare at least %s minutes for us to prepare resource.', 'http_code' => 400, 'description' => '启用弹性计划失败。今天的弹性变配功能已经无法于弹性计划配置的变配时间进行触发，请检查配置的时间是否晚于可变配时间（当前时间加上资源准备时间%s分钟）。'], + ['code' => 'ACS.ElasticPlan.NameAlreadyExists', 'message' => 'The name already exists.', 'http_code' => 400, 'description' => '存在同名的弹性计划。'], + ['code' => 'ACS.ElasticPlan.NotFound', 'message' => 'The elastic plan is not found.', 'http_code' => 404, 'description' => '弹性计划不存在'], + ['code' => 'ACS.ElasticPlan.WorkerNotFound', 'message' => 'Worker not found.', 'http_code' => 400, 'description' => '此实例没有预留存储资源，无法设置存储弹性计划。'], + ['code' => 'ACS.ElasticPlan.WorkerPlanExists', 'message' => 'Failed to enable the elastic plan. At least one active elastic plan already exists.', 'http_code' => 400, 'description' => '启用存储自动弹性计划失败，当前存在另外一个启用的存储弹性计划。'], + ['code' => 'ACS.Instance.InvalidState', 'message' => 'The state of the instance does not support this operation.', 'http_code' => 400, 'description' => '子实例的状态不支持当前的操作'], + ['code' => 'ACS.InvalidParameter.%s', 'message' => 'Parameter %s is invalid.', 'http_code' => 400, 'description' => '输入的参数无效'], + ['code' => 'ACS.OperationFailed', 'message' => 'The specific operation is failed.', 'http_code' => 400, 'description' => 'ADB Cloud Service 服务错误'], + ['code' => 'ACS.Parameter.Malformed', 'message' => 'The following required parameters are not specified: %s', 'http_code' => 400, 'description' => '没有指定所需的参数。'], + ['code' => 'ACS.Privilege.ModifyFailed', 'message' => 'Failed to modify the account privilege. Make sure that bound account have sufficient database privileges.', 'http_code' => 400, 'description' => '修改账户权限失败，请检查发起请求的用户绑定的数据库账户是否有足够的数据库权限。'], + ['code' => 'ACS.ResourceGroup.ElasticPlanExists', 'message' => 'This resource group does not support this operation. Elastic plans that have been enabled already exist.', 'http_code' => 400, 'description' => '当前资源组不支持此操作：存在启用的弹性计划。'], + ['code' => 'ACS.ResourceGroup.InvalidResourceGroupState', 'message' => 'The state of this resource group does not support this operation.', 'http_code' => 400, 'description' => '当前状态的资源组不支持此操作。'], + ['code' => 'ACS.ResourceGroup.OngoingJobExist', 'message' => 'Resource group has ongoing job like %s.', 'http_code' => 400, 'description' => '资源组存在正在运行的作业'], + ['code' => 'ACS.ResourceGroup.OngoingJobExists', 'message' => 'Resource group has ongoing job(s).', 'http_code' => 400, 'description' => '资源组有正在进行的作业。'], + ['code' => 'ACS.SecurityIPsExceedLimit', 'message' => 'Provided security IPs exceed limit.', 'http_code' => 400, 'description' => '传入的IP数量超过限制'], + ['code' => 'ACS.ServerError', 'message' => 'ADB Cloud Service failed to process your request.', 'http_code' => 403, 'description' => 'ADB Cloud Service 服务错误'], + ['code' => 'ACS.Sql.CannotConnect', 'message' => 'Cannot connect instance which type is %s.', 'http_code' => 400, 'description' => '无法连接到给定类型的子实例。'], + ['code' => 'ACS.UnsupportedAvailableZone', 'message' => 'The specified available zone is not supported.', 'http_code' => 400, 'description' => '不支持的可用区.'], + ['code' => 'ACS.User.DatabaseAccountHasBind', 'message' => 'The database account has been bound to %s.', 'http_code' => 400, 'description' => '数据库账号已经绑定到一个用户。'], + ['code' => 'ACS.User.NotBindDatabaseAccount', 'message' => 'The user has not been associated with a database account.', 'http_code' => 400, 'description' => '用户没有绑定数据库账户。'], + ['code' => 'AcsServerTimeOut', 'message' => 'The request has failed due to Adb Cloud Service time out.', 'http_code' => 408, 'description' => '后端服务超时,请稍后尝试。'], + ['code' => 'ADB.InnerDescribeClusters', 'message' => 'Failed to query clusters by inner api.', 'http_code' => 400, 'description' => '查询集群内部信息失败'], + ['code' => 'ADBClassNotSupport', 'message' => 'The specified instance type does not support this operation.', 'http_code' => 400, 'description' => '实例规格不支持该操作'], + ['code' => 'ADBConsoleAPIError', 'message' => 'Instance console api query return failed.', 'http_code' => 503, 'description' => '实例Console API接口请求失败。'], + ['code' => 'ADBConsoleAPITimeout', 'message' => 'Instance console api query timeout.', 'http_code' => 503, 'description' => '实例Console API接口请求超时。'], + ['code' => 'ADBVersionNotSupport', 'message' => 'ADB version not support. pls upgrade the cluster version first.', 'http_code' => 400, 'description' => '当前ADB内核版本不支持，请先升级内核版本。'], + ['code' => 'AnalyticDBKernelError', 'message' => 'Failed to invoke AnalyticDB kernel.', 'http_code' => 400, 'description' => '调用ADB内核错误。'], + ['code' => 'ApiVersionForbidden', 'message' => 'The version parameter is not correct.', 'http_code' => 400, 'description' => 'Version不正确'], + ['code' => 'APS.Forbidden', 'message' => 'No permissions to access the resources: %s .', 'http_code' => 403, 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ['code' => 'ClickHouseEngineNotAllowed', 'message' => 'ClickHouse engine not allowed cause %s.', 'http_code' => 400, 'description' => '不允许开启clickhouse引擎'], + ['code' => 'COMMODITY.INVALID_COMPONENT', 'message' => 'The module you purchased is invalid.', 'http_code' => 400, 'description' => '您购买的模块不合法。请重新购买'], + ['code' => 'ConfigSyncJob.Duplicate', 'message' => 'There is another sync job configuring, please retry it later.', 'http_code' => 400, 'description' => '当前正有同步任务在配置中。请稍后再试。'], + ['code' => 'ConfigSyncJobDuplicate', 'message' => 'There is another sync job configuring, please retry it later.', 'http_code' => 400, 'description' => '已经有一个其他的同步任务正在配置中，请等待后再重试'], + ['code' => 'Console.ConnectClusterFailed', 'message' => 'Failed to connect to the database instance through the JDBC protocol.', 'http_code' => 400, 'description' => '通过JDBC协议无法连接数据库实例'], + ['code' => 'Console.ExecuteSubmitFailed', 'message' => 'Failed to submit SQL execution task.', 'http_code' => 400, 'description' => '提交SQL执行任务失败'], + ['code' => 'Console.InternalServerError', 'message' => 'Internal Server Error.', 'http_code' => 500, 'description' => '系统内部错误'], + ['code' => 'Console.MissingTraceId', 'message' => 'The trace id in the message is missing, please contact the administrator.', 'http_code' => 400, 'description' => '消息中的TRACE ID缺失，请联系管理员。'], + ['code' => 'Console.NotFound', 'message' => 'The resource is not found.', 'http_code' => 404, 'description' => '资源不存在'], + ['code' => 'Console.ParamsUnavailable', 'message' => 'The params are invalid.', 'http_code' => 400, 'description' => '输入参数非法'], + ['code' => 'Console.SendMessageFailed', 'message' => 'Failed to send websocket message to client.', 'http_code' => 400, 'description' => '向WebSocket客户端发送消息失败'], + ['code' => 'Console.SessionExpired', 'message' => 'User identity authentication failed, traceId and login ticket does not match, please login again.', 'http_code' => 400, 'description' => '用户身份认证失败，traceId与登录态Ticket不匹配，请重新登录。'], + ['code' => 'Console.SessionExpired', 'message' => 'User’s login credentials have expired, please login again.', 'http_code' => 400, 'description' => '用户的登录凭据已过期，请重新登录。'], + ['code' => 'Console.UnknownMessage', 'message' => 'This type of message is not supported, only allow `Heartbeat`, `ExecuteSQL`, `CancelExecuteSQL`', 'http_code' => 400, 'description' => '不支持此类消息，只允许`Heartbeat`、`ExecuteSQL`、`CancelExecuteSQL`'], + ['code' => 'CREATE_PROCESS_DEFINITION_ERROR', 'message' => 'Failed to create process definition.', 'http_code' => 400, 'description' => '创建工作流错误'], + ['code' => 'CrossUser.CheckFailed', 'message' => 'The input UID and role is not authorized.', 'http_code' => 403, 'description' => '跨账号鉴权失败，请检查输入的uid和role是否正确，Role是否信任adb服务账号'], + ['code' => 'DBNodeGroupCount', 'message' => 'The specified parameter "DBNodeGroupCount" is not valid.', 'http_code' => 400, 'description' => '入参DBNodeGroupCount非法'], + ['code' => 'DeleteBackupError', 'message' => 'At least one backup set must be retained.', 'http_code' => 401, 'description' => '至少需要保留一个备份集'], + ['code' => 'ElasticIOResourceCannotChange', 'message' => 'ElasticIOResource can not change.', 'http_code' => 400, 'description' => '弹性IO资源不能变更'], + ['code' => 'ElasticIOResourceInvalid', 'message' => 'ElasticIOResource Number is not valid, the range is %s to %s.', 'http_code' => 400, 'description' => '弹性IO资源个数不正确，正确的范围是1-200'], + ['code' => 'ElasticPlanParameterError', 'message' => 'The specified elastic plan parameter is invalid.', 'http_code' => 400, 'description' => '弹性计划参数错误'], + ['code' => 'Forbidden', 'message' => 'This operation is not allowed.', 'http_code' => 403, 'description' => '禁止该操作。'], + ['code' => 'Forbidden', 'message' => 'You do not have the authority to operate.', 'http_code' => 401, 'description' => '无权限触发该请求。'], + ['code' => 'IncorrectDBInstanceLockMode', 'message' => 'The specified instance lock mode does not support this operation.', 'http_code' => 400, 'description' => '实例锁定模式不支持该操作。'], + ['code' => 'IncorrectDBInstanceState', 'message' => 'The specified instance state does not support this operation.', 'http_code' => 400, 'description' => '实例状态不允许该操作'], + ['code' => 'IncorrectModuleVersion', 'message' => 'The specified module version does not support this operation.', 'http_code' => 400, 'description' => '模块版本不支持该操作。'], + ['code' => 'IncorrectTaskStatus', 'message' => 'Status of certain task does not support this operation.', 'http_code' => 403, 'description' => '当前的任务状态不支持该操作，请先确认任务状态有效。'], + ['code' => 'InsufficientResourceCapacity', 'message' => 'Insufficient resources.', 'http_code' => 400, 'description' => '资源不足。'], + ['code' => 'InternalError', 'message' => 'An error occurred while processing your request.', 'http_code' => 500, 'description' => '系统内部错误，请稍后重试'], + ['code' => 'InternalFailure', 'message' => 'An error occurred while processing your request.', 'http_code' => 500, 'description' => '系统内部错误，请稍后重试'], + ['code' => 'InternalServerError', 'message' => 'Internal Server Error', 'http_code' => 500, 'description' => '系统暂时不可用，请稍后重试'."\n"], + ['code' => 'InvalidAccountDescription.Malformed', 'message' => 'The specified parameter AccountDescription is not valid.', 'http_code' => 400, 'description' => 'AccountDescription参数不正确，请确认参数是否符合规范。'."\n"], + ['code' => 'InvalidAccountName.Malformed', 'message' => 'The specified parameter AccountName is not valid.', 'http_code' => 400, 'description' => 'AccountName不正确，请确认参数是否符合规范。'], + ['code' => 'InvalidAccountPassword.Malformed', 'message' => 'The specified parameter AccountPassword is not valid.', 'http_code' => 400, 'description' => 'AccountPassword参数不正确，请确认参数是否符合规范。'."\n"], + ['code' => 'InvalidAccountType.Malformed', 'message' => 'The specified parameter AccountType is not valid.', 'http_code' => 400, 'description' => 'AccountType参数不正确，请确认参数是否符合规范。'], + ['code' => 'InvalidAction', 'message' => 'Specified action is not valid.', 'http_code' => 400, 'description' => 'action不正确'], + ['code' => 'InvalidApi.NotFound', 'message' => 'Request was denied due to user flow control.', 'http_code' => 400, 'description' => '请求被限流'], + ['code' => 'InvalidBackupRetentionPeriod.Malformed', 'message' => 'The specified parameter BackupRetentionPeriod is not valid.', 'http_code' => 400, 'description' => 'BackupRetentionPeriod参数不正确，请确认参数是否符合规范。'."\n"], + ['code' => 'InvalidBackupRetentionPeriod.Malformed', 'message' => 'The specified parameter "BackupRetentionPeriod" should be within [7-%s] days.', 'http_code' => 400, 'description' => '数据备份保留天数错误：%s'], + ['code' => 'InvalidConnectionString.Malformed', 'message' => 'The specified parameter "ConnectionString" is not valid.', 'http_code' => 400, 'description' => '参数ConnectionString不合法'], + ['code' => 'InvalidConnectionString.UnSupported', 'message' => 'The specified parameter "ConnectionString" Only support vpc address.', 'http_code' => 400, 'description' => '参数ConnectString只支持VPC地址'], + ['code' => 'InvalidConnectionStringPrefix.Malformed', 'message' => 'The specified connection string is invalid.', 'http_code' => 400, 'description' => '连接地址无效'], + ['code' => 'InvalidDBCluster.NotFound', 'message' => 'The DBClusterId provided does not exist in our records.', 'http_code' => 404, 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['code' => 'InvalidDBClusterDescription.Malformed', 'message' => 'The specified parameter DBClusterDescription is not valid.', 'http_code' => 400, 'description' => 'DBClusterDescription参数不正确，请确认参数是否符合规范。'."\n"], + ['code' => 'InvalidDBClusterId.Malformed', 'message' => 'The specified parameter DBClusterId is not valid.', 'http_code' => 400, 'description' => 'DBClusterId参数不正确，请确认参数是否符合规范。'], + ['code' => 'InvalidDBClusterId.NotFound', 'message' => 'The DBClusterId provided does not exist in our records.', 'http_code' => 400, 'description' => '您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。'], + ['code' => 'InvalidDBClusterIPArrayName.Malformed', 'message' => 'The specified parameter DBClusterIPArrayName is not valid.', 'http_code' => 400, 'description' => 'DBClusterIPArrayName参数不正确，请确认参数是否符合规范。'."\n"], + ['code' => 'InvalidDBInstanceGroupCount', 'message' => 'Specified DB instance Group Count is not valid.', 'http_code' => 400, 'description' => '指定的节点数不正确'], + ['code' => 'InvalidElasticPlanType.Malformed', 'message' => 'The specified parameter "ElasticPlanType" is not valid.', 'http_code' => 400, 'description' => '弹性计划类型错误'], + ['code' => 'InvalidElasticPlanWorkerSpec.Malformed', 'message' => 'The specified parameter "ElasticPlanWorkerSpec" is not valid.', 'http_code' => 400, 'description' => '参数ElasticPlanWorkerSpec非法'], + ['code' => 'InvalidInput', 'message' => 'Invalid input.', 'http_code' => 400, 'description' => 'OpenAPI的输入参数无效。'], + ['code' => 'InvalidInstanceCrossBackupEnabled.Malformed', 'message' => 'The specified parameter "BackupEnabled" is not valid.', 'http_code' => 400, 'description' => '参数BackupEnabled不存在或不合法'], + ['code' => 'InvalidMaintainTime.Malformed', 'message' => 'The specified parameter MaintainTime is not valid.', 'http_code' => 400, 'description' => 'MaintainTime参数不正确，请确认参数是否符合规范。'."\n"], + ['code' => 'InvalidMaxComputeResource.Malformed', 'message' => 'The specified parameter MaxComputeResource is not valid.', 'http_code' => 400, 'description' => 'MaxComputeResource参数不正确，请确认参数是否符合规范。'."\n"], + ['code' => 'InvalidMinComputeResource.Malformed', 'message' => 'The specified parameter MinComputeResource is not valid.', 'http_code' => 400, 'description' => 'MinComputeResource参数不正确，请确认参数是否符合规范。'."\n"], + ['code' => 'InvalidOperation', 'message' => 'The specified parameter "Operation" is not valid, please choose one of Buy, Modify or Migrate.', 'http_code' => 400, 'description' => '入参Operation非法，只支持Buy、Modify或Migrate'], + ['code' => 'InvalidParameter.ComputeResource', 'message' => 'The specified parameter "ComputeResource" is not valid.', 'http_code' => 400, 'description' => '入参ComputeResource非法'], + ['code' => 'InvalidParameter.DBNodeClass', 'message' => 'The specified parameter "DBNodeClass" is not valid.', 'http_code' => 400, 'description' => '入参DBNodeClass非法'], + ['code' => 'InvalidParameter.DBNodeGroupCount', 'message' => 'The specified parameter "DBNodeGroupCount" is not valid.', 'http_code' => 400, 'description' => 'DBNodeGroupCount参数不正确'], + ['code' => 'InvalidParameter.Name', 'message' => 'The specified parameter Name is not valid.', 'http_code' => 400, 'description' => '输入参数Name缺失或错误，请确认正确性。'], + ['code' => 'InvalidParameter.Resource', 'message' => 'The specified parameter Resource is not valid.', 'http_code' => 400, 'description' => 'Resource参数不正确，请确认参数是否符合规范。'."\n"], + ['code' => 'InvalidPayType.Malformed', 'message' => 'The specified parameter "PayType" is not changed.', 'http_code' => 400, 'description' => '付费类型未做修改'], + ['code' => 'InvalidPoolName.Malformed', 'message' => 'The specified parameter PoolName is not valid.', 'http_code' => 400, 'description' => 'PoolName参数不正确，请确认参数是否符合规范。'], + ['code' => 'InvalidPoolType.Malformed', 'message' => 'The specified parameter PoolType is not valid.', 'http_code' => 400, 'description' => 'PoolType参数不正确，请确认参数是否符合规范。'], + ['code' => 'InvalidPoolUser.Malformed', 'message' => 'The specified parameter PoolUser is not valid.', 'http_code' => 400, 'description' => 'PoolUser参数不正确，请确认参数是否符合规范。'], + ['code' => 'InvalidPreferredBackupPeriod.Malformed', 'message' => 'The specified parameter PreferredBackupPeriod is not valid.', 'http_code' => 400, 'description' => 'PreferredBackupPeriod'], + ['code' => 'InvalidPreferredBackupTime.Malformed', 'message' => 'The specified parameter PreferredBackupTime is not valid.', 'http_code' => 400, 'description' => 'PreferredBackupTime参数不正确，请确认参数是否符合规范。'."\n"], + ['code' => 'InvalidRemoteBackupRegion.Malformed', 'message' => 'The specified parameter "RemoteBackupRegion" is not valid.', 'http_code' => 400, 'description' => '参数"RemoteBackupRegion"不存在或不合法'], + ['code' => 'InvalidSecurityIPList.Duplicate', 'message' => 'Specified security IP list is not valid: Duplicate IP address in the list', 'http_code' => 400, 'description' => 'IP地址重复，请确认输入是否合法'."\n"], + ['code' => 'InvalidSecurityIPList.Malformed', 'message' => 'The specified SecurityIPList is incorrectly formatted.', 'http_code' => 400, 'description' => '安全组参数不正确。'], + ['code' => 'InvalidStartTime.Malformed', 'message' => 'The specified StartTime is invalid.', 'http_code' => 400, 'description' => 'StarTime参数不正确'], + ['code' => 'InvalidTagValue.Malformed', 'message' => 'The specified parameter Tag.n.Value is invalid.', 'http_code' => 400, 'description' => '参数Tag.n.Value不正确'], + ['code' => 'InvalidUser.NotFound', 'message' => 'Specified user does not exist.', 'http_code' => 400, 'description' => '请求用户在系统中不存在'], + ['code' => 'InvalidViewName.Malformed', 'message' => 'The specified parameter "ViewName" is not valid.', 'http_code' => 400, 'description' => '入参ViewName缺失。'], + ['code' => 'InvalidVPC.NotFound', 'message' => 'VPC or VSwitch is not valid.', 'http_code' => 404, 'description' => 'VPC或VSwitch不存在'], + ['code' => 'InvalidWorkerGroupNumber', 'message' => 'Invalid worker group number, because %s.', 'http_code' => 401, 'description' => '弹性IO资源个数不正确'], + ['code' => 'InvokeSLSException', 'message' => 'Failed to invoke Log Service.', 'http_code' => 400, 'description' => '调用SLS服务发生异常。'], + ['code' => 'InvokeSLSException', 'message' => 'An exception occured while invoke SLS Service.Failed to invoke Log Service.', 'http_code' => 400, 'description' => '调用SLS服务时发生异常，调用失败'], + ['code' => 'MDS.IllegalArgument', 'message' => 'Invalid argument.', 'http_code' => 400, 'description' => '用户使用了非法参数'], + ['code' => 'MDS.InternalError', 'message' => 'An internal MDS error occurred.', 'http_code' => 500, 'description' => 'MDS服务内部错误'], + ['code' => 'MDS.InvalidPrivilege', 'message' => 'No permissions.', 'http_code' => 400, 'description' => '用户无权限进行操作'], + ['code' => 'MDS.MetaSchemaAlreadyExist', 'message' => 'The database already exists.', 'http_code' => 400, 'description' => '数据库已存在'], + ['code' => 'MDS.MetaSchemaNotExist', 'message' => 'The database does not exist.', 'http_code' => 400, 'description' => '操作的数据库不存在'], + ['code' => 'MDS.MetaTableAlreadyExist', 'message' => 'The table already exists.', 'http_code' => 400, 'description' => '操作的表已经存在'], + ['code' => 'MDS.MetaTableNotExist', 'message' => 'The table is not found.', 'http_code' => 400, 'description' => '操作的表不存在'], + ['code' => 'MDS.MetaVisitError', 'message' => 'Failed to access metadata.', 'http_code' => 500, 'description' => '访问元数据失败'], + ['code' => 'MDS.RamAuthAccessDenied', 'message' => 'ram auth access denied.', 'http_code' => 403, 'description' => 'RAM鉴权失败'], + ['code' => 'MissingEcuType', 'message' => 'EcuType is mandatory for this action.', 'http_code' => 400, 'description' => 'EcuType参数缺失'."\n"], + ['code' => 'MissingParameter.PageSize', 'message' => 'The PageSize parameter is required.', 'http_code' => 400, 'description' => '缺少PageSize参数'], + ['code' => 'MissingProjectName', 'message' => 'ProjectName is required.', 'http_code' => 400, 'description' => 'ProjectName参数为必填项。'], + ['code' => 'NotInInstanceCrossBackupWhitelist', 'message' => 'Not allow to enable instance cross backup cause dbClusterId not in whitelist.', 'http_code' => 403, 'description' => '该实例不允许调整跨地域备份配置，请联系ADB-M技术支持人员加白名单。'], + ['code' => 'OperationDenied.DBClusterPayType', 'message' => 'The specified instance pay type does not support this operation.', 'http_code' => 400, 'description' => '实例付费类型不支持该操作'], + ['code' => 'OperationDenied.DBClusterStatus', 'message' => 'The operation is not permitted due to cluster status.', 'http_code' => 403, 'description' => '当前集群状态禁止该操作。'], + ['code' => 'OperationDenied.InvalidSourceDBCluster', 'message' => 'The operation is not permitted due to pc-wz9li839to71d2659 not synchronizing with this ADB cluster', 'http_code' => 400, 'description' => '无效的源集群实例，请确认实例是否正确'."\n"], + ['code' => 'OperationDenied.OrderProcessing', 'message' => 'User already has an order which is processing.', 'http_code' => 403, 'description' => '用户已经有一个订单在处理中'], + ['code' => 'OperationDenied.OrderType', 'message' => 'The operation is not permitted due to the order type.', 'http_code' => 400, 'description' => '订单类型不正确'], + ['code' => 'OperationDenied.ParallelOperateNodeStorage', 'message' => 'Nodes and storage resources cannot be changed at the same time.', 'http_code' => 400, 'description' => '不允许同时操作修改节点和存储资源。'], + ['code' => 'OperationDenied.RegionZoneNotSupport', 'message' => 'The specified region or zone does not support this operation.', 'http_code' => 400, 'description' => '指定的region或zone不支持该操作。'], + ['code' => 'PerformanceViewNotFound', 'message' => 'Performance view not found.', 'http_code' => 404, 'description' => '没有找到指定的监控视图名'], + ['code' => 'ProcessInstanceNotCompleted', 'message' => 'Process instance not completed', 'http_code' => 400, 'description' => '工作流实例未完成，无法执行操作'], + ['code' => 'ProcessInstanceNotFailed', 'message' => 'Process instance not failed', 'http_code' => 400, 'description' => '工作流实例未失败，无法执行操作'], + ['code' => 'ProcessInstanceNotRunning', 'message' => 'Process instance not running', 'http_code' => 400, 'description' => '工作流实例未运行，无法执行操作'], + ['code' => 'ProcessInstanceNotSuspended', 'message' => 'Process instance not suspended', 'http_code' => 400, 'description' => '工作流实例未暂停，无法执行操作'], + ['code' => 'RelatedTaskNotFinish', 'message' => 'The related task does not finish.', 'http_code' => 400, 'description' => '关联任务未完成，禁止该操作。'], + ['code' => 'RemoteBackupRestoreToTimeError', 'message' => 'Remote backup restore to time is not allowed. The remote backup is not activated.', 'http_code' => 400, 'description' => '异地备份功能未开启，异地备份恢复不可用。'], + ['code' => 'RequiredParam.NotFound', 'message' => 'Required parameters are not specified.', 'http_code' => 400, 'description' => '未填写必填参数，请填写完整后重试。'], + ['code' => 'SecurityIPList.Duplicate', 'message' => 'The specified IP address is duplicate.', 'http_code' => 400, 'description' => '指定安全访问白名单IP重复'], + ['code' => 'ServiceUnavailable', 'message' => 'An error occurred while processing your request.', 'http_code' => 503, 'description' => '系统暂时不可用，请稍后重试'], + ['code' => 'Spark.AnalyzeTask.AppStateNotAccepted', 'message' => 'Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'http_code' => 400, 'description' => '只允许分析处于终止状态的 Spark app。指定 app 不满足条件。'], + ['code' => 'Spark.AnalyzeTask.FailedToKill', 'message' => 'Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.', 'http_code' => 400, 'description' => '杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。'], + ['code' => 'Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp', 'message' => 'Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.', 'http_code' => 400, 'description' => '仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。'], + ['code' => 'Spark.AnalyzeTask.NotFound', 'message' => 'The requested analysis task %s is not found.', 'http_code' => 404, 'description' => '请求查看的日志分析任务 %s 不存在。'], + ['code' => 'Spark.App.ContentNotFound', 'message' => 'The requested content %s of the Spark application is not found.', 'http_code' => 404, 'description' => '找不到指定Spark作业的提交内容。'], + ['code' => 'Spark.App.ExceedQuotaLimitation', 'message' => 'The Spark application resource request exceeds the quota limitation: %s.', 'http_code' => 400, 'description' => 'Spark 应用程序资源请求超出配额限制: %s'], + ['code' => 'Spark.App.InvalidAppTypeWhenSubmit', 'message' => 'The specified AppType is INVALID or NULL. Please refer to the documentation to correct the parameters for %s.', 'http_code' => 400, 'description' => 'AppType类型不合法，请参考使用文档指定适合业务的AppType，请关注配置类型：%s。'], + ['code' => 'Spark.App.InvalidResourceSpec', 'message' => 'The requested resource type is not supported: %s.', 'http_code' => 400, 'description' => '不支持申请的资源机型: %s'], + ['code' => 'Spark.App.KillNotAcceptable', 'message' => 'Can\'t kill the application %s in %s state.', 'http_code' => 406, 'description' => '不能删除处于不可删除状态下的 Spark 应用。'], + ['code' => 'Spark.App.KillOperationFailed', 'message' => 'Failed to kill the application %s, please retry in a few seconds.', 'http_code' => 400, 'description' => '杀死 Spark 应用失败，请稍后重试。'], + ['code' => 'Spark.App.NotFound', 'message' => 'The Spark application %s is not found.', 'http_code' => 404, 'description' => '未能找到输入的 Spark App。'], + ['code' => 'Spark.App.ParameterConflict', 'message' => 'Conflicting parameters submitted: %s.', 'http_code' => 406, 'description' => '提交Spark应用的配置参数存在冲突: %s'], + ['code' => 'Spark.App.ResourceNegativeError', 'message' => 'The requested resource MUST be positive: %s.', 'http_code' => 400, 'description' => '申请使用的Spark资源量必须为正整数: %s'], + ['code' => 'Spark.Config.InvalidAppFilePath', 'message' => 'The main driver file MUST be a valid OSS path. Current is %s.', 'http_code' => 400, 'description' => '主驱动文件地址必须是合法的OSS地址，当前的地址是 %s。'], + ['code' => 'Spark.Config.invalidConnectors', 'message' => 'The spark.adb.connectors configuration is invalid: %s', 'http_code' => 400, 'description' => 'spark.adb.connectors配置不正确。'], + ['code' => 'Spark.Config.InvalidDiskConfig', 'message' => 'The requested disk mount parameter is invalid: %s', 'http_code' => 400, 'description' => '磁盘挂载配置错误。'], + ['code' => 'Spark.Config.InvalidDiskConfig', 'message' => 'The requested disk mount parameter is invalid: %s.', 'http_code' => 400, 'description' => '磁盘挂载配置错误，相关配置参数的错误信息为%s。'], + ['code' => 'Spark.Config.InvalidHostAliasConfig', 'message' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local', 'http_code' => 400, 'description' => '域名映射配置错误。'], + ['code' => 'Spark.Config.InvalidHostAliasConfig', 'message' => 'The requested host alias parameter %s is invalid. Example: 127.0.0.1 localhost local.', 'http_code' => 400, 'description' => '域名映射配置错误。'], + ['code' => 'Spark.Config.InvalidLogOssPath', 'message' => 'The OSS address for log storage is illegal: %s', 'http_code' => 400, 'description' => '存储日志的OSS地址非法。'], + ['code' => 'Spark.Config.InvalidRoleArnFormat', 'message' => 'Configure RoleARN %s invalid format. It should match acs:ram::uid_number:role/role_name', 'http_code' => 400, 'description' => '配置的RoleARN格式错误。'], + ['code' => 'Spark.Config.InvalidRoleArnFormat', 'message' => 'Configure RoleARN %s invalid format.', 'http_code' => 400, 'description' => '配置的RoleARN %s 格式错误。'], + ['code' => 'Spark.Config.InvalidTimeZone', 'message' => 'Unable to parse time zone configuration %s : %s', 'http_code' => 400, 'description' => '时区配置错误。'], + ['code' => 'Spark.Config.InvalidTimeZone', 'message' => 'Unable to parse time zone configuration %s, %s.', 'http_code' => 400, 'description' => '时区配置错误，错误信息：%s。'], + ['code' => 'Spark.Config.LogOssPathNotExists', 'message' => 'Spark app log path %s is not exists.', 'http_code' => 400, 'description' => 'Spark日志地址%s不存在.'], + ['code' => 'Spark.Config.MainAppFileNotExists', 'message' => 'The main driver file is missing, [file] or [sqls] must be configured.', 'http_code' => 400, 'description' => '主驱动文件缺失，必须保证file或者sqls配置不为空。'], + ['code' => 'Spark.Config.OSSPathAccessError', 'message' => 'The configured OSS address %s cannot be accessed.', 'http_code' => 400, 'description' => '配置的OSS路径无法访问。'], + ['code' => 'Spark.Config.OSSPathNotExists', 'message' => 'The OSS address %s requested does not exist or the permissions are insufficient.', 'http_code' => 400, 'description' => 'OSS路径不存在或当前用户无权限访问。'], + ['code' => 'Spark.Config.RoleArnVerifyFailed', 'message' => 'RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s', 'http_code' => 400, 'description' => 'RoleARN参数校验失败。'], + ['code' => 'Spark.Config.SecurityGroupNotFound', 'message' => 'The security group in the configuration does not exist or cannot be accessed. %s.', 'http_code' => 400, 'description' => '配置的资源组不存在或者因权限不足无法访问。%s。'], + ['code' => 'Spark.Config.VswitchNotFound', 'message' => 'The vswitch in the configuration does not exist or cannot be accessed. %s.', 'http_code' => 400, 'description' => '无法找到配置虚拟机交换机，或当前账号权限不足。%s。'], + ['code' => 'Spark.Forbidden', 'message' => 'No permissions to access the resources: %s', 'http_code' => 403, 'description' => '权限不足，拒绝访问相关资源。您当前申请访问的信息是：%s。'], + ['code' => 'Spark.GetNotebookKernelStateFailed', 'message' => 'Failed to obtain the status of the notebook kernel.', 'http_code' => 400, 'description' => 'Notebook Kernel 状态查询失败'], + ['code' => 'Spark.GetSparkStatementResultFailed', 'message' => 'Get spark statement execution results failed: %s.', 'http_code' => 400, 'description' => '获取Spark代码执行结果失败: %s'], + ['code' => 'Spark.InvalidParameter', 'message' => 'Invalid parameter value: %s', 'http_code' => 400, 'description' => '输入参数不正确：%s。'], + ['code' => 'Spark.InvalidParameter', 'message' => 'Spark parameter is not valid, please check error info: %s.', 'http_code' => 400, 'description' => 'Spark参数出现错误,错误信息为: %s.'], + ['code' => 'Spark.InvalidState', 'message' => 'The object of the operation is in an invalid state: %s', 'http_code' => 400, 'description' => '操作对象处于非合法状态。'], + ['code' => 'Spark.InvalidState', 'message' => 'The object of the operation is in an invalid state: %s.', 'http_code' => 400, 'description' => '操作对象处于非合法状态 %s。'], + ['code' => 'Spark.Log.IllegalPath', 'message' => 'Invalid job log URI: %s.', 'http_code' => 400, 'description' => '配置的Spark日志路径不合法：%s。'], + ['code' => 'Spark.Log.InvalidState', 'message' => 'Failed to obtain the logs of the Spark job %s in the %s state.', 'http_code' => 400, 'description' => '无法获取指定Spark作业的日志。'], + ['code' => 'Spark.Log.PodLogNotFound', 'message' => 'Can\'t find logs of the pod by podName[%s] in the namespace[%s].', 'http_code' => 404, 'description' => '无法通过podName找到对应pod的日志 [%s]。'], + ['code' => 'Spark.NotebookNamingDuplicate', 'message' => 'The name of the notebook is duplicated, please change the name', 'http_code' => 400, 'description' => 'Notebook命名重复，请重新命名。'], + ['code' => 'Spark.NotebookNotFound', 'message' => 'The notebook is not found', 'http_code' => 400, 'description' => 'Notebook不存在，请联系管理员'], + ['code' => 'Spark.NotebookParagraphMissingProgramCode', 'message' => 'The notebook paragraph program code is missing', 'http_code' => 400, 'description' => 'Notebook段落缺少执行代码'], + ['code' => 'Spark.NotebookParagraphNotFound', 'message' => 'The notebook paragraph is not found', 'http_code' => 400, 'description' => 'Notebook段落不存在，请联系管理员'], + ['code' => 'Spark.NotebookParagraphNotRunning', 'message' => 'The notebook paragraph has not been running', 'http_code' => 400, 'description' => 'Notebook段落未运行，请先执行语句'], + ['code' => 'Spark.ObjectNotFound', 'message' => 'The object is not found. More information: %s', 'http_code' => 404, 'description' => '操作对象不存在。关联信息：%s。'], + ['code' => 'Spark.Oss.InternalError', 'message' => 'An OSS internal error occurred: %s', 'http_code' => 400, 'description' => 'OSS内部错误，请求失败。'], + ['code' => 'Spark.Resources.LoadFileFromClasspathFailed', 'message' => 'Can\'t load the content from file: %s', 'http_code' => 500, 'description' => '加载资源文件失败。'], + ['code' => 'Spark.RoleArn.Invalid', 'message' => '%s is not found, or the RAM role has not been authorized.', 'http_code' => 400, 'description' => 'RoleArn不存在或子账号未授权。'], + ['code' => 'Spark.RoleARN.invalid', 'message' => 'Current account fails to verify the permissions of the RAM system, please check the help information and configure the appropriate permissions for the current account.', 'http_code' => 400, 'description' => '请确保您当前的 RAM 用户 （ram_user_id %s） 已被授予系统策略“AliyunADBDeveloperAccess”。然后按照“在阿里云帐户内执行授权”部分进行作。这将自动初始化您的云帐户中名为“aliyunadbsparkprocessingdatarole”的系统角色。更多详细信息：https://www.alibabacloud.com/help/en/analyticdb/analyticdb-for-mysql/user-guide/create-the-aliyunadbsparkprocessingdatarole-role-for-a-ram-user-and-grant-permissions-to-the-role'], + ['code' => 'Spark.ServerError', 'message' => 'The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s', 'http_code' => 500, 'description' => 'Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。'], + ['code' => 'Spark.SQL.BlankError', 'message' => 'Input sql can not be blank string.', 'http_code' => 400, 'description' => '提交SQL不能为空。'], + ['code' => 'Spark.SQL.MultipleSQLError', 'message' => 'Element in field [sqls] can not contain more than one sql statement: %s.', 'http_code' => 400, 'description' => '提交的Spark SQL包含了多条可执行SQL。'], + ['code' => 'Spark.SQL.NotFoundExecutableSQLError', 'message' => 'No executable statements are submitted. Please check the input SQL.', 'http_code' => 400, 'description' => 'Spark作业的SQL信息中不包含可执行语句。'], + ['code' => 'Spark.SQL.NotFoundExecutableSQLError', 'message' => 'The execution part is not included in the current submitted SQL, please check the input SQL.', 'http_code' => 400, 'description' => '提交的SQL中不包含可执行内容。'], + ['code' => 'Spark.SQL.ParserError', 'message' => 'Failed to parse the SQL %s. Error message: %s.', 'http_code' => 400, 'description' => 'Spark作业信息中的SQL无法解析。'], + ['code' => 'Spark.SQL.ParserError', 'message' => 'Submit spark app failed when parser SQL %s. Error message: %s.', 'http_code' => 400, 'description' => '解析提交的Spark SQL失败。'], + ['code' => 'Spark.TemplateFile.BadFileType', 'message' => 'The requested template %s is not a file.', 'http_code' => 400, 'description' => '请求的模板文件ID不是文件类型的。'], + ['code' => 'Spark.TemplateFile.FileNotFound', 'message' => 'The template file %s is not found.', 'http_code' => 404, 'description' => '未能找到输入的模板文件。'], + ['code' => 'Spark.TemplateFile.TemplateNotFound', 'message' => 'The template %s is not found.', 'http_code' => 404, 'description' => '模板文件未找到。'], + ['code' => 'StartTimeBeforeNow', 'message' => 'The start time should not be earlier than the current time.', 'http_code' => 400, 'description' => '开始时间不得早于当前时间，请重新填写开始时间。'], + ['code' => 'SwitchTimeAfterDeadline', 'message' => 'The switch time should be earlier than deadline.', 'http_code' => 400, 'description' => '切换时间必须早于结束时间，请重新填写切换时间。'], + ['code' => 'SystemError', 'message' => 'Internal system exception: templateName cannot be empty.', 'http_code' => 400, 'description' => '发生系统内部错误'], + ['code' => 'TaskModifyError', 'message' => 'Part of the tasks cannot be modified.', 'http_code' => 400, 'description' => '部分任务无法修改，请先确认任务信息。'], + ['code' => 'Throttling.Api', 'message' => 'The request was denied due to API throttling.', 'http_code' => 403, 'description' => '请求由于流量控制被限制。'], + ['code' => 'Unauthorized', 'message' => 'Denied by sts or ram', 'http_code' => 400, 'description' => '被拒绝访问'], + ['code' => 'UserAndPoolAlreadyBind', 'message' => 'The specified user already binds the resource pool.', 'http_code' => 400, 'description' => '指定用户已绑定资源池。'], + ['code' => 'UserNotInElasticPlanWhitelist', 'message' => 'Not allow to create worker elastic plan.', 'http_code' => 400, 'description' => '不允许创建存储弹性计划。'], + ['code' => 'MDS.CatalogAlreadyExist', 'message' => 'The catalog already exists.', 'http_code' => 400, 'description' => '目录已经存在'], + ['code' => 'MDS.SemanticViewNotExist', 'message' => 'This semantic view does not exist.', 'http_code' => 400, 'description' => '此语义视图不存在'], + ['code' => 'MDS.SemanticViewAreadyExist', 'message' => 'This semantic view already exists.', 'http_code' => 400, 'description' => '此语义视图已经存在'], + ['code' => 'MDS.SemanticViewAlreadyExist', 'message' => 'The semantic view already exists.', 'http_code' => 400, 'description' => '此语义视图已经存在'], + ['code' => 'MDS.InstanceNotExist', 'message' => 'ADB instance does not exist.', 'http_code' => 404, 'description' => 'ADB 实例不存在'], + ['code' => 'MDS.RamUserAlreadyBound', 'message' => 'RAM user already bound to another user.', 'http_code' => 400, 'description' => 'Ram用户已经绑定了其他账号'], + ], + 'changeSet' => [ + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeDownloadRecords'], ], - 'schemes' => [ - 'https', + 'createdAt' => '2025-12-19T09:34:29.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateApsKafkaHudiJob'], ], - 'security' => [ - [ - 'AK' => [], + 'createdAt' => '2025-12-03T12:35:12.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBResourceGroup'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDBResourceGroup'], + ['description' => '请求参数发生变更', 'api' => 'ModifyDBResourceGroup'], + ], + 'createdAt' => '2025-12-02T15:07:54.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeAuditLogRecords'], + ], + 'createdAt' => '2025-10-27T07:49:52.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeDBResourceGroup'], + ['description' => '请求参数发生变更', 'api' => 'ModifyDBResourceGroup'], + ], + 'createdAt' => '2025-10-17T13:49:38.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeDiagnosisRecords'], + ['description' => '响应参数发生变更', 'api' => 'DescribePatternPerformance'], + ], + 'createdAt' => '2024-10-21T12:16:07.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribePerformanceViewAttribute'], + ], + 'createdAt' => '2024-10-16T02:07:29.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBResourceGroup'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDBResourceGroup'], + ['description' => '请求参数发生变更', 'api' => 'ModifyDBResourceGroup'], + ], + 'createdAt' => '2024-10-15T17:29:02.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeDBClusterAttribute'], + ], + 'createdAt' => '2024-10-14T14:44:31.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeBackups'], + ], + 'createdAt' => '2024-10-12T14:49:39.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'ModifyBackupPolicy'], + ], + 'createdAt' => '2024-10-12T03:26:45.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'ModifyBackupPolicy'], + ], + 'createdAt' => '2024-10-12T01:59:11.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeDBResourceGroup'], + ], + 'createdAt' => '2024-09-29T06:39:51.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeClusterAccessWhiteList'], + ], + 'createdAt' => '2024-09-26T08:36:30.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBCluster'], + ], + 'createdAt' => '2024-09-24T09:25:58.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'ModifyDBCluster'], + ], + 'createdAt' => '2024-09-18T13:35:01.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'SetSparkAppLogRootPath'], + ], + 'createdAt' => '2024-09-02T02:38:10.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeDiagnosisRecords'], + ], + 'createdAt' => '2024-08-30T11:11:25.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'GetTableObjects'], + ], + 'createdAt' => '2024-08-20T09:29:24.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'ModifyAuditLogConfig'], + ], + 'createdAt' => '2024-08-20T07:40:28.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBResourceGroup'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDBResourceGroup'], + ['description' => '请求参数发生变更', 'api' => 'ModifyDBResourceGroup'], + ], + 'createdAt' => '2024-08-13T16:11:52.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeSQLPatterns'], + ], + 'createdAt' => '2024-08-06T07:59:21.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeRegions'], + ], + 'createdAt' => '2024-07-24T07:15:03.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'GetTable'], + ], + 'createdAt' => '2024-07-04T08:31:18.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeJobResourceUsage'], + ], + 'createdAt' => '2024-06-30T06:27:13.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更、请求参数发生变更', 'api' => 'CreateAccount'], + ], + 'createdAt' => '2024-06-13T14:53:38.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更、请求参数发生变更', 'api' => 'AllocateClusterPublicConnection'], + ['description' => '请求参数发生变更', 'api' => 'DeleteAccount'], + ['description' => '错误码发生变更、请求参数发生变更、响应参数发生变更', 'api' => 'DescribeAccounts'], + ['description' => '错误码发生变更、请求参数发生变更、响应参数发生变更', 'api' => 'DescribeClusterNetInfo'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDBClusterAttribute'], + ['description' => '错误码发生变更、请求参数发生变更', 'api' => 'ModifyAccountDescription'], + ['description' => '请求参数发生变更', 'api' => 'ReleaseClusterPublicConnection'], + ['description' => '错误码发生变更、请求参数发生变更', 'api' => 'ResetAccountPassword'], + ], + 'createdAt' => '2024-06-13T13:51:24.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'SubmitSparkApp'], + ], + 'createdAt' => '2024-05-29T02:44:17.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeDBClusterAttribute'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDBClusters'], + ], + 'createdAt' => '2024-05-28T02:57:54.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBCluster'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDBClusterAttribute'], + ], + 'createdAt' => '2024-05-23T06:29:56.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeApsActionLogs'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDBClusterHealthStatus'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDownloadRecords'], + ['description' => '响应参数发生变更', 'api' => 'DescribeSQLPatterns'], + ], + 'createdAt' => '2024-05-14T08:32:53.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateOssSubDirectory'], + ], + 'createdAt' => '2024-05-10T06:02:02.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBCluster'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeDBClusters'], + ['description' => '请求参数发生变更', 'api' => 'ModifyDBCluster'], + ], + 'createdAt' => '2024-05-09T02:23:39.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeDBClusterAttribute'], + ], + 'createdAt' => '2024-05-08T07:37:35.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'ExistRunningSQLEngine'], + ], + 'createdAt' => '2024-05-06T03:07:06.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeApsResourceGroups'], + ], + 'createdAt' => '2024-04-10T07:29:28.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'ModifyAccountPrivileges'], + ], + 'createdAt' => '2024-04-09T11:05:47.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBResourceGroup'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDBResourceGroup'], + ['description' => '请求参数发生变更', 'api' => 'ModifyDBResourceGroup'], + ], + 'createdAt' => '2024-03-25T02:10:18.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeDBResourceGroup'], + ], + 'createdAt' => '2024-03-01T08:17:21.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBResourceGroup'], + ['description' => '响应参数发生变更', 'api' => 'DescribeClusterResourceDetail'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDBResourceGroup'], + ['description' => '请求参数发生变更', 'api' => 'ModifyDBResourceGroup'], + ], + 'createdAt' => '2024-01-26T02:34:11.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeApsActionLogs'], + ], + 'createdAt' => '2024-01-24T03:42:26.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'GetSparkAppAttemptLog'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'GetSparkAppLog'], + ], + 'createdAt' => '2024-01-18T10:52:46.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeDiagnosisSQLInfo'], + ], + 'createdAt' => '2024-01-05T06:00:22.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'GetTable'], + ], + 'createdAt' => '2023-12-21T06:37:54.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBResourceGroup'], + ['description' => '请求参数发生变更', 'api' => 'ModifyDBResourceGroup'], + ], + 'createdAt' => '2023-12-19T08:51:20.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'DescribeEnabledPrivileges'], + ], + 'createdAt' => '2023-12-18T14:02:34.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DeleteElasticPlan'], + ['description' => '响应参数发生变更', 'api' => 'DescribeElasticPlanAttribute'], + ['description' => '响应参数发生变更', 'api' => 'DescribeElasticPlanJobs'], + ['description' => '响应参数发生变更', 'api' => 'DescribeElasticPlanSpecifications'], + ['description' => '响应参数发生变更', 'api' => 'DisableElasticPlan'], + ['description' => '响应参数发生变更', 'api' => 'ModifyElasticPlan'], + ], + 'createdAt' => '2023-12-12T10:09:33.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeAuditLogRecords'], + ['description' => '请求参数发生变更', 'api' => 'DescribePatternPerformance'], + ['description' => '请求参数发生变更', 'api' => 'DescribeSQLPatterns'], + ], + 'createdAt' => '2023-12-08T02:33:47.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'DescribeAccountAllPrivileges'], + ['description' => '错误码发生变更、请求参数发生变更', 'api' => 'DescribeAccountPrivilegeObjects'], + ['description' => '错误码发生变更、请求参数发生变更', 'api' => 'DescribeAccountPrivileges'], + ['description' => '请求参数发生变更', 'api' => 'DescribeEnabledPrivileges'], + ], + 'createdAt' => '2023-12-06T02:33:03.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'GetSparkAppInfo'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'GetSparkAppLog'], + ['description' => '请求参数发生变更', 'api' => 'GetSparkAppMetrics'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'GetSparkAppState'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'GetSparkAppWebUiAddress'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'KillSparkApp'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'ListSparkAppAttempts'], + ['description' => '请求参数发生变更', 'api' => 'PreloadSparkAppMetrics'], + ], + 'createdAt' => '2023-11-23T05:56:33.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeUserQuota'], + ], + 'createdAt' => '2023-11-06T09:35:32.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeAdbMySqlColumns'], + ['description' => '请求参数发生变更', 'api' => 'DescribeAdbMySqlTables'], + ], + 'createdAt' => '2023-11-02T03:45:36.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'GetDatabaseObjects'], + ['description' => '请求参数发生变更', 'api' => 'GetTableColumns'], + ['description' => '请求参数发生变更', 'api' => 'GetTableDDL'], + ['description' => '请求参数发生变更', 'api' => 'GetTableObjects'], + ['description' => '请求参数发生变更', 'api' => 'GetViewDDL'], + ['description' => '请求参数发生变更', 'api' => 'GetViewObjects'], + ], + 'createdAt' => '2023-10-25T05:35:53.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'DescribeElasticPlanAttribute'], + ], + 'createdAt' => '2023-10-23T02:55:38.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeDBClusterAttribute'], + ], + 'createdAt' => '2023-09-26T07:36:32.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBResourceGroup'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDBResourceGroup'], + ['description' => '请求参数发生变更', 'api' => 'ModifyDBResourceGroup'], + ], + 'createdAt' => '2023-09-25T10:08:28.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeDBClusterPerformance'], + ['description' => '请求参数发生变更', 'api' => 'DescribeDiagnosisDimensions'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeDiagnosisRecords'], + ['description' => '请求参数发生变更', 'api' => 'DescribeSqlPattern'], + ['description' => '请求参数发生变更', 'api' => 'DescribeTableAccessCount'], + ['description' => '请求参数发生变更', 'api' => 'DownloadDiagnosisRecords'], + ], + 'createdAt' => '2023-09-13T12:07:31.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'GetSparkAppAttemptLog'], + ], + 'createdAt' => '2023-09-01T08:22:48.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBCluster'], + ], + 'createdAt' => '2023-08-28T06:20:09.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeAllDataSource'], + ['description' => '请求参数发生变更', 'api' => 'DescribeColumns'], + ['description' => '请求参数发生变更', 'api' => 'DescribeTables'], + ], + 'createdAt' => '2023-08-25T03:36:59.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBCluster'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDBClusterAttribute'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeDBClusters'], + ['description' => '请求参数发生变更', 'api' => 'ModifyDBCluster'], + ], + 'createdAt' => '2023-07-27T11:22:23.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'GetSparkAppAttemptLog'], + ['description' => '错误码发生变更', 'api' => 'GetSparkConfigLogPath'], + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'GetSparkLogAnalyzeTask'], + ['description' => '错误码发生变更', 'api' => 'GetSparkTemplateFolderTree'], + ['description' => '错误码发生变更', 'api' => 'GetSparkTemplateFullTree'], + ['description' => '错误码发生变更', 'api' => 'KillSparkLogAnalyzeTask'], + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'ListSparkLogAnalyzeTasks'], + ['description' => '错误码发生变更', 'api' => 'ListSparkTemplateFileIds'], + ], + 'createdAt' => '2023-07-27T05:10:32.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'StartSparkSQLEngine'], + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'SubmitSparkApp'], + ], + 'createdAt' => '2023-07-27T01:59:19.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'CreateElasticPlan'], + ['description' => '错误码发生变更', 'api' => 'EnableElasticPlan'], + ], + 'createdAt' => '2023-06-30T02:18:44.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeApsActionLogs'], + ], + 'createdAt' => '2023-06-21T09:28:13.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'ModifyDBCluster'], + ], + 'createdAt' => '2023-06-21T03:39:22.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'CreateSparkTemplate'], + ['description' => '错误码发生变更', 'api' => 'DeleteSparkTemplate'], + ['description' => '错误码发生变更', 'api' => 'DeleteSparkTemplateFile'], + ['description' => '错误码发生变更', 'api' => 'GetSparkAppInfo'], + ['description' => '错误码发生变更', 'api' => 'GetSparkAppLog'], + ['description' => '错误码发生变更', 'api' => 'GetSparkAppMetrics'], + ['description' => '错误码发生变更', 'api' => 'GetSparkAppState'], + ['description' => '错误码发生变更', 'api' => 'GetSparkAppWebUiAddress'], + ['description' => '错误码发生变更', 'api' => 'GetSparkDefinitions'], + ['description' => '错误码发生变更', 'api' => 'GetSparkSQLEngineState'], + ], + 'createdAt' => '2023-06-19T09:40:53.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeSQLPatterns'], + ], + 'createdAt' => '2023-06-08T06:16:52.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribePatternPerformance'], + ], + 'createdAt' => '2023-06-08T03:15:13.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'BindAccount'], + ['description' => '错误码发生变更', 'api' => 'DeleteDBResourceGroup'], + ], + 'createdAt' => '2023-06-07T15:59:38.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeElasticPlans'], + ], + 'createdAt' => '2023-06-02T01:37:46.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeApsResourceGroups'], + ], + 'createdAt' => '2023-05-09T09:42:50.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'ModifyDBCluster'], + ], + 'createdAt' => '2023-05-08T16:27:56.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'BindAccount'], + ['description' => '错误码发生变更', 'api' => 'DescribeAccountAllPrivileges'], + ['description' => '错误码发生变更', 'api' => 'DescribeAccountPrivilegeObjects'], + ['description' => '错误码发生变更', 'api' => 'DescribeAccountPrivileges'], + ['description' => '错误码发生变更', 'api' => 'DescribeEnabledPrivileges'], + ['description' => '错误码发生变更', 'api' => 'ModifyAccountPrivileges'], + ], + 'createdAt' => '2023-04-20T14:38:30.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'CreateElasticPlan'], + ], + 'createdAt' => '2023-04-14T08:50:53.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'CreateDBResourceGroup'], + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'CreateElasticPlan'], + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'DeleteDBCluster'], + ['description' => '错误码发生变更', 'api' => 'DeleteDBResourceGroup'], + ['description' => '错误码发生变更', 'api' => 'DeleteElasticPlan'], + ['description' => '错误码发生变更', 'api' => 'DescribeElasticPlanAttribute'], + ['description' => '错误码发生变更', 'api' => 'DescribeElasticPlanJobs'], + ['description' => '错误码发生变更', 'api' => 'DescribeElasticPlans'], + ['description' => '错误码发生变更', 'api' => 'DescribeElasticPlanSpecifications'], + ['description' => '错误码发生变更', 'api' => 'DisableElasticPlan'], + ], + 'createdAt' => '2023-04-13T06:37:09.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'AllocateClusterPublicConnection'], + ['description' => '错误码发生变更', 'api' => 'BindAccount'], + ['description' => '错误码发生变更', 'api' => 'CreateAccount'], + ['description' => '错误码发生变更', 'api' => 'CreateDBResourceGroup'], + ['description' => '错误码发生变更', 'api' => 'DeleteAccount'], + ['description' => '错误码发生变更', 'api' => 'DeleteDBResourceGroup'], + ['description' => '错误码发生变更', 'api' => 'DescribeAccounts'], + ['description' => '错误码发生变更', 'api' => 'DescribeClusterAccessWhiteList'], + ['description' => '错误码发生变更', 'api' => 'DescribeDBResourceGroup'], + ['description' => '错误码发生变更', 'api' => 'ModifyAccountDescription'], + ], + 'createdAt' => '2023-03-31T07:03:50.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeApsActionLogs'], + ], + 'createdAt' => '2023-03-30T02:43:18.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeAccountAllPrivileges'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeAccountPrivilegeObjects'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeAccountPrivileges'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeEnabledPrivileges'], + ['description' => '请求参数发生变更', 'api' => 'ModifyAccountPrivileges'], + ], + 'createdAt' => '2023-03-24T06:24:36.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'GetDatabaseObjects'], + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'GetTable'], + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'GetTableColumns'], + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'GetTableDDL'], + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'GetTableObjects'], + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'GetViewDDL'], + ['description' => '错误码发生变更、响应参数发生变更', 'api' => 'GetViewObjects'], + ], + 'createdAt' => '2023-03-22T02:15:55.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeDiagnosisSQLInfo'], + ], + 'createdAt' => '2023-01-03T03:57:06.000Z', + 'description' => '修复stage信息中的operatorCost映射', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeDiagnosisSQLInfo'], + ], + 'createdAt' => '2022-12-15T11:36:50.000Z', + 'description' => '查询诊断信息提供stage统计信息', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DeleteDBCluster'], + ], + 'createdAt' => '2022-11-16T06:07:19.000Z', + 'description' => '修正deleteDBCluster返回参数', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'DescribeBackupPolicy'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeBackups'], + ['description' => 'OpenAPI 下线', 'api' => 'ModifyBackupPolicy'], + ], + 'createdAt' => '2022-11-16T06:03:56.000Z', + 'description' => '支持备份策略', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'ListAuthorizedUsers'], + ['description' => '请求参数发生变更', 'api' => 'ListUnauthorizedUsers'], + ], + 'createdAt' => '2022-11-15T04:31:59.000Z', + 'description' => '不发布', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBCluster'], + ], + 'createdAt' => '2022-11-07T06:20:54.000Z', + 'description' => '修改PayType参数为必填', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDBCluster'], + ['description' => '请求参数发生变更', 'api' => 'DeleteDBCluster'], + ['description' => '响应参数发生变更', 'api' => 'DescribeDBClusterAttribute'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeDBClusters'], + ['description' => '请求参数发生变更', 'api' => 'ModifyDBCluster'], + ], + 'createdAt' => '2022-11-03T03:02:21.000Z', + 'description' => '调整参数正确性', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'DescribeApsActionLogs'], + ], + 'createdAt' => '2022-11-01T17:22:54.000Z', + 'description' => '增加任务日志API', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeDBClusterAttribute'], + ], + 'createdAt' => '2022-09-27T12:01:23.000Z', + 'description' => '提供默认engineVersion', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'DescribeRegions'], + ], + 'createdAt' => '2022-09-27T11:59:58.000Z', + 'description' => 'adb5.0 feature', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'StartProcessInstance'], + ], + 'createdAt' => '2022-09-22T09:27:02.000Z', + 'description' => 'none', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'StartCheckProcessDefinition'], + ['description' => '请求参数发生变更', 'api' => 'StartCheckProcessDefinition'], + ], + 'createdAt' => '2022-09-16T07:56:56.000Z', + 'description' => '非公开', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CancelAsyncSqlByJobId'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeAsyncResultsByJobId'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeSparkCodeLog'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeSparkCodeOutput'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeSparkCodeWebUi'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'ExecuteAsyncSql'], + ], + 'createdAt' => '2022-09-06T02:43:16.000Z', + 'description' => '没有sdk', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DescribeDBClusterPerformance'], + ], + 'createdAt' => '2022-09-01T08:51:18.000Z', + 'description' => '内测接口', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'DescribeDBClusterHealthStatus'], + ], + 'createdAt' => '2022-09-01T03:16:56.000Z', + 'description' => '内侧接口', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeSqlEditorHistory'], + ], + 'createdAt' => '2022-08-25T11:38:01.000Z', + 'description' => 'a', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'ExecuteSyncSql'], + ], + 'createdAt' => '2022-08-24T08:10:34.000Z', + 'description' => '不需要', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeSqlEditorHistory'], + ], + 'createdAt' => '2022-08-16T03:04:39.000Z', + 'description' => '不需要', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'CancelAsyncSqlByJobId'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeAsyncResultsByJobId'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeAsyncResultsDownloadUrlByJobId'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeSqlEditorHistory'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeSqlEditorHistoryDimensions'], + ['description' => 'OpenAPI 下线', 'api' => 'ExecuteAsyncSql'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'ExecuteSyncSql'], + ], + 'createdAt' => '2022-08-10T06:38:28.000Z', + 'description' => '不输出SDK', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'DescribeApsResourceGroups'], + ], + 'createdAt' => '2022-08-08T07:29:14.000Z', + 'description' => 'APS API 首次发布', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeDiagnosisSQLInfo'], + ], + 'createdAt' => '2022-07-26T03:56:16.000Z', + 'description' => 'rchost设置为非必选', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'DescribeDiagnosisSQLInfo'], + ], + 'createdAt' => '2022-07-26T03:53:29.000Z', + 'description' => '查询提交时间和状态非必选', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'ListSparkAppAttempts'], + ['description' => '请求参数发生变更', 'api' => 'ListSparkApps'], + ], + 'createdAt' => '2022-07-19T03:29:03.000Z', + 'description' => '将Spark的Filter和DeleteLog参数可见性配置为私有, 当前 ADB Spark无真实线上用户, 预期不会影响任何用户使用.', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'CreateOssSubDirectory'], + ['description' => 'OpenAPI 下线', 'api' => 'GetLakehouseValidResourceGroups'], + ], + 'createdAt' => '2022-06-22T08:55:31.000Z', + 'description' => 'lakehose api 发布', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'DescribeAuditLogConfig'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeAuditLogRecords'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeDBClusterForecast'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeDiagnosisDimensions'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeDiagnosisSQLInfo'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeDownloadRecords'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribePatternPerformance'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeSqlPattern'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeSQLPatternAttribute'], + ], + 'createdAt' => '2022-06-22T04:05:55.000Z', + 'description' => '内测暂不对外发布', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'AllocateClusterPublicConnection'], + ['description' => 'OpenAPI 下线', 'api' => 'BindAccount'], + ['description' => 'OpenAPI 下线', 'api' => 'CheckBindRamUser'], + ['description' => 'OpenAPI 下线', 'api' => 'CreateAccount'], + ['description' => 'OpenAPI 下线', 'api' => 'CreateDBCluster'], + ['description' => 'OpenAPI 下线', 'api' => 'CreateDBResourceGroup'], + ['description' => 'OpenAPI 下线', 'api' => 'DeleteAccount'], + ['description' => 'OpenAPI 下线', 'api' => 'DeleteDBCluster'], + ['description' => 'OpenAPI 下线', 'api' => 'DeleteDBResourceGroup'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeAccounts'], + ], + 'createdAt' => '2022-06-11T16:53:04.000Z', + 'description' => '新增5.0OpenApi接口', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'DescribeDBClusterPerformance'], + ['description' => 'OpenAPI 下线', 'api' => 'DescribeDiagnosisRecords'], + ], + 'createdAt' => '2022-03-22T08:52:04.000Z', + 'description' => '内测发布', + ], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreatePerformanceView'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CancelSparkReplStatement'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDownloadRecords'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkReplSession'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAccountAllPrivileges'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ExecuteSparkReplStatement'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsProgress'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'RunMaterializedViewRecommend'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'UpgradeKernelVersion'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeResourceGroupSpec'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteBackups'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDiagnosisSQLInfo'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DisableAdviceService'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeletePerformanceView'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkAppWebUiAddress'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAdbMySqlTables'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'UpdateApsWebhook'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyCompactionServiceSwitch'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateAccount'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeTableStatistics'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteElasticPlan'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'KillSparkSQLEngine'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyClusterAccessWhiteList'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteSparkTemplateFile'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeElasticPlanSpecifications'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeLakeCacheSize'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAuditLogRecords'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateApsKafkaHudiJob'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBClusterResourceGroup'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'BatchApplyAdviceByIdList'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribePatternPerformance'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'KillSparkLogAnalyzeTask'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBResourceGroup'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyClickhouseEngine'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsJobs'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsActionLogs'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBClusterSpaceSummary'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyAccountPrivileges'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EnableElasticPlan'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBClusterMaintainTime'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkSQLDiagnosisList'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DownloadDiagnosisRecords'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsHiveWorkload'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeBackups'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeEssdCacheConfig'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'LoadSampleDataSet'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SubmitSparkApp'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkAuditLogRecords'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyApsJob'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteSparkTemplate'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DetachUserENI'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'RevokeOperatorPermission'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeControllerDetection'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeViewJobs'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkAppMetrics'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyAuditLogConfig'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'BindAccount'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAdbMySqlIndexes'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribePerformanceViews'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkAppDiagnosisInfo'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListLakeStorages'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribePerformanceViewAttribute'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetTableObjects'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GrantOperatorPermission'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAllDataSource'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeMvRecommendTasks'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeStorageResourceUsage'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBCluster'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeTablePartitionDiagnose'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DownloadInstanceCACertificate'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsDatasources'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeElasticPlanAttribute'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAPSADBInstances'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkAppInfo'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeInclinedNodes'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyAutoRenewalAttribute'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBClusterPerformance'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAutoRenewalAttribute'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ApplyAdviceById'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteMaterializedViewRecommend'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'BindDBResourceGroupWithUser'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListSparkApps'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAbnormalPatternDetection'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListResultExportJobHistory'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsMigrationWorkloads'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CheckBindRamUser'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsResourceGroups'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteDBResourceGroup'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateOssSubDirectory'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateElasticPlan'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAdbMySqlColumns'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAdviceServiceEnabled'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SuspendApsJob'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateLakeStorage'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateBackup'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateApsHiveJob'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBClusterAttribute'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeOversizeNonPartitionTableInfos'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'StartSparkSQLEngine'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeDBClusters'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDiagnosisDimensions'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeHistoryTasks'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateApsSlsADBJob'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'KillSparkApp'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CheckSampleDataSet'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteApsDatasoure'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSQLWebSocketDomain'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifySqlTemplatePosition'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'KillProcess'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListSparkWarehouseBatchSQL'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAccountPrivilegeObjects'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeExcessivePrimaryKeys'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSqlPattern'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkSQLDiagnosisAttribute'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteAccount'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeComputeResourceUsage'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeMvRecommendSubTasks'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ResetAccountPassword'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'StartApsJob'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteApsWebhook'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeTableAccessCount'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyApsSlsADBJob'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyPerformanceView'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListSparkAppAttempts'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'PreloadSparkAppMetrics'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ConfigureResultExport'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetViewObjects'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkTemplateFileContent'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkTemplateFullTree'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyAccountDescription'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeClusterNetInfo'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyApsWorkloadName'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetLakeStorage'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAccountPrivileges'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkAppType'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeWorkerDetection'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteDBCluster'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeClusterResourceDetail'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateApsDatasoure'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyUserEniVswitchOptions'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeOperatorPermission'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeProcessList'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteApsJob'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkAppState'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeJobResourceUsage'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SubmitSparkLogAnalyzeTask'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBClusterStatus'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ExistRunningSQLEngine'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetTable'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyMaterializedViewRecommend'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyLakeCacheSize'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyBackupPolicy'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkAppLog'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateDBCluster'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsDatasource'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListSparkLogAnalyzeTasks'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAppliedAdvices'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeHistoryTasksStat'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'UnbindAccount'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkConfigLogPath'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'UpdateLakeStorage'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetViewDDL'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBResourceGroup'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateApsWebhook'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateApsCopyWorkload'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeEnabledPrivileges'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeApsJobDetail'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAvailableAdvices'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSchemas'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkWarehouseBatchSQL'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBClusterDescription'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeColumns'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ExecuteSparkWarehouseBatchSQL'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'UpdateSparkTemplateFile'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeMVRecommendResults'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteLakeStorage'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeUserQuota'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeCompactionServiceSwitch'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'StartSparkReplSession'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EnableAdviceService'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'AttachUserENI'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkCodeLog'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetTableDDL'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkLogAnalyzeTask'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyEssdCacheConfig'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBClusterSSL'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAdbMySqlTableMeta'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDBClusterHealthStatus'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListSparkTemplateFileIds'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListTagResources'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyMaterializedView'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkAppAttemptLog'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeExecutorDetection'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetADBSparkNecessaryRAMPermissions'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkCodeOutput'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyApsDatasoure'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeClusterAccessWhiteList'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SubmitResultExportJob'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeClusterResourceUsage'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyElasticPlan'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DisableElasticPlan'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSQLPatterns'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateAPSJob'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeResultExportConfig'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBClusterVip'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CancelSparkWarehouseBatchSQL'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ReleaseClusterPublicConnection'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkTemplateFolderTree'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeElasticPlanJobs'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ModifyDBClusterSSL'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeTables'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateSparkTemplate'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeBadSqlDetection'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkReplStatement'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeInclinedTables'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeKernelVersion'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeElasticPlans'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'UnbindDBResourceGroupWithUser'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateDBResourceGroup'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetDatabaseObjects'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetTableColumns'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeRegions'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateMaterializedViewRecommend'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDiagnosisRecords'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetCreateTableSQL'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAccounts'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAdbMySqlSchemas'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSparkCodeWebUi'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SetSparkAppLogRootPath'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeTableDetail'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetSparkSQLEngineState'], + ['threshold' => '500', 'countWindow' => 60, 'regionId' => '*', 'api' => 'AllocateClusterPublicConnection'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeBackupPolicy'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ListApsWebhook'], + ], + ], + 'ram' => [ + 'productCode' => 'ADB', + 'productName' => '云原生数据仓库AnalyticDB MySQL版', + 'ramCodes' => ['adb'], + 'ramLevel' => '资源级', + 'ramConditions' => [ + [ + 'name' => 'adb:DiskEncryption', + 'schema' => [ + 'type' => 'String', + 'description' => '是否开启云盘加密', + 'enums' => ['true', 'false'], + ], + ], + [ + 'name' => 'adb:EnableSSL', + 'schema' => [ + 'type' => 'String', + 'description' => '是否开启SSL加密链接', + 'enums' => ['true', 'false'], + ], + ], + ], + 'ramActions' => [ + [ + 'apiName' => 'ExecuteSparkWarehouseBatchSQL', + 'description' => '批量执行Spark SQL', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:ExecuteSparkWarehouseBatchSQL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], - 'operationType' => 'write', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'ReleaseClusterPublicConnection', + 'description' => '释放公网地址', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:ReleaseClusterPublicConnection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'UpdateApsWebhook', + 'description' => '更新Webhook配置', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:UpdateApsWebhook', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SetSparkAppLogRootPath', + 'description' => '更改用户Spark的日志配置', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:SetSparkAppLogRootPath', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeDBClusterSSL', + 'description' => '查询ADB实例的SSL配置', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeDBClusterSSL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'GetTableObjects', + 'description' => '查询表信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getTableObjects', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeExecutorDetection', + 'description' => '计算节点检测', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeExecutorDetection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeSparkCodeOutput', + 'description' => '查询产品的代码配置详情', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkCodeOutput', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CreateApsHiveJob', + 'description' => '创建APS Hive任务', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateApsHiveJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'CreateElasticPlan', + 'description' => '创建弹性计划', 'operationType' => 'create', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '216925', - 'abilityTreeNodes' => [ - 'FEATUREadsQO9FPM', + 'ramAction' => [ + 'action' => 'adb:CreateElasticPlan', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => 'RegionId', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-hangzhou', + [ + 'apiName' => 'DescribeTableStatistics', + 'description' => '查看表统计信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeTableStatistics', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'Description', - 'in' => 'formData', - 'schema' => [ - 'title' => '湖存储描述', - 'description' => '湖存储描述', - 'type' => 'string', - 'required' => false, - 'example' => 'test', + ], + [ + 'apiName' => 'DescribeDBClusters', + 'description' => '查询集群列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDBClusters', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'title' => 'ADB实例ID', - 'description' => '湖存储绑定的ADB实例ID', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-******', + ], + [ + 'apiName' => 'ListApsWebhook', + 'description' => '查询Webhook', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:ListApsWebhook', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'Permissions', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'title' => '湖存储权限', - 'description' => '创建湖存储时会自动给操作的RAM账号和主账号加上权限，此处可以增加额外的主账号授权', - 'type' => 'array', - 'items' => [ - 'title' => '权限项', - 'description' => '权限项', - 'type' => 'object', - 'properties' => [ - 'Read' => [ - 'title' => '读权限', - 'description' => '读权限', - 'type' => 'boolean', - 'required' => false, - 'example' => '-', - ], - 'Write' => [ - 'title' => '写权限', - 'description' => '写权限', - 'type' => 'boolean', - 'required' => false, - 'example' => '-', - ], - 'Account' => [ - 'title' => '账户ID', - 'description' => '账户ID', - 'type' => 'string', - 'required' => false, - 'example' => '-', - 'pattern' => '^\\d+$', - 'default' => '', - ], - 'Type' => [ - 'title' => '账户类型', - 'description' => '账户类型', - 'type' => 'string', - 'required' => false, - 'example' => '-', - 'enum' => [ - 'CUSTOMER', - 'SUB', - 'STS', - ], - ], - ], - 'required' => false, - ], - 'required' => false, - 'example' => '-', + ], + [ + 'apiName' => 'DeletePerformanceView', + 'description' => '删除监控视图', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeletePerformanceView', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'ClientToken', - 'in' => 'query', - 'allowEmptyValue' => false, - 'schema' => [ - 'title' => '幂等参数', - 'description' => '-', - 'type' => 'string', - 'required' => false, - 'example' => '******', + ], + [ + 'apiName' => 'CreateApsDatasoure', + 'description' => '创建APS数据源', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateApsDatasoure', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#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' => 'Id of the request', - 'type' => 'string', - 'example' => '******', - ], - 'Message' => [ - 'title' => '若创建接口为异步实现，则需返回明确的JobId。', - 'description' => '若创建接口为异步实现，则需返回明确的JobId。', - 'type' => 'string', - 'example' => 'OK', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => 'InvalidInput', - ], - 'Data' => [ - 'description' => '集群资源使用详情。', - 'type' => 'string', - 'example' => 'true', - ], - ], + [ + 'apiName' => 'CheckBindRamUser', + 'description' => '查询当前RAM用户是否绑定数据库账号', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:CheckBindRamUser', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - '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.', + [ + 'apiName' => 'DescribeInclinedTables', + 'description' => '查看表监控', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeInclinedTables', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + [ + 'apiName' => 'ModifyLakeCacheSize', + 'description' => '修改湖存储缓存空间', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:ModifyLakeCacheSize', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"******\\",\\n \\"Message\\": \\"OK\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Success\\": true,\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Data\\": \\"true\\"\\n}","type":"json"}]', - 'title' => '创建湖存储', - ], - 'DeleteLakeStorage' => [ - 'summary' => '删除湖存储。', - 'methods' => [ - 'post', + [ + 'apiName' => 'RevokeOperatorPermission', + 'description' => '取消授权服务账号', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:RevokeOperatorPermission', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}'], + ], + ], ], - 'schemes' => [ - 'https', + [ + 'apiName' => 'UnbindAccount', + 'description' => '解绑RAM用户与数据库账号', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:UnbindAccount', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'CreatePerformanceView', + 'description' => '创建自定义监控视图', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreatePerformanceView', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'write', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'ModifyPerformanceView', + 'description' => '修改自定义监控视图', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyPerformanceView', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeInclinedNodes', + 'description' => '查询存储节点磁盘水位', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeInclinedNodes', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ModifyClickhouseEngine', + 'description' => '开启和修改宽表引擎', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyClickhouseEngine', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DownloadInstanceCACertificate', + 'description' => '获取证书下载地址', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DownloadInstanceCACertificate', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'SubmitSparkLogAnalyzeTask', + 'description' => '提交Spark日志分析任务', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:SubmitSparkLogAnalyzeTask', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribePerformanceViews', + 'description' => '获取监控视图列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribePerformanceViews', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeApsJobs', + 'description' => '查询APS任务列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeApsJobs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeElasticPlanJobs', + 'description' => '查询弹性计划作业列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeElasticPlanJobs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribePerformanceViewAttribute', + 'description' => '查看监控视图详情', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribePerformanceViewAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeSparkCodeLog', + 'description' => '查询产品的代码日志', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkCodeLog', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DisableElasticPlan', + 'description' => '停用弹性计划', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:DisableElasticPlan', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ModifyMaterializedView', + 'description' => '修改物化视图', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyMaterializedView', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteLakeStorage', + 'description' => '删除湖存储', 'operationType' => 'delete', - 'abilityTreeCode' => '216926', - 'abilityTreeNodes' => [ - 'FEATUREadsQO9FPM', + 'ramAction' => [ + 'action' => 'adb:DeleteLakeStorage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'cn-beijing', + [ + 'apiName' => 'ModifyApsDatasoure', + 'description' => '修改APS数据源', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyApsDatasoure', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'LakeStorageId', - 'in' => 'formData', - 'schema' => [ - 'title' => '实例 ID。', - 'description' => '湖存储实例 ID。', - 'type' => 'string', - 'required' => true, - 'example' => '-', + ], + [ + 'apiName' => 'ExecuteSparkReplStatement', + 'description' => '执行Spark作业中的部分代码', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:ExecuteSparkReplStatement', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbClusterId}/resourcegroup/{#resourceGroupName}/sparkapp/{#sparkAppId}'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => 'ADB实例ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-bp*********', + ], + [ + 'apiName' => 'CreateOssSubDirectory', + 'description' => '创建oss目录', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateOssSubDirectory', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#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' => '请求ID。', - 'type' => 'string', - 'example' => '2******-B2C1-408E-AA73-DB8D59******', - ], - 'Message' => [ - 'title' => '若创建接口为异步实现，则需返回明确的JobId。', - 'description' => '若创建接口为异步实现，则需返回明确的JobId。', - 'type' => 'string', - 'example' => 'Success', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP状态码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Success' => [ - 'description' => '调用是否成功。'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Code' => [ - 'description' => '状态码。说明 200表示成功。', - 'type' => 'string', - 'example' => '200', - ], - 'Data' => [ - 'description' => '删除结果。', - 'type' => 'string', - 'example' => 'True', - ], - ], + [ + 'apiName' => 'DescribeElasticPlans', + 'description' => '查询弹性计划列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeElasticPlans', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - '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.', + [ + 'apiName' => 'DescribeApsResourceGroups', + 'description' => '查询资源组信息', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsResourceGroups', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + [ + 'apiName' => 'DescribeApsProgress', + 'description' => '查询APS进度', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsProgress', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2******-B2C1-408E-AA73-DB8D59******\\",\\n \\"Message\\": \\"Success\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Data\\": \\"True\\"\\n}","type":"json"}]', - 'title' => '删除湖存储', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - 'ModifyLakeCacheSize' => [ - 'summary' => '修改集群湖存储加速缓存空间大小。', - 'methods' => [ - 'post', - 'get', + [ + 'apiName' => 'DescribeAutoRenewalAttribute', + 'description' => '查询包年包月集群自动续费状态', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeAutoRenewalAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'schemes' => [ - 'http', - 'https', + [ + 'apiName' => 'DescribeLakeCacheSize', + 'description' => '查询湖存储缓存空间设置', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeLakeCacheSize', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'DescribeDBClusterSpaceSummary', + 'description' => '查看集群的空间概览', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeDBClusterSpaceSummary', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'DescribeApsJobDetail', + 'description' => '查询APS任务详情', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsJobDetail', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CreateSparkTemplate', + 'description' => '创建Spark应用模板', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateSparkTemplate', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ModifyDBResourceGroup', + 'description' => '修改资源组', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBResourceGroup', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'CancelSparkReplStatement', + 'description' => '终止Spark作业中的部分代码块', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CancelSparkReplStatement', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbClusterId}/resourcegroup/{#resourceGroupName}/sparkapp/{#sparkAppId}/{#sparkStatmentId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeAppliedAdvices', + 'description' => '显示已采纳的优化', 'operationType' => 'get', - 'abilityTreeCode' => '214852', - 'abilityTreeNodes' => [ - 'FEATUREadsCQJTKP', + 'ramAction' => [ + 'action' => 'adb:DescribeAppliedAdvices', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp10yt0gva71ei7d', + [ + 'apiName' => 'ModifyAutoRenewalAttribute', + 'description' => '设置包年包月集群自动续费状态', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyAutoRenewalAttribute', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'EnableLakeCache', - 'in' => 'query', - 'schema' => [ - 'description' => '是否开启湖存储加速', - 'type' => 'boolean', - 'required' => true, - 'docRequired' => true, - 'enumValueTitles' => [ - 'true' => 'true', - 'false' => 'false', - ], - 'example' => 'true', + ], + [ + 'apiName' => 'GrantOperatorPermission', + 'description' => '授予服务账号权限', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:GrantOperatorPermission', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}'], ], ], - [ - 'name' => 'Capacity', - 'in' => 'query', - 'schema' => [ - 'description' => '缓存空间大小设置，单位为GB', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '100', + ], + [ + 'apiName' => 'CreateApsCopyWorkload', + 'description' => '创建APS复制链路', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateApsCopyWorkload', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', - 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '494486CE-6F49-574E-B304-29127EA12E36', - ], - 'Code' => [ - 'description' => '状态码。说明 200表示成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Data' => [ - 'description' => '返回结果数据。', - 'type' => 'object', - 'properties' => [ - 'Instances' => [ - 'description' => '共享湖存储缓存空间的集群列表', - 'type' => 'array', - 'items' => [ - 'description' => '集群ID', - 'type' => 'string', - 'example' => 'amv-bp10yt0gva71ei7d', - ], - ], - 'Capacity' => [ - 'description' => '湖存储缓存空间大小，单位为GB', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'DataSize' => [ - 'description' => '已使用的湖存储缓存空间容量，单位为GB', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - ], - ], - ], + [ + 'apiName' => 'DescribeBadSqlDetection', + 'description' => 'BadSQL检测', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeBadSqlDetection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"494486CE-6F49-574E-B304-29127EA12E36\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"Instances\\": [\\n \\"amv-bp10yt0gva71ei7d\\"\\n ],\\n \\"Capacity\\": 100,\\n \\"DataSize\\": 100\\n }\\n}","type":"json"}]', - 'title' => '修改湖存储缓存空间', - ], - 'DescribeLakeCacheSize' => [ - 'summary' => '获取集群湖存储加速缓存空间大小。', - 'methods' => [ - 'post', - 'get', + [ + 'apiName' => 'DescribeDiagnosisRecords', + 'description' => '查看SQL摘要信息', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDiagnosisRecords', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'schemes' => [ - 'http', - 'https', + [ + 'apiName' => 'DescribeCompactionServiceSwitch', + 'description' => '查询集群加速配置', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:DescribeCompactionServiceSwitch', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'DescribeDiagnosisDimensions', + 'description' => '查询不同维度的SQL去重统计信息', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDiagnosisDimensions', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'ModifyDBClusterDescription', + 'description' => '变更集群描述', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBClusterDescription', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeAbnormalPatternDetection', + 'description' => '查询异常模式检测', 'operationType' => 'get', - 'abilityTreeCode' => '214834', - 'abilityTreeNodes' => [ - 'FEATUREadsCQJTKP', + 'ramAction' => [ + 'action' => 'adb:DescribeAbnormalPatternDetection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看数仓版集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp10b6646l07akdt', + [ + 'apiName' => 'DescribeDBResourceGroup', + 'description' => '查询资源组', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDBResourceGroup', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', - 'description' => 'PlainResponse<DescribeElasticPlanAttributeResponse>', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Code' => [ - 'description' => '状态码。说明 200表示成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'DBClusterId' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp10b6646l07akdt'."\n", - ], - 'EnableLakeCache' => [ - 'description' => '是否开启湖存储加速', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Instances' => [ - 'description' => '共享湖存储缓存空间的实例列表。', - 'type' => 'array', - 'items' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'example' => 'amv-bp10b6646l07akdt'."\n", - ], - ], - 'Capacity' => [ - 'description' => '湖存储加速缓存空间大小，单位为GB', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'DataSize' => [ - 'description' => '湖存储缓存空间已经使用的容量大小，单位为GB', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - ], - ], - ], + [ + 'apiName' => 'ModifyApsWorkloadName', + 'description' => '修改APS工作负载名称', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyApsWorkloadName', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Code\\": 200,\\n \\"Data\\": {\\n \\"DBClusterId\\": \\"amv-bp10b6646l07akdt\\\\n\\",\\n \\"EnableLakeCache\\": true,\\n \\"Instances\\": [\\n \\"amv-bp10b6646l07akdt\\\\n\\"\\n ],\\n \\"Capacity\\": 100,\\n \\"DataSize\\": 100\\n }\\n}","type":"json"}]', - 'title' => '查询湖存储缓存空间设置', - ], - 'DescribeCompactionServiceSwitch' => [ - 'summary' => '查询集群加速配置中，远程Build服务是否开启。', - 'methods' => [ - 'post', - 'get', + [ + 'apiName' => 'DescribeAdbMySqlIndexes', + 'description' => '查看表索引信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeAdbMySqlIndexes', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'schemes' => [ - 'http', - 'https', + [ + 'apiName' => 'DescribeApsActionLogs', + 'description' => '查询实时数据接入任务的日志', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsActionLogs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'DescribeElasticPlanAttribute', + 'description' => '查询弹性计划详情', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeElasticPlanAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'ModifyDBClusterSSL', + 'description' => '修改ADB实例的SSL配置', 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBClusterSSL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp149vz49b36t****', + [ + 'apiName' => 'CheckSampleDataSet', + 'description' => '检查内置数据集状态', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:CheckSampleDataSet', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D761DA51-12F8-5457-AAA9-F52B9F436D2D', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'EnableCompactionService' => [ - 'description' => '是否开启远程Build服务。', - 'type' => 'boolean', - 'enumValueTitles' => [ - 'true' => 'true', - 'false' => 'false', - ], - 'example' => 'true', - ], - ], - ], - ], + [ + 'apiName' => 'UnbindDBResourceGroupWithUser', + 'description' => '解绑资源组和用户', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:UnbindDBResourceGroupWithUser', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + [ + 'apiName' => 'ModifyDBClusterVip', + 'description' => '修改集群访问VIP', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBClusterVip', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', + ], + ], + [ + 'apiName' => 'DescribeEssdCacheConfig', + 'description' => '查询集群云盘缓存空间', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:DescribeEssdCacheConfig', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], - [ - 'errorCode' => 'InvalidMaintainTime.Malformed', - 'errorMessage' => 'The specified parameter MaintainTime is not valid.', + ], + ], + [ + 'apiName' => 'RunMaterializedViewRecommend', + 'description' => '手动执行物化视图自动推荐任务', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:RunMaterializedViewRecommend', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D761DA51-12F8-5457-AAA9-F52B9F436D2D\\",\\n \\"Data\\": {\\n \\"EnableCompactionService\\": true\\n }\\n}","type":"json"}]', - 'title' => '查询集群加速配置', - ], - 'ModifyEssdCacheConfig' => [ - 'summary' => '修改集群加速配置，EIU云盘空间缓存大小。', - 'methods' => [ - 'post', - 'get', + [ + 'apiName' => 'DescribeClusterResourceUsage', + 'description' => '查询集群资源使用情况', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeClusterResourceUsage', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'schemes' => [ - 'http', - 'https', + [ + 'apiName' => 'DeleteBackups', + 'description' => '删除备份集', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteBackups', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'CreateApsKafkaHudiJob', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateApsKafkaHudiJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'ModifyElasticPlan', + 'description' => '修改弹性计划', 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyElasticPlan', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp10yt0gva71ei7d', + [ + 'apiName' => 'CreateDBResourceGroup', + 'description' => '创建资源组', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateDBResourceGroup', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'EnableEssdCache', - 'in' => 'query', - 'schema' => [ - 'description' => '是否开启云盘缓存。', - 'type' => 'boolean', - 'required' => true, - 'docRequired' => true, - 'enumValueTitles' => [ - 'true' => 'true', - 'false' => 'false', - ], - 'example' => 'true', + ], + [ + 'apiName' => 'ModifyAccountPrivileges', + 'description' => ' 修改数据库账户的权限', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyAccountPrivileges', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], - [ - 'name' => 'EssdCacheSize', - 'in' => 'query', - 'schema' => [ - 'description' => '云盘缓存大小，单位为GB。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'docRequired' => true, - 'example' => '500', + ], + [ + 'apiName' => 'ListTagResources', + 'description' => '查询标签列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListTagResources', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '115F9CCA-EF2E-5F91-AB60-4961D52FEAB4', - ], - ], + [ + 'apiName' => 'GetSparkTemplateFolderTree', + 'description' => '查询Spark应用的目录结构', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkTemplateFolderTree', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + [ + 'apiName' => 'DescribeResultExportConfig', + 'description' => '获取结果集导出配置信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeResultExportConfig', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', + ], + ], + [ + 'apiName' => 'GetSparkReplStatement', + 'description' => '获取一段代码的执行结果', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:GetSparkReplStatement', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbClusterId}/resourcegroup/{#resourceGroupName}/sparkapp/{#sparkAppId}/{#sparkStatmentId}'], ], - [ - 'errorCode' => 'InvalidMaintainTime.Malformed', - 'errorMessage' => 'The specified parameter MaintainTime is not valid.', + ], + ], + [ + 'apiName' => 'BindDBResourceGroupWithUser', + 'description' => '将资源组与数据库用户进行绑定', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:BindDBResourceGroupWithUser', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"115F9CCA-EF2E-5F91-AB60-4961D52FEAB4\\"\\n}","type":"json"}]', - 'title' => '修改云盘缓存', - ], - 'DescribeEssdCacheConfig' => [ - 'summary' => '查询集群加速配置，云盘缓存空间大小，单位为GB。', - 'methods' => [ - 'post', - 'get', + [ + 'apiName' => 'EnableAdviceService', + 'description' => '开通建议服务', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:EnableAdviceService', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'schemes' => [ - 'http', - 'https', + [ + 'apiName' => 'DescribeAuditLogRecords', + 'description' => '查询SQL审计日志', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAuditLogRecords', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'ApplyAdviceById', + 'description' => '应用单条优化建议', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ApplyAdviceById', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'ModifyUserEniVswitchOptions', + 'description' => '修改用户ENI交换机列表', 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'paid', + 'ramAction' => [ + 'action' => 'adb:ModifyUserEniVswitchOptions', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL集群的详情，包括集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-uf685u1o987hj6rn', + [ + 'apiName' => 'GetSparkLogAnalyzeTask', + 'description' => '查询Spark日志分析任务结果', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkLogAnalyzeTask', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/task/{#SparkTaskId}'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'C7EDB8E4-9769-4233-88C7-DCA4C9******', - ], - 'Data' => [ - 'description' => '返回结果。', - 'type' => 'object', - 'properties' => [ - 'EnableEssdCache' => [ - 'description' => '是否开区云盘缓存。', - 'type' => 'boolean', - 'enumValueTitles' => [ - 'true' => 'true', - 'false' => 'false', - ], - 'example' => 'true', - ], - 'EssdCacheSize' => [ - 'description' => '云盘缓存空间大小，单位为GB。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '500', - ], - ], - ], - ], + [ + 'apiName' => 'DescribeDBClusterAttribute', + 'description' => '查询集群详细信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeDBClusterAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + [ + 'apiName' => 'EnableElasticPlan', + 'description' => '启用弹性计划', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:EnableElasticPlan', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', + ], + ], + [ + 'apiName' => 'DescribeTablePartitionDiagnose', + 'description' => '查询二级分区诊断新系列', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeTablePartitionDiagnose', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], - [ - 'errorCode' => 'InvalidMaintainTime.Malformed', - 'errorMessage' => 'The specified parameter MaintainTime is not valid.', + ], + ], + [ + 'apiName' => 'DescribeWorkerDetection', + 'description' => '预留节点检测', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeWorkerDetection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C7EDB8E4-9769-4233-88C7-DCA4C9******\\",\\n \\"Data\\": {\\n \\"EnableEssdCache\\": true,\\n \\"EssdCacheSize\\": 500\\n }\\n}","type":"json"}]', - 'title' => '查询集群云盘缓存空间', - ], - 'ModifyCompactionServiceSwitch' => [ - 'summary' => '修改集群查询加速配置远程Build服务开关。', - 'methods' => [ - 'post', - 'get', + [ + 'apiName' => 'ModifyDBClusterMaintainTime', + 'description' => '修改可维护时间段', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBClusterMaintainTime', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'schemes' => [ - 'http', - 'https', + [ + 'apiName' => 'DescribeAdbMySqlSchemas', + 'description' => '查询所有数据库列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAdbMySqlSchemas', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'DescribeSchemas', + 'description' => '枚举实例的库列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:describeAllDataSource', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'DescribeSQLPatterns', + 'description' => '查询SQL Pattern列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeSQLPatterns', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeSparkSQLDiagnosisAttribute', + 'description' => '查询SparkSQL诊断详情', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkSQLDiagnosisAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeSparkAppDiagnosisInfo', + 'description' => '查询Spark应用诊断信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkAppDiagnosisInfo', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ModifyAuditLogConfig', + 'description' => '修改SQL审计日志设置', 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyAuditLogConfig', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'parameters' => [ - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'amv-bp14t95lun0w****', + [ + 'apiName' => 'GetSparkAppMetrics', + 'description' => '查询Spark App指标数据', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkAppMetrics', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'SparkApplication', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], ], ], - [ - 'name' => 'EnableCompactionService', - 'in' => 'query', - 'schema' => [ - 'description' => '是否开启远程Build服务。', - 'type' => 'boolean', - 'required' => true, - 'docRequired' => true, - 'enumValueTitles' => [ - 'true' => 'true', - 'false' => 'false', - ], - 'example' => 'true', + ], + [ + 'apiName' => 'GetTableDDL', + 'description' => '查询建表语句', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getTableDDL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '21ABF219-10E0-571B-94B8-9C9AE5022BF8', - ], - ], + [ + 'apiName' => 'ModifyEssdCacheConfig', + 'description' => '修改云盘缓存', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyEssdCacheConfig', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidDBClusterId.NotFound', - 'errorMessage' => 'The DBClusterId provided does not exist in our records.', + [ + 'apiName' => 'GetSparkSQLEngineState', + 'description' => '查询Spark SQL引擎状态', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetActiveSparkSession', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}'], + ], + ], + ], + [ + 'apiName' => 'DescribeBackups', + 'description' => '查询备份集列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeBackups', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeProcessList', + 'description' => '查看集群正在运行的查询', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeProcessList', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], - [ - 'errorCode' => 'InvalidDBClusterId.Malformed', - 'errorMessage' => 'The specified parameter DBClusterId is not valid.', + ], + ], + [ + 'apiName' => 'GetCreateTableSQL', + 'description' => '查询某个表的建表语句', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetCreateTableSQL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'CreateDBCluster', + 'description' => '创建集群', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateDBCluster', + 'authLevel' => 'resource', + 'actionConditions' => [ + ['conditionKey' => 'adb:DiskEncryption', 'validationType' => 'always'], + ['conditionKey' => 'adb:EnableSSL', 'validationType' => 'always'], ], - [ - 'errorCode' => 'InvalidMaintainTime.Malformed', - 'errorMessage' => 'The specified parameter MaintainTime is not valid.', + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"21ABF219-10E0-571B-94B8-9C9AE5022BF8\\"\\n}","type":"json"}]', - 'title' => '修改远程Build服务开关', - ], - 'SubmitResultExportJob' => [ - 'summary' => '调用SubmitResultExportJob接口提交SQL查询并导出结果集。', - 'methods' => [ - 'post', + [ + 'apiName' => 'UpgradeKernelVersion', + 'description' => '升级集群内核版本', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:UpgradeKernelVersion', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'schemes' => [ - 'http', - 'https', + [ + 'apiName' => 'LoadSampleDataSet', + 'description' => '加载内置数据集', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:LoadSampleDataSet', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'DescribeClusterNetInfo', + 'description' => '查询网络信息', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeClusterNetInfo', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'write', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'DescribeTables', + 'description' => '枚举数据库的表列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:describeAllDataSource', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeHistoryTasks', + 'description' => '查询历史运维任务', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeHistoryTasks', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeElasticPlanSpecifications', + 'description' => '查询弹性计划支持的规格列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeElasticPlanSpecifications', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeViewJobs', + 'description' => '查询物化视图刷新任务列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeViewJobs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteApsWebhook', + 'description' => '删除Webhook接口', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteApsWebhook', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SubmitResultExportJob', + 'description' => '提交结果集导出任务', 'operationType' => 'create', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '219535', - 'abilityTreeNodes' => [ - 'FEATUREadsCORDM7', + 'ramAction' => [ + 'action' => 'adb:SubmitResultExportJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'>您可以调用[DescribeRegions](~~143074~~)接口查看集群的地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', + [ + 'apiName' => 'CreateAPSJob', + 'description' => '创建APS任务', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateAPSJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => 'AnalyticDB MySQL湖仓版（3.0）集群ID。'."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查询目标地域中所有AnalyticDB MySQL湖仓版（3.0）集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-bp10a0ng21t5****', + ], + [ + 'apiName' => 'DescribeClusterAccessWhiteList', + 'description' => '查询白名单', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeClusterAccessWhiteList', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'Engine', - 'in' => 'formData', - 'schema' => [ - 'description' => '任务执行的引擎，目前只支持XIHE。', - 'type' => 'string', - 'required' => false, - 'example' => 'XIHE', + ], + [ + 'apiName' => 'GetSparkConfigLogPath', + 'description' => '获取Spark日志配置路径', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkConfigLogPath', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'ResourceGroup', - 'in' => 'formData', - 'schema' => [ - 'description' => '导出任务执行资源组。', - 'type' => 'string', - 'required' => false, - 'example' => 'user_default', + ], + [ + 'apiName' => 'DescribeAccountAllPrivileges', + 'description' => '查询数据库账号的所有权限', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAccountAllPrivileges', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], - [ - 'name' => 'Schema', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'tpch_oss', + ], + [ + 'apiName' => 'DescribeSparkSQLDiagnosisList', + 'description' => '查询SparkSQL诊断列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkSQLDiagnosisList', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'SQL', - 'in' => 'formData', - 'schema' => [ - 'description' => '仅支持执行SELECT语句，其他SQL语句会导致接口调用失败。', - 'type' => 'string', - 'required' => true, - 'example' => 'SELECT * FROM `fotor_com_datastore_resource`.`fotor_ai_create_task` where `date` = \'2023-05-13\' LIMIT 10;', + ], + [ + 'apiName' => 'AttachUserENI', + 'description' => '打通用户ENI', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:AttachUserENI', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'ExportType', - 'in' => 'formData', - 'schema' => [ - 'description' => '导出类型。', - 'type' => 'string', - 'required' => false, - 'example' => 'SLS', + ], + [ + 'apiName' => 'GetViewDDL', + 'description' => '查询视图的创建语句', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getViewDDL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'ResultData<?>', - 'description' => '返回详细信息。', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：调用成功。'."\n" - .'- **false**：调用失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**OK**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'OK', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => 'InvalidInput'."\n", - ], - 'Data' => [ - 'description' => '结果集导出任务ID。', - 'type' => 'string', - 'example' => 'export_202405131927121980210080040****'."\n", - ], - ], + [ + 'apiName' => 'ListSparkApps', + 'description' => '查询Spark应用列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListSparkApps', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + [ + 'apiName' => 'CreateMaterializedViewRecommend', + 'description' => '创建物化视图自动推荐任务', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateMaterializedViewRecommend', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"InvalidInput\\\\n\\",\\n \\"Data\\": \\"export_202405131927121980210080040****\\\\n\\"\\n}","type":"json"}]', - 'title' => '提交结果集导出任务', - ], - 'ListResultExportJobHistory' => [ - 'summary' => '调用ListResultExportJobHistory接口查询当前RAM用户结果集导出执行历史记录列表。', - 'methods' => [ - 'post', - 'get', + [ + 'apiName' => 'GetSparkWarehouseBatchSQL', + 'description' => '获取Spark SQL执行结果', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkWarehouseBatchSQL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'schemes' => [ - 'http', - 'https', + [ + 'apiName' => 'DescribeEnabledPrivileges', + 'description' => '查询支持的权限级别和权限列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeEnabledPrivileges', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'DescribeApsHiveWorkload', + 'description' => '查询APS Hive工作负载详情', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsHiveWorkload', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], - 'operationType' => 'write', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'DescribeSparkAuditLogRecords', + 'description' => '查询Spark Interactive资源组的SQL审计日志。', 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '219537', - 'abilityTreeNodes' => [ - 'FEATUREadsCORDM7', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkAuditLogRecords', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看AnalyticDB MySQL版支持的地域和可用区信息，包括地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', + [ + 'apiName' => 'ConfigureResultExport', + 'description' => '配置结果集导出信息', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:ConfigureResultExport', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => 'AnalyticDB MySQL湖仓版（3.0）集群ID。'."\n" - ."\n" - .'> 您可以调用[DescribeDBClusters](~~129857~~)接口查看目标地域下所有AnalyticDB MySQL湖仓版（3.0）集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-7xv5ty5m9o4v****', + ], + [ + 'apiName' => 'DescribeApsDatasources', + 'description' => '查询APS数据源列表', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsDatasources', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'PageNumber', - 'in' => 'formData', - 'schema' => [ - 'description' => '页码，取值为大于0且不超过Integer最大值的整数。', - 'type' => 'string', - 'required' => false, - 'example' => '1', + ], + [ + 'apiName' => 'DescribeColumns', + 'description' => '枚举表的列列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:describeAllDataSource', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'PageSize', - 'in' => 'formData', - 'schema' => [ - 'description' => '每页记录数，取值：'."\n" - .'- **30**（默认值）'."\n" - .'- **50**'."\n" - .'- **100**', - 'type' => 'string', - 'required' => false, - 'example' => '30', + ], + [ + 'apiName' => 'GetTable', + 'description' => '查询表信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getTable', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], - [ - 'name' => 'StartTime', - 'in' => 'formData', - 'schema' => [ - 'description' => '查询开始时间。格式为<i>yyyy-MM-ddTHH:mm:ssZ</i>（UTC时间）。', - 'type' => 'string', - 'required' => false, - 'example' => '2022-01-01T12:01:00Z', + ], + [ + 'apiName' => 'DeleteMaterializedViewRecommend', + 'description' => '删除物化视图自动推荐任务', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteMaterializedViewRecommend', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'EndTime', - 'in' => 'formData', - 'schema' => [ - 'description' => '查询结束时间，UTC时间，格式为：yyyy-MM-ddTHH:mmZ。'."\n" - ."\n" - .'> 查询结束时间需晚于查询开始时间。', - 'type' => 'string', - 'required' => false, - 'example' => '2023-05-25T06:54:00Z', + ], + [ + 'apiName' => 'DescribeExcessivePrimaryKeys', + 'description' => '检测主键过多表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeExcessivePrimaryKeys', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'Order', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => '根据指定字段对SQL语句进行排序，格式为JSON，是一个有序JSON数组，按输入数组的顺序进行复合排序，包含`Field`和`Type`两个字段，例如`[{"Field":"CreateTimee", "Type": "desc" }]`。其中：'."\n" - ."\n" - .'- `Field`表示需要排序的字段名，支持如下字段：'."\n" - .' - `CreateTime`：执行开始时间。'."\n" - .' - `Status`：执行状态。'."\n" - .' - `DatabaseUser`：用户名称。'."\n" - .' - `TimeCost`：执行耗时。'."\n" - .' - `ResourceGroup`：资源组。'."\n" - .' - `ExportRows`：导出行数。'."\n" - .' - `Progress`：导出进度。'."\n" - ."\n\n" - .'- `Type`表示排序类型，支持如下取值（取值均不区分大小写）：'."\n" - .' - `Desc`：降序。'."\n" - .' - `Asc`：升序。', - 'type' => 'object', - 'properties' => [ - 'Field' => [ - 'description' => '排序字段名称，支持的排序字段如下：'."\n" - ."\n" - .'- CreateTime'."\n" - .'- DatabaseUser'."\n" - .'- TimeCost'."\n" - .'- ResourceGroup'."\n" - .'- Status'."\n" - .'- Progress'."\n" - .'- ExportRows', - 'type' => 'string', - 'required' => false, - 'example' => 'DatabaseUser', - ], - 'Type' => [ - 'description' => '排序类型，取值：'."\n" - .'- **Desc**：降序'."\n" - .'- **Asc**：升序', - 'type' => 'string', - 'required' => false, - 'example' => 'Desc', - ], - ], - 'required' => false, + ], + [ + 'apiName' => 'GetSparkTemplateFullTree', + 'description' => '查询Spark应用的目录结构', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkTemplateFullTree', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'StatusList', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => '任务执行状态列表（支持按照状态进行筛选）。', - 'type' => 'array', - 'items' => [ - 'description' => '支持的状态有：'."\n" - .'1. **SUBMITTED**：任务提交成功。'."\n" - .'2. **RUNNING**：任务正在运行中。'."\n" - .'3. **SUCCEEDED**：任务执行成功。'."\n" - .'4. **FAILED**：任务执行失败。', - 'type' => 'string', - 'required' => false, - 'example' => 'RUNNING', - ], - 'required' => false, + ], + [ + 'apiName' => 'DescribeSqlPattern', + 'description' => '查询SQL Pattern详情', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeSqlPattern', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'ResourceGroup', - 'in' => 'formData', - 'schema' => [ - 'description' => '任务执行资源组（支持按照资源组进行筛选）。', - 'type' => 'string', - 'required' => false, - 'example' => 'user_default', + ], + [ + 'apiName' => 'ModifyApsSlsADBJob', + 'description' => '修改sls投递adb数仓任务', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyApsSlsADBJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'DatabaseUser', - 'in' => 'formData', - 'schema' => [ - 'description' => '数据库用户。', - 'type' => 'string', - 'required' => false, - 'example' => 'test1', + ], + [ + 'apiName' => 'StartSparkSQLEngine', + 'description' => '启动Spark SQL引擎', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:StartSparkEngine', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'ResultData<?>', - 'description' => '返回详细信息。', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Ok**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'OK', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => 'InvalidInput', - ], - 'Items' => [ - 'description' => '列表详情。', - 'type' => 'array', - 'items' => [ - 'description' => '结果集导出详情。', - 'type' => 'object', - 'properties' => [ - 'DBClusterId' => [ - 'description' => 'AnalyticDB MySQL湖仓版（3.0）集群ID。', - 'type' => 'string', - 'example' => 'amv-7xv5ty5m9o4v****', - ], - 'AliUid' => [ - 'description' => 'RAM账号ID。', - 'type' => 'string', - 'example' => '120010511678****', - ], - 'Sql' => [ - 'description' => '结果集导出任务中使用的SQL语句详情。', - 'type' => 'string', - 'example' => 'SELECT * FROM `ADB_SampleData_TPCH`.`supplier` LIMIT 20', - ], - 'CreateTime' => [ - 'description' => '结果集导出任务创建时间。UTC时间，格式为<i>yyyy-mm-ddThh:mm:ssZ</i>。', - 'type' => 'string', - 'example' => '2022-04-01T09:50:18Z', - ], - 'StartTime' => [ - 'description' => '任务的开始时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ。', - 'type' => 'string', - 'example' => '2021-07-03T04:00:00Z', - ], - 'EndTime' => [ - 'description' => '查询结束时间。UTC时间，格式：<i>yyyy-MM-ddTHH:mm:ssZ</i>。'."\n" - .'> 查询结束时间需晚于查询开始时间。', - 'type' => 'string', - 'example' => '2023-06-15T02:13:00Z', - ], - 'DatabaseUser' => [ - 'description' => 'RAM用户关联的数据库账号名称。', - 'type' => 'string', - 'example' => 'ram_user', - ], - 'TimeCost' => [ - 'description' => '数据导出耗时，单位是毫秒。'."\n" - ."\n" - .'> 从数据导出任务启动开始算，直到导出结束。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '560', - ], - 'ExportJobId' => [ - 'description' => '结果集导出任务唯一标识。', - 'type' => 'string', - 'example' => 'export_2024051319271219802100800401300****'."\n", - ], - 'ResourceGroup' => [ - 'description' => '任务执行资源组。', - 'type' => 'string', - 'example' => 'test', - ], - 'Status' => [ - 'description' => '导出任务执行状态，枚举类型，分为以下几种状态：'."\n" - .'1. **SUBMITTED**：任务提交成功。'."\n" - .'2. **RUNNING**：任务正在运行中。'."\n" - .'3. **SUCCEEDED**：任务执行成功。'."\n" - .'4. **FAILED**：任务执行失败。', - 'type' => 'string', - 'example' => 'RUNNING', - ], - 'ExportPath' => [ - 'description' => '结果集完整地址。', - 'type' => 'string', - 'example' => 'oss://testBucketName/export_test/result_export/2024/05/13/202405131528400210090110690315154****/result.csv', - ], - 'Progress' => [ - 'description' => '导出进度。单位为百分比（%），取值范围[0,100]。', - 'type' => 'string', - 'example' => '30', - ], - 'ProcessId' => [ - 'description' => '返回SQL查询ID，便于用户诊断。'."\n" - .'> 您可以通过调用[DescribeDiagnosisSQLInfo](~~612495~~)接口进行查询诊断。', - 'type' => 'string', - 'example' => '202306121421111720161451770345339****', - ], - 'ExportRows' => [ - 'description' => '导出行数，接口调用成功才返回该参数。', - 'type' => 'string', - 'example' => '10000', - ], - 'Message' => [ - 'description' => '结果集导出SQL执行错误信息，只在任务执行失败时才返回该信息。', - 'type' => 'string', - 'example' => 'Failed to execute SQL', - ], - 'Engine' => [ - 'description' => '任务执行的引擎，目前只支持XIHE。', - 'type' => 'string', - 'example' => 'XIHE', - ], - 'Schema' => [ - 'description' => '数据库名称。', - 'type' => 'string', - 'example' => 'lake_db', - ], - 'ExportType' => [ - 'description' => '导出类型。', - 'type' => 'string', - 'example' => '-', - ], - 'IsExpired' => [ - 'description' => '是否已过期：'."\n" - ."\n" - .'- **false**: 未过期，'."\n" - .'- **true**: 已过期', - 'type' => 'boolean', - ], - ], - ], - ], - 'PageNumber' => [ - 'description' => '页号，和传入的值一致。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '本页记录数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'TotalCount' => [ - 'description' => '总记录数。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '174', - ], - ], + [ + 'apiName' => 'BindAccount', + 'description' => '绑定RAM用户与数据库账号', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:BindAccount', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'AccountLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + [ + 'apiName' => 'ModifyAccountDescription', + 'description' => '修改数据库账号的备注信息', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyAccountDescription', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Items\\": [\\n {\\n \\"DBClusterId\\": \\"amv-7xv5ty5m9o4v****\\",\\n \\"AliUid\\": \\"120010511678****\\",\\n \\"Sql\\": \\"SELECT * FROM `ADB_SampleData_TPCH`.`supplier` LIMIT 20\\",\\n \\"CreateTime\\": \\"2022-04-01T09:50:18Z\\",\\n \\"StartTime\\": \\"2021-07-03T04:00:00Z\\",\\n \\"EndTime\\": \\"2023-06-15T02:13:00Z\\",\\n \\"DatabaseUser\\": \\"ram_user\\",\\n \\"TimeCost\\": 560,\\n \\"ExportJobId\\": \\"export_2024051319271219802100800401300****\\\\n\\",\\n \\"ResourceGroup\\": \\"test\\",\\n \\"Status\\": \\"RUNNING\\",\\n \\"ExportPath\\": \\"oss://testBucketName/export_test/result_export/2024/05/13/202405131528400210090110690315154****/result.csv\\",\\n \\"Progress\\": \\"30\\",\\n \\"ProcessId\\": \\"202306121421111720161451770345339****\\",\\n \\"ExportRows\\": \\"10000\\",\\n \\"Message\\": \\"Failed to execute SQL\\",\\n \\"Engine\\": \\"XIHE\\",\\n \\"Schema\\": \\"lake_db\\",\\n \\"ExportType\\": \\"-\\",\\n \\"IsExpired\\": true\\n }\\n ],\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 174\\n}","type":"json"}]', - 'title' => '列出结果集导出历史任务', - ], - 'DescribeSQLWebSocketDomain' => [ - 'summary' => '查看注册的WebSocket域名。', - 'methods' => [ - 'get', - 'post', + [ + 'apiName' => 'DescribeResourceGroupSpec', + 'description' => '查询资源组规格', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeResourceGroupSpec', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'schemes' => [ - 'http', - 'https', + [ + 'apiName' => 'ModifyDBClusterResourceGroup', + 'description' => '修改集群所属的资源组', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBClusterResourceGroup', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'DescribeDownloadRecords', + 'description' => '查看最近5次的SQL查询下载任务列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDownloadRecords', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'DescribeSQLWebSocketDomain', + 'description' => '查看注册的WebSocket域名', 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '180261', - 'abilityTreeNodes' => [ - 'FEATUREads8FGISX', + 'ramAction' => [ + 'action' => 'adb:DescribeSQLWebSocketDomain', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => '地域ID。'."\n" - .'> 您可以调用[DescribeRegions](~~143074~~)接口查看指定AnalyticDB MySQL数仓版支持的地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', + [ + 'apiName' => 'GetSparkAppLog', + 'description' => '查询Spark应用日志', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkAppLog', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'>您可以通过[DescribeDBClusters](~~98094~~)接口查看账号下所有集群的详细信息，包括集群ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'amv-bp1lw6g669zpi660', + ], + [ + 'apiName' => 'DescribeUserQuota', + 'description' => '查询用户可用配额', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeUserQuota', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'Module', - 'in' => 'query', - 'allowEmptyValue' => false, - 'schema' => [ - 'type' => 'string', - 'required' => false, + ], + [ + 'apiName' => 'DetachUserENI', + 'description' => '关闭用户ENI', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:DetachUserENI', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'Code' => [ - 'description' => '状态码。说明 200表示成功。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'Success', - ], - 'RequestId' => [ - 'description' => '阿里云为该请求生成的唯一标识符。', - 'type' => 'string', - 'example' => 'E03F0806-A67B-5B24-8562-9589F20DEEB5', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'Domain' => [ - 'description' => '域名。', - 'type' => 'string', - 'example' => 'adb-ws-beijing.console.aliyun.com/query', - ], - ], + [ + 'apiName' => 'DeleteDBResourceGroup', + 'description' => '删除资源组', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteDBResourceGroup', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + [ + 'apiName' => 'DescribeAccountPrivileges', + 'description' => '查询数据库账号的权限', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAccountPrivileges', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"E03F0806-A67B-5B24-8562-9589F20DEEB5\\",\\n \\"Success\\": true,\\n \\"Domain\\": \\"adb-ws-beijing.console.aliyun.com/query\\"\\n}","type":"json"}]', - 'title' => '查看注册的WebSocket域名', - ], - 'ConfigureResultExport' => [ - 'summary' => '配置导出的SLS 或者OSS 信息，实例级别唯一，遵循一次配置多次使用的原则。', - 'methods' => [ - 'post', + [ + 'apiName' => 'ModifyBackupPolicy', + 'description' => '修改集群备份策略', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyBackupPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'schemes' => [ - 'https', + [ + 'apiName' => 'CreateBackup', + 'description' => '立即创建一个临时备份', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateBackup', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'StartApsJob', + 'description' => '启动APS任务', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:StartApsJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'write', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'DescribeStorageResourceUsage', + 'description' => '查询集群存储资源使用情况', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeStorageResourceUsage', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeJobResourceUsage', + 'description' => '查询任务型资源使用情况', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeJobResourceUsage', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'CreateLakeStorage', + 'description' => '创建湖存储', 'operationType' => 'create', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '254776', - 'abilityTreeNodes' => [ - 'FEATUREadsCORDM7', + 'ramAction' => [ + 'action' => 'adb:CreateLakeStorageBucket', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'formData', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-shenzhen', + [ + 'apiName' => 'DescribeComputeResourceUsage', + 'description' => '查询资源组计算资源使用情况', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeComputeResourceUsage', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'formData', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下所有AnalyticDB MySQL集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-wz9509beptiz****', + ], + [ + 'apiName' => 'DescribeKernelVersion', + 'description' => '查询集群内核版本', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeKernelVersion', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'ExportType', - 'in' => 'formData', - 'schema' => [ - 'description' => '导出类型，枚举类型，当前可选值为：'."\n" - ."\n" - .'- SLS：标识导出目的为SLS。'."\n" - .'- OSS：标识导出目的为OSS。', - 'type' => 'string', - 'required' => false, - 'example' => 'SLS', + ], + [ + 'apiName' => 'DescribeAdbMySqlTableMeta', + 'description' => '查看表元数据信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeAdbMySqlTableMeta', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], - [ - 'name' => 'SlsInfo', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => '当导出目的为SLS类型时，对应的SLS配置信息。', - 'type' => 'object', - 'properties' => [ - 'SlsProject' => [ - 'description' => 'SLS Project名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'test-project', - ], - 'ResourceGroup' => [ - 'description' => '导出SQL运行的资源组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'aps', - ], - 'LogstoreTtl' => [ - 'description' => '结果集导出临时生成的logstore的过期时间，单位为天，过期后自动删除。'."\n" - .'最小1天，最大30天，超过范围报错。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '10', - ], - ], - 'required' => false, + ], + [ + 'apiName' => 'GetSparkAppAttemptLog', + 'description' => '查询Spark应用的重试日志', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkAppAttemptLog', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], ], ], - [ - 'name' => 'OssInfo', - 'in' => 'formData', - 'style' => 'json', - 'schema' => [ - 'description' => '当导出目的为OSS类型时，对应的OSS配置信息。', - 'type' => 'object', - 'properties' => [ - 'ExportBasePath' => [ - 'description' => '导出结果存储的OSS路径地址。', - 'type' => 'string', - 'required' => false, - 'example' => 'oss://testBucketName/data_result', - ], - 'ResourceGroup' => [ - 'description' => '导出SQL运行的资源组名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'aps', - ], - 'ResultFileTtl' => [ - 'description' => 'Oss文件过期时间，单位为天，最小1天，最大30天，超出范围报错。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '10', - ], - ], - 'required' => false, + ], + [ + 'apiName' => 'DescribeDiagnosisSQLInfo', + 'description' => '查看SQL执行详情', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDiagnosisSQLInfo', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'ResultData<?>', - 'description' => 'ResultData<?>', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的附加信息。取值说明：'."\n" - ."\n" - .'- 请求正常，返回OK。'."\n" - .'- 请求异常，返回具体异常错误码。', - 'type' => 'string', - 'example' => 'OK', - ], - 'Code' => [ - 'description' => '后端错误码。', - 'type' => 'string', - 'example' => '200', - ], - 'Data' => [ - 'description' => '已配置的结果集导出信息', - 'type' => 'object', - 'properties' => [ - 'ExportType' => [ - 'description' => '导出类型，枚举类型，返回结果可能值为：'."\n" - ."\n" - .'- SLS：标识导出目的为SLS。'."\n" - .'- OSS：标识导出目的为OSS。', - 'type' => 'string', - 'example' => 'SLS', - ], - 'SlsInfo' => [ - 'description' => '当导出目的为SLS类型时，对应的SLS配置信息。', - 'type' => 'object', - 'properties' => [ - 'SlsProject' => [ - 'description' => 'SLS Project名称。', - 'type' => 'string', - 'example' => 'test-project', - ], - 'ResourceGroup' => [ - 'description' => '导出SQL运行的资源组名称。', - 'type' => 'string', - 'example' => 'aps', - ], - 'LogstoreTtl' => [ - 'description' => '结果集导出临时生成的logstore的过期时间，单位为天，过期后自动删除。 最小1天，最大30天。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - ], - ], - 'OssInfo' => [ - 'description' => '当导出目的为OSS类型时，配置成功的OSS导出信息。', - 'type' => 'object', - 'properties' => [ - 'ExportBasePath' => [ - 'description' => '导出结果存储的OSS路径地址。', - 'type' => 'string', - 'example' => 'oss://testBucketName/data_result', - ], - 'ResourceGroup' => [ - 'description' => '导出SQL运行的资源组名称。', - 'type' => 'string', - 'example' => 'aps', - ], - 'ResultFileTtl' => [ - 'description' => 'Oss文件过期时间，单位为天，最小1天，最大30天。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - ], - ], - ], - ], - ], + [ + 'apiName' => 'ModifyClusterAccessWhiteList', + 'description' => '修改白名单', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyClusterAccessWhiteList', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ModifyDBCluster', + 'description' => '集群升降配', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyDBCluster', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + [ + 'apiName' => 'DescribeAvailableAdvices', + 'description' => '显示可用优化建议', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeAvailableAdvices', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"200\\",\\n \\"Data\\": {\\n \\"ExportType\\": \\"SLS\\",\\n \\"SlsInfo\\": {\\n \\"SlsProject\\": \\"test-project\\",\\n \\"ResourceGroup\\": \\"aps\\",\\n \\"LogstoreTtl\\": 10\\n },\\n \\"OssInfo\\": {\\n \\"ExportBasePath\\": \\"oss://testBucketName/data_result\\",\\n \\"ResourceGroup\\": \\"aps\\",\\n \\"ResultFileTtl\\": 10\\n }\\n }\\n}","type":"json"}]', - 'title' => '配置结果集导出信息', - ], - 'DescribeResultExportConfig' => [ - 'summary' => '获取用户配置的结果集导出信息', - 'methods' => [ - 'get', - 'post', + [ + 'apiName' => 'GetDatabaseObjects', + 'description' => '查询数据库信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getDatabaseObjectsByFilter', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'KillSparkApp', + 'description' => '强行停止运行中的Spark作业', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:KillSparkApp', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], + ], ], - 'schemes' => [ - 'https', + [ + 'apiName' => 'DeleteDBCluster', + 'description' => '释放集群', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteDBCluster', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'ModifyMaterializedViewRecommend', + 'description' => '修改物化视图自动推荐任务', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyMaterializedViewRecommend', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], ], ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'DescribeTableAccessCount', + 'description' => '查询表的访问次数', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeTableAccessCount', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeAccountPrivilegeObjects', + 'description' => '查询数据库账号可见的库表列', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAccountPrivilegeObjects', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'AllocateClusterPublicConnection', + 'description' => '申请公网地址', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:AllocateClusterPublicConnection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ExistRunningSQLEngine', + 'description' => '检测是否存在运行中的Spark SQLEngine', 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '254784', - 'abilityTreeNodes' => [ - 'FEATUREadsCORDM7', + 'ramAction' => [ + 'action' => 'adb:GetActiveSparkSession', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}'], + ], ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-shenzhen', + [ + 'apiName' => 'DeleteAccount', + 'description' => '删除数据库账号', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteAccount', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'description' => '集群ID。'."\n" - .'> 调用[DescribeDBClusters](~~129857~~)接口可以查看目标地域下所有AnalyticDB MySQL集群的集群ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-8vbf80pjcz*****', + ], + [ + 'apiName' => 'GetSparkTemplateFileContent', + 'description' => '查询Spark应用模板的内容', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkTemplateFileContent', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'ExportType', - 'in' => 'query', - 'schema' => [ - 'description' => '导出类型，枚举类型，当前可选值为：'."\n" - ."\n" - .'- SLS：标识导出目的为SLS。'."\n" - .'- OSS：标识导出目的为OSS。', - 'type' => 'string', - 'required' => false, - 'example' => 'SLS', + ], + [ + 'apiName' => 'DescribeAccounts', + 'description' => '查询数据库账号', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAccounts', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'ResultData<?>', - 'description' => 'ResultData<?>', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', - ], - 'Success' => [ - 'description' => '请求是否成功。取值说明：'."\n" - .'- **True**：成功。'."\n" - .'- **False**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'HttpStatusCode' => [ - 'description' => 'HTTP请求返回的响应状态码，200表示请求发送成功。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Message' => [ - 'description' => '调用结果的信息。取值说明：'."\n" - .'- 请求正常，返回**OK**。 '."\n" - .'- 请求异常，返回具体异常信息。', - 'type' => 'string', - 'example' => 'OK', - ], - 'Code' => [ - 'description' => '接口状态或POP错误码。', - 'type' => 'string', - 'example' => 'InvalidInput', - ], - 'Data' => [ - 'description' => '返回数据。', - 'type' => 'object', - 'properties' => [ - 'ExportType' => [ - 'description' => '导出类型，枚举类型，当前可选值为：'."\n" - ."\n" - .'- SLS：标识导出目的为SLS。'."\n" - .'- OSS：标识导出目的为OSS。', - 'type' => 'string', - 'example' => 'OSS', - ], - 'SlsInfo' => [ - 'description' => '导出类型为SLS时，对应的SLS配置信息。', - 'type' => 'object', - 'properties' => [ - 'SlsProject' => [ - 'description' => 'SLS Project名称。', - 'type' => 'string', - 'example' => 'test-project', - ], - 'ResourceGroup' => [ - 'description' => '导出SQL运行的资源组名称。', - 'type' => 'string', - 'example' => 'aps', - ], - 'LogstoreTtl' => [ - 'description' => '结果集导出临时生成的logstore的过期时间，单位为天，过期后自动删除。 最小1天，最大30天。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - ], - ], - 'OssInfo' => [ - 'description' => '导出类型为OSS时，对应的OSS信息。', - 'type' => 'object', - 'properties' => [ - 'ExportBasePath' => [ - 'description' => '导出结果存储的OSS路径地址。', - 'type' => 'string', - 'example' => 'oss://testBucketName/data_result'."\n", - ], - 'ResourceGroup' => [ - 'description' => '导出SQL运行的资源组名称。', - 'type' => 'string', - 'example' => 'aps', - ], - 'ResultFileTtl' => [ - 'description' => 'Oss文件过期时间，单位为天，最小1天，最大30天。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - ], - ], - ], - ], - ], + [ + 'apiName' => 'DescribeHistoryTasksStat', + 'description' => '统计历史任务', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:DescribeHistoryTasksStat', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + [ + 'apiName' => 'DeleteApsJob', + 'description' => '删除APS任务', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DeleteApsJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"HttpStatusCode\\": 200,\\n \\"Message\\": \\"OK\\",\\n \\"Code\\": \\"InvalidInput\\",\\n \\"Data\\": {\\n \\"ExportType\\": \\"OSS\\",\\n \\"SlsInfo\\": {\\n \\"SlsProject\\": \\"test-project\\",\\n \\"ResourceGroup\\": \\"aps\\",\\n \\"LogstoreTtl\\": 10\\n },\\n \\"OssInfo\\": {\\n \\"ExportBasePath\\": \\"oss://testBucketName/data_result\\\\n\\",\\n \\"ResourceGroup\\": \\"aps\\",\\n \\"ResultFileTtl\\": 10\\n }\\n }\\n}","type":"json"}]', - 'title' => '获取结果集导出配置信息', - ], - 'ModifySqlTemplatePosition' => [ - 'summary' => '用于修改SQL模板的目录位置', - 'methods' => [ - 'get', - 'post', + [ + 'apiName' => 'KillSparkSQLEngine', + 'description' => '关闭Spark SQL引擎', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:KillSparkEngine', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}'], + ], + ], ], - 'schemes' => [ - 'http', - 'https', + [ + 'apiName' => 'UpdateLakeStorage', + 'description' => '更新湖存储', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:UpdateLakeStorage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'security' => [ - [ - 'AK' => [], + [ + 'apiName' => 'KillSparkLogAnalyzeTask', + 'description' => '终止Spark日志分析任务', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:KillSparkLogAnalyzeTask', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/task/{#SparkTaskId}'], + ], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ + [ + 'apiName' => 'GetLakeStorage', + 'description' => '获取湖存储', 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetLakeStorage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'title' => 'RegionId', - 'description' => '地域ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'cn-hangzhou', + [ + 'apiName' => 'DescribeAllDataSource', + 'description' => '枚举数据库列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:describeAllDataSource', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], - [ - 'name' => 'DBClusterId', - 'in' => 'query', - 'schema' => [ - 'title' => '实例ID', - 'description' => '实例ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'amv-uf6wjk5xxxxxxxxxx', + ], + [ + 'apiName' => 'DescribeOperatorPermission', + 'description' => '查询服务账号授权情况', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeOperatorPermission', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}'], ], ], - [ - 'name' => 'TemplateId', - 'in' => 'query', - 'schema' => [ - 'title' => '分组Id', - 'description' => '模板ID。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '210208', + ], + [ + 'apiName' => 'ListSparkWarehouseBatchSQL', + 'description' => '分页查询所有执行的Spark SQL', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListSparkWarehouseBatchSQL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], - [ - 'name' => 'TargetTemplateGroupId', - 'in' => 'query', - 'schema' => [ - 'title' => '参数模板Id', - 'description' => '模板分组ID', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - 'example' => '1', + ], + [ + 'apiName' => 'DescribeAdviceServiceEnabled', + 'description' => '查询建议服务是否开启', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeAdviceServiceEnabled', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'Message' => [ - 'description' => '调用结果的信息。取值说明：'."\n" - .'- 请求正常，返回**Success**。 '."\n" - .'- 请求异常，返回具体异常信息。', - 'type' => 'string', - 'example' => 'success', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '5DC10091-348D-12B1-906D-AB49D658012E', - ], - 'Success' => [ - 'description' => '调用是否成功，取值说明：'."\n" - .'- **true**：成功。'."\n" - .'- **false**：失败。', - 'type' => 'boolean', - 'example' => 'true', - ], - ], + [ + 'apiName' => 'ListLakeStorages', + 'description' => '列取湖存储', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListLakeStorages', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + [ + 'apiName' => 'DescribeMvRecommendSubTasks', + 'description' => '查询物化视图推荐任务执行列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeMvRecommendSubTasks', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"5DC10091-348D-12B1-906D-AB49D658012E\\",\\n \\"Success\\": true\\n}","type":"json"}]', - 'title' => '修改SQL模板位置', - 'description' => '当前服务的接入地址请参见[服务接入点](~~612373~~)。', - ], - ], - 'endpoints' => [ - [ - 'regionId' => 'ap-northeast-1', - 'endpoint' => 'adb.ap-northeast-1.aliyuncs.com', - ], - [ - 'regionId' => 'ap-northeast-2', - 'endpoint' => 'adb.ap-northeast-2.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-1', - 'endpoint' => 'adb.ap-southeast-1.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-2', - 'endpoint' => 'adb.ap-southeast-2.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-3', - 'endpoint' => 'adb.ap-southeast-3.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-5', - 'endpoint' => 'adb.ap-southeast-5.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-6', - 'endpoint' => 'adb.ap-southeast-6.aliyuncs.com', - ], - [ - 'regionId' => 'ap-southeast-7', - 'endpoint' => 'adb.ap-southeast-7.aliyuncs.com', - ], - [ - 'regionId' => 'cn-beijing', - 'endpoint' => 'adb.cn-beijing.aliyuncs.com', - ], - [ - 'regionId' => 'cn-chengdu', - 'endpoint' => 'adb.cn-chengdu.aliyuncs.com', - ], - [ - 'regionId' => 'cn-guangzhou', - 'endpoint' => 'adb.cn-guangzhou.aliyuncs.com', - ], - [ - 'regionId' => 'cn-hangzhou', - 'endpoint' => 'adb.aliyuncs.com', - ], - [ - 'regionId' => 'cn-hongkong', - 'endpoint' => 'adb.cn-hongkong.aliyuncs.com', - ], - [ - 'regionId' => 'cn-huhehaote', - 'endpoint' => 'adb.cn-huhehaote.aliyuncs.com', - ], - [ - 'regionId' => 'cn-qingdao', - 'endpoint' => 'adb.cn-qingdao.aliyuncs.com', - ], - [ - 'regionId' => 'cn-shanghai', - 'endpoint' => 'adb.aliyuncs.com', - ], - [ - 'regionId' => 'cn-shenzhen', - 'endpoint' => 'adb.cn-shenzhen.aliyuncs.com', - ], - [ - 'regionId' => 'cn-wulanchabu', - 'endpoint' => 'adb.cn-wulanchabu.aliyuncs.com', - ], - [ - 'regionId' => 'cn-zhangjiakou', - 'endpoint' => 'adb.cn-zhangjiakou.aliyuncs.com', - ], - [ - 'regionId' => 'us-west-1', - 'endpoint' => 'adb.us-west-1.aliyuncs.com', - ], - [ - 'regionId' => 'us-east-1', - 'endpoint' => 'adb.us-east-1.aliyuncs.com', - ], - [ - 'regionId' => 'na-south-1', - 'endpoint' => 'adb.na-south-1.aliyuncs.com', - ], - [ - 'regionId' => 'eu-west-1', - 'endpoint' => 'adb.eu-west-1.aliyuncs.com', - ], - [ - 'regionId' => 'eu-central-1', - 'endpoint' => 'adb.eu-central-1.aliyuncs.com', - ], - [ - 'regionId' => 'me-central-1', - 'endpoint' => 'adb.me-central-1.aliyuncs.com', - ], - [ - 'regionId' => 'ap-south-1', - 'endpoint' => 'adb.ap-south-1.aliyuncs.com', - ], - [ - 'regionId' => 'cn-shenzhen-finance-1', - 'endpoint' => 'adb.cn-shenzhen-finance-1.aliyuncs.com', - ], - [ - 'regionId' => 'cn-shanghai-finance-1', - 'endpoint' => 'adb.cn-shanghai-finance-1.aliyuncs.com', - ], - [ - 'regionId' => 'cn-north-2-gov-1', - 'endpoint' => 'adb.cn-north-2-gov-1.aliyuncs.com', - ], - [ - 'regionId' => 'cn-hangzhou-finance', - 'endpoint' => 'adb.aliyuncs.com', - ], - [ - 'regionId' => 'cn-beijing-finance-1', - 'endpoint' => 'adb.aliyuncs.com', + [ + 'apiName' => 'GetSparkReplSession', + 'description' => '获取会话状态', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:GetSparkReplSession', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbClusterId}/resourcegroup/{#resourceGroupName}/sparkapp/{#sparkAppId}/{#sessionid}'], + ], + ], + ], + [ + 'apiName' => 'DescribeControllerDetection', + 'description' => '接入节点检测', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeControllerDetection', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeAdbMySqlColumns', + 'description' => '查询表的列信息', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAdbMySqlColumns', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GetSparkAppWebUiAddress', + 'description' => '查询Spark Web UI地址', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkAppWebUiAddress', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteApsDatasoure', + 'description' => '删除APS数据源', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DeleteApsDatasoure', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ModifyApsJob', + 'description' => '修改aps任务', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyApsJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'BatchApplyAdviceByIdList', + 'description' => '批量应用优化建议', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:BatchApplyAdviceByIdList', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeMvRecommendTasks', + 'description' => '查询物化视图推荐任务列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeMvRecommendTasks', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeDBClusterPerformance', + 'description' => '查看集群性能数据', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDBClusterPerformance', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeAdbMySqlTables', + 'description' => '查询数据库下所有表信息', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeAdbMySqlTables', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeApsDatasource', + 'description' => '查询过APS数据源详情', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeApsDatasource', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ListResultExportJobHistory', + 'description' => '列出结果集导出历史任务', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListResultExportJobHistory', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeTableDetail', + 'description' => '查询表详情', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeTableDetail', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ListSparkLogAnalyzeTasks', + 'description' => '查询Spark日志分析任务列表', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListSparkLogAnalyzeTasks', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'StartSparkReplSession', + 'description' => '启动一个Spark会话', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:SubmitSparkApp', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#resourcegroup}'], + ], + ], + ], + [ + 'apiName' => 'DeleteSparkTemplateFile', + 'description' => '删除Spark模板', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteSparkTemplate', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/template/{#TemplateId}'], + ], + ], + ], + [ + 'apiName' => 'GetViewObjects', + 'description' => '查询视图信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getViewObjects', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'SuspendApsJob', + 'description' => '暂停APS任务', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:SuspendApsJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CancelSparkWarehouseBatchSQL', + 'description' => '取消Spark SQL执行', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:CancelSparkWarehouseBatchSQL', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CreateApsSlsADBJob', + 'description' => '', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateApsSlsADBJob', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteSparkTemplate', + 'description' => '删除Spark模板', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteSparkTemplate', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/template/{#TemplateId}'], + ], + ], + ], + [ + 'apiName' => 'CreateAccount', + 'description' => '创建数据库账号', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:CreateAccount', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'UpdateSparkTemplateFile', + 'description' => '更新Spark应用模板', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:UpdateSparkTemplateFile', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'SparkTemplate', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/template/{#TemplateId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeDBClusterHealthStatus', + 'description' => '查询集群健康检查状态', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeDBClusterHealthStatus', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'PreloadSparkAppMetrics', + 'description' => '预加载Spark App指标数据', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:PreloadSparkAppMetrics', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'SparkApplication', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeAPSADBInstances', + 'description' => '获取联邦分析支持的ADB实例列表', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:DescribeAPSADBInstances', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ResetAccountPassword', + 'description' => '重置数据库账号的密码', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ResetAccountPassword', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeSparkCodeWebUi', + 'description' => '查询Spark code的web ui', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkCodeWebUi', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GetSparkAppInfo', + 'description' => '查询Spark应用的信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkAppInfo', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], + ], + ], + [ + 'apiName' => 'GetSparkAppState', + 'description' => '查询Spark应用的状态', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetSparkAppState', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ], + ], + ], + [ + 'apiName' => 'ListSparkTemplateFileIds', + 'description' => '列出集群中的Spark模板文件ID', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListSparkTemplateFileIds', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'CreateApsWebhook', + 'description' => '创建Webhook', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'adb:CreateApsWebhook', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ListSparkAppAttempts', + 'description' => '查询Spark应用的重试信息', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:ListSparkAppAttempts', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ModifySqlTemplatePosition', + 'description' => '修改SQL模板位置', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:ModifySqlTemplatePosition', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeApsMigrationWorkloads', + 'description' => '查询APS迁移任务工作负载列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeApsMigrationWorkloads', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'SubmitSparkApp', + 'description' => '提交Spark应用', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:SubmitSparkApp', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'SparkApplication', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}'], + ], + ], + ], + [ + 'apiName' => 'DescribeOversizeNonPartitionTableInfos', + 'description' => '检测非分区表不合理', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeOversizeNonPartitionTableInfos', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeMVRecommendResults', + 'description' => '查询物化视图推荐结果列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeMVRecommendResults', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteElasticPlan', + 'description' => '删除弹性计划', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'adb:DeleteElasticPlan', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DisableAdviceService', + 'description' => '关闭建议服务', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:DisableAdviceService', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeSparkAppType', + 'description' => '查询Spark应用类型', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeSparkAppType', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'ModifyCompactionServiceSwitch', + 'description' => '修改远程Build服务开关', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'adb:ModifyCompactionServiceSwitch', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeClusterResourceDetail', + 'description' => '查询集群资源具体使用详情', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeClusterResourceDetail', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribePatternPerformance', + 'description' => '查询SQL Pattern的指标', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:DescribePatternPerformance', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'KillProcess', + 'description' => '终止正在进行的任务', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'adb:KillProcess', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'conditional', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DownloadDiagnosisRecords', + 'description' => '下载SQL摘要信息', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'adb:DownloadDiagnosisRecords', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'GetADBSparkNecessaryRAMPermissions', + 'description' => '查看当前用户的Spark基本权限诊断报告', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:GetADBSparkNecessaryRAMPermissions', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'DescribeBackupPolicy', + 'description' => '查询集群自动备份策略', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:DescribeBackupPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + [ + 'apiName' => 'GetTableColumns', + 'description' => '查询列信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'adb:getTableColumns', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'ADB', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#AccountId}:dbcluster/{#DBClusterId}'], + ], + ], + ], + ], + 'resourceTypes' => [ + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourceGroupName/{#ResrouceGroupName}'], + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ['validationType' => 'always', 'resourceType' => 'DBCluster', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:DBClusterLakeVersion/DBClusterLakeVersionId'], + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:DBClusterLakeVersion/*'], + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbClusterId}/resourcegroup/{#resourceGroupName}/sparkapp/{#sparkAppId}'], + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbClusterId}/resourcegroup/{#resourceGroupName}/sparkapp/{#sparkAppId}/{#sparkStatmentId}'], + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#Region}:{#AccountId}:dbcluster/{#DBClusterId}'], + ['validationType' => 'always', 'resourceType' => 'LakeAccount', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/account/{#AccountName}'], + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/task/{#SparkTaskId}'], + ['validationType' => 'always', 'resourceType' => 'SparkApplication', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}'], + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourceGroupName/{#ResrouceGroupName}/query/{#QueryId}'], + ['validationType' => 'always', 'resourceType' => 'ResourceGroup', 'arn' => 'acs:adb:*:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}'], + ['validationType' => 'always', 'resourceType' => 'AccountLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}'], + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}/sparkapp/{#SparkAppId}'], + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbClusterId}/resourcegroup/{#resourceGroupName}/sparkapp/{#sparkAppId}/{#sessionid}'], + ['validationType' => 'always', 'resourceType' => 'DBClusterLakeVersion', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/template/{#TemplateId}'], + ['validationType' => 'always', 'resourceType' => 'SparkTemplate', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/template/{#TemplateId}'], + ['validationType' => 'always', 'resourceType' => 'SparkApplication', 'arn' => 'acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}/resourcegroup/{#ResourceGroup}'], ], ], ]; |