'1.0',
'info' => ['style' => 'RPC', 'product' => 'DAS', 'version' => '2020-01-16'],
'directories' => [
[
'children' => ['AddHDMInstance'],
'type' => 'directory',
'title' => '实例接入',
'id' => 446812,
],
[
'children' => ['GetInstanceInspections'],
'type' => 'directory',
'title' => '巡检评分',
'id' => 446813,
],
[
'children' => ['SetEventSubscription', 'GetEventSubscription', 'GetAutonomousNotifyEventContent', 'GetAutonomousNotifyEventsInRange'],
'type' => 'directory',
'title' => '事件通知',
'id' => 446814,
],
[
'children' => ['CreateDiagnosticReport', 'DescribeDiagnosticReportList', 'GetDBInstanceConnectivityDiagnosis'],
'type' => 'directory',
'title' => '诊断报告',
'id' => 446815,
],
[
'children' => ['CreateCacheAnalysisJob', 'DescribeCacheAnalysisJob', 'DescribeCacheAnalysisJobs'],
'type' => 'directory',
'title' => '缓存分析',
'id' => 446817,
],
[
'children' => ['EnableSqlConcurrencyControl', 'DisableSqlConcurrencyControl', 'DisableAllSqlConcurrencyControlRules', 'GetRunningSqlConcurrencyControlRules', 'GetSqlConcurrencyControlRulesHistory', 'GetSqlConcurrencyControlKeywordsFromSqlText'],
'type' => 'directory',
'title' => 'SQL限流',
'id' => 446818,
],
[
'children' => ['CreateRequestDiagnosis', 'GetRequestDiagnosisResult', 'GetRequestDiagnosisPage', 'DescribeQueryExplain'],
'type' => 'directory',
'title' => 'SQL诊断',
'id' => 446819,
],
[
'children' => ['DescribeHotBigKeys', 'DescribeTopHotKeys', 'DescribeTopBigKeys', 'DescribeHotKeys'],
'type' => 'directory',
'title' => 'Key分析',
'id' => 446820,
],
[
'children' => ['CreateQueryOptimizeTag', 'GetQueryOptimizeExecErrorStats', 'GetQueryOptimizeExecErrorSample', 'GetQueryOptimizeSolution', 'GetQueryOptimizeRuleList', 'GetQueryOptimizeDataTrend', 'GetQueryOptimizeDataTop', 'GetQueryOptimizeDataStats', 'GetQueryOptimizeTag', 'GetQueryOptimizeShareUrl'],
'type' => 'directory',
'title' => '查询治理',
'id' => 446821,
],
[
'children' => ['GetErrorRequestSample', 'GetAsyncErrorRequestStatResult', 'GetAsyncErrorRequestListByCode', 'GetAsyncErrorRequestStatByCode', 'GetFullRequestOriginStatByInstanceId', 'GetFullRequestStatResultByInstanceId', 'GetFullRequestSampleByInstanceId'],
'type' => 'directory',
'title' => 'SQL洞察',
'id' => 446822,
],
[
'children' => ['DescribeSqlLogConfig', 'ModifySqlLogConfig', 'DescribeSqlLogStatistic', 'GetDasSQLLogHotData', 'CreateSqlLogTask', 'DescribeSqlLogTask', 'DescribeSqlLogTasks'],
'type' => 'directory',
'title' => '企业版管理',
'id' => 446823,
],
[
'children' => ['GetRedisAllSession', 'GetMongoDBCurrentOp', 'KillInstanceAllSession', 'CreateKillInstanceSessionTask', 'GetKillInstanceSessionTaskResult', 'GetMySQLAllSessionAsync'],
'type' => 'directory',
'title' => '实例会话',
'id' => 446824,
],
[
'children' => ['CreateStorageAnalysisTask', 'GetStorageAnalysisResult', 'GetAutoIncrementUsageStatistic'],
'type' => 'directory',
'title' => '空间分析',
'id' => 446825,
],
[
'children' => ['GetDeadLockDetailList', 'GetBlockingDetailList', 'CreateLatestDeadLockAnalysis', 'GetDeadLockHistory', 'GetDeadLockDetail', 'GetDeadlockHistogram'],
'type' => 'directory',
'title' => '锁优化',
'id' => 446826,
],
[
'children' => ['GetInstanceMissingIndexList'],
'type' => 'directory',
'title' => '索引诊断',
'id' => 446827,
],
[
'children' => ['DescribeSlowLogHistogramAsync', 'DescribeSlowLogStatistic', 'DescribeSlowLogRecords'],
'type' => 'directory',
'title' => '慢日志',
'id' => 446828,
],
[
'children' => ['UpdateAutoThrottleRulesAsync', 'DisableAutoThrottleRules', 'GetAutoThrottleRules'],
'type' => 'directory',
'title' => '自动SQL限流',
'id' => 446830,
],
[
'children' => ['UpdateAutoSqlOptimizeStatus', 'GetSqlOptimizeAdvice', 'GetInstanceSqlOptimizeStatistic'],
'type' => 'directory',
'title' => '自动SQL优化',
'id' => 446831,
],
[
'children' => ['UpdateAutoResourceOptimizeRulesAsync', 'DisableAutoResourceOptimizeRules', 'GetAutoResourceOptimizeRules'],
'type' => 'directory',
'title' => '自动空间优化',
'id' => 446832,
],
[
'children' => ['ModifyAutoScalingConfig', 'DescribeAutoScalingConfig', 'DescribeAutoScalingHistory', 'DisableInstanceDasConfig'],
'type' => 'directory',
'title' => '自动弹性伸缩',
'id' => 446833,
],
[
'children' => ['GetPartitionsHeatmap'],
'type' => 'directory',
'title' => '分区热力图',
'id' => 446834,
],
[
'children' => ['GetPfsSqlSample', 'GetPfsMetricTrends', 'GetPfsSqlSummaries'],
'type' => 'directory',
'title' => '性能洞察(新版)',
'id' => 446835,
],
[
'children' => ['DescribeErrorLogRecords'],
'type' => 'directory',
'title' => '错误日志',
'id' => 446836,
],
[
'children' => ['Chat', 'GetInstanceGroupInspectReportList', 'GetInstanceGroupInspectReportDetail'],
'type' => 'directory',
'title' => 'DAS Agent',
'id' => 446837,
],
[
'children' => ['CreateSecurityIPGroup', 'DescribeSecurityIPGroup', 'DescribeSecurityIPGroupRelation', 'ModifySecurityIPGroup', 'ModifySecurityIPGroupRelation', 'DeleteSecurityIPGroup'],
'type' => 'directory',
'title' => '跨产品白名单',
'id' => 446838,
],
[
'children' => ['GetDasAgentSSE', 'GetHDMAliyunResourceSyncResult', 'DescribeSqlLogRecords', 'EnableDasPro', 'DisableDasPro', 'DescribeInstanceDasPro', 'GetDasProServiceUsage', 'RunCloudBenchTask', 'DescribeCloudbenchTask', 'DescribeCloudBenchTasks', 'CreateCloudBenchTasks', 'DescribeCloudbenchTaskConfig', 'DeleteCloudBenchTask', 'DeleteStopGateway', 'GetYaoChiAgent', 'DescribeAuditLogs'],
'type' => 'directory',
'title' => '其他',
'id' => 446839,
],
],
'components' => [
'schemas' => [],
],
'apis' => [
'AddHDMInstance' => [
'summary' => '调用AddHDMInstance接口,将数据库实例接入DAS。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => ['operationType' => 'create'],
'parameters' => [
[
'name' => '__context',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceArea',
'in' => 'query',
'schema' => ['description' => '实例所属的数据库产品,取值:'."\n"
."\n"
.'- **RDS**:云实例。'."\n"
.'- **ECS**:ECS自建实例。'."\n"
.'- **IDC**:非公有云自建实例。'."\n"
."\n"
.'> IDC为用户数据中心。', 'type' => 'string', 'required' => true, 'example' => 'ECS'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => false, 'example' => 'rm-2ze1jdv45i7l6****'],
],
[
'name' => 'Ip',
'in' => 'query',
'schema' => ['description' => '待接入实例的内网连接地址。', 'type' => 'string', 'required' => false, 'example' => 'rm-2ze1jdv45i7l6****.mysql.rds.aliyuncs.com'],
],
[
'name' => 'Port',
'in' => 'query',
'schema' => ['description' => '实例的内网连接端口。', 'type' => 'string', 'required' => false, 'example' => '3306'],
],
[
'name' => 'Engine',
'in' => 'query',
'schema' => ['description' => '数据库引擎,取值:'."\n"
."\n"
.'- **MySQL**'."\n"
.'- **PostgreSQL**'."\n"
.'- **SQLServer**'."\n"
.'- **PolarDBMySQL**'."\n"
.'- **PolarDBPostgreSQL**'."\n"
.'- **Redis**'."\n"
.'- **MongoDB**'."\n"
.'- **PolarDBOracle**'."\n"
.'- **PolarDBX**', 'type' => 'string', 'required' => false, 'example' => 'MySQL'],
],
[
'name' => 'Username',
'in' => 'query',
'schema' => ['description' => '用户名。', 'type' => 'string', 'required' => false, 'example' => 'test****'],
],
[
'name' => 'Password',
'in' => 'query',
'schema' => ['description' => '用户名的密码。', 'type' => 'string', 'required' => false, 'example' => '122****'],
],
[
'name' => 'InstanceAlias',
'in' => 'query',
'schema' => ['description' => '实例名称。', 'type' => 'string', 'required' => false, 'example' => 'yuecq--test****'],
],
[
'name' => 'NetworkType',
'in' => 'query',
'schema' => ['description' => '实例的网络类型。', 'type' => 'string', 'required' => false, 'example' => 'VPC'],
],
[
'name' => 'VpcId',
'in' => 'query',
'schema' => ['description' => 'VPC ID。', 'type' => 'string', 'required' => false, 'example' => 'vpc-m5e666n89m2bx8jar****'],
],
[
'name' => 'Region',
'in' => 'query',
'schema' => ['description' => '实例所属的地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou'],
],
[
'name' => 'FlushAccount',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Synchro' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'Data' => [
'description' => '详细信息列表,包括信息总数、错误码等。',
'type' => 'object',
'properties' => [
'VpcId' => ['description' => 'VPC ID。', 'type' => 'string', 'example' => 'vpc-m5e666n89m2bx8jar****'],
'Token' => ['description' => '客户端token(即自定义的唯一随机字符串)。', 'type' => 'string', 'example' => 'tokenID'],
'Ip' => ['description' => '实例的IP连接地址。', 'type' => 'string', 'example' => 'rm-de21209****.mysql.rds.aliyuncs.com'],
'CallerUid' => ['description' => '调用者用户ID。', 'type' => 'string', 'example' => '31063db679****'],
'InstanceId' => ['description' => '实例的ID。', 'type' => 'string', 'example' => 'rm-2ze1jdv45i7l6****'],
'Port' => ['description' => '目标实例的端口。', 'type' => 'integer', 'format' => 'int32', 'example' => '3306'],
'OwnerId' => ['description' => '所有者ID。', 'type' => 'string', 'example' => '325352345'],
'Uuid' => ['description' => '实例的唯一标识符号。', 'type' => 'string', 'example' => 'hdm_3063db6792965c080a4bcb6e6304****'],
'Error' => ['description' => '错误消息。', 'type' => 'string', 'example' => 'InvalidRequestURL'],
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200'],
'Role' => ['description' => '角色信息。', 'type' => 'string', 'example' => 'master'],
'TenantId' => ['description' => '所属的租户ID。', 'type' => 'string', 'example' => 'L0EPfLS****=SCE00000*****'],
],
],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => ''],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => ''],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Synchro\\": \\"None\\",\\n \\"Data\\": {\\n \\"VpcId\\": \\"vpc-m5e666n89m2bx8jar****\\",\\n \\"Token\\": \\"tokenID\\",\\n \\"Ip\\": \\"rm-de21209****.mysql.rds.aliyuncs.com\\",\\n \\"CallerUid\\": \\"31063db679****\\",\\n \\"InstanceId\\": \\"rm-2ze1jdv45i7l6****\\",\\n \\"Port\\": 3306,\\n \\"OwnerId\\": \\"325352345\\",\\n \\"Uuid\\": \\"hdm_3063db6792965c080a4bcb6e6304****\\",\\n \\"Error\\": \\"InvalidRequestURL\\",\\n \\"Code\\": 200,\\n \\"Role\\": \\"master\\",\\n \\"TenantId\\": \\"L0EPfLS****=SCE00000*****\\"\\n },\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n None\\n \\n vpc-m5e666n89m2bx8jar****\\n tokenID\\n rm-de21209****.mysql.rds.aliyuncs.com\\n 31063db679****\\n rm-2ze1jdv45i7l6****\\n 3306\\n 325352345\\n hdm_3063db6792965c080a4bcb6e6304****\\n InvalidRequestURL\\n 200\\n master\\n L0EPfLS****=SCE00000*****\\n \\n 200\\n true\\n","errorExample":""}]',
'title' => '接入数据库实例',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'ramActions' => [
[
'operationType' => 'create',
'ramAction' => [
'action' => 'hdm:AddHDMInstance',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'Chat' => [
'summary' => 'DAS大模型能力异步逻辑接口',
'path' => '/chat',
'methods' => ['post'],
'schemes' => ['https', 'sse'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => ['FEATUREhdmB8MM4L', 'FEATUREhdmROFBLE', 'FEATUREhdm1XKIXR', 'FEATUREhdmR88NLD', 'FEATUREhdm3TU4OK'],
'autoTest' => true,
'tenantRelevance' => 'tenant',
],
'parameters' => [
[
'name' => 'Message',
'in' => 'query',
'schema' => ['description' => '消息', 'type' => 'string', 'required' => true, 'example' => '{"id":"68fe0321-37fe-4c75-a118-b61b33156f6a","role":"user","content":[{"type":"text","text":"hello"}]}'],
],
[
'name' => 'SessionId',
'in' => 'query',
'schema' => ['description' => '可选,会话 ID,格式为 UUID 字符串。如未指定默认创建新的会话。上下文对话需保持同一个会话 ID。', 'type' => 'string', 'required' => false, 'example' => '123e4567-e89b-12d3-a456-xxxxxxxxxxxx'],
],
[
'name' => 'AgentId',
'in' => 'query',
'schema' => ['description' => '可选,用于服务的 Agent ID。可指定为开启 DAS Agent 后生成的Agent 或主动创建的 Agent。如未指定则使用默认 Agent 进行服务。', 'type' => 'string', 'required' => false, 'example' => 'ag-472T0DxtmjIxxxxx'],
],
[
'name' => 'Summary',
'in' => 'query',
'schema' => ['description' => '是否输出摘要信息', 'type' => 'string', 'required' => false, 'example' => 'false'],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'Type' => ['description' => '事件类型', 'type' => 'string', 'example' => 'TEXT_MESSAGE_CONTENT'],
'MessageId' => ['description' => '消息ID', 'type' => 'string', 'example' => '61820b594664275c4429****'],
'Role' => ['description' => '对话角色ID', 'type' => 'string', 'example' => 'assistant'],
'Delta' => ['description' => '是否增量内容', 'type' => 'string', 'example' => 'hello'],
'ActivityType' => ['description' => '心跳', 'type' => 'string', 'example' => 'waiting_for_agent_thinking'],
'ToolCallId' => ['description' => '工具调用ID', 'type' => 'string', 'example' => 'call_edf9cdb69e0e4c9796a6a5a6'],
'ToolCallName' => ['description' => '工具名称', 'type' => 'string', 'example' => 'das_api'],
'Content' => ['description' => '回答内容', 'type' => 'string', 'example' => 'I see you have several PolarDB instances, and I will query them for you shortly'],
'ParentMessageId' => ['description' => '父消息 ID', 'type' => 'string', 'example' => '76bee207-31ee-4707-8851-6b9d4da033aa'],
'ThreadId' => ['description' => '线程ID', 'type' => 'string', 'example' => '8e481be1-21d5-4a92-a2fb-fb54be0ab4f6'],
'StepName' => ['description' => '执行步骤名称', 'type' => 'string', 'example' => 'sub_agent_performance_diagnose_mysql'],
'RunId' => ['description' => '运行ID', 'type' => 'string', 'example' => 'ed7cb7b1-ddc8-45d7-9ff3-b315726cb5f7'],
'TaskTrackerId' => ['description' => '回调工具类', 'type' => 'string', 'example' => 'das_api'],
'Name' => ['description' => '扩展Key', 'type' => 'string', 'example' => 'summary'],
'Value' => ['description' => '扩展Value', 'type' => 'any', 'example' => '{"CharCount":393,"End":1777428785996,"RequestId":"BE59AED5-D831-5811-BBAD-590B917B2089","SessionId":"123e4567-e89b-12d3-a456-xxxxxxxxxxxx","Start":1777428707927}'],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
[
['errorCode' => 'InstanceNotFound', 'errorMessage' => 'Requested instance not found.', 'description' => '对应实例id无法找到'],
],
500 => [
['errorCode' => 'Timeout', 'errorMessage' => 'The request processing has failed due to timeout.', 'description' => '由于超时请求处理失败。'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => 'DAS Agent 交互接口',
'description' => '前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 仅开通了DAS企业版的数据库实例支持创建离线任务。DAS企业版各个版本支持的数据库和地域请参见[DAS产品系列及支持的功能](~~156204~~)。'."\n"
."\n"
.'更多使用Chat接口与DAS Agent进行交互的方法和示例,请参考 [DAS Agent交互最佳实践(集成Chat API)](https://help.aliyun.com/zh/das/developer-reference/chat-api-best-practice)。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:Chat',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Type\\": \\"TEXT_MESSAGE_CONTENT\\",\\n \\"MessageId\\": \\"61820b594664275c4429****\\",\\n \\"Role\\": \\"assistant\\",\\n \\"Delta\\": \\"hello\\",\\n \\"ActivityType\\": \\"waiting_for_agent_thinking\\",\\n \\"ToolCallId\\": \\"call_edf9cdb69e0e4c9796a6a5a6\\",\\n \\"ToolCallName\\": \\"das_api\\",\\n \\"Content\\": \\"I see you have several PolarDB instances, and I will query them for you shortly\\",\\n \\"ParentMessageId\\": \\"76bee207-31ee-4707-8851-6b9d4da033aa\\",\\n \\"ThreadId\\": \\"8e481be1-21d5-4a92-a2fb-fb54be0ab4f6\\",\\n \\"StepName\\": \\"sub_agent_performance_diagnose_mysql\\",\\n \\"RunId\\": \\"ed7cb7b1-ddc8-45d7-9ff3-b315726cb5f7\\",\\n \\"TaskTrackerId\\": \\"das_api\\",\\n \\"Name\\": \\"summary\\",\\n \\"Value\\": \\"{\\\\\\"CharCount\\\\\\":393,\\\\\\"End\\\\\\":1777428785996,\\\\\\"RequestId\\\\\\":\\\\\\"BE59AED5-D831-5811-BBAD-590B917B2089\\\\\\",\\\\\\"SessionId\\\\\\":\\\\\\"123e4567-e89b-12d3-a456-xxxxxxxxxxxx\\\\\\",\\\\\\"Start\\\\\\":1777428707927}\\"\\n}","type":"json"}]',
],
'CreateCacheAnalysisJob' => [
'summary' => '调用CreateCacheAnalysisJob接口,创建缓存分析任务。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => ['operationType' => 'create'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => 'Redis实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'r-bp18ff4a195d****'],
],
[
'name' => 'NodeId',
'in' => 'query',
'schema' => ['description' => '实例的数据节点ID,传入本参数可查询指定节点的监控信息。'."\n"
.'>当您传入BackupSetId参数,系统会忽略此参数,您可调用[DescribeLogicInstanceTopology](~~473786~~)接口查询节点ID。', 'type' => 'string', 'required' => false, 'example' => 'r-x****-db-0'],
],
[
'name' => 'BackupSetId',
'in' => 'query',
'schema' => ['description' => '备份文件ID,可以通过[DescribeBackups](~~473823~~)接口获取。'."\n"
."\n"
.'- 如需传入多个备份文件ID,请使用英文逗号(,)分隔,例如`12345,67890`。'."\n"
.'- 如果不传入本参数,系统会自动执行备份并对该备份文件执行缓存分析。', 'type' => 'string', 'required' => false, 'example' => '12345'],
],
[
'name' => 'Separators',
'in' => 'query',
'schema' => ['description' => '用于识别Key前缀的分隔符。当分隔符为默认的`:;,_-+@=|#`时,不需要输入。', 'type' => 'string', 'required' => false, 'example' => '&'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Data' => [
'description' => '详细信息列表。',
'type' => 'object',
'properties' => [
'TaskState' => ['description' => '缓存分析任务的状态:'."\n"
."\n"
.'- **BACKUP**:备份中。'."\n"
.'- **ANALYZING**:分析中。'."\n"
.'- **FINISHED**:分析完成。'."\n"
.'- **FAILED**:出现错误。', 'type' => 'string', 'example' => 'BACKUP'],
'JobId' => ['description' => '缓存分析任务ID。'."\n"
.'>此参数可用于查询缓存分析任务使用,当您调用该API时,由于创建缓存分析任务需要一定的时间,不会立即返回分析结果,您需要通过此参数,结合[DescribeCacheAnalysisJob](~~180983~~)接口,查询具体的分析结果。', 'type' => 'string', 'example' => 'sf79-sd99-sa37-****'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'BigKeys' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'KeyInfo' => [
'description' => '大Key详细信息,根据Key占用字节数降序排列。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Type' => ['description' => 'Redis数据结构类型。', 'type' => 'string', 'example' => 'hash'],
'Db' => ['description' => '数据库名称。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'ExpirationTimeMillis' => ['description' => 'Key过期时间,单位:毫秒(ms),0表示不过期。', 'type' => 'integer', 'format' => 'int64', 'example' => '1596256542547'],
'Key' => ['description' => 'Key的名称。', 'type' => 'string', 'example' => 'task_x****'],
'Encoding' => ['description' => 'Key内部数据类型。', 'type' => 'string', 'example' => 'hashtable'],
'Bytes' => ['description' => 'Key占用字节数。', 'type' => 'integer', 'format' => 'int64', 'example' => '12345'],
'NodeId' => ['description' => '实例的数据节点ID。', 'type' => 'string', 'example' => 'r-x****-db-0'],
'Count' => ['description' => 'Key的元素个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '127'],
],
],
],
],
],
'InstanceId' => ['description' => '实例ID。', 'type' => 'string', 'example' => 'r-bp18ff4a195d****'],
'NodeId' => ['description' => '实例的数据节点ID。', 'type' => 'string', 'example' => 'r-x****-db-0'],
],
],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => ''],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => ''],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Data\\": {\\n \\"TaskState\\": \\"BACKUP\\",\\n \\"JobId\\": \\"sf79-sd99-sa37-****\\",\\n \\"Message\\": \\"Successful\\",\\n \\"BigKeys\\": {\\n \\"KeyInfo\\": [\\n {\\n \\"Type\\": \\"hash\\",\\n \\"Db\\": 0,\\n \\"ExpirationTimeMillis\\": 1596256542547,\\n \\"Key\\": \\"task_x****\\",\\n \\"Encoding\\": \\"hashtable\\",\\n \\"Bytes\\": 12345,\\n \\"NodeId\\": \\"r-x****-db-0\\",\\n \\"Count\\": 127\\n }\\n ]\\n },\\n \\"InstanceId\\": \\"r-bp18ff4a195d****\\",\\n \\"NodeId\\": \\"r-x****-db-0\\"\\n },\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n \\n BACKUP\\n sf79-sd99-sa37-****\\n Successful\\n \\n hash\\n 0\\n 1596256542547\\n task_x****\\n hashtable\\n 12345\\n r-x****-db-0\\n 127\\n \\n r-bp18ff4a195d****\\n r-x****-db-0\\n \\n 200\\n true\\n","errorExample":""}]',
'title' => '创建缓存分析任务',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 只支持分析Redis数据结构和以下Tair自研数据结构:TairString、TairHash、TairGIS、TairBloom、TairDoc、TairCpc、TairZset,暂不支持分析其他Tair自研数据结构。'."\n"
.'- 如果目标实例规格已发生变更,则不支持分析实例变更前的备份文件。'."\n"
.'- 暂不支持Tair磁盘型实例。',
'changeSet' => [],
'ramActions' => [
[
'operationType' => 'create',
'ramAction' => [
'action' => 'hdm:CreateCacheAnalysisJob',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'CreateCloudBenchTasks' => [
'summary' => '调用CreateCloudBenchTasks接口,创建压测任务。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'systemTags' => ['operationType' => 'create'],
'parameters' => [
[
'name' => 'TaskType',
'in' => 'query',
'schema' => ['description' => '压测任务类型。取值:'."\n"
.'- **pressure test**(默认):智能压测,将从源实例上捕获的流量,按照目标实例规格支持的极限速度,在目标实例上进行回放。'."\n"
.'- **smart pressure test**:生成压测,通过分析和学习短时间内在源实例上捕获的流量,生成和原始流量的业务模型和流量分布基本一致的流量进行持续压测,减少从源实例采集数据的时间,降低存储成本和性能开销。', 'type' => 'string', 'required' => true, 'example' => 'pressure test'],
],
[
'name' => 'SrcInstanceId',
'in' => 'query',
'schema' => ['description' => '源实例ID,仅支持RDS MySQL、PolarDB MySQL版实例,您可通过调用[GetInstanceInspections](~~202857~~)接口获取。'."\n"
.'>当**DstType**为**Instance**时,本参数需要传入。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze1jdv45i7l6****'],
],
[
'name' => 'Description',
'in' => 'query',
'allowEmptyValue' => false,
'schema' => ['description' => '压测任务描述。', 'type' => 'string', 'required' => true, 'example' => 'test-das-bench-0501'],
],
[
'name' => 'SrcPublicIp',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'DstInstanceId',
'in' => 'query',
'schema' => ['description' => '目标实例ID,仅支持RDS MySQL、PolarDB MySQL版实例,您可通过调用[GetInstanceInspections](~~202857~~)接口获取。'."\n"
.'>当**DstType**为**Instance**时,本参数需要传入。', 'type' => 'string', 'required' => false, 'example' => 'rm-2ze1jdv45i7l6****'],
],
[
'name' => 'GatewayVpcId',
'in' => 'query',
'schema' => ['description' => '数据库网关的专有网络ID。'."\n"
.'>若**ClientType**取值为**ECS**,则此参数必传入。', 'type' => 'string', 'required' => false, 'example' => 'vpc-t4nsnwvpbc1h76ja4****'],
],
[
'name' => 'GatewayVpcIp',
'in' => 'query',
'schema' => ['description' => '数据库网关的IP地址或域名。'."\n"
.'>若**ClientType**取值为**ECS**,则此参数必传入。', 'type' => 'string', 'required' => false, 'example' => '172.30.XX.XX'],
],
[
'name' => 'ClientType',
'in' => 'query',
'schema' => ['description' => '压测机器类型。取值:'."\n"
."\n"
.'- **ECS**:您需要自己准备[数据库网关](~~64905~~)。'."\n"
.'- **DAS_ECS**:DAS自动购买和部署的ECS。', 'type' => 'string', 'required' => true, 'example' => 'ECS'],
],
[
'name' => 'RequestStartTime',
'in' => 'query',
'schema' => ['description' => '压测任务的开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'string', 'required' => false, 'example' => '1608888296000'],
],
[
'name' => 'RequestEndTime',
'in' => 'query',
'schema' => ['description' => '压测任务的结束时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'string', 'required' => false, 'example' => '1608888296001'],
],
[
'name' => 'RequestDuration',
'in' => 'query',
'schema' => ['description' => '压测任务的持续时间,单位为毫秒。', 'type' => 'string', 'required' => false, 'example' => '86400000'],
],
[
'name' => 'Rate',
'in' => 'query',
'schema' => ['description' => '源实例流量在目标实例上的回放速度,回放速度必须是正整数,取值:**1**~**30**,默认为**1**。', 'type' => 'string', 'required' => false, 'example' => '1'],
],
[
'name' => 'SmartPressureTime',
'in' => 'query',
'schema' => ['description' => '生成压测的持续时间,单位为毫秒。'."\n"
.'>当**TaskType**为**smart pressure test**时本参数需要传入。', 'type' => 'string', 'required' => false, 'example' => '86400000'],
],
[
'name' => 'DtsJobClass',
'in' => 'query',
'schema' => ['description' => 'DTS迁移任务规格,您可以通过调用[DescribeCloudbenchTask](~~230669~~)接口获取。'."\n"
.'>压测任务需要先将源实例基准数据迁移至目标实例,当您新建DTS任务时需要传入本参数。', 'type' => 'string', 'required' => false, 'example' => 'medium'],
],
[
'name' => 'DtsJobId',
'in' => 'query',
'schema' => ['description' => 'DTS迁移任务ID,您可调用[ConfigureDtsJob](~~208399~~)接口获取。'."\n"
.'>已在DTS控制台创建完DTS任务时本参数必传入。', 'type' => 'string', 'required' => false, 'example' => '23127'],
],
[
'name' => 'SrcSuperAccount',
'in' => 'query',
'schema' => ['description' => '源端实例高权限账号。取值:**admin**。'."\n"
.'>当**DstType**为**Instance**时,本参数需要传入。', 'type' => 'string', 'required' => false, 'example' => 'admin'],
],
[
'name' => 'SrcSuperPassword',
'in' => 'query',
'schema' => ['description' => '源端实例高权限账号的密码。'."\n"
.'>当**DstType**为**Instance**时,本参数需要传入。', 'type' => 'string', 'required' => false, 'example' => 'test123'],
],
[
'name' => 'DstSuperAccount',
'in' => 'query',
'schema' => ['description' => '目标实例的高权限账号。', 'type' => 'string', 'required' => false, 'example' => 'root'],
],
[
'name' => 'DstSuperPassword',
'in' => 'query',
'schema' => ['description' => '目标实例高权限账号的密码。', 'type' => 'string', 'required' => false, 'example' => 'test123'],
],
[
'name' => 'DstType',
'in' => 'query',
'schema' => ['description' => '目标实例的类型。取值:'."\n"
.'- **Instance**(默认):实例ID。'."\n"
.'- **ConnectionString**:实例的连接地址。', 'type' => 'string', 'required' => false, 'example' => 'Instance'],
],
[
'name' => 'DstConnectionString',
'in' => 'query',
'schema' => ['description' => '目标实例的连接地址,仅支持RDS MySQL、PolarDB MySQL版实例。'."\n"
.'>**DstType**为**ConnectionString**本参数有效。', 'type' => 'string', 'required' => false, 'example' => 'rm-de21209****.mysql.rds.aliyuncs.com'],
],
[
'name' => 'DstPort',
'in' => 'query',
'schema' => ['description' => '目标实例的端口。'."\n"
.'>**DstType**为**ConnectionString**本参数有效。', 'type' => 'string', 'required' => false, 'example' => '3306'],
],
[
'name' => 'WorkDir',
'in' => 'query',
'schema' => ['description' => '压测生成的临时目录。', 'type' => 'string', 'required' => false, 'example' => '/tmp/bench/'],
],
[
'name' => 'BackupId',
'in' => 'query',
'schema' => ['description' => '备份集ID,可通过查询备份列表接口[DescribeBackups](~~26273~~)获取。', 'type' => 'string', 'required' => false, 'example' => '229132'],
],
[
'name' => 'BackupTime',
'in' => 'query',
'schema' => ['description' => '备份的时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。', 'type' => 'string', 'required' => false, 'example' => '2021-04-23T13:22:14Z'],
],
[
'name' => 'Amount',
'in' => 'query',
'schema' => ['description' => '创建压测任务的总个数,取值:**0**~**30**,默认为**1**。', 'type' => 'string', 'required' => false, 'example' => '1', 'default' => '1'],
],
[
'name' => 'EndState',
'in' => 'query',
'schema' => ['description' => '压测任务结束后的状态。取值:'."\n"
."\n"
.'- **WAIT_TARGET**:准备压测的目标实例。'."\n"
.'- **WAIT_DBGATEWAY**:准备压测部署。'."\n"
.'- **WAIT_SQL**:准备全量SQL。'."\n"
.'- **WAIT_LOGIC**:准备开始回放流量。'."\n"
."\n"
.'>当压测任务执行完EndState设置的状态之后,任务将直接到达完成状态。', 'type' => 'string', 'required' => false, 'example' => 'WAIT_TARGET'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'taskIds' => [
'description' => '详细信息列表。',
'type' => 'array',
'items' => ['description' => '详细信息列表,包括信息总数、错误码等。', 'type' => 'string', 'example' => '"Data": { "total": 1, "list":[...] }, "Code": 200, "Success": true }'],
],
],
'description' => '',
],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '创建压测任务',
'description' => '数据库自治服务DAS提供智能压测功能,帮助您验证您的实例规格是否需要扩容,有效应对业务流量高峰。更多信息,请参见[智能压测](~~155068~~)。数据库需满足如下前提条件:'."\n"
."\n"
.' - 源数据库仅支持RDS MySQL高可用系列或三节点企业系列、PolarDB MySQL版的集群版。'."\n"
.' - 目标数据库实例为RDS MySQL、PolarDB MySQL版。'."\n"
.' - 实例已接入DAS,详情请参见[接入阿里云数据库实例](~~65405~~)。'."\n"
.' - 需开启DAS企业版,详情请参见[DAS企业版](~~190912~~)。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateCloudBenchTasks'],
],
],
'ramActions' => [
[
'operationType' => 'create',
'ramAction' => [
'action' => 'hdm:CreateCloudBenchTasks',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"taskIds\\": [\\n \\"\\\\\\"Data\\\\\\": { \\\\\\"total\\\\\\": 1, \\\\\\"list\\\\\\":[...] }, \\\\\\"Code\\\\\\": 200, \\\\\\"Success\\\\\\": true }\\"\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n \\"Data\\": { \\"total\\": 1, \\"list\\":[...] }, \\"Code\\": 200, \\"Success\\": true }\\n","errorExample":""}]',
],
'CreateDiagnosticReport' => [
'summary' => '调用CreateDiagnosticReport接口,创建诊断报告。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => ['operationType' => 'create'],
'parameters' => [
[
'name' => 'DBInstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => ['description' => '创建任务开始时间,格式为Unix时间戳(UTC时间),单位为毫秒。', 'type' => 'string', 'required' => true, 'example' => '1596177993000'],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => ['description' => '创建任务结束时间,格式为Unix时间戳(UTC时间),单位为毫秒。'."\n"
.'>创建任务结束时间需晚于创建任务开始时间。', 'type' => 'string', 'required' => true, 'example' => '1596177993001'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'ac544623-f6ad-45fd-9a74-9be3db65****'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => ['description' => '返回的数据。', 'type' => 'string', 'example' => '70af71852fcdf2c5dc7b90596e2cf05b'],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '创建诊断报告',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 在使用阿里云SDK时,需要保证aliyun-sdk-core的版本大于4.3.3,建议使用最新版本。'."\n"
.'- 使用DAS的SDK的版本为1.0.3或以上。'."\n"
.'- 在调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 本接口适用的数据库引擎为:'."\n"
."\n"
.' - RDS MySQL'."\n"
.' - PolarDB MySQL版'."\n"
.' - Redis',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateDiagnosticReport'],
],
],
'ramActions' => [
[
'operationType' => 'create',
'ramAction' => [
'action' => 'hdm:CreateDiagnosticReport',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"ac544623-f6ad-45fd-9a74-9be3db65****\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": \\"70af71852fcdf2c5dc7b90596e2cf05b\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n ac544623-f6ad-45fd-9a74-9be3db65****\\n Successful\\n 70af71852fcdf2c5dc7b90596e2cf05b\\n 200\\n true\\n","errorExample":""}]',
],
'CreateKillInstanceSessionTask' => [
'summary' => '调用CreateKillInstanceSessionTask接口,创建结束会话的任务。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => ['operationType' => 'create'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
[
'name' => 'NodeId',
'in' => 'query',
'schema' => ['description' => '节点ID。'."\n"
."\n"
.'> 对于PolarDB MySQL版实例,需要提供节点ID。如果没有提供节点ID,并且请求参数**KillAllSessions**配置为**true**(即结束全部会话),将会遍历PolarDB MySQL版实例所有节点,并结束每个节点上正在进行的会话。', 'type' => 'string', 'required' => false, 'example' => 'pi-bp1v203xzzh0a****'],
],
[
'name' => 'DbUser',
'in' => 'query',
'schema' => ['description' => '具有结束会话权限的数据库账号。', 'type' => 'string', 'required' => true, 'example' => 'testUser'],
],
[
'name' => 'DbUserPassword',
'in' => 'query',
'schema' => ['description' => '数据库账号密码。', 'type' => 'string', 'required' => true, 'example' => 'testPassword'],
],
[
'name' => 'IgnoredUsers',
'in' => 'query',
'schema' => ['description' => '忽略账号列表,该列表中账号的会话不会被结束。'."\n"
."\n"
.'> 数据格式为JSONArray字符串,例如\\[\'数据库账号1\',\'数据库账号2\'\\],数据库账号间用英文逗号(,)分隔。', 'type' => 'string', 'required' => false, 'example' => '[\'db_user1\',\'db_user2\']'],
],
[
'name' => 'KillAllSessions',
'in' => 'query',
'schema' => ['description' => '是否结束全部会话。'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。'."\n"
."\n"
.'> 该参数取值为**true**时,请求参数**IgnoredUsers**中账号的会话、阿里云内部运维账号的会话和**Binlog Dump**会话都不会被结束。', 'type' => 'boolean', 'required' => true, 'example' => 'true'],
],
[
'name' => 'SessionIds',
'in' => 'query',
'schema' => ['description' => '需要被结束的会话ID列表。'."\n"
."\n"
.'> 数据格式为JSONArray,例如\\[会话ID1,会话ID2\\],会话ID间用英文逗号(,)分隔。如果请求参数**KillAllSessions**取值为**true**(即结束全部会话),该列表会被忽略。', 'type' => 'string', 'required' => false, 'example' => '[10805639,10805623,10805645,10805553,10805566,10805616]'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => ['description' => '结束会话的任务ID。'."\n"
."\n"
.'> PolarDB MySQL版实例调用该API接口,请求参数**NodeId**为空(即未指定节点ID),并且请求参数**KillAllSessions**配置为**true**(即结束全部会话)时,会按照节点数量返回任务ID列表,例如\\["f77d535b45405bd462b21caa3ee8\\*\\*\\*\\*", "e93ab549abb081eb5dcd5396a29b\\*\\*\\*\\*"\\]', 'type' => 'string', 'example' => 'f77d535b45405bd462b21caa3ee8****'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'true'],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => ''],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => ''],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": \\"f77d535b45405bd462b21caa3ee8****\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n f77d535b45405bd462b21caa3ee8****\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n","errorExample":""}]',
'title' => '创建结束会话的任务',
'description' => '- 本接口只适用于RDS MySQL和PolarDB MySQL版实例。'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'ramActions' => [
[
'operationType' => 'create',
'ramAction' => [
'action' => 'hdm:CreateKillInstanceSessionTask',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'CreateLatestDeadLockAnalysis' => [
'summary' => '创建最近死锁分析任务。',
'methods' => ['post', 'get'],
'schemes' => ['https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'none',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => ['FEATUREhdm7GLEEO'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'pc-bp1u5mas9exx7****'],
],
[
'name' => 'NodeId',
'in' => 'formData',
'schema' => ['description' => '节点ID。'."\n"
."\n"
.'> 对于PolarDB MySQL版实例,需要提供节点ID。', 'type' => 'string', 'required' => false, 'example' => 'pi-bp16v3824rt73****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => 'OpenAPI请求的ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => [
'description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。',
'type' => 'boolean',
'enumValueTitles' => ['执行成功' => 'true', '执行失败' => 'false'],
'example' => 'true',
],
'Data' => [
'description' => '创建任务是否成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。',
'type' => 'boolean',
'enumValueTitles' => ['执行成功' => 'true', '执行失败' => 'false'],
'example' => 'true',
],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '创建最近死锁分析任务',
'description' => '本接口用于创建最近死锁分析任务。DAS基于SHOW ENGINE INNODB STATUS返回的最近一次死锁日志进行分析。如果发生过多次死锁,DAS只会对最近一次死锁进行分析。详情请参见[最近死锁分析](~~2858236~~)。'."\n"
."\n"
.'使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 目标数据库引擎为:RDS MySQL、自建MySQL、PolarDB MySQL版、PolarDB-X 2.0。'."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateLatestDeadLockAnalysis'],
],
],
'ramActions' => [
[
'operationType' => 'none',
'ramAction' => [
'action' => 'hdm:CreateLatestDeadLockAnalysis',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": true,\\n \\"Data\\": true\\n}","type":"json"}]',
],
'CreateQueryOptimizeTag' => [
'summary' => '调用CreateQueryOptimizeTag接口,对目标SQL进行打标。',
'methods' => ['post'],
'schemes' => ['https', 'http'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free'],
'parameters' => [
[
'name' => 'Engine',
'in' => 'query',
'schema' => ['description' => '数据库引擎,取值:'."\n"
."\n"
.'- **MySQL**:RDS MySQL'."\n"
.'- **PolarDBMySQL**:PolarDB MySQL版'."\n"
.'- **PostgreSQL**:RDS PostgreSQL', 'type' => 'string', 'required' => true, 'example' => 'MySQL'],
],
[
'name' => 'SqlIds',
'in' => 'query',
'schema' => ['description' => 'SQL模板ID,您可以调用[GetQueryOptimizeDataStats](~~405261~~)接口查询SQL模板ID。支持英文逗号(,)分隔传入多个模板ID,进行批量打标。', 'type' => 'string', 'required' => true, 'example' => '6068ce044e3dc9b903979672fb0b69df,d12515c015fc9f41a0778a9e1de0****'],
],
[
'name' => 'Tags',
'in' => 'query',
'schema' => [
'description' => 'SQL标签。支持英文逗号(,)分隔传入多个值。'."\n"
."\n"
.'- **DAS\\_IMPORTANT**:重要SQL。'."\n"
.'- **DAS\\_NOT\\_IMPORTANT**:不重要SQL。'."\n"
.'- **USER\\_IGNORE**:无需优化。'."\n"
.'- **DAS\\_IN\\_PLAN**:排期优化。',
'type' => 'string',
'required' => true,
'enumValueTitles' => [],
'example' => 'DAS_IN_PLAN,DAS_NOT_IMPORTANT',
],
],
[
'name' => 'Status',
'in' => 'query',
'schema' => ['description' => '设置请求参数**Tags**的状态:'."\n"
."\n"
.'- **0**:清空请求参数**SqlIds**对应的全部标签,忽略请求参数**Tags**设置。'."\n"
.'- **1**:设置请求参数**SqlIds**对应的标签为请求参数**Tags**的值。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '1'],
],
[
'name' => 'Comments',
'in' => 'query',
'schema' => ['description' => '备注。'."\n"
."\n"
.'长度为1~300个字符。', 'type' => 'string', 'required' => false, 'example' => 'Slow SQL from offline synchronization. No optimization needed.'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze1jdv45i7l6****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '阿里云为该请求生成的唯一标识符。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => ['title' => 'Boolean', 'description' => '打标操作是否执行成功:'."\n"
."\n"
.'- **true**:打标成功。'."\n"
.'- **false**:打标失败。', 'type' => 'boolean', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n true\\n","errorExample":""}]',
'title' => '对目标SQL进行打标',
'description' => '- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 本接口适用的数据库引擎为:'."\n"
.' - RDS MySQL'."\n"
.' - PolarDB MySQL版'."\n"
.' - RDS PostgreSQL',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateQueryOptimizeTag'],
],
],
'ramActions' => [
[
'operationType' => 'update',
'ramAction' => [
'action' => 'hdm:CreateQueryOptimizeTag',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'CreateRequestDiagnosis' => [
'summary' => '调用CreateRequestDiagnosis接口,发起SQL诊断请求。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => ['operationType' => 'create'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-0iwhhl8gx0ld6****'],
],
[
'name' => 'NodeId',
'in' => 'query',
'schema' => ['description' => '节点ID。'."\n"
.'> 对于PolarDB MySQL版、PolarDB PostgreSQL版(兼容Oracle)和云数据库MongoDB等集群实例,需要提供节点ID。', 'type' => 'string', 'required' => false, 'example' => '202****'],
],
[
'name' => 'Database',
'in' => 'query',
'schema' => ['description' => '数据库名。', 'type' => 'string', 'required' => true, 'example' => 'das'],
],
[
'name' => 'Sql',
'in' => 'query',
'schema' => ['description' => '待诊断的SQL。', 'type' => 'string', 'required' => true, 'example' => 'select * from test where name = \'mockUser\''],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回的消息。'."\n"
."\n"
.'> 请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => ['description' => '诊断ID,是诊断的唯一标识,后续用于查询诊断结果。', 'type' => 'string', 'example' => '61820b594664275c4429****'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '800FBAF5-A539-5B97-A09E-C63AB2F7****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '发起SQL诊断请求',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 本接口适用的数据库引擎为:'."\n"
."\n"
.' - RDS MySQL'."\n"
.' - RDS PostgreSQL'."\n"
.' - RDS SQL Server'."\n"
.' - PolarDB MySQL版'."\n"
.' - PolarDB PostgreSQL版(兼容Oracle)'."\n"
.' - 云数据库MongoDB版'."\n"
."\n"
.'> RDS PostgreSQL实例内核小版本为20221230及以上。查看和升级内核小版本,请参见[升级内核小版本](~~146895~~)。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateRequestDiagnosis'],
],
],
'ramActions' => [
[
'operationType' => 'create',
'ramAction' => [
'action' => 'hdm:CreateRequestDiagnosis',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": \\"61820b594664275c4429****\\",\\n \\"RequestId\\": \\"800FBAF5-A539-5B97-A09E-C63AB2F7****\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n 61820b594664275c4429****\\n 800FBAF5-A539-5B97-A09E-C63AB2F7****\\n true\\n","errorExample":""}]',
],
'CreateSecurityIPGroup' => [
'summary' => '创建用户跨产品白名单模板',
'path' => '',
'methods' => ['post', 'get'],
'schemes' => ['https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '247410',
'abilityTreeNodes' => ['FEATUREhdmQULC0I'],
'tenantRelevance' => 'tenant',
],
'parameters' => [
[
'name' => 'RegionName',
'in' => 'query',
'allowEmptyValue' => false,
'schema' => ['description' => '地域 ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-beijing'],
],
[
'name' => 'GlobalIgName',
'in' => 'query',
'schema' => ['description' => 'IP白名单模板名称。IP白名单模板名称需满足如下要求:'."\n"
."\n"
.'- 由小写字母、数字、下划线(_)组成。'."\n"
."\n"
.'- 由字母开头、字母或数字结尾。'."\n"
."\n"
.'- 长度为2~120个字符。', 'type' => 'string', 'required' => true, 'example' => 'test_123'],
],
[
'name' => 'GIpList',
'in' => 'query',
'schema' => ['description' => '白名单模板内的IP地址。'."\n"
."\n"
.'> 多个IP地址需要用英文逗号(,)分隔,不可重复,上限为1000个。', 'type' => 'string', 'required' => true, 'example' => '192.168.0.1'],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Data' => [
'title' => 'ListResult',
'description' => 'ListResult',
'type' => 'object',
'properties' => [
'GlobalSecurityIPGroup' => [
'description' => '跨产品白名单模板信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'SecurityIpType' => ['description' => 'IP类型', 'type' => 'string', 'example' => 'ipv4'],
'RegionId' => ['description' => '地域 ID。'."\n"
."\n"
.'示例值:'."\n"
.'cn-hangzhou', 'type' => 'string', 'example' => 'cn-shenzhen'],
'GlobalIgName' => ['description' => 'IP白名单模板名称。IP白名单模板名称需满足如下要求:'."\n"
."\n"
.'- 由小写字母、数字、下划线(_)组成。'."\n"
."\n"
.'- 由字母开头、字母或数字结尾。'."\n"
."\n"
.'- 长度为2~120个字符。', 'type' => 'string', 'example' => 'test'],
'GlobalSecurityGroupId' => ['description' => 'IP白名单模板ID。', 'type' => 'string', 'example' => 'g-2uztsd6yvhmsqyjXXX'],
'WhitelistNetType' => ['description' => '白名单的网络类型。', 'type' => 'string', 'example' => 'mix'],
'GIpList' => ['description' => '白名单模板内的IP地址。'."\n"
."\n"
.'> 多个IP地址需要用英文逗号隔开,所有IP白名单累积支持添加1000个IP地址或地址段。', 'type' => 'string', 'example' => '192.168.0.0/24'],
],
'description' => '',
],
],
],
],
'Message' => ['description' => '请求返回的消息。'."\n"
."\n"
.'> 请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'D578DB3C-06BF-54F2-A78F-C6C25Exxxxxx'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'description' => '前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 仅开通了DAS企业版的数据库实例支持创建离线任务。DAS企业版各个版本支持的数据库和地域请参见[DAS产品系列及支持的功能](~~156204~~)。'."\n"
."\n"
.'接口限制:'."\n"
."\n"
.'最大同时执行数量为10。',
'title' => '跨产品白名单模板创建接口',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [],
],
'ramActions' => [
[
'operationType' => 'create',
'ramAction' => [
'action' => 'hdm:CreateSecurityIPGroup',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Data\\": {\\n \\"GlobalSecurityIPGroup\\": [\\n {\\n \\"SecurityIpType\\": \\"ipv4\\",\\n \\"RegionId\\": \\"cn-shenzhen\\",\\n \\"GlobalIgName\\": \\"test\\",\\n \\"GlobalSecurityGroupId\\": \\"g-2uztsd6yvhmsqyjXXX\\",\\n \\"WhitelistNetType\\": \\"mix\\",\\n \\"GIpList\\": \\"192.168.0.0/24\\"\\n }\\n ]\\n },\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"D578DB3C-06BF-54F2-A78F-C6C25Exxxxxx\\",\\n \\"Success\\": \\"true\\"\\n}","type":"json"}]',
],
'CreateSqlLogTask' => [
'summary' => '创建明细数据异步任务。',
'methods' => ['post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '199695',
'abilityTreeNodes' => ['FEATUREhdmFT57I0'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['description' => '数据库实例ID。', 'type' => 'string', 'required' => false, 'example' => 'pc-2ze8g2am97624****'],
],
[
'name' => 'NodeId',
'in' => 'formData',
'schema' => ['description' => '节点ID。'."\n"
.'>该参数仅适用于集群版实例,可以选择查询指定节点离线任务。若不传该参数,默认返回主节点离线任务。', 'type' => 'string', 'required' => false, 'example' => 'pi-uf6k5f6g3912i****'],
],
[
'name' => 'Type',
'in' => 'formData',
'schema' => ['description' => '任务类型'."\n"
."\n"
.'- **Export**:导出任务。'."\n"
.'> **Export**支持的过滤参数及其取值请参考**请求参数补充说明**。'."\n"
.'- **Query**:查询任务。', 'type' => 'string', 'required' => false, 'example' => 'Export'],
],
[
'name' => 'Name',
'in' => 'formData',
'schema' => ['description' => '任务名称。', 'type' => 'string', 'required' => false, 'example' => 'SQL audit export 1'],
],
[
'name' => 'Filters',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '筛选条件列表。',
'type' => 'array',
'items' => [
'description' => '筛选条件。',
'type' => 'object',
'properties' => [
'Key' => ['title' => '过滤参数', 'description' => '过滤参数的名称。'."\n"
."\n"
.'> 支持的过滤参数及其取值请参考**请求参数补充说明**。', 'type' => 'string', 'required' => false, 'example' => 'KeyWords'],
'Value' => ['description' => '过滤参数的数值。', 'type' => 'string', 'required' => false, 'example' => 'select'],
],
'required' => false,
],
'required' => false,
'maxItems' => 100,
],
],
[
'name' => 'StartTime',
'in' => 'formData',
'schema' => ['description' => '任务的开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1596177993000'."\n"],
],
[
'name' => 'EndTime',
'in' => 'formData',
'schema' => ['description' => '任务结束时间,格式为unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1608888296000'."\n"],
],
[
'name' => 'Role',
'in' => 'query',
'schema' => ['description' => 'PolarDB-X 2.0数据库实例节点信息。'."\n"
."\n"
.'- **polarx_cn**:计算节点。'."\n"
."\n"
.'- **polarx_dn**:数据节点。', 'type' => 'string', 'required' => false, 'example' => 'polarx_cn'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '83D9D59B-057A-54A9-BFF9-CF2B42F05645'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'title' => 'SqlLogTask',
'description' => '返回数据。',
'type' => 'object',
'properties' => [
'TaskId' => ['description' => '任务ID。', 'type' => 'string', 'example' => '54f8041743ca3a9ac5cb9342d050527c'],
'InstanceId' => ['title' => '实例标识', 'description' => '数据库实例ID。', 'type' => 'string', 'example' => 'pc-2ze8g2am97624****'],
'Name' => ['title' => '任务别名', 'description' => '任务名称。', 'type' => 'string', 'example' => 'Export_test'],
'Start' => ['title' => '查询开始时间', 'description' => '开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1596177993000'],
'End' => ['title' => '查询结束时间', 'description' => '结束时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1608888296000'."\n"],
'Status' => ['title' => '任务状态', 'description' => '任务状态。'."\n"
.'- **INIT**:待调度。'."\n"
.'- **RUNNING**:运行中。'."\n"
.'- **FAILED**:失败。'."\n"
.'- **CANCELED**:已取消。'."\n"
.'- **COMPLETED**:完成。'."\n"
."\n"
.'> 当任务处于**COMPLETED**时,可以查看任务的结果。', 'type' => 'string', 'example' => 'COMPLETED'],
'CreateTime' => ['title' => '任务创建时间', 'description' => '任务创建时间,格式为unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1681363254423'."\n"],
],
],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"83D9D59B-057A-54A9-BFF9-CF2B42F05645\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"TaskId\\": \\"54f8041743ca3a9ac5cb9342d050527c\\",\\n \\"InstanceId\\": \\"pc-2ze8g2am97624****\\",\\n \\"Name\\": \\"Export_test\\",\\n \\"Start\\": 1596177993000,\\n \\"End\\": 1608888296000,\\n \\"Status\\": \\"COMPLETED\\",\\n \\"CreateTime\\": 1681363254423\\n }\\n}","type":"json"}]',
'title' => '创建DAS企业版离线任务',
'description' => '前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 仅开通了DAS企业版的数据库实例支持创建离线任务。DAS企业版各个版本支持的数据库和地域请参见[DAS产品系列及支持的功能](~~156204~~)。'."\n"
."\n"
.'接口限制:'."\n"
."\n"
.'最大同时执行数量为10。',
'requestParamsDescription' => '**Key**支持的参数和取值:'."\n"
.'- **KeyWords**:关键字,多个关键字间使用空格隔开。'."\n"
.'- **LogicalOperator**:关键字间的逻辑操作,取值为and或or。'."\n"
.'- **AccountName**:用户名,可以传递多个的,用逗号分开,上限为5。'."\n"
.'- **DbName**:数据库名称,可以传递多个的,用逗号分开,上限为5。'."\n"
.'- **HostAddress**:客户端IP地址,可以传递多个的,用逗号分开,上限为5。'."\n"
.'- **MaxConsume**:最大耗时,单位us。'."\n"
.'- **MinConsume**:最小耗时,单位us。'."\n"
.'- **MaxScanRows**:最大扫描行。'."\n"
.'- **MinScanRows**:最小扫描行。'."\n"
.'- **SqlType**:SQL类型,取值select、update、insert或delete。'."\n"
.'- **State**:执行结果,取值0(成功)或1(失败)。'."\n"
.'- **ThreadId**:线程ID。'."\n"
.'- **SortKey**:排序列名称,取值ScanRows(扫描行数)、UpdateRows(更新行数)、Consume(耗时)、ExecuteTime(执行时间)、ReturnRows(返回行数)、LockTime(锁等待时间)、Frows(PolarDB-X 2.0计算节点的拉取行数)、Scnt(PolarDB-X 2.0计算节点的DN请求数)、CpuTime(CPU执行时间)、PhysicalRead(物理读)。'."\n"
.'- **SortMethod**:排序方式,取值DESC(降序)、ASC(升序)。默认为DESC。'."\n"
.'- **TraceId**:PolarDB-X 2.0实例的跟踪ID。'."\n"
.'- **MinRows**:最小更新行数。'."\n"
.'- **MaxRows**:最大更新行数。'."\n"
.'- **MinScnt**:PolarDB-X 2.0计算节点(CN)的DN最小请求数。'."\n"
.'- **MaxScnt**:PolarDB-X 2.0计算节点(CN)的DN最大请求数。'."\n"
.'- **TrxId**:事务ID。'."\n"
.'- **Fail**:错误码。'."\n"
.'- **SqlId**:SQL ID。'."\n"
.'- **JobId**:通过异步任务ID进一步查询返回结果。'."\n"
.'- **Delimiter**:分隔符,支持的`|` `,` `$` `#` 四种。'."\n"
.'- **Columns**:**Type** = **Export**,任务类型为导出任务时,传入选择的导出列,导出列用空格隔开,可选的有'."\n"
.' - **columnDBName**:数据库'."\n"
.' - **columnThreadId**:线程ID'."\n"
.' - **columnAccountName**:用户'."\n"
.' - **columnHostAddress**:客户端IP'."\n"
.' - **columnSqlType**:sql类型'."\n"
.' - **columnState**:状态'."\n"
.' - **columnConsume**:耗时us'."\n"
.' - **columnUpdateRows**:更新行数'."\n"
.' - **columnScanRows**:扫描行数'."\n"
.' - **columnReturnRows**:返回行数'."\n"
.' - **columnLockTime**:锁等待时间'."\n"
.' - **columnLogicRead**:逻辑读'."\n"
.' - **columnPhysicSyncRead**:物理同步读'."\n"
.' - **columnPhysicASyncRead**:物理异步读'."\n"
.' - **columnOriginTime**:执行时间(us)'."\n"
.' - **columnExecuteTime**:执行时间(类似于 2024-07-30 11:00:00)',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateSqlLogTask'],
],
],
'ramActions' => [
[
'operationType' => 'create',
'ramAction' => [
'action' => 'hdm:CreateSqlLogTask',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'CreateStorageAnalysisTask' => [
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze1jdv45i7l6****'],
],
[
'name' => 'NodeId',
'in' => 'query',
'schema' => ['description' => '节点ID。'."\n"
.'对于MongoDB实例,通过该参数指定节点进行空间分析。调用[DescribeRoleZoneInfo](~~123802~~)接口,可以查询MongoDB实例各个节点的详细信息。'."\n"
."\n"
.'- 当传入目标节点的**InsName**(节点ID)时,例如`d-bp1872fa24d5****`,调用该接口分析其对应的Hidden节点。'."\n"
.'- 当传入目标节点的`InsName#RoleId`时,例如`d-bp1872fa24d5****#299****5`,调用该接口分析指定的节点。'."\n"
."\n"
.'>对于MongoDB副本集实例,不传入此参数时,调用该接口会默认分析唯一的Hidden节点。对于MongoDB分片集群实例,推荐传入此参数,指定目标节点。', 'type' => 'string', 'required' => false, 'example' => 'd-bp1872fa24d5****'],
],
[
'name' => 'DbName',
'in' => 'query',
'schema' => ['description' => '数据库名。传入该参数时,分析指定数据库的空间使用情况。', 'type' => 'string', 'required' => false, 'example' => 'testdb01'],
],
[
'name' => 'TableName',
'in' => 'query',
'schema' => ['description' => '表名。传入该参数时,分析指定数据库中指定表的空间使用情况。传入该参数时,必须同时传入**DbName**,指定该表所属的数据库。', 'type' => 'string', 'required' => false, 'example' => 'test_table'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => [
'description' => '返回的数据。',
'type' => 'object',
'properties' => [
'TaskId' => ['description' => '任务ID。', 'type' => 'string', 'example' => '910f83f4b96df0524ddc5749f61539f8'],
'CreateTaskSuccess' => ['description' => '创建任务是否成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'false'],
'ErrorMessage' => ['description' => '创建任务失败时的错误提示。', 'type' => 'string', 'example' => 'unknown error'],
],
],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '创建空间分析任务',
'summary' => '调用CreateStorageAnalysisTask接口,创建空间分析任务,获取数据库及表的空间使用数据。',
'description' => '- 本接口仅适用于RDS MySQL、PolarDB MySQL版和MongoDB实例。'."\n"
.'- 对于RDS MySQL和PolarDB MySQL版实例,本接口对应于旧版空间分析功能,该接口生成的任务无法在DAS控制台新版空间分析页面查看。如有需要查看任务及结果,请调用接口获取数据后自行保存。'."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'CreateStorageAnalysisTask'],
],
],
'ramActions' => [
[
'operationType' => 'none',
'ramAction' => [
'action' => 'hdm:CreateStorageAnalysisTask',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": {\\n \\"TaskId\\": \\"910f83f4b96df0524ddc5749f61539f8\\",\\n \\"CreateTaskSuccess\\": false,\\n \\"ErrorMessage\\": \\"unknown error\\"\\n },\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": true\\n}","type":"json"}]',
],
'DeleteCloudBenchTask' => [
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => ['operationType' => 'delete'],
'parameters' => [
[
'name' => 'TaskId',
'in' => 'query',
'schema' => ['description' => '任务ID,您可通过[DescribeCloudBenchTasks](~~230670~~)接口获取。', 'type' => 'string', 'required' => true, 'example' => 'e5cec704-0518-430f-8263-76f4dcds****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '删除压测任务',
'summary' => '调用DeleteCloudBenchTask接口,删除压测任务。',
'description' => '数据库自治服务DAS提供智能压测功能,帮助您验证您的实例规格是否需要扩容,有效应对业务流量高峰。更多信息,请参见[智能压测](~~155068~~)。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteCloudBenchTask'],
],
],
'ramActions' => [
[
'operationType' => 'delete',
'ramAction' => [
'action' => 'hdm:DeleteCloudBenchTask',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": \\"None\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n Successful\\n 200\\n true\\n","errorExample":""}]',
],
'DeleteSecurityIPGroup' => [
'summary' => '删除用户跨产品白名单模板',
'path' => '',
'methods' => ['post', 'get'],
'schemes' => ['https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '247410',
'abilityTreeNodes' => ['FEATUREhdmQULC0I'],
'tenantRelevance' => 'tenant',
],
'parameters' => [
[
'name' => 'RegionName',
'in' => 'query',
'allowEmptyValue' => false,
'schema' => ['description' => '地域 ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-shanghai'],
],
[
'name' => 'GlobalSecurityGroupId',
'in' => 'query',
'schema' => ['description' => 'IP白名单模板ID。', 'type' => 'string', 'required' => true, 'example' => 'g-rcge12hbfooad3m****'],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'Code' => ['description' => '状态码。', 'type' => 'string', 'example' => '200'],
'Data' => [
'title' => 'ListResult',
'description' => 'ListResult',
'type' => 'object',
'properties' => [
'GlobalSecurityIPGroup' => [
'description' => '跨产品白名单模板信息。',
'type' => 'array',
'items' => [
'description' => '跨产品白名单模板信息。',
'type' => 'object',
'properties' => [
'GlobalSecurityGroupId' => ['description' => 'IP白名单模板ID。', 'type' => 'string', 'example' => 'g-1no2rzybnqcv0m****'."\n"],
],
],
],
],
],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'description' => '- 本接口用于删除[CreateCloudBenchTasks](~~230665~~)接口创建的智能压测任务中已释放的DBgateway元数据。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
."\n"
.'> 当DBGateway与接入点超过20秒无心跳时,此DBGateway为停止状态。',
'title' => '跨产品白名单模板删除接口',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [],
],
'ramActions' => [
[
'operationType' => 'delete',
'ramAction' => [
'action' => 'hdm:DeleteSecurityIPGroup',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Data\\": {\\n \\"GlobalSecurityIPGroup\\": [\\n {\\n \\"GlobalSecurityGroupId\\": \\"g-1no2rzybnqcv0m****\\\\n\\"\\n }\\n ]\\n },\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\"\\n}","type":"json"}]',
],
'DeleteStopGateway' => [
'summary' => '调用DeleteStopGateway接口,删除已停止的DBGateway元数据。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'systemTags' => ['operationType' => 'delete'],
'parameters' => [
[
'name' => 'GatewayId',
'in' => 'query',
'schema' => ['description' => 'DBGateway的ID,是DBGateway的唯一标识。可通过[DescribeCloudbenchTask](~~230669~~)接口获取,返回的**ClientGatewayId**字段值即为DBGateway的ID。', 'type' => 'string', 'required' => true, 'example' => '22938c83fcfbced4b4869b9695e3****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => ['description' => 'DBGateway元数据删除结果:'."\n"
."\n"
.'- **0**:执行成功。'."\n"
.'- **-1**:系统错误。'."\n"
.'- **-2**:DBGateway不存在。'."\n"
.'- **-3**:DBGateway未停止,无法删除元数据。'."\n"
.'- **-4**:删除元数据信息失败。'."\n", 'type' => 'string', 'example' => '0'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'FC6C0929-29E1-59FD-8DFE-70D9D41E****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '删除已停止的DBGateway元数据',
'description' => '- 本接口用于删除[CreateCloudBenchTasks](~~230665~~)接口创建的智能压测任务中已释放的DBgateway元数据。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
."\n"
.'> 当DBGateway与接入点超过20秒无心跳时,此DBGateway为停止状态。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteStopGateway'],
],
],
'ramActions' => [
[
'operationType' => 'delete',
'ramAction' => [
'action' => 'hdm:DeleteStopGateway',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": \\"0\\",\\n \\"RequestId\\": \\"FC6C0929-29E1-59FD-8DFE-70D9D41E****\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n 0\\n FC6C0929-29E1-59FD-8DFE-70D9D41E****\\n true\\n","errorExample":""}]',
],
'DescribeAuditLogs' => [
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '212859',
'abilityTreeNodes' => ['FEATUREhdmQULC0I'],
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Lang',
'in' => 'query',
'schema' => ['description' => '请求和接收消息的语言类型,默认为zh_cn。取值:'."\n"
."\n"
.'- zh_cn:中文。'."\n"
.'- en_us:英文。', 'type' => 'string', 'required' => false, 'example' => 'zh-CN'],
],
[
'name' => 'UserName',
'in' => 'query',
'schema' => ['description' => '用户名', 'type' => 'string', 'required' => false, 'example' => 'admin'],
],
[
'name' => 'ClientIp',
'in' => 'query',
'schema' => ['description' => '请求客户端 IP。', 'type' => 'string', 'required' => false, 'example' => '11.26.118.7'],
],
[
'name' => 'ClientUa',
'in' => 'query',
'schema' => ['description' => '客户端类型。', 'type' => 'string', 'required' => false, 'example' => 'mysql'],
],
[
'name' => 'InstanceName',
'in' => 'query',
'schema' => ['description' => '资产实例名称', 'type' => 'string', 'required' => false, 'example' => 'rm-t4ni1cezz5y3xxxx'],
],
[
'name' => 'DatabaseName',
'in' => 'query',
'schema' => ['description' => '数据库的名称。', 'type' => 'string', 'required' => false, 'example' => 'TestDB'],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => ['description' => '告警日志起始时间,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1608888296000'],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => ['description' => '告警日志结束时间,以毫秒为单位的 unix 时间戳。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '15682887991222'],
],
[
'name' => 'ProductCode',
'in' => 'query',
'schema' => ['description' => '数据资产所属的产品名称。取值:**RDS、PolarDB、PolarDB-X 2.0**等。', 'type' => 'string', 'required' => false, 'example' => 'RDS'],
],
[
'name' => 'ProductId',
'in' => 'query',
'schema' => ['description' => '数据对象所属的产品名称对应的 ID。取值:'."\n"
."\n"
.'- 3:ADB-MYSQL'."\n"
.'- 5:RDS'."\n"
.'- 7:PolarDB-X'."\n"
.'- 8:PolarDB'."\n"
.'- 9:ADB-PG'."\n"
.'- 11:MongoDB'."\n"
.'- 25:Redis', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '5'],
],
[
'name' => 'SqlText',
'in' => 'query',
'schema' => ['description' => 'SQL 语句内容。', 'type' => 'string', 'required' => false, 'example' => 'SELECT * FROM test where name = \'das\''],
],
[
'name' => 'ExecuteTimeRange',
'in' => 'query',
'schema' => ['description' => '执行时间的范围。', 'type' => 'string', 'required' => false, 'example' => 'in[1000 2000]'],
],
[
'name' => 'EffectRowRange',
'in' => 'query',
'schema' => ['description' => '影响行数范围。', 'type' => 'string', 'required' => false, 'example' => 'in[1 33]'],
],
[
'name' => 'RuleID',
'in' => 'query',
'schema' => ['description' => '审计规则id。', 'type' => 'string', 'required' => false, 'example' => '9953411'],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => ['description' => '审计规则名称。', 'type' => 'string', 'required' => false, 'example' => 'test_rule'],
],
[
'name' => 'OperateType',
'in' => 'query',
'schema' => ['description' => '操作类型。', 'type' => 'string', 'required' => false, 'example' => 'Insert'],
],
[
'name' => 'OssObjectKey',
'in' => 'query',
'schema' => ['description' => 'OSS存储对象的key值。', 'type' => 'string', 'required' => false, 'example' => 'N.A'],
],
[
'name' => 'AsyncRequestId',
'in' => 'query',
'schema' => ['description' => '请求id。', 'type' => 'string', 'required' => false, 'example' => '2c548e83-1473-4fda-b3dc-5a189074ead5'],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => ['description' => '每页最大记录数,默认值为10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30'],
],
[
'name' => 'CurrentPage',
'in' => 'query',
'schema' => ['description' => '当前页数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '3'],
],
[
'name' => 'RuleCategory',
'in' => 'query',
'schema' => ['description' => '规则类型。', 'type' => 'string', 'required' => false, 'example' => '10'],
],
[
'name' => 'LoadWhiteList',
'in' => 'query',
'schema' => ['description' => '是否加载白名单状态。', 'type' => 'boolean', 'required' => false, 'example' => 'false'],
],
[
'name' => 'IpType',
'in' => 'query',
'schema' => ['description' => '网络类型。枚举类型,取值:'."\n"
."\n"
.'- **default**(默认值):非阿里云服务'."\n"
."\n"
.'- **aliyun**: 阿里云服务', 'type' => 'string', 'required' => false, 'example' => 'aliyun'],
],
[
'name' => 'LogSource',
'in' => 'query',
'schema' => ['description' => '数据来源', 'type' => 'string', 'required' => false, 'example' => 'SLOW_SQL'],
],
[
'name' => 'RuleAggQuery',
'in' => 'query',
'schema' => ['description' => '是否聚合查询', 'type' => 'boolean', 'required' => false, 'example' => 'true'],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => ['description' => '规则ID', 'type' => 'string', 'required' => false, 'example' => '867028'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'AsyncRequestId' => ['description' => '请求id。', 'type' => 'string', 'example' => '3926fba5-1774-44f4-af2d-ac7b33e86c3b'],
'CurrentPage' => ['description' => '当前页数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'],
'PageSize' => ['description' => '分页查询,每页大小。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A7021857-AFD9-5AD6-979D-AA7DFC5AFADF'],
'TotalCount' => ['description' => '总的记录数(仅 Redis 引擎有效)', 'type' => 'integer', 'format' => 'int32', 'example' => '12'],
'Items' => [
'description' => 'SQL日志记录中的客户端IP'."\n"
.'SQL日志记录中客户端的IP地址',
'type' => 'array',
'items' => [
'description' => '物理异步读。',
'type' => 'object',
'properties' => [
'CreationTime' => ['description' => '告警时间,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1536751124000'],
'WarnLevel' => ['description' => '危险等级。'."\n"
.'- **1**:低危。'."\n"
.'- **2**:中危。'."\n"
.'- **3**:高危。', 'type' => 'string', 'example' => '1'],
'ClientPort' => ['description' => '查询中客户端端口号', 'type' => 'string', 'example' => '53815'],
'TableName' => ['description' => '查询中使用的表名', 'type' => 'string', 'example' => 'it_table'],
'EffectRow' => ['description' => '影响行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'PackageName' => ['description' => 'MaxCompute包名称。', 'type' => 'string', 'example' => 'test01'],
'UserId' => ['description' => '用户 UID。', 'type' => 'string', 'example' => '19********94'],
'Message' => ['description' => '原始日志内容。', 'type' => 'string', 'example' => 'success'],
'RuleId' => ['description' => '审计规则 id。', 'type' => 'string', 'example' => '9953411'],
'OperateType' => ['description' => '操作类型。', 'type' => 'string', 'example' => 'Drop'],
'LogTime' => ['description' => '日志执行时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '1751870592000'],
'WarnLevelName' => ['description' => '危险等级名称。'."\n"
.'- 低危。'."\n"
.'- 中危。'."\n"
.'- 高危。', 'type' => 'string', 'example' => '1'],
'InstanceName' => ['description' => '实例别名。', 'type' => 'string', 'example' => 'test-instance-003'],
'DatabaseName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'chngc_b2b_migration_sh'],
'OssObjectKey' => ['description' => 'OSS存储对象的key值。', 'type' => 'string', 'example' => 'N.A'],
'ExecuteStatus' => ['description' => '执行状态:0:未成功 1:执行成功', 'type' => 'integer', 'format' => 'int32', 'example' => '1'],
'ProductId' => ['description' => '数据对象所属的产品名称对应的 ID。取值:'."\n"
."\n"
.'- 3:ADB-MYSQL'."\n"
.'- 5:RDS'."\n"
.'- 7:PolarDB-X'."\n"
.'- 8:PolarDB'."\n"
.'- 9:ADB-PG'."\n"
.'- 11:MongoDB'."\n"
.'- 25:Redis', 'type' => 'integer', 'format' => 'int64', 'example' => '5'],
'ExecuteTime' => ['description' => '执行时长,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1751870592000'],
'UserName' => ['description' => '用户名', 'type' => 'string', 'example' => 'admin'],
'InstanceDescription' => ['description' => '数据资产实例的描述信息。', 'type' => 'string', 'example' => 'instance dscription'],
'RuleName' => ['description' => '审计规则名称。', 'type' => 'string', 'example' => 'name'],
'ColumnName' => ['description' => '列名。', 'type' => 'string', 'example' => 'ds'],
'ClientIp' => ['description' => '查询中的客户端IP地址', 'type' => 'string', 'example' => '100.104.16.251'],
'ClientUa' => ['description' => '客户端类型。', 'type' => 'string', 'example' => 'mysql'],
'Id' => ['description' => '主键ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'ProductCode' => ['description' => '数据资产所属的产品名称。取值:RDS、PolarDB、PolarDB-X 2.0等。', 'type' => 'string', 'example' => 'RDS'],
'SqlText' => ['description' => 'SQL语句。', 'type' => 'string', 'example' => 'select * from test03'],
'InWhiteList' => ['description' => '告警是否在加白列表。', 'type' => 'boolean', 'example' => 'True'],
'IpType' => ['description' => '网络类型。枚举类型,取值:'."\n"
."\n"
.'**default**(默认值):非阿里云服务'."\n"
."\n"
.'**aliyun**: 阿里云服务', 'type' => 'string', 'example' => 'aliyun'],
'RuleCategory' => ['description' => '规则类型。', 'type' => 'string', 'example' => '10'],
'LogSource' => ['description' => '数据来源', 'type' => 'string', 'example' => 'SLOW_SQL'],
'InstanceAuditStatus' => ['description' => '实例审计状态', 'type' => 'string', 'example' => '2'],
],
],
],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '查询审计告警日志',
'summary' => '本接口一般用于数据审计告警日志列表查询,便于告警搜索和告警处理。',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [],
],
'ramActions' => [],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"AsyncRequestId\\": \\"3926fba5-1774-44f4-af2d-ac7b33e86c3b\\",\\n \\"CurrentPage\\": 1,\\n \\"PageSize\\": 10,\\n \\"RequestId\\": \\"A7021857-AFD9-5AD6-979D-AA7DFC5AFADF\\",\\n \\"TotalCount\\": 12,\\n \\"Items\\": [\\n {\\n \\"CreationTime\\": 1536751124000,\\n \\"WarnLevel\\": \\"1\\",\\n \\"ClientPort\\": \\"53815\\",\\n \\"TableName\\": \\"it_table\\",\\n \\"EffectRow\\": 10,\\n \\"PackageName\\": \\"test01\\",\\n \\"UserId\\": \\"19********94\\",\\n \\"Message\\": \\"success\\",\\n \\"RuleId\\": \\"9953411\\",\\n \\"OperateType\\": \\"Drop\\",\\n \\"LogTime\\": 1751870592000,\\n \\"WarnLevelName\\": \\"1\\",\\n \\"InstanceName\\": \\"test-instance-003\\",\\n \\"DatabaseName\\": \\"chngc_b2b_migration_sh\\",\\n \\"OssObjectKey\\": \\"N.A\\",\\n \\"ExecuteStatus\\": 1,\\n \\"ProductId\\": 5,\\n \\"ExecuteTime\\": 1751870592000,\\n \\"UserName\\": \\"admin\\",\\n \\"InstanceDescription\\": \\"instance dscription\\",\\n \\"RuleName\\": \\"name\\",\\n \\"ColumnName\\": \\"ds\\",\\n \\"ClientIp\\": \\"100.104.16.251\\",\\n \\"ClientUa\\": \\"mysql\\",\\n \\"Id\\": 1,\\n \\"ProductCode\\": \\"RDS\\",\\n \\"SqlText\\": \\"select * from test03\\",\\n \\"InWhiteList\\": true,\\n \\"IpType\\": \\"aliyun\\",\\n \\"RuleCategory\\": \\"10\\",\\n \\"LogSource\\": \\"SLOW_SQL\\",\\n \\"InstanceAuditStatus\\": \\"2\\"\\n }\\n ]\\n}","type":"json"}]',
],
'DescribeAutoScalingConfig' => [
'summary' => '调用DescribeAutoScalingConfig接口,查询实例弹性伸缩功能配置信息。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => ['operationType' => 'get'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'pc-2ze1prap1k46r****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'description' => '实例弹性伸缩功能配置信息。',
'type' => 'object',
'properties' => [
'Spec' => [
'description' => '规格弹性伸缩功能配置信息。',
'type' => 'object',
'properties' => [
'Upgrade' => ['description' => '规格自动扩容是否开启:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'CpuUsageUpperThreshold' => ['description' => '触发规格自动扩容的CPU平均利用率阈值,单位为%。', 'type' => 'integer', 'format' => 'int32', 'example' => '70'],
'MemUsageUpperThreshold' => ['description' => '触发规格自动扩容的内存平均利用率阈值,单位为%。', 'type' => 'integer', 'format' => 'int32', 'example' => '70'],
'MaxSpec' => ['description' => '自动扩容的规格上限。详情请参见各数据库实例的产品规格文档:'."\n"
.''."\n"
."\n"
.'- PolarDB MySQL版的集群版请参见[计算节点规格](~~102542~~)。'."\n"
.'- RDS MySQL高可用系列云盘版请参见[产品规格](~~276974~~)。'."\n"
.'- Redis社区云盘版请参见[实例规格](~~144986~~)。'."\n"
."\n"
.''."\n"
."\n"
.''."\n"
."\n"
.'- PolarDB MySQL版的集群版请参见[计算节点规格](~~102542~~)。'."\n"
.'- RDS MySQL高可用系列云盘版请参见[产品规格](~~276974~~)。'."\n"
."\n"
.'', 'type' => 'string', 'example' => 'polar.mysql.x8.12xlarge'],
'MaxReadOnlyNodes' => ['description' => '实例只读节点数的最大值。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'],
'ObservationWindowSize' => ['description' => '观测窗口。 返回值由数值和时间单位后缀组成,其中时间单位后缀含义如下:'."\n"
."\n"
.'- **s**:表示秒。'."\n"
.'- **m**:表示分钟。'."\n"
.'- **h**:表示小时。'."\n"
.'- **d**:表示天。 '."\n"
."\n"
.'> 例如,返回**5m**表示5分钟。', 'type' => 'string', 'example' => '5m'],
'CoolDownTime' => ['description' => '静默期。返回值由数值和时间单位后缀组成,其中时间单位后缀含义如下:'."\n"
."\n"
.'- **s**:表示秒。'."\n"
.'- **m**:表示分钟。'."\n"
.'- **h**:表示小时。'."\n"
.'- **d**:表示天。 '."\n"
."\n"
.'> 例如,返回**5m**表示5分钟。', 'type' => 'string', 'example' => '5m'],
'Downgrade' => ['description' => '规格自动回缩是否开启:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
],
],
'Storage' => [
'description' => '实例存储自动扩容功能配置信息。',
'type' => 'object',
'properties' => [
'Upgrade' => ['description' => '存储自动扩容是否开启:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'DiskUsageUpperThreshold' => ['description' => '触发存储自动扩容的存储空间平均利用率阈值,单位为%。', 'type' => 'integer', 'format' => 'int32', 'example' => '70'],
'MaxStorage' => ['description' => '存储空间上限,单位为GB。', 'type' => 'integer', 'format' => 'int32', 'example' => '32000'],
],
],
'Resource' => [
'description' => '实例本地资源弹性伸缩功能配置信息。',
'type' => 'object',
'properties' => [
'Enable' => ['description' => '本地资源弹性伸缩是否开启:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'CpuUsageUpperThreshold' => ['description' => '触发本地资源自动扩容的CPU平均利用率阈值,单位为%。', 'type' => 'integer', 'format' => 'int32', 'example' => '70'],
'CpuStep' => ['description' => 'CPU扩容步长。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'],
'UpgradeObservationWindowSize' => ['description' => '扩容观测窗口。返回值由数值和时间单位后缀组成,其中时间单位后缀含义如下:'."\n"
."\n"
.'- **s**:表示秒。'."\n"
.'- **m**:表示分钟。'."\n"
.'- **h**:表示小时。'."\n"
.'- **d**:表示天。 '."\n"
."\n"
.'> 例如,返回**5m**表示5分钟。', 'type' => 'string', 'example' => '5m'],
'DowngradeObservationWindowSize' => ['description' => '缩容观测窗口。返回值由数值和时间单位后缀组成,其中时间单位后缀含义如下:'."\n"
."\n"
.'- **s**:表示秒。'."\n"
.'- **m**:表示分钟。'."\n"
.'- **h**:表示小时。'."\n"
.'- **d**:表示天。 '."\n"
."\n"
.'> 例如,返回**5m**表示5分钟。', 'type' => 'string', 'example' => '5m'],
],
],
'Shard' => [
'description' => '实例分片弹性伸缩功能配置信息。',
'type' => 'object',
'properties' => [
'Upgrade' => ['description' => '自动增加分片是否开启:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。'."\n", 'type' => 'boolean', 'example' => 'true'],
'MemUsageUpperThreshold' => ['description' => '触发自动增加分片的内存平均利用率阈值,单位为%。', 'type' => 'integer', 'format' => 'int32', 'example' => '70'],
'MaxShards' => ['description' => '实例总分片数的最大值。', 'type' => 'integer', 'format' => 'int32', 'example' => '16'],
'UpgradeObservationWindowSize' => ['description' => '自动增加分片观测窗口。返回值由数值和时间单位后缀组成,其中时间单位后缀含义如下:'."\n"
."\n"
.'- **s**:表示秒。'."\n"
.'- **m**:表示分钟。'."\n"
.'- **h**:表示小时。'."\n"
.'- **d**:表示天。 '."\n"
."\n"
.'> 例如,返回**5m**表示5分钟。', 'type' => 'string', 'example' => '5m'],
'Downgrade' => ['description' => '自动减少分片是否开启:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。'."\n", 'type' => 'boolean', 'example' => 'true'],
'MemUsageLowerThreshold' => ['description' => '触发自动减少分片的内存平均利用率阈值,单位为%。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'],
'MinShards' => ['description' => '实例总分片数的最小值。', 'type' => 'integer', 'format' => 'int32', 'example' => '4'],
'DowngradeObservationWindowSize' => ['description' => '自动减少分片观测窗口。返回值由数值和时间单位后缀组成,其中时间单位后缀含义如下:'."\n"
.'- **s**:表示秒。'."\n"
.'- **m**:表示分钟。'."\n"
.'- **h**:表示小时。'."\n"
.'- **d**:表示天。 '."\n"
."\n"
.'> 例如,返回**1d**表示1天。', 'type' => 'string', 'example' => '1d'],
],
],
'Bandwidth' => [
'description' => '实例带宽弹性伸缩功能配置信息。',
'type' => 'object',
'properties' => [
'Upgrade' => ['description' => '带宽自动扩展是否开启:'."\n"
.'- **true**:是。'."\n"
.'- **false**:否。'."\n", 'type' => 'boolean', 'example' => 'true'],
'BandwidthUsageUpperThreshold' => ['description' => '触发带宽自动扩展的带宽平均使用率阈值,单位为%。', 'type' => 'integer', 'format' => 'int32', 'example' => '70'],
'ObservationWindowSize' => ['description' => '带宽自动扩展的观测窗口。返回值由数值和时间单位后缀组成,其中时间单位后缀含义如下:'."\n"
."\n"
.'- **s**:表示秒。'."\n"
.'- **m**:表示分钟。'."\n"
.'- **h**:表示小时。'."\n"
.'- **d**:表示天。 '."\n"
."\n"
.'> 例如,返回**5m**表示5分钟。', 'type' => 'string', 'example' => '5m'],
'Downgrade' => ['description' => '带宽自动回缩是否开启:'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'BandwidthUsageLowerThreshold' => ['description' => '触发带宽自动回缩的带宽平均使用率阈值,单位为%。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => ''],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => ''],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"Spec\\": {\\n \\"Upgrade\\": true,\\n \\"CpuUsageUpperThreshold\\": 70,\\n \\"MemUsageUpperThreshold\\": 70,\\n \\"MaxSpec\\": \\"polar.mysql.x8.12xlarge\\",\\n \\"MaxReadOnlyNodes\\": 10,\\n \\"ObservationWindowSize\\": \\"5m\\",\\n \\"CoolDownTime\\": \\"5m\\",\\n \\"Downgrade\\": true\\n },\\n \\"Storage\\": {\\n \\"Upgrade\\": true,\\n \\"DiskUsageUpperThreshold\\": 70,\\n \\"MaxStorage\\": 32000\\n },\\n \\"Resource\\": {\\n \\"Enable\\": true,\\n \\"CpuUsageUpperThreshold\\": 70,\\n \\"CpuStep\\": 2,\\n \\"UpgradeObservationWindowSize\\": \\"5m\\",\\n \\"DowngradeObservationWindowSize\\": \\"5m\\"\\n },\\n \\"Shard\\": {\\n \\"Upgrade\\": true,\\n \\"MemUsageUpperThreshold\\": 70,\\n \\"MaxShards\\": 16,\\n \\"UpgradeObservationWindowSize\\": \\"5m\\",\\n \\"Downgrade\\": true,\\n \\"MemUsageLowerThreshold\\": 30,\\n \\"MinShards\\": 4,\\n \\"DowngradeObservationWindowSize\\": \\"1d\\"\\n },\\n \\"Bandwidth\\": {\\n \\"Upgrade\\": true,\\n \\"BandwidthUsageUpperThreshold\\": 70,\\n \\"ObservationWindowSize\\": \\"5m\\",\\n \\"Downgrade\\": true,\\n \\"BandwidthUsageLowerThreshold\\": 30\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n \\n \\n true\\n 70\\n 70\\n polar.mysql.x8.12xlarge\\n 10\\n 5m\\n 5m\\n true\\n \\n \\n","errorExample":""}]',
'title' => '查询实例弹性伸缩功能配置信息',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeAutoScalingConfig',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'DescribeAutoScalingHistory' => [
'methods' => ['get'],
'schemes' => ['https', 'http'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。'."\n"
."\n"
.'> 当前仅支持RDS MySQL实例。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
[
'name' => 'AutoScalingTaskType',
'in' => 'query',
'schema' => ['description' => '查询的弹性伸缩业务种类。当前仅支持**SPEC**,表示仅支持查询自动性能扩展历史信息。', 'type' => 'string', 'required' => true, 'example' => 'SPEC'],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => ['description' => '查询任务的开始时间,格式为Unix时间戳,单位为毫秒。'."\n"
."\n"
.'>查询任务的开始时间最大不能早于当前时间45天。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1675833788056'],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => ['description' => '查询任务结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
.'>查询任务结束时间需晚于查询任务开始时间。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1676605305796'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '状态码。200表示成功。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'title' => 'AutoScalingInstanceHistory',
'description' => '弹性伸缩历史记录。',
'type' => 'object',
'properties' => [
'InstanceId' => ['description' => '实例ID。', 'type' => 'string', 'example' => 'rm-2ze1jdv45i7l6****'],
'SpecHistory' => [
'description' => '自动性能扩展历史记录。',
'type' => 'array',
'items' => [
'description' => '自动性能扩展历史信息。',
'type' => 'object',
'properties' => [
'ScaleType' => ['description' => '自动性能扩展任务类型,取值:'."\n"
.'- **SCALE_UP**:规格自动扩容。'."\n"
.'- **SCALE_DOWN**:规格自动缩容。', 'type' => 'string', 'example' => 'SCALE_UP'],
'TaskExcuteStatus' => ['description' => '任务执行状态:'."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'true'],
'ErrorCode' => ['description' => '扩缩容内部任务返回的错误码:'."\n"
."\n"
.'- **Insufficient_Balance** :用户余额不足或存在未支付订单。'."\n"
.'- **REACH_SPEC_UPPERBOUND** :已达到用户规格上限。'."\n"
.'- **Control_Error_Timeout_Msg** :管控任务超时。'."\n"
.'- **Invoke_Rds_Api_Error_Msg** :调用RDS API失败。', 'type' => 'string', 'example' => 'Insufficient_Balance'],
'OriginInstanceClass' => ['description' => '原始实例规格码。', 'type' => 'string', 'example' => 'mysql.n2.large.2c'],
'TargetInstanceClass' => ['description' => '目标实例规格码。', 'type' => 'string', 'example' => 'mysql.n2.xlarge.2c'],
'OriginCore' => ['description' => '原始实例CPU核数。', 'type' => 'integer', 'format' => 'int32', 'example' => '4'],
'OriginMemory' => ['description' => '原始实例内存大小,单位GB。', 'type' => 'number', 'format' => 'double', 'example' => '8'],
'TargetCore' => ['description' => '目标实例CPU核数。', 'type' => 'integer', 'format' => 'int32', 'example' => '8'],
'TargetMemory' => ['description' => '目标实例内存大小,单位GB。', 'type' => 'number', 'format' => 'double', 'example' => '16'],
'TaskTime' => ['description' => '任务执行时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1684830763000'],
],
],
],
'Storage' => [
'description' => '存储扩容历史记录,暂不支持。',
'type' => 'array',
'items' => ['description' => '实例存储扩容历史信息。', 'type' => 'object', 'example' => 'None'],
],
'Resource' => [
'description' => 'Redis资源扩容历史记录,暂不支持。',
'type' => 'array',
'items' => ['description' => 'Redis资源扩容历史信息。', 'type' => 'object', 'example' => 'None'],
],
'Shard' => [
'description' => 'Redis自动分片扩容历史记录,暂不支持。',
'type' => 'array',
'items' => ['description' => 'Redis自动分片扩容历史信息。', 'type' => 'object', 'example' => 'None'],
],
'Bandwidth' => [
'description' => 'Redis带宽弹性伸缩历史记录,暂不支持。',
'type' => 'array',
'items' => ['description' => 'Redis带宽弹性伸缩历史信息。', 'type' => 'object', 'example' => 'None'],
],
],
],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '查询实例弹性伸缩历史信息',
'summary' => '调用DescribeAutoScalingHistory接口,查询实例弹性伸缩历史信息。',
'description' => '- 当前仅支持查询RDS MySQL高可用系列云盘版的自动性能扩展历史信息。'."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'requestParamsDescription' => 'AutoScalingTaskType取值为SPEC时,表示查询自动性能扩展历史,当前仅支持取值为SPEC。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeAutoScalingHistory'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeAutoScalingHistory',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"InstanceId\\": \\"rm-2ze1jdv45i7l6****\\",\\n \\"SpecHistory\\": [\\n {\\n \\"ScaleType\\": \\"SCALE_UP\\",\\n \\"TaskExcuteStatus\\": true,\\n \\"ErrorCode\\": \\"Insufficient_Balance\\",\\n \\"OriginInstanceClass\\": \\"mysql.n2.large.2c\\",\\n \\"TargetInstanceClass\\": \\"mysql.n2.xlarge.2c\\",\\n \\"OriginCore\\": 4,\\n \\"OriginMemory\\": 8,\\n \\"TargetCore\\": 8,\\n \\"TargetMemory\\": 16,\\n \\"TaskTime\\": 1684830763000\\n }\\n ],\\n \\"Storage\\": [\\n {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n ],\\n \\"Resource\\": [\\n {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n ],\\n \\"Shard\\": [\\n {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n ],\\n \\"Bandwidth\\": [\\n {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n ]\\n }\\n}","type":"json"}]',
],
'DescribeCacheAnalysisJob' => [
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'abilityTreeCode' => '23813',
'abilityTreeNodes' => ['FEATUREhdmJC65CS'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'r-bp18ff4a195d****'],
],
[
'name' => 'JobId',
'in' => 'query',
'schema' => ['description' => '缓存分析任务ID,您可通过调用[CreateCacheAnalysisJob](~~180982~~)接口获取返回参数的JobId。', 'type' => 'string', 'required' => true, 'example' => 'sf79-sd99-sa37-****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Data' => [
'description' => '详细信息列表。',
'type' => 'object',
'properties' => [
'TaskState' => ['description' => '缓存分析任务的状态:'."\n"
."\n"
.'- **BACKUP**:备份中。'."\n"
.'- **ANALYZING**:分析中。'."\n"
.'- **FINISHED**:分析完成。'."\n"
.'- **FAILED**:出现错误。', 'type' => 'string', 'example' => 'BACKUP'],
'JobId' => ['description' => '缓存分析任务ID。', 'type' => 'string', 'example' => 'sf79-sd99-sa37-****'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'BigKeys' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'KeyInfo' => [
'description' => '大Key详细信息,根据Key占用字节数降序排列。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Type' => ['description' => 'Redis数据结构类型。', 'type' => 'string', 'example' => 'hash'],
'Db' => ['description' => '数据库名称。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'ExpirationTimeMillis' => ['description' => 'Key过期时间,格式为 Unix 时间戳,单位为毫秒(ms),0表示不过期。', 'type' => 'integer', 'format' => 'int64', 'example' => '1596256542547'],
'Key' => ['description' => 'Key的名称。', 'type' => 'string', 'example' => 'task_x****'],
'Encoding' => ['description' => 'Key内部数据类型。', 'type' => 'string', 'example' => 'hashtable'],
'Bytes' => ['description' => 'Key占用字节数。', 'type' => 'integer', 'format' => 'int64', 'example' => '12345'],
'NodeId' => ['description' => '实例的数据节点ID。', 'type' => 'string', 'example' => 'r-x****-db-0'],
'Count' => ['description' => 'Key的元素个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '127'],
],
'description' => '',
],
],
],
'description' => '',
],
'KeyPrefixes' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Prefix' => [
'description' => 'Key前缀列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'KeyNum' => ['description' => '该前缀Key的数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '123'],
'Type' => ['description' => 'Redis数据结构类型。', 'type' => 'string', 'example' => 'hash'],
'Bytes' => ['description' => 'Key占用字节数。', 'type' => 'integer', 'format' => 'int64', 'example' => '12345'],
'Prefix' => ['description' => 'Key的前缀。', 'type' => 'string', 'example' => 'task_'],
'Count' => ['description' => 'Key的元素个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '127'],
],
'description' => '',
],
],
],
'description' => '',
],
'BigKeysOfNum' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'KeyInfo' => [
'description' => '大Key详细信息,根据Key数量降序排列。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Type' => ['description' => 'Redis数据结构类型。', 'type' => 'string', 'example' => 'hash'],
'Db' => ['description' => '数据库名称。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'ExpirationTimeMillis' => ['description' => 'Key过期时间,格式为 Unix 时间戳,单位为毫秒(ms),0表示不过期。', 'type' => 'integer', 'format' => 'int64', 'example' => '1596256542547'],
'Key' => ['description' => 'Key的名称。', 'type' => 'string', 'example' => 'task_x****'],
'Encoding' => ['description' => 'Key内部数据类型。', 'type' => 'string', 'example' => 'hashtable'],
'Bytes' => ['description' => 'Key占用字节数。', 'type' => 'integer', 'format' => 'int64', 'example' => '12345'],
'NodeId' => ['description' => '实例的数据节点ID。', 'type' => 'string', 'example' => 'r-x****-db-0'],
'Count' => ['description' => 'Key的元素个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '127'],
],
'description' => '',
],
],
],
'description' => '',
],
'UnexBigKeysOfBytes' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'KeyInfo' => [
'description' => '永不过期Key的详细信息,根据Key占用字节数降序排列。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Type' => ['description' => 'Redis数据结构类型。', 'type' => 'string', 'example' => 'hash'],
'Db' => ['description' => '数据库名称。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'ExpirationTimeMillis' => ['description' => 'Key过期时间,格式为 Unix 时间戳,单位为毫秒(ms),0表示不过期。', 'type' => 'integer', 'format' => 'int64', 'example' => '1596256542547'],
'Key' => ['description' => 'Key的名称。', 'type' => 'string', 'example' => 'task_x****'],
'Encoding' => ['description' => 'Key内部数据类型。', 'type' => 'string', 'example' => 'hashtable'],
'Bytes' => ['description' => 'Key占用字节数。', 'type' => 'integer', 'format' => 'int64', 'example' => '12345'],
'NodeId' => ['description' => '实例的数据节点ID', 'type' => 'string', 'example' => 'r-x****-db-0'],
'Count' => ['description' => 'Key的元素个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '127'],
],
'description' => '',
],
],
],
'description' => '',
],
'UnexBigKeysOfNum' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'KeyInfo' => [
'description' => '永不过期Key的详细信息,根据Key数量降序排列。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Type' => ['description' => 'Redis数据结构类型。', 'type' => 'string', 'example' => 'hash'],
'Db' => ['description' => '数据库名称。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'ExpirationTimeMillis' => ['description' => 'Key过期时间,格式为 Unix 时间戳,单位为毫秒(ms),0表示不过期。', 'type' => 'integer', 'format' => 'int64', 'example' => '1596256542547'],
'Key' => ['description' => 'Key的名称。', 'type' => 'string', 'example' => 'task_x****'],
'Encoding' => ['description' => 'Key内部数据类型。', 'type' => 'string', 'example' => 'hashtable'],
'Bytes' => ['description' => 'Key占用字节数。', 'type' => 'integer', 'format' => 'int64', 'example' => '12345'],
'NodeId' => ['description' => '实例的数据节点ID。', 'type' => 'string', 'example' => 'r-x****-db-0'],
'Count' => ['description' => 'Key的元素个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '127'],
],
'description' => '',
],
],
],
'description' => '',
],
'InstanceId' => ['description' => '实例ID。', 'type' => 'string', 'example' => 'r-bp18ff4a195d****'],
'NodeId' => ['description' => '实例的数据节点ID。', 'type' => 'string', 'example' => 'r-x****-db-0'],
'ExpiryKeysLevelCount' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ExpiryLevel' => [
'description' => '按过期时间分类的Key统计信息。',
'type' => 'array',
'items' => [
'description' => '按过期时间分类的Key统计信息。',
'type' => 'object',
'properties' => [
'AnalysisTs' => ['description' => '分析完成的时间,格式为 Unix 时间戳,单位为毫秒(ms)。', 'type' => 'integer', 'format' => 'int64', 'example' => '1717469347000'],
'Level' => ['description' => '过期时间级别。取值:'."\n"
."\n"
.'- **0**:不过期。'."\n"
.'- **1**:已过期。'."\n"
.'- **2**:过期0~1小时。'."\n"
.'- **3**:过期1~3小时。'."\n"
.'- **4**:过期3~12小时。'."\n"
.'- **5**:过期12~24小时。'."\n"
.'- **6**:过期1~2天。'."\n"
.'- **7**:过期3~7天。'."\n"
.'- **8**:过期超过7天。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'TotalBytes' => ['description' => '按过期时间分类统计的Key占用的字节数。', 'type' => 'integer', 'format' => 'int64', 'example' => '8064'],
'TotalKeys' => ['description' => '按过期时间分类统计的Key总数。', 'type' => 'integer', 'format' => 'int64', 'example' => '62'],
],
],
],
],
'description' => '',
],
],
],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '查询缓存分析任务详情',
'summary' => '调用DescribeCacheAnalysisJob接口,查询缓存分析任务详情。',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 本接口只适用于Redis引擎。'."\n"
."\n"
.'> 调用本接口可查询实例缓存分析任务中排名前500的Key信息。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeCacheAnalysisJob'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeCacheAnalysisJob',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Data\\": {\\n \\"TaskState\\": \\"BACKUP\\",\\n \\"JobId\\": \\"sf79-sd99-sa37-****\\",\\n \\"Message\\": \\"Successful\\",\\n \\"BigKeys\\": {\\n \\"KeyInfo\\": [\\n {\\n \\"Type\\": \\"hash\\",\\n \\"Db\\": 0,\\n \\"ExpirationTimeMillis\\": 1596256542547,\\n \\"Key\\": \\"task_x****\\",\\n \\"Encoding\\": \\"hashtable\\",\\n \\"Bytes\\": 12345,\\n \\"NodeId\\": \\"r-x****-db-0\\",\\n \\"Count\\": 127\\n }\\n ]\\n },\\n \\"KeyPrefixes\\": {\\n \\"Prefix\\": [\\n {\\n \\"KeyNum\\": 123,\\n \\"Type\\": \\"hash\\",\\n \\"Bytes\\": 12345,\\n \\"Prefix\\": \\"task_\\",\\n \\"Count\\": 127\\n }\\n ]\\n },\\n \\"BigKeysOfNum\\": {\\n \\"KeyInfo\\": [\\n {\\n \\"Type\\": \\"hash\\",\\n \\"Db\\": 0,\\n \\"ExpirationTimeMillis\\": 1596256542547,\\n \\"Key\\": \\"task_x****\\",\\n \\"Encoding\\": \\"hashtable\\",\\n \\"Bytes\\": 12345,\\n \\"NodeId\\": \\"r-x****-db-0\\",\\n \\"Count\\": 127\\n }\\n ]\\n },\\n \\"UnexBigKeysOfBytes\\": {\\n \\"KeyInfo\\": [\\n {\\n \\"Type\\": \\"hash\\",\\n \\"Db\\": 0,\\n \\"ExpirationTimeMillis\\": 1596256542547,\\n \\"Key\\": \\"task_x****\\",\\n \\"Encoding\\": \\"hashtable\\",\\n \\"Bytes\\": 12345,\\n \\"NodeId\\": \\"r-x****-db-0\\",\\n \\"Count\\": 127\\n }\\n ]\\n },\\n \\"UnexBigKeysOfNum\\": {\\n \\"KeyInfo\\": [\\n {\\n \\"Type\\": \\"hash\\",\\n \\"Db\\": 0,\\n \\"ExpirationTimeMillis\\": 1596256542547,\\n \\"Key\\": \\"task_x****\\",\\n \\"Encoding\\": \\"hashtable\\",\\n \\"Bytes\\": 12345,\\n \\"NodeId\\": \\"r-x****-db-0\\",\\n \\"Count\\": 127\\n }\\n ]\\n },\\n \\"InstanceId\\": \\"r-bp18ff4a195d****\\",\\n \\"NodeId\\": \\"r-x****-db-0\\",\\n \\"ExpiryKeysLevelCount\\": {\\n \\"ExpiryLevel\\": [\\n {\\n \\"AnalysisTs\\": 1717469347000,\\n \\"Level\\": 0,\\n \\"TotalBytes\\": 8064,\\n \\"TotalKeys\\": 62\\n }\\n ]\\n }\\n },\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n \\n BACKUP\\n sf79-sd99-sa37-****\\n Successful\\n \\n hash\\n 0\\n 1596256542547\\n task_x****\\n hashtable\\n 12345\\n r-x****-db-0\\n 127\\n \\n \\n 123\\n hash\\n 12345\\n task_\\n 127\\n \\n \\n hash\\n 0\\n 1596256542547\\n task_x****\\n hashtable\\n 12345\\n r-x****-db-0\\n 127\\n \\n \\n hash\\n 0\\n 1596256542547\\n task_x****\\n hashtable\\n 12345\\n r-x****-db-0\\n 127\\n \\n \\n hash\\n 0\\n 1596256542547\\n task_x****\\n hashtable\\n 12345\\n r-x****-db-0\\n 127\\n \\n r-bp18ff4a195d****\\n r-x****-db-0\\n \\n 200\\n true\\n","errorExample":""}]',
],
'DescribeCacheAnalysisJobs' => [
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => ['operationType' => 'get'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'r-bp18ff4a195d****'],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => ['description' => '查询任务开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'string', 'required' => true, 'example' => '1596177993000'],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => ['description' => '查询任务结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
.'>查询任务结束时间需晚于查询任务开始时间。', 'type' => 'string', 'required' => true, 'example' => '1596177993001'],
],
[
'name' => 'PageNo',
'in' => 'query',
'schema' => ['description' => '页码,取值大于0且不超过Integer数据类型的最大值,默认值为1。', 'type' => 'string', 'required' => false, 'example' => '1'],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => ['description' => '每页最大记录数,默认值为10。', 'type' => 'string', 'required' => false, 'example' => '10'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Data' => [
'description' => '信息列表。',
'type' => 'object',
'properties' => [
'List' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'CacheAnalysisJob' => [
'description' => '信息详情。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'TaskState' => ['description' => '缓存分析任务的状态:'."\n"
."\n"
.'- **BACKUP**:备份中。'."\n"
.'- **ANALYZING**:分析中。'."\n"
.'- **FINISHED**:分析完成。'."\n"
.'- **FAILED**:出现错误。', 'type' => 'string', 'example' => 'BACKUP'],
'JobId' => ['description' => '缓存分析任务ID。', 'type' => 'string', 'example' => 'sf79-sd99-sa37-****'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'BigKeys' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'KeyInfo' => [
'description' => '大Key详细信息。'."\n"
."\n"
.'>当前已不再返回该参数的子参数及其内容,请调用[DescribeCacheAnalysisJob](~~180983~~)接口查询缓存分析任务的详细信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Type' => ['description' => 'Redis数据结构类型。', 'type' => 'string', 'example' => 'hash'],
'Db' => ['description' => '数据库名称。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'ExpirationTimeMillis' => ['description' => 'Key过期时间,单位:毫秒(ms),0表示不过期。', 'type' => 'integer', 'format' => 'int64', 'example' => '1596256542547'],
'Key' => ['description' => 'Key的名称。', 'type' => 'string', 'example' => 'task_*****'],
'Encoding' => ['description' => 'Key内部数据类型。', 'type' => 'string', 'example' => 'hashtable'],
'Bytes' => ['description' => 'Key占用字节数。', 'type' => 'integer', 'format' => 'int64', 'example' => '12345'],
'NodeId' => ['description' => '实例的数据节点ID。', 'type' => 'string', 'example' => 'r-****-db-0'],
'Count' => ['description' => 'Key的元素个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '127'],
],
'description' => '',
],
],
],
'description' => '',
],
'InstanceId' => ['description' => '实例ID。', 'type' => 'string', 'example' => 'r-bp18ff4a195d****'],
'NodeId' => ['description' => '实例的数据节点ID。', 'type' => 'string', 'example' => 'r-x****-db-0'],
],
'description' => '',
],
],
],
'description' => '',
],
'PageNo' => ['description' => '页码,取值大于0且不超过Integer数据类型的最大值,默认值为1。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'PageSize' => ['description' => '每页最大记录数,默认值为10。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'Extra' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'Total' => ['description' => '结果数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '4'],
],
],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '查询缓存分析任务列表',
'summary' => '调用DescribeCacheAnalysisJobs接口,查询缓存分析任务列表。',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 本接口只适用于Redis引擎。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeCacheAnalysisJobs'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeCacheAnalysisJobs',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Data\\": {\\n \\"List\\": {\\n \\"CacheAnalysisJob\\": [\\n {\\n \\"TaskState\\": \\"BACKUP\\",\\n \\"JobId\\": \\"sf79-sd99-sa37-****\\",\\n \\"Message\\": \\"Successful\\",\\n \\"BigKeys\\": {\\n \\"KeyInfo\\": [\\n {\\n \\"Type\\": \\"hash\\",\\n \\"Db\\": 0,\\n \\"ExpirationTimeMillis\\": 1596256542547,\\n \\"Key\\": \\"task_*****\\",\\n \\"Encoding\\": \\"hashtable\\",\\n \\"Bytes\\": 12345,\\n \\"NodeId\\": \\"r-****-db-0\\",\\n \\"Count\\": 127\\n }\\n ]\\n },\\n \\"InstanceId\\": \\"r-bp18ff4a195d****\\",\\n \\"NodeId\\": \\"r-x****-db-0\\"\\n }\\n ]\\n },\\n \\"PageNo\\": 1,\\n \\"PageSize\\": 10,\\n \\"Extra\\": \\"None\\",\\n \\"Total\\": 4\\n },\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n \\n \\n BACKUP\\n sf79-sd99-sa37-****\\n Successful\\n \\n hash\\n 0\\n 1596256542547\\n task_*****\\n hashtable\\n 12345\\n r-****-db-0\\n 127\\n \\n r-bp18ff4a195d****\\n r-x****-db-0\\n
\\n 1\\n 10\\n None\\n 4\\n \\n 200\\n true\\n","errorExample":""}]',
],
'DescribeCloudBenchTasks' => [
'summary' => '调用DescribeCloudBenchTasks接口,查询压测任务列表。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'systemTags' => [
'operationType' => 'get',
'abilityTreeCode' => '29456',
'abilityTreeNodes' => ['FEATUREhdmB8MM4L'],
],
'parameters' => [
[
'name' => 'Status',
'in' => 'query',
'schema' => ['description' => '任务的运行状态。取值:'."\n"
."\n"
.'- **SUCCESS**:成功。'."\n"
.'- **IGNORED**:忽略。'."\n"
.'- **RUNNING**:运行中。'."\n"
.'- **EXCEPTION**:异常。', 'type' => 'string', 'required' => false, 'example' => 'SUCCESS'],
],
[
'name' => 'TaskType',
'in' => 'query',
'schema' => ['description' => '压测任务类型。取值:'."\n"
.'- **pressure test**(默认):智能压测,将从源实例上捕获的流量,按照目标实例规格支持的极限速度,在目标实例上进行回放。'."\n"
.'- **smart pressure test**:生成压测,通过分析和学习短时间内在源实例上捕获的流量,生成和原始流量的业务模型和流量分布基本一致的流量进行持续压测,减少从源实例采集数据的时间,降低存储成本和性能开销。', 'type' => 'string', 'required' => false, 'example' => 'pressure test'],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => ['description' => '查询任务开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'string', 'required' => false, 'example' => '1596177993000'],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => ['description' => '查询任务结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
.'>查询任务结束时间需晚于查询任务开始时间。', 'type' => 'string', 'required' => false, 'example' => '1596177993001'],
],
[
'name' => 'PageNo',
'in' => 'query',
'schema' => ['description' => '页码,取值大于0且不超过Integer数据类型的最大值,默认值为1。', 'type' => 'string', 'required' => false, 'example' => '1'],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => ['description' => '每页最大记录数,取值大于0且不超过Integer数据类型的最大值,默认值为10。', 'type' => 'string', 'required' => false, 'example' => '10'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'description' => '详细信息列表,包括信息总数、错误码等。',
'type' => 'object',
'properties' => [
'PageNo' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'],
'PageSize' => ['description' => '每页最大记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'],
'Extra' => ['description' => ' 备用参数。', 'type' => 'string', 'example' => 'None'],
'Total' => ['description' => '结果的数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '2'],
'List' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'cloudbenchTasks' => [
'description' => '压测任务的详细信息列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DtsJobName' => ['description' => 'DTS的任务名称。', 'type' => 'string', 'example' => 'RDS间迁移'],
'ErrorMessage' => ['description' => '任务失败的错误提示。', 'type' => 'string', 'example' => 'DTS-070211: Connect Source DB failed. cause by [com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:Could not create connection to database server. Attempted reconnect 3 times. Giving up.][com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:Communications link failure\\n\\nThe last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.][java.net.ConnectException:Connection timed out (Connection timed out)] About more information in [https://yq.aliyun.com/articles/499178].'],
'External' => ['description' => '其他信息。', 'type' => 'string', 'example' => 'Null'],
'BackupType' => ['description' => '备份类型。取值:'."\n"
."\n"
.'- **TIMESTAMP**:按备份时间。'."\n"
.'- **BACKUPID**:按备份集ID。', 'type' => 'string', 'example' => 'TIMESTAMP'],
'UserId' => ['description' => '阿里云账号ID。', 'type' => 'string', 'example' => '1091411816252****'],
'DstType' => ['description' => '目标实例的类型。取值:'."\n"
.'- **Instance**(默认):实例ID。'."\n"
.'- **ConnectionString**:实例的连接地址。', 'type' => 'string', 'example' => 'Instance'],
'EcsInstanceId' => ['description' => 'ECS的实例ID。', 'type' => 'string', 'example' => 'i-bp1ecr5go2go1****'],
'DstInstanceUuid' => ['description' => '目标实例的唯一标识符号。', 'type' => 'string', 'example' => 'hdm_d887b5ccf99fa0dc9a1e5aaac368****'],
'TaskType' => ['description' => '压测任务类型。取值:'."\n"
.'- **pressure test**(默认):智能压测,将从源实例上捕获的流量,按照目标实例规格支持的极限速度,在目标实例上进行回放。'."\n"
.'- **smart pressure test**:生成压测,通过分析和学习短时间内在源实例上捕获的流量,生成和原始流量的业务模型和流量分布基本一致的流量进行持续压测,减少从源实例采集数据的时间,降低存储成本和性能开销。', 'type' => 'string', 'example' => 'pressure test'],
'BenchStep' => ['description' => '压测的子步骤。取值:'."\n"
."\n"
.'- **NEW**:任务初始化。'."\n"
.'- **WAIT_BUY_ECS**:新购ECS实例。'."\n"
.'- **WAIT_START_ECS**:ECS实例启动。'."\n"
.'- **WAIT_INSTALL_JDK**:安装JDK。'."\n"
.'- **WAIT_INSTALL_DBGATEWAY**:安装DBGateway。'."\n"
.'- **ADD_SECURITY_IPS_STEP**:配置安全组白名单。'."\n"
.'- **ARCHIVE**:全量SQL归档。'."\n"
.'- **DOWNLOAD**:下载全量SQL文件。'."\n"
.'- **PROCEED**:预处理全量SQL文件。'."\n"
.'- **PRE_LOAD**:预加载全量SQL文件。'."\n"
.'- **VALIDATE**:功能验证。'."\n"
.'- **PRESSURE**:性能压测。', 'type' => 'string', 'example' => 'PROCEED'],
'Version' => ['description' => '压测任务版本。取值:'."\n"
."\n"
.'- **V2.0**。'."\n"
.'- **V3.0**。', 'type' => 'string', 'example' => 'V3.0'],
'EndState' => ['description' => '压测任务结束后的状态。取值:'."\n"
."\n"
.'- **WAIT_TARGET**:准备压测的目标实例。'."\n"
.'- **WAIT_DBGATEWAY**:准备压测部署。'."\n"
.'- **WAIT_SQL**:准备全量SQL。'."\n"
.'- **WAIT_LOGIC**:准备开始回放流量。'."\n"
."\n"
.'>当压测任务执行完EndState设置的状态之后,任务将直接到达完成状态。', 'type' => 'string', 'example' => 'WAIT_TARGET'],
'SrcInstanceUuid' => ['description' => '源实例的唯一标识符号。', 'type' => 'string', 'example' => 'hdm_3063db6792965c080a4bcb6e6304****'],
'ClientType' => ['description' => '压测机器类型。取值:'."\n"
."\n"
.'- **ECS**:您需要自己准备[数据库网关](~~64905~~)。'."\n"
.'- **DAS_ECS**:DAS自动购买和部署的ECS。', 'type' => 'string', 'example' => 'ECS'],
'State' => ['description' => '目前压测任务的状态。取值:'."\n"
."\n"
.'- **WAIT_TARGET**:准备压测的目标实例。'."\n"
.'- **WAIT_DBGATEWAY**:准备压测部署。'."\n"
.'- **WAIT_SQL**:准备全量SQL。'."\n"
.'- **WAIT_LOGIC**:准备开始回放流量。', 'type' => 'string', 'example' => 'WAIT_TARGET'],
'DstIp' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'SrcPublicIp' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'BackupId' => ['description' => '备份集ID,可通过查询备份列表接口[DescribeBackups](~~26273~~)获取。', 'type' => 'string', 'example' => '229132'],
'SqlCompleteReuse' => ['description' => '全量SQL的复用信息。', 'type' => 'string', 'example' => '{"sqlUuid":"task_a37d2f07-45cb-4413-a2a6-c66c68****","metaUuid":"task_211e2561-5c0c-486b-864c-56b511****","sqlFile":"cl-1620057600000-1800626.sc","metaFile":"cl-1620057600000-1800626.meta"}'],
'SmartPressureTime' => ['description' => '生成压测的时间,单位为毫秒。', 'type' => 'integer', 'format' => 'int32', 'example' => '86400000'],
'ArchiveState' => ['description' => 'SQL归档状态,取值:'."\n"
."\n"
.'- **0**:未开始。'."\n"
.'- **1**:完成。'."\n"
.'- **2**:错误。'."\n"
.'- **3**:运行中。'."\n"
.'- **4**:无需下载。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'],
'Status' => ['description' => '压测任务的运行状态。取值:'."\n"
."\n"
.'- **SUCCESS**:成功。'."\n"
.'- **IGNORED**:忽略。'."\n"
.'- **RUNNING**:运行中。'."\n"
.'- **EXCEPTION**:异常。', 'type' => 'string', 'example' => 'RUNNING'],
'WorkDir' => ['description' => '压测生成的临时目录。', 'type' => 'string', 'example' => '/tmp/bench/'],
'ArchiveOssTableName' => ['description' => '归档至OSS的表名。', 'type' => 'string', 'example' => 'custins15546355_161604665****'],
'DtsJobId' => ['description' => 'DTS迁移的任务ID。', 'type' => 'string', 'example' => 'i03e3zty16i****'],
'DtsJobState' => ['description' => 'DTS任务状态,取值:'."\n"
."\n"
.'- **NOT_STARTED**:未启动。'."\n"
.'- **PRE_CHECKING**:预检查中。'."\n"
.'- **PRE_CHECK_FAILED**:预检查失败。'."\n"
.'- **CHECKING**:检查中。'."\n"
.'- **MIGRATING**:迁移中。'."\n"
.'- **CATCHED**:已经追平。'."\n"
.'- **SUSPENDING**:暂停中。'."\n"
.'- **MIGRATION_FAILED**:迁移失败。'."\n"
.'- **FINISHED**:完成。'."\n"
.'- **INITIALIZING**:同步初始化。'."\n"
.'- **INITIALIZE_FAILED**:同步初始化失败。'."\n"
.'- **SYNCHRONIZING**:同步中。'."\n"
.'- **MODIFYING**:同步对象变更中。'."\n"
.'- **SWITCHING**:切换中。'."\n"
.'- **FAILED**:失败。'."\n", 'type' => 'integer', 'format' => 'int32', 'example' => 'CHECKING'],
'DstPort' => ['description' => '目标实例的端口。', 'type' => 'integer', 'format' => 'int32', 'example' => '3306'],
'DtsJobClass' => ['description' => 'DTS链路规格。'."\n"
.'>关于各链路规格的说明及性能测试情况请参见[数据迁移链路规格说明](~~26606~~)。', 'type' => 'string', 'example' => 'medium'],
'ClientGatewayId' => ['description' => '压测机的数据库网关ID。', 'type' => 'string', 'example' => '58598b2af48a0193dfc16fc6964ef****'],
'Description' => ['description' => '压测任务描述。', 'type' => 'string', 'example' => 'test-das-bench-0501'],
'ErrorCode' => ['description' => '压测内部任务返回的错误码。', 'type' => 'string', 'example' => '10109'],
'TableSchema' => ['description' => '压测中涉及的表名。', 'type' => 'string', 'example' => '[{"TABLE_NAME":"customer1","TABLE_SCHEMA":"tpcc"}]'],
'DtsJobStatus' => ['description' => 'DTS任务状态,取值:'."\n"
."\n"
.'- **NOT_STARTED**:未启动。'."\n"
.'- **PRE_CHECKING**:预检查中。'."\n"
.'- **PRE_CHECK_FAILED**:预检查失败。'."\n"
.'- **CHECKING**:检查中。'."\n"
.'- **MIGRATING**:迁移中。'."\n"
.'- **CATCHED**:已经追平。'."\n"
.'- **SUSPENDING**:暂停中。'."\n"
.'- **MIGRATION_FAILED**:迁移失败。'."\n"
.'- **FINISHED**:完成。'."\n"
.'- **INITIALIZING**:同步初始化。'."\n"
.'- **INITIALIZE_FAILED**:同步初始化失败。'."\n"
.'- **SYNCHRONIZING**:同步中。'."\n"
.'- **MODIFYING**:同步对象变更中。'."\n"
.'- **SWITCHING**:切换中。'."\n"
.'- **FAILED**:失败。'."\n", 'type' => 'string', 'example' => 'PRE_CHECK_FAILED'],
'SrcInstanceArea' => ['description' => '源实例的数据库类型。', 'type' => 'string', 'example' => 'RDS'],
'BenchStepStatus' => ['description' => '压测子步骤状态。取值:'."\n"
."\n"
.'- **NEW**:任务初始化。'."\n"
.'- **RUNNING**:正在执行。'."\n"
.'- **FAILED**:失败。'."\n"
.'- **FINISHED**:完成。'."\n"
.'- **Terminated**:已终止。'."\n"
.'- **Deleted**:已删除。'."\n", 'type' => 'string', 'example' => 'FINISHED'],
'Source' => ['description' => '任务来源。取值:'."\n"
."\n"
.'- **DAS**。'."\n"
.'- **OPEN_API**。', 'type' => 'string', 'example' => 'DAS'],
'ArchiveJobId' => ['description' => '归档任务ID。', 'type' => 'string', 'example' => '\'202105211430070112231480820340758****'],
'Topic' => ['description' => 'kafka的消费Topic。', 'type' => 'string', 'example' => 'das'],
'RequestDuration' => ['description' => '压测任务持续时间,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '86400000'],
'TaskId' => ['description' => '任务ID。', 'type' => 'string', 'example' => 'e5cec704-0518-430f-8263-76f4dcds****'],
'Rate' => ['description' => '源实例流量在目标实例上的回放速度,回放速度必须是正整数,取值:**0**~**30**,默认为**1**。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"PageNo\\": 1,\\n \\"PageSize\\": 10,\\n \\"Extra\\": \\"None\\",\\n \\"Total\\": 2,\\n \\"List\\": {\\n \\"cloudbenchTasks\\": [\\n {\\n \\"DtsJobName\\": \\"RDS间迁移\\",\\n \\"ErrorMessage\\": \\"DTS-070211: Connect Source DB failed. cause by [com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:Could not create connection to database server. Attempted reconnect 3 times. Giving up.][com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:Communications link failure\\\\\\\\n\\\\\\\\nThe last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.][java.net.ConnectException:Connection timed out (Connection timed out)] About more information in [https://yq.aliyun.com/articles/499178].\\",\\n \\"External\\": \\"Null\\",\\n \\"BackupType\\": \\"TIMESTAMP\\",\\n \\"UserId\\": \\"1091411816252****\\",\\n \\"DstType\\": \\"Instance\\",\\n \\"EcsInstanceId\\": \\"i-bp1ecr5go2go1****\\",\\n \\"DstInstanceUuid\\": \\"hdm_d887b5ccf99fa0dc9a1e5aaac368****\\",\\n \\"TaskType\\": \\"pressure test\\",\\n \\"BenchStep\\": \\"PROCEED\\",\\n \\"Version\\": \\"V3.0\\",\\n \\"EndState\\": \\"WAIT_TARGET\\",\\n \\"SrcInstanceUuid\\": \\"hdm_3063db6792965c080a4bcb6e6304****\\",\\n \\"ClientType\\": \\"ECS\\",\\n \\"State\\": \\"WAIT_TARGET\\",\\n \\"DstIp\\": \\"None\\",\\n \\"SrcPublicIp\\": \\"None\\",\\n \\"BackupId\\": \\"229132\\",\\n \\"SqlCompleteReuse\\": \\"{\\\\\\"sqlUuid\\\\\\":\\\\\\"task_a37d2f07-45cb-4413-a2a6-c66c68****\\\\\\",\\\\\\"metaUuid\\\\\\":\\\\\\"task_211e2561-5c0c-486b-864c-56b511****\\\\\\",\\\\\\"sqlFile\\\\\\":\\\\\\"cl-1620057600000-1800626.sc\\\\\\",\\\\\\"metaFile\\\\\\":\\\\\\"cl-1620057600000-1800626.meta\\\\\\"}\\",\\n \\"SmartPressureTime\\": 86400000,\\n \\"ArchiveState\\": 1,\\n \\"Status\\": \\"RUNNING\\",\\n \\"WorkDir\\": \\"/tmp/bench/\\",\\n \\"ArchiveOssTableName\\": \\"custins15546355_161604665****\\",\\n \\"DtsJobId\\": \\"i03e3zty16i****\\",\\n \\"DtsJobState\\": 0,\\n \\"DstPort\\": 3306,\\n \\"DtsJobClass\\": \\"medium\\",\\n \\"ClientGatewayId\\": \\"58598b2af48a0193dfc16fc6964ef****\\",\\n \\"Description\\": \\"test-das-bench-0501\\",\\n \\"ErrorCode\\": \\"10109\\",\\n \\"TableSchema\\": \\"[{\\\\\\"TABLE_NAME\\\\\\":\\\\\\"customer1\\\\\\",\\\\\\"TABLE_SCHEMA\\\\\\":\\\\\\"tpcc\\\\\\"}]\\",\\n \\"DtsJobStatus\\": \\"PRE_CHECK_FAILED\\",\\n \\"SrcInstanceArea\\": \\"RDS\\",\\n \\"BenchStepStatus\\": \\"FINISHED\\",\\n \\"Source\\": \\"DAS\\",\\n \\"ArchiveJobId\\": \\"\'202105211430070112231480820340758****\\",\\n \\"Topic\\": \\"das\\",\\n \\"RequestDuration\\": 86400000,\\n \\"TaskId\\": \\"e5cec704-0518-430f-8263-76f4dcds****\\",\\n \\"Rate\\": 1\\n }\\n ]\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n \\n 1\\n 10\\n None\\n 2\\n \\n RDS间迁移\\n DTS-070211: Connect Source DB failed. cause by [com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:Could not create connection to database server. Attempted reconnect 3 times. Giving up.][com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:Communications link failure\\\\n\\\\nThe last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.][java.net.ConnectException:Connection timed out (Connection timed out)] About more information in [https://yq.aliyun.com/articles/499178].\\n Null\\n TIMESTAMP\\n 1091411816252****\\n Instance\\n i-bp1ecr5go2go1****\\n hdm_d887b5ccf99fa0dc9a1e5aaac368****\\n pressure test\\n PROCEED\\n V3.0\\n WAIT_TARGET\\n hdm_3063db6792965c080a4bcb6e6304****\\n ECS\\n WAIT_TARGET\\n None\\n None\\n 229132\\n {\\"sqlUuid\\":\\"task_a37d2f07-45cb-4413-a2a6-c66c68****\\",\\"metaUuid\\":\\"task_211e2561-5c0c-486b-864c-56b511****\\",\\"sqlFile\\":\\"cl-1620057600000-1800626.sc\\",\\"metaFile\\":\\"cl-1620057600000-1800626.meta\\"}\\n 86400000\\n 1\\n RUNNING\\n /tmp/bench/\\n custins15546355_161604665****\\n i03e3zty16i****\\n 3306\\n medium\\n 58598b2af48a0193dfc16fc6964ef****\\n test-das-bench-0501\\n 10109\\n [{\\"TABLE_NAME\\":\\"customer1\\",\\"TABLE_SCHEMA\\":\\"tpcc\\"}]\\n PRE_CHECK_FAILED\\n RDS\\n FINISHED\\n DAS\\n \'202105211430070112231480820340758****\\n das\\n 86400000\\n e5cec704-0518-430f-8263-76f4dcds****\\n 1\\n
\\n \\n","errorExample":""}]',
'title' => '查询压测任务列表',
'description' => '数据库自治服务DAS提供智能压测功能,帮助您验证您的实例规格是否需要扩容,有效应对业务流量高峰。更多信息,请参见[智能压测](~~155068~~)。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeCloudBenchTasks'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeCloudBenchTasks',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'DescribeCloudbenchTask' => [
'summary' => '调用DescribeCloudbenchTask接口,查询压测任务。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'systemTags' => ['operationType' => 'get'],
'parameters' => [
[
'name' => 'TaskId',
'in' => 'query',
'schema' => ['description' => '任务ID,您可通过[DescribeCloudBenchTasks](~~230670~~)接口获取。', 'type' => 'string', 'required' => true, 'example' => 'e5cec704-0518-430f-8263-76f4dcds****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'description' => '详细信息列表,包括信息总数、错误码等。',
'type' => 'object',
'properties' => [
'DtsJobName' => ['description' => 'DTS的任务名称。', 'type' => 'string', 'example' => 'Migration between RDS instances'],
'ErrorMessage' => ['description' => '任务失败的错误提示。', 'type' => 'string', 'example' => 'DTS-070211: Connect Source DB failed. cause by [com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:Could not create connection to database server. Attempted reconnect 3 times. Giving up.][com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:Communications link failure\\n\\nThe last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.][java.net.ConnectException:Connection timed out (Connection timed out)] About more information in [https://yq.aliyun.com/articles/499178].'],
'External' => ['description' => '其他信息。', 'type' => 'string', 'example' => 'Null'],
'BackupType' => ['description' => '备份类型。取值:'."\n"
."\n"
.'- **TIMESTAMP**:按备份时间。'."\n"
.'- **BACKUPID**:按备份集ID。', 'type' => 'string', 'example' => 'TIMESTAMP'],
'UserId' => ['description' => '阿里云账号ID。', 'type' => 'string', 'example' => '109141182625****'],
'DstType' => ['description' => '目标实例的类型。取值:'."\n"
.'- **Instance**(默认):实例ID。'."\n"
.'- **ConnectionString**:实例的连接地址。', 'type' => 'string', 'example' => 'Instance'],
'EcsInstanceId' => ['description' => 'ECS的实例ID。', 'type' => 'string', 'example' => 'i-bp1ecr5go2go1****'],
'DstInstanceUuid' => ['description' => '目标实例的唯一标识符号。', 'type' => 'string', 'example' => 'hdm_d887b5ccf99fa0dc9a1e5aaac368****'],
'TaskType' => ['description' => '压测任务类型。取值:'."\n"
.'- **pressure test**(默认):智能压测,将从源实例上捕获的流量,按照目标实例规格支持的极限速度,在目标实例上进行回放。'."\n"
.'- **smart pressure test**:生成压测,通过分析和学习短时间内在源实例上捕获的流量,生成和原始流量的业务模型和流量分布基本一致的流量进行持续压测,减少从源实例采集数据的时间,降低存储成本和性能开销。', 'type' => 'string', 'example' => 'pressure test'],
'BenchStep' => ['description' => '压测的子步骤。取值:'."\n"
."\n"
.'- **NEW**:任务初始化。'."\n"
.'- **WAIT_BUY_ECS**:新购ECS实例。'."\n"
.'- **WAIT_START_ECS**:ECS实例启动。'."\n"
.'- **WAIT_INSTALL_JDK**:安装JDK。'."\n"
.'- **WAIT_INSTALL_DBGATEWAY**:安装DBGateway。'."\n"
.'- **ADD_SECURITY_IPS_STEP**:配置安全组白名单。'."\n"
.'- **ARCHIVE**:全量SQL归档。'."\n"
.'- **DOWNLOAD**:下载全量SQL文件。'."\n"
.'- **PROCEED**:预处理全量SQL文件。'."\n"
.'- **PRE_LOAD**:预加载全量SQL文件。'."\n"
.'- **VALIDATE**:功能验证。'."\n"
.'- **PRESSURE**:性能压测。', 'type' => 'string', 'example' => 'PROCEED'],
'Version' => ['description' => '压测任务版本。取值:'."\n"
."\n"
.'- **V2.0**'."\n"
.'- **V3.0**', 'type' => 'string', 'example' => 'V3.0'],
'EndState' => ['description' => '压测任务结束后的状态。取值:'."\n"
."\n"
.'- **WAIT_TARGET**:准备压测的目标实例。'."\n"
.'- **WAIT_DBGATEWAY**:准备压测部署。'."\n"
.'- **WAIT_SQL**:准备全量SQL。'."\n"
.'- **WAIT_LOGIC**:准备开始回放流量。'."\n"
."\n"
.'>当压测任务执行完EndState设置的状态之后,任务将直接到达完成状态。', 'type' => 'string', 'example' => 'WAIT_LOGIC'],
'SrcInstanceUuid' => ['description' => '源实例的唯一标识符号。', 'type' => 'string', 'example' => 'a364e414-e68b-4e5c-9166-65b3a153****'],
'ClientType' => ['description' => '压测机器类型。取值:'."\n"
."\n"
.'- **ECS**:您需要自己准备[数据库网关](~~64905~~)。'."\n"
.'- **DAS_ECS**:DAS自动购买和部署的ECS。', 'type' => 'string', 'example' => 'ECS'],
'State' => ['description' => '目前压测任务的状态。取值:'."\n"
."\n"
.'- **WAIT_TARGET**:准备压测的目标实例。'."\n"
.'- **WAIT_DBGATEWAY**:准备压测部署。'."\n"
.'- **WAIT_SQL**:准备全量SQL。'."\n"
.'- **WAIT_LOGIC**:准备开始回放流量。', 'type' => 'string', 'example' => 'WAIT_TARGET'],
'DstIp' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'SrcPublicIp' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'BackupId' => ['description' => '备份集ID,可通过查询备份列表接口[DescribeBackups](~~26273~~)获取。', 'type' => 'string', 'example' => '229132'],
'SqlCompleteReuse' => ['description' => '全量SQL的复用信息。', 'type' => 'string', 'example' => '{"sqlUuid":"task_a37d2f07-45cb-****-a2a6-c66c62****","metaUuid":"task_211e2561-5c0c-486b-864c-56b511****","sqlFile":"cl-1620057600000-1800626.sc","metaFile":"cl-1620057600000-180****.meta"}'],
'SmartPressureTime' => ['description' => '生成压测时间,单位为毫秒。', 'type' => 'integer', 'format' => 'int32', 'example' => '86400000'],
'ArchiveState' => ['description' => 'SQL归档状态,取值:'."\n"
."\n"
.'- **0**:未开始。'."\n"
.'- **1**:完成。'."\n"
.'- **2**:错误。'."\n"
.'- **3**:运行中。'."\n"
.'- **4**:无需下载。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'],
'Status' => ['description' => '压测任务的运行状态。取值:'."\n"
."\n"
.'- **SUCCESS**:成功。'."\n"
.'- **IGNORED**:忽略。'."\n"
.'- **RUNNING**:运行中。'."\n"
.'- **EXCEPTION**:异常。', 'type' => 'string', 'example' => 'RUNNING'],
'WorkDir' => ['description' => '压测生成的临时目录。', 'type' => 'string', 'example' => '/tmp/bench/'],
'ArchiveOssTableName' => ['description' => '归档的OSS表名。', 'type' => 'string', 'example' => 'custins15546355_161604665****'],
'DtsJobId' => ['description' => 'DTS迁移任务ID。', 'type' => 'string', 'example' => 'i03e3zty16i****'],
'DtsJobState' => ['description' => 'DTS任务状态,取值:'."\n"
."\n"
.'- **NOT_STARTED**:未启动。'."\n"
.'- **PRE_CHECKING**:预检查中。'."\n"
.'- **PRE_CHECK_FAILED**:预检查失败。'."\n"
.'- **CHECKING**:检查中。'."\n"
.'- **MIGRATING**:迁移中。'."\n"
.'- **CATCHED**:已经追平。'."\n"
.'- **SUSPENDING**:暂停中。'."\n"
.'- **MIGRATION_FAILED**:迁移失败。'."\n"
.'- **FINISHED**:完成。'."\n"
.'- **INITIALIZING**:同步初始化。'."\n"
.'- **INITIALIZE_FAILED**:同步初始化失败。'."\n"
.'- **SYNCHRONIZING**:同步中。'."\n"
.'- **MODIFYING**:同步对象变更中。'."\n"
.'- **SWITCHING**:切换中。'."\n"
.'- **FAILED**:失败。', 'type' => 'integer', 'format' => 'int32', 'example' => 'CHECKING'],
'DstPort' => ['description' => '目标实例的端口。', 'type' => 'integer', 'format' => 'int32', 'example' => '3306'],
'DtsJobClass' => ['description' => 'DTS任务规格。', 'type' => 'string', 'example' => 'medium'],
'ClientGatewayId' => ['description' => '压测机的数据库网关ID。', 'type' => 'string', 'example' => '58598b2af48a0193dfc16fc6964ef****'],
'Description' => ['description' => '压测任务描述。', 'type' => 'string', 'example' => 'test-das-bench-0501'],
'ErrorCode' => ['description' => '压测内部任务返回的错误码。', 'type' => 'string', 'example' => '10910'],
'TableSchema' => ['description' => '压测中涉及的表名。', 'type' => 'string', 'example' => '[{"TABLE_NAME":"customer1","TABLE_SCHEMA":"tpcc"}]'],
'DtsJobStatus' => ['description' => 'DTS任务状态,取值:'."\n"
."\n"
.'- **NOT_STARTED**:未启动。'."\n"
.'- **PRE_CHECKING**:预检查中。'."\n"
.'- **PRE_CHECK_FAILED**:预检查失败。'."\n"
.'- **CHECKING**:检查中。'."\n"
.'- **MIGRATING**:迁移中。'."\n"
.'- **CATCHED**:已经追平。'."\n"
.'- **SUSPENDING**:暂停中。'."\n"
.'- **MIGRATION_FAILED**:迁移失败。'."\n"
.'- **FINISHED**:完成。'."\n"
.'- **INITIALIZING**:同步初始化。'."\n"
.'- **INITIALIZE_FAILED**:同步初始化失败。'."\n"
.'- **SYNCHRONIZING**:同步中。'."\n"
.'- **MODIFYING**:同步对象变更中。'."\n"
.'- **SWITCHING**:切换中。'."\n"
.'- **FAILED**:失败。'."\n", 'type' => 'string', 'example' => 'PRE_CHECKING'],
'SrcInstanceArea' => ['description' => '源实例的数据库类型。', 'type' => 'string', 'example' => 'RDS'],
'BenchStepStatus' => ['description' => '压测子步骤状态。取值:'."\n"
."\n"
.'- **NEW**:任务初始化。'."\n"
.'- **RUNNING**:正在执行。'."\n"
.'- **FAILED**:失败。'."\n"
.'- **FINISHED**:已完成。'."\n"
.'- **Terminated**:已终止。'."\n"
.'- **Deleted**:已删除。'."\n"
."\n", 'type' => 'string', 'example' => 'FINISHED'],
'Source' => ['description' => '任务来源。取值:'."\n"
."\n"
.'- **DAS**。'."\n"
.'- **OPEN_API**。', 'type' => 'string', 'example' => 'DAS'],
'ArchiveJobId' => ['description' => '归档任务ID。', 'type' => 'string', 'example' => '\'202105211430070112231480820340758****'],
'Topic' => ['description' => 'kafka的消费Topic。', 'type' => 'string', 'example' => 'das'],
'RequestDuration' => ['description' => '压测任务的持续时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '864000'],
'TaskId' => ['description' => '任务ID。', 'type' => 'string', 'example' => 'e5cec704-0518-430f-8263-76f4dcds****'],
'Rate' => ['description' => '压测倍率。回放倍率必须是正整数,取值范围为:**0**~**30**,默认为**1**。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
],
],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"DtsJobName\\": \\"Migration between RDS instances\\",\\n \\"ErrorMessage\\": \\"DTS-070211: Connect Source DB failed. cause by [com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:Could not create connection to database server. Attempted reconnect 3 times. Giving up.][com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:Communications link failure\\\\\\\\n\\\\\\\\nThe last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.][java.net.ConnectException:Connection timed out (Connection timed out)] About more information in [https://yq.aliyun.com/articles/499178].\\",\\n \\"External\\": \\"Null\\",\\n \\"BackupType\\": \\"TIMESTAMP\\",\\n \\"UserId\\": \\"109141182625****\\",\\n \\"DstType\\": \\"Instance\\",\\n \\"EcsInstanceId\\": \\"i-bp1ecr5go2go1****\\",\\n \\"DstInstanceUuid\\": \\"hdm_d887b5ccf99fa0dc9a1e5aaac368****\\",\\n \\"TaskType\\": \\"pressure test\\",\\n \\"BenchStep\\": \\"PROCEED\\",\\n \\"Version\\": \\"V3.0\\",\\n \\"EndState\\": \\"WAIT_LOGIC\\",\\n \\"SrcInstanceUuid\\": \\"a364e414-e68b-4e5c-9166-65b3a153****\\",\\n \\"ClientType\\": \\"ECS\\",\\n \\"State\\": \\"WAIT_TARGET\\",\\n \\"DstIp\\": \\"None\\",\\n \\"SrcPublicIp\\": \\"None\\",\\n \\"BackupId\\": \\"229132\\",\\n \\"SqlCompleteReuse\\": \\"{\\\\\\"sqlUuid\\\\\\":\\\\\\"task_a37d2f07-45cb-****-a2a6-c66c62****\\\\\\",\\\\\\"metaUuid\\\\\\":\\\\\\"task_211e2561-5c0c-486b-864c-56b511****\\\\\\",\\\\\\"sqlFile\\\\\\":\\\\\\"cl-1620057600000-1800626.sc\\\\\\",\\\\\\"metaFile\\\\\\":\\\\\\"cl-1620057600000-180****.meta\\\\\\"}\\",\\n \\"SmartPressureTime\\": 86400000,\\n \\"ArchiveState\\": 1,\\n \\"Status\\": \\"RUNNING\\",\\n \\"WorkDir\\": \\"/tmp/bench/\\",\\n \\"ArchiveOssTableName\\": \\"custins15546355_161604665****\\",\\n \\"DtsJobId\\": \\"i03e3zty16i****\\",\\n \\"DtsJobState\\": 0,\\n \\"DstPort\\": 3306,\\n \\"DtsJobClass\\": \\"medium\\",\\n \\"ClientGatewayId\\": \\"58598b2af48a0193dfc16fc6964ef****\\",\\n \\"Description\\": \\"test-das-bench-0501\\",\\n \\"ErrorCode\\": \\"10910\\",\\n \\"TableSchema\\": \\"[{\\\\\\"TABLE_NAME\\\\\\":\\\\\\"customer1\\\\\\",\\\\\\"TABLE_SCHEMA\\\\\\":\\\\\\"tpcc\\\\\\"}]\\",\\n \\"DtsJobStatus\\": \\"PRE_CHECKING\\",\\n \\"SrcInstanceArea\\": \\"RDS\\",\\n \\"BenchStepStatus\\": \\"FINISHED\\",\\n \\"Source\\": \\"DAS\\",\\n \\"ArchiveJobId\\": \\"\'202105211430070112231480820340758****\\",\\n \\"Topic\\": \\"das\\",\\n \\"RequestDuration\\": 864000,\\n \\"TaskId\\": \\"e5cec704-0518-430f-8263-76f4dcds****\\",\\n \\"Rate\\": 1\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n \\n RDS间迁移\\n DTS-070211: Connect Source DB failed. cause by [com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:Could not create connection to database server. Attempted reconnect 3 times. Giving up.][com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:Communications link failure\\\\n\\\\nThe last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.][java.net.ConnectException:Connection timed out (Connection timed out)] About more information in [https://yq.aliyun.com/articles/499178].\\n Null\\n TIMESTAMP\\n 109141182625****\\n Instance\\n i-bp1ecr5go2go1****\\n hdm_d887b5ccf99fa0dc9a1e5aaac368****\\n pressure test\\n PROCEED\\n V3.0\\n WAIT_LOGIC\\n a364e414-e68b-4e5c-9166-65b3a153****\\n ECS\\n WAIT_TARGET\\n None\\n None\\n 229132\\n {\\"sqlUuid\\":\\"task_a37d2f07-45cb-****-a2a6-c66c62****\\",\\"metaUuid\\":\\"task_211e2561-5c0c-486b-864c-56b511****\\",\\"sqlFile\\":\\"cl-1620057600000-1800626.sc\\",\\"metaFile\\":\\"cl-1620057600000-180****.meta\\"}\\n 86400000\\n 1\\n RUNNING\\n /tmp/bench/\\n custins15546355_161604665****\\n i03e3zty16i****\\n 3306\\n medium\\n 58598b2af48a0193dfc16fc6964ef****\\n test-das-bench-0501\\n 10910\\n [{\\"TABLE_NAME\\":\\"customer1\\",\\"TABLE_SCHEMA\\":\\"tpcc\\"}]\\n PRE_CHECKING\\n RDS\\n FINISHED\\n DAS\\n \'202105211430070112231480820340758****\\n das\\n 864000\\n e5cec704-0518-430f-8263-76f4dcds****\\n 1\\n \\n","errorExample":""}]',
'title' => '查询压测任务',
'description' => '数据库自治服务DAS提供智能压测功能,帮助您验证您的实例规格是否需要扩容,有效应对业务流量高峰。更多信息,请参见[智能压测](~~155068~~)。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeCloudbenchTask'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeCloudbenchTask',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'DescribeCloudbenchTaskConfig' => [
'summary' => '调用DescribeCloudbenchTaskConfig接口,查询压测任务配置信息。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => ['operationType' => 'get'],
'parameters' => [
[
'name' => 'TaskId',
'in' => 'query',
'schema' => ['description' => '任务ID,您可通过[DescribeCloudBenchTasks](~~230670~~)接口获取。', 'type' => 'string', 'required' => true, 'example' => 'e5cec704-0518-430f-8263-76f4dcds****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'description' => '详细信息列表,包括信息总数、错误码等。',
'type' => 'object',
'properties' => [
'WorkDir' => ['description' => '压测生成的临时目录。', 'type' => 'string', 'example' => '/tmp/bench/'],
'ArchiveFolder' => ['description' => '归档文件路径。', 'type' => 'string', 'example' => '/tmp/das/cloudbench/archive-sqls/'],
'MetaFilePath' => ['description' => '元文件路径。', 'type' => 'string', 'example' => '/tmp/das/cloudbench/cl-1621353601000-360****.meta'],
'MetaFileName' => ['description' => '元文件名。', 'type' => 'string', 'example' => 'cl-1621353601000-360****.meta'],
'MetaFileOnOss' => ['description' => '元文件在OSS的名称。', 'type' => 'string', 'example' => '"https://cb-rm-bp1w9g06h560l****.oss-cn-hangzhou.aliyuncs.com/cl-1621353601000-360****.meta?OSSAccessKeyId=LTAI5tKj8B4wikkVtupK****&Expires=1622441372&Signature=Qsehg3tzeA57M%2BIixAbWPWAtvl****'],
'UserId' => ['description' => '阿里云账号ID。', 'type' => 'string', 'example' => '1091411816252****'],
'BenchCmd' => ['description' => '压测的命令。', 'type' => 'string', 'example' => 'java -jar /tmp/das/cloudbench/CloudBenchClient.jar --bench --rocksdb /tmp/das/cloudbench/rocksdb --meta /tmp/das/cloudbench/cl-1621353601000-360****.meta --task_name 2777bba9-a836-49e6-9f70-1c3822fc9239 --result_file /tmp/das/cloudbench/null.result --user cloudb**** --pwd \\"cloudbench@****\\" --host rm-bp1j5f8s5x26kq79216****.mysql.rds.aliyuncs.com --port 3306 --charset utf8mb4 --interval 1 --bench_time 3600 --rate_factor 1.0 --start_time 1621353601 --rt > /tmp/das/cloudbench/null.log'],
'SqlFileOnOss' => ['description' => '全量SQL文件在OSS的名称。', 'type' => 'string', 'example' => 'https://cb-rm-bp1w9g06h560l****.oss-cn-hangzhou.aliyuncs.com/cl-1621353601000-360****.sc?OSSAccessKeyId=LTAI5tKj8B4wikkVtupK****&Expires=1622441372&Signature=LYMADwo%2BRrJeqR3e4d8OlIkVmw****'],
'LoadCmd' => ['description' => 'SQL文件预加载的命令。', 'type' => 'string', 'example' => 'java -jar /tmp/das/cloudbench/CloudBenchClient.jar --load --out /tmp/das/cloudbench/cl-1621353601000-360****.sc --meta /tmp/das/cloudbench/cl-1621353601000-360****.meta --task_name 2777bba9-****-49e6-9f70-1c3822fc**** --rocksdb /tmp/das/cloudbench/rocksdb'],
'RocksDbPath' => ['description' => 'RocksDB存储系统在压测机中的位置。', 'type' => 'string', 'example' => '/tmp/das/cloudbench/rocksdb'],
'ParseCmd' => ['description' => 'SQL文件解析的命令。', 'type' => 'string', 'example' => 'cd /tmp/das/cloudbench && java -jar CloudBenchClient.jar --parse --threads 32 --file /tmp/das/cloudbench/2777bba9-a836-49e6-9f70-1c3822fc9239.archiveSql --meta /tmp/das/cloudbench/cl-1621353601000-360****.meta --out /tmp/das/cloudbench/cl-1621353601000-360****.sc --parent_patmp/das/cloudbench --source RDS --h /thost rm-bp1j5f8s5x266****.mysql.rds.aliyuncs.com --port 3306 --user cloudb**** --pwd \\"cloudbench@****\\" --cutSqlLen 8192 --db_black_list=information_schema,test,unknow,null'],
'SqlFileName' => ['description' => '全量SQL文件名。', 'type' => 'string', 'example' => 'cl-1621353601000-360****.sc'],
'ClientJarPath' => ['description' => '压测Jar包路径。', 'type' => 'string', 'example' => '/tmp/das/cloudbench/CloudBenchClient.jar'],
'SqlFilePath' => ['description' => 'SQL文件路径。', 'type' => 'string', 'example' => '/tmp/das/cloudbench/cl-1621353601000-360****.sc'],
'ParseFilePath' => ['description' => '解析后的SQL文件路径。', 'type' => 'string', 'example' => '/tmp/das/cloudbench/2777bba9-a836-49e6-9f70-1c3822fc****.archiveSql'],
'JarOnOss' => ['description' => '压测Jar包在OSS的路径。', 'type' => 'string', 'example' => 'https://cloudbench-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/CloudBenchClient.jar?OSSAccessKeyId=LTAI5tKj8B4wikkVtupK****&Expires=1622441372&Signature=28p%2BCe4tNHpr9VPOcHc3Si9iOb****'],
'TaskId' => ['description' => '任务ID。', 'type' => 'string', 'example' => 'e5cec704-0518-430f-8263-76f4dcds****'],
],
],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '查询压测任务配置',
'description' => '数据库自治服务DAS提供智能压测功能,帮助您验证您的实例规格是否需要扩容,有效应对业务流量高峰。更多信息,请参见[智能压测](~~155068~~)。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeCloudbenchTaskConfig'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeCloudbenchTaskConfig',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"WorkDir\\": \\"/tmp/bench/\\",\\n \\"ArchiveFolder\\": \\"/tmp/das/cloudbench/archive-sqls/\\",\\n \\"MetaFilePath\\": \\"/tmp/das/cloudbench/cl-1621353601000-360****.meta\\",\\n \\"MetaFileName\\": \\"cl-1621353601000-360****.meta\\",\\n \\"MetaFileOnOss\\": \\"\\\\\\"https://cb-rm-bp1w9g06h560l****.oss-cn-hangzhou.aliyuncs.com/cl-1621353601000-360****.meta?OSSAccessKeyId=LTAI5tKj8B4wikkVtupK****&Expires=1622441372&Signature=Qsehg3tzeA57M%2BIixAbWPWAtvl****\\",\\n \\"UserId\\": \\"1091411816252****\\",\\n \\"BenchCmd\\": \\"java -jar /tmp/das/cloudbench/CloudBenchClient.jar --bench --rocksdb /tmp/das/cloudbench/rocksdb --meta /tmp/das/cloudbench/cl-1621353601000-360****.meta --task_name 2777bba9-a836-49e6-9f70-1c3822fc9239 --result_file /tmp/das/cloudbench/null.result --user cloudb**** --pwd \\\\\\\\\\\\\\"cloudbench@****\\\\\\\\\\\\\\" --host rm-bp1j5f8s5x26kq79216****.mysql.rds.aliyuncs.com --port 3306 --charset utf8mb4 --interval 1 --bench_time 3600 --rate_factor 1.0 --start_time 1621353601 --rt > /tmp/das/cloudbench/null.log\\",\\n \\"SqlFileOnOss\\": \\"https://cb-rm-bp1w9g06h560l****.oss-cn-hangzhou.aliyuncs.com/cl-1621353601000-360****.sc?OSSAccessKeyId=LTAI5tKj8B4wikkVtupK****&Expires=1622441372&Signature=LYMADwo%2BRrJeqR3e4d8OlIkVmw****\\",\\n \\"LoadCmd\\": \\"java -jar /tmp/das/cloudbench/CloudBenchClient.jar --load --out /tmp/das/cloudbench/cl-1621353601000-360****.sc --meta /tmp/das/cloudbench/cl-1621353601000-360****.meta --task_name 2777bba9-****-49e6-9f70-1c3822fc**** --rocksdb /tmp/das/cloudbench/rocksdb\\",\\n \\"RocksDbPath\\": \\"/tmp/das/cloudbench/rocksdb\\",\\n \\"ParseCmd\\": \\"cd /tmp/das/cloudbench && java -jar CloudBenchClient.jar --parse --threads 32 --file /tmp/das/cloudbench/2777bba9-a836-49e6-9f70-1c3822fc9239.archiveSql --meta /tmp/das/cloudbench/cl-1621353601000-360****.meta --out /tmp/das/cloudbench/cl-1621353601000-360****.sc --parent_patmp/das/cloudbench --source RDS --h /thost rm-bp1j5f8s5x266****.mysql.rds.aliyuncs.com --port 3306 --user cloudb**** --pwd \\\\\\\\\\\\\\"cloudbench@****\\\\\\\\\\\\\\" --cutSqlLen 8192 --db_black_list=information_schema,test,unknow,null\\",\\n \\"SqlFileName\\": \\"cl-1621353601000-360****.sc\\",\\n \\"ClientJarPath\\": \\"/tmp/das/cloudbench/CloudBenchClient.jar\\",\\n \\"SqlFilePath\\": \\"/tmp/das/cloudbench/cl-1621353601000-360****.sc\\",\\n \\"ParseFilePath\\": \\"/tmp/das/cloudbench/2777bba9-a836-49e6-9f70-1c3822fc****.archiveSql\\",\\n \\"JarOnOss\\": \\"https://cloudbench-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/CloudBenchClient.jar?OSSAccessKeyId=LTAI5tKj8B4wikkVtupK****&Expires=1622441372&Signature=28p%2BCe4tNHpr9VPOcHc3Si9iOb****\\",\\n \\"TaskId\\": \\"e5cec704-0518-430f-8263-76f4dcds****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n \\n /tmp/bench/\\n /tmp/das/cloudbench/archive-sqls/\\n /tmp/das/cloudbench/cl-1621353601000-360****.meta\\n cl-1621353601000-360****.meta\\n \\"https://cb-rm-bp1w9g06h560l****.oss-cn-hangzhou.aliyuncs.com/cl-1621353601000-360****.meta?OSSAccessKeyId=LTAI5tKj8B4wikkVtupK****&Expires=1622441372&Signature=Qsehg3tzeA57M%2BIixAbWPWAtvl****\\n 1091411816252****\\n java -jar /tmp/das/cloudbench/CloudBenchClient.jar --bench --rocksdb /tmp/das/cloudbench/rocksdb --meta /tmp/das/cloudbench/cl-1621353601000-360****.meta --task_name 2777bba9-a836-49e6-9f70-1c3822fc9239 --result_file /tmp/das/cloudbench/null.result --user cloudb**** --pwd \\\\\\"cloudbench@****\\\\\\" --host rm-bp1j5f8s5x26kq79216****.mysql.rds.aliyuncs.com --port 3306 --charset utf8mb4 --interval 1 --bench_time 3600 --rate_factor 1.0 --start_time 1621353601 --rt > /tmp/das/cloudbench/null.log\\n https://cb-rm-bp1w9g06h560l****.oss-cn-hangzhou.aliyuncs.com/cl-1621353601000-360****.sc?OSSAccessKeyId=LTAI5tKj8B4wikkVtupK****&Expires=1622441372&Signature=LYMADwo%2BRrJeqR3e4d8OlIkVmw****\\n java -jar /tmp/das/cloudbench/CloudBenchClient.jar --load --out /tmp/das/cloudbench/cl-1621353601000-360****.sc --meta /tmp/das/cloudbench/cl-1621353601000-360****.meta --task_name 2777bba9-****-49e6-9f70-1c3822fc**** --rocksdb /tmp/das/cloudbench/rocksdb\\n /tmp/das/cloudbench/rocksdb\\n cd /tmp/das/cloudbench && java -jar CloudBenchClient.jar --parse --threads 32 --file /tmp/das/cloudbench/2777bba9-a836-49e6-9f70-1c3822fc9239.archiveSql --meta /tmp/das/cloudbench/cl-1621353601000-360****.meta --out /tmp/das/cloudbench/cl-1621353601000-360****.sc --parent_patmp/das/cloudbench --source RDS --h /thost rm-bp1j5f8s5x266****.mysql.rds.aliyuncs.com --port 3306 --user cloudb**** --pwd \\\\\\"cloudbench@****\\\\\\" --cutSqlLen 8192 --db_black_list=information_schema,test,unknow,null\\n cl-1621353601000-360****.sc\\n /tmp/das/cloudbench/CloudBenchClient.jar\\n /tmp/das/cloudbench/cl-1621353601000-360****.sc\\n /tmp/das/cloudbench/2777bba9-a836-49e6-9f70-1c3822fc****.archiveSql\\n https://cloudbench-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/CloudBenchClient.jar?OSSAccessKeyId=LTAI5tKj8B4wikkVtupK****&Expires=1622441372&Signature=28p%2BCe4tNHpr9VPOcHc3Si9iOb****\\n e5cec704-0518-430f-8263-76f4dcds****\\n \\n","errorExample":""}]',
],
'DescribeDiagnosticReportList' => [
'summary' => '调用DescribeDiagnosticReportList接口,查询诊断报告。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => ['operationType' => 'get'],
'parameters' => [
[
'name' => 'DBInstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
[
'name' => 'PageNo',
'in' => 'query',
'schema' => ['description' => '页码,取值大于0且不超过Integer数据类型的最大值,默认值为1。', 'type' => 'string', 'required' => false, 'example' => '1'],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => ['description' => '每页最大记录数,默认值为10。', 'type' => 'string', 'required' => false, 'example' => '10'],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => ['description' => '查询任务开始时间,格式为Unix时间戳(UTC时间),单位为毫秒。', 'type' => 'string', 'required' => true, 'example' => '1668398892000'],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => ['description' => '查询任务结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
.'> 查询任务结束时间需晚于查询任务开始时间。', 'type' => 'string', 'required' => true, 'example' => '1668420492000'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'D00DB161-FEF6-5428-B37A-8D29A4C2****'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Synchro' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'Data' => ['description' => '返回的数据:'."\n"
."\n"
.'- **total**:数据量。'."\n"
.'- **score**:诊断分数。'."\n"
.'- **diagnosticTime**:诊断生成时间(UTC 时间)。'."\n"
.'- **startTime**:查询开始时间(UTC 时间)。'."\n"
.'- **endTime**:查询结束时间(UTC 时间)。', 'type' => 'string', 'example' => '{ "total": 1, "list": [ { "score": 100, "diagnosticTime": "2022-11-14T08:17:00Z", "startTime": "2022-11-14T07:16:59Z", "endTime": "2022-11-14T08:16:59Z" } ] }'],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '查询诊断报告',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 本接口适用的数据库引擎为:'."\n"
."\n"
.' - RDS MySQL'."\n"
.' - PolarDB MySQL版'."\n"
.' - Redis',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeDiagnosticReportList'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeDiagnosticReportList',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D00DB161-FEF6-5428-B37A-8D29A4C2****\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Synchro\\": \\"None\\",\\n \\"Data\\": \\"{ \\\\\\"total\\\\\\": 1, \\\\\\"list\\\\\\": [ { \\\\\\"score\\\\\\": 100, \\\\\\"diagnosticTime\\\\\\": \\\\\\"2022-11-14T08:17:00Z\\\\\\", \\\\\\"startTime\\\\\\": \\\\\\"2022-11-14T07:16:59Z\\\\\\", \\\\\\"endTime\\\\\\": \\\\\\"2022-11-14T08:16:59Z\\\\\\" } ] }\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n D00DB161-FEF6-5428-B37A-8D29A4C2****\\n Successful\\n \\n 1\\n \\n 100\\n 2022-11-14T08:17:00Z\\n 2022-11-14T07:16:59Z\\n 2022-11-14T08:16:59Z\\n
\\n \\n 200\\n true\\n","errorExample":""}]',
],
'DescribeErrorLogRecords' => [
'summary' => '查询实例指定时间范围内的错误日志明细。',
'path' => '',
'methods' => ['post', 'get'],
'schemes' => ['https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'none',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '235508',
'abilityTreeNodes' => ['FEATUREhdmR88NLD'],
'tenantRelevance' => 'tenant',
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'pc-bp1u5mas9exx7****'],
],
[
'name' => 'NodeId',
'in' => 'formData',
'schema' => ['description' => '节点ID。', 'type' => 'string', 'required' => false, 'example' => 'pi-bp16v3824rt73****'],
],
[
'name' => 'Role',
'in' => 'formData',
'schema' => ['description' => '节点角色:'."\n"
."\n"
.'- db'."\n"
.'- mongos'."\n"
."\n"
.'> 仅云数据库MongoDB版实例支持。', 'type' => 'string', 'required' => false, 'example' => 'db'],
],
[
'name' => 'StartTime',
'in' => 'formData',
'schema' => ['description' => '查询开始时间,格式为Unix时间戳,单位为毫秒。'."\n"
."\n"
.'>该字段类型为Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于9007199254740991。>', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1731983066000'],
],
[
'name' => 'EndTime',
'in' => 'formData',
'schema' => ['description' => '查询结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
.'>该字段类型为Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于9007199254740991。>', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1732069466000'],
],
[
'name' => 'PageNumber',
'in' => 'formData',
'schema' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'],
],
[
'name' => 'PageSize',
'in' => 'formData',
'schema' => ['description' => '每页大小,最大值为100。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'],
],
[
'name' => 'Filters',
'in' => 'formData',
'style' => 'repeatList',
'schema' => [
'description' => '筛选条件。'."\n"
."\n"
.'> 仅支持RDS MySQL、RDS PostgreSQL、PolarDB MySQL版、PolarDB PostgreSQL版、PolarDB PostgreSQL版(兼容Oracle)的错误日志筛选。',
'type' => 'array',
'items' => [
'description' => '筛选条件。',
'type' => 'object',
'properties' => [
'Key' => ['title' => '过滤参数', 'description' => '筛选参数,需填写为filters。', 'type' => 'string', 'required' => false, 'example' => 'filters'],
'Value' => ['description' => '筛选的错误日志内容。', 'type' => 'string', 'required' => false, 'example' => 'deadlock'."\n"],
],
'required' => false,
],
'required' => false,
'maxItems' => 100,
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => '返回数据。',
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求 ID。', 'type' => 'string', 'example' => 'AAA17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'true'],
'Data' => [
'title' => 'ListResult',
'description' => '数据详情。',
'type' => 'object',
'properties' => [
'ItemsNumbers' => ['description' => '当前返回的日志明细总数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'StartTime' => ['description' => '查询开始时间,格式为yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。', 'type' => 'string', 'example' => '2025-07-22T05:48:43Z'],
'EndTime' => ['description' => '查询结束时间,格式为yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。', 'type' => 'string', 'example' => '2025-07-23T05:48:43Z'],
'TotalRecords' => ['description' => '查询时间范围内的日志明细总数。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'],
'PageNumbers' => ['description' => '当前查询的页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'],
'MaxRecordsPerPage' => ['description' => '每页显示的最大记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'],
'Logs' => [
'description' => '日志明细。',
'type' => 'array',
'items' => [
'description' => '日志明细。',
'type' => 'object',
'properties' => [
'CreateTime' => ['description' => '错误日志生成时间。格式为Unix时间戳,单位为毫秒。'."\n"
."\n"
.'>对于云数据库MongoDB版实例,格式为yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。>', 'type' => 'string', 'example' => '1731983067000'],
'DBInstanceName' => ['description' => '节点ID。'."\n"
."\n"
.'> 仅云数据库MongoDB版实例支持。', 'type' => 'string', 'example' => 'd-bp128a003436****'."\n"],
'Category' => ['description' => '日志类别,取值:'."\n"
.'- **NETWORK**:网络连接日志。'."\n"
.'- **ACCESS**:访问控制日志。'."\n"
.'- **-**:普通日志。'."\n"
.'- **COMMAND**:慢日志。'."\n"
.'- **SHARDING**:集群日志。'."\n"
.'- **STORAGE**:存储引擎日志。'."\n"
.'- **CONNPOOL**:连接池日志。'."\n"
.'- **ASIO**:异步 IO 日志。'."\n"
.'- **WRITE**:慢更新日志。'."\n"
."\n"
.'> 仅云数据库 MongoDB 版实例支持。', 'type' => 'string', 'example' => 'NETWORK'],
'ConnInfo' => ['description' => '日志连接信息。'."\n"
."\n"
.'> 仅云数据库MongoDB版实例支持。', 'type' => 'string', 'example' => 'conn18xxxxxx'],
'Content' => ['description' => '错误日志。', 'type' => 'string', 'example' => '2025-07-15T15:14:27.175188+08:00 0 [Note] [MY-012468] [InnoDB] Transactions deadlock detected, dumping detailed information.'],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '查询错误日志明细',
'description' => '本接口用于查询实例指定时间范围内的错误日志明细。'."\n"
."\n"
.'使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 目标数据库引擎为:RDS MySQL、RDS PostgreSQL、PolarDB MySQL 版、PolarDB PostgreSQL 版、PolarDB PostgreSQL版(兼容Oracle)、云数据库 MongoDB 版。'."\n"
.'- 使用阿里云或 DAS 的 SDK 时,建议使用最新版本。'."\n"
.'- 使用 SDK 调用 DAS 服务时,需要将地域指定为 cn-shanghai。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [],
],
'ramActions' => [
[
'operationType' => 'none',
'ramAction' => [
'action' => 'hdm:DescribeErrorLogRecords',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"AAA17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"ItemsNumbers\\": 10,\\n \\"StartTime\\": \\"2025-07-22T05:48:43Z\\",\\n \\"EndTime\\": \\"2025-07-23T05:48:43Z\\",\\n \\"TotalRecords\\": 100,\\n \\"PageNumbers\\": 1,\\n \\"MaxRecordsPerPage\\": 10,\\n \\"Logs\\": [\\n {\\n \\"CreateTime\\": \\"1731983067000\\",\\n \\"DBInstanceName\\": \\"d-bp128a003436****\\\\n\\",\\n \\"Category\\": \\"NETWORK\\",\\n \\"ConnInfo\\": \\"conn18xxxxxx\\",\\n \\"Content\\": \\"2025-07-15T15:14:27.175188+08:00 0 [Note] [MY-012468] [InnoDB] Transactions deadlock detected, dumping detailed information.\\"\\n }\\n ]\\n }\\n}","type":"json"}]',
],
'DescribeHotBigKeys' => [
'summary' => '调用DescribeHotBigKeys接口,实时获取当前内存中的热Key和大Key。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => ['FEATUREhdmROFBLE'],
],
'parameters' => [
[
'name' => 'ConsoleContext',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => 'Redis实例ID。', 'type' => 'string', 'required' => true, 'example' => 'r-bp18ff4a195d****'],
],
[
'name' => 'NodeId',
'in' => 'query',
'schema' => ['description' => 'Redis实例的数据分片ID。', 'type' => 'string', 'required' => false, 'example' => 'r-****-db-0'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Message' => ['description' => '请求返回消息。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Data' => [
'description' => '详情信息列表。',
'type' => 'object',
'properties' => [
'HotKeys' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'HotKey' => [
'description' => '按QPS统计的热Key列表。',
'type' => 'array',
'items' => [
'description' => '按QPS统计的热Key列表。',
'type' => 'object',
'properties' => [
'Key' => ['description' => '具体的Key。', 'type' => 'string', 'example' => 'abc:def:eng'],
'Db' => ['description' => 'Key所在的DB。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'Hot' => ['description' => 'Key的访问频次,即Key的每秒访问数。', 'type' => 'string', 'example' => '5500~6000'],
'KeyType' => ['description' => 'Key的类型。', 'type' => 'string', 'example' => 'zset'],
'Lfu' => ['description' => 'LFU算法的统计值。', 'type' => 'integer', 'format' => 'int32', 'example' => '253'],
'NodeId' => ['description' => 'Redis实例的数据分片ID。', 'type' => 'string', 'example' => 'r-x****-db-0'],
'Size' => ['description' => '元素的个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '2'],
],
],
],
],
'description' => '',
],
'BigKeys' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BigKey' => [
'description' => '按子元素数量统计的大Key列表。',
'type' => 'array',
'items' => [
'description' => '按子元素数量统计的大Key列表。',
'type' => 'object',
'properties' => [
'Db' => ['description' => 'Key所在的DB。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'Key' => ['description' => '具体的Key。', 'type' => 'string', 'example' => 'abc:def:eng'],
'KeyType' => ['description' => 'Key类型。', 'type' => 'string', 'example' => 'zset'],
'Size' => ['description' => '元素的个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '2'],
'NodeId' => ['description' => 'Redis实例的数据分片ID。', 'type' => 'string', 'example' => 'r-x****-db-0'],
],
],
],
],
'description' => '',
],
'HotKeyMsg' => ['description' => '获取按QPS统计的热Key失败的原因。', 'type' => 'string', 'example' => 'current version doesn\'t support'],
'BigKeyMsg' => ['description' => '获取按子元素数量统计的大Key失败的原因。', 'type' => 'string', 'example' => 'current version doesn\'t support'],
'HighTrafficKeyMsg' => ['description' => '获取按流量统计的热Key失败的原因。', 'type' => 'string', 'example' => 'current version doesn\'t support'],
'HighTrafficKeys' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'HighTrafficKey' => [
'description' => '按流量统计的热Key列表。',
'type' => 'array',
'items' => [
'description' => '按流量统计的热Key列表。',
'type' => 'object',
'properties' => [
'Key' => ['description' => '具体的Key。', 'type' => 'string', 'example' => 'abc:def:eng'],
'Db' => ['description' => 'Key所在的DB。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'Hot' => ['description' => 'Key的访问频次,即Key的每秒访问数。', 'type' => 'string', 'example' => '1988'],
'KeyType' => ['description' => 'Key的类型。', 'type' => 'string', 'example' => 'string'],
'NodeId' => ['description' => '节点ID。', 'type' => 'string', 'example' => 'r-x****-db-0'."\n"],
'inBytes' => ['description' => '入流量,单位:Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '85767'],
'outBytes' => ['description' => '出流量,单位:Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1054684'],
'Size' => ['description' => '元素的个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '2'],
],
],
],
],
'description' => '',
],
'LargeKeys' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'LargeKey' => [
'description' => '按内存占用统计的大Key列表。',
'type' => 'array',
'items' => [
'description' => '按内存占用统计的大Key列表。',
'type' => 'object',
'properties' => [
'Db' => ['description' => 'Key所在的DB。', 'type' => 'string', 'example' => '0'],
'Key' => ['description' => '具体的Key。', 'type' => 'string', 'example' => 'abc:def:eng'],
'KeyType' => ['description' => 'Key的类型。', 'type' => 'string', 'example' => 'string'],
'DataSize' => ['description' => 'Key的内存占用,单位:Byte。', 'type' => 'string', 'example' => '33554439'],
'NodeId' => ['description' => '节点ID。', 'type' => 'string', 'example' => 'r-x****-db-0'],
],
],
],
],
'description' => '',
],
'LargeKeyMsg' => ['description' => '获取按内存占用统计的大Key失败的原因。', 'type' => 'string', 'example' => 'current version doesn\'t support'],
],
],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Data\\": {\\n \\"HotKeys\\": {\\n \\"HotKey\\": [\\n {\\n \\"Key\\": \\"abc:def:eng\\",\\n \\"Db\\": 0,\\n \\"Hot\\": \\"5500~6000\\",\\n \\"KeyType\\": \\"zset\\",\\n \\"Lfu\\": 253,\\n \\"NodeId\\": \\"r-x****-db-0\\",\\n \\"Size\\": 2\\n }\\n ]\\n },\\n \\"BigKeys\\": {\\n \\"BigKey\\": [\\n {\\n \\"Db\\": 0,\\n \\"Key\\": \\"abc:def:eng\\",\\n \\"KeyType\\": \\"zset\\",\\n \\"Size\\": 2,\\n \\"NodeId\\": \\"r-x****-db-0\\"\\n }\\n ]\\n },\\n \\"HotKeyMsg\\": \\"current version doesn\'t support\\",\\n \\"BigKeyMsg\\": \\"current version doesn\'t support\\",\\n \\"HighTrafficKeyMsg\\": \\"current version doesn\'t support\\",\\n \\"HighTrafficKeys\\": {\\n \\"HighTrafficKey\\": [\\n {\\n \\"Key\\": \\"abc:def:eng\\",\\n \\"Db\\": 0,\\n \\"Hot\\": \\"1988\\",\\n \\"KeyType\\": \\"string\\",\\n \\"NodeId\\": \\"r-x****-db-0\\\\n\\",\\n \\"inBytes\\": 85767,\\n \\"outBytes\\": 1054684,\\n \\"Size\\": 2\\n }\\n ]\\n },\\n \\"LargeKeys\\": {\\n \\"LargeKey\\": [\\n {\\n \\"Db\\": \\"0\\",\\n \\"Key\\": \\"abc:def:eng\\",\\n \\"KeyType\\": \\"string\\",\\n \\"DataSize\\": \\"33554439\\",\\n \\"NodeId\\": \\"r-x****-db-0\\"\\n }\\n ]\\n },\\n \\"LargeKeyMsg\\": \\"current version doesn\'t support\\"\\n },\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n \\n \\n abc:def:eng\\n 0\\n 5500~6000\\n zset\\n 253\\n r-x****-db-0\\n \\n \\n 0\\n abc:def:eng\\n zset\\n 2\\n r-x****-db-0\\n \\n current version doesn\'t support\\n current version doesn\'t support\\n \\n 200\\n true\\n","errorExample":""}]',
'title' => '实时获取当前热Key和大Key',
'description' => '对数据结构为List、Hash、Set、Zset的Key,按照Key中元素的数量排序并展示排名前3的Key,记录为大Key。如果某个Key的QPS大于5,000,会被记录为热点Key。关于大Key和热点Key的具体定义,请参见[Top Key统计](https://help.aliyun.com/zh/das/user-guide/key-analysis)。'."\n"
.'>'."\n"
.'> - 在Redis开源版7.0.18、6.0.2.9、5.5.2.9及更早版本的实例,或Tair内存型5.0.50、25.2.0.0版本及更早版本的实例中,QPS大于3,000的Key即会被记录为热点Key,且该阈值不支持调整。'."\n"
."\n"
.'- 在使用阿里云SDK时,需要保证aliyun-sdk-core的版本大于4.3.3,建议使用最新版本。'."\n"
.'- 使用DAS的SDK的版本为1.0.2或以上。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 本接口只适用于如下Redis实例:'."\n"
.' - 实例为Redis开源版或Tair(企业版)内存型。'."\n"
.' - 实例的小版本为最新。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeHotBigKeys'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeHotBigKeys',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'DescribeHotKeys' => [
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => 'Redis实例ID。', 'type' => 'string', 'required' => true, 'example' => 'r-bp18ff4a195d****'],
],
[
'name' => 'NodeId',
'in' => 'query',
'schema' => ['description' => 'Redis实例的数据分片ID。', 'type' => 'string', 'required' => false, 'example' => 'r-x****-db-0'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Data' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'HotKey' => [
'description' => '详细信息列表。',
'type' => 'array',
'items' => [
'description' => '结果集。',
'type' => 'object',
'properties' => [
'Key' => ['description' => '具体的Key。', 'type' => 'string', 'example' => 'abc:def:eng'],
'Db' => ['description' => 'Key所在的DB。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'Hot' => ['description' => 'Key的访问频次,即Key的每秒访问数。', 'type' => 'string', 'example' => '5500~6000'],
'KeyType' => ['description' => 'Key的类型。', 'type' => 'string', 'example' => 'zset'],
'Size' => ['description' => '元素的个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '2'],
'InBytes' => ['description' => '入流量,单位Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '85766'],
'OutBytes' => ['description' => '出流量,单位Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '1054688'],
'NodeId' => ['description' => '节点id。', 'type' => 'string', 'example' => 'r-x****-db-0'],
'Category' => ['description' => '热Key类别:'."\n"
.'- **qps**:按QPS统计的热Key。'."\n"
.'- **traffic**:按流量统计的热Key。', 'type' => 'string', 'example' => 'qps'],
],
],
],
],
'description' => '',
],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '查询实例当前的热Key',
'summary' => '调用DescribeHotKeys接口,查询Redis实例的热Key。',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 在使用阿里云SDK时,需要保证aliyun-sdk-core的版本大于4.3.3,建议使用最新版本。'."\n"
.'- 使用DAS的SDK的版本为1.0.2或以上。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 本接口只适用于如下Redis实例:'."\n"
.' - 实例为Redis开源版或Tair(企业版)内存型。'."\n"
.' - 实例的小版本为最新。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeHotKeys'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeHotKeys',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Data\\": {\\n \\"HotKey\\": [\\n {\\n \\"Key\\": \\"abc:def:eng\\",\\n \\"Db\\": 0,\\n \\"Hot\\": \\"5500~6000\\",\\n \\"KeyType\\": \\"zset\\",\\n \\"Size\\": 2,\\n \\"InBytes\\": 85766,\\n \\"OutBytes\\": 1054688,\\n \\"NodeId\\": \\"r-x****-db-0\\",\\n \\"Category\\": \\"qps\\"\\n }\\n ]\\n },\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n \\n abc:def:eng\\n 0\\n 5500~6000\\n zset\\n 2\\n \\n 200\\n true\\n","errorExample":""}]',
],
'DescribeInstanceDasPro' => [
'methods' => ['post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => ['FEATUREhdm543Z01'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '数据库实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '9CB97BC4-6479-55D0-B9D0-EA925AFE****'],
'Data' => ['description' => '数据库实例是否开启了DAS企业版:'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '查询是否开启了DAS企业版 V1或V2',
'summary' => '调用DescribeInstanceDasPro接口,查询指定数据库实例是否开启了DAS企业版 V1或企业版 V2。',
'description' => '- 目前支持的数据库实例请参见[DAS企业版使用说明](~~190912~~)。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 该接口仅适用于DAS企业版 V1、V2。'."\n"
.'>推荐使用[DescribeSqlLogConfig](~~2778837~~)接口,查询数据库实例的DAS企业版配置信息。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeInstanceDasPro'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeInstanceDasPro',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"9CB97BC4-6479-55D0-B9D0-EA925AFE****\\",\\n \\"Data\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n Successful\\n 9CB97BC4-6479-55D0-B9D0-EA925AFE****\\n true\\n 200\\n true\\n","errorExample":""}]',
],
'DescribeQueryExplain' => [
'path' => '',
'methods' => ['post', 'get'],
'schemes' => ['https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => ['FEATUREhdmI71917'],
'tenantRelevance' => 'tenant',
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
[
'name' => 'NodeId',
'in' => 'formData',
'schema' => ['description' => '节点ID。'."\n"
."\n"
.'> 对于PolarDB MySQL版实例,若提供节点ID,将到指定节点查询执行计划,否则将在备节点查询执行计划。'."\n"
.'> 对于RDS MySQL高可用实例,若将实例ID传入,将到指定节点查询执行计划,否则将在备节点查询执行计划。', 'type' => 'string', 'required' => false, 'example' => 'pi-bp1v203xzzh0a****'],
],
[
'name' => 'Sql',
'in' => 'formData',
'schema' => ['description' => '待查询执行计划的SQL。', 'type' => 'string', 'required' => true, 'example' => 'select * from test where name = \'mockUser\''],
],
[
'name' => 'DbName',
'in' => 'formData',
'schema' => ['description' => '数据库名。', 'type' => 'string', 'required' => false, 'example' => 'dbtest01'],
],
[
'name' => 'Schema',
'in' => 'formData',
'schema' => ['description' => 'schema信息,预留参数。', 'type' => 'string', 'required' => false, 'example' => '无'],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码,200表示成功。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'title' => 'List',
'description' => 'List',
'type' => 'array',
'items' => [
'description' => '返回数据。',
'type' => 'object',
'properties' => [
'Id' => ['description' => '查询ID。', 'type' => 'string', 'example' => '1'],
'SelectType' => ['description' => '查询类型。', 'type' => 'string', 'example' => 'SIMPLE'],
'Table' => ['description' => '表名。', 'type' => 'string', 'example' => 'test'],
'Type' => ['description' => 'Join类型。', 'type' => 'string', 'example' => 'eq_ref'],
'PossibleKeys' => ['description' => '可能被选择的索引。', 'type' => 'string', 'example' => 'test_idx'],
'Key' => ['description' => '执行计划中,实际选择的索引。', 'type' => 'string', 'example' => 'PRIMARY'],
'KeyLen' => ['description' => '实际选择索引的长度。', 'type' => 'string', 'example' => '3'],
'Ref' => ['description' => '索引所用的列。', 'type' => 'string', 'example' => 'test_column'],
'Rows' => ['description' => '待扫描行数。', 'type' => 'string', 'example' => '1000'],
'Extra' => ['description' => '附加信息。', 'type' => 'string', 'example' => '无'],
'QueryPlan' => ['title' => 'QUEYR_PLAN展示用', 'description' => '保留字段,用于PG引擎。', 'type' => 'string', 'example' => '无'],
'TableList' => [
'title' => 'queryPlan中用到的表名',
'description' => '保留字段,用于PG引擎。',
'type' => 'array',
'items' => ['description' => '保留字段,用于PG引擎。', 'type' => 'string', 'example' => '无'],
],
'IndexList' => [
'title' => 'queryPlan中用到的索引名',
'description' => '保留字段,用于PG引擎。',
'type' => 'array',
'items' => ['description' => '保留字段,用于PG引擎。', 'type' => 'string', 'example' => '无'],
],
'LogicalPlanList' => [
'description' => '保留字段,用于PolarDB X引擎。',
'type' => 'array',
'items' => ['description' => '保留字段,用于PolarDB X引擎。', 'type' => 'string', 'example' => '无'],
],
'StmtText' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'StmtId' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'NodeId' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'Parent' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'PhysicalOp' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'LogicalOp' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'Argument' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'DefinedValues' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'EstimateRows' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'EstimateIO' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'EstimateCPU' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'AvgRowSize' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'TotalSubtreeCost' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'OutputList' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'Warnings' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'Parallel' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
'EstimateExecutions' => ['description' => '保留字段,用于SQLServer引擎。', 'type' => 'string', 'example' => '无'],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '查询SQL执行计划',
'summary' => '查询SQL的执行计划。',
'description' => '- 当前仅支持RDS MySQL和PolarDB MySQL实例查询SQL的执行计划。'."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeQueryExplain',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": [\\n {\\n \\"Id\\": \\"1\\",\\n \\"SelectType\\": \\"SIMPLE\\",\\n \\"Table\\": \\"test\\",\\n \\"Type\\": \\"eq_ref\\",\\n \\"PossibleKeys\\": \\"test_idx\\",\\n \\"Key\\": \\"PRIMARY\\",\\n \\"KeyLen\\": \\"3\\",\\n \\"Ref\\": \\"test_column\\",\\n \\"Rows\\": \\"1000\\",\\n \\"Extra\\": \\"无\\",\\n \\"QueryPlan\\": \\"无\\",\\n \\"TableList\\": [\\n \\"无\\"\\n ],\\n \\"IndexList\\": [\\n \\"无\\"\\n ],\\n \\"LogicalPlanList\\": [\\n \\"无\\"\\n ],\\n \\"StmtText\\": \\"无\\",\\n \\"StmtId\\": \\"无\\",\\n \\"NodeId\\": \\"无\\",\\n \\"Parent\\": \\"无\\",\\n \\"PhysicalOp\\": \\"无\\",\\n \\"LogicalOp\\": \\"无\\",\\n \\"Argument\\": \\"无\\",\\n \\"DefinedValues\\": \\"无\\",\\n \\"EstimateRows\\": \\"无\\",\\n \\"EstimateIO\\": \\"无\\",\\n \\"EstimateCPU\\": \\"无\\",\\n \\"AvgRowSize\\": \\"无\\",\\n \\"TotalSubtreeCost\\": \\"无\\",\\n \\"OutputList\\": \\"无\\",\\n \\"Warnings\\": \\"无\\",\\n \\"Parallel\\": \\"无\\",\\n \\"EstimateExecutions\\": \\"无\\"\\n }\\n ]\\n}","type":"json"}]',
],
'DescribeSecurityIPGroup' => [
'summary' => '展示用户跨产品白名单模板具体信息',
'path' => '',
'methods' => ['post', 'get'],
'schemes' => ['https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '247410',
'abilityTreeNodes' => ['FEATUREhdmQULC0I'],
'tenantRelevance' => 'tenant',
],
'parameters' => [
[
'name' => 'RegionName',
'in' => 'query',
'allowEmptyValue' => false,
'schema' => ['description' => '地域 ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-shanghai'],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Data' => [
'title' => 'ListResult',
'description' => 'ListResult',
'type' => 'object',
'properties' => [
'SecurityIpGroups' => [
'description' => '用户在该region下的所有跨产品白名单模板列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DbInstances' => [
'description' => '该跨产品白名单模板所绑定的数据库实例列表。',
'type' => 'array',
'items' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => '["r-2ze9g6mnhu1***",'."\n"
.'"pc-2zew5qn1m***",'."\n"
.'"r-2ze9g6mn****",'."\n"
.'"pc-2zew5qh41*****"]'],
],
'SecurityIpType' => ['description' => 'ip类型', 'type' => 'string', 'example' => 'ipv4'],
'Uid' => ['description' => '账号ID,您可在阿里云**账号管理**的**安全设置**页面获取**登录账号**的ID。', 'type' => 'string', 'example' => '160-79abe3f4****'],
'RegionId' => ['description' => '地域 ID。', 'type' => 'string', 'example' => 'cn-hangzhou'],
'GEcsSgIdList' => ['description' => 'ECS 安全组ID,已无效,是冗余数据,待下线', 'type' => 'string', 'example' => ' null'],
'GlobalIgName' => ['description' => 'IP白名单模板名称。IP白名单模板名称需满足如下要求:'."\n"
."\n"
.'- 由小写字母、数字、下划线(_)组成。'."\n"
."\n"
.'- 由字母开头、字母或数字结尾。'."\n"
."\n"
.'- 长度为2~120个字符。', 'type' => 'string', 'example' => 'test_123'],
'GlobalSecurityGroupId' => ['description' => 'IP白名单模板ID。', 'type' => 'string', 'example' => 'g-1no2rzybnqcv****'],
'WhitelistNetType' => ['description' => '白名单的网络类型。', 'type' => 'string', 'example' => 'mix'],
'EngineInfoList' => [
'description' => '该模板所绑定的各产品下的实例信息',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'InstanceNum' => ['description' => '当前登录账号包含的实例数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'],
'EngineName' => ['description' => '目标实例的数据库类型。', 'type' => 'string', 'example' => 'PolarDBMySQL'],
'InstanceIds' => [
'description' => '数据库实例ID列表。',
'type' => 'array',
'items' => ['description' => '数据库实例ID。'."\n"
."\n"
.'> 数据格式为JSONArray,例如`[\'实例ID1\',\'实例ID2\']`,实例ID间用英文逗号(,)分隔。', 'type' => 'string', 'example' => 'rm-2ze8ygcc****'],
],
],
'description' => '',
],
],
'UserId' => ['description' => '用户id', 'type' => 'string', 'example' => '641***'],
'GIpList' => ['description' => '白名单模板内的IP地址。'."\n"
.'> 多个IP地址需要用英文逗号(,)分隔。', 'type' => 'string', 'example' => '192.168.1.28/32'],
],
'description' => '',
],
],
],
],
'Message' => ['description' => '请求返回的消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'CAC553F1-C669-53F1-A295-2CF050E****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '跨产品白名单模板展示接口',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeSecurityIPGroup',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Data\\": {\\n \\"SecurityIpGroups\\": [\\n {\\n \\"DbInstances\\": [\\n \\"[\\\\\\"r-2ze9g6mnhu1***\\\\\\",\\\\n\\\\\\"pc-2zew5qn1m***\\\\\\",\\\\n\\\\\\"r-2ze9g6mn****\\\\\\",\\\\n\\\\\\"pc-2zew5qh41*****\\\\\\"]\\"\\n ],\\n \\"SecurityIpType\\": \\"ipv4\\",\\n \\"Uid\\": \\"160-79abe3f4****\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"GEcsSgIdList\\": \\" null\\",\\n \\"GlobalIgName\\": \\"test_123\\",\\n \\"GlobalSecurityGroupId\\": \\"g-1no2rzybnqcv****\\",\\n \\"WhitelistNetType\\": \\"mix\\",\\n \\"EngineInfoList\\": [\\n {\\n \\"InstanceNum\\": 10,\\n \\"EngineName\\": \\"PolarDBMySQL\\",\\n \\"InstanceIds\\": [\\n \\"rm-2ze8ygcc****\\"\\n ]\\n }\\n ],\\n \\"UserId\\": \\"641***\\",\\n \\"GIpList\\": \\"192.168.1.28/32\\"\\n }\\n ]\\n },\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"CAC553F1-C669-53F1-A295-2CF050E****\\",\\n \\"Success\\": \\"true\\"\\n}","type":"json"}]',
],
'DescribeSecurityIPGroupRelation' => [
'path' => '',
'methods' => ['post', 'get'],
'schemes' => ['https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '247410',
'abilityTreeNodes' => ['FEATUREhdmQULC0I'],
'tenantRelevance' => 'tenant',
],
'parameters' => [
[
'name' => 'RegionName',
'in' => 'query',
'allowEmptyValue' => false,
'schema' => ['description' => '地域 ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-shanghai'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2zegsc57ofexxxxx'],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Data' => [
'title' => 'ListResult',
'description' => 'ListResult',
'type' => 'object',
'properties' => [
'GlobalSecurityIPGroupRel' => [
'description' => '全局IP白名单模板信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'RegionId' => ['description' => '地域 ID。', 'type' => 'string', 'example' => 'cn-shenzhen'],
'GlobalIgName' => ['description' => 'IP白名单模板名称。', 'type' => 'string', 'example' => 'test2'],
'GlobalSecurityGroupId' => ['description' => 'IP白名单模板ID。', 'type' => 'string', 'example' => 'g-1no2rzybnqcv0xxxxxx'],
'GIpList' => ['description' => '白名单模板内的IP地址。'."\n"
."\n"
.'> 多个IP地址需要用英文逗号隔开,所有IP白名单累积支持添加1000个IP地址或地址段。', 'type' => 'string', 'example' => '192.168.1.28/32'],
],
'description' => '',
],
],
'InstanceId' => ['description' => '实例ID。', 'type' => 'string', 'example' => 'rm-2ze1jdv45i7l6****'],
],
],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A6D1C8EE-013C-541F-83EB-B13C8xxxxxx'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'summary' => '展示用户跨产品白名单模板与实例绑定信息',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'title' => '跨产品白名单模板绑定信息展示接口',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeSecurityIPGroupRelation',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Data\\": {\\n \\"GlobalSecurityIPGroupRel\\": [\\n {\\n \\"RegionId\\": \\"cn-shenzhen\\",\\n \\"GlobalIgName\\": \\"test2\\",\\n \\"GlobalSecurityGroupId\\": \\"g-1no2rzybnqcv0xxxxxx\\",\\n \\"GIpList\\": \\"192.168.1.28/32\\"\\n }\\n ],\\n \\"InstanceId\\": \\"rm-2ze1jdv45i7l6****\\"\\n },\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"A6D1C8EE-013C-541F-83EB-B13C8xxxxxx\\",\\n \\"Success\\": \\"true\\"\\n}","type":"json"}]',
],
'DescribeSlowLogHistogramAsync' => [
'summary' => '异步获取实例慢日志趋势数据。',
'methods' => ['post', 'get'],
'schemes' => ['https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '236527',
'abilityTreeNodes' => ['FEATUREhdmR88NLD'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['description' => '数据库实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'."\n"],
],
[
'name' => 'NodeId',
'in' => 'formData',
'schema' => ['description' => '节点ID。'."\n"
.'> 对于PolarDB MySQL版实例,需要提供节点ID。', 'type' => 'string', 'required' => false, 'example' => 'r-****-db-0'],
],
[
'name' => 'StartTime',
'in' => 'formData',
'schema' => ['description' => '查询任务开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1596177993000'],
],
[
'name' => 'EndTime',
'in' => 'formData',
'schema' => ['description' => '查询结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
.'> 查询结束时间需晚于任务开始时间。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1662518540764'],
],
[
'name' => 'Filters',
'in' => 'formData',
'style' => 'repeatList',
'schema' => [
'description' => '查询筛选条件列表。',
'type' => 'array',
'items' => [
'description' => 'Key支持的参数和取值:'."\n"
."\n"
.'hostAddress:来源,多个逗号分隔。'."\n"
."\n"
.'sqlId:sqlId,多个逗号分隔。'."\n"
."\n"
.'user:用户,多个逗号分隔。'."\n"
."\n"
.'dbName:数据库,多个逗号分隔。',
'type' => 'object',
'properties' => [
'Key' => ['title' => '过滤参数', 'description' => '过滤参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
'Value' => ['description' => '过滤参数的值。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
'required' => false,
],
'required' => false,
'maxItems' => 100,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'title' => 'AsyncResult',
'description' => 'AsyncResult。',
'type' => 'object',
'properties' => [
'RequestKey' => ['title' => '请求参数的Key', 'description' => '请求参数的Key。', 'type' => 'string', 'example' => '无'],
'ResultId' => ['title' => '结果ID', 'description' => '结果ID。', 'type' => 'string', 'example' => 'async__20ee808e72257f16a4fe024057ca****'],
'State' => ['title' => '当前状态 (RUNNING: 正在运行, SUCCESS: 成功, FAIL: 失败)', 'description' => '当前状态:'."\n"
.'- **RUNNING**:正在运行。'."\n"
.'- **SUCCESS**:成功。'."\n"
.'- **FAIL**:失败。', 'type' => 'string', 'example' => 'SUCCESS'],
'IsFinish' => ['title' => '是否完成', 'description' => '是否完成。', 'type' => 'boolean', 'example' => 'true'],
'Data' => [
'title' => '数据',
'description' => '数据。',
'type' => 'object',
'properties' => [
'Total' => ['description' => '查询的总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'Count' => [
'description' => '慢日志数量趋势。',
'type' => 'array',
'items' => ['description' => '慢日志个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'],
],
'Ts' => [
'title' => '关系型数据库只使用这个',
'description' => '关系型数据库只使用这个。',
'type' => 'array',
'items' => ['description' => '第一个事件发生的时间,使用UNIX时间戳表示,单位:毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 1735098480000,'."\n"
.' 1735098540000,'."\n"
.' 1735098600000,'."\n"
.' 1735098660000,'."\n"
.' 1735098720000,'."\n"
.' 1735098780000'."\n"
.' ]'],
],
'TsEnd' => [
'description' => '无用,预留字段。',
'type' => 'array',
'items' => ['description' => '查询结束时间戳。'."\n"
."\n", 'type' => 'integer', 'format' => 'int64', 'example' => '暂无'],
],
'Item' => [
'description' => '趋势指标。',
'type' => 'array',
'items' => [
'description' => '具体项目名称。',
'type' => 'object',
'properties' => [
'NodeId' => ['description' => '节点ID。', 'type' => 'string', 'example' => 'r-bp1hi0wg57s3n0i3n8-db-0'],
'Count' => [
'description' => '慢日志数量。',
'type' => 'array',
'items' => ['description' => '慢日志数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'],
],
'InsItems' => [
'description' => '趋势指标。'."\n"
.'>仅云数据库MongoDB版实例支持。',
'type' => 'array',
'items' => [
'description' => '趋势指标。'."\n"
.'>仅云数据库MongoDB版实例支持。',
'type' => 'object',
'properties' => [
'InsId' => ['description' => '实例角色ID。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'string', 'example' => '2492'],
'InsRole' => ['description' => '实例角色。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'string', 'example' => 'userAdmin'],
'Count' => [
'description' => '执行次数。',
'type' => 'array',
'items' => ['description' => '执行次数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
],
'TotalCount' => ['description' => '物理节点的慢日志数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
],
],
],
'TotalCount' => ['description' => '总的慢日志数。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'],
'InsRole' => ['description' => '实例角色。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'string'],
],
],
],
'Rt' => [
'description' => '总执行耗时,单位为秒。',
'type' => 'array',
'items' => ['description' => '总执行耗时,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 2.306,'."\n"
.' 1.141,'."\n"
.' 0.0,'."\n"
.' 4.538,'."\n"
.' 1.247,'."\n"
.' 1.972'."\n"
.' ]'],
],
'AvgRt' => [
'description' => '平均执行耗时。',
'type' => 'array',
'items' => ['description' => '平均执行耗时。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 1.593,'."\n"
.' 2.306,'."\n"
.' 1.141,'."\n"
.' 0.0,'."\n"
.' 1.5127,'."\n"
.' 1.247'."\n"
.' ]'],
],
'MaxRt' => [
'description' => '最大执行耗时,单位秒。',
'type' => 'array',
'items' => ['description' => '最大执行耗时,单位秒。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 1.593,'."\n"
.' 2.306,'."\n"
.' 1.141,'."\n"
.' 14.115'."\n"
.' 0.0,'."\n"
.' 1.972'."\n"
.' ]'],
],
'LockTime' => [
'description' => '总锁等待时间,单位秒。',
'type' => 'array',
'items' => ['description' => '总锁等待时间,单位秒。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 1.051,'."\n"
.' 1.007,'."\n"
.' 0.0,'."\n"
.' 0.755,'."\n"
.' 0.096,'."\n"
.' 0.0'."\n"
.' ]'],
],
'AvgLockTime' => [
'description' => '平均锁等待时间,单位为秒。',
'type' => 'array',
'items' => ['description' => '平均锁等待时间,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 1.051,'."\n"
.' 0.0,'."\n"
.' 0.3357,'."\n"
.' 0.755,'."\n"
.' 0.324,'."\n"
.' 0.814'."\n"
.' ]'],
],
'MaxLockTime' => [
'description' => '最大锁等待时间,单位为秒。',
'type' => 'array',
'items' => ['description' => '最大锁等待时间,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 1.051,'."\n"
.' 1.007,'."\n"
.' 0.755,'."\n"
.' 0.0,'."\n"
.' 0.05,'."\n"
.' 0.656'."\n"
.' ]'],
],
'RowsExamined' => [
'description' => '总扫描行数。'."\n"
.'> 目前支持该字段的数据库:云数据库RDS MySQL版、云数据库RDS PostgreSQL版、云原生数据库PolarDB MySQL版。',
'type' => 'array',
'items' => ['description' => '总扫描行数。'."\n"
.'> 目前支持该字段的数据库:云数据库RDS MySQL版、云数据库RDS PostgreSQL版、云原生数据库PolarDB MySQL版。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 256,'."\n"
.' 1,'."\n"
.' 512,'."\n"
.' 0,'."\n"
.' 1476678,'."\n"
.' 24430'."\n"
.' ]'],
],
'AvgRowsExamined' => [
'description' => '平均扫描行数。',
'type' => 'array',
'items' => ['description' => '平均扫描行数。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 256.0,'."\n"
.' 256.3333,'."\n"
.' 512.0,'."\n"
.' 370860.1111,'."\n"
.' 0.0,'."\n"
.' 1.0'."\n"
.' ]'],
],
'MaxRowsExamined' => [
'description' => '最大扫描行数。',
'type' => 'array',
'items' => ['description' => '最大扫描行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 256,'."\n"
.' 1,'."\n"
.' 512,'."\n"
.' 0,'."\n"
.' 1476678,'."\n"
.' 24430'."\n"
.' ]'],
],
'RowsSent' => [
'description' => '返回行数。',
'type' => 'array',
'items' => ['description' => '返回行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 384,'."\n"
.' 256,'."\n"
.' 0,'."\n"
.' 207030,'."\n"
.' 4,'."\n"
.' 256'."\n"
.' ]'],
],
'AvgRowsSent' => [
'description' => '平均返回行数。',
'type' => 'array',
'items' => ['description' => '平均返回行数。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 128.0,'."\n"
.' 0.0,'."\n"
.' 256.0,'."\n"
.' 25878.75,'."\n"
.' 192.0,'."\n"
.' 72.7778'."\n"
.' ]'],
],
'MaxRowsSent' => [
'description' => '最大返回行数。',
'type' => 'array',
'items' => ['description' => '最大返回行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 256,'."\n"
.' 207023,'."\n"
.' 0,'."\n"
.' 128,'."\n"
.' 0,'."\n"
.' 0'."\n"
.' ]'],
],
'KeysExamined' => [
'description' => '索引扫描行数。'."\n"
.'>仅云数据库MongoDB版实例支持。',
'type' => 'array',
'items' => ['description' => '索引扫描行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 384,'."\n"
.' 256,'."\n"
.' 0,'."\n"
.' 207030,'."\n"
.' 4,'."\n"
.' 256'."\n"
.' ]'],
],
'AvgKeysExamined' => [
'description' => '平均索引扫描行数。'."\n"
.'>仅云数据库MongoDB版实例支持。',
'type' => 'array',
'items' => ['description' => '平均索引扫描行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 128.0,'."\n"
.' 0.0,'."\n"
.' 256.0,'."\n"
.' 25878.75,'."\n"
.' 192.0,'."\n"
.' 72.7778'."\n"
.' ]'],
],
'MaxKeysExamined' => [
'description' => '最大索引扫描行数。'."\n"
.'>仅云数据库MongoDB版实例支持。',
'type' => 'array',
'items' => ['description' => '最大索引扫描行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 384,'."\n"
.' 256,'."\n"
.' 0,'."\n"
.' 207030,'."\n"
.' 4,'."\n"
.' 256'."\n"
.' ]'],
],
'DocExamined' => [
'description' => '扫描文档行数。'."\n"
.'>仅云数据库MongoDB版实例支持。',
'type' => 'array',
'items' => ['description' => '扫描文档行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 256,'."\n"
.' 207023,'."\n"
.' 0,'."\n"
.' 128,'."\n"
.' 0,'."\n"
.' 0'."\n"
.' ]'],
],
'AvgDocExamined' => [
'description' => '平均扫描文档行数。'."\n"
.'>仅云数据库MongoDB版实例支持。',
'type' => 'array',
'items' => ['description' => '平均扫描文档行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 128.0,'."\n"
.' 0.0,'."\n"
.' 256.0,'."\n"
.' 25878.75,'."\n"
.' 192.0,'."\n"
.' 72.7778'."\n"
.' ]'],
],
'MaxDocExamined' => [
'description' => '最大扫描文档行数。'."\n"
.'>仅云数据库MongoDB版实例支持。',
'type' => 'array',
'items' => ['description' => '最大扫描文档行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 256,'."\n"
.' 207023,'."\n"
.' 0,'."\n"
.' 128,'."\n"
.' 0,'."\n"
.' 0'."\n"
.' ]'],
],
'ReturnNum' => [
'description' => '返回行数。'."\n"
.'>仅云数据库MongoDB版实例支持。',
'type' => 'array',
'items' => ['description' => '返回行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 256,'."\n"
.' 207023,'."\n"
.' 0,'."\n"
.' 128,'."\n"
.' 0,'."\n"
.' 0'."\n"
.' ]'],
],
'AvgReturnNum' => [
'description' => '平均返回行数。'."\n"
.'>仅云数据库MongoDB版实例支持。',
'type' => 'array',
'items' => ['description' => '平均返回行数'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 128.0,'."\n"
.' 0.0,'."\n"
.' 256.0,'."\n"
.' 25878.75,'."\n"
.' 192.0,'."\n"
.' 72.7778'."\n"
.' ]'],
],
'MaxReturnNum' => [
'description' => '最大返回行数。'."\n"
.'>仅云数据库MongoDB版实例支持。',
'type' => 'array',
'items' => ['description' => '最大返回行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 256,'."\n"
.' 207023,'."\n"
.' 0,'."\n"
.' 128,'."\n"
.' 0,'."\n"
.' 0'."\n"
.' ]'],
],
'IOWrites' => [
'description' => 'I/O 写次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => 'I/O 写次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 256,'."\n"
.' 207023,'."\n"
.' 0,'."\n"
.' 128,'."\n"
.' 0,'."\n"
.' 0'."\n"
.' ]'],
],
'AvgIOWrites' => [
'description' => '平均 I/O 写次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '平均 I/O 写次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 384,'."\n"
.' 256,'."\n"
.' 0,'."\n"
.' 207030,'."\n"
.' 4,'."\n"
.' 256'."\n"
.' ]'],
],
'MaxIOWrites' => [
'description' => '最大 I/O 写次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '最大 I/O 写次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 256,'."\n"
.' 1,'."\n"
.' 512,'."\n"
.' 0,'."\n"
.' 1476678,'."\n"
.' 24430'."\n"
.' ]'],
],
'LastRowsCountAffected' => [
'description' => '最后一条语句的影响行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '最后一条语句的影响行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 256,'."\n"
.' 207023,'."\n"
.' 0,'."\n"
.' 128,'."\n"
.' 0,'."\n"
.' 0'."\n"
.' ]'],
],
'AvgLastRowsCountAffected' => [
'description' => '平均最后一条语句的影响行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '平均最后一条语句的影响行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 1.593,'."\n"
.' 2.306,'."\n"
.' 1.141,'."\n"
.' 0.0,'."\n"
.' 1.5127,'."\n"
.' 1.247'."\n"
.' ]'],
],
'MaxLastRowsCountAffected' => [
'description' => '最大最后一条语句的影响行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '平均最后一条语句的影响行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 1,'."\n"
.' 1,'."\n"
.' 3,'."\n"
.' 1,'."\n"
.' 2,'."\n"
.' 3'."\n"
.' ]'],
],
'LogicalIOReads' => [
'description' => '逻辑读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '逻辑读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 384,'."\n"
.' 256,'."\n"
.' 0,'."\n"
.' 207030,'."\n"
.' 4,'."\n"
.' 256'."\n"
.' ]'],
],
'AvgLogicalIOReads' => [
'description' => '平均逻辑读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '平均逻辑读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 1.593,'."\n"
.' 2.306,'."\n"
.' 1.141,'."\n"
.' 0.0,'."\n"
.' 1.5127,'."\n"
.' 1.247'."\n"
.' ]'],
],
'MaxLogicalIOReads' => [
'description' => '最大逻辑读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '最大逻辑读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 124,'."\n"
.' 2,'."\n"
.' 24,'."\n"
.' 251,'."\n"
.' 191,'."\n"
.' 721'."\n"
.' ]'],
],
'PhysicalIOReads' => [
'description' => '物理读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '物理读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 324,'."\n"
.' 22,'."\n"
.' 254,'."\n"
.' 251,'."\n"
.' 191,'."\n"
.' 721'."\n"
.' ]'],
],
'AvgPhysicalIOReads' => [
'description' => '平均物理读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '平均物理读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 128.0,'."\n"
.' 0.0,'."\n"
.' 256.0,'."\n"
.' 25878.75,'."\n"
.' 192.0,'."\n"
.' 72.7778'."\n"
.' ]'],
],
'MaxPhysicalIOReads' => [
'description' => '最大物理读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '最大物理读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 314,'."\n"
.' 242,'."\n"
.' 114,'."\n"
.' 351,'."\n"
.' 191,'."\n"
.' 721'."\n"
.' ]'],
],
'RowsCountAffected' => [
'description' => '影响的行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '影响的行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 34,'."\n"
.' 42,'."\n"
.' 14,'."\n"
.' 51,'."\n"
.' 91,'."\n"
.' 71'."\n"
.' ]'],
],
'AvgRowsCountAffected' => [
'description' => '平均影响的行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '平均影响的行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 1.593,'."\n"
.' 2.306,'."\n"
.' 1.141,'."\n"
.' 14.115,'."\n"
.' 0.0,'."\n"
.' 1.783,'."\n"
.' 0.0,'."\n"
.' 1.972'."\n"
.' ]'],
],
'MaxRowsCountAffected' => [
'description' => '最大影响的行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '最大影响的行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '['."\n"
.' 714,'."\n"
.' 442,'."\n"
.' 314,'."\n"
.' 151,'."\n"
.' 291,'."\n"
.' 521'."\n"
.' ]'],
],
'CPUTime' => [
'description' => 'CPU处理时长。单位:秒(s)。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => 'CPU处理时长。单位:秒(s)。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 1.051,'."\n"
.' 1.007,'."\n"
.' 0.755,'."\n"
.' 0.0,'."\n"
.' 0.05,'."\n"
.' 0.656'."\n"
.' ]'],
],
'AvgCPUTime' => [
'description' => '平均CPU处理时长。单位:秒(s)。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '平均CPU处理时长。单位:秒(s)。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 2.306,'."\n"
.' 1.141,'."\n"
.' 0.0,'."\n"
.' 4.538,'."\n"
.' 1.247,'."\n"
.' 0.0'."\n"
.' ]'],
],
'MaxCPUTime' => [
'description' => '最大CPU处理时长。单位:秒(s)。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。',
'type' => 'array',
'items' => ['description' => '最大CPU处理时长。单位:秒(s)。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '['."\n"
.' 2.306,'."\n"
.' 1.141,'."\n"
.' 0.0,'."\n"
.' 4.538,'."\n"
.' 1.247,'."\n"
.' 0.0'."\n"
.' ]'],
],
'Rows' => [
'description' => 'PolarDB-X 2.0数据库实例计算节点总更新或返回的行数。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。',
'type' => 'array',
'items' => ['description' => 'PolarDB-X 2.0数据库实例计算节点总更新或返回的行数。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '[]'],
],
'AvgRows' => [
'description' => '平均行数。',
'type' => 'array',
'items' => ['description' => '平均行数。', 'type' => 'number', 'format' => 'double'],
],
'MaxRows' => [
'description' => '最大行数。',
'type' => 'array',
'items' => ['description' => '最大行数。', 'type' => 'integer', 'format' => 'int64'],
],
'Frows' => [
'description' => 'PolarDB-X 2.0计算节点(CN)的拉取行数。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。',
'type' => 'array',
'items' => ['description' => 'PolarDB-X 2.0计算节点(CN)的拉取行数。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。', 'type' => 'integer', 'format' => 'int64'],
],
'AvgFrows' => [
'description' => '平均拉取行数。',
'type' => 'array',
'items' => ['description' => '平均拉取行数。', 'type' => 'number', 'format' => 'double'],
],
'MaxFrows' => [
'description' => '最大拉取行数。',
'type' => 'array',
'items' => ['description' => '最大拉取行数。', 'type' => 'integer', 'format' => 'int64'],
],
'Scnt' => [
'description' => 'PolarDB-X 2.0计算节点(CN)的DN请求数。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。',
'type' => 'array',
'items' => ['description' => 'PolarDB-X 2.0计算节点(CN)的DN请求数。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。', 'type' => 'integer', 'format' => 'int64'],
],
'AvgScnt' => [
'description' => '平均请求数。',
'type' => 'array',
'items' => ['description' => '平均请求数。', 'type' => 'number', 'format' => 'double'],
],
'MaxScnt' => [
'description' => '最大请求数。',
'type' => 'array',
'items' => ['description' => '最大请求数。', 'type' => 'integer', 'format' => 'int64'],
],
'TotalCount' => ['description' => '慢日志总数。', 'type' => 'integer', 'format' => 'int64', 'example' => '5'],
],
],
'ErrorCode' => ['title' => '错误码', 'description' => '错误码。', 'type' => 'integer', 'format' => 'int32', 'example' => '10910'],
'Message' => ['title' => '错误信息', 'description' => '错误信息。', 'type' => 'string', 'example' => 'Successful'],
'Timestamp' => ['title' => '请求时间', 'description' => '请求时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '1645668213000'],
],
],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'eventInfo' => [
'enable' => false,
'eventNames' => [],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"RequestKey\\": \\"无\\",\\n \\"ResultId\\": \\"async__20ee808e72257f16a4fe024057ca****\\",\\n \\"State\\": \\"SUCCESS\\",\\n \\"IsFinish\\": true,\\n \\"Data\\": {\\n \\"Total\\": 1,\\n \\"Count\\": [\\n 100\\n ],\\n \\"Ts\\": [\\n 0\\n ],\\n \\"TsEnd\\": [\\n 0\\n ],\\n \\"Item\\": [\\n {\\n \\"NodeId\\": \\"r-bp1hi0wg57s3n0i3n8-db-0\\",\\n \\"Count\\": [\\n 100\\n ],\\n \\"InsItems\\": [\\n {\\n \\"InsId\\": \\"2492\\",\\n \\"InsRole\\": \\"userAdmin\\",\\n \\"Count\\": [\\n 1\\n ],\\n \\"TotalCount\\": 10\\n }\\n ],\\n \\"TotalCount\\": 20,\\n \\"InsRole\\": \\"\\"\\n }\\n ],\\n \\"Rt\\": [\\n 0\\n ],\\n \\"AvgRt\\": [\\n 0\\n ],\\n \\"MaxRt\\": [\\n 0\\n ],\\n \\"LockTime\\": [\\n 0\\n ],\\n \\"AvgLockTime\\": [\\n 0\\n ],\\n \\"MaxLockTime\\": [\\n 0\\n ],\\n \\"RowsExamined\\": [\\n 0\\n ],\\n \\"AvgRowsExamined\\": [\\n 0\\n ],\\n \\"MaxRowsExamined\\": [\\n 0\\n ],\\n \\"RowsSent\\": [\\n 0\\n ],\\n \\"AvgRowsSent\\": [\\n 0\\n ],\\n \\"MaxRowsSent\\": [\\n 0\\n ],\\n \\"KeysExamined\\": [\\n 0\\n ],\\n \\"AvgKeysExamined\\": [\\n 0\\n ],\\n \\"MaxKeysExamined\\": [\\n 0\\n ],\\n \\"DocExamined\\": [\\n 0\\n ],\\n \\"AvgDocExamined\\": [\\n 0\\n ],\\n \\"MaxDocExamined\\": [\\n 0\\n ],\\n \\"ReturnNum\\": [\\n 0\\n ],\\n \\"AvgReturnNum\\": [\\n 0\\n ],\\n \\"MaxReturnNum\\": [\\n 0\\n ],\\n \\"IOWrites\\": [\\n 0\\n ],\\n \\"AvgIOWrites\\": [\\n 0\\n ],\\n \\"MaxIOWrites\\": [\\n 0\\n ],\\n \\"LastRowsCountAffected\\": [\\n 0\\n ],\\n \\"AvgLastRowsCountAffected\\": [\\n 0\\n ],\\n \\"MaxLastRowsCountAffected\\": [\\n 0\\n ],\\n \\"LogicalIOReads\\": [\\n 0\\n ],\\n \\"AvgLogicalIOReads\\": [\\n 0\\n ],\\n \\"MaxLogicalIOReads\\": [\\n 0\\n ],\\n \\"PhysicalIOReads\\": [\\n 0\\n ],\\n \\"AvgPhysicalIOReads\\": [\\n 0\\n ],\\n \\"MaxPhysicalIOReads\\": [\\n 0\\n ],\\n \\"RowsCountAffected\\": [\\n 0\\n ],\\n \\"AvgRowsCountAffected\\": [\\n 0\\n ],\\n \\"MaxRowsCountAffected\\": [\\n 0\\n ],\\n \\"CPUTime\\": [\\n 0\\n ],\\n \\"AvgCPUTime\\": [\\n 0\\n ],\\n \\"MaxCPUTime\\": [\\n 0\\n ],\\n \\"Rows\\": [\\n 0\\n ],\\n \\"AvgRows\\": [\\n 0\\n ],\\n \\"MaxRows\\": [\\n 0\\n ],\\n \\"Frows\\": [\\n 0\\n ],\\n \\"AvgFrows\\": [\\n 0\\n ],\\n \\"MaxFrows\\": [\\n 0\\n ],\\n \\"Scnt\\": [\\n 0\\n ],\\n \\"AvgScnt\\": [\\n 0\\n ],\\n \\"MaxScnt\\": [\\n 0\\n ],\\n \\"TotalCount\\": 5\\n },\\n \\"ErrorCode\\": 10910,\\n \\"Message\\": \\"Successful\\",\\n \\"Timestamp\\": 1645668213000\\n }\\n}","type":"json"}]',
'title' => '异步获取实例慢日志趋势数据',
'description' => '**请确保在使用该接口前,已充分了解DAS产品的[收费方式和价格](~~156195~~)。**'."\n"
."\n"
.'使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 请求实例已开通**DAS企业版**,或者智能运维服务(暂未上线)。'."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
."\n"
.'该接口异步调用后不会立即返回完整结果,当返回数据中 isFinish 取值为 false 时,请等待 1s 后重新发起调用,直到 isFinish 取值为 true 时,返回完整结果。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSlowLogHistogramAsync'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeSlowLogHistogramAsync',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'DescribeSlowLogRecords' => [
'methods' => ['post', 'get'],
'schemes' => ['https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '236528',
'abilityTreeNodes' => ['FEATUREhdmR88NLD'],
'autoTest' => true,
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['description' => '实例id。', 'type' => 'string', 'required' => true, 'example' => 'rm-8vbk4xz99su8****'],
],
[
'name' => 'NodeId',
'in' => 'formData',
'schema' => ['description' => '节点id。', 'type' => 'string', 'required' => false, 'example' => 'pi-d9j9fe7wq7t9i****'."\n"],
],
[
'name' => 'StartTime',
'in' => 'formData',
'schema' => ['description' => '起始时间。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1596177993000'],
],
[
'name' => 'EndTime',
'in' => 'formData',
'schema' => ['description' => '结束时间。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1634972640000'],
],
[
'name' => 'PageNumber',
'in' => 'formData',
'schema' => ['description' => '页码,从1开始。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'],
],
[
'name' => 'PageSize',
'in' => 'formData',
'schema' => ['description' => '页大小。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'],
],
[
'name' => 'Filters',
'in' => 'formData',
'style' => 'repeatList',
'schema' => [
'description' => '筛选条件列表。',
'type' => 'array',
'items' => [
'description' => '筛选条件列表。',
'type' => 'object',
'properties' => [
'Key' => ['title' => '过滤参数', 'description' => '过滤参数。'."\n"
."\n"
.'> 详情请参见补充说明。', 'type' => 'string', 'required' => false, 'example' => 'None'],
'Value' => ['description' => '过滤参数取值。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
'required' => false,
],
'required' => false,
'maxItems' => 100,
],
],
[
'name' => 'OrderBy',
'in' => 'query',
'schema' => ['description' => '- **MySQL** '."\n"
.' - QueryTimeSeconds:查询耗时(秒)。'."\n"
.' - LockTimeSeconds:锁时间(秒)。'."\n"
.' - RowsSent:配置行。'."\n"
.' - RowsExamined:检查行。'."\n"
.'- **Redis**'."\n"
.' - QueryTime:耗时。'."\n"
.' - Timestamp:执行结束时间。'."\n"
.'- **MongoDB**'."\n"
.' - QueryTime:耗时。'."\n"
.' - Timestamp:执行结束时间。'."\n"
.' - KeysExamined:已检查密匙。'."\n"
.' - DocExamined:已检查文件。'."\n"
.' - ReturnNum:返回行。'."\n"
."\n"
.'RDS PostgreSQL、PolarDB PostgreSQL和SQLServer不支持排序。', 'type' => 'string', 'required' => false, 'example' => 'QueryTimeSeconds'],
],
[
'name' => 'Asc',
'in' => 'query',
'schema' => ['description' => '是否升序排序,默认为**true**。'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'required' => false, 'example' => 'true'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A1C79EE2-D04D-571B-8C60-961FAF8E****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'title' => 'DBLogRecords',
'description' => 'DBLogRecords',
'type' => 'object',
'properties' => [
'DbInstanceName' => ['description' => '实例ID。', 'type' => 'string', 'example' => 'rm-bp157g54vy772****'],
'NodeId' => ['description' => '节点id。', 'type' => 'string', 'example' => 'node123'],
'ItemsNumbers' => ['description' => '当前页查询日志列表内的Item数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'StartTime' => ['description' => '起始时间。', 'type' => 'string', 'example' => '1672531200000'],
'EndTime' => ['description' => '结束时间。', 'type' => 'string', 'example' => '1672617600000'],
'DbInstanceId' => ['description' => '实例数字ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'],
'TotalRecords' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'],
'PageNumbers' => ['description' => '分页查询的页码,从1开始,默认为1。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'],
'MaxRecordsPerPage' => ['description' => '分页查询每页最大记录数。取值范围:5~100。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'],
'Logs' => [
'description' => '返回数据。',
'type' => 'array',
'items' => [
'description' => '返回数据。',
'type' => 'object',
'properties' => [
'SqlId' => ['description' => 'SQL模板ID', 'type' => 'string', 'example' => 'sqlId'],
'Scheme' => ['description' => '数据Schema', 'type' => 'string', 'example' => 'HTTPS'],
'SubInstanceId' => ['description' => '子实例ID。', 'type' => 'string', 'example' => 'r-8vb219d10038****'],
'DbInstanceName' => ['description' => '实例ID。', 'type' => 'string', 'example' => 'rm-2zebg30mk056g****'],
'InsName' => ['description' => '实例名字', 'type' => 'string', 'example' => 'test'],
'AccountName' => ['description' => '用户。', 'type' => 'string', 'example' => 'user1'],
'HostAddress' => ['description' => '来源。', 'type' => 'string', 'example' => '192.168.1.1'],
'QueryStartTime' => ['description' => '查询开始的时间。格式:yyyy-MM-dd hh:mm:ss(UTC时间)。', 'type' => 'string', 'example' => '2024-04-01 11:00:00'],
'SQLText' => ['description' => 'sql文本。', 'type' => 'string', 'example' => 'SELECT * FROM my_table WHERE ROWNUM <= 10'],
'Psql' => ['description' => 'SQL模板。', 'type' => 'string', 'example' => 'SELECT * FROM my_table WHERE ROWNUM <= 10'."\n"],
'DBName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'test'],
'QueryTime' => ['description' => '查询耗时。', 'type' => 'integer', 'format' => 'int64', 'example' => '121'],
'ReturnItemNumbers' => ['description' => '返回项目编号。', 'type' => 'string', 'example' => 'test'],
'DocsExamined' => ['description' => 'MongoDB该操作执行时扫描的文档数。', 'type' => 'string', 'example' => '100'],
'KeysExamined' => ['description' => 'MongoDB 索引扫描行数。', 'type' => 'string', 'example' => 'valueA'],
'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'tableNameExample'],
'LockTime' => ['description' => '锁等待时间。', 'type' => 'number', 'format' => 'double', 'example' => '100'],
'RowsExamined' => ['description' => '扫描行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'],
'RowsSent' => ['description' => '返回行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'ThreadId' => ['title' => '仅 PolarDB MySQL 有thread_id', 'description' => '线程ID。', 'type' => 'string', 'example' => '57472578'],
'Timestamp' => ['description' => '时间戳。', 'type' => 'integer', 'format' => 'int64', 'example' => '1747118812'],
'SqlTag' => [
'description' => '标签。',
'type' => 'object',
'properties' => [
'SqlId' => ['description' => 'sqlid。', 'type' => 'string', 'example' => '8ad7069f236bcdaaa9b3ae4b6299****'],
'Tags' => ['description' => '逗号分隔的多个tag。', 'type' => 'string', 'example' => 'DAS_IMPORTANT,DAS_IN_PLAN'],
'Comments' => ['description' => '备注信息。', 'type' => 'string', 'example' => 'test'],
],
],
'LockTimeSeconds' => ['description' => '锁等待时间,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '100'],
'QueryTimeSeconds' => ['description' => '查询耗时,单位秒。', 'type' => 'number', 'format' => 'double', 'example' => '100'],
'SqlType' => ['description' => '选择SQL的类型。'."\n"
.'- **SELECT**'."\n"
.'- **UPDATE**'."\n"
.'- **DELETE**', 'type' => 'string', 'example' => 'SELECT'],
'CPUTime' => ['description' => 'CPU 查询时间。'."\n"
."\n"
.'> 仅云数据库 RDS SQL Server 版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '50'],
'IOWrites' => ['description' => 'I/O 写次数。'."\n"
."\n"
.'> 仅云数据库 RDS SQL Server 版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'LastRowsCountAffected' => ['description' => '最后一条语句的影响行数。'."\n"
."\n"
.'> 仅云数据库 RDS SQL Server 版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'LogicalIOReads' => ['description' => '逻辑读次数。'."\n"
."\n"
.'> 仅云数据库 RDS SQL Server 版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'PhysicalIOReads' => ['description' => '物理读次数。'."\n"
."\n"
.'> 仅云数据库 RDS SQL Server 版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'RowsCountAffected' => ['description' => '影响的行数。'."\n"
."\n"
.'> 仅云数据库 RDS SQL Server 版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'Command' => ['description' => '慢查询语句。'."\n"
.'>仅云数据库 Tair(兼容 Redis)实例支持。', 'type' => 'string', 'example' => 'SELECT'],
'Namespace' => ['description' => '命名空间。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'string', 'example' => 'pro-test'],
'QueryId' => ['description' => 'Query ID。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'string', 'example' => 'sq-1pzcdMwRb'],
'ReturnNum' => ['description' => '返回行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'string', 'example' => '20'],
'ApplicationName' => ['description' => '应用名。'."\n"
."\n"
.'> 仅云数据库 RDS SQL Server 版实例支持。', 'type' => 'string', 'example' => 'MyApp'],
'CPUTimeSeconds' => ['description' => 'CPU 查询时间,单位秒。'."\n"
."\n"
.'> 仅云数据库 RDS SQL Server 版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '100'],
'Rows' => ['description' => 'PolarDB-X 2.0数据库实例计算节点总更新或返回的行数。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'],
'Frows' => ['description' => 'PolarDB-X 2.0计算节点(CN)的拉取行数。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'Scnt' => ['description' => 'PolarDB-X 2.0计算节点(CN)的DN请求数。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'TraceId' => ['description' => 'PolarDB-X 2.0的跟踪ID,即SQL在数据节点的执行ID。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。', 'type' => 'string', 'example' => '074ce334-5247-40b9-b0c1-158aea5d****'],
'TemplateId' => ['description' => 'PolarDB-X 2.0 模板ID。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。', 'type' => 'string', 'example' => '6a63b6ac4572abfaef7d1163f684****'],
'NodeId' => ['type' => 'string'],
'Cmd' => ['type' => 'string'],
'Rt' => ['type' => 'integer', 'format' => 'int64'],
'RequestSize' => ['type' => 'integer', 'format' => 'int64'],
'ResponseSize' => ['type' => 'integer', 'format' => 'int64'],
'ClientIp' => ['type' => 'string'],
'DbId' => ['type' => 'string'],
'OriginTime' => ['type' => 'string'],
'OpType' => ['type' => 'string'],
'Fail' => ['type' => 'string'],
'Params' => ['type' => 'string'],
'Reason' => ['type' => 'string'],
'ReqId' => ['type' => 'string'],
'ExtText' => ['type' => 'string'],
],
],
],
],
],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'eventInfo' => [
'enable' => false,
'eventNames' => [],
],
'title' => '慢日志记录查询',
'summary' => '本接口用于查询数据库实例的慢日志记录,支持按多种条件过滤和排序。',
'description' => '- `InstanceId` 为实例ID,必填参数。'."\n"
.'- `StartTime` 和 `EndTime` 为查询的时间范围,必填参数。'."\n"
.'- 可以通过设置 `PageNumber` 和 `PageSize` 来分页获取结果。'."\n"
.'- 支持通过 `OrderBy` 参数对结果进行排序,具体可排序字段请参考文档。'."\n"
.'- 使用 `Filters` 参数可以进一步细化查询条件,如按主机地址、SQL ID等过滤。'."\n"
.'某些数据库类型(如pg和polarPG)不支持特定的排序方式,请根据实际情况选择合适的参数。',
'requestParamsDescription' => '**Key**支持的参数和取值:'."\n"
.'- **RDS MySQL、PolarDB MySQL、RDS PostgreSQL、PolarDB PostgreSQL版**'."\n"
.' - hostAddress:来源,多个使用逗号分隔。'."\n"
.' - sqlId:SqlID,多个使用逗号分隔。'."\n"
.' - user:用户,多个使用逗号分隔。'."\n"
.' - dbName:数据库名称,多个使用逗号分隔。'."\n"
.' - tags:标签,多个使用逗号分隔。'."\n"
.'- **MongoDB**'."\n"
.' - hostInsId:角色ID,多个使用逗号分隔。'."\n"
.' - insRole:实例角色,多个使用逗号分隔。'."\n"
.' - opType:操作类型,多个使用逗号分隔。'."\n"
.' - namespace:命名空间,多个使用逗号分隔。'."\n"
.' - nodeType:组件类型,多个使用逗号分隔。'."\n"
.' - queryId:查询ID,多个使用逗号分隔。'."\n"
.'- **云数据库Tair(兼容redis)**'."\n"
.' - hostAddress:来源。'."\n"
.' - user:用户。'."\n"
.' - dbName:数据库。'."\n"
.' - nodeType:节点类型。'."\n"
.'- **RDS SQL Server**'."\n"
.' - hostAddress:来源,多个使用逗号分隔。'."\n"
.' - sqlId:SqlID,多个使用逗号分隔。'."\n"
.' - user:用户,多个使用逗号分隔。'."\n"
.' - dbName:数据库,多个使用逗号分隔。'."\n"
.' - tags:标签,多个使用逗号分隔。'."\n"
.'- **PolarDB-X**'."\n"
.' - traceId:实例的跟踪 ID。'."\n"
.' - role:节点角色,取值CN或DN(计算节点/存储节点),必传。'."\n"
.' - hostAddress:来源,多个使用逗号分隔。'."\n"
.' - sqlId:SqlID,多个使用逗号分隔。'."\n"
.' - user:user,多个使用逗号分隔。'."\n"
.' - dbName:数据库,多个使用逗号分隔。'."\n"
.' - tags:标签,多个使用逗号分隔。'."\n"
.'> - SQL引擎支持根据sqlId查询数据,且sqlId支持逗号分隔传入多个,最多20个。'."\n"
.'> - MongoDB支持根据queryId查询数据,且queryId支持逗号分隔传入多个,最多20个。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSlowLogRecords'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeSlowLogRecords',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"A1C79EE2-D04D-571B-8C60-961FAF8E****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"DbInstanceName\\": \\"rm-bp157g54vy772****\\",\\n \\"NodeId\\": \\"node123\\",\\n \\"ItemsNumbers\\": 10,\\n \\"StartTime\\": \\"1672531200000\\",\\n \\"EndTime\\": \\"1672617600000\\",\\n \\"DbInstanceId\\": 100,\\n \\"TotalRecords\\": 100,\\n \\"PageNumbers\\": 1,\\n \\"MaxRecordsPerPage\\": 20,\\n \\"Logs\\": [\\n {\\n \\"SqlId\\": \\"sqlId\\",\\n \\"Scheme\\": \\"HTTPS\\",\\n \\"SubInstanceId\\": \\"r-8vb219d10038****\\",\\n \\"DbInstanceName\\": \\"rm-2zebg30mk056g****\\",\\n \\"InsName\\": \\"test\\",\\n \\"AccountName\\": \\"user1\\",\\n \\"HostAddress\\": \\"192.168.1.1\\",\\n \\"QueryStartTime\\": \\"2024-04-01 11:00:00\\",\\n \\"SQLText\\": \\"SELECT * FROM my_table WHERE ROWNUM <= 10\\",\\n \\"Psql\\": \\"SELECT * FROM my_table WHERE ROWNUM <= 10\\\\n\\",\\n \\"DBName\\": \\"test\\",\\n \\"QueryTime\\": 121,\\n \\"ReturnItemNumbers\\": \\"test\\",\\n \\"DocsExamined\\": \\"100\\",\\n \\"KeysExamined\\": \\"valueA\\",\\n \\"TableName\\": \\"tableNameExample\\",\\n \\"LockTime\\": 100,\\n \\"RowsExamined\\": 100,\\n \\"RowsSent\\": 10,\\n \\"ThreadId\\": \\"57472578\\",\\n \\"Timestamp\\": 1747118812,\\n \\"SqlTag\\": {\\n \\"SqlId\\": \\"8ad7069f236bcdaaa9b3ae4b6299****\\",\\n \\"Tags\\": \\"DAS_IMPORTANT,DAS_IN_PLAN\\",\\n \\"Comments\\": \\"test\\"\\n },\\n \\"LockTimeSeconds\\": 100,\\n \\"QueryTimeSeconds\\": 100,\\n \\"SqlType\\": \\"SELECT\\",\\n \\"CPUTime\\": 50,\\n \\"IOWrites\\": 1,\\n \\"LastRowsCountAffected\\": 10,\\n \\"LogicalIOReads\\": 1,\\n \\"PhysicalIOReads\\": 1,\\n \\"RowsCountAffected\\": 10,\\n \\"Command\\": \\"SELECT\\",\\n \\"Namespace\\": \\"pro-test\\",\\n \\"QueryId\\": \\"sq-1pzcdMwRb\\",\\n \\"ReturnNum\\": \\"20\\",\\n \\"ApplicationName\\": \\"MyApp\\",\\n \\"CPUTimeSeconds\\": 100,\\n \\"Rows\\": 20,\\n \\"Frows\\": 10,\\n \\"Scnt\\": 10,\\n \\"TraceId\\": \\"074ce334-5247-40b9-b0c1-158aea5d****\\",\\n \\"TemplateId\\": \\"6a63b6ac4572abfaef7d1163f684****\\",\\n \\"NodeId\\": \\"\\",\\n \\"Cmd\\": \\"\\",\\n \\"Rt\\": 0,\\n \\"RequestSize\\": 0,\\n \\"ResponseSize\\": 0,\\n \\"ClientIp\\": \\"\\",\\n \\"DbId\\": \\"\\",\\n \\"OriginTime\\": \\"\\",\\n \\"OpType\\": \\"\\",\\n \\"Fail\\": \\"\\",\\n \\"Params\\": \\"\\",\\n \\"Reason\\": \\"\\",\\n \\"ReqId\\": \\"\\",\\n \\"ExtText\\": \\"\\"\\n }\\n ]\\n }\\n}","type":"json"}]',
],
'DescribeSlowLogStatistic' => [
'summary' => '慢日志统计信息。',
'methods' => ['post', 'get'],
'schemes' => ['https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '236526',
'abilityTreeNodes' => ['FEATUREhdmR88NLD'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze1jdv45i7l6****'],
],
[
'name' => 'NodeId',
'in' => 'formData',
'schema' => ['description' => '节点ID。'."\n"
."\n"
.'- 对于RDS MySQL和PolarDB MySQL版,该参数仅适用于集群版实例。若不传该参数,默认查询主节点日志明细。'."\n"
.'- 对于PolarDB-X 2.0,该参数传入**polarx_cn**(计算节点)或**polarx_dn**(数据节点)。', 'type' => 'string', 'required' => false, 'example' => 'r-x****-db-0'],
],
[
'name' => 'Type',
'in' => 'formData',
'schema' => [
'description' => '任务类型:'."\n"
."\n"
.'SQL引擎特有:'."\n"
."\n"
.'**SlowLogRequestOrigin**:通过来源IP聚合日志。'."\n"
."\n"
.'**SlowLogRequestUser**:通过来源USER聚合日志。'."\n"
."\n"
.'**SQL**:通过SQLID聚合日志。'."\n"
."\n\n"
.'MongoDB引擎特有:'."\n"
."\n"
.'**SlowLogRequestOrigin**:通过来源IP聚合日志。'."\n"
."\n"
.'**SlowLogRequestUser**:通过来源USER聚合日志。'."\n"
."\n"
.'**SQL**:通过Query ID聚合日志。'."\n"
."\n"
.'**SlowLogRequestOpType**:通过操作类型聚合日志。'."\n"
."\n"
.'**SlowLogRequestNamespace**:通过namespace聚合日志。'."\n"
."\n"
.'Redis引擎特有:'."\n"
."\n"
.'**SlowLogRequestNodeId**:通过nodeId聚合日志。'."\n"
."\n"
.'**SlowLogRequestHostInsId**:通过HostInsId聚合日志。',
'type' => 'string',
'required' => false,
'enumValueTitles' => ['SlowLogRequestOrigin' => 'SlowLogRequestOrigin', 'OriginHost' => 'OriginHost', 'SlowLogRequestUser' => 'SlowLogRequestUser', 'SQL' => 'SQL'],
'example' => 'SQL',
],
],
[
'name' => 'TemplateId',
'in' => 'formData',
'schema' => ['description' => '模板ID。', 'type' => 'string', 'required' => false, 'example' => '04ea3310df40c3fa8a6b4854db49f79a'],
],
[
'name' => 'StartTime',
'in' => 'formData',
'schema' => ['description' => '查询任务开始时间,格式为Unix时间戳(UTC时间),单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1568269711000'],
],
[
'name' => 'EndTime',
'in' => 'formData',
'schema' => ['description' => '查询结束时间,格式为Unix时间戳(UTC时间),单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1608888296000'],
],
[
'name' => 'OrderBy',
'in' => 'formData',
'schema' => ['description' => '排序方式,可选为:'."\n"
."\n"
.'**Count**'."\n"
."\n"
.'**QueryTime**'."\n"
."\n"
.'**LockTime**'."\n"
."\n"
.'**RowsExamined**'."\n"
."\n"
.'**RowsSent**', 'type' => 'string', 'required' => false, 'example' => 'count'],
],
[
'name' => 'Asc',
'in' => 'formData',
'schema' => ['description' => '升序排序开关,默认关闭。', 'type' => 'boolean', 'required' => false, 'example' => 'true'],
],
[
'name' => 'PageNumber',
'in' => 'formData',
'schema' => ['description' => '查询列表的页码,起始值为1,默认值为1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'],
],
[
'name' => 'PageSize',
'in' => 'formData',
'schema' => ['description' => '每页最大记录数,默认值为10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '20'],
],
[
'name' => 'Filters',
'in' => 'formData',
'style' => 'repeatList',
'schema' => [
'description' => '查询筛选条件列表。',
'type' => 'array',
'items' => [
'description' => 'Key支持的参数和取值:'."\n"
."\n"
.'hostAddress:来源,多个逗号分隔。'."\n"
."\n"
.'sqlId:sqlId,多个逗号分隔。'."\n"
."\n"
.'user:用户,多个逗号分隔。'."\n"
."\n"
.'dbName:数据库,多个逗号分隔。'."\n"
."\n"
.'keyWord:关键字,多个空格分隔。'."\n"
."\n"
.'tags:标签,多个逗号分隔。',
'type' => 'object',
'properties' => [
'Key' => ['title' => '过滤参数', 'description' => '过滤参数', 'type' => 'string', 'required' => false, 'example' => 'KeyWords'],
'Value' => ['description' => '过滤参数的值。', 'type' => 'string', 'required' => false, 'example' => 'select'],
],
'required' => false,
],
'required' => false,
'maxItems' => 100,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '52D540CF-C517-1F57-BB42-9035F96******'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'title' => 'AsyncResult>',
'description' => 'AsyncResult>',
'type' => 'object',
'properties' => [
'RequestKey' => ['title' => '请求参数的Key', 'description' => '请求参数的Key。', 'type' => 'string', 'example' => '123456789'],
'ResultId' => ['title' => '结果ID', 'description' => '结果ID。', 'type' => 'string', 'example' => 'async__665ee69612f1627c7fd9f3c85075****'],
'State' => ['title' => '当前状态 (RUNNING: 正在运行, SUCCESS: 成功, FAIL: 失败)', 'description' => '当前状态:'."\n"
."\n"
.'-**RUNNING**:正在运行。'."\n"
."\n"
.'-**SUCCESS**:成功。'."\n"
."\n"
.'-**FAIL**:失败。', 'type' => 'string', 'example' => 'SUCCESS'],
'IsFinish' => ['title' => '是否完成', 'description' => '是否完成。', 'type' => 'boolean', 'example' => 'true'],
'Data' => [
'title' => '数据',
'description' => '数据。',
'type' => 'object',
'properties' => [
'DbInstanceName' => ['description' => '实例ID。', 'type' => 'string', 'example' => '0'],
'NodeId' => ['description' => '节点ID。'."\n"
."\n"
.'对于MongoDB实例,通过该参数指定节点进行空间分析。调用[DescribeRoleZoneInfo](~~123802~~)接口,可以查询MongoDB实例各个节点的详细信息。'."\n"
."\n"
.'- 当传入目标节点的**InsName**(节点ID)时,例如`d-bp1872fa24d5****`,调用该接口分析其对应的Hidden节点。'."\n"
.'- 当传入目标节点的`InsName#RoleId`时,例如`d-bp1872fa24d5****#299****5`,调用该接口分析指定的节点。'."\n"
."\n"
.'>对于MongoDB副本集实例,不传入此参数时,调用该接口会默认分析唯一的Hidden节点。对于MongoDB分片集群实例,推荐传入此参数,指定目标节点。', 'type' => 'string', 'example' => 'pi-wz99g5rn7w1x8h0sf'],
'ItemsNumbers' => ['description' => '当前页查询日志列表内的Item数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'StartTime' => ['description' => '开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'string', 'example' => '2024-10-08T02:01:00Z'],
'EndTime' => ['description' => '查询任务结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
.'> 查询任务结束时间需晚于查询任务开始时间。', 'type' => 'string', 'example' => '2024-08-08T02:15:00Z'],
'DbInstanceId' => ['description' => '实例数字ID。', 'type' => 'integer', 'format' => 'int64', 'example' => 'rm-k2ja51w7cnusg5a1x'],
'TotalRecords' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '13'],
'PageNumbers' => ['description' => '分页查询的页码,从1开始,默认为1。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'],
'MaxRecordsPerPage' => ['description' => '分页查询每页最大记录数。取值范围:5~100。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'],
'Logs' => [
'description' => '操作对象名称。',
'type' => 'array',
'items' => [
'description' => '日志。',
'type' => 'object',
'properties' => [
'Count' => ['description' => 'Key的元素个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '12'],
'MaxLockTime' => ['description' => '已废弃。', 'type' => 'number', 'format' => 'double', 'example' => '-'],
'MaxQueryTime' => ['description' => '已废弃。', 'type' => 'number', 'format' => 'double', 'example' => '-'],
'MaxRowsExamined' => ['description' => '最大扫描行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '318613'],
'MaxRowsSent' => ['description' => '最大返回行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '256'],
'AvgQueryTime' => ['description' => '已废弃。', 'type' => 'number', 'format' => 'double', 'example' => '-'],
'QueryTimeRate' => ['description' => '查询耗时比例。', 'type' => 'number', 'format' => 'double', 'example' => '0.1018'],
'CountRate' => ['description' => '执行次数比例。', 'type' => 'number', 'format' => 'double', 'example' => '0.2034'],
'AvgRowsExamined' => ['description' => '平均扫描行数。', 'type' => 'number', 'format' => 'double', 'example' => '53421.0'],
'OriginAlias' => ['description' => '来源别名。', 'type' => 'string', 'example' => 'order-1'],
'User' => ['description' => '用户。', 'type' => 'string', 'example' => 'user-1'],
'SqlTag' => [
'description' => '标签。',
'type' => 'object',
'properties' => [
'SqlId' => ['description' => 'SQL ID。', 'type' => 'string', 'example' => 'a3931d8c3a9315dd5ed016d71cf*****'],
'Tags' => ['title' => '逗号分隔的多个tag', 'description' => '逗号分隔的多个tag。', 'type' => 'string', 'example' => 'DAS_IN_PLAN'],
'Comments' => ['description' => '备注。'."\n"
."\n"
.'长度为1~300个字符。', 'type' => 'string', 'example' => 'dba 归档'],
],
],
'Trend' => [
'description' => '慢日志趋势。',
'type' => 'array',
'items' => [
'description' => '慢日志趋势。',
'type' => 'object',
'properties' => [
'Timestamp' => ['description' => '执行时间,格式为Unix时间戳,单位为毫秒(ms)。', 'type' => 'integer', 'format' => 'int64', 'example' => '1723775362'],
'Value' => ['description' => '过滤参数的值。', 'type' => 'any', 'example' => 'tf-testacc-oos-parameter'],
],
],
],
'Database' => ['description' => '数据库名。', 'type' => 'string', 'example' => 'work-wechat-api'],
'Histogram' => [
'description' => '趋势图数据。',
'type' => 'object',
'properties' => [
'Total' => ['description' => '查询的总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '7'],
'Count' => [
'description' => '慢日志数量。',
'type' => 'array',
'items' => ['description' => '慢日志数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'],
],
'Ts' => [
'title' => '关系型数据库只使用这个',
'description' => '执行时间戳。',
'type' => 'array',
'items' => ['description' => '事件发生的时间,使用UNIX时间戳表示,单位:秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1715220818'],
],
'TsEnd' => [
'description' => '已废弃。',
'type' => 'array',
'items' => ['description' => '已废弃。', 'type' => 'integer', 'format' => 'int64', 'example' => '-'],
],
'Item' => [
'description' => '任务状态。',
'type' => 'array',
'items' => [
'description' => '错误码信息。',
'type' => 'object',
'properties' => [
'NodeId' => ['description' => '节点id。', 'type' => 'string', 'example' => 'r-bp1s1m8hwzrm77kfvz-db-0'],
'Count' => [
'description' => '慢日志数量。',
'type' => 'array',
'items' => ['description' => 'Key的元素个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'],
],
],
],
],
'Rt' => [
'description' => '执行耗时,单位为秒。',
'type' => 'array',
'items' => ['description' => '执行耗时,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '1854'],
],
'AvgRt' => [
'description' => '平均执行耗时。',
'type' => 'array',
'items' => ['description' => '平均执行耗时。', 'type' => 'number', 'format' => 'double', 'example' => '3709'],
],
'MaxRt' => [
'description' => '最大RT,单位ms。',
'type' => 'array',
'items' => ['description' => '最大RT,单位ms。', 'type' => 'number', 'format' => 'double', 'example' => '2516.0'],
],
'LockTime' => [
'description' => '锁等待时间,单位毫秒。',
'type' => 'array',
'items' => ['description' => '锁等待时间,单位毫秒。', 'type' => 'number', 'format' => 'double', 'example' => '300'],
],
'AvgLockTime' => [
'description' => '平均锁等待时间,单位为秒。',
'type' => 'array',
'items' => ['description' => '平均锁等待时间,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '15'],
],
'MaxLockTime' => [
'description' => '最大锁等待时间,单位为秒。',
'type' => 'array',
'items' => ['description' => '最大锁等待时间,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '1051'],
],
'RowsExamined' => [
'description' => '总扫描行数。'."\n"
.'> 目前支持该字段的数据库:RDS MySQL、RDS PostgreSQL、PolarDB MySQL版。',
'type' => 'array',
'items' => ['description' => '总扫描行数。'."\n"
.'> 目前支持该字段的数据库:RDS MySQL、RDS PostgreSQL、PolarDB MySQL版。', 'type' => 'integer', 'format' => 'int64', 'example' => '641057'],
],
'AvgRowsExamined' => [
'description' => '平均扫描行数。',
'type' => 'array',
'items' => ['description' => '平均扫描行数。', 'type' => 'number', 'format' => 'double', 'example' => '222189'],
],
'MaxRowsExamined' => [
'description' => '最大扫描行数。',
'type' => 'array',
'items' => ['description' => '最大扫描行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '878511'],
],
'RowsSent' => [
'description' => '返回行数。',
'type' => 'array',
'items' => ['description' => '返回行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '4'],
],
'AvgRowsSent' => [
'description' => '平均返回行数。',
'type' => 'array',
'items' => ['description' => '平均返回行数。', 'type' => 'number', 'format' => 'double', 'example' => '2.0'],
],
'MaxRowsSent' => [
'description' => '最大返回行数。',
'type' => 'array',
'items' => ['description' => '最大返回行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '256'],
],
],
],
'SqlId' => ['description' => 'SQL ID。', 'type' => 'string', 'example' => '2dca88762ec6b3812504ab8a4b******'],
'Scheme' => ['description' => 'HTTP或HTTPS。', 'type' => 'string', 'example' => 'HTTP'],
'SubInstanceId' => ['description' => '子实例ID。', 'type' => 'string', 'example' => 'r-8vba51c588ba3a94'],
'DbInstanceName' => ['description' => '实例ID。', 'type' => 'string', 'example' => '0'],
'InsName' => ['description' => '分片名。', 'type' => 'string', 'example' => 'rm-uf6zix1z2jh1y6fe5'],
'AccountName' => ['description' => '数据库账号。', 'type' => 'string', 'example' => 'edu_admin'],
'HostAddress' => ['description' => '客户端IP地址。', 'type' => 'string', 'example' => '172.23.142.178'],
'QueryStartTime' => ['description' => '查询开始的时间。格式:yyyy-MM-dd hh:mm:ss(UTC时间)。', 'type' => 'string', 'example' => '2024-12-25T03:00:00Z'],
'SQLText' => ['description' => 'SQL语句详情。', 'type' => 'string', 'example' => 'SELECT \'Hello, World!\' FROM DUAL'],
'Psql' => ['description' => 'SQL模板。', 'type' => 'string', 'example' => 'SELECT b?.id,b?.t?,b?.id,b?.t? FROM testtb? b? JOIN testtb? b? ON b?.id=b?.id WHERE b?.t? LIKE ? ORDER BY b?.id DESC'],
'DBName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'member_score'],
'QueryTime' => ['description' => '查询执行时间阈值,单位为毫秒(ms)。', 'type' => 'integer', 'format' => 'int64', 'example' => '272.444'],
'ReturnItemNumbers' => ['description' => '返回项目编号。', 'type' => 'string', 'example' => '暂无'],
'DocsExamined' => ['description' => 'MongoDB该操作执行时扫描的文档数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'KeysExamined' => ['description' => 'MongoDB索引扫描行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '20000'."\n"],
'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'users\\nifconfig\\n'],
'LockTime' => ['description' => '已废弃。', 'type' => 'number', 'format' => 'double', 'example' => '-'],
'RowsExamined' => ['description' => '总扫描行数。'."\n"
.'> 目前支持该字段的数据库:RDS MySQL、RDS PostgreSQL、PolarDB MySQL版。', 'type' => 'integer', 'format' => 'int64', 'example' => '2444081'],
'RowsSent' => ['description' => '返回行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '772'],
'ThreadId' => ['title' => '仅 PolarDB MySQL 有thread_id', 'description' => '仅 PolarDB MySQL 有thread_id。', 'type' => 'string', 'example' => '1'],
'Timestamp' => ['description' => '执行时间,格式为Unix时间戳,单位为毫秒(ms)。', 'type' => 'integer', 'format' => 'int64', 'example' => '1708568930'],
'AvgLockTime' => ['description' => '已废弃。', 'type' => 'number', 'format' => 'double', 'example' => '-'],
'AvgRowsSent' => ['description' => '平均返回行数。', 'type' => 'number', 'format' => 'double', 'example' => '2.0'],
'LockTimeSeconds' => ['description' => '锁等待时间,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '0.0'],
'QueryTimeSeconds' => ['description' => '查询耗时,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '25.472'],
'AvgLockTimeSeconds' => ['description' => '平均锁等待时间,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '0.0'],
'MaxLockTimeSeconds' => ['description' => '最大锁等待时间,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '0.0'],
'MaxQueryTimeSeconds' => ['description' => '最大查询耗时,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '14.402'],
'AvgQueryTimeSeconds' => ['description' => '平均查询耗时,单位为秒。', 'type' => 'number', 'format' => 'double', 'example' => '6.211'],
'SqlType' => ['description' => 'SQL语句的类型。', 'type' => 'string', 'example' => 'LOGIN'],
'QueryId' => ['description' => 'Query ID。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'string', 'example' => 'sq-1pzcdMwRb'],
'NodeType' => ['description' => '节点类型。'."\n"
.'> 目前支持该字段的数据库:云数据库MongoDB版、云数据库 Tair(兼容 Redis)。', 'type' => 'string', 'example' => 'DLNode'],
'HostInsId' => ['description' => '主机实例id。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'string', 'example' => 'mongo-abc123456'],
'InsRole' => ['description' => '实例角色。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'string', 'example' => '__system'],
'OpType' => ['description' => '操作类型。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'string', 'example' => 'Insert'],
'Namespace' => ['description' => '命名空间。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'string', 'example' => 'database.collection'],
'AvgKeysExamined' => ['description' => '平均索引扫描行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '20000'],
'AvgDocExamined' => ['description' => '平均扫描文档行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '10000'],
'AvgReturnNum' => ['description' => '平均返回行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '1'],
'MaxKeysExamined' => ['description' => '最大索引扫描行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '2000000'],
'MaxDocExamined' => ['description' => '最大扫描文档行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000000'],
'MaxReturnNum' => ['description' => '最大返回行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'ReturnNum' => ['description' => '返回行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'DocExamined' => ['description' => '扫描文档行数。'."\n"
.'>仅云数据库MongoDB版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '2000000'],
'Command' => ['description' => '慢查询语句。'."\n"
.'>仅云数据库 Tair(兼容 Redis)实例支持。', 'type' => 'string', 'example' => 'SELECT b?.id,b?.t?,b?.id,b?.t? FROM testtb? b? JOIN testtb? b? ON b?.id=b?.id WHERE b?.t? LIKE ? ORDER BY b?.t? DESC'],
'IOWrites' => ['description' => 'I/O 写次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'],
'MaxIOWrites' => ['description' => '最大 I/O 写次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'],
'LastRowsCountAffected' => ['description' => '最后一条语句的影响行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'],
'MaxLastRowsCountAffected' => ['description' => '最大最后一条语句的影响行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'],
'LogicalIOReads' => ['description' => '逻辑读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'],
'MaxLogicalIOReads' => ['description' => '最大逻辑读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'],
'PhysicalIOReads' => ['description' => '物理读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'],
'MaxPhysicalIOReads' => ['description' => '最大物理读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'],
'RowsCountAffected' => ['description' => '影响的行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'],
'MaxRowsCountAffected' => ['description' => '最大影响的行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'],
'CPUTime' => ['description' => '已废弃。', 'type' => 'number', 'format' => 'double', 'example' => '-'],
'AvgCPUTime' => ['description' => '已废弃。', 'type' => 'number', 'format' => 'double', 'example' => '-'."\n"],
'MaxCPUTime' => ['description' => '已废弃。', 'type' => 'number', 'format' => 'double', 'example' => '-'."\n"],
'AvgIOWrites' => ['description' => '平均 I/O 写次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '1000'],
'AvgLastRowsCountAffected' => ['description' => '平均最后一条语句的影响行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '1000'],
'AvgLogicalIOReads' => ['description' => '平均逻辑读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '1000'],
'AvgPhysicalIOReads' => ['description' => '平均物理读次数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '1000'],
'AvgRowsCountAffected' => ['description' => '平均影响的行数。'."\n"
.'>仅云数据库RDS SQL Server版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '1000'],
'AvgCPUTimeSeconds' => ['description' => 'CPU 平均查询时间,单位秒。', 'type' => 'number', 'format' => 'double', 'example' => '456'],
'MaxCPUTimeSeconds' => ['description' => 'CPU 最长查询时间,单位秒。', 'type' => 'number', 'format' => 'double', 'example' => '456'],
'CPUTimeSeconds' => ['description' => 'CPU 查询时间,单位秒。'."\n"
."\n"
.'> 仅云数据库 RDS SQL Server 版实例支持。', 'type' => 'number', 'format' => 'double', 'example' => '456'],
'Rows' => ['description' => 'PolarDB-X 2.0数据库实例计算节点总更新或返回的行数。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '105'],
'AvgRows' => ['description' => '平均行数。', 'type' => 'number', 'format' => 'double', 'example' => '10'],
'MaxRows' => ['description' => '最大行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'Frows' => ['description' => 'PolarDB-X 2.0计算节点(CN)的拉取行数。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'AvgFrows' => ['description' => '平均拉取行数。', 'type' => 'number', 'format' => 'double', 'example' => '10'],
'MaxFrows' => ['description' => '最大拉取行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'Scnt' => ['description' => 'PolarDB-X 2.0计算节点(CN)的DN请求数。'."\n"
."\n"
.'> 仅云数据库 PolarDB-X 2.0 版实例支持。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'AvgScnt' => ['description' => '平均请求数。', 'type' => 'number', 'format' => 'double', 'example' => '10'],
'MaxScnt' => ['description' => '最大请求数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'RuleId' => ['description' => '规则ID,具体信息请参见[查询治理](~~290038~~)。', 'type' => 'string', 'example' => '181**47'],
'AvgRt' => ['description' => '平均执行耗时。', 'type' => 'number', 'format' => 'double'],
'MaxRt' => ['description' => '最大执行耗时,单位秒。', 'type' => 'number', 'format' => 'double'],
'AvgRequestSize' => ['description' => '平均请求长度,单位字节(仅 Redis 有效)。', 'type' => 'number', 'format' => 'double'],
'MaxRequestSize' => ['description' => '最大请求长度,单位字节(仅 Redis 有效)。', 'type' => 'number', 'format' => 'double'],
'AvgResponseSize' => ['description' => '平均响应长度,单位字节(仅 Redis 有效)。', 'type' => 'number', 'format' => 'double'],
'MaxResponseSize' => ['description' => '最大响应长度,单位字节(仅 Redis 有效)。', 'type' => 'number', 'format' => 'double'],
'TotalCount' => ['description' => '总的记录数(仅 Redis 引擎有效)', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'Cmd' => ['description' => '执行的命令(仅 Redis 有效)', 'type' => 'string', 'example' => 'systemctl restart nginx.service'],
'ClientIp' => ['description' => '查询中的客户端IP地址', 'type' => 'string', 'example' => '10.57.84.109'],
'DbId' => ['description' => '数据库ID(仅 Redis 有效)', 'type' => 'string', 'example' => '0'],
],
],
],
],
],
'ErrorCode' => ['title' => '错误码', 'description' => '错误码。', 'type' => 'integer', 'format' => 'int32', 'example' => '10910'],
'Message' => ['title' => '错误信息', 'description' => '错误信息。', 'type' => 'string', 'example' => 'Successful'],
'Timestamp' => ['title' => '请求时间', 'description' => '请求时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '1735104224250'],
],
],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'eventInfo' => [
'enable' => false,
'eventNames' => [],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"52D540CF-C517-1F57-BB42-9035F96******\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"RequestKey\\": \\"123456789\\",\\n \\"ResultId\\": \\"async__665ee69612f1627c7fd9f3c85075****\\",\\n \\"State\\": \\"SUCCESS\\",\\n \\"IsFinish\\": true,\\n \\"Data\\": {\\n \\"DbInstanceName\\": \\"0\\",\\n \\"NodeId\\": \\"pi-wz99g5rn7w1x8h0sf\\",\\n \\"ItemsNumbers\\": 10,\\n \\"StartTime\\": \\"2024-10-08T02:01:00Z\\",\\n \\"EndTime\\": \\"2024-08-08T02:15:00Z\\",\\n \\"DbInstanceId\\": 0,\\n \\"TotalRecords\\": 13,\\n \\"PageNumbers\\": 1,\\n \\"MaxRecordsPerPage\\": 10,\\n \\"Logs\\": [\\n {\\n \\"Count\\": 12,\\n \\"MaxLockTime\\": 0,\\n \\"MaxQueryTime\\": 0,\\n \\"MaxRowsExamined\\": 318613,\\n \\"MaxRowsSent\\": 256,\\n \\"AvgQueryTime\\": 0,\\n \\"QueryTimeRate\\": 0.1018,\\n \\"CountRate\\": 0.2034,\\n \\"AvgRowsExamined\\": 53421,\\n \\"OriginAlias\\": \\"order-1\\",\\n \\"User\\": \\"user-1\\",\\n \\"SqlTag\\": {\\n \\"SqlId\\": \\"a3931d8c3a9315dd5ed016d71cf*****\\",\\n \\"Tags\\": \\"DAS_IN_PLAN\\",\\n \\"Comments\\": \\"dba 归档\\"\\n },\\n \\"Trend\\": [\\n {\\n \\"Timestamp\\": 1723775362,\\n \\"Value\\": \\"tf-testacc-oos-parameter\\"\\n }\\n ],\\n \\"Database\\": \\"work-wechat-api\\",\\n \\"Histogram\\": {\\n \\"Total\\": 7,\\n \\"Count\\": [\\n 100\\n ],\\n \\"Ts\\": [\\n 1715220818\\n ],\\n \\"TsEnd\\": [\\n 0\\n ],\\n \\"Item\\": [\\n {\\n \\"NodeId\\": \\"r-bp1s1m8hwzrm77kfvz-db-0\\",\\n \\"Count\\": [\\n 100\\n ]\\n }\\n ],\\n \\"Rt\\": [\\n 1854\\n ],\\n \\"AvgRt\\": [\\n 3709\\n ],\\n \\"MaxRt\\": [\\n 2516\\n ],\\n \\"LockTime\\": [\\n 300\\n ],\\n \\"AvgLockTime\\": [\\n 15\\n ],\\n \\"MaxLockTime\\": [\\n 1051\\n ],\\n \\"RowsExamined\\": [\\n 641057\\n ],\\n \\"AvgRowsExamined\\": [\\n 222189\\n ],\\n \\"MaxRowsExamined\\": [\\n 878511\\n ],\\n \\"RowsSent\\": [\\n 4\\n ],\\n \\"AvgRowsSent\\": [\\n 2\\n ],\\n \\"MaxRowsSent\\": [\\n 256\\n ]\\n },\\n \\"SqlId\\": \\"2dca88762ec6b3812504ab8a4b******\\",\\n \\"Scheme\\": \\"HTTP\\",\\n \\"SubInstanceId\\": \\"r-8vba51c588ba3a94\\",\\n \\"DbInstanceName\\": \\"0\\",\\n \\"InsName\\": \\"rm-uf6zix1z2jh1y6fe5\\",\\n \\"AccountName\\": \\"edu_admin\\",\\n \\"HostAddress\\": \\"172.23.142.178\\",\\n \\"QueryStartTime\\": \\"2024-12-25T03:00:00Z\\",\\n \\"SQLText\\": \\"SELECT \'Hello, World!\' FROM DUAL\\",\\n \\"Psql\\": \\"SELECT b?.id,b?.t?,b?.id,b?.t? FROM testtb? b? JOIN testtb? b? ON b?.id=b?.id WHERE b?.t? LIKE ? ORDER BY b?.id DESC\\",\\n \\"DBName\\": \\"member_score\\",\\n \\"QueryTime\\": 272.444,\\n \\"ReturnItemNumbers\\": \\"暂无\\",\\n \\"DocsExamined\\": 1,\\n \\"KeysExamined\\": 20000,\\n \\"TableName\\": \\"users\\\\\\\\nifconfig\\\\\\\\n\\",\\n \\"LockTime\\": 0,\\n \\"RowsExamined\\": 2444081,\\n \\"RowsSent\\": 772,\\n \\"ThreadId\\": \\"1\\",\\n \\"Timestamp\\": 1708568930,\\n \\"AvgLockTime\\": 0,\\n \\"AvgRowsSent\\": 2,\\n \\"LockTimeSeconds\\": 0,\\n \\"QueryTimeSeconds\\": 25.472,\\n \\"AvgLockTimeSeconds\\": 0,\\n \\"MaxLockTimeSeconds\\": 0,\\n \\"MaxQueryTimeSeconds\\": 14.402,\\n \\"AvgQueryTimeSeconds\\": 6.211,\\n \\"SqlType\\": \\"LOGIN\\",\\n \\"QueryId\\": \\"sq-1pzcdMwRb\\",\\n \\"NodeType\\": \\"DLNode\\",\\n \\"HostInsId\\": \\"mongo-abc123456\\",\\n \\"InsRole\\": \\"__system\\",\\n \\"OpType\\": \\"Insert\\",\\n \\"Namespace\\": \\"database.collection\\",\\n \\"AvgKeysExamined\\": 20000,\\n \\"AvgDocExamined\\": 10000,\\n \\"AvgReturnNum\\": 1,\\n \\"MaxKeysExamined\\": 2000000,\\n \\"MaxDocExamined\\": 1000000,\\n \\"MaxReturnNum\\": 1,\\n \\"ReturnNum\\": 1,\\n \\"DocExamined\\": 2000000,\\n \\"Command\\": \\"SELECT b?.id,b?.t?,b?.id,b?.t? FROM testtb? b? JOIN testtb? b? ON b?.id=b?.id WHERE b?.t? LIKE ? ORDER BY b?.t? DESC\\",\\n \\"IOWrites\\": 1000,\\n \\"MaxIOWrites\\": 1000,\\n \\"LastRowsCountAffected\\": 1000,\\n \\"MaxLastRowsCountAffected\\": 1000,\\n \\"LogicalIOReads\\": 1000,\\n \\"MaxLogicalIOReads\\": 1000,\\n \\"PhysicalIOReads\\": 1000,\\n \\"MaxPhysicalIOReads\\": 1000,\\n \\"RowsCountAffected\\": 1000,\\n \\"MaxRowsCountAffected\\": 1000,\\n \\"CPUTime\\": 0,\\n \\"AvgCPUTime\\": 0,\\n \\"MaxCPUTime\\": 0,\\n \\"AvgIOWrites\\": 1000,\\n \\"AvgLastRowsCountAffected\\": 1000,\\n \\"AvgLogicalIOReads\\": 1000,\\n \\"AvgPhysicalIOReads\\": 1000,\\n \\"AvgRowsCountAffected\\": 1000,\\n \\"AvgCPUTimeSeconds\\": 456,\\n \\"MaxCPUTimeSeconds\\": 456,\\n \\"CPUTimeSeconds\\": 456,\\n \\"Rows\\": 105,\\n \\"AvgRows\\": 10,\\n \\"MaxRows\\": 10,\\n \\"Frows\\": 10,\\n \\"AvgFrows\\": 10,\\n \\"MaxFrows\\": 10,\\n \\"Scnt\\": 10,\\n \\"AvgScnt\\": 10,\\n \\"MaxScnt\\": 10,\\n \\"RuleId\\": \\"181**47\\",\\n \\"AvgRt\\": 0,\\n \\"MaxRt\\": 0,\\n \\"AvgRequestSize\\": 0,\\n \\"MaxRequestSize\\": 0,\\n \\"AvgResponseSize\\": 0,\\n \\"MaxResponseSize\\": 0,\\n \\"TotalCount\\": 0,\\n \\"Cmd\\": \\"systemctl restart nginx.service\\",\\n \\"ClientIp\\": \\"10.57.84.109\\",\\n \\"DbId\\": \\"0\\"\\n }\\n ]\\n },\\n \\"ErrorCode\\": 10910,\\n \\"Message\\": \\"Successful\\",\\n \\"Timestamp\\": 1735104224250\\n }\\n}","type":"json"}]',
'title' => '慢日志统计信息',
'description' => '**请确保在使用该接口前,已充分了解DAS产品的[收费方式和价格](~~156195~~)。**'."\n"
."\n"
.'使用该接口需满足以下前提条件:'."\n"
.'- 请求实例已开通智能运维服务。'."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
."\n"
.'该接口异步调用后不会立即返回完整结果,当返回数据中 isFinish 取值为 false 时,请等待 1s 后重新发起调用,直到 isFinish 取值为 true 时,返回完整结果。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSlowLogStatistic'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeSlowLogStatistic',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'DescribeSqlLogConfig' => [
'summary' => '调用DescribeSqlLogConfig接口,查询数据库实例的DAS企业版配置信息。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '198881',
'abilityTreeNodes' => ['FEATUREhdmPGXCEW', 'FEATUREhdmFT57I0'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['description' => '数据库实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Data' => [
'title' => 'SqlLogConfig',
'description' => '返回数据。',
'type' => 'object',
'properties' => [
'ColdEnable' => ['description' => '是否开启数据冷存储。'."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'ColdRetention' => ['title' => '冷数据存储周期(不落库),通过 retention - hotRetention 计算', 'description' => '数据冷存储时长,单位为天。', 'type' => 'integer', 'format' => 'int32', 'example' => '23'],
'ColdStartTime' => ['description' => '数据冷存储开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1683712800000'],
'CollectorVersion' => ['description' => '采集器版本。'."\n"
."\n"
.'- **MYSQL_V0**:MySQL V0版。'."\n"
.'- **MYSQL_V1**:MySQL V1版。'."\n"
.'- **MYSQL_V2**:MySQL V2版。'."\n"
.'- **MYSQL_V3**:MySQL V3版。'."\n"
.'- **PG_V1**:PostgreSQL V1版。'."\n"
.'- **rdspg_v1**:RDS PostgreSQL V1版。'."\n"
.'- **polarpg_v1**:PolarDB PostgreSQL版 V1版。', 'type' => 'string', 'example' => 'MYSQL_V3'],
'HotEnable' => ['description' => '是否开启数据热存储。'."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'HotRetention' => ['description' => '数据热存储时长,单位为天。', 'type' => 'integer', 'format' => 'int32', 'example' => '7'],
'HotStartTime' => ['description' => '数据热存储开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1683712800000'],
'LogFilter' => ['description' => '预留参数。', 'type' => 'string', 'example' => 'None'],
'RequestEnable' => ['description' => '是否开启SQL洞察。'."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'RequestStartTime' => ['description' => 'SQL洞察开启时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1683712800000'],
'RequestStopTime' => ['description' => 'DAS企业版V1到期时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1715335200000'],
'Retention' => ['description' => '数据总存储时长,**HotRetention**与**ColdRetention**之和,单位为天。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'],
'SqlLogEnable' => ['description' => '是否开启了DAS企业版。'."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'SqlLogSource' => ['description' => '预留参数。', 'type' => 'string', 'example' => 'None'],
'SqlLogState' => ['description' => '数据迁移状态。'."\n"
."\n"
.'- **FINISH**: 历史数据迁移完成。'."\n"
.'- **RUNNING**: 历史数据迁移中。'."\n"
.'- **FAILURE**: 历史数据迁移失败。', 'type' => 'string', 'example' => 'FINISH'],
'SqlLogVisibleTime' => ['description' => 'DAS企业版开启的时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1683712800000'],
'SupportMigration' => ['description' => '预留参数。', 'type' => 'boolean', 'example' => 'None'],
'SupportVersion' => ['title' => '当前实例支持的数据库版本(不落库)', 'description' => '当前支持的最新DAS企业版版本。'."\n"
.'- **SQL_LOG_V0**:企业版 V0。'."\n"
.'- **SQL_LOG_V1**:企业版 V1。'."\n"
.'- **SQL_LOG_V2**:企业版 V2。'."\n"
.'- **SQL_LOG_V3**:企业版 V3。'."\n"
.'- **SQL_LOG_NOT_ENABLE**:未开启企业版。'."\n"
.'- **SQL_LOG_NOT_SUPPORT**: 不支持企业版。', 'type' => 'string', 'example' => 'SQL_LOG_V3'],
'Version' => ['title' => '当前审计日志的版本', 'description' => '当前开启的DAS企业版版本。'."\n"
.'- **SQL_LOG_V0**:企业版 V0。'."\n"
.'- **SQL_LOG_V1**:企业版 V1。'."\n"
.'- **SQL_LOG_V2**:企业版 V2。'."\n"
.'- **SQL_LOG_V3**:企业版 V3。'."\n"
.'- **SQL_LOG_NOT_ENABLE**:未开启企业版。'."\n"
.'- **SQL_LOG_NOT_SUPPORT**: 不支持企业版。', 'type' => 'string', 'example' => 'SQL_LOG_V3'],
],
],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '0A74B755-98B7-59DB-8724-1321B394****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
.'* **true**:执行成功'."\n"
.'* **false**:执行失败', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '查询DAS企业版配置信息',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'responseParamsDescription' => '对于**SQL_LOG_V0**(企业版 V0)和**SQL_LOG_V1**(企业版 V1) ,其数据存储在CStore中,视为热存储。开通该版本的数据库实例,查询返回结果中`SqlLogEnable = HotEnable = true, Retention = HotRetention, ColdEnable = false, ColdRetention = 0`。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSqlLogConfig'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeSqlLogConfig',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Data\\": {\\n \\"ColdEnable\\": true,\\n \\"ColdRetention\\": 23,\\n \\"ColdStartTime\\": 1683712800000,\\n \\"CollectorVersion\\": \\"MYSQL_V3\\",\\n \\"HotEnable\\": true,\\n \\"HotRetention\\": 7,\\n \\"HotStartTime\\": 1683712800000,\\n \\"LogFilter\\": \\"None\\",\\n \\"RequestEnable\\": true,\\n \\"RequestStartTime\\": 1683712800000,\\n \\"RequestStopTime\\": 1715335200000,\\n \\"Retention\\": 30,\\n \\"SqlLogEnable\\": true,\\n \\"SqlLogSource\\": \\"None\\",\\n \\"SqlLogState\\": \\"FINISH\\",\\n \\"SqlLogVisibleTime\\": 1683712800000,\\n \\"SupportMigration\\": true,\\n \\"SupportVersion\\": \\"SQL_LOG_V3\\",\\n \\"Version\\": \\"SQL_LOG_V3\\"\\n },\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"0A74B755-98B7-59DB-8724-1321B394****\\",\\n \\"Success\\": \\"true\\"\\n}","type":"json"}]',
],
'DescribeSqlLogRecords' => [
'summary' => '调用DescribeSqlLogRecords接口,查询DAS企业版日志明细。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '199697',
'abilityTreeNodes' => ['FEATUREhdmFT57I0'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['title' => '实例ID', 'description' => '数据库实例ID。', 'type' => 'string', 'required' => true, 'example' => 'pc-2ze8g2am97624****'."\n"],
],
[
'name' => 'NodeId',
'in' => 'formData',
'schema' => ['description' => '节点ID。'."\n"
."\n"
.'- 对于RDS MySQL和PolarDB MySQL版,该参数仅适用于集群版实例。若不传该参数,默认查询主节点日志明细。'."\n"
.'- 对于PolarDB-X 2.0,该参数传入**polarx_cn**(计算节点)或**polarx_dn**(数据节点)。', 'type' => 'string', 'required' => false, 'example' => 'pi-uf6k5f6g3912i****'],
],
[
'name' => 'Role',
'in' => 'query',
'schema' => ['description' => 'PolarDB-X 2.0数据库实例节点的角色。'."\n"
."\n"
.'- **polarx_cn **:计算节点。'."\n"
.'- **polarx_dn **:数据节点。', 'type' => 'string', 'required' => false, 'example' => 'polarx_cn '],
],
[
'name' => 'Filters',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '筛选条件列表。',
'type' => 'array',
'items' => [
'description' => '筛选条件。',
'type' => 'object',
'properties' => [
'Key' => ['title' => '过滤参数', 'description' => '过滤参数。'."\n"
."\n"
.'> 支持的过滤参数及其取值请参考**请求参数补充说明**。', 'type' => 'string', 'required' => false, 'example' => 'keyWords'],
'Value' => ['description' => '过滤参数取值。', 'type' => 'string', 'required' => false, 'example' => 'select'],
],
'required' => false,
],
'required' => false,
'maxItems' => 100,
],
],
[
'name' => 'StartTime',
'in' => 'formData',
'schema' => ['description' => '开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1596177993000'],
],
[
'name' => 'EndTime',
'in' => 'formData',
'schema' => ['description' => '结束时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1608888296000'],
],
[
'name' => 'PageNo',
'in' => 'formData',
'schema' => ['description' => '分页查询的页码,从1开始,默认为1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'],
],
[
'name' => 'PageSize',
'in' => 'formData',
'schema' => ['description' => '每页最大记录数,最大支持100,默认值为10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'],
],
],
'responses' => [
200 => [
'schema' => [
'title' => '根节点或根目录',
'description' => '根节点或根目录',
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'F43E7FB3-CE67-5FFD-A59C-EFD278BCD7BE'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'title' => 'SqlLogDetailResult',
'description' => '返回数据。',
'type' => 'object',
'properties' => [
'StartTime' => ['description' => '开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1596177993000'],
'EndTime' => ['description' => '结束时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1608888296000'],
'TotalRecords' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'Items' => [
'description' => '列表数据',
'type' => 'object',
'properties' => [
'SQLLogRecord' => [
'description' => 'SQL日志数据。',
'type' => 'array',
'items' => [
'description' => 'SQL日志数据。',
'type' => 'object',
'properties' => [
'Ext' => ['description' => '扩展信息字段,备用参数。', 'type' => 'string', 'example' => 'None'],
'ExecuteTime' => ['description' => '执行时间,格式为UTC时间:`yyyy-MM-ddTHH:mm:ssZ`。', 'type' => 'string', 'example' => '2023-12-07T02:15:32Z'],
'OriginTime' => ['description' => '执行时间戳,格式为Unix时间,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1701886532000'],
'HostAddress' => ['description' => '客户端IP地址。', 'type' => 'string', 'example' => '11.197.XX.XX'],
'UpdateRows' => ['description' => '更新行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'LogicRead' => ['description' => '逻辑读。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'SqlText' => ['description' => 'SQL语句。', 'type' => 'string', 'example' => 'select resource_id as cluster_id, tpl_name \\n\\tfrom dbfree_alert_resource_tpl_ref\\n\\twhere user_id=? and type=\'cluster\' group by resource_id, tpl_name'],
'LockTime' => ['description' => '锁等待时间,单位毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'ScanRows' => ['description' => '扫描行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'ThreadId' => ['description' => '线程ID。', 'type' => 'integer', 'format' => 'int64', 'example' => 'None'],
'State' => ['description' => '执行状态。'."\n"
."\n"
.'- **0**:执行成功。'."\n"
.'- **1**:执行失败。', 'type' => 'string', 'example' => '0'],
'DBName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'testdb'],
'SqlType' => ['description' => 'SQL语句的类型。', 'type' => 'string', 'example' => 'select'],
'AccountName' => ['description' => '数据库账号。', 'type' => 'string', 'example' => 'testname'],
'PhysicSyncRead' => ['description' => '物理同步读。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'PhysicAsyncRead' => ['description' => '物理异步读。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'TrxId' => ['description' => '事务ID。', 'type' => 'string', 'example' => '200000'],
'ReturnRows' => ['description' => '返回行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'Consume' => ['description' => '执行耗时(us)。', 'type' => 'integer', 'format' => 'int64', 'example' => '58'],
'Vip' => ['description' => '查询链接的endpoint解析地址。', 'type' => 'string', 'example' => '100.115.XX.XX'],
'NodeId' => ['description' => '节点ID。', 'type' => 'string', 'example' => 'pi-uf6k5f6g3912i****'],
'SqlId' => ['description' => 'SQL ID。', 'type' => 'string', 'example' => 'c67649d4a7fb62c4f8c7a447c52b5b17'],
'UseImciEngine' => ['description' => 'PolarDB MySQL版实例是否使用列存索引。'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'string', 'example' => 'true'],
'ParallelQueueTime' => ['description' => 'PolarDB MySQL版实例的并行度。', 'type' => 'string', 'example' => '2'],
'ParallelDegree' => ['description' => 'PolarDB MySQL版实例的并行排队时间,单位为毫秒。', 'type' => 'string', 'example' => '10'],
'Scnt' => ['description' => 'PolarDB-X 2.0计算节点(CN)的DN请求数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'Rows' => ['description' => 'PolarDB-X 2.0数据库实例计算节点总更新或返回的行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'Frows' => ['description' => 'PolarDB-X 2.0计算节点(CN)的拉取行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'TraceId' => ['description' => 'PolarDB-X 2.0的跟踪ID,即SQL在数据节点的执行ID。', 'type' => 'string', 'example' => '14c93b7c7bf00000 '],
'PhysicRead' => ['description' => '物理读。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'CpuTime' => ['description' => 'CPU执行时间,单位为微秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'],
'Writes' => ['description' => 'RDS SQL Server引擎的写入数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'Collection' => ['description' => '预留参数。', 'type' => 'string', 'example' => 'None'],
'TableName' => ['title' => 'SQL日志记录中的表名', 'description' => 'SQL日志记录中的表名', 'type' => 'string', 'example' => 'das'],
'ConnectionId' => ['title' => 'SQL日志记录的连接ID', 'description' => 'SQL日志记录的连接ID', 'type' => 'string', 'example' => 'ld-******'],
'Protocol' => ['title' => 'SQL日志记录的协议类型', 'description' => 'SQL日志记录的协议类型', 'type' => 'string', 'example' => 'MySQL'],
'Params' => ['title' => 'SQL日志记录的参数', 'description' => 'SQL日志记录的参数', 'type' => 'string', 'example' => '[1, "das"]'],
'ClientIp' => ['title' => 'SQL日志记录中的客户端IP'."\n"
.'SQL日志记录中客户端的IP地址', 'description' => 'SQL日志记录中的客户端IP'."\n"
.'SQL日志记录中客户端的IP地址', 'type' => 'string', 'example' => '10.0.0.1xx'],
'ClientPort' => ['title' => '客户端端口号', 'description' => '客户端端口号', 'type' => 'integer', 'format' => 'int64', 'example' => '3306'],
'RowKey' => ['title' => 'SQL日志记录的行键', 'description' => 'SQL日志记录的行键', 'type' => 'string', 'example' => '23'],
'AffectColumns' => ['title' => '受影响的列', 'description' => '受影响的列', 'type' => 'string', 'example' => '["col1"]'],
],
],
],
],
],
'Finish' => ['description' => '任务是否完成。'."\n"
.'- **0**:未完成'."\n"
.'- **1**:已完成'."\n"
."\n"
.'> 当**Finish**返回为0,并且包含**JobId**字段时,说明当前请求为异步请求,无法直接获取返回结果,需要进一步根据**JobId**进行查询。查询时将**JobId**作为**Filters**的输入值,例如:`Filters=[{"Key": "JobId", "Value": "******"}]`。', 'type' => 'string', 'example' => '1'],
'JobId' => ['description' => '异步任务ID。', 'type' => 'string', 'example' => 'MzI4NTZfUUlOR0RBT19DTTlfTlUyMF9NWVNRTF9PREJTX0xWU18zMjg1Nl9teXNxbF9XZWQgTWFyIDA2IDE0OjUwOjQ3IENTVCAyMDI0XzBfMzBfRXhlY3V0ZVRpbWVfREVTQ19XZWQgTWFyIDA2IDE0OjM1OjQ3IENTVCAyMDI0Xw==_1709708406465'],
],
],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '(废弃)查询DAS企业版日志明细',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'requestParamsDescription' => '**Key**支持的参数和取值:'."\n"
."\n"
.'- **KeyWords**:关键字,多个关键字间使用空格隔开。'."\n"
.'- **LogicalOperator**:关键字间的逻辑操作,取值为and或or。'."\n"
.'- **AccountName**:用户名,可以传递多个的,用逗号分开,上限为5。'."\n"
.'- **dbName**:数据库名称,可以传递多个的,用逗号分开,上限为5。'."\n"
.'- **HostAddress**:客户端IP地址,可以传递多个的,用逗号分开,上限为5。'."\n"
.'- **MaxConsume**:最大耗时,单位us。'."\n"
.'- **MinConsume**:最小耗时,单位us。'."\n"
.'- **MaxScanRows**:最大扫描行。'."\n"
.'- **MinScanRows**:最小扫描行。'."\n"
.'- **SqlType**:SQL类型,取值select、update、insert或delete。'."\n"
.'- **State**:执行结果,取值0(成功)或1(失败)。'."\n"
.'- **ThreadId**:线程ID。'."\n"
.'- **SortKey**:排序列名称,取值ScanRows(扫描行数)、UpdateRows(更新行数)、Consume(耗时)、ExecuteTime(执行时间)、ReturnRows(返回行数)、LockTime(锁等待时间)、Frows(PolarDB-X 2.0计算节点的拉取行数)、Scnt(PolarDB-X 2.0计算节点的DN请求数)、CpuTime(CPU执行时间)、PhysicalRead(物理读)。'."\n"
.'- **SortMethod**:排序方式,取值DESC(降序)、ASC(升序)。默认为DESC。'."\n"
.'- **TraceId**:PolarDB-X 2.0实例的跟踪ID。'."\n"
.'- **MinRows**:最小更新行数。'."\n"
.'- **MaxRows**:最大更新行数。'."\n"
.'- **MinScnt**:PolarDB-X 2.0计算节点(CN)的DN最小请求数。'."\n"
.'- **MaxScnt**:PolarDB-X 2.0计算节点(CN)的DN最大请求数。'."\n"
.'- **TrxId**:事务ID。'."\n"
.'- **Fail**:错误码。'."\n"
.'- **SqlId**:SQL ID。'."\n"
.'- **JobId**:通过异步任务ID进一步查询返回结果。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSqlLogRecords'],
],
],
'ramActions' => [
[
'operationType' => 'list',
'ramAction' => [
'action' => 'hdm:DescribeSqlLogRecords',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"F43E7FB3-CE67-5FFD-A59C-EFD278BCD7BE\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"StartTime\\": 1596177993000,\\n \\"EndTime\\": 1608888296000,\\n \\"TotalRecords\\": 1,\\n \\"Items\\": {\\n \\"SQLLogRecord\\": [\\n {\\n \\"Ext\\": \\"None\\",\\n \\"ExecuteTime\\": \\"2023-12-07T02:15:32Z\\",\\n \\"OriginTime\\": 1701886532000,\\n \\"HostAddress\\": \\"11.197.XX.XX\\",\\n \\"UpdateRows\\": 0,\\n \\"LogicRead\\": 0,\\n \\"SqlText\\": \\"select resource_id as cluster_id, tpl_name \\\\\\\\n\\\\\\\\tfrom dbfree_alert_resource_tpl_ref\\\\\\\\n\\\\\\\\twhere user_id=? and type=\'cluster\' group by resource_id, tpl_name\\",\\n \\"LockTime\\": 0,\\n \\"ScanRows\\": 0,\\n \\"ThreadId\\": 0,\\n \\"State\\": \\"0\\",\\n \\"DBName\\": \\"testdb\\",\\n \\"SqlType\\": \\"select\\",\\n \\"AccountName\\": \\"testname\\",\\n \\"PhysicSyncRead\\": 0,\\n \\"PhysicAsyncRead\\": 0,\\n \\"TrxId\\": \\"200000\\",\\n \\"ReturnRows\\": 0,\\n \\"Consume\\": 58,\\n \\"Vip\\": \\"100.115.XX.XX\\",\\n \\"NodeId\\": \\"pi-uf6k5f6g3912i****\\",\\n \\"SqlId\\": \\"c67649d4a7fb62c4f8c7a447c52b5b17\\",\\n \\"UseImciEngine\\": \\"true\\",\\n \\"ParallelQueueTime\\": \\"2\\",\\n \\"ParallelDegree\\": \\"10\\",\\n \\"Scnt\\": 10,\\n \\"Rows\\": 10,\\n \\"Frows\\": 10,\\n \\"TraceId\\": \\"14c93b7c7bf00000 \\",\\n \\"PhysicRead\\": 0,\\n \\"CpuTime\\": 100,\\n \\"Writes\\": 10,\\n \\"Collection\\": \\"None\\",\\n \\"TableName\\": \\"das\\",\\n \\"ConnectionId\\": \\"ld-******\\",\\n \\"Protocol\\": \\"MySQL\\",\\n \\"Params\\": \\"[1, \\\\\\"das\\\\\\"]\\",\\n \\"ClientIp\\": \\"10.0.0.1xx\\",\\n \\"ClientPort\\": 3306,\\n \\"RowKey\\": \\"23\\",\\n \\"AffectColumns\\": \\"[\\\\\\"col1\\\\\\"]\\"\\n }\\n ]\\n },\\n \\"Finish\\": \\"1\\",\\n \\"JobId\\": \\"MzI4NTZfUUlOR0RBT19DTTlfTlUyMF9NWVNRTF9PREJTX0xWU18zMjg1Nl9teXNxbF9XZWQgTWFyIDA2IDE0OjUwOjQ3IENTVCAyMDI0XzBfMzBfRXhlY3V0ZVRpbWVfREVTQ19XZWQgTWFyIDA2IDE0OjM1OjQ3IENTVCAyMDI0Xw==_1709708406465\\"\\n }\\n}","type":"json"}]',
],
'DescribeSqlLogStatistic' => [
'summary' => '调用DescribeSqlLogStatistic接口,查询DAS企业版的数据统计信息。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '198879',
'abilityTreeNodes' => ['FEATUREhdmFT57I0'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['description' => '数据库实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze1jdv45i7l6****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
.'* true:执行成功'."\n"
.'* false:执行失败'."\n", 'type' => 'string', 'example' => 'true'],
'Data' => [
'title' => 'SqlLogStatistic',
'description' => '返回数据。',
'type' => 'object',
'properties' => [
'Timestamp' => ['title' => '时间戳', 'description' => '时间戳,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1712568564928'],
'HotSqlSize' => [
'title' => '热数据量',
'description' => '总的热存储数据,单位字节(Byte)。',
'type' => 'integer',
'format' => 'int64',
'enumValueTitles' => [],
'example' => '1118042',
],
'ColdSqlSize' => ['title' => '冷数据量', 'description' => '总的冷存储数据,单位字节(Byte)。', 'type' => 'integer', 'format' => 'int64', 'example' => '8585901'],
'ImportSqlSize' => ['title' => '引入量', 'description' => '最近一天该的数据引入量,单位字节(Byte)。', 'type' => 'integer', 'format' => 'int64', 'example' => '297245'],
'FreeHotSqlSize' => ['description' => '免费的热存储数据,单位字节(Byte)。', 'type' => 'integer', 'format' => 'int64', 'example' => '297245'],
'FreeColdSqlSize' => ['description' => '免费的冷存储数据,单位字节(Byte)。', 'type' => 'integer', 'format' => 'int64', 'example' => '5041450'],
'TotalSqlSize' => ['description' => '总存储数据(冷数据+热数据)', 'type' => 'integer', 'format' => 'int64', 'example' => '9703943'],
],
],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"Timestamp\\": 1712568564928,\\n \\"HotSqlSize\\": 1118042,\\n \\"ColdSqlSize\\": 8585901,\\n \\"ImportSqlSize\\": 297245,\\n \\"FreeHotSqlSize\\": 297245,\\n \\"FreeColdSqlSize\\": 5041450,\\n \\"TotalSqlSize\\": 9703943\\n }\\n}","type":"json"}]',
'title' => '查询DAS企业版数据统计信息',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSqlLogStatistic'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeSqlLogStatistic',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'DescribeSqlLogTask' => [
'summary' => '调用DescribeSqlLogTask接口,查询DAS企业版离线任务详情。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '213185',
'abilityTreeNodes' => ['FEATUREhdmFT57I0'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['description' => '数据库实例ID。', 'type' => 'string', 'required' => false, 'example' => 'r-bp1nti25tc7bq5****'."\n"],
],
[
'name' => 'TaskId',
'in' => 'formData',
'schema' => ['description' => '任务ID。', 'type' => 'string', 'required' => false, 'example' => 'a4f5c4494dbd6713185d87a97aa53e8'."\n"],
],
[
'name' => 'PageNo',
'in' => 'formData',
'schema' => ['description' => '分页查询的页码,从1开始,默认为1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'],
],
[
'name' => 'PageSize',
'in' => 'formData',
'schema' => ['description' => '分页查询每页最大记录数,最大支持100,默认为10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'],
],
],
'responses' => [
200 => [
'schema' => [
'title' => '根节点或根目录',
'description' => '根节点或根目录',
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。'."\n"
."\n", 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'title' => 'SqlLogTaskDetail',
'description' => '返回数据。',
'type' => 'object',
'properties' => [
'Name' => ['title' => '任务名', 'description' => '任务名称。', 'type' => 'string', 'example' => 'SQL audit export 1'],
'TaskId' => ['title' => '任务ID', 'description' => '任务ID。', 'type' => 'string', 'example' => '9a4f5c4494dbd6713185d87a97aa53e8'."\n"],
'TaskType' => ['title' => '任务类型', 'description' => '任务类型。'."\n"
."\n"
.'- **Export**:导出任务。'."\n"
.'- **Query**:查询任务。', 'type' => 'string', 'example' => 'Query'],
'CreateTime' => ['title' => '任务创建时间', 'description' => '任务创建时间,格式为unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1681363254423'."\n"],
'Status' => ['title' => '任务状态', 'description' => '任务状态。'."\n"
.'- **INIT**:待调度 。'."\n"
.'- **RUNNING**:运行中。'."\n"
.'- **FAILED**:失败。'."\n"
.'- **CANCELED**:已取消。'."\n"
.'- **COMPLETED**:完成。'."\n"
.'> 当任务处于**COMPLETED**时,可以查看离线任务的结果。', 'type' => 'string', 'example' => 'COMPLETED'],
'Expire' => ['description' => '任务是否过期。'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'false'."\n"],
'Start' => ['title' => '查询开始时间', 'description' => '查询开始时间,格式为unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1596177993000'."\n"],
'End' => ['title' => '查询结束时间', 'description' => '查询结束时间,格式为unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1608888296000'."\n"],
'Filters' => [
'title' => '过滤条件',
'description' => '过滤条件。',
'type' => 'array',
'items' => [
'description' => '查询筛选条件。',
'type' => 'object',
'properties' => [
'Key' => ['title' => '过滤参数', 'description' => '过滤参数的名称。'."\n"
.'>支持的过滤参数及其取值请参考**返回参数补充说明**。', 'type' => 'string', 'example' => 'keyWords'."\n"],
'Value' => ['title' => '过滤值', 'description' => '过滤参数的值。', 'type' => 'any', 'example' => 'select'],
],
],
],
'Total' => ['title' => '总条数', 'description' => '任务总数。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'Queries' => [
'title' => '明细列表',
'description' => '离线查询任务结果。'."\n"
.'当TaskType == Query 时才会返回该值。',
'type' => 'array',
'items' => [
'description' => '离线查询任务结果。',
'type' => 'object',
'properties' => [
'Vip' => ['description' => '查询链接的endpoint解析地址。', 'type' => 'string', 'example' => '10.146.XX.XX'],
'NodeId' => ['description' => '子节点ID。', 'type' => 'string', 'example' => 'pi-bp1o58x3ib7e6****'."\n"],
'SqlText' => ['description' => 'SQL语句详情。', 'type' => 'string', 'example' => 'SELECT @@session.transaction_read_only'],
'SqlType' => ['description' => '选择SQL的类型。取值:'."\n"
.'- **SELECT**'."\n"
.'- **UPDATE**'."\n"
.'- **DELETE**', 'type' => 'string', 'example' => 'SELECT'],
'State' => ['description' => '执行结果。'."\n"
."\n"
.'- **0**:执行成功。'."\n"
.'- **1**:执行失败。', 'type' => 'string', 'example' => '0'],
'DBName' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'testdb01'],
'SqlId' => ['description' => 'SQL ID。', 'type' => 'string', 'example' => 'a4111670e80596c5bf42cf5154438a91'],
'ExecuteTime' => ['title' => 'yyyy-MM-dd\'T\'HH:mm:ss.SSS\'Z\'', 'description' => '执行时间,格式为UTC时间:`yyyy-MM-ddTHH:mm:ssZ`。', 'type' => 'string', 'example' => '2023-12-07T02:15:32Z'],
'OriginTime' => ['title' => 'ts unix', 'description' => '执行时间戳,格式为Unix时间,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1701886532000'."\n"],
'AccountName' => ['description' => '数据库账号。', 'type' => 'string', 'example' => 'testname'."\n"],
'HostAddress' => ['description' => '客户端IP地址。', 'type' => 'string', 'example' => '11.197.XX.XX'."\n"],
'Consume' => ['description' => '执行耗时,单位毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '58'],
'LockTime' => ['description' => '锁等待时间,单位毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'UpdateRows' => ['description' => '更新行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'ScanRows' => ['description' => '扫描行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'ReturnRows' => ['description' => '返回行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'LogicRead' => ['description' => '逻辑读。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'PhysicSyncRead' => ['description' => '物理同步读。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'PhysicAsyncRead' => ['description' => '物理异步读。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'ThreadId' => ['description' => '线程ID。', 'type' => 'integer', 'format' => 'int64', 'example' => 'None'],
'TrxId' => ['description' => '事务ID。', 'type' => 'string', 'example' => '200000'."\n"],
'Ext' => ['description' => '扩展信息字段,备用参数。', 'type' => 'string', 'example' => 'None'],
'Scnt' => ['title' => 'polarx cn节点,dn请求总数', 'description' => 'PolarDB-X 2.0计算节点(CN)的DN请求数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'."\n"],
'Rows' => ['title' => 'polarx cn节点,总更新/返回行数', 'description' => 'PolarDB-X 2.0数据库实例计算节点总更新或返回的行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'Frows' => ['title' => 'polarx cn节点,拉取行数', 'description' => 'PolarDB-X 2.0计算节点(CN)的拉取行数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'TraceId' => ['description' => 'PolarDB-X 2.0的跟踪ID,即SQL在数据节点的执行ID。', 'type' => 'string', 'example' => '14c93b7c7bf00000 '],
'UseImciEngine' => ['description' => 'PolarDB MySQL版实例是否使用列存索引。'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'string', 'example' => 'true'."\n"],
'ParallelDegree' => ['description' => 'PolarDB MySQL版实例的并行排队时间,单位为毫秒。', 'type' => 'string', 'example' => '10'."\n"],
'ParallelQueueTime' => ['description' => 'PolarDB MySQL版实例的并行度。', 'type' => 'string', 'example' => '2'],
'PhysicRead' => ['description' => '物理读。', 'type' => 'integer', 'format' => 'int64', 'example' => '0'],
'CpuTime' => ['description' => 'CPU执行时间,单位为微秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '100'."\n"],
'Writes' => ['description' => 'RDS SQL Server引擎的写入数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'Collection' => ['description' => '预留参数', 'type' => 'string', 'example' => 'None'],
'SqlCommand' => ['title' => '查询中的SQL命令', 'description' => '查询中的SQL命令', 'type' => 'integer', 'format' => 'int64', 'example' => 'sql'],
'ConnectionId' => ['title' => '查询中使用的连接ID', 'description' => '查询中使用的连接ID', 'type' => 'string', 'example' => 'ld-******'],
'Protected' => ['title' => '查询项是否受保护', 'description' => '查询项是否受保护', 'type' => 'string', 'example' => 'MySQL'],
'Params' => ['title' => '查询参数列表', 'description' => '查询参数列表', 'type' => 'string', 'example' => '[1, "das"]'],
'ClientIp' => ['title' => '查询中的客户端IP地址', 'description' => '查询中的客户端IP地址', 'type' => 'string', 'example' => '10.0.0.1xx'],
'ClientPort' => ['title' => '查询中客户端端口号', 'description' => '查询中客户端端口号', 'type' => 'integer', 'format' => 'int64', 'example' => '3306'],
'RowKey' => ['title' => '查询中的行键', 'description' => '查询中的行键', 'type' => 'string', 'example' => '23'],
'AffectColumns' => ['title' => '影响的列', 'description' => '影响的列', 'type' => 'string', 'example' => '["col1"]'],
'TableName' => ['title' => '查询中使用的表名', 'description' => '查询中使用的表名', 'type' => 'string', 'example' => 'das'],
],
],
],
'Export' => ['title' => '导出地址', 'description' => '导出任务的下载地址。当TaskType == Export 时才会返回该值。', 'type' => 'string', 'example' => '"https://das-sqllog-download-cn-hongkong.oss-cn-hongkong.aliyuncs.com/****"'],
],
],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"Name\\": \\"SQL audit export 1\\",\\n \\"TaskId\\": \\"9a4f5c4494dbd6713185d87a97aa53e8\\\\n\\",\\n \\"TaskType\\": \\"Query\\",\\n \\"CreateTime\\": 1681363254423,\\n \\"Status\\": \\"COMPLETED\\",\\n \\"Expire\\": true,\\n \\"Start\\": 1596177993000,\\n \\"End\\": 1608888296000,\\n \\"Filters\\": [\\n {\\n \\"Key\\": \\"keyWords\\\\n\\",\\n \\"Value\\": \\"select\\"\\n }\\n ],\\n \\"Total\\": 1,\\n \\"Queries\\": [\\n {\\n \\"Vip\\": \\"10.146.XX.XX\\",\\n \\"NodeId\\": \\"pi-bp1o58x3ib7e6****\\\\n\\",\\n \\"SqlText\\": \\"SELECT @@session.transaction_read_only\\",\\n \\"SqlType\\": \\"SELECT\\",\\n \\"State\\": \\"0\\",\\n \\"DBName\\": \\"testdb01\\",\\n \\"SqlId\\": \\"a4111670e80596c5bf42cf5154438a91\\",\\n \\"ExecuteTime\\": \\"2023-12-07T02:15:32Z\\",\\n \\"OriginTime\\": 1701886532000,\\n \\"AccountName\\": \\"testname\\\\n\\",\\n \\"HostAddress\\": \\"11.197.XX.XX\\\\n\\",\\n \\"Consume\\": 58,\\n \\"LockTime\\": 0,\\n \\"UpdateRows\\": 0,\\n \\"ScanRows\\": 0,\\n \\"ReturnRows\\": 0,\\n \\"LogicRead\\": 0,\\n \\"PhysicSyncRead\\": 0,\\n \\"PhysicAsyncRead\\": 0,\\n \\"ThreadId\\": 0,\\n \\"TrxId\\": \\"200000\\\\n\\",\\n \\"Ext\\": \\"None\\",\\n \\"Scnt\\": 10,\\n \\"Rows\\": 10,\\n \\"Frows\\": 10,\\n \\"TraceId\\": \\"14c93b7c7bf00000 \\",\\n \\"UseImciEngine\\": \\"true\\\\n\\",\\n \\"ParallelDegree\\": \\"10\\\\n\\",\\n \\"ParallelQueueTime\\": \\"2\\",\\n \\"PhysicRead\\": 0,\\n \\"CpuTime\\": 100,\\n \\"Writes\\": 10,\\n \\"Collection\\": \\"None\\",\\n \\"SqlCommand\\": 0,\\n \\"ConnectionId\\": \\"ld-******\\",\\n \\"Protected\\": \\"MySQL\\",\\n \\"Params\\": \\"[1, \\\\\\"das\\\\\\"]\\",\\n \\"ClientIp\\": \\"10.0.0.1xx\\",\\n \\"ClientPort\\": 3306,\\n \\"RowKey\\": \\"23\\",\\n \\"AffectColumns\\": \\"[\\\\\\"col1\\\\\\"]\\",\\n \\"TableName\\": \\"das\\"\\n }\\n ],\\n \\"Export\\": \\"\\\\\\"https://das-sqllog-download-cn-hongkong.oss-cn-hongkong.aliyuncs.com/****\\\\\\"\\"\\n }\\n}","type":"json"}]',
'title' => '查询DAS企业版离线任务详情',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'responseParamsDescription' => '**Key**支持的参数和取值:'."\n"
."\n"
.'- **KeyWords**:关键字,多个关键字间使用空格隔开。'."\n"
.'- **LogicalOperator**:关键字间的逻辑操作,取值为and或or。'."\n"
.'- **AccountName**:用户名,可以传递多个的,用逗号分开,上限为5。'."\n"
.'- **dbName**:数据库名称,可以传递多个的,用逗号分开,上限为5。'."\n"
.'- **HostAddress**:客户端IP地址,可以传递多个的,用逗号分开,上限为5。'."\n"
.'- **MaxConsume**:最大耗时,单位us。'."\n"
.'- **MinConsume**:最小耗时,单位us。'."\n"
.'- **MaxScanRows**:最大扫描行。'."\n"
.'- **MinScanRows**:最小扫描行。'."\n"
.'- **SqlType**:SQL类型,取值select、update、insert或delete。'."\n"
.'- **State**:执行结果,取值0(成功)或1(失败)。'."\n"
.'- **ThreadId**:线程ID。'."\n"
.'- **SortKey**:排序列名称,取值ScanRows(扫描行数)、UpdateRows(更新行数)、Consume(耗时)、ExecuteTime(执行时间)、ReturnRows(返回行数)、LockTime(锁等待时间)、Frows(PolarDB-X 2.0计算节点的拉取行数)、Scnt(PolarDB-X 2.0计算节点的DN请求数)、CpuTime(CPU执行时间)、PhysicalRead(物理读)。'."\n"
.'- **SortMethod**:排序方式,取值DESC(降序)、ASC(升序)。默认为DESC。'."\n"
.'- **TraceId**:PolarDB-X 2.0实例的跟踪ID。'."\n"
.'- **MinRows**:最小更新行数。'."\n"
.'- **MaxRows**:最大更新行数。'."\n"
.'- **MinScnt**:PolarDB-X 2.0计算节点(CN)的DN最小请求数。'."\n"
.'- **MaxScnt**:PolarDB-X 2.0计算节点(CN)的DN最大请求数。'."\n"
.'- **TrxId**:事务ID。'."\n"
.'- **Fail**:错误码。'."\n"
.'- **SqlId**:SQL ID。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSqlLogTask'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeSqlLogTask',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'DescribeSqlLogTasks' => [
'summary' => '查询实例的审计日志任务列表。',
'methods' => ['post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '199696',
'abilityTreeNodes' => ['FEATUREhdmFT57I0'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['description' => '数据库实例ID。', 'type' => 'string', 'required' => false, 'example' => 'r-bp1nti25tc7bq5****'],
],
[
'name' => 'NodeId',
'in' => 'formData',
'schema' => ['description' => '节点ID。'."\n"
.'>该参数仅适用于集群版实例,可以选择查询指定节点离线任务。若不传该参数,默认返回主节点离线任务。', 'type' => 'string', 'required' => false, 'example' => 'pi-bp1o58x3ib7e6****'],
],
[
'name' => 'Filters',
'in' => 'formData',
'style' => 'repeatList',
'schema' => [
'description' => '查询筛选条件列表。',
'type' => 'array',
'items' => [
'description' => '查询筛选条件。',
'type' => 'object',
'properties' => [
'Key' => ['title' => '过滤参数', 'description' => '过滤参数。'."\n"
."\n"
.'> 支持的过滤参数及其取值请参考**请求参数补充说明**。', 'type' => 'string', 'required' => false, 'example' => 'keyWords'],
'Value' => ['description' => '过滤参数的值。', 'type' => 'string', 'required' => false, 'example' => 'select'."\n"],
],
'required' => false,
],
'required' => false,
'maxItems' => 100,
],
],
[
'name' => 'StartTime',
'in' => 'formData',
'schema' => ['description' => '查询开始时间,格式为unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1596177993000'],
],
[
'name' => 'EndTime',
'in' => 'formData',
'schema' => ['description' => '查询结束时间,格式为unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1608888296000'],
],
[
'name' => 'PageNo',
'in' => 'formData',
'schema' => ['description' => '分页查询的页码,从1开始,默认为1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'],
],
[
'name' => 'PageSize',
'in' => 'formData',
'schema' => ['description' => '每页最大记录数,最大支持100,默认值为10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'title' => 'ListResult',
'description' => '返回数据。',
'type' => 'object',
'properties' => [
'List' => [
'description' => '返回信息列表。',
'type' => 'array',
'items' => [
'description' => '返回信息列表。',
'type' => 'object',
'properties' => [
'TaskId' => ['description' => '任务ID。', 'type' => 'string', 'example' => '9a4f5c4494dbd6713185d87a97aa53e8'],
'InstanceId' => ['title' => '实例标识', 'description' => '数据库实例ID。', 'type' => 'string', 'example' => 'r-bp1nti25tc7bq5****'."\n"],
'Name' => ['title' => '任务别名', 'description' => '任务名称。', 'type' => 'string', 'example' => 'SQL audit export 1'],
'Start' => ['title' => '查询开始时间', 'description' => '任务开始时间,格式为unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1683859555482'],
'End' => ['title' => '查询结束时间', 'description' => '任务结束时间,格式为unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1705975320000'],
'Status' => ['title' => '任务状态', 'description' => '任务状态。'."\n"
."\n"
.'- **INIT**:待调度 。'."\n"
.'- **RUNNING**:运行中。'."\n"
.'- **FAILED**:失败。'."\n"
.'- **CANCELED**:已取消。'."\n"
.'- **COMPLETED**:完成。'."\n"
."\n"
.'> 当任务处于**COMPLETED**时,可以查看离线任务的结果。', 'type' => 'string', 'example' => 'RUNNING'],
'LogCount' => ['title' => '日志总数', 'description' => '日志总数。', 'type' => 'integer', 'format' => 'int64', 'example' => '99999'],
'Progress' => ['title' => '任务进度', 'description' => '任务进度。', 'type' => 'integer', 'format' => 'int32', 'example' => '100'],
'ScanFileSize' => ['title' => '扫描的文件量', 'description' => '扫描的文件数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '3000'],
'Expire' => ['title' => '任务是否过期', 'description' => '任务是否过期。'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'false'],
'CreateTime' => ['title' => '任务创建时间', 'description' => '任务创建时间,格式为unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1681363254423'],
'AnalysisTaskFinishTime' => ['title' => '分析任务完成时间', 'description' => '分析任务完成时间,格式为unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1712751923000'],
'AnalysisTaskStatus' => ['description' => '分析任务状态。'."\n"
."\n"
.'> 系统内部参数,用户无需关注。', 'type' => 'string', 'example' => 'SCAN_ANALYZE_COMPLETED'],
'Result' => ['title' => 'oss链接或其他信息', 'description' => '任务类型为**Export**时的链接地址。', 'type' => 'string', 'example' => 'https://das-sqllog-download-cn-shanghai.oss-cn-shanghai.aliyuncs.com/la'],
'TaskType' => ['description' => '任务类型。'."\n"
."\n"
.'- **Export**:导出任务。'."\n"
.'- **Query**:查询任务。', 'type' => 'string', 'example' => 'Export'],
'Filters' => [
'description' => '查询筛选条件列表。',
'type' => 'array',
'items' => [
'description' => '查询筛选条件。',
'type' => 'object',
'properties' => [
'Key' => ['description' => '过滤参数。'."\n"
."\n"
.'> 支持的过滤参数及其取值请参考**请求参数补充说明**。', 'type' => 'string', 'example' => 'keyWords'."\n"],
'Value' => ['description' => '过滤参数的值。', 'type' => 'string', 'example' => 'select'."\n"],
],
],
],
'InnerResult' => ['description' => 'VPC内网地址', 'type' => 'string', 'example' => 'https://das-sqllog-download-oss-cn-shanghai-internal.aliyuncs.com'."\n"
.'/la'],
],
],
],
'Total' => ['description' => '任务数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '40'],
'PageNo' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'PageSize' => ['description' => '每页数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
],
],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"List\\": [\\n {\\n \\"TaskId\\": \\"9a4f5c4494dbd6713185d87a97aa53e8\\",\\n \\"InstanceId\\": \\"r-bp1nti25tc7bq5****\\\\n\\",\\n \\"Name\\": \\"SQL audit export 1\\",\\n \\"Start\\": 1683859555482,\\n \\"End\\": 1705975320000,\\n \\"Status\\": \\"RUNNING\\",\\n \\"LogCount\\": 99999,\\n \\"Progress\\": 100,\\n \\"ScanFileSize\\": 3000,\\n \\"Expire\\": false,\\n \\"CreateTime\\": 1681363254423,\\n \\"AnalysisTaskFinishTime\\": 1712751923000,\\n \\"AnalysisTaskStatus\\": \\"SCAN_ANALYZE_COMPLETED\\",\\n \\"Result\\": \\"https://das-sqllog-download-cn-shanghai.oss-cn-shanghai.aliyuncs.com/la\\",\\n \\"TaskType\\": \\"Export\\",\\n \\"Filters\\": [\\n {\\n \\"Key\\": \\"keyWords\\\\n\\",\\n \\"Value\\": \\"select\\\\n\\"\\n }\\n ],\\n \\"InnerResult\\": \\"https://das-sqllog-download-oss-cn-shanghai-internal.aliyuncs.com\\\\n/la\\"\\n }\\n ],\\n \\"Total\\": 40,\\n \\"PageNo\\": 1,\\n \\"PageSize\\": 10\\n }\\n}","type":"json"}]',
'title' => '查询DAS企业版离线任务列表',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'requestParamsDescription' => '**Key**支持的参数和取值:'."\n"
."\n"
.'- **taskId**:任务ID。'."\n"
.'- **keyWords**:任务名。'."\n"
.'- **status**:状态筛选,取值INIT(待调度)、RUNNING(运行中)、FAILED(失败)、CANCELED(已取消)、COMPLETED(完成)。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeSqlLogTasks'],
],
],
'ramActions' => [
[
'operationType' => 'list',
'ramAction' => [
'action' => 'hdm:DescribeSqlLogTasks',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'DescribeTopBigKeys' => [
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => ['FEATUREhdmTQGIFY'],
],
'parameters' => [
[
'name' => 'ConsoleContext',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => 'Redis实例ID。', 'type' => 'string', 'required' => true, 'example' => 'r-bp18ff4a195d****'],
],
[
'name' => 'NodeId',
'in' => 'query',
'schema' => ['description' => 'Redis实例的数据分片ID。', 'type' => 'string', 'required' => false, 'example' => 'r-x****-db-0'],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => ['description' => '查询任务开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'string', 'required' => true, 'example' => '1596177993000'],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => ['description' => '查询任务结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
.'> - 查询任务结束时间需晚于查询任务开始时间。'."\n"
.'> - 仅支持最大查询时间范围为4天内的数据。'."\n"
.'> - **StartTime**和**EndTime**最大查询间隔为3小时内。', 'type' => 'string', 'required' => true, 'example' => '1596177993001'],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'type' => 'object',
'properties' => [
'Message' => ['description' => '请求返回消息。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Data' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'BigKey' => [
'description' => '大Key详细信息列表。'."\n"
."\n"
.'> 查询时间段内没有大Key时,返回为空。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Key' => ['description' => '具体的Key。', 'type' => 'string', 'example' => 'abc:def:eng'],
'Db' => ['description' => 'Key所在的DB。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'KeyType' => ['description' => 'Key的类型。', 'type' => 'string', 'example' => 'zset'],
'Size' => ['description' => '元素的个数。', 'type' => 'integer', 'format' => 'int64', 'example' => '2'],
'NodeId' => ['description' => 'Redis实例的数据分片ID。', 'type' => 'string', 'example' => 'r-x****-db-0'],
],
'description' => '',
],
],
],
'description' => '',
],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => ' 获取排名前100的大Key',
'summary' => '调用DescribeTopBigKeys接口,获取一段时间内排名前100的大Key。',
'description' => '对数据结构为List、Hash、Set、Zset的Key,按照Key中元素的数量排序并展示排名前3的Key,记录为大Key。'."\n"
."\n"
.'- 在使用阿里云SDK时,需要保证aliyun-sdk-core的版本大于4.3.3,建议使用最新版本。'."\n"
.'- 使用DAS的SDK的版本为1.0.2或以上。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 本接口只适用于如下Redis实例:'."\n"
.' - 实例为Redis开源版或Tair(企业版)内存型。'."\n"
.' - 实例的小版本为最新。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeTopBigKeys'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeTopBigKeys',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Data\\": {\\n \\"BigKey\\": [\\n {\\n \\"Key\\": \\"abc:def:eng\\",\\n \\"Db\\": 0,\\n \\"KeyType\\": \\"zset\\",\\n \\"Size\\": 2,\\n \\"NodeId\\": \\"r-x****-db-0\\"\\n }\\n ]\\n },\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n \\n abc:def:eng\\n 0\\n zset\\n 2\\n r-x****-db-0\\n \\n 200\\n true\\n","errorExample":""}]',
],
'DescribeTopHotKeys' => [
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => ['FEATUREhdmROFBLE'],
],
'parameters' => [
[
'name' => 'ConsoleContext',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => 'Redis实例ID。', 'type' => 'string', 'required' => true, 'example' => 'r-bp18ff4a195d****'],
],
[
'name' => 'NodeId',
'in' => 'query',
'schema' => ['description' => 'Redis实例的数据分片ID。', 'type' => 'string', 'required' => false, 'example' => 'r-****-db-0'],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => ['description' => '查询任务开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'string', 'required' => true, 'example' => '1596177993000'],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => ['description' => '查询任务结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
.'> - 查询任务结束时间需晚于查询任务开始时间。'."\n"
.'> - 仅支持最大查询时间范围为4天内的数据。'."\n"
.'> - **StartTime**和**EndTime**最大查询间隔为3小时内。', 'type' => 'string', 'required' => true, 'example' => '1596177993001'],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'type' => 'object',
'properties' => [
'Message' => ['description' => '请求返回消息。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Data' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'HotKey' => [
'description' => '热Key详细信息列表。',
'type' => 'array',
'items' => [
'description' => '热key详细信息列表。',
'type' => 'object',
'properties' => [
'Db' => ['description' => 'Key所在的DB。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'],
'Key' => ['description' => '具体的Key。', 'type' => 'string', 'example' => 'abc:def:eng'],
'Hot' => ['description' => 'Key的访问频次,即Key的每秒访问数。', 'type' => 'string', 'example' => '5500~6000'],
'KeyType' => ['description' => 'Key类型。', 'type' => 'string', 'example' => 'zset'],
'Lfu' => ['description' => 'LFU算法的统计值。', 'type' => 'integer', 'format' => 'int32', 'example' => '253'],
'NodeId' => ['description' => 'Redis实例的数据分片ID。', 'type' => 'string', 'example' => 'r-x****-db-0'],
'InBytes' => ['description' => '入流量,单位Byte。仅按流量统计的热 Key 返回。', 'type' => 'integer', 'format' => 'int64', 'example' => '4502693'],
'OutBytes' => ['description' => '出流量,单位Byte。仅按流量统计的热 Key 返回。', 'type' => 'integer', 'format' => 'int64', 'example' => '1291659'],
'Category' => ['description' => '热Key类别:'."\n"
.'- **qps**:按QPS统计的热Key。'."\n"
.'- **traffic**:按流量统计的热Key。', 'type' => 'string', 'example' => 'qps'],
],
],
],
],
'description' => '',
],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '获取排名前100的热Key',
'summary' => '调用DescribeTopHotKeys接口,获取一段时间内排名前100的热Key。',
'description' => '当某个Key的QPS大于3,000时会被记录为热点Key。'."\n"
."\n"
.'- 在使用阿里云SDK时,需要保证aliyun-sdk-core的版本大于4.3.3,建议使用最新版本。'."\n"
.'- 使用DAS的SDK的版本为1.0.2或以上。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 本接口只适用于如下Redis实例:'."\n"
.' - 实例为Redis开源版或Tair(企业版)内存型。'."\n"
.' - 实例的小版本为最新。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DescribeTopHotKeys'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:DescribeTopHotKeys',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Data\\": {\\n \\"HotKey\\": [\\n {\\n \\"Db\\": 0,\\n \\"Key\\": \\"abc:def:eng\\",\\n \\"Hot\\": \\"5500~6000\\",\\n \\"KeyType\\": \\"zset\\",\\n \\"Lfu\\": 253,\\n \\"NodeId\\": \\"r-x****-db-0\\",\\n \\"InBytes\\": 4502693,\\n \\"OutBytes\\": 1291659,\\n \\"Category\\": \\"qps\\"\\n }\\n ]\\n },\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n \\n 0\\n abc:def:eng\\n 5500~6000\\n zset\\n 253\\n r-x****-db-0\\n \\n 200\\n true\\n","errorExample":""}]',
],
'DisableAllSqlConcurrencyControlRules' => [
'summary' => '调用DisableAllSqlConcurrencyControlRules接口,关闭全部正在执行的限流规则。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => ['operationType' => 'update'],
'parameters' => [
[
'name' => 'ConsoleContext',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。'."\n"
.'>仅支持RDS MySQL和 PolarDB MySQL版实例。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze1jdv45i7l6****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功'."\n"
.'- **false**:执行失败', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => ' 关闭全部正在执行的限流规则',
'description' => '本接口适用的数据库引擎为:'."\n"
.'- RDS MySQL'."\n"
.'- PolarDB MySQL版',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DisableAllSqlConcurrencyControlRules'],
],
],
'ramActions' => [
[
'operationType' => 'update',
'ramAction' => [
'action' => 'hdm:DisableAllSqlConcurrencyControlRules',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": \\"None\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n","errorExample":""}]',
],
'DisableAutoResourceOptimizeRules' => [
'summary' => '调用DisableAutoResourceOptimizeRules接口,批量关闭指定数据库实例的空间碎片自动回收功能。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'none',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => ['FEATUREhdmTFSOG0'],
],
'parameters' => [
[
'name' => 'ConsoleContext',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceIds',
'in' => 'query',
'schema' => ['description' => '数据库实例ID。'."\n"
."\n"
.'> 数据格式为JSONArray,例如`[\'实例ID1\',\'实例ID2\']`,实例ID间用英文逗号(,)分隔。', 'type' => 'string', 'required' => true, 'example' => '[\'rm-2ze8g2am97624****\',\'rm-2ze9xrhze0709****\']'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => [
'description' => '返回的数据。',
'type' => 'object',
'properties' => [
'TotalInstanceCount' => ['description' => '总数据库实例ID数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '2'],
'ConfigSuccessInstanceCount' => ['description' => '关闭空间碎片自动回收功能成功的数据库实例数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'ConfigFailInstanceCount' => ['description' => '关闭空间碎片自动回收功能失败的数据库实例数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'ConfigSuccessInstanceList' => [
'description' => '关闭空间碎片自动回收功能成功的数据库实例列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ConfigSuccess' => ['description' => '关闭设置是否成功:'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'InstanceId' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => 'rm-2ze8g2am97624****'],
],
'description' => '',
],
],
'ConfigFailInstanceList' => [
'description' => '关闭空间碎片自动回收功能失败的数据库实例列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ConfigSuccess' => ['description' => '关闭设置是否成功:'."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'false'],
'InstanceId' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => 'rm-2ze9xrhze0709****'],
'ErrorMessage' => ['description' => '错误信息。', 'type' => 'string', 'example' => 'cannot found instance by rm-2ze9xrhze0709****'],
],
'description' => '',
],
],
],
],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。'."\n", 'type' => 'boolean', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '关闭空间碎片自动回收功能',
'description' => '在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n",
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DisableAutoResourceOptimizeRules'],
],
],
'ramActions' => [
[
'operationType' => 'none',
'ramAction' => [
'action' => 'hdm:DisableAutoResourceOptimizeRules',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": {\\n \\"TotalInstanceCount\\": 2,\\n \\"ConfigSuccessInstanceCount\\": 1,\\n \\"ConfigFailInstanceCount\\": 1,\\n \\"ConfigSuccessInstanceList\\": [\\n {\\n \\"ConfigSuccess\\": true,\\n \\"InstanceId\\": \\"rm-2ze8g2am97624****\\"\\n }\\n ],\\n \\"ConfigFailInstanceList\\": [\\n {\\n \\"ConfigSuccess\\": false,\\n \\"InstanceId\\": \\"rm-2ze9xrhze0709****\\",\\n \\"ErrorMessage\\": \\"cannot found instance by rm-2ze9xrhze0709****\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n \\n 2\\n 1\\n 1\\n \\n true\\n rm-2ze8g2am97624****\\n \\n \\n false\\n rm-2ze9xrhze0709****\\n cannot found instance by rm-2ze9xrhze0709****\\n \\n \\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n","errorExample":""}]',
],
'DisableAutoThrottleRules' => [
'summary' => '调用DisableAutoThrottleRules接口,批量关闭指定数据库实例的自动SQL限流功能。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'none',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => ['FEATUREhdmDSULQV'],
],
'parameters' => [
[
'name' => 'ConsoleContext',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceIds',
'in' => 'query',
'schema' => ['description' => '数据库实例ID。'."\n"
."\n"
.'> 数据格式为JSONArray,例如`[\'实例ID1\',\'实例ID2\']`,实例ID间用英文逗号(,)分隔。', 'type' => 'string', 'required' => true, 'example' => '[\'rm-2ze8g2am97624****\',\'rm-2ze9xrhze0709****\']'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => [
'description' => '返回的数据。',
'type' => 'object',
'properties' => [
'TotalInstanceCount' => ['description' => '总数据库实例数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '2'],
'ConfigSuccessInstanceCount' => ['description' => '关闭自动SQL限流功能成功的数据库实例数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'ConfigFailInstanceCount' => ['description' => '关闭自动SQL限流功能失败的数据库实例数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'ConfigSuccessInstanceList' => [
'description' => '关闭自动SQL限流功能成功的数据库实例列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ConfigSuccess' => ['description' => '关闭设置是否成功:'."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'InstanceId' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => 'rm-2ze8g2am97624****'],
],
'description' => '',
],
],
'ConfigFailInstanceList' => [
'description' => '关闭自动SQL限流功能失败的数据库实例列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ConfigSuccess' => ['description' => '关闭设置是否成功:'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'false'],
'InstanceId' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => 'rm-2ze9xrhze0709****'],
'ErrorMessage' => ['description' => '错误信息。', 'type' => 'string', 'example' => 'cannot found instance by rm-2ze9xrhze0709****'],
],
'description' => '',
],
],
],
],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '关闭自动SQL限流功能',
'description' => '在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DisableAutoThrottleRules'],
],
],
'ramActions' => [
[
'operationType' => 'none',
'ramAction' => [
'action' => 'hdm:DisableAutoThrottleRules',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": {\\n \\"TotalInstanceCount\\": 2,\\n \\"ConfigSuccessInstanceCount\\": 1,\\n \\"ConfigFailInstanceCount\\": 1,\\n \\"ConfigSuccessInstanceList\\": [\\n {\\n \\"ConfigSuccess\\": true,\\n \\"InstanceId\\": \\"rm-2ze8g2am97624****\\"\\n }\\n ],\\n \\"ConfigFailInstanceList\\": [\\n {\\n \\"ConfigSuccess\\": false,\\n \\"InstanceId\\": \\"rm-2ze9xrhze0709****\\",\\n \\"ErrorMessage\\": \\"cannot found instance by rm-2ze9xrhze0709****\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n \\n 2\\n 1\\n 1\\n \\n true\\n rm-2ze8g2am97624****\\n \\n \\n false\\n rm-2ze9xrhze0709****\\n cannot found instance by rm-2ze9xrhze0709****\\n \\n \\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n","errorExample":""}]',
],
'DisableDasPro' => [
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => ['operationType' => 'delete'],
'parameters' => [
[
'name' => 'UserId',
'in' => 'query',
'schema' => ['description' => '用户ID,即创建数据库实例的阿里云主账号ID。'."\n"
."\n"
.'> 非必填,输入目标数据库实例ID后,在调用API接口时,系统会自动获取用户ID。', 'type' => 'string', 'required' => false, 'example' => '196278346919****'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '数据库实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '7172BECE-588A-5961-8126-C216E16B****'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Synchro' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'Data' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
['errorCode' => '-1020004', 'errorMessage' => 'the dbconfig is applying', 'description' => ''],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '关闭DAS企业版 V1',
'summary' => '关闭指定实例DAS专业版。',
'description' => '- 目前支持的数据库实例请参见[DAS企业版使用说明](~~190912~~)。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 该接口仅适用于DAS企业版 V1。'."\n"
.'>推荐使用[ModifySqlLogConfig](~~2778835~~)接口,为实例开启或关闭DAS企业版。DAS企业版各个版本支持的数据库和地域请参见[DAS产品系列及支持的功能](~~156204~~)。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DisableDasPro'],
],
],
'ramActions' => [
[
'operationType' => 'delete',
'ramAction' => [
'action' => 'hdm:DisableDasPro',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7172BECE-588A-5961-8126-C216E16B****\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Synchro\\": \\"None\\",\\n \\"Data\\": \\"None\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 7172BECE-588A-5961-8126-C216E16B****\\n Successful\\n 200\\n true\\n","errorExample":""}]',
],
'DisableInstanceDasConfig' => [
'summary' => '调用DisableInstanceDasConfig接口,关闭指定弹性伸缩功能。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => ['operationType' => 'update'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '数据库实例ID。', 'type' => 'string', 'required' => true, 'example' => 'r-bp1nti25tc7bq5****'],
],
[
'name' => 'Engine',
'in' => 'query',
'schema' => ['description' => '数据库引擎,当前仅支持Redis。', 'type' => 'string', 'required' => true, 'example' => 'Redis'],
],
[
'name' => 'ScaleType',
'in' => 'query',
'schema' => [
'description' => '弹性伸缩类型,取值:'."\n"
.'- **specScale**:规格自动弹性伸缩。'."\n"
.'- **shardScale**:分片自动弹性伸缩。'."\n"
.'- **bandwidthScale**:带宽自动弹性伸缩。',
'type' => 'string',
'required' => true,
'example' => 'bandwidthScale',
'enum' => ['specScale', 'shardScale', 'bandwidthScale'],
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => ['description' => '关闭数据库实例指定弹性伸缩功能的结果。', 'type' => 'string', 'example' => 'success'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '7172BECE-588A-5961-8126-C216E16B****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
.'* **true**:执行成功。'."\n"
.'* **false**:执行失败。'."\n", 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '关闭指定弹性伸缩功能',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 本接口当前仅适用于Redis数据库实例。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DisableInstanceDasConfig'],
],
],
'ramActions' => [
[
'operationType' => 'update',
'ramAction' => [
'action' => 'hdm:DisableInstanceDasConfig',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": \\"success\\",\\n \\"RequestId\\": \\"7172BECE-588A-5961-8126-C216E16B****\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n success\\n 7172BECE-588A-5961-8126-C216E16B****\\n true\\n","errorExample":""}]',
],
'DisableSqlConcurrencyControl' => [
'summary' => '调用DisableSqlConcurrencyControl接口,关闭指定限流规则。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => ['operationType' => 'update'],
'parameters' => [
[
'name' => 'ConsoleContext',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。'."\n"
.'>仅支持RDS MySQL和PolarDB MySQL版实例。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze1jdv45i7l6****'],
],
[
'name' => 'ItemId',
'in' => 'query',
'schema' => ['description' => '当前实例限流规则ID,可调用[GetRunningSqlConcurrencyControlRules](~~223538~~)接口获取。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => ['description' => '详细信息列表,包括信息总数、错误码等。', 'type' => 'string', 'example' => 'Null'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功'."\n"
.'- **false**:执行失败', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '关闭指定限流规则',
'description' => '本接口适用的数据库引擎为:'."\n"
.'- RDS MySQL'."\n"
.'- PolarDB MySQL版',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DisableSqlConcurrencyControl'],
],
],
'ramActions' => [
[
'operationType' => 'update',
'ramAction' => [
'action' => 'hdm:DisableSqlConcurrencyControl',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": \\"Null\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n Null\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n","errorExample":""}]',
],
'EnableDasPro' => [
'summary' => '开启指定实例DAS专业版。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'create',
'abilityTreeCode' => '23825',
'abilityTreeNodes' => ['FEATUREhdm543Z01'],
],
'parameters' => [
[
'name' => 'UserId',
'in' => 'query',
'schema' => ['description' => '用户ID,即创建数据库实例的阿里云主账号ID。'."\n"
."\n"
.'> 非必填,输入目标数据库实例ID后,在调用API接口时,系统会自动获取用户ID。', 'type' => 'string', 'required' => false, 'example' => '196278346919****'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '数据库实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
[
'name' => 'SqlRetention',
'in' => 'query',
'schema' => ['description' => 'SQL洞察数据存储时长,单位为天,默认为**30**。'."\n"
."\n"
.'- **30**'."\n"
.'- **180**'."\n"
.'- **365**'."\n"
.'- **1095**'."\n"
.'- **1825**', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '7172BECE-588A-5961-8126-C216E16B****'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Synchro' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'Data' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'Code' => ['description' => '状态码。', 'type' => 'string', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => ''],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => ''],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7172BECE-588A-5961-8126-C216E16B****\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Synchro\\": \\"None\\",\\n \\"Data\\": \\"None\\",\\n \\"Code\\": \\"200\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 7172BECE-588A-5961-8126-C216E16B****\\n Successful\\n 200\\n true\\n","errorExample":""}]',
'title' => '开启DAS企业版 V1',
'description' => '- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 该接口仅适用于DAS企业版 V1。'."\n"
."\n"
.'>推荐使用[ModifySqlLogConfig](~~2778835~~)接口,为实例开启或关闭DAS企业版。DAS企业版各个版本支持的数据库和地域请参见[DAS产品系列及支持的功能](~~156204~~)。',
'changeSet' => [],
'ramActions' => [
[
'operationType' => 'create',
'ramAction' => [
'action' => 'hdm:EnableDasPro',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'EnableSqlConcurrencyControl' => [
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => ['operationType' => 'create'],
'parameters' => [
[
'name' => 'ConsoleContext',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。'."\n"
.'>仅支持RDS MySQL和 PolarDB MySQL版实例。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze1jdv45i7l6****'],
],
[
'name' => 'SqlType',
'in' => 'query',
'schema' => ['description' => '选择SQL的类型。取值:'."\n"
.'- **SELECT**'."\n"
.'- **UPDATE**'."\n"
.'- **DELETE**', 'type' => 'string', 'required' => true, 'example' => 'SELECT'],
],
[
'name' => 'MaxConcurrency',
'in' => 'query',
'schema' => ['description' => 'SQL最大并发数,取值为大于或等于1的整数。'."\n"
.'>当包含关键词的SQL达到最大并发数时会触发限流规则。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '3'],
],
[
'name' => 'SqlKeywords',
'in' => 'query',
'schema' => ['description' => '需要限流的SQL关键词。'."\n"
.'>多个关键词间用波浪线(~)分隔,SQL语句中需要同时包含这些关键词才会触发限流规则。', 'type' => 'string', 'required' => true, 'example' => 'call~open~api~test~4~from~POP'],
],
[
'name' => 'ConcurrencyControlTime',
'in' => 'query',
'schema' => ['description' => 'SQL限流的生效时长,单位为秒。'."\n"
.'>限流规则仅在生效时间内开启。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '300'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => ['description' => '详细信息列表,包括信息总数、错误码等。', 'type' => 'string', 'example' => 'Null'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功'."\n"
.'- **false**:执行失败', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '启用SQL限流',
'summary' => '调用EnableSqlConcurrencyControl接口,启用SQL限流来控制数据库请求访问量和SQL并发量。',
'description' => '本接口适用的数据库引擎为:'."\n"
.'- RDS MySQL'."\n"
.'- PolarDB MySQL版',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EnableSqlConcurrencyControl'],
],
],
'ramActions' => [
[
'operationType' => 'create',
'ramAction' => [
'action' => 'hdm:EnableSqlConcurrencyControl',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": \\"Null\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n \\"Data\\": { \\"total\\": 1, \\"list\\":[...] }, \\"Code\\": 200, \\"Success\\": true }\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n","errorExample":""}]',
],
'GetAsyncErrorRequestListByCode' => [
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'systemTags' => ['operationType' => 'get'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
[
'name' => 'NodeId',
'in' => 'query',
'schema' => ['description' => '节点ID。'."\n"
.'> 对于PolarDB MySQL版实例,需要提供节点ID。', 'type' => 'string', 'required' => false, 'example' => 'pi-wz9s658475e58****'],
],
[
'name' => 'Start',
'in' => 'query',
'schema' => ['description' => '查询开始时间,格式为Unix时间戳,单位为毫秒。'."\n"
."\n"
.'> 查询开始时间需要在数据库实例SQL洞察存储时长范围内,最大不能早于当前时间90天。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1642556990714'],
],
[
'name' => 'End',
'in' => 'query',
'schema' => ['description' => '查询结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
."\n"
.'> 查询结束时间需晚于查询开始时间,且查询开始时间和查询结束时间的间隔不能超过1天。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1642566830000'],
],
[
'name' => 'ErrorCode',
'in' => 'query',
'schema' => ['description' => '错误码,您可调用[GetAsyncErrorRequestStatByCode](~~409804~~)接口查询实例的MySQL错误码。', 'type' => 'string', 'required' => false, 'example' => '1064'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => [
'description' => '返回的数据。',
'type' => 'object',
'properties' => [
'fail' => ['description' => '请求是否失败:'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'false'],
'result' => [
'description' => '产生指定MySQL错误码的SQL ID列表。',
'type' => 'array',
'items' => [
'description' => '产生指定MySQL错误码的SQL ID列表。',
'type' => 'object',
'properties' => [
'sqlId' => ['description' => 'SQL ID。', 'type' => 'string', 'example' => 'ad78a4e7d3ce81590c9dc2d5f4bc****'],
'instanceId' => ['description' => '实例ID。', 'type' => 'string', 'example' => 'rm-2ze8g2am97624****'],
],
],
],
'resultId' => ['description' => '异步请求ID。', 'type' => 'string', 'example' => 'async__c39d43ece52d35267cc4b92a0c26****'],
'isFinish' => ['description' => '异步请求是否执行完成:'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'state' => ['description' => '异步请求的执行状态:'."\n"
."\n"
.'- **RUNNING**:正在运行。'."\n"
."\n"
.'- **SUCCESS**:成功。'."\n"
."\n"
.'- **FAIL**:失败。', 'type' => 'string', 'example' => 'SUCCESS'],
'complete' => ['description' => '异步请求是否完成:'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'timestamp' => ['description' => '执行时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1644559407740'],
],
'example' => '{ "fail": false, "data": [ { "sqlId": "ad78a4e7d3ce81590c9dc2d5f4bc****", "instanceId": "rm-2ze8g2am97624****" }, { "sqlId": "0f92feacd92c048b06a16617a633****", "instanceId": "rm-2ze8g2am97624****" } ], "resultId": "async__c39d43ece52d35267cc4b92a0c26****", "isFinish": true, "state": "SUCCESS", "complete": true, "timestamp": 1644559407740 }',
],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '9CB97BC4-6479-55D0-B9D0-EA925AFE****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '查询产生指定MySQL错误码的SQL ID',
'summary' => '调用GetAsyncErrorRequestListByCode接口,异步查询数据库实例SQL洞察结果中产生指定MySQL错误码的SQL ID。',
'description' => '> 异步调用后不会立即返回完整结果,当返回数据中**isFinish**取值为**false**时,请等待1s后重新发起调用,直到**isFinish**取值为**true**时,返回完整结果。'."\n"
."\n\n"
.'- 目前仅支持RDS MySQL和PolarDB MySQL版实例,请确保在使用该接口前,该实例已经开启DAS企业版,具体请参见[购买DAS企业版](~~163298~~)。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 2024年09月01日起,由于SQL的模板化算法优化,调用本接口时,SqlId 字段的值将发生变更。详情请参见[【通知】SQL模板化算法优化](~~2845725~~)。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetAsyncErrorRequestListByCode'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:GetAsyncErrorRequestListByCode',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": {\\n \\"fail\\": false,\\n \\"result\\": [\\n {\\n \\"sqlId\\": \\"ad78a4e7d3ce81590c9dc2d5f4bc****\\",\\n \\"instanceId\\": \\"rm-2ze8g2am97624****\\"\\n }\\n ],\\n \\"resultId\\": \\"async__c39d43ece52d35267cc4b92a0c26****\\",\\n \\"isFinish\\": true,\\n \\"state\\": \\"SUCCESS\\",\\n \\"complete\\": true,\\n \\"timestamp\\": 1644559407740\\n },\\n \\"RequestId\\": \\"9CB97BC4-6479-55D0-B9D0-EA925AFE****\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n \\n false\\n \\n ad78a4e7d3ce81590c9dc2d5f4bc****\\n rm-2ze8g2am97624****\\n \\n async__c39d43ece52d35267cc4b92a0c26****\\n true\\n SUCCESS\\n true\\n 1644559407740\\n \\n 9CB97BC4-6479-55D0-B9D0-EA925AFE****\\n true\\n","errorExample":""}]',
],
'GetAsyncErrorRequestStatByCode' => [
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'systemTags' => ['operationType' => 'get'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
[
'name' => 'NodeId',
'in' => 'query',
'schema' => ['description' => '节点ID。'."\n"
.'> 对于PolarDB MySQL版实例,需要提供节点ID。', 'type' => 'string', 'required' => false, 'example' => 'pi-wz9s658475e58****'],
],
[
'name' => 'Start',
'in' => 'query',
'schema' => ['description' => '查询开始时间,格式为Unix时间戳,单位为毫秒。'."\n"
."\n"
.'> 查询开始时间需在数据库实例SQL洞察存储时长范围内,最大不能早于当前时间90天。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1642556990714'],
],
[
'name' => 'End',
'in' => 'query',
'schema' => ['description' => '查询的结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
."\n"
.'> 查询结束时间需晚于查询开始时间,且查询开始时间和查询结束时间的间隔不能超过1天。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1642566830000'],
],
[
'name' => 'DbName',
'in' => 'query',
'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => false, 'example' => 'testdb01'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => [
'description' => '返回的数据。'."\n"
."\n",
'type' => 'object',
'properties' => [
'fail' => ['description' => '请求是否失败:'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'false'],
'isFinish' => ['description' => '异步请求是否执行完成:'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'resultId' => ['description' => '异步请求ID。', 'type' => 'string', 'example' => 'async__fcd7c35788e62324622c3b4a03de****'],
'state' => ['description' => '异步请求的执行状态:'."\n"
."\n"
.'- **RUNNING**:正在运行。'."\n"
."\n"
.'- **SUCCESS**:成功。'."\n"
."\n"
.'- **FAIL**:失败。', 'type' => 'string', 'example' => 'SUCCESS'],
'timestamp' => ['description' => '执行时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1644560866961'],
'complete' => ['description' => '异步请求是否完成:'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'result' => [
'description' => '返回的错误码以及每个错误码对应的SQL数量列表。',
'type' => 'array',
'items' => [
'description' => '返回的错误码以及每个错误码对应的SQL数量列表。',
'type' => 'object',
'properties' => [
'instanceId' => ['description' => '实例ID。', 'type' => 'string', 'example' => 'rm-2ze8g2am97624****'],
'errorCode' => ['description' => '错误码。', 'type' => 'string', 'example' => '1062'],
'count' => ['description' => '错误码对应SQL的数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'],
],
],
],
],
'example' => '{ "fail": false, "data": [ { "instanceId": "rm-2ze8g2am97624****", "count": 1, "errorCode": "1062" }, { "instanceId": "rm-2ze8g2am97624****", "count": 2, "errorCode": "1064" } ], "resultId": "async__fcd7c35788e62324622c3b4a03de****", "isFinish": true, "state": "SUCCESS", "complete": true, "timestamp": 1644560866961 }',
],
'RequestId' => ['description' => '请求的ID。', 'type' => 'string', 'example' => '840F51F7-9C01-538D-94F6-AE712905****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '查询MySQL错误码以及每个错误码对应的SQL数量',
'summary' => '调用GetAsyncErrorRequestStatByCode接口,异步查询数据库实例SQL洞察结果中的MySQL错误码以及每个错误码对应的SQL数量。',
'description' => '> 异步调用后不会立即返回完整结果,当返回数据中**isFinish**取值为**false**时,请等待1s后重新发起调用,直到**isFinish**取值为**true**时,返回完整结果。'."\n"
."\n"
.'- 目前仅支持RDS MySQL和PolarDB MySQL版实例,请确保在使用该接口前,该实例已经开启DAS企业版,具体请参见[购买DAS企业版](~~163298~~)。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetAsyncErrorRequestStatByCode'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:GetAsyncErrorRequestStatByCode',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": {\\n \\"fail\\": false,\\n \\"isFinish\\": true,\\n \\"resultId\\": \\"async__fcd7c35788e62324622c3b4a03de****\\",\\n \\"state\\": \\"SUCCESS\\",\\n \\"timestamp\\": 1644560866961,\\n \\"complete\\": true,\\n \\"result\\": [\\n {\\n \\"instanceId\\": \\"rm-2ze8g2am97624****\\",\\n \\"errorCode\\": \\"1062\\",\\n \\"count\\": 1\\n }\\n ]\\n },\\n \\"RequestId\\": \\"840F51F7-9C01-538D-94F6-AE712905****\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n \\n false\\n true\\n async__fcd7c35788e62324622c3b4a03de****\\n SUCCESS\\n 1644560866961\\n true\\n \\n rm-2ze8g2am97624****\\n 1062\\n 1\\n \\n \\n 840F51F7-9C01-538D-94F6-AE712905****\\n true\\n","errorExample":""}]',
],
'GetAsyncErrorRequestStatResult' => [
'summary' => '调用GetAsyncErrorRequestStatResult接口,异步获取数据库实例SQL洞察结果中指定SQL的执行错误次数。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => ['FEATUREhdmFT57I0'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
[
'name' => 'NodeId',
'in' => 'query',
'schema' => ['description' => '节点ID。'."\n"
."\n"
.'> 对于PolarDB MySQL版实例,需要提供节点ID。', 'type' => 'string', 'required' => false, 'example' => 'pi-bp179lg03445l****'],
],
[
'name' => 'SqlIdList',
'in' => 'query',
'schema' => ['description' => 'SQL ID,多个SQL ID请使用英文逗号分隔。您可以调用[GetAsyncErrorRequestListByCode](~~410746~~)接口查询实例中产生MySQL错误码的SQL ID。', 'type' => 'string', 'required' => false, 'example' => 'ad78a4e7d3ce81590c9dc2d5f4bc****,0f92feacd92c048b06a16617a633****'],
],
[
'name' => 'Start',
'in' => 'query',
'schema' => ['description' => '查询开始时间,格式为Unix时间戳,单位为毫秒。'."\n"
."\n"
.'> 查询开始时间需在数据库实例SQL洞察存储时长范围内,最大不能早于当前时间90天。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1642556990714'],
],
[
'name' => 'End',
'in' => 'query',
'schema' => ['description' => '查询结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
."\n"
.'> 查询结束时间需晚于查询开始时间,且查询开始时间和查询结束时间的间隔不能超过1天。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1642566830000'],
],
[
'name' => 'DbName',
'in' => 'query',
'schema' => ['description' => '数据库名称。', 'type' => 'string', 'required' => false, 'example' => 'testdb01'],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '返回数据列表。',
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => [
'description' => '返回的数据。',
'type' => 'object',
'properties' => [
'fail' => ['description' => '请求是否失败:'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'false'],
'isFinish' => ['description' => '异步请求是否执行完成:'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'resultId' => ['description' => '异步请求ID。', 'type' => 'string', 'example' => 'async__61f45ee381b2fa4e8a6545e3bee9****'],
'state' => ['description' => '异步请求的执行状态:'."\n"
."\n"
.'- **RUNNING**:正在运行。'."\n"
."\n"
.'- **SUCCESS**:成功。'."\n"
."\n"
.'- **FAIL**:失败。', 'type' => 'string', 'example' => 'SUCCESS'],
'timestamp' => ['description' => '执行时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1644558576717'],
'complete' => ['description' => '异步请求是否完成:'."\n"
."\n"
.'- **true**:是。'."\n"
."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'result' => [
'description' => '异步请求的返回数据列表。',
'type' => 'object',
'additionalProperties' => [
'type' => 'object',
'properties' => [
'sqlId' => ['type' => 'string', 'description' => 'SQL模板ID', 'example' => '61f45ee381b2fa4e8a6545e3bee9'],
'instanceId' => ['type' => 'string', 'example' => 'rm-xxx', 'description' => '实例ID'],
'count' => ['type' => 'integer', 'format' => 'int32', 'description' => '数量', 'example' => '10'],
],
'description' => '异步请求的返回数据列表。',
],
],
],
'example' => '{ "fail": false, "data": { "ad78a4e7d3ce81590c9dc2d5f4bc****": { "sqlId": "ad78a4e7d3ce81590c9dc2d5f4bc****", "instanceId": "rm-2ze8g2am97624****", "count": 1 }, "0f92feacd92c048b06a16617a633****": { "sqlId": "0f92feacd92c048b06a16617a633****", "instanceId": "rm-2ze8g2am97624****", "count": 2 } }, "resultId": "async__61f45ee381b2fa4e8a6545e3bee9****", "isFinish": true, "state": "SUCCESS", "complete": true, "timestamp": 1644558576717 }',
],
'RequestId' => ['description' => '请求的ID。', 'type' => 'string', 'example' => '3FC3F8EB-3564-5D1A-B187-3B03E5B0****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'true'],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": {\\n \\"fail\\": false,\\n \\"isFinish\\": true,\\n \\"resultId\\": \\"async__61f45ee381b2fa4e8a6545e3bee9****\\",\\n \\"state\\": \\"SUCCESS\\",\\n \\"timestamp\\": 1644558576717,\\n \\"complete\\": true,\\n \\"result\\": {\\n \\"key\\": {\\n \\"sqlId\\": \\"61f45ee381b2fa4e8a6545e3bee9\\",\\n \\"instanceId\\": \\"rm-xxx\\",\\n \\"count\\": 10\\n }\\n }\\n },\\n \\"RequestId\\": \\"3FC3F8EB-3564-5D1A-B187-3B03E5B0****\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n \\n false\\n true\\n async__61f45ee381b2fa4e8a6545e3bee9****\\n SUCCESS\\n 1644558576717\\n true\\n \\n \\n ad78a4e7d3ce81590c9dc2d5f4bc****\\n rm-2ze8g2am97624****\\n 1\\n \\n \\n \\n 3FC3F8EB-3564-5D1A-B187-3B03E5B0****\\n true\\n","errorExample":""}]',
'title' => '获取指定SQL的执行错误次数',
'description' => '> 异步调用后不会立即返回完整结果,当返回数据中**isFinish**取值为**false**时,请等待1s后重新发起调用,直到**isFinish**取值为**true**时,返回完整结果。'."\n"
."\n\n"
.'- 目前仅支持RDS MySQL和PolarDB MySQL版实例,请确保在使用该接口前,该实例已经开启DAS企业版,具体请参见[购买DAS企业版](~~163298~~)。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetAsyncErrorRequestStatResult'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:GetAsyncErrorRequestStatResult',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'GetAutoIncrementUsageStatistic' => [
'summary' => '调用GetAutoIncrementUsageStatistic接口,获取表自增ID的使用数据。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
[
'name' => 'DbNames',
'in' => 'query',
'schema' => ['description' => '数据库名。传入此参数时,查询指定数据库中表自增ID使用情况,不传入时查询实例上所有数据库的表自增ID使用情况。'."\n"
.'>数据格式为JSONArray,例如[\'db1\',\'db2\'],数据库名间用英文逗号(,)分隔。', 'type' => 'string', 'required' => false, 'example' => '[\'db1\',\'db2\']'],
],
[
'name' => 'RatioFilter',
'in' => 'query',
'schema' => ['description' => '自增ID使用比例过滤值,只返回超过该比例的自增ID使用数据。取值为0~1的小数。', 'type' => 'number', 'format' => 'double', 'required' => true, 'example' => '0.9'],
],
[
'name' => 'RealTime',
'in' => 'query',
'schema' => ['description' => '是否获取实时数据:'."\n"
."\n"
.'- **true**:实时查询实例上数据并计算。最小查询时间粒度为10分钟,即有10分钟内的数据时,即使传递**true**也不进行实时查询。'."\n"
.'- **false**:当有近两小时的数据时,返回该数据,否则查询实例上最新数据。', 'type' => 'boolean', 'required' => true, 'example' => 'false'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => [
'description' => '返回的数据。',
'type' => 'object',
'properties' => [
'Finish' => ['description' => '任务是否结束:'."\n"
."\n"
.'- **true**:任务结束。'."\n"
.'- **false**:任务未结束。', 'type' => 'boolean', 'example' => 'false'],
'Timestamp' => ['description' => '执行时间,格式为Unix时间戳,单位为毫秒(ms)。', 'type' => 'integer', 'format' => 'int64', 'example' => '1697183353000'],
'TaskStatus' => ['description' => '任务状态:'."\n"
.'- **INIT**:初始化。'."\n"
.'- **RUNNING**:任务执行中。'."\n"
.'- **SUCCESS**:任务成功。'."\n"
.'- **FAIL**:任务失败。', 'type' => 'string', 'example' => 'INIT'],
'ErrorInfo' => ['description' => '任务失败时的错误信息。', 'type' => 'string', 'example' => 'the given database name list invalid, none of the database names in the list exist on the instance'],
'AutoIncrementUsageList' => [
'description' => '自增ID使用数据列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'DbName' => ['description' => '数据库名。', 'type' => 'string', 'example' => 'db01'],
'TableName' => ['description' => '表名。', 'type' => 'string', 'example' => 'test_table'],
'ColumnName' => ['description' => '列名。', 'type' => 'string', 'example' => 'id'],
'AutoIncrementCurrentValue' => ['description' => '自增ID当前值。', 'type' => 'integer', 'format' => 'int64', 'example' => '2147483647'],
'MaximumValue' => ['description' => '该数据类型的自增ID支持的最大值。', 'type' => 'integer', 'format' => 'int64', 'example' => '2147483647'],
'AutoIncrementRatio' => ['description' => '自增ID使用比例。', 'type' => 'number', 'format' => 'double', 'example' => '1'],
],
'description' => '',
],
],
],
],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '0A74B755-98B7-59DB-8724-1321B394****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '获取表自增ID使用数据',
'description' => '- 本接口只适用于RDS MySQL和PolarDB MySQL版实例。'."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'extraInfo' => '- 调用接口时,当返回数据中Finish不为true时,需要继续调用。当Finish为true且TaskStatus为SUCCESS时,可以查看具体的自增ID使用数据。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetAutoIncrementUsageStatistic'],
],
],
'ramActions' => [
[
'operationType' => 'none',
'ramAction' => [
'action' => 'hdm:GetAutoIncrementUsageStatistic',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": {\\n \\"Finish\\": false,\\n \\"Timestamp\\": 1697183353000,\\n \\"TaskStatus\\": \\"INIT\\",\\n \\"ErrorInfo\\": \\"the given database name list invalid, none of the database names in the list exist on the instance\\",\\n \\"AutoIncrementUsageList\\": [\\n {\\n \\"DbName\\": \\"db01\\",\\n \\"TableName\\": \\"test_table\\",\\n \\"ColumnName\\": \\"id\\",\\n \\"AutoIncrementCurrentValue\\": 2147483647,\\n \\"MaximumValue\\": 2147483647,\\n \\"AutoIncrementRatio\\": 1\\n }\\n ]\\n },\\n \\"RequestId\\": \\"0A74B755-98B7-59DB-8724-1321B394****\\",\\n \\"Success\\": true\\n}","type":"json"}]',
],
'GetAutoResourceOptimizeRules' => [
'summary' => '获取指定数据库实例的空间碎片自动回收规则。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free'],
'parameters' => [
[
'name' => 'ConsoleContext',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceIds',
'in' => 'query',
'schema' => ['description' => '数据库实例ID。'."\n"
."\n"
.'- 数据格式为JSONArray,例如`[\'实例ID1\',\'实例ID2\']`,实例ID间用英文逗号(,)分隔。'."\n"
.'- 不输入数据库实例ID时,默认返回当前账号曾经开启过空间碎片自动回收功能的全部数据库实例信息,包括:'."\n"
.' - 正在使用该功能的数据库实例。'."\n"
.' - 已关闭该功能的数据库实例(包含已经关闭了DAS企业版数据库实例,但不包含已经释放的数据库实例)。', 'type' => 'string', 'required' => false, 'example' => '[\'rm-2ze8g2am97624****\',\'rm-2vc54m2a6pd6p****\',\'rm-2ze9xrhze0709****\',\'rm-2ze8g2am97627****\']'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => [
'description' => '返回的数据。'."\n"
."\n",
'type' => 'object',
'properties' => [
'TotalAutoResourceOptimizeRulesCount' => ['description' => '所有开启过空间碎片自动回收功能的数据库实例数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '3'],
'EnableAutoResourceOptimizeCount' => ['description' => '正在使用空间碎片自动回收功能的数据库实例数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'TurnOffAutoResourceOptimizeCount' => ['description' => '曾经开启并且当前已关闭空间碎片自动回收功能的数据库实例数量。'."\n", 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'HasEnableRuleButNotDasProCount' => ['description' => '已开启并且未关闭空间碎片自动回收功能,但已不再使用DAS企业版的数据库实例数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'EnableAutoResourceOptimizeList' => [
'description' => '正在使用空间碎片自动回收功能的数据库实例信息列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'InstanceId' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => 'rm-2ze8g2am97624****'],
'AutoDefragment' => ['description' => '是否开启了自动空间碎片回收功能。'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'TableSpaceSize' => ['description' => '触发空间碎片自动回收单个物理表的最小空间,单位为GB。', 'type' => 'number', 'format' => 'double', 'example' => '10'],
'DasProOn' => ['description' => '是否开启了DAS企业版。'."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'TableFragmentationRatio' => ['description' => '触发空间碎片自动回收单个物理表的碎片率。', 'type' => 'number', 'format' => 'double', 'example' => '0.2'],
'UserId' => ['description' => '用户ID,即创建数据库实例的阿里云主账号ID。', 'type' => 'string', 'example' => '140692647406****'],
],
'description' => '',
],
],
'TurnOffAutoResourceOptimizeList' => [
'description' => '曾经开启并且当前已关闭空间碎片自动回收功能的数据库实例信息列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'InstanceId' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => 'rm-2vc54m2a6pd6p****'],
'AutoDefragment' => ['description' => '是否开启了自动空间碎片回收功能。'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'false'],
'TableSpaceSize' => ['description' => '触发空间碎片自动回收单个物理表的最小空间,单位为GB。', 'type' => 'number', 'format' => 'double', 'example' => '10'],
'DasProOn' => ['description' => '是否开启了DAS企业版。'."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'TableFragmentationRatio' => ['description' => '触发空间碎片自动回收单个物理表的碎片率。', 'type' => 'number', 'format' => 'double', 'example' => '0.2'],
'UserId' => ['description' => '用户ID,即创建数据库实例的阿里云主账号ID。', 'type' => 'string', 'example' => '140692647406****'],
],
'description' => '',
],
],
'HasEnableRuleButNotDasProList' => [
'description' => '已开启并且未关闭空间碎片自动回收功能,但已不再使用DAS企业版的数据库实例列表。'."\n"
.'> 此类数据库实例不会执行空间碎片自动回收,直至再次为数据库实例开启DAS企业版。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'InstanceId' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => 'rm-2ze9xrhze0709****'],
'AutoDefragment' => ['description' => '是否开启了自动空间碎片回收功能。'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'TableSpaceSize' => ['description' => '触发空间碎片自动回收单个物理表的最小空间,单位为GB。', 'type' => 'number', 'format' => 'double', 'example' => '10'],
'DasProOn' => ['description' => '是否开启了DAS企业版。'."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'false'],
'TableFragmentationRatio' => ['description' => '触发空间碎片自动回收单个物理表的碎片率。', 'type' => 'number', 'format' => 'double', 'example' => '0.2'],
'UserId' => ['description' => '用户ID,即创建数据库实例的阿里云主账号ID。', 'type' => 'string', 'example' => '140692647406****'],
],
'description' => '',
],
],
'NeverEnableAutoResourceOptimizeOrReleasedInstanceCount' => ['description' => '从未开启过空间碎片自动回收或者实例不存在的数据库实例数量。'."\n"
.'> 实例不存在:数据库实例已经释放或者传入的数据库实例ID存在错误。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'NeverEnableAutoResourceOptimizeOrReleasedInstanceIdList' => [
'description' => '从未开启过空间碎片自动回收或者实例不存在的数据库实例信息列表。',
'type' => 'array',
'items' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => 'rm-2ze8g2am97624****'],
],
],
],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '获取空间碎片自动回收规则',
'description' => '使用该接口需满足以下前提条件:'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
."\n"
.'- 实例类型为RDS MySQL高可用系列。'."\n"
."\n"
.'- 数据库实例的CPU规格不小于4核,且**innodb_file_per_table**参数值为**ON**。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetAutoResourceOptimizeRules'],
],
],
'ramActions' => [
[
'operationType' => 'none',
'ramAction' => [
'action' => 'hdm:GetAutoResourceOptimizeRules',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": {\\n \\"TotalAutoResourceOptimizeRulesCount\\": 3,\\n \\"EnableAutoResourceOptimizeCount\\": 1,\\n \\"TurnOffAutoResourceOptimizeCount\\": 1,\\n \\"HasEnableRuleButNotDasProCount\\": 1,\\n \\"EnableAutoResourceOptimizeList\\": [\\n {\\n \\"InstanceId\\": \\"rm-2ze8g2am97624****\\",\\n \\"AutoDefragment\\": true,\\n \\"TableSpaceSize\\": 10,\\n \\"DasProOn\\": true,\\n \\"TableFragmentationRatio\\": 0.2,\\n \\"UserId\\": \\"140692647406****\\"\\n }\\n ],\\n \\"TurnOffAutoResourceOptimizeList\\": [\\n {\\n \\"InstanceId\\": \\"rm-2vc54m2a6pd6p****\\",\\n \\"AutoDefragment\\": false,\\n \\"TableSpaceSize\\": 10,\\n \\"DasProOn\\": true,\\n \\"TableFragmentationRatio\\": 0.2,\\n \\"UserId\\": \\"140692647406****\\"\\n }\\n ],\\n \\"HasEnableRuleButNotDasProList\\": [\\n {\\n \\"InstanceId\\": \\"rm-2ze9xrhze0709****\\",\\n \\"AutoDefragment\\": true,\\n \\"TableSpaceSize\\": 10,\\n \\"DasProOn\\": false,\\n \\"TableFragmentationRatio\\": 0.2,\\n \\"UserId\\": \\"140692647406****\\"\\n }\\n ],\\n \\"NeverEnableAutoResourceOptimizeOrReleasedInstanceCount\\": 1,\\n \\"NeverEnableAutoResourceOptimizeOrReleasedInstanceIdList\\": [\\n \\"rm-2ze8g2am97624****\\"\\n ]\\n },\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n \\n 3\\n 1\\n 1\\n 1\\n \\n rm-2ze8g2am97624****\\n true\\n 10\\n true\\n 0.2\\n 140692647406****\\n \\n \\n rm-2vc54m2a6pd6p****\\n false\\n 10\\n true\\n 0.2\\n 140692647406****\\n \\n \\n rm-2ze9xrhze0709****\\n true\\n 10\\n false\\n 0.2\\n 140692647406****\\n \\n 1\\n rm-2ze8g2am97624****\\n \\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n true\\n","errorExample":""}]',
],
'GetAutoThrottleRules' => [
'summary' => '获取指定数据库实例的自动SQL限流规则。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free'],
'parameters' => [
[
'name' => 'ConsoleContext',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceIds',
'in' => 'query',
'schema' => ['description' => '数据库实例ID。'."\n"
."\n"
.'- 数据格式为JSONArray,例如`[\'实例ID1\',\'实例ID2\']`,实例ID间用英文逗号(,)分隔。'."\n"
.'- 不输入数据库实例ID时,默认返回当前账号曾经开启过自动SQL限流功能的全部数据库实例信息,包括:'."\n"
.' - 正在使用该功能的数据库实例。'."\n"
.' - 已关闭该功能的数据库实例(不包含已经释放的数据库实例)。', 'type' => 'string', 'required' => false, 'example' => '[\'rm-2ze8g2am97624****\',\'rm-2vc54m2a6pd6p****\',\'rm-2ze9xrhze0709****\']'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => [
'description' => '返回的数据。',
'type' => 'object',
'properties' => [
'TotalAutoThrottleRulesCount' => ['description' => '所有开启过自动SQL限流功能的数据库数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '3'],
'EnableAutoThrottleCount' => ['description' => '正在使用自动SQL限流功能的数据库实例数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'TurnOffAutoThrottleCount' => ['description' => '曾经开启并且当前已关闭自动SQL限流功能的数据库实例数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'NeverEnableAutoThrottleOrReleasedInstanceCount' => ['description' => '从未开启过自动SQL限流或者实例不存在的数据库实例数量。'."\n"
.'> 实例不存在:数据库实例已经释放或者传入的数据库实例ID存在错误。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'EnableAutoThrottleList' => [
'description' => '正在使用自动SQL限流功能的数据库实例信息列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'AbnormalDuration' => ['description' => '触发自动限SQL流规则的异常的持续时间阈值,单位:分钟。', 'type' => 'number', 'format' => 'double', 'example' => '2'],
'CpuUsage' => ['description' => 'CPU利用率阈值。', 'type' => 'number', 'format' => 'double', 'example' => '70'],
'CpuSessionRelation' => ['description' => 'CPU利用率阈值和活跃会话数阈值的逻辑关系:'."\n"
."\n"
.'- **AND**:且。'."\n"
.'- **OR**:或。', 'type' => 'string', 'example' => 'AND'],
'ActiveSessions' => ['description' => '活跃会话数量阈值。', 'type' => 'integer', 'format' => 'int64', 'example' => '32'],
'MaxThrottleTime' => ['description' => '最大限流时长,单位:分钟。', 'type' => 'number', 'format' => 'double', 'example' => '10'],
'AllowThrottleStartTime' => ['description' => '可限流时间段的开始时间(UTC时间)。', 'type' => 'string', 'example' => '00:00Z'],
'AllowThrottleEndTime' => ['description' => '可限流时间段的结束时间(UTC时间)。', 'type' => 'string', 'example' => '23:59Z'],
'Visible' => ['description' => '自动SQL限流规则是否开启:'."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'AutoKillSession' => ['description' => '是否同时KILL执行中的异常SQL:'."\n"
.'> 异常SQL:与需要限流的SQL模板相同。'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'InstanceId' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => 'rm-2ze8g2am97624****'],
'UserId' => ['description' => '用户ID,即创建数据库实例的阿里云主账号ID。', 'type' => 'string', 'example' => '140692647406****'],
],
'description' => '',
],
],
'TurnOffAutoThrottleList' => [
'description' => '曾经开启并且当前已关闭自动SQL限流功能的数据库实例信息列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'AbnormalDuration' => ['description' => '触发自动限流规则的持续时间阈值,单位:分钟。', 'type' => 'number', 'format' => 'double', 'example' => '2'],
'CpuUsage' => ['description' => 'CPU利用率阈值。', 'type' => 'number', 'format' => 'double', 'example' => '80'],
'AllowThrottleEndTime' => ['description' => '可限流时间段的结束时间(UTC时间)。', 'type' => 'string', 'example' => '23:59Z'],
'InstanceId' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => 'rm-2ze9xrhze0709****'],
'Visible' => ['description' => '自动SQL限流规则是否开启:'."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'false'],
'CpuSessionRelation' => ['description' => 'CPU利用率阈值和活跃会话数阈值的关系:'."\n"
.'- **AND**:且。'."\n"
.'- **OR**:或。', 'type' => 'string', 'example' => 'OR'],
'AutoKillSession' => ['description' => '是否同时KILL执行中的异常SQL:'."\n"
.'> 异常SQL:与需要限流的SQL模板相同。'."\n"
."\n"
.'- **true**:是。'."\n"
.'- **false**:否。', 'type' => 'boolean', 'example' => 'true'],
'ActiveSessions' => ['description' => '活跃会话数阈值。', 'type' => 'integer', 'format' => 'int64', 'example' => '64'],
'MaxThrottleTime' => ['description' => '最大限流时长,单位:分钟。', 'type' => 'number', 'format' => 'double', 'example' => '10'],
'UserId' => ['description' => '用户ID,即创建数据库实例的阿里云主账号ID。', 'type' => 'string', 'example' => '140692647406****'],
'AllowThrottleStartTime' => ['description' => '可限流时间段的开始时间(UTC时间)。', 'type' => 'string', 'example' => '00:00Z'],
],
'description' => '',
],
],
'NeverEnableAutoThrottleOrReleasedInstanceIdList' => [
'description' => '从未开启过自动SQL限流或者实例不存在的数据库实例数量。'."\n"
.'> 实例不存在:数据库实例已经释放或者传入的数据库实例ID存在错误。',
'type' => 'array',
'items' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => 'rm-2vc54m2a6pd6p****'],
],
],
],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '7172BECE-588A-5961-8126-C216E16B****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '获取自动SQL限流规则',
'description' => '使用该接口需满足以下前提条件:'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 目标数据库实例为:'."\n"
.' - RDS MySQL 5.6、5.7、 8.0高可用系列、三节点企业系列。'."\n"
.' - PolarDB MySQL版 5.6集群版、5.7集群版、 8.0集群版。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetAutoThrottleRules'],
],
],
'ramActions' => [
[
'operationType' => 'none',
'ramAction' => [
'action' => 'hdm:GetAutoThrottleRules',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": {\\n \\"TotalAutoThrottleRulesCount\\": 3,\\n \\"EnableAutoThrottleCount\\": 1,\\n \\"TurnOffAutoThrottleCount\\": 1,\\n \\"NeverEnableAutoThrottleOrReleasedInstanceCount\\": 1,\\n \\"EnableAutoThrottleList\\": [\\n {\\n \\"AbnormalDuration\\": 2,\\n \\"CpuUsage\\": 70,\\n \\"CpuSessionRelation\\": \\"AND\\",\\n \\"ActiveSessions\\": 32,\\n \\"MaxThrottleTime\\": 10,\\n \\"AllowThrottleStartTime\\": \\"00:00Z\\",\\n \\"AllowThrottleEndTime\\": \\"23:59Z\\",\\n \\"Visible\\": true,\\n \\"AutoKillSession\\": true,\\n \\"InstanceId\\": \\"rm-2ze8g2am97624****\\",\\n \\"UserId\\": \\"140692647406****\\"\\n }\\n ],\\n \\"TurnOffAutoThrottleList\\": [\\n {\\n \\"AbnormalDuration\\": 2,\\n \\"CpuUsage\\": 80,\\n \\"AllowThrottleEndTime\\": \\"23:59Z\\",\\n \\"InstanceId\\": \\"rm-2ze9xrhze0709****\\",\\n \\"Visible\\": false,\\n \\"CpuSessionRelation\\": \\"OR\\",\\n \\"AutoKillSession\\": true,\\n \\"ActiveSessions\\": 64,\\n \\"MaxThrottleTime\\": 10,\\n \\"UserId\\": \\"140692647406****\\",\\n \\"AllowThrottleStartTime\\": \\"00:00Z\\"\\n }\\n ],\\n \\"NeverEnableAutoThrottleOrReleasedInstanceIdList\\": [\\n \\"rm-2vc54m2a6pd6p****\\"\\n ]\\n },\\n \\"RequestId\\": \\"7172BECE-588A-5961-8126-C216E16B****\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n Successful\\n \\n 3\\n 1\\n 1\\n 1\\n \\n 2\\n 70\\n AND\\n 32\\n 10\\n 00:00Z\\n 23:59Z\\n true\\n true\\n rm-2ze8g2am97624****\\n 140692647406****\\n \\n \\n 2\\n 80\\n 23:59Z\\n rm-2ze9xrhze0709****\\n false\\n OR\\n true\\n 64\\n 10\\n 140692647406****\\n 00:00Z\\n \\n rm-2vc54m2a6pd6p****\\n \\n 7172BECE-588A-5961-8126-C216E16B****\\n true\\n","errorExample":""}]',
],
'GetAutonomousNotifyEventContent' => [
'summary' => '调用GetAutonomousNotifyEventContent接口,获取指定数据库实例自治事件的内容。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '23868',
'abilityTreeNodes' => ['FEATUREhdmETIPZF'],
],
'parameters' => [
[
'name' => '__context',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-18ff4a195d****'],
],
[
'name' => 'SpanId',
'in' => 'query',
'schema' => ['description' => '事件的唯一标识,您可调用[GetAutonomousNotifyEventsInRange](~~288371~~)接口查看返回参数中的SpanId。', 'type' => 'string', 'required' => true, 'example' => '7e7b2774-95b8-4fa3-bd9c-0ab47cb7****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Data' => ['description' => '详细信息列表。', 'type' => 'string', 'example' => '{\\"taskId\\":\\"7e1ba595-0889-48ff-a6ff-010f54991d****\\",\\"taskType\\":\\"SQL_OPTIMIZE\\",\\"advisorId\\":\\"636dc5f34664dd56ff0****\\",\\"sqlId\\":\\"e2b1d6c1ee1bb29555a828b59f16****\\",\\"indexAdviceCount\\":1,\\"indexAdvices\\":[{\\"schemaName\\":\\"das\\",\\"tableName\\":\\"students\\",\\"indexName\\":\\"idx_name\\",\\"columns\\":[\\"name\\"],\\"unique\\":false,\\"ddlAddIndex\\":\\"ALTER TABLE `das`.`students` ADD INDEX `idx_name` (`name`)\\",\\"priority\\":0,\\"optimizeId\\":\\"96232794517277511\\"}],\\"tuningAdvices\\":[],\\"improvement\\":8127.25,\\"supportLevel\\":3,\\"priority\\":\\"HIGH\\"}'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '获取实例自治事件内容',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 当您的实例接入DAS之后,DAS异常检测发现数据库相关的监控指标发生变化,就会触发快照抓取等通知类事件。'."\n"
."\n"
.' '."\n"
.'>只有开启[自治中心](~~152139~~)才能获取通知事件的详情。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetAutonomousNotifyEventContent'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:GetAutonomousNotifyEventContent',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Data\\": \\"{\\\\\\\\\\\\\\"taskId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"7e1ba595-0889-48ff-a6ff-010f54991d****\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"taskType\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"SQL_OPTIMIZE\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"advisorId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"636dc5f34664dd56ff0****\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"sqlId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"e2b1d6c1ee1bb29555a828b59f16****\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"indexAdviceCount\\\\\\\\\\\\\\":1,\\\\\\\\\\\\\\"indexAdvices\\\\\\\\\\\\\\":[{\\\\\\\\\\\\\\"schemaName\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"das\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"tableName\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"students\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"indexName\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"idx_name\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"columns\\\\\\\\\\\\\\":[\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\"],\\\\\\\\\\\\\\"unique\\\\\\\\\\\\\\":false,\\\\\\\\\\\\\\"ddlAddIndex\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"ALTER TABLE `das`.`students` ADD INDEX `idx_name` (`name`)\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"priority\\\\\\\\\\\\\\":0,\\\\\\\\\\\\\\"optimizeId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"96232794517277511\\\\\\\\\\\\\\"}],\\\\\\\\\\\\\\"tuningAdvices\\\\\\\\\\\\\\":[],\\\\\\\\\\\\\\"improvement\\\\\\\\\\\\\\":8127.25,\\\\\\\\\\\\\\"supportLevel\\\\\\\\\\\\\\":3,\\\\\\\\\\\\\\"priority\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"HIGH\\\\\\\\\\\\\\"}\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n {\\"taskId\\":\\"7e1ba595-0889-48ff-a6ff-010f54991d****\\",\\"taskType\\":\\"SQL_OPTIMIZE\\",\\"advisorId\\":\\"636dc5f34664dd56ff0****\\",\\"sqlId\\":\\"e2b1d6c1ee1bb29555a828b59f16****\\",\\"indexAdviceCount\\":1,\\"indexAdvices\\":[{\\"schemaName\\":\\"das\\",\\"tableName\\":\\"students\\",\\"indexName\\":\\"idx_name\\",\\"columns\\":[\\"name\\"],\\"unique\\":false,\\"ddlAddIndex\\":\\"ALTER TABLE `das`.`students` ADD INDEX `idx_name` (`name`)\\",\\"priority\\":0,\\"optimizeId\\":\\"96232794517277511\\"}],\\"tuningAdvices\\":[],\\"improvement\\":8127.25,\\"supportLevel\\":3,\\"priority\\":\\"HIGH\\"}\\n 200\\n true\\n","errorExample":""}]',
],
'GetAutonomousNotifyEventsInRange' => [
'summary' => '调用GetAutonomousNotifyEventsInRange接口,获取指定类型或范围的通知事件。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '23871',
'abilityTreeNodes' => ['FEATUREhdm56JBRC'],
],
'parameters' => [
[
'name' => '__context',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '实例ID。', 'type' => 'string', 'required' => false, 'example' => 'rm-18ff4a195d****'],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => ['description' => '查询任务开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'string', 'required' => true, 'example' => '1568269711000'],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => ['description' => '查询任务结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
.'>查询任务结束时间需晚于查询任务开始时间。', 'type' => 'string', 'required' => true, 'example' => '1568265711221'],
],
[
'name' => 'NodeId',
'in' => 'query',
'schema' => ['description' => 'PolarDB的节点ID,您可以通过调用[DescribeDBClusters](~~98094~~)接口查看返回参数的DBNodeId。'."\n"
.'>仅支持PolarDB MySQL版实例。', 'type' => 'string', 'required' => false, 'example' => 'r-x****-db-0'],
],
[
'name' => 'EventContext',
'in' => 'query',
'schema' => ['description' => '备用参数。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'Level',
'in' => 'query',
'schema' => ['description' => '指定事件紧急程度,当该字段设置时,MinLevel参数将无效。取值:'."\n"
."\n"
.'- **Notice**:通知类事件。'."\n"
.'- **Optimization**:优化类事件。'."\n"
.'- **Warn**:警告类事件。'."\n"
.'- **Critical**:危机类事件。', 'type' => 'string', 'required' => false, 'example' => 'Warn'],
],
[
'name' => 'MinLevel',
'in' => 'query',
'schema' => ['description' => '最小事件紧急程度。取值:'."\n"
."\n"
.'- **Notice**:通知类事件。'."\n"
.'- **Optimization**:优化类事件。'."\n"
.'- **Warn**:警告类事件。'."\n"
.'- **Critical**:危机类事件。', 'type' => 'string', 'required' => false, 'example' => 'Notice'],
],
[
'name' => 'PageOffset',
'in' => 'query',
'schema' => ['description' => '分页查询,页码,取值大于0且不超过Integer数据类型的最大值,默认值为1。', 'type' => 'string', 'required' => false, 'example' => '1'],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => ['description' => '分页查询,每页大小。', 'type' => 'string', 'required' => false, 'example' => '30'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Data' => [
'description' => '详细信息列表,包括信息总数、错误码等。',
'type' => 'object',
'properties' => [
'Extra' => ['description' => '备用参数。', 'type' => 'string', 'example' => 'None'],
'List' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'T' => [
'description' => '详细信息列表,包括信息总数、错误码等。',
'type' => 'array',
'items' => ['description' => '详细信息列表。', 'type' => 'string', 'example' => '"T": []'],
],
],
'description' => '',
],
'PageNo' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'PageSize' => ['description' => '每页最大记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'Total' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '4'],
],
],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '获取指定类型或范围的通知事件',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 当您的实例接入DAS之后,DAS异常检测发现数据库相关的监控指标发生变化,就会触发快照抓取等通知类事件。'."\n"
."\n"
.' '."\n"
.'>只有开启[自治中心](~~152139~~)才能获取通知事件的详情。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetAutonomousNotifyEventsInRange'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:GetAutonomousNotifyEventsInRange',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Data\\": {\\n \\"Extra\\": \\"None\\",\\n \\"List\\": {\\n \\"T\\": [\\n \\"\\\\\\"T\\\\\\": []\\"\\n ]\\n },\\n \\"PageNo\\": 1,\\n \\"PageSize\\": 10,\\n \\"Total\\": 4\\n },\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n Successful\\n B6D17591-B48B-4D31-9CD6-9B9796B2****\\n \\n \\n
\\n 1\\n 10\\n None\\n 4\\n \\n 200\\n true\\n","errorExample":""}]',
],
'GetBlockingDetailList' => [
'summary' => '调用GetBlockingDetailList接口,查询RDS SQL Server实例的锁阻塞列表。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => ['operationType' => 'list'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '数据库实例ID。'."\n"
."\n", 'type' => 'string', 'required' => true, 'example' => 'rm-t4nfalp2ap421****'],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => ['description' => '查询开始时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'string', 'required' => true, 'example' => '1679429913757'],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => ['description' => '查询结束时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'string', 'required' => true, 'example' => '1682490480548'],
],
[
'name' => 'PageNo',
'in' => 'query',
'schema' => ['description' => '页码,取值大于0且不超过Integer数据类型的最大值,默认值为1。', 'type' => 'string', 'required' => false, 'example' => '1'],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => ['description' => '每页最大记录数,取值大于0且不超过Integer数据类型的最大值,默认值为10。', 'type' => 'string', 'required' => false, 'example' => '10'],
],
[
'name' => 'QueryHash',
'in' => 'query',
'schema' => ['description' => 'SQL哈希值。将SQL语句进行Hash之后得出的值,同一种SQL对应同一个QueryHash。', 'type' => 'string', 'required' => false, 'example' => 'DC08B955CAD25E7B'],
],
[
'name' => 'DbNameList',
'in' => 'query',
'schema' => ['description' => '数据库名。传入多个数据库时,各个数据库名称间使用英文逗号(,)进行分隔。', 'type' => 'string', 'required' => false, 'example' => 'testdb1,testdb2'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => [
'description' => '返回的数据。',
'type' => 'object',
'properties' => [
'List' => [
'description' => '返回信息列表。',
'type' => 'array',
'items' => [
'description' => '数据详情。',
'type' => 'object',
'properties' => [
'BatchId' => ['description' => '采集批次。', 'type' => 'integer', 'format' => 'int64', 'example' => '1683530096156'],
'ClientAppName' => ['description' => '客户端名称。', 'type' => 'string', 'example' => '.Net SqlClient Data Provider'],
'DataBase' => ['description' => '数据库名称。', 'type' => 'string', 'example' => 'testdb1'],
'HostName' => ['description' => '客户端主机名称。', 'type' => 'string', 'example' => 'ALLBNMGTAPPRD01'],
'LoginId' => ['description' => '登录用户名。', 'type' => 'string', 'example' => 'Testuser'],
'QueryHash' => ['description' => 'SQL HASH值。', 'type' => 'string', 'example' => 'DC08B955CAD25E7B'],
'Spid' => ['description' => '会话ID。', 'type' => 'string', 'example' => '1717'],
'SqlText' => ['description' => 'SQL语句。', 'type' => 'string', 'example' => 'select * from test1'],
'StartTime' => ['description' => '开始执行的时间。格式为Unix时间戳,单位为毫秒。', 'type' => 'string', 'example' => '1608888296000'],
'WaitTimeMs' => ['description' => '阻塞时长,单位毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '30000'],
'WaitType' => ['description' => '等待类型。更多等待类型及说明,请参见[等待类型](https://learn.microsoft.com/en-us/sql/relational-databases/system-dynamic-management-views/sys-dm-os-wait-stats-transact-sql?view=sql-server-ver15)。', 'type' => 'string', 'example' => 'MISCELLANEOUS'],
'CurrentCollectionTime' => ['description' => '阻塞的采集时间。格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1700065800000'],
],
],
],
'PageNo' => ['description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'],
'PageSize' => ['description' => '分页大小。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'],
'Total' => ['description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '19'],
],
],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '查询RDS SQL Server实例的锁阻塞列表',
'description' => '* 本接口仅适用于RDS SQL Server版实例。'."\n"
.'* 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'* 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetBlockingDetailList'],
],
],
'ramActions' => [
[
'operationType' => 'list',
'ramAction' => [
'action' => 'hdm:GetBlockingDetailList',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": {\\n \\"List\\": [\\n {\\n \\"BatchId\\": 1683530096156,\\n \\"ClientAppName\\": \\".Net SqlClient Data Provider\\",\\n \\"DataBase\\": \\"testdb1\\",\\n \\"HostName\\": \\"ALLBNMGTAPPRD01\\",\\n \\"LoginId\\": \\"Testuser\\",\\n \\"QueryHash\\": \\"DC08B955CAD25E7B\\",\\n \\"Spid\\": \\"1717\\",\\n \\"SqlText\\": \\"select * from test1\\",\\n \\"StartTime\\": \\"1608888296000\\",\\n \\"WaitTimeMs\\": 30000,\\n \\"WaitType\\": \\"MISCELLANEOUS\\",\\n \\"CurrentCollectionTime\\": 1700065800000\\n }\\n ],\\n \\"PageNo\\": 1,\\n \\"PageSize\\": 10,\\n \\"Total\\": 19\\n },\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\"\\n}","type":"json"}]',
],
'GetDBInstanceConnectivityDiagnosis' => [
'summary' => '获取用户输入IP地址到指定数据库实例的网络连通性诊断结果。',
'methods' => ['get', 'post'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => ['operationType' => 'get'],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['title' => '实例ID', 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
[
'name' => 'SrcIp',
'in' => 'query',
'schema' => ['title' => '源IP', 'description' => '源IP地址。', 'type' => 'string', 'required' => true, 'example' => '47.100.XX.XX'],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '返回信息列表。',
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'>请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'Data' => [
'description' => '详细信息列表。',
'type' => 'object',
'properties' => [
'instanceId' => ['title' => '实例ID', 'description' => '实例ID。', 'type' => 'string', 'example' => 'rm-2ze8g2am97624****'],
'success' => [
'title' => '是否检测通过',
'description' => '是否检测通过:'."\n"
."\n"
.'- **true**:检测通过。'."\n"
.'- **false**:检测不通过。',
'type' => 'boolean',
'enumValueTitles' => [],
'example' => 'false',
],
'failType' => ['title' => '异常类型', 'description' => '异常类型:'."\n"
."\n"
.'- **0**:用户可自助处理的。'."\n"
.'- **1**:需要联系值班人员处理的。', 'type' => 'string', 'example' => '0'],
'connCheckErrorCode' => ['title' => '异常检测项', 'description' => '异常检测项:'."\n"
."\n"
.'- **SRC\\_IP\\_NOT\\_IN\\_USER\\_WHITELIST**:源IP地址没有配置在用户白名单中。'."\n"
.'- **VIP\\_NOT\\_EXISTS**:VIP对应的ALB实例不存在。'."\n"
.'- **RS\\_NOT\\_EXISTS**:RS不正常挂载。'."\n"
.'- **VIP\\_TUNNEL\\_ID\\_NOT\\_CONSISTENT**:VPC类型VIP使用的TUNNEL ID与VPC对应的实际TUNNEL ID不一致。'."\n"
.'- **VIP\\_VPC\\_CLOUD\\_INSTANCE\\_NOT\\_EXISTS**:VPC类型VIP不存在。'."\n"
.'- **VIP\\_IS\\_NOT\\_NGLB**:VIP关闭了NGLB模式。'."\n"
.'- **CUSTINS\\_NOT\\_ASSOCIATE\\_ECS\\_SECURITY\\_GROUP**:实例没有关联安全组。'."\n"
.'- **SRC\\_IP\\_NOT\\_IN\\_USER\\_WHITELIST**:源IP地址没有配置在用户白名单中。'."\n"
.'- **SRC\\_IP\\_NOT\\_IN\\_ADMIN\\_WHITELIST**:源IP地址没有配置在管理机白名单中。'."\n"
.'- **SRC\\_IP\\_NOT\\_IN\\_ECS\\_SECURITY\\_GROUP**:源IP地址没有配置在实例关联的安全组中。'."\n"
.'- **VPC\\_INSTANCE\\_IP\\_NOT\\_WORKING\\_STATUS**:VPC IP地址状态异常。', 'type' => 'string', 'example' => 'SRC_IP_NOT_IN_USER_WHITELIST'],
'connCheckErrorMessage' => ['title' => '异常检测详情信息', 'description' => '异常检测详情信息。', 'type' => 'string', 'example' => 'Src ip:47.100.XX.XX not in user whitelist'],
],
],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'B6D17591-B48B-4D31-9CD6-9B9796B2****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
.'* **true**:执行成功。'."\n"
.'* **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => ''],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => ''],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": {\\n \\"instanceId\\": \\"rm-2ze8g2am97624****\\",\\n \\"success\\": false,\\n \\"failType\\": \\"0\\",\\n \\"connCheckErrorCode\\": \\"SRC_IP_NOT_IN_USER_WHITELIST\\",\\n \\"connCheckErrorMessage\\": \\"Src ip:47.100.XX.XX not in user whitelist\\"\\n },\\n \\"RequestId\\": \\"B6D17591-B48B-4D31-9CD6-9B9796B2****\\",\\n \\"Success\\": \\"true\\"\\n}","type":"json"}]',
'title' => '获取数据库实例网络连通性诊断结果',
'description' => '使用该接口需满足以下前提条件:'."\n"
."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 数据库实例已接入DAS。',
'changeSet' => [],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:GetDBInstanceConnectivityDiagnosis',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
],
'GetDasAgentSSE' => [
'summary' => 'DAS大模型交互SSE接口。可以进行知识问答,性能诊断等功能。',
'path' => '/getDasAgentSSE',
'methods' => ['post'],
'schemes' => ['https', 'sse'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeNodes' => ['FEATUREhdmB8MM4L', 'FEATUREhdmROFBLE', 'FEATUREhdm1XKIXR', 'FEATUREhdmR88NLD', 'FEATUREhdm3TU4OK'],
'autoTest' => true,
'tenantRelevance' => 'tenant',
],
'parameters' => [
[
'name' => 'Query',
'in' => 'query',
'schema' => ['description' => '问答自然语言描述', 'type' => 'string', 'required' => true, 'example' => 'Are there any issues or abnormalities with my instance rm-xxx?'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'allowEmptyValue' => true,
'schema' => ['description' => '废弃参数, 实例Id通过Query字段传入', 'type' => 'string', 'required' => false, 'example' => 'rm-xxxx'],
],
[
'name' => 'SessionId',
'in' => 'query',
'schema' => ['description' => '可选,会话Id,格式为UUID字符串,未传入会创建新的会话,上下文对话需保持同一个会话Id', 'type' => 'string', 'required' => false, 'example' => '123e4567-e89b-12d3-a456-xxxxxxxxxxxx'],
],
[
'name' => 'AgentId',
'in' => 'query',
'schema' => ['description' => '可选,默认使用默认Agent进行服务,或者传入开启DASAgent服务后生成的或者主动创建的Agent', 'type' => 'string', 'required' => false, 'example' => 'ag-472T0DxtmjIxxxxx'],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'Id' => ['description' => 'SessionId, 同请求参数中的SessionId', 'type' => 'string', 'example' => '123e4567-e89b-12d3-a456-xxxxxxxxxxxx'],
'Answer' => ['description' => '回答内容', 'type' => 'string', 'example' => 'rm-xxxx'],
'Metadata' => [
'description' => '元信息',
'type' => 'object',
'properties' => [
'Code' => ['description' => '如果异常,会返回错误类型,无异常时返回为空', 'type' => 'integer', 'format' => 'int32', 'example' => '-1810001'],
'CharCount' => ['description' => '回答的字符数量', 'type' => 'integer', 'format' => 'int64', 'example' => '1403'],
'ToolName' => ['description' => '调用的工具命令', 'type' => 'string', 'example' => 'SqlFilter'],
'ToolParams' => [
'description' => '工具参数',
'type' => 'array',
'items' => ['description' => '字符串列表', 'type' => 'string', 'example' => '["--instanceId", "rm-*****", "--sqlText", "select~from~das~where~name~das1"]'],
],
'RequestId' => ['description' => '请求Id', 'type' => 'string', 'example' => '04930480-9404-50CB-8252-Axxxxxxxx'],
],
],
'Event' => [
'description' => '返回回答信息的类型',
'type' => 'string',
'enumValueTitles' => ['summary' => '回答的相关统计', ' error ' => '报错信息', 'agent_message ' => '大模型生成的回答'],
'example' => 'summary',
],
],
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
[
['errorCode' => 'InstanceNotFound', 'errorMessage' => 'Requested instance not found.', 'description' => '对应实例id无法找到'],
],
500 => [
['errorCode' => 'Timeout', 'errorMessage' => 'The request processing has failed due to timeout.', 'description' => '由于超时请求处理失败。'],
],
],
'staticInfo' => ['returnType' => 'synchronous'],
'title' => '(废弃)Das Agent 数据流接口',
'description' => '该接口是付费接口,会按照输出字符进行计费,请确保在使用该接口前,已充分了解DAS Agent产品的收费方式和[价格](https://help.aliyun.com/zh/das/product-overview/billing-details-of-the-previous-version?spm=a2c4g.11186623.help-menu-63907.d_0_1_0.b7203b87MDNqHO&scm=20140722.H_156195._.OR_help-T_cn~zh-V_1#cad160563fbkd)。',
'extraInfo' => '### Java 版本示例'."\n"
."\n"
.'```'."\n"
.'import com.aliyun.auth.credentials.Credential;'."\n"
.'import com.aliyun.auth.credentials.provider.StaticCredentialProvider;'."\n"
.'import com.aliyun.sdk.gateway.pop.Configuration;'."\n"
.'import com.aliyun.sdk.gateway.pop.auth.SignatureVersion;'."\n"
.'import com.aliyun.sdk.service.das20200116.models.GetDasAgentSSERequest;'."\n"
.'import com.aliyun.sdk.service.das20200116.models.GetDasAgentSSEResponseBody;'."\n"
.'import com.aliyun.sdk.service.das20200116.models.*;'."\n"
.'import com.aliyun.sdk.service.das20200116.*;'."\n"
.'import darabonba.core.ResponseIterable;'."\n"
.'import darabonba.core.client.ClientOverrideConfiguration;'."\n"
."\n"
.'import java.util.*;'."\n"
.'import java.io.*;'."\n"
."\n"
.'public class GetDasAgentSSESample {'."\n"
."\n"
.' public static void main(String[] args) throws Exception {'."\n"
."\n"
.' StaticCredentialProvider provider = StaticCredentialProvider.create(Credential.builder()'."\n"
.' .accessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))'."\n"
.' .accessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))'."\n"
.' .build());'."\n"
."\n"
.' AsyncClient client = AsyncClient.builder()'."\n"
.' .region("cn-shanghai")'."\n"
.' .credentialsProvider(provider)'."\n"
.' .serviceConfiguration(Configuration.create().setSignatureVersion(SignatureVersion.V3))'."\n"
.' .overrideConfiguration(ClientOverrideConfiguration.create().setProtocol("HTTPS")'."\n"
.' .setEndpointOverride("das.cn-shanghai.aliyuncs.com"))'."\n"
.' .build();'."\n"
."\n"
.' GetDasAgentSSERequest request = GetDasAgentSSERequest.builder()'."\n"
.' .query("麻烦介绍下DAS Agent,相关文字在1000字左右").build();'."\n"
.' ResponseIterable x = client.getDasAgentSSEWithResponseIterable(request);'."\n"
.' for (GetDasAgentSSEResponseBody event : x) {'."\n"
.' System.out.printf(event.getAnswer());'."\n"
.' }'."\n"
."\n"
.' client.close();'."\n"
.' }'."\n"
."\n"
.'}'."\n"
.'```'."\n"
.'### Python 版本示例'."\n"
."\n"
.'```'."\n"
.'# -*- coding: utf-8 -*-'."\n"
.'import os'."\n"
.'import sys'."\n"
.'import json'."\n"
.'import asyncio'."\n"
."\n"
.'from typing import List'."\n"
."\n"
.'from alibabacloud_das20200116.client import Client as DAS20200116Client'."\n"
.'from alibabacloud_credentials.client import Client as CredentialClient'."\n"
.'from alibabacloud_tea_openapi import models as open_api_models'."\n"
.'from alibabacloud_das20200116 import models as das20200116_models'."\n"
.'from alibabacloud_tea_util import models as util_models'."\n"
.'from alibabacloud_tea_util.client import Client as UtilClient'."\n"
."\n\n"
.'class GetDasAgentSseSample:'."\n"
.' def __init__(self):'."\n"
.' pass'."\n"
."\n"
.' @staticmethod'."\n"
.' def create_client() -> DAS20200116Client:'."\n"
.' """'."\n"
.' 使用凭据初始化账号Client'."\n"
.' @return: Client'."\n"
.' @throws Exception'."\n"
.' """'."\n"
.' credential = CredentialClient()'."\n"
.' config = open_api_models.Config('."\n"
.' credential=credential'."\n"
.' )'."\n"
.' config.endpoint = f\'das.cn-shanghai.aliyuncs.com\''."\n"
.' return DAS20200116Client(config)'."\n"
."\n"
.' @staticmethod'."\n"
.' def create_api_info() -> open_api_models.Params:'."\n"
.' params = open_api_models.Params('."\n"
.' action=\'GetDasAgentSSE\','."\n"
.' version=\'2020-01-16\','."\n"
.' protocol=\'HTTPS\','."\n"
.' pathname=\'/\','."\n"
.' method=\'POST\','."\n"
.' auth_type=\'AK\','."\n"
.' style=\'RPC\','."\n"
.' req_body_type=\'json\','."\n"
.' body_type=\'sse\''."\n"
.' )'."\n"
.' return params'."\n"
."\n"
.' @staticmethod'."\n"
.' def build_open_api_request(request_obj) -> open_api_models.OpenApiRequest:'."\n"
.' query_dict = {} '."\n"
.' for attr_name in dir(request_obj):'."\n"
.' if attr_name.startswith(\'_\'):'."\n"
.' continue'."\n"
.' if callable(getattr(request_obj, attr_name, None)):'."\n"
.' continue'."\n"
.' try:'."\n"
.' value = getattr(request_obj, attr_name)'."\n"
.' except AttributeError:'."\n"
.' continue '."\n"
.' if UtilClient.is_unset(value):'."\n"
.' continue'."\n"
.' '."\n"
.' api_key = \'\'.join(word.capitalize() for word in attr_name.split(\'_\'))'."\n"
.' query_dict[api_key] = value'."\n"
.' '."\n"
.' return open_api_models.OpenApiRequest('."\n"
.' query=query_dict,'."\n"
.' headers={}'."\n"
.' )'."\n"
."\n"
.' @staticmethod'."\n"
.' def run() -> None:'."\n"
.' client = GetDasAgentSseSample.create_client()'."\n"
.' params = GetDasAgentSseSample.create_api_info()'."\n"
.' runtime = util_models.RuntimeOptions()'."\n"
.' '."\n"
.' # 创建请求对象(可以通过命令行参数传递 query)'."\n"
.' get_das_agent_sserequest = das20200116_models.GetDasAgentSSERequest('."\n"
.' query=\'麻烦介绍下DAS Agent,相关文字在1000字左右\''."\n"
.' )'."\n"
.' '."\n"
.' # 转换为 OpenApiRequest 格式'."\n"
.' open_api_request = GetDasAgentSseSample.build_open_api_request(get_das_agent_sserequest)'."\n"
.' '."\n"
.' response = client.call_sseapi(params, open_api_request, runtime)'."\n"
.' for res in response:'."\n"
.' answer = None '."\n"
.' if hasattr(res.event, \'data\'):'."\n"
.' # event.data 可能是字符串或字典'."\n"
.' event_data = res.event.data'."\n"
.' if isinstance(event_data, str):'."\n"
.' try:'."\n"
.' event_data = json.loads(event_data)'."\n"
.' except json.JSONDecodeError:'."\n"
.' pass'."\n"
.' if isinstance(event_data, dict):'."\n"
.' answer = event_data.get(\'Answer\')'."\n"
.' if answer:'."\n"
.' print(answer, end=\'\', flush=True)'."\n"
."\n\n"
.'if __name__ == \'__main__\':'."\n"
.' GetDasAgentSseSample.run()'."\n"
.'```',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:GetDasAgentSSE',
'authLevel' => 'resource',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Id\\": \\"123e4567-e89b-12d3-a456-xxxxxxxxxxxx\\",\\n \\"Answer\\": \\"rm-xxxx\\",\\n \\"Metadata\\": {\\n \\"Code\\": -1810001,\\n \\"CharCount\\": 1403,\\n \\"ToolName\\": \\"SqlFilter\\",\\n \\"ToolParams\\": [\\n \\"[\\\\\\"--instanceId\\\\\\", \\\\\\"rm-*****\\\\\\", \\\\\\"--sqlText\\\\\\", \\\\\\"select~from~das~where~name~das1\\\\\\"]\\"\\n ],\\n \\"RequestId\\": \\"04930480-9404-50CB-8252-Axxxxxxxx\\"\\n },\\n \\"Event\\": \\"summary\\"\\n}","type":"json"}]',
],
'GetDasProServiceUsage' => [
'summary' => '调用GetDasProServiceUsage接口,查询数据库实例DAS企业版 V1或企业版 V2存储空间的使用情况。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => ['operationType' => 'get'],
'parameters' => [
[
'name' => 'UserId',
'in' => 'query',
'schema' => ['description' => '用户ID,即创建数据库实例的阿里云主账号ID。'."\n"
."\n"
.'> 非必填,输入目标数据库实例ID后,在调用API接口时,系统会自动获取用户ID。', 'type' => 'string', 'required' => false, 'example' => '196278346919****'],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => ['description' => '数据库实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze8g2am97624****'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Message' => ['description' => '请求返回消息。'."\n"
."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '7172BECE-588A-5961-8126-C216E16B****'],
'Data' => [
'description' => '返回数据。',
'type' => 'object',
'properties' => [
'storageFreeQuotaInMB' => ['description' => '赠送的SQL洞察数据存储空间,单位为MB。', 'type' => 'number', 'format' => 'double', 'example' => '5120'],
'ip' => ['description' => '数据库实例的地址。', 'type' => 'string', 'example' => 'rm-2ze8g2am97624****.mysql.****.com'],
'userId' => ['description' => '用户ID,即创建数据库实例的阿里云主账号ID。', 'type' => 'string', 'example' => '196278346919****'],
'expireTime' => ['description' => '数据库实例企业版到期时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1648742400000'],
'instanceId' => ['description' => '数据库实例ID。', 'type' => 'string', 'example' => 'rm-2ze8g2am97624****'],
'storageUsed' => ['description' => '数据库实例已使用的SQL洞察数据存储空间,单位为Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '35903498'],
'engine' => ['description' => '数据库引擎。', 'type' => 'string', 'example' => 'MySQL'],
'instanceAlias' => ['description' => '数据库实例名称。', 'type' => 'string', 'example' => 'TESTDB01'],
'port' => ['description' => '端口号。', 'type' => 'integer', 'format' => 'int32', 'example' => '3306'],
'vpcId' => ['description' => 'VPC ID。', 'type' => 'string', 'example' => 'vpc-2zentqj1sk4qmolci****'],
'commodityInstanceId' => ['description' => 'DAS企业版ID。', 'type' => 'string', 'example' => 'daspro-cn-v0h1l6i****'],
'startTime' => ['description' => '开启企业版的时间,格式为Unix时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1646100892000'],
'isSpare' => ['description' => '数据库实例的企业版是否过期:'."\n"
."\n"
.'- **true**:过期。'."\n"
.'- **false**:未过期。', 'type' => 'boolean', 'example' => 'false'],
'region' => ['description' => '数据库实例所属的地域。', 'type' => 'string', 'example' => 'cn-shanghai'],
'serviceUnitId' => ['description' => '服务单元ID。', 'type' => 'string', 'example' => '4'],
'sqlRetention' => ['description' => 'SQL洞察数据存储时长,单位为天。', 'type' => 'string', 'example' => '180'],
'migrationPredictRemainingTime' => ['description' => '旧版SQL洞察和审计迁移到新版的预计剩余时间,单位为毫秒。'."\n"
.'>仅当进行旧版SQL洞察和审计迁移到新版操作时,返回此参数。'."\n"
.'>', 'type' => 'integer', 'format' => 'int64', 'example' => '60000'],
],
'example' => '{ "storageFreeQuotaInMB": 5120, "ip": "rm-2ze8g2am97624****.mysql.****.com", "custinsId": 12448331, "userId": "196278346919****", "uuid": "hdm_b0ae36343407609bf3e8df8709d8****", "expireTime": 1924963200000, "instanceId": "rm-2ze8g2am97624****", "storageUsed": 10773752667393, "engine": "MySQL", "instanceAlias": "TESTDB01_PROD", "port": 3310, "vpcId": "hdm_****", "commodityInstanceId": "daspro-****", "startTime": 1606381940000, "isSpare": false, "region": "cn-shanghai", "serviceUnitId": "5", "sqlRetention": 30 }',
],
'Code' => ['description' => '返回的状态码。', 'type' => 'integer', 'format' => 'int64', 'example' => '200'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'boolean', 'example' => 'true'],
],
'description' => '',
],
],
],
'errorCodes' => [
400 => [
['errorCode' => 'InvalidParams', 'errorMessage' => 'The request parameters are invalid.', 'description' => '请求参数错误'],
],
403 => [
['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to do this action.', 'description' => '没有权限执行该操作'],
],
],
'title' => '查询DAS企业版(V1或V2)存储空间使用情况',
'description' => '- 当前支持的数据库请参见[DAS企业版使用说明](~~190912~~)。'."\n"
.'- 使用阿里云或DAS的SDK时,建议使用最新版本。'."\n"
.'- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。'."\n"
.'- 该接口仅适用于DAS企业版 V1、V2。'."\n"
.'>推荐使用[DescribeSqlLogStatistic](~~2778836~~)接口,查询DAS企业版的数据统计信息。',
'changeSet' => [],
'flowControl' => [
'flowControlList' => [
['threshold' => '60', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetDasProServiceUsage'],
],
],
'ramActions' => [
[
'operationType' => 'get',
'ramAction' => [
'action' => 'hdm:GetDasProServiceUsage',
'authLevel' => 'operate',
'actionConditions' => [],
'resources' => [
['validationType' => 'always', 'product' => 'DAS', 'resourceType' => '全部资源', 'arn' => '*'],
],
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"7172BECE-588A-5961-8126-C216E16B****\\",\\n \\"Data\\": {\\n \\"storageFreeQuotaInMB\\": 5120,\\n \\"ip\\": \\"rm-2ze8g2am97624****.mysql.****.com\\",\\n \\"userId\\": \\"196278346919****\\",\\n \\"expireTime\\": 1648742400000,\\n \\"instanceId\\": \\"rm-2ze8g2am97624****\\",\\n \\"storageUsed\\": 35903498,\\n \\"engine\\": \\"MySQL\\",\\n \\"instanceAlias\\": \\"TESTDB01\\",\\n \\"port\\": 3306,\\n \\"vpcId\\": \\"vpc-2zentqj1sk4qmolci****\\",\\n \\"commodityInstanceId\\": \\"daspro-cn-v0h1l6i****\\",\\n \\"startTime\\": 1646100892000,\\n \\"isSpare\\": false,\\n \\"region\\": \\"cn-shanghai\\",\\n \\"serviceUnitId\\": \\"4\\",\\n \\"sqlRetention\\": \\"180\\",\\n \\"migrationPredictRemainingTime\\": 60000\\n },\\n \\"Code\\": 200,\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n Successful\\n 7172BECE-588A-5961-8126-C216E16B****\\n \\n 5120\\n rm-2ze8g2am97624****.mysql.****.com\\n 196278346919****\\n 1648742400000\\n rm-2ze8g2am97624****\\n 35903498\\n MySQL\\n TESTDB01\\n 3306\\n vpc-2zentqj1sk4qmolci****\\n daspro-cn-v0h1l6i****\\n 1646100892000\\n false\\n cn-shanghai\\n 4\\n 180\\n \\n 200\\n true\\n","errorExample":""}]',
],
'GetDasSQLLogHotData' => [
'summary' => '获取审计日志热数据。',
'methods' => ['post', 'get'],
'schemes' => ['http', 'https'],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'abilityTreeCode' => '178715',
'abilityTreeNodes' => ['FEATUREhdmFT57I0'],
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'formData',
'schema' => ['description' => '数据库实例ID。', 'type' => 'string', 'required' => true, 'example' => 'rm-2ze1jdv45i7l6****'],
],
[
'name' => 'Start',
'in' => 'formData',
'schema' => ['description' => '查询开始时间,格式为Unix时间戳,单位为毫秒。'."\n"
."\n"
.'> 只能查询开启DAS企业版后的数据,查询开始时间最大不能早于当前时间7天。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1684734297000'],
],
[
'name' => 'End',
'in' => 'formData',
'schema' => ['description' => '查询结束时间,格式为Unix时间戳,单位为毫秒。'."\n"
."\n"
.'> 查询结束时间需晚于查询开始时间,且查询开始时间和查询结束时间的间隔不能超过1天。', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'example' => '1684820697000'],
],
[
'name' => 'QueryKeyword',
'in' => 'formData',
'schema' => [
'description' => '关键字。'."\n"
."\n"
.'> 支持模糊查询;最多支持10个关键字组合查询,关键字之间以空格分隔。例如:a1 b2 c3。',
'type' => 'string',
'required' => false,
'enumValueTitles' => [],
'example' => 'a1 b2',
],
],
[
'name' => 'AccountName',
'in' => 'formData',
'schema' => ['description' => '数据库账号。'."\n"
."\n"
.'> 支持多个数据库账号组合查询,数据库账号间以空格分隔,例如:`user1 user2 user3`。', 'type' => 'string', 'required' => false, 'example' => 'testuser'],
],
[
'name' => 'DBName',
'in' => 'formData',
'schema' => ['description' => '数据库名。'."\n"
."\n"
.'> 支持多个数据库名组合查询,数据库名间以空格分隔,例如:`DB1 DB2 DB3`。', 'type' => 'string', 'required' => false, 'example' => 'testDB'],
],
[
'name' => 'HostAddress',
'in' => 'formData',
'schema' => ['description' => '客户端IP地址。'."\n"
."\n"
.'> 支持多个客户端IP地址组合查询,客户端IP地址间以空格分隔,例如:`IP1 IP2 IP3`。', 'type' => 'string', 'required' => false, 'example' => '47.100.XX.XX'],
],
[
'name' => 'LogicalOperator',
'in' => 'formData',
'schema' => ['description' => '多个关键字的逻辑关系。'."\n"
."\n"
.'- **or**:或。'."\n"
.'- **and**:与。', 'type' => 'string', 'required' => false, 'example' => 'or'],
],
[
'name' => 'MaxLatancy',
'in' => 'formData',
'schema' => ['description' => '最大执行耗时 ,单位为微秒。查询执行耗时小于该参数值的SQL语句。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '100'],
],
[
'name' => 'MaxScanRows',
'in' => 'formData',
'schema' => ['description' => '最大扫描行数 ,查询扫描行数小于该参数值的SQL语句。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '10000'],
],
[
'name' => 'MinLatancy',
'in' => 'formData',
'schema' => ['description' => '最小执行耗时 ,单位为微秒。查询执行耗时大于等于该参数值的SQL语句。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '10'],
],
[
'name' => 'MinScanRows',
'in' => 'formData',
'schema' => ['description' => '最小扫描行数 ,查询扫描行数大于等于该参数值的SQL语句。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '10'],
],
[
'name' => 'SqlType',
'in' => 'formData',
'schema' => [
'description' => 'SQL语句的类型。取值:'."\n"
.'- **select**'."\n"
.'- **update**'."\n"
.'- **delete**',
'type' => 'string',
'required' => false,
'enumValueTitles' => ['select' => '查询', 'update' => '修改', 'delete' => '删除'],
'example' => 'select',
],
],
[
'name' => 'State',
'in' => 'formData',
'schema' => ['description' => '执行结果,输入**0**时表示查询执行成功的SQL,您也可以输入具体的错误码,查询对应的SQL。', 'type' => 'string', 'required' => false, 'example' => '0'],
],
[
'name' => 'ThreadID',
'in' => 'formData',
'schema' => ['description' => '线程ID。'."\n"
."\n"
.'> 支持多个线程ID组合查询,线程ID间以空格分隔,例如:`线程ID1 线程ID2 线程ID3`。', 'type' => 'string', 'required' => false, 'example' => '657'],
],
[
'name' => 'PageNumbers',
'in' => 'formData',
'schema' => ['description' => '分页查询的页码,从1开始,默认为1。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '2'],
],
[
'name' => 'MaxRecordsPerPage',
'in' => 'formData',
'schema' => ['description' => '分页查询每页最大记录数。取值范围:5~100。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '10'],
],
[
'name' => 'SortKey',
'in' => 'formData',
'schema' => ['description' => '排序依据。'."\n"
."\n"
.'- **ScanRows**:扫描行数。'."\n"
.'- **UpdateRows**:更新行数。'."\n"
.'- **Consume**:耗时。'."\n"
.'- **OriginTime**:执行时间。'."\n"
.'- **ReturnRows**:返回行数。', 'type' => 'string', 'required' => false, 'example' => 'ScanRows'],
],
[
'name' => 'SortMethod',
'in' => 'formData',
'schema' => ['description' => '排序方式。'."\n"
.'- **ASC**:正序。'."\n"
.'- **DESC**:倒序。', 'type' => 'string', 'required' => false, 'example' => 'ASC'],
],
[
'name' => 'ChildDBInstanceIDs',
'in' => 'formData',
'schema' => ['description' => '节点ID。'."\n"
."\n"
.'> 对于PolarDB MySQL版实例,需要提供节点ID。', 'type' => 'string', 'required' => false, 'example' => 'pi-bp179lg03445l****'],
],
[
'name' => 'Role',
'in' => 'formData',
'schema' => ['description' => '预留参数,暂不支持。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'TraceId',
'in' => 'formData',
'schema' => ['description' => '预留参数,暂不支持。', 'type' => 'string', 'required' => false, 'example' => 'None'],
],
[
'name' => 'MinRows',
'in' => 'formData',
'schema' => ['description' => '预留参数,暂不支持。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => 'None'],
],
[
'name' => 'MaxRows',
'in' => 'formData',
'schema' => ['description' => '预留参数,暂不支持。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => 'None'],
],
[
'name' => 'MinSpillCnt',
'in' => 'formData',
'schema' => ['description' => '预留参数,暂不支持。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => 'None'],
],
[
'name' => 'MaxSpillCnt',
'in' => 'formData',
'schema' => ['description' => '预留参数,暂不支持。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => 'None'],
],
[
'name' => 'TransactionId',
'in' => 'formData',
'schema' => ['description' => '事务ID。', 'type' => 'string', 'required' => false, 'example' => '0'],
],
[
'name' => 'Fail',
'in' => 'formData',
'schema' => ['description' => 'SQL执行错误码,您可以调用[GetAsyncErrorRequestStatByCode](~~409804~~)获取错误码。', 'type' => 'string', 'required' => false, 'example' => '1064'],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => ['description' => '返回的状态码。', 'type' => 'string', 'example' => '200'],
'Message' => ['description' => '请求返回消息。'."\n"
.'> 请求成功时该参数返回**Successful**,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Successful'],
'RequestId' => ['description' => '请求ID,阿里云为该请求生成的标识符。', 'type' => 'string', 'example' => '0A74B755-98B7-59DB-8724-1321B394****'],
'Success' => ['description' => '请求是否执行成功:'."\n"
."\n"
.'- **true**:执行成功。'."\n"
.'- **false**:执行失败。', 'type' => 'string', 'example' => 'true'],
'Data' => [
'title' => 'ListResult