'1.0', 'info' => [ 'style' => 'RPC', 'product' => 'polardbx', 'version' => '2020-02-02', ], 'directories' => [ [ 'id' => 119060, 'title' => '实例管理', 'type' => 'directory', 'children' => [ 'CreateDBInstance', 'DeleteDBInstance', 'DescribeDBInstanceAttribute', 'DescribeDBInstanceConfig', 'DescribeDBInstances', 'DescribeDBInstanceSSL', 'DescribeDBInstanceTDE', 'DescribeDBInstanceTopology', 'DescribeDBInstanceViaEndpoint', 'ModifyDBInstanceConfig', 'ModifyDBInstanceDescription', 'ReleaseInstancePublicConnection', 'RestartDBInstance', 'UpgradeDBInstanceKernelVersion', 'ModifyDBInstanceClass', 'DescribeDBInstanceHA', 'UpdatePolarDBXInstanceNode', 'ChangeResourceGroup', 'DescribeTransformStatus', 'DescribePolarxDataNodes', 'ModifyDBInstanceMaintainTime', 'ModifyDBInstanceVip', 'DescribeRdsVpcs', 'DescribeRdsVswitches', 'DescribeShowStorageInfo', 'DescribeStoragePoolInfo', 'CreateStoragePool', 'CreateCustomEndpoint', 'DescribeCustomEndpointList', 'ModifyCustomEndpointNet', 'DeleteCustomEndpoint', 'ModifyCustomEndpoint', 'ModifyDBInstanceConnectionString', 'AllocateInstancePublicConnection', 'AllocateColdDataVolume', 'ReleaseColdDataVolume', 'DescribeColdDataBasicInfo', ], ], [ 'id' => 201174, 'title' => '监控与日志', 'type' => 'directory', 'children' => [ 'DescribeSlowLogRecords', 'DescribeDBNodePerformance', 'DescribeSqlAuditInfo', 'EnableSqlAudit', 'DisableSqlAudit', 'CheckSqlAuditSlsStatus', 'DescribeEvents', 'DescribeActiveOperationMaintainConf', 'DescribeActiveOperationTasks', 'DescribeActiveOperationTaskCount', 'ModifyActiveOperationMaintainConf', ], ], [ 'id' => 119019, 'title' => '任务管理', 'type' => 'directory', 'children' => [ 'DescribeTasks', 'DescribeScaleOutMigrateTaskList', 'CreateTransformOperation', 'DescribeRplInspectionTask', 'SkipCurrentStep', 'CreateRplInspectionTask', 'CancelActiveOperationTasks', 'ModifyActiveOperationTasks', ], ], [ 'id' => 119022, 'title' => 'SSL加密', 'type' => 'directory', 'children' => [ 'UpdateDBInstanceSSL', ], ], [ 'id' => 119025, 'title' => '参数管理', 'type' => 'directory', 'children' => [ 'ModifyParameter', 'DescribeParameterTemplates', 'DescribeParameters', 'DescribeParameterGroups', ], ], [ 'id' => 119029, 'title' => '备份管理', 'type' => 'directory', 'children' => [ 'CreateBackup', 'DescribeBackupPolicy', 'DescribeBackupSetList', 'DescribeBinaryLogList', 'UpdateBackupPolicy', 'DescribeOpenBackupSet', 'DescribeBackupSet', ], ], [ 'id' => 119037, 'title' => '数据安全', 'type' => 'directory', 'children' => [ 'UpdateDBInstanceTDE', 'ModifySecurityIps', 'DescribeUserEncryptionKeyList', 'DescribeSecurityIps', 'CheckCloudResourceAuthorized', 'EnableRightsSeparation', 'DisableRightsSeparation', ], ], [ 'id' => 119043, 'title' => '账号管理', 'type' => 'directory', 'children' => [ 'ResetAccountPassword', 'CreateAccount', 'CreateSuperAccount', 'DeleteAccount', 'DescribeAccountList', 'ModifyAccountDescription', 'ResetAccountPasswordRestrict', 'ModifyAccountPrivilege', ], ], [ 'id' => 119049, 'title' => '地域', 'type' => 'directory', 'children' => [ 'DescribeRegions', 'MigrateDBInstance', 'DescribeAvailableCrossRegions', 'DescribeEnabledCrossRegions', 'AlignStoragePrimaryAzone', 'SwitchDBInstanceHA', ], ], [ 'id' => 119051, 'title' => '数据库管理', 'type' => 'directory', 'children' => [ 'CreateDB', 'DeleteDB', 'DescribeCharacterSet', 'DescribeDbList', 'DescribeDistributeTableList', 'ModifyDatabaseDescription', 'StartSwitchDatabase', 'DescribeComponentPropeties', 'ModifyEngineMigration', 'DescribeArchiveTableList', ], ], [ 'id' => 277496, 'title' => 'CDC管理', 'type' => 'directory', 'children' => [ 'UpgradeCDCVersion', 'DescribeCdcInfo', 'DescribeCdcVersionList', 'DescribeCdcClassList', 'ModifyCdcClass', ], ], [ 'id' => 280912, 'title' => '列存管理', 'type' => 'directory', 'children' => [ 'AttachColumnarInstance', 'UpgradeColumnarVersion', 'ModifyColumnarClass', 'DescribeColumnarVersionList', 'DescribeColumnarInfo', 'DescribeColumnarClassList', ], ], [ 'id' => 275483, 'title' => '数据迁移与同步', 'type' => 'directory', 'children' => [ 'DescribeEvaluateAndImportTask', 'DescribeEvaluateAndImportTasks', 'DeleteEvaluateAndImportTask', 'CreateSQLEvaluateTask', 'CreateStructureImportTask', 'DescribeDataImportTaskInfo', 'CloseEngineMigration', 'ConfirmNoConnection', 'RestartDataImportTask', 'StopDataImportTask', 'CreateDataImportTask', 'DescribeStructureImportTaskInfo', 'RefreshImportMeta', ], ], [ 'id' => 285585, 'title' => 'GDN管理', 'type' => 'directory', 'children' => [ 'DeleteGdnInstance', 'DescribeGdnInstances', 'SwitchGdnMemberRole', 'CreateGdnInstance', ], ], [ 'id' => 285586, 'title' => 'SQL闪回', 'type' => 'directory', 'children' => [ 'SubmitSqlFlashbackTask', 'PreCheckSqlFlashbackTask', 'DescribeSqlFlashbackTaskList', ], ], [ 'id' => 189406, 'title' => '标签管理', 'type' => 'directory', 'children' => [ 'DescribeTags', 'ListTagResources', 'TagResources', 'UntagResources', ], ], ], 'components' => [ 'schemas' => [], ], 'apis' => [ 'CreateDBInstance' => [ 'summary' => '调用CreateDBInstance接口创建PolarDB-X实例。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'paid', 'abilityTreeCode' => '86227', 'abilityTreeNodes' => [ 'FEATUREdrdsIT76F2', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'PayType', 'in' => 'query', 'schema' => [ 'description' => '实例付费类型。'."\n" ."\n" .'- **PREPAY**:包年包月'."\n" .'- **POSTPAY**:按量付费', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'PREPAY', ], ], [ 'name' => 'DBNodeCount', 'in' => 'query', 'schema' => [ 'description' => '实例节点数量,最小为2。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'maximum' => '99', 'minimum' => '0', 'example' => '3', ], ], [ 'name' => 'DBNodeClass', 'in' => 'query', 'schema' => [ 'description' => '节点规格:'."\n" ."\n" .'- **polarx.x4.medium.2e**:2核8 GB'."\n" .'- **polarx.x4.large.2e**:4核16 GB'."\n" .'- **polarx.x8.large.2e**:4核32 GB'."\n" .'- **polarx.x4.xlarge.2e**:8核32 GB'."\n" .'- **polarx.x8.xlarge.2e**:8核64 GB'."\n" .'- **polarx.x4.2xlarge.2e**:16核64 GB'."\n" .'- **polarx.x8.2xlarge.2e**:16核128 GB'."\n" .'- **polarx.x4.4xlarge.2e**:32核128 GB'."\n" .'- **polarx.x8.4xlarge.2e**:32核256 GB'."\n" .'- **polarx.st.8xlarge.2e**:60核470 GB'."\n" .'- **polarx.st.12xlarge.2e**:90核720 GB', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'polarx.x4.2xlarge.2d', ], ], [ 'name' => 'ClientToken', 'in' => 'query', 'schema' => [ 'description' => '幂等请求串,保持每次创建不同即可。', 'type' => 'string', 'required' => false, 'example' => 'xxxxxx-xxx', ], ], [ 'name' => 'NetworkType', 'in' => 'query', 'schema' => [ 'description' => '网络类型,仅支持VPC网络。', 'type' => 'string', 'required' => false, 'example' => 'vpc', ], ], [ 'name' => 'VPCId', 'in' => 'query', 'schema' => [ 'description' => 'VPC ID。'."\n", 'type' => 'string', 'required' => false, 'example' => 'vpc-*****', ], ], [ 'name' => 'VSwitchId', 'in' => 'query', 'schema' => [ 'description' => '虚拟交换机ID。', 'type' => 'string', 'required' => false, 'example' => 'vsw-*********', ], ], [ 'name' => 'UsedTime', 'in' => 'query', 'schema' => [ 'description' => '预付费时,可以选择买几个月或者几年。'."\n" ."\n" .'> Period设置为Year时,该参数支持的取值为1、2、3。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', ], ], [ 'name' => 'Period', 'in' => 'query', 'schema' => [ 'description' => '收费周期,包年包月只能选Year、Month, 按量付费默认选择Hour。', 'type' => 'string', 'required' => false, 'example' => 'Month', ], ], [ 'name' => 'ResourceGroupId', 'in' => 'query', 'schema' => [ 'description' => '可以为空,资源组ID,暂时不支持。', 'type' => 'string', 'required' => false, 'example' => 'null', ], ], [ 'name' => 'AutoRenew', 'in' => 'query', 'schema' => [ 'description' => '是否自动续费,默认为true。'."\n" ."\n" .'- **true**:是'."\n" .'- **false**:否', 'type' => 'boolean', 'required' => false, 'example' => 'true', ], ], [ 'name' => 'EngineVersion', 'in' => 'query', 'schema' => [ 'description' => 'mysql引擎版本,5.7或者8.0。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '5.7', ], ], [ 'name' => 'IsReadDBInstance', 'in' => 'query', 'schema' => [ 'description' => '是否为只读实例。'."\n" ."\n" .'- **true**:是'."\n" .'- **false**:否', 'type' => 'boolean', 'required' => false, 'example' => 'false', ], ], [ 'name' => 'PrimaryDBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '如果为只读实例,需要指定主实例。', 'type' => 'string', 'required' => false, 'example' => 'pxc-*********', ], ], [ 'name' => 'TopologyType', 'in' => 'query', 'schema' => [ 'description' => '拓扑类型:'."\n" ."\n" .'- **3azones**:三可用区;'."\n" .'- **1azone**:单可用区。', 'type' => 'string', 'required' => true, 'example' => '3azones', ], ], [ 'name' => 'PrimaryZone', 'in' => 'query', 'schema' => [ 'description' => '主可用区。', 'type' => 'string', 'required' => false, 'example' => 'cn-shenzhen-e', ], ], [ 'name' => 'SecondaryZone', 'in' => 'query', 'schema' => [ 'description' => '次可用区。', 'type' => 'string', 'required' => false, 'example' => 'cn-shenzhen-a', ], ], [ 'name' => 'TertiaryZone', 'in' => 'query', 'schema' => [ 'description' => '第三可用区。', 'type' => 'string', 'required' => false, 'example' => 'cn-shenzhen-e', ], ], [ 'name' => 'ZoneId', 'in' => 'query', 'schema' => [ 'description' => '实例可用区。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou-a', ], ], [ 'name' => 'CnClass', 'in' => 'query', 'schema' => [ 'description' => '计算节点规格:'."\n" ."\n" .'- **polarx.x4.medium.2e**:2核8 GB'."\n" .'- **polarx.x4.large.2e**:4核16 GB'."\n" .'- **polarx.x8.large.2e**:4核32 GB'."\n" .'- **polarx.x4.xlarge.2e**:8核32 GB'."\n" .'- **polarx.x8.xlarge.2e**:8核64 GB'."\n" .'- **polarx.x4.2xlarge.2e**:16核64 GB'."\n" .'- **polarx.x8.2xlarge.2e**:16核128 GB'."\n" .'- **polarx.x4.4xlarge.2e**:32核128 GB'."\n" .'- **polarx.x8.4xlarge.2e**:32核256 GB'."\n" .'- **polarx.st.8xlarge.2e**:60核470 GB'."\n" .'- **polarx.st.12xlarge.2e**:90核720 GB', 'type' => 'string', 'required' => false, 'example' => 'polarx.x4.medium.2e', ], ], [ 'name' => 'DnClass', 'in' => 'query', 'schema' => [ 'description' => '存储节点规格:'."\n" ."\n" .'- **mysql.n4.medium.25**:2核8 GB'."\n" .'- **mysql.n4.large.25**:4核16 GB'."\n" .'- **mysql.x8.large.25**:4核32 GB'."\n" .'- **mysql.n4.xlarge.25**:8核32 GB'."\n" .'- **mysql.x8.xlarge.25**:8核64 GB'."\n" .'- **mysql.n4.2xlarge.25**:16核64 GB'."\n" .'- **mysql.x8.2xlarge.25**:16核128 GB'."\n" .'- **mysql.x4.4xlarge.25**:32核128 GB'."\n" .'- **mysql.x8.4xlarge.25**:32核256 GB'."\n" .'- **mysql.st.8xlarge.25**:60核470 GB'."\n" .'- **mysql.st.12xlarge.25**:90核720 GB', 'type' => 'string', 'required' => false, 'example' => 'mysql.n4.medium.25', ], ], [ 'name' => 'CNNodeCount', 'in' => 'query', 'schema' => [ 'description' => '计算节点个数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '99', 'minimum' => '0', 'example' => '2', ], ], [ 'name' => 'DNNodeCount', 'in' => 'query', 'schema' => [ 'description' => '存储节点个数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '99', 'minimum' => '0', 'example' => '2', ], ], [ 'name' => 'IsColumnarReadDBInstance', 'in' => 'query', 'schema' => [ 'description' => '创建的实例是否为列存只读实例。', 'type' => 'boolean', 'required' => false, 'example' => 'true', ], ], [ 'name' => 'Series', 'in' => 'query', 'schema' => [ 'title' => '企业版: enterprise'."\n" .'标准版: standard', 'description' => '企业版:enterprise'."\n" .'标准版:standard', 'type' => 'string', 'required' => false, 'example' => 'enterprise', 'default' => 'enterprise', 'enum' => [ 'enterprise', 'standard', ], ], ], [ 'name' => 'DnStorageSpace', 'in' => 'query', 'schema' => [ 'description' => '存储节点磁盘空间大小', 'type' => 'string', 'required' => false, 'example' => '1500', ], ], [ 'name' => 'ExtraParams', 'in' => 'query', 'allowEmptyValue' => false, 'style' => 'json', 'schema' => [ 'description' => '其他参数', 'type' => 'object', 'required' => false, 'additionalProperties' => [ 'type' => 'string', 'description' => '其他参数', 'example' => 'xxxx', ], ], ], [ 'name' => 'Description', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'DBInstanceName' => [ 'description' => '创建的实例名称。', 'type' => 'string', 'example' => 'pxc-*********', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'OrderId' => [ 'description' => '订单号。', 'type' => 'string', 'example' => '12345', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"DBInstanceName\\": \\"pxc-*********\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"OrderId\\": \\"12345\\"\\n}","errorExample":""},{"type":"xml","example":"\\n pxc-*********\\n 9B2F3840-5C98-475C-B269-2D5C3A31797C\\n 12345\\n","errorExample":""}]', 'title' => '创建实例', ], 'DeleteDBInstance' => [ 'summary' => '调用DeleteDBInstance接口删除实例。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATUREdrdsD0NTUP', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 9B2F3840-5C98-475C-B269-2D5C3A31797C\\n","errorExample":""}]', 'title' => '删除实例', ], 'DescribeDBInstanceAttribute' => [ 'summary' => '调用DescribeDBInstanceAttribute接口获取实例属性。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '86240', 'abilityTreeNodes' => [ 'FEATUREdrds9ED9RQ', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'ResourceGroupId', 'in' => 'query', 'schema' => [ 'title' => '资源组ID', 'description' => '资源组ID。', 'type' => 'string', 'required' => false, 'example' => 'rg-aekzaxhezhs5***', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'DBInstance' => [ 'description' => '数据库实例信息。', 'type' => 'object', 'properties' => [ 'Type' => [ 'description' => '实例类型:'."\n" ."\n" .'- **ReadWrite**: 主实例;'."\n" .'- **ReadOnly**: 只读实例。', 'type' => 'string', 'example' => 'ReadWrite', ], 'Status' => [ 'description' => '实例状态,详情请参见[实例状态表](~~339826~~)。', 'type' => 'string', 'example' => 'Running', ], 'RightsSeparationStatus' => [ 'description' => '三权分立状态:'."\n" ."\n" .'- **disabled**:未开启;'."\n" .'- **enabled**:开启;'."\n" .'- **processing**: 处理中;'."\n" .'- **unknown**:未知,可能是实例无法连接导致。', 'type' => 'string', 'example' => 'disabled', ], 'DBNodeCount' => [ 'description' => '实例节点数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '2', ], 'Expired' => [ 'description' => '是否过期:'."\n" ."\n" .'- **true**:过期;'."\n" .'- **false**:正常。', 'type' => 'string', 'example' => 'false', ], 'CreateTime' => [ 'description' => '创建时间。', 'type' => 'string', 'example' => '2021-08-31T08:56:25.000+0000', ], 'PayType' => [ 'description' => '实例付费方式,取值:'."\n" ."\n" .'- **Postpaid**:按量付费;'."\n" .'- **Prepaid**:包年包月。', 'type' => 'string', 'example' => 'Postpaid', ], 'Port' => [ 'description' => '内网连接端口。', 'type' => 'string', 'example' => '3306', ], 'LockMode' => [ 'description' => '实例锁定模式:'."\n" ."\n" .'- **Unlock**:正常;'."\n" .'- **ManualLock**:手动触发锁定;'."\n" .'- **LockByExpiration**:实例过期自动锁定;'."\n" .'- **LockByRestoration**:实例回滚前的自动锁定;'."\n" .'- **LockByDiskQuota**:实例空间满自动锁定;'."\n" .'- **LockReadInstanceByDiskQuota**:只读实例空间满自动锁定。', 'type' => 'string', 'example' => 'Unlock', ], 'Description' => [ 'description' => '实例描述。', 'type' => 'string', 'example' => 'test instance', ], 'ConnectionString' => [ 'description' => '内网连接信息。', 'type' => 'string', 'example' => 'pxc-sprpx766vo****.polarx.singapore.rds.aliyuncs.com', ], 'StorageUsed' => [ 'description' => '已经使用的存储,单位为B。', 'type' => 'integer', 'format' => 'int64', 'example' => '17042505728', ], 'ExpireDate' => [ 'description' => '到期时间。格式为yyyy-MM-ddTHH:mm:ss.sss+0000(UTC时间)。', 'type' => 'string', 'example' => '2022-08-31T16:00:00.000+0000', ], 'CommodityCode' => [ 'description' => '实例商品种类,固定取值为drds_polarxpost_public_cn。', 'type' => 'string', 'example' => 'drds_polarxpost_public_cn', ], 'MaintainStartTime' => [ 'description' => '实例可维护开始时间,此处为UTC时间,加8小时才是控制台上显示的可维护时间段。', 'type' => 'string', 'example' => '06:00', ], 'DBInstanceType' => [ 'description' => '实例类型:'."\n" ."\n" .'- **ReadWrite**: 主实例;'."\n" .'- **ReadOnly**: 只读实例。', 'type' => 'string', 'example' => 'ReadWrite', ], 'DBNodeClass' => [ 'description' => '实例节点规格。', 'type' => 'string', 'example' => 'polarx.x4.large.2e', ], 'LatestMinorVersion' => [ 'description' => '当前实例支持的最新内核版本。', 'type' => 'string', 'example' => 'polarx-kernel_5.4.11-16301083_xcluster-20210805', ], 'MaintainEndTime' => [ 'description' => '实例可维护结束时间,此处为UTC时间,加8小时为控制台上显示的可维护时间段。', 'type' => 'string', 'example' => '06:00', ], 'DBType' => [ 'description' => '数据库类型,固定取值为polarx。', 'type' => 'string', 'example' => 'polarx', ], 'RightsSeparationEnabled' => [ 'description' => '三权分立状态:'."\n" ."\n" .'- **false**:未开启'."\n" .'- **true**:开启', 'type' => 'boolean', 'example' => 'false', ], 'VPCId' => [ 'description' => 'VPC ID。', 'type' => 'string', 'example' => 'vpc-xxxxx', ], 'MinorVersion' => [ 'description' => '当前内核版本。', 'type' => 'string', 'example' => 'polarx-kernel_5.4.11-16301083_xcluster-20210805', ], 'RegionId' => [ 'description' => '实例所在地域。', 'type' => 'string', 'example' => 'cn-hangzhou', ], 'Network' => [ 'description' => '实例的网络类型,仅支持取值VPC,表示专有网络。', 'type' => 'string', 'example' => 'VPC', ], 'DBVersion' => [ 'description' => '数据库版本。', 'type' => 'string', 'example' => '5.5', ], 'VSwitchId' => [ 'description' => '交换机ID。', 'type' => 'string', 'example' => 'vsw-********', ], 'ZoneId' => [ 'description' => '实例所在可用区。', 'type' => 'string', 'example' => 'cn-hangzhou-a', ], 'Engine' => [ 'description' => '数据库类型,固定取值为polarx。', 'type' => 'string', 'example' => 'polarx', ], 'KindCode' => [ 'description' => '实例引擎版本,内部参数。', 'type' => 'integer', 'format' => 'int32', 'example' => '18', ], 'Id' => [ 'description' => '主实例的ID,如果没有返回此参数则表示该实例是主实例。', 'type' => 'string', 'example' => 'pxc-zkralxpc5d****', ], 'DBNodes' => [ 'description' => '数据库节点信息。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'ComputeNodeId' => [ 'description' => '计算节点名称。', 'type' => 'string', 'example' => 'pxc-i-********', ], 'NodeClass' => [ 'description' => '节点规格。', 'type' => 'string', 'example' => 'polarx.x4.large.2e', ], 'DataNodeId' => [ 'description' => '存储节点名称。', 'type' => 'string', 'example' => 'pxc-xdb-xxxxxx', ], 'ZoneId' => [ 'description' => '节点所在可用区名称。', 'type' => 'string', 'example' => 'cn-hangzhou-a', ], 'Id' => [ 'description' => '逻辑节点ID。', 'type' => 'string', 'example' => 'pxi-*********', ], 'RegionId' => [ 'description' => '节点所在地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou', ], ], ], ], 'ConnAddrs' => [ 'description' => '连接地址信息。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Type' => [ 'description' => '连接的种类,**VPC**为内网连接,**PUBLIC**为公网连接。', 'type' => 'string', 'example' => 'VPC', ], 'VSwitchId' => [ 'description' => '交换机ID。', 'type' => 'string', 'example' => 'vsw-*********', ], 'Port' => [ 'description' => '连接端口号。', 'type' => 'integer', 'format' => 'int64', 'example' => '3306', ], 'VPCId' => [ 'description' => 'VPC ID。', 'type' => 'string', 'example' => 'vpc-xxxxxx', ], 'ConnectionString' => [ 'description' => '连接地址。', 'type' => 'string', 'example' => 'polardbx-xxx.aliyuncs.com', ], 'VpcInstanceId' => [ 'description' => 'vpc 内部CloudInstanceId,可以忽略', 'type' => 'string', 'example' => 'pxc-zkralxpc5d****', ], ], ], ], 'ReadDBInstances' => [ 'description' => '只读实例名称列表。', 'type' => 'array', 'items' => [ 'description' => '只读实例名称。', 'type' => 'string', 'example' => 'pxr-*********', ], ], 'ColumnarReadDBInstances' => [ 'description' => '列存只读实例信息。', 'type' => 'array', 'items' => [ 'title' => '', 'description' => '列存只读实例信息。', 'type' => 'string', 'example' => 'xxx', ], ], 'ResourceGroupId' => [ 'title' => '资源组ID', 'description' => '资源组ID。', 'type' => 'string', 'example' => 'rg-*********', ], 'TagSet' => [ 'title' => '标签集合', 'description' => '标签集合。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '标签名称', 'description' => '标签名称。', 'type' => 'string', 'example' => 'key2', ], 'Value' => [ 'title' => '标签值', 'description' => '标签值。', 'type' => 'string', 'example' => 'value2', ], ], ], ], 'CnNodeCount' => [ 'description' => 'CN节点数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '2', ], 'DnNodeCount' => [ 'description' => 'DN节点数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '2', ], 'CnNodeClassCode' => [ 'description' => 'CN节点规格:'."\n" .'- **polarx.x4.medium.2e**:2核8G'."\n" .'- **polarx.x4.large.2e**:4核16G'."\n" .'- **polarx.x8.large.2e**:4核32G'."\n" .'- **polarx.x4.xlarge.2e**:8核32G'."\n" .'- **polarx.x8.xlarge.2e**:8核64G'."\n" .'- **polarx.x4.2xlarge.2e**:16核64G'."\n" .'- **polarx.x8.2xlarge.2e**:16核128G'."\n" .'- **polarx.x4.4xlarge.2e**:32核128G'."\n" .'- **polarx.x8.4xlarge.2e**:32核256G'."\n" .'- **polarx.st.8xlarge.2e**:60核470G'."\n" .'- **polarx.st.12xlarge.2e**:90核720G', 'type' => 'string', 'example' => 'polarx.x4.xlarge.2e', ], 'DnNodeClassCode' => [ 'description' => 'DN节点规格:'."\n" .'- **mysql.n2.medium.25**:2核4G'."\n" .'- **mysql.n4.medium.25**:2核8G'."\n" .'- **mysql.x8.medium.25**:2核16G'."\n" .'- **mysql.n2.large.25**:4核8G'."\n" .'- **mysql.n4.large.25**:4核16G'."\n" .'- **mysql.x8.large.25**:4核32G'."\n" .'- **mysql.n2.xlarge.25**:8核16G'."\n" .'- **mysql.n4.xlarge.25**:8核32G'."\n" .'- **mysql.x8.xlarge.25**:8核64G'."\n" .'- **mysql.n4.2xlarge.25**:16核64G'."\n" .'- **mysql.x8.2xlarge.25**:16核128G'."\n" .'- **mysql.x4.4xlarge.25**:32核128G'."\n" .'- **mysql.x8.4xlarge.25**:32核256G'."\n" .'- **mysql.st.8xlarge.25**:60核470G'."\n" .'- **mysql.st.12xlarge.25**:90核720G', 'type' => 'string', 'example' => 'mysql.x8.large.25', ], 'Series' => [ 'description' => '实例系列,取值如下:'."\n" ."\n" .'- **enterprise**:企业版'."\n" .'- **standard**:标准版', 'type' => 'string', 'example' => 'enterprise', ], 'LTSVersions' => [ 'type' => 'array', 'items' => [ 'description' => 'LTS版本号。', 'type' => 'string', 'example' => 'X.X.X.X', ], 'required' => true, ], 'TopologyType' => [ 'title' => '拓扑类型:'."\n" ."\n" .'- **3azones**:三可用区;'."\n" .'- **1azone**:单可用区。', 'description' => '拓扑类型:'."\n" ."\n" .'- **3azones**:三可用区;'."\n" .'- **1azone**:单可用区。', 'type' => 'string', 'deprecated' => false, 'required' => true, 'example' => '3azones', 'pattern' => '', 'default' => '3azones', ], 'PrimaryZone' => [ 'title' => '主可用区。', 'description' => '主可用区。', 'type' => 'string', 'deprecated' => false, 'required' => true, 'example' => 'cn-shenzhen-e', 'pattern' => '', 'default' => '', ], 'SecondaryZone' => [ 'title' => '次可用区。', 'description' => '次可用区。', 'type' => 'string', 'deprecated' => false, 'example' => 'cn-shenzhen-a', 'pattern' => '', 'default' => '', ], 'TertiaryZone' => [ 'title' => '第三可用区。', 'description' => '第三可用区。', 'type' => 'string', 'deprecated' => false, 'example' => 'cn-shenzhen-e', 'pattern' => '', 'default' => '', ], 'DifferentDNSpec' => [ 'description' => '实例的DN节点之间的规格是否相同,取值如下:'."\n" ."\n" .'- true:规格不同'."\n" .'- false:规格相同', 'type' => 'boolean', 'enumValueTitles' => [], 'example' => 'false', ], 'ColumnarInstanceName' => [ 'description' => '列存引擎实例名称。', 'type' => 'string', 'example' => 'xxxx', ], 'CanNotCreateColumnar' => [ 'description' => '是否支持列存索引功能。', 'type' => 'boolean', 'example' => 'true', ], 'GdnInstanceName' => [ 'type' => 'string', ], 'GdnMemberList' => [ 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Role' => [ 'type' => 'string', ], 'MemberName' => [ 'type' => 'string', ], 'Status' => [ 'type' => 'string', ], ], ], ], 'SpecCategory' => [ 'type' => 'string', ], 'GdnRole' => [ 'type' => 'string', ], 'PrimaryInstanceId' => [ 'type' => 'string', ], 'StorageType' => [ 'type' => 'string', ], 'CpuType' => [ 'type' => 'string', ], 'EngineVersion' => [ 'type' => 'string', ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"DBInstance\\": {\\n \\"Type\\": \\"ReadWrite\\",\\n \\"Status\\": \\"Running\\",\\n \\"RightsSeparationStatus\\": \\"disabled\\",\\n \\"DBNodeCount\\": 2,\\n \\"Expired\\": \\"false\\",\\n \\"CreateTime\\": \\"2021-08-31T08:56:25.000+0000\\",\\n \\"PayType\\": \\"Postpaid\\",\\n \\"Port\\": \\"3306\\",\\n \\"LockMode\\": \\"Unlock\\",\\n \\"Description\\": \\"test instance\\",\\n \\"ConnectionString\\": \\"pxc-sprpx766vo****.polarx.singapore.rds.aliyuncs.com\\",\\n \\"StorageUsed\\": 17042505728,\\n \\"ExpireDate\\": \\"2022-08-31T16:00:00.000+0000\\",\\n \\"CommodityCode\\": \\"drds_polarxpost_public_cn\\",\\n \\"MaintainStartTime\\": \\"06:00\\",\\n \\"DBInstanceType\\": \\"ReadWrite\\",\\n \\"DBNodeClass\\": \\"polarx.x4.large.2e\\",\\n \\"LatestMinorVersion\\": \\"polarx-kernel_5.4.11-16301083_xcluster-20210805\\",\\n \\"MaintainEndTime\\": \\"06:00\\",\\n \\"DBType\\": \\"polarx\\",\\n \\"RightsSeparationEnabled\\": false,\\n \\"VPCId\\": \\"vpc-xxxxx\\",\\n \\"MinorVersion\\": \\"polarx-kernel_5.4.11-16301083_xcluster-20210805\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"Network\\": \\"VPC\\",\\n \\"DBVersion\\": \\"5.5\\",\\n \\"VSwitchId\\": \\"vsw-********\\",\\n \\"ZoneId\\": \\"cn-hangzhou-a\\",\\n \\"Engine\\": \\"polarx\\",\\n \\"KindCode\\": 18,\\n \\"Id\\": \\"pxc-zkralxpc5d****\\",\\n \\"DBNodes\\": [\\n {\\n \\"ComputeNodeId\\": \\"pxc-i-********\\",\\n \\"NodeClass\\": \\"polarx.x4.large.2e\\",\\n \\"DataNodeId\\": \\"pxc-xdb-xxxxxx\\",\\n \\"ZoneId\\": \\"cn-hangzhou-a\\",\\n \\"Id\\": \\"pxi-*********\\",\\n \\"RegionId\\": \\"cn-hangzhou\\"\\n }\\n ],\\n \\"ConnAddrs\\": [\\n {\\n \\"Type\\": \\"VPC\\",\\n \\"VSwitchId\\": \\"vsw-*********\\",\\n \\"Port\\": 3306,\\n \\"VPCId\\": \\"vpc-xxxxxx\\",\\n \\"ConnectionString\\": \\"polardbx-xxx.aliyuncs.com\\",\\n \\"VpcInstanceId\\": \\"pxc-zkralxpc5d****\\"\\n }\\n ],\\n \\"ReadDBInstances\\": [\\n \\"pxr-*********\\"\\n ],\\n \\"ColumnarReadDBInstances\\": [\\n \\"xxx\\"\\n ],\\n \\"ResourceGroupId\\": \\"rg-*********\\",\\n \\"TagSet\\": [\\n {\\n \\"Key\\": \\"key2\\",\\n \\"Value\\": \\"value2\\"\\n }\\n ],\\n \\"CnNodeCount\\": 2,\\n \\"DnNodeCount\\": 2,\\n \\"CnNodeClassCode\\": \\"polarx.x4.xlarge.2e\\",\\n \\"DnNodeClassCode\\": \\"mysql.x8.large.25\\",\\n \\"Series\\": \\"enterprise\\",\\n \\"LTSVersions\\": [\\n \\"X.X.X.X\\"\\n ],\\n \\"TopologyType\\": \\"3azones\\",\\n \\"PrimaryZone\\": \\"cn-shenzhen-e\\",\\n \\"SecondaryZone\\": \\"cn-shenzhen-a\\",\\n \\"TertiaryZone\\": \\"cn-shenzhen-e\\",\\n \\"DifferentDNSpec\\": false,\\n \\"ColumnarInstanceName\\": \\"xxxx\\",\\n \\"CanNotCreateColumnar\\": true,\\n \\"GdnInstanceName\\": \\"\\",\\n \\"GdnMemberList\\": [\\n {\\n \\"Role\\": \\"\\",\\n \\"MemberName\\": \\"\\",\\n \\"Status\\": \\"\\"\\n }\\n ],\\n \\"SpecCategory\\": \\"\\",\\n \\"GdnRole\\": \\"\\",\\n \\"PrimaryInstanceId\\": \\"\\",\\n \\"StorageType\\": \\"\\",\\n \\"CpuType\\": \\"\\",\\n \\"EngineVersion\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 9B2F3840-5C98-475C-B269-2D5C3A31797C\\n \\n ReadWrite\\n Running\\n disabled\\n 2\\n false\\n 2021-08-31T08:56:25.000+0000\\n Postpaid\\n 3306\\n Unlock\\n test instance\\n pxc-sprpx766vo****.polarx.singapore.rds.aliyuncs.com\\n 17042505728\\n 2022-08-31T16:00:00.000+0000\\n drds_polarxpost_public_cn\\n 06:00\\n ReadWrite\\n polarx.x4.large.2e\\n polarx-kernel_5.4.11-16301083_xcluster-20210805\\n 06:00\\n polarx\\n false\\n vpc-xxxxx\\n polarx-kernel_5.4.11-16301083_xcluster-20210805\\n cn-hangzhou\\n VPC\\n 5.5\\n vsw-********\\n cn-hangzhou-a\\n polarx\\n 18\\n pxc-zkralxpc5d****\\n \\n pxc-i-********\\n polarx.x4.large.2e\\n pxc-xdb-xxxxxx\\n cn-hangzhou-a\\n pxi-*********\\n cn-hangzhou\\n \\n \\n VPC\\n vsw-*********\\n 3306\\n vpc-xxxxxx\\n polardbx-xxx.aliyuncs.com\\n pxc-zkralxpc5d****\\n \\n pxr-*********\\n rg-*********\\n \\n key2\\n value2\\n \\n 2\\n 2\\n polarx.x4.xlarge.2e\\n mysql.x8.large.25\\n enterprise\\n X.X.X.X\\n 3azones\\n cn-shenzhen-e\\n cn-shenzhen-a\\n cn-shenzhen-e\\n \\n","errorExample":""}]', 'title' => '查询实例属性', ], 'DescribeDBInstanceConfig' => [ 'summary' => '调用DescribeDBInstanceConfig接口获取实例配置参数。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '86241', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域的ID。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。'."\n" ."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-*********', ], ], [ 'name' => 'ConfigName', 'in' => 'query', 'schema' => [ 'description' => '配置标识, 默认:htap。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'htap', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。'."\n" ."\n", 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'ConfigName' => [ 'description' => '配置Key。', 'type' => 'string', 'example' => 'htap', ], 'DbInstanceName' => [ 'description' => '实例ID。'."\n" ."\n", 'type' => 'string', 'example' => 'pxc-sprcym7g7w****', ], 'ConfigValue' => [ 'description' => '配置项,说明如下:'."\n" ."\n" .'- attendHtapList:开启Htap的实例列表。'."\n" .'- autoAttendHtap:是否自动把新建的只读实例加入到HTAP列表里。'."\n" .'- delayExecutionStrategy:当只读延迟到达storageDelayThreshold设定的值时,将只读流量切回主实例。默认值为1,取值为0或1。'."\n" .'- enableConsistentReplicaRead:是否开启一致性读。'."\n" .'- storageDelayThreshold:只读实例延迟阈值,默认3s,范围为:0~3600*24。'."\n" .'- enableHtap:是否开始Htap。'."\n" .'- masterReadWeight:主节点读权重,设置100表示100%的流量打到主节点,范围为:0~100。', 'type' => 'string', 'example' => '{\\"attendHtapList\\":[\\"pxc-hzruyzes08****\\"],\\"autoAttendHtap\\":\\"true\\",\\"delayExecutionStrategy\\":1,\\"enableConsistentReplicaRead\\":true,\\"enableHtap\\":\\"true\\",\\"masterReadWeight\\":100,\\"storageDelayThreshold\\":3}', ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Data\\": {\\n \\"ConfigName\\": \\"htap\\",\\n \\"DbInstanceName\\": \\"pxc-sprcym7g7w****\\",\\n \\"ConfigValue\\": \\"{\\\\\\\\\\\\\\"attendHtapList\\\\\\\\\\\\\\":[\\\\\\\\\\\\\\"pxc-hzruyzes08****\\\\\\\\\\\\\\"],\\\\\\\\\\\\\\"autoAttendHtap\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"true\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"delayExecutionStrategy\\\\\\\\\\\\\\":1,\\\\\\\\\\\\\\"enableConsistentReplicaRead\\\\\\\\\\\\\\":true,\\\\\\\\\\\\\\"enableHtap\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"true\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"masterReadWeight\\\\\\\\\\\\\\":100,\\\\\\\\\\\\\\"storageDelayThreshold\\\\\\\\\\\\\\":3}\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n C458B1E8-1683-3645-B154-6BA32080EEA\\n \\n htap\\n pxc-sprcym7g7w****\\n {\\\\\\"attendHtapList\\\\\\":[\\\\\\"pxc-hzruyzes08****\\\\\\"],\\\\\\"autoAttendHtap\\\\\\":\\\\\\"true\\\\\\",\\\\\\"delayExecutionStrategy\\\\\\":1,\\\\\\"enableConsistentReplicaRead\\\\\\":true,\\\\\\"enableHtap\\\\\\":\\\\\\"true\\\\\\",\\\\\\"masterReadWeight\\\\\\":100,\\\\\\"storageDelayThreshold\\\\\\":3}\\n \\n","errorExample":""}]', 'title' => '查询实例配置参数', ], 'DescribeDBInstances' => [ 'summary' => '查询实例列表。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '86242', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', 'enum' => [ 'cn-shenzhen', 'cn-beijing', 'cn-wulanchabu', 'cn-shenzhen-finance-1', 'cn-north-2-gov-1', 'cn-qingdao', 'cn-shanghai', 'cn-shanghai-finance-1', 'cn-hongkong', 'cn-hangzhou-finance', 'ap-southeast-1', 'eu-central-1', 'cn-huhehaote', 'ap-southeast-5', 'us-east-1', 'cn-zhangjiakou', 'us-west-1', 'cn-hangzhou', 'ap-northeast-1', 'cn-zhengzhou-jva', 'cn-shanghai-cloudspe', 'ap-southeast-6', 'ap-southeast-7', ], ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'description' => '分页下标:从1开始。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'example' => '1', 'pattern' => '^\\d+$', 'default' => '1', ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '页面大小,取值如下:'."\n" ."\n" .'- 30'."\n" .'- 50'."\n" .'- 100', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '5', 'enumValueTitles' => [], 'example' => '30', 'pattern' => '^\\d+$', 'default' => '30', 'enum' => [ '30', '50', '100', ], ], ], [ 'name' => 'ResourceGroupId', 'in' => 'query', 'schema' => [ 'title' => '资源组ID', 'description' => '资源组ID。', 'type' => 'string', 'required' => false, 'example' => 'rg-acfmyst47******', ], ], [ 'name' => 'Tags', 'in' => 'query', 'schema' => [ 'title' => '标签过滤条件', 'description' => '标签列表。', 'type' => 'string', 'required' => false, 'example' => '[{\\"TagKey\\":\\"test\\",\\"TagValue\\":\\"test-value\\"}]', ], ], [ 'name' => 'InstanceId', 'in' => 'query', 'schema' => [ 'title' => '实例名称', 'description' => '实例ID。', 'type' => 'string', 'required' => false, 'example' => 'dinga93c84f4d***', ], ], [ 'name' => 'Series', 'in' => 'query', 'allowEmptyValue' => false, 'schema' => [ 'description' => '实例系列,取值如下:'."\n" ."\n" .'- **enterprise**:企业版'."\n" .'- **standard**:标准版', 'type' => 'string', 'required' => false, 'example' => 'enterprise', ], ], [ 'name' => 'MustHasCdc', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '是否必须有日志引擎。', 'type' => 'boolean', 'required' => false, 'example' => 'true', ], ], [ 'name' => 'DbVersion', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], [ 'name' => 'Description', 'in' => 'query', 'schema' => [ 'description' => '数据库描述/备注', 'type' => 'string', 'required' => false, 'example' => 'app-test', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'description' => '返回信息列表。', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'PageNumber' => [ 'description' => '页面下标。', 'type' => 'integer', 'format' => 'int32', 'example' => '1', ], 'PageSize' => [ 'description' => '页面大小。', 'type' => 'integer', 'format' => 'int32', 'example' => '30', ], 'TotalNumber' => [ 'description' => '总数。', 'type' => 'integer', 'format' => 'int32', 'example' => '30', ], 'DBInstances' => [ 'description' => '实例列表。', 'type' => 'array', 'items' => [ 'description' => '实例详情。', 'type' => 'object', 'properties' => [ 'Type' => [ 'description' => '实例类型:'."\n" ."\n" .'- **ReadWrite**: 主实例'."\n" .'- **ReadOnly**: 只读实例', 'type' => 'string', 'example' => 'ReadWrite', ], 'Status' => [ 'description' => '实例状态,详情请参见[实例状态表](~~339826~~)。', 'type' => 'string', 'example' => 'Running', ], 'CommodityCode' => [ 'description' => '商品类型。', 'type' => 'string', 'example' => 'drds_polarxpre_public_cn', ], 'ExpireTime' => [ 'description' => '过期时间。', 'type' => 'string', 'example' => '2021-12-01T16:00:00.000+0000', ], 'Expired' => [ 'description' => '是否过期。', 'type' => 'boolean', 'example' => 'false', ], 'CreateTime' => [ 'description' => '创建时间。', 'type' => 'string', 'example' => '2021-11-01T03:49:50.000+0000', ], 'PayType' => [ 'description' => '实例付费方式,取值:'."\n" ."\n" .'- **Postpaid**:按量付费;'."\n" .'- **Prepaid**:包年包月。', 'type' => 'string', 'example' => 'Prepaid', ], 'LockReason' => [ 'description' => '锁定原因。', 'type' => 'string', 'example' => '欠费', ], 'DBType' => [ 'description' => '数据库类型。', 'type' => 'string', 'example' => 'polarx', ], 'LockMode' => [ 'description' => '是否锁定。', 'type' => 'string', 'example' => 'Unlock', ], 'VPCId' => [ 'description' => 'VPC ID。', 'type' => 'string', 'example' => 'VPCID', ], 'MinorVersion' => [ 'description' => '当前内核版本。', 'type' => 'string', 'example' => 'polarx-kernel_5.4.12-16349923_xcluster-20210926', ], 'RegionId' => [ 'description' => '地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou', ], 'Network' => [ 'description' => '网络类型。', 'type' => 'string', 'example' => 'VPC', ], 'DBVersion' => [ 'description' => '数据库版本。', 'type' => 'string', 'example' => '5.7', ], 'Description' => [ 'description' => '数据库描述。', 'type' => 'string', 'example' => '测试', ], 'NodeClass' => [ 'description' => '规格。', 'type' => 'string', 'example' => 'polarx.x4.large.2e', ], 'StorageUsed' => [ 'description' => '存储使用。', 'type' => 'integer', 'format' => 'int64', 'example' => '40658534400', ], 'NodeCount' => [ 'description' => '节点个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '5', ], 'ZoneId' => [ 'description' => '可用区ID。', 'type' => 'string', 'example' => 'cn-hangzhou-g', ], 'Engine' => [ 'description' => '引擎型号。', 'type' => 'string', 'example' => 'polarx', ], 'Id' => [ 'description' => '实例ID。', 'type' => 'string', 'example' => 'pxc-hzr2yeov******', ], 'Nodes' => [ 'description' => '节点列表。', 'type' => 'array', 'items' => [ 'description' => '节点列表。', 'type' => 'object', 'properties' => [ 'ZoneId' => [ 'description' => '可用区ID。', 'type' => 'string', 'example' => 'cn-hangzhou-g', ], 'Id' => [ 'description' => '节点ID。', 'type' => 'string', 'example' => 'pxi-zd89wrzqh******', ], 'RegionId' => [ 'description' => '区域ID。', 'type' => 'string', 'example' => 'cn-hangzhou-g-aliyun', ], 'ClassCode' => [ 'description' => '实例规格。', 'type' => 'string', 'example' => 'polarx.x4.large.2e', ], 'Name' => [ 'type' => 'string', ], ], ], ], 'ReadDBInstances' => [ 'description' => '只读实例列表。', 'type' => 'array', 'items' => [ 'description' => '只读实例名称。', 'type' => 'string', 'example' => 'pxr-hzr2yeov******', ], ], 'ColumnarReadDBInstances' => [ 'description' => '列存只读实例信息。', 'type' => 'array', 'items' => [ 'description' => '列存只读实例信息。', 'type' => 'string', 'example' => 'xxxxxxxx', ], ], 'ResourceGroupId' => [ 'title' => '资源组ID', 'description' => '资源组ID', 'type' => 'string', 'example' => 'rg-xxxxxx', ], 'TagSet' => [ 'title' => '标签集合', 'description' => '标签集合。', 'type' => 'array', 'items' => [ 'description' => '标签集合。', 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '标签名称', 'description' => '标签名称。', 'type' => 'string', 'example' => 'key1', ], 'Value' => [ 'title' => '标签值', 'description' => '标签值。', 'type' => 'string', 'example' => 'value1', ], ], ], ], 'DBInstanceName' => [ 'title' => '数据库实例名称', 'description' => '数据库实例名称。', 'type' => 'string', 'example' => 'pxc-xxxxx', ], 'DnNodeCount' => [ 'description' => 'DN节点个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '2', ], 'CnNodeCount' => [ 'description' => 'CN节点个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '2', ], 'CnNodeClassCode' => [ 'description' => 'CN节点规格。'."\n" ."\n" .'- **polarx.x4.medium.2e**:2核8G'."\n" .'- **polarx.x4.large.2e**:4核16G'."\n" .'- **polarx.x8.large.2e**:4核32G'."\n" .'- **polarx.x4.xlarge.2e**:8核32G'."\n" .'- **polarx.x8.xlarge.2e**:8核64G'."\n" .'- **polarx.x4.2xlarge.2e**:16核64G'."\n" .'- **polarx.x8.2xlarge.2e**:16核128G'."\n" .'- **polarx.x4.4xlarge.2e**:32核128G'."\n" .'- **polarx.x8.4xlarge.2e**:32核256G'."\n" .'- **polarx.st.8xlarge.2e**:60核470G'."\n" .'- **polarx.st.12xlarge.2e**:90核720G', 'type' => 'string', 'example' => 'polarx.x4.large.2e', ], 'DnNodeClassCode' => [ 'description' => 'DN节点规格。'."\n" .'- **mysql.n2.medium.25**:2核4G'."\n" .'- **mysql.n4.medium.25**:2核8G'."\n" .'- **mysql.x8.medium.25**:2核16G'."\n" .'- **mysql.n2.large.25**:4核8G'."\n" .'- **mysql.n4.large.25**:4核16G'."\n" .'- **mysql.x8.large.25**:4核32G'."\n" .'- **mysql.n2.xlarge.25**:8核16G'."\n" .'- **mysql.n4.xlarge.25**:8核32G'."\n" .'- **mysql.x8.xlarge.25**:8核64G'."\n" .'- **mysql.n4.2xlarge.25**:16核64G'."\n" .'- **mysql.x8.2xlarge.25**:16核128G'."\n" .'- **mysql.x4.4xlarge.25**:32核128G'."\n" .'- **mysql.x8.4xlarge.25**:32核256G'."\n" .'- **mysql.st.8xlarge.25**:60核470G'."\n" .'- **mysql.st.12xlarge.25**:90核720G', 'type' => 'string', 'example' => 'mysql.n4.medium.25', ], 'Series' => [ 'description' => '实例系列,取值如下:'."\n" ."\n" .'- **enterprise**:企业版'."\n" .'- **standard**:标准版', 'type' => 'string', 'example' => 'enterprise', ], 'ContainBinlogX' => [ 'description' => '是否包含多流日志服务,取值如下:'."\n" ."\n" .'- **true**:是'."\n" .'- **false**:否', 'type' => 'boolean', 'example' => 'true', ], 'SupportBinlogX' => [ 'description' => '当前实例是否支持多流,取值如下:'."\n" ."\n" .'- **true**:是'."\n" .'- **false**:否', 'type' => 'boolean', 'example' => 'true', ], 'CdcInstanceName' => [ 'description' => '日志节点名称。', 'type' => 'string', 'example' => 'pxc-c-dmlgit****', ], 'TopologyType' => [ 'title' => '拓扑类型:'."\n" ."\n" .'- **3azones**:三可用区;'."\n" .'- **1azone**:单可用区。', 'description' => '拓扑类型:'."\n" ."\n" .'- **3azones**:三可用区;'."\n" .'- **1azone**:单可用区。', 'type' => 'string', 'deprecated' => false, 'required' => true, 'example' => '3azones', 'pattern' => '', 'default' => '3azones', ], 'TertiaryZone' => [ 'title' => '第三可用区。', 'description' => '第三可用区。', 'type' => 'string', 'deprecated' => false, 'example' => 'cn-hangzhou-k', 'pattern' => '', 'default' => '', ], 'PrimaryZone' => [ 'title' => '主可用区。', 'description' => '主可用区。', 'type' => 'string', 'deprecated' => false, 'required' => true, 'example' => 'cn-hangzhou-j', 'pattern' => '', 'default' => '', ], 'SecondaryZone' => [ 'title' => '次可用区。', 'description' => '次可用区。', 'type' => 'string', 'deprecated' => false, 'example' => 'cn-hangzhou-l', 'pattern' => '', 'default' => '', ], 'ColumnarInstanceName' => [ 'description' => '列存引擎实例名称。', 'type' => 'string', 'example' => 'xxxxxxxx', ], 'isInGdn' => [ 'type' => 'boolean', ], 'gdnRole' => [ 'type' => 'string', ], 'CpuType' => [ 'type' => 'string', ], 'PrimaryInstanceId' => [ 'type' => 'string', ], 'StorageType' => [ 'type' => 'string', ], 'EngineVersion' => [ 'type' => 'string', ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalNumber\\": 30,\\n \\"DBInstances\\": [\\n {\\n \\"Type\\": \\"ReadWrite\\",\\n \\"Status\\": \\"Running\\",\\n \\"CommodityCode\\": \\"drds_polarxpre_public_cn\\",\\n \\"ExpireTime\\": \\"2021-12-01T16:00:00.000+0000\\",\\n \\"Expired\\": false,\\n \\"CreateTime\\": \\"2021-11-01T03:49:50.000+0000\\",\\n \\"PayType\\": \\"Prepaid\\",\\n \\"LockReason\\": \\"欠费\\",\\n \\"DBType\\": \\"polarx\\",\\n \\"LockMode\\": \\"Unlock\\",\\n \\"VPCId\\": \\"VPCID\\",\\n \\"MinorVersion\\": \\"polarx-kernel_5.4.12-16349923_xcluster-20210926\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"Network\\": \\"VPC\\",\\n \\"DBVersion\\": \\"5.7\\",\\n \\"Description\\": \\"测试\\",\\n \\"NodeClass\\": \\"polarx.x4.large.2e\\",\\n \\"StorageUsed\\": 40658534400,\\n \\"NodeCount\\": 5,\\n \\"ZoneId\\": \\"cn-hangzhou-g\\",\\n \\"Engine\\": \\"polarx\\",\\n \\"Id\\": \\"pxc-hzr2yeov******\\",\\n \\"Nodes\\": [\\n {\\n \\"ZoneId\\": \\"cn-hangzhou-g\\",\\n \\"Id\\": \\"pxi-zd89wrzqh******\\",\\n \\"RegionId\\": \\"cn-hangzhou-g-aliyun\\",\\n \\"ClassCode\\": \\"polarx.x4.large.2e\\",\\n \\"Name\\": \\"\\"\\n }\\n ],\\n \\"ReadDBInstances\\": [\\n \\"pxr-hzr2yeov******\\"\\n ],\\n \\"ColumnarReadDBInstances\\": [\\n \\"xxxxxxxx\\"\\n ],\\n \\"ResourceGroupId\\": \\"rg-xxxxxx\\",\\n \\"TagSet\\": [\\n {\\n \\"Key\\": \\"key1\\",\\n \\"Value\\": \\"value1\\"\\n }\\n ],\\n \\"DBInstanceName\\": \\"pxc-xxxxx\\",\\n \\"DnNodeCount\\": 2,\\n \\"CnNodeCount\\": 2,\\n \\"CnNodeClassCode\\": \\"polarx.x4.large.2e\\",\\n \\"DnNodeClassCode\\": \\"mysql.n4.medium.25\\",\\n \\"Series\\": \\"enterprise\\",\\n \\"ContainBinlogX\\": true,\\n \\"SupportBinlogX\\": true,\\n \\"CdcInstanceName\\": \\"pxc-c-dmlgit****\\",\\n \\"TopologyType\\": \\"3azones\\",\\n \\"TertiaryZone\\": \\"cn-hangzhou-k\\",\\n \\"PrimaryZone\\": \\"cn-hangzhou-j\\",\\n \\"SecondaryZone\\": \\"cn-hangzhou-l\\",\\n \\"ColumnarInstanceName\\": \\"xxxxxxxx\\",\\n \\"isInGdn\\": true,\\n \\"gdnRole\\": \\"\\",\\n \\"CpuType\\": \\"\\",\\n \\"PrimaryInstanceId\\": \\"\\",\\n \\"StorageType\\": \\"\\",\\n \\"EngineVersion\\": \\"\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n C458B1E8-1683-3645-B154-6BA32080EEA\\n 1\\n 30\\n 30\\n \\n ReadWrite\\n Running\\n drds_polarxpre_public_cn\\n 2021-12-01T16:00:00.000+0000\\n false\\n 2021-11-01T03:49:50.000+0000\\n Prepaid\\n 欠费\\n polarx\\n Unlock\\n VPCID\\n polarx-kernel_5.4.12-16349923_xcluster-20210926\\n cn-hangzhou\\n VPC\\n 5.7\\n 测试\\n polarx.x4.large.2e\\n 40658534400\\n 5\\n cn-hangzhou-g\\n polarx\\n pxc-hzr2yeov******\\n \\n cn-hangzhou-g\\n pxi-zd89wrzqh******\\n polarx.x4.large.2e\\n cn-hangzhou-g-aliyun\\n \\n pxr-hzr2yeov******\\n rg-xxxxxx\\n \\n key1\\n value1\\n \\n pxc-xxxxx\\n 2\\n 2\\n polarx.x4.large.2e\\n mysql.n4.medium.25\\n enterprise\\n true\\n true\\n pxc-c-dmlgit****\\n 3azones\\n cn-hangzhou-k\\n cn-hangzhou-j\\n cn-hangzhou-l\\n xxxxx\\n \\n","errorExample":""}]', 'title' => '查询数据库实例列表', ], 'DescribeDBInstanceSSL' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86243', 'abilityTreeNodes' => [ 'FEATUREdrdsUULYZA', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。'."\n" ."\n", 'type' => 'string', 'required' => false, 'example' => 'pxc-*********', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域的ID。'."\n", 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。'."\n" ."\n", 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'SSLEnabled' => [ 'description' => '实例是否开启SSL:'."\n" ."\n" .'- **true**:开启'."\n" .'- **false**: 关闭', 'type' => 'boolean', 'example' => 'false', ], 'SSLExpiredTime' => [ 'description' => '证书过期时间。', 'type' => 'string', 'example' => '2022-11-04T09:39:07Z', ], 'CertCommonName' => [ 'description' => '证书绑定域名。', 'type' => 'string', 'example' => 'pxc-sddddddcym7g7w****.polarx.singapore.rds.aliyuncs.com', ], ], ], ], ], ], ], 'errorCodes' => [ 400 => [ [ 'errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', ], [ 'errorCode' => 'InvalidAction', 'errorMessage' => 'The specified Action is invalid.', ], ], 404 => [ [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist.', ], ], 500 => [ [ 'errorCode' => 'InternalError', 'errorMessage' => 'An error occurred while processing your request.', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Data\\": {\\n \\"SSLEnabled\\": false,\\n \\"SSLExpiredTime\\": \\"2022-11-04T09:39:07Z\\",\\n \\"CertCommonName\\": \\"pxc-sddddddcym7g7w****.polarx.singapore.rds.aliyuncs.com\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n C458B1E8-1683-3645-B154-6BA32080EEA\\n \\n false\\n 2022-11-04T09:39:07Z\\n pxc-sddddddcym7g7w****.polarx.singapore.rds.aliyuncs.com\\n \\n","errorExample":""}]', 'title' => '查看SSL信息', 'summary' => '查看SSL信息。', ], 'DescribeDBInstanceTDE' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86244', 'abilityTreeNodes' => [ 'FEATUREdrds9HBOA5', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。'."\n" ."\n", 'type' => 'string', 'required' => false, 'example' => 'pxc-********', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属的地域ID。'."\n", 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。'."\n" ."\n", 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'TDEStatus' => [ 'description' => '是否开启TDE:'."\n" ."\n" .'- 0 = 未开启;'."\n" .'- 1 = 已开启。', 'type' => 'string', 'example' => '0', ], ], ], ], ], ], ], 'errorCodes' => [ 403 => [ [ 'errorCode' => 'IncorrectEngineVersion', 'errorMessage' => 'The current engine version does not support the operation.', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Data\\": {\\n \\"TDEStatus\\": \\"0\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n C458B1E8-1683-3645-B154-6BA32080EEA\\n \\n 0\\n \\n","errorExample":""}]', 'title' => '获取实例TDE的详细信息', 'summary' => '调用DescribeDBInstanceTDE接口获取实例TDE的详细信息。', ], 'DescribeDBInstanceTopology' => [ 'summary' => '调用DescribeDBInstanceTopology接口获取实例拓扑信息。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '86245', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属的地域ID。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。'."\n" ."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'StartTime', 'in' => 'query', 'schema' => [ 'description' => '查询拓扑中历史实例范围开始时间,格式为yyyy-MM-dd HH:mm:ss。', 'type' => 'string', 'required' => false, 'example' => '2021-10-21T10:30:45Z 04:00:00', ], ], [ 'name' => 'EndTime', 'in' => 'query', 'schema' => [ 'description' => '查询拓扑中历史实例范围结束时间,格式为yyyy-MM-dd HH:mm:ss。', 'type' => 'string', 'required' => false, 'example' => '2021-10-22T10:30:45Z 04:00:00', ], ], [ 'name' => 'MinuteSimple', 'in' => 'query', 'schema' => [ 'description' => '是否查询历史拓扑。', 'type' => 'boolean', 'required' => false, 'example' => 'true', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。'."\n" ."\n", 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'LogicInstanceTopology' => [ 'description' => '拓扑信息。', 'type' => 'object', 'properties' => [ 'DBInstanceName' => [ 'description' => '实例名称。', 'type' => 'string', 'example' => 'pxc-sprcym7g7w****', ], 'DBInstanceCreateTime' => [ 'description' => '实例创建时间,格式为yyyy-MM-dd HH:mm:ss。', 'type' => 'string', 'example' => '2021-10-21T10:30:45Z 04:00:00', ], 'MaintainStartTime' => [ 'description' => '运维开始时间,格式为HH:mm:ss。', 'type' => 'string', 'example' => '04:00:00', ], 'MaintainEndTime' => [ 'description' => '运维结束时间,格式为HH:mm:ss。', 'type' => 'string', 'example' => '05:00:00', ], 'LockReason' => [ 'description' => '锁定原因。', 'type' => 'string', 'example' => '欠费', ], 'DBInstanceStatus' => [ 'description' => '实例状态。', 'type' => 'integer', 'format' => 'int32', 'example' => '8', ], 'LockMode' => [ 'description' => '锁定状态 :'."\n" ."\n" .'- **0**:未锁定;'."\n" .'- **1**:锁定。', 'type' => 'integer', 'format' => 'int32', 'example' => '0', ], 'EngineVersion' => [ 'description' => '引擎版本,默认2.0。', 'type' => 'string', 'example' => '2.0', ], 'DBInstanceStorage' => [ 'description' => '存储节点个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1', ], 'DBInstanceConnType' => [ 'description' => '表示用lvs做负载均衡。', 'type' => 'string', 'example' => 'lvs', ], 'DBInstanceId' => [ 'description' => '实例ID。', 'type' => 'string', 'example' => '304726047', ], 'Engine' => [ 'description' => '引擎, 默认:polarx。', 'type' => 'string', 'example' => 'polarx', ], 'DBInstanceDescription' => [ 'description' => '实例描述。', 'type' => 'string', 'example' => 'pxc-sprcym7******', ], 'DBInstanceStatusDescription' => [ 'description' => '实例状态描述。', 'type' => 'string', 'example' => 'TDE_MODIFYING', ], 'Items' => [ 'description' => '节点列表。', 'type' => 'array', 'items' => [ 'description' => '节点信息。', 'type' => 'object', 'properties' => [ 'DBInstanceCreateTime' => [ 'description' => '实例创建时间。', 'type' => 'string', 'example' => '2021-10-21T10:30:45Z', ], 'DBInstanceName' => [ 'description' => '实例名称。', 'type' => 'string', 'example' => 'pxc-i-tk6t4z****', ], 'CharacterType' => [ 'description' => '节点属性,取值如下:'."\n" ."\n" .'- **polarx_cn**:计算节点;'."\n" .'- **polarx_store**:数据节点;'."\n" .'- **polarx_gms**:GMS节点。', 'type' => 'string', 'example' => '节点角色', ], 'MaintainStartTime' => [ 'description' => '运维开始时间。', 'type' => 'string', 'example' => '不展示', ], 'DiskSize' => [ 'description' => '磁盘大小。', 'type' => 'integer', 'format' => 'int64', 'example' => '3145728', ], 'MaintainEndTime' => [ 'description' => '运维结束时间。', 'type' => 'string', 'example' => '不展示', ], 'LockReason' => [ 'description' => '锁定原因。', 'type' => 'string', 'example' => '不展示', ], 'DBInstanceStatus' => [ 'description' => '实例状态。', 'type' => 'integer', 'format' => 'int32', 'example' => '8', ], 'LockMode' => [ 'description' => '是否锁定,取值如下:'."\n" ."\n" .'- **0**:未锁定;'."\n" .'- **1**:锁定。', 'type' => 'integer', 'format' => 'int32', 'example' => '0', ], 'EngineVersion' => [ 'description' => '引擎版本,默认2.0。', 'type' => 'string', 'example' => '5.7', ], 'DBInstanceConnType' => [ 'description' => '连接类型。', 'type' => 'integer', 'format' => 'int32', 'example' => '不展示', ], 'MaxConnections' => [ 'description' => '最大连接数。', 'type' => 'integer', 'format' => 'int32', 'example' => '4000', ], 'DBInstanceId' => [ 'description' => '实例ID。', 'type' => 'string', 'example' => '304726049', ], 'Engine' => [ 'description' => '引擎版本,取值如下:'."\n" ."\n" .'- **mysql **'."\n" .'- **polarx_cdc**'."\n" .'- **polarx_dn**', 'type' => 'string', 'example' => 'mysql', ], 'MaxIops' => [ 'description' => '最大Iops。', 'type' => 'integer', 'format' => 'int32', 'example' => '7000', ], 'DBInstanceDescription' => [ 'description' => '实例描述。', 'type' => 'string', 'example' => '不展示', ], 'DBInstanceStatusDescription' => [ 'description' => '实例状态描述。', 'type' => 'string', 'example' => '不展示', ], 'ConnectionIp' => [ 'description' => '数据结构体。', 'type' => 'array', 'items' => [ 'description' => '连接信息。', 'type' => 'object', 'properties' => [ 'Port' => [ 'description' => '端口。', 'type' => 'string', 'example' => '3306', ], 'DBInstanceNetType' => [ 'description' => '内部连接的方式,固定取值为1,表示经典网络。', 'type' => 'integer', 'format' => 'int32', 'example' => '1', ], 'ConnectionString' => [ 'description' => '连接信息。', 'type' => 'string', 'example' => 'pxc-xdb-m-pxcdym7g7w********.mysql.singapore.rds.aliyuncs.com', ], ], ], ], 'Region' => [ 'description' => '节点所属地域,如果为RDS节点,多个子节点的地域以 \';\' 分割。', 'type' => 'string', 'example' => 'cn-hangzhou', ], 'Azone' => [ 'description' => '节点所属可用区,如果为RDS节点,多个子节点的可用区以\';\'分割。', 'type' => 'string', 'example' => 'cn-hangzhou-a', ], 'Role' => [ 'description' => '节点角色,取值如下:'."\n" ."\n" .'- **master**:主节点'."\n" .'- **standby**:备节点', 'type' => 'string', 'example' => 'master', ], 'Activated' => [ 'description' => '节点是否启用,计算层仅启用主可用区节点,在实例执行主备切换后计算层备用节点会切换为主节点,所有存储层节点均启用。', 'type' => 'boolean', 'example' => 'true', ], 'AzoneRoleList' => [ 'description' => 'RDS三节点的数据信息列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Azone' => [ 'description' => 'RDS三节点中某个节点所属可用区。', 'type' => 'string', 'example' => 'cn-hangzhou-a', ], 'Role' => [ 'description' => 'RDS三节点中某个节点的角色,取值如下:'."\n" ."\n" .'- **leader**:主节点'."\n" .'- **follower**:从节点'."\n" .'- **logger**:日志节点', 'type' => 'string', 'example' => 'leader', ], ], ], ], 'Status' => [ 'description' => '节点状态:'."\n" ."\n" .'- **0**:运行中'."\n" .'- **1**:创建中'."\n" .'- **2**:异常'."\n" .'- **3**:已过期'."\n" .'- **4**:释放中'."\n" .'- **5**:已释放'."\n" .'- **6**:锁定', 'type' => 'string', 'example' => '0', ], 'NodeClass' => [ 'description' => '节点规格:'."\n" ."\n" .'- **polarx.x4.medium.2e**:2核8 GB'."\n" .'- **polarx.x4.large.2e**:4核16 GB'."\n" .'- **polarx.x8.large.2e**:4核32 GB'."\n" .'- **polarx.x4.xlarge.2e**:8核32 GB'."\n" .'- **polarx.x8.xlarge.2e**:8核64 GB'."\n" .'- **polarx.x4.2xlarge.2e**:16核64 GB'."\n" .'- **polarx.x8.2xlarge.2e**:16核128 GB'."\n" .'- **polarx.x4.4xlarge.2e**:32核128 GB'."\n" .'- **polarx.x8.4xlarge.2e**:32核256 GB'."\n" .'- **polarx.st.8xlarge.2e**:60核470 GB'."\n" .'- **polarx.st.12xlarge.2e**:90核720 GB', 'type' => 'string', 'example' => 'polarx.x4.large.2e', ], 'Version' => [ 'description' => '日志节点版本。', 'type' => 'string', 'example' => 'polarx-cdc-kernel-2.0.0-3985896', ], 'PhyInstanceName' => [ 'description' => '物理实例名', 'type' => 'string', 'example' => 'pxc-unrbk8oyz**********', ], 'StorageUsed' => [ 'description' => '存储空间的使用量,单位为MB。', 'type' => 'string', 'example' => '16681', ], ], ], ], 'HistoryItems' => [ 'description' => '历史节点列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'CharacterType' => [ 'description' => '节点属性,取值如下:'."\n" ."\n" .'- **polarx_cn**:计算节点;'."\n" .'- **polarx_store**:数据节点;'."\n" .'- **polarx_gms**:GMS节点。', 'type' => 'string', 'example' => '节点角色', ], 'Role' => [ 'description' => '节点角色,取值如下:'."\n" ."\n" .'- **master**:主节点'."\n" .'- **standby**:备节点', 'type' => 'string', 'example' => 'master', ], 'DBInstanceName' => [ 'description' => '实例名称。', 'type' => 'string', 'example' => 'pxc-sprcym7g7w****', ], 'DBInstanceId' => [ 'description' => '实例ID。', 'type' => 'string', 'example' => '304726049', ], 'Region' => [ 'description' => '节点所属地域,如果为RDS节点,多个子节点的地域以 \';\' 分割。', 'type' => 'string', 'example' => 'cn-hangzhou', ], 'Azone' => [ 'description' => '节点所属可用区,如果为RDS节点,多个子节点的可用区以\';\'分割。', 'type' => 'string', 'example' => 'cn-hangzhou-a', ], 'Activated' => [ 'description' => '节点是否启用,计算层仅启用主可用区节点,在实例执行主备切换后计算层备用节点会切换为主节点,所有存储层节点均启用。', 'type' => 'boolean', 'example' => 'true', ], 'PhyInstanceName' => [ 'description' => '物理实例名。', 'type' => 'string', 'example' => 'pxc-unrbk8oyz**********', ], ], ], ], ], ], ], ], ], ], ], ], 'errorCodes' => [ 403 => [ [ 'errorCode' => 'RAM.Permission.Denied', 'errorMessage' => 'RAM authentication failed.', ], ], [ [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist.', ], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Data\\": {\\n \\"LogicInstanceTopology\\": {\\n \\"DBInstanceName\\": \\"pxc-sprcym7g7w****\\",\\n \\"DBInstanceCreateTime\\": \\"2021-10-21T10:30:45Z 04:00:00\\",\\n \\"MaintainStartTime\\": \\"04:00:00\\",\\n \\"MaintainEndTime\\": \\"05:00:00\\",\\n \\"LockReason\\": \\"欠费\\",\\n \\"DBInstanceStatus\\": 8,\\n \\"LockMode\\": 0,\\n \\"EngineVersion\\": \\"2.0\\",\\n \\"DBInstanceStorage\\": 1,\\n \\"DBInstanceConnType\\": \\"lvs\\",\\n \\"DBInstanceId\\": \\"304726047\\",\\n \\"Engine\\": \\"polarx\\",\\n \\"DBInstanceDescription\\": \\"pxc-sprcym7******\\",\\n \\"DBInstanceStatusDescription\\": \\"TDE_MODIFYING\\",\\n \\"Items\\": [\\n {\\n \\"DBInstanceCreateTime\\": \\"2021-10-21T10:30:45Z\\",\\n \\"DBInstanceName\\": \\"pxc-i-tk6t4z****\\",\\n \\"CharacterType\\": \\"节点角色\\",\\n \\"MaintainStartTime\\": \\"不展示\\",\\n \\"DiskSize\\": 3145728,\\n \\"MaintainEndTime\\": \\"不展示\\",\\n \\"LockReason\\": \\"不展示\\",\\n \\"DBInstanceStatus\\": 8,\\n \\"LockMode\\": 0,\\n \\"EngineVersion\\": \\"5.7\\",\\n \\"DBInstanceConnType\\": 0,\\n \\"MaxConnections\\": 4000,\\n \\"DBInstanceId\\": \\"304726049\\",\\n \\"Engine\\": \\"mysql\\",\\n \\"MaxIops\\": 7000,\\n \\"DBInstanceDescription\\": \\"不展示\\",\\n \\"DBInstanceStatusDescription\\": \\"不展示\\",\\n \\"ConnectionIp\\": [\\n {\\n \\"Port\\": \\"3306\\",\\n \\"DBInstanceNetType\\": 1,\\n \\"ConnectionString\\": \\"pxc-xdb-m-pxcdym7g7w********.mysql.singapore.rds.aliyuncs.com\\"\\n }\\n ],\\n \\"Region\\": \\"cn-hangzhou\\",\\n \\"Azone\\": \\"cn-hangzhou-a\\",\\n \\"Role\\": \\"master\\",\\n \\"Activated\\": true,\\n \\"AzoneRoleList\\": [\\n {\\n \\"Azone\\": \\"cn-hangzhou-a\\",\\n \\"Role\\": \\"leader\\"\\n }\\n ],\\n \\"Status\\": \\"0\\",\\n \\"NodeClass\\": \\"polarx.x4.large.2e\\",\\n \\"Version\\": \\"polarx-cdc-kernel-2.0.0-3985896\\",\\n \\"PhyInstanceName\\": \\"pxc-unrbk8oyz**********\\",\\n \\"StorageUsed\\": \\"16681\\"\\n }\\n ],\\n \\"HistoryItems\\": [\\n {\\n \\"CharacterType\\": \\"节点角色\\",\\n \\"Role\\": \\"master\\",\\n \\"DBInstanceName\\": \\"pxc-sprcym7g7w****\\",\\n \\"DBInstanceId\\": \\"304726049\\",\\n \\"Region\\": \\"cn-hangzhou\\",\\n \\"Azone\\": \\"cn-hangzhou-a\\",\\n \\"Activated\\": true,\\n \\"PhyInstanceName\\": \\"pxc-unrbk8oyz**********\\"\\n }\\n ]\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n C458B1E8-1683-3645-B154-6BA32080EEA\\n \\n \\n pxc-sprcym7g7w****\\n 2021-10-21T10:30:45Z 04:00:00\\n 04:00:00\\n 05:00:00\\n 欠费\\n 8\\n 0\\n 2.0\\n 1\\n lvs\\n 304726047\\n polarx\\n pxc-sprcym7******\\n TDE_MODIFYING\\n \\n 2021-10-21T10:30:45Z\\n pxc-i-tk6t4z****\\n 节点角色\\n 不展示\\n 3145728\\n 不展示\\n 不展示\\n 8\\n 0\\n 5.7\\n 4000\\n 304726049\\n mysql\\n 7000\\n 不展示\\n 不展示\\n \\n 3306\\n 1\\n pxc-xdb-m-pxcdym7g7w********.mysql.singapore.rds.aliyuncs.com\\n \\n cn-hangzhou\\n cn-hangzhou-a\\n master\\n true\\n \\n cn-hangzhou-a\\n leader\\n \\n 0\\n polarx.x4.large.2e\\n polarx-cdc-kernel-2.0.0-3985896\\n pxc-unrbk8oyz**********\\n \\n \\n 节点角色\\n master\\n pxc-sprcym7g7w****\\n 304726049\\n cn-hangzhou\\n cn-hangzhou-a\\n true\\n pxc-unrbk8oyz**********\\n \\n \\n \\n","errorExample":""}]', 'title' => '查询实例拓扑信息', ], 'DescribeDBInstanceViaEndpoint' => [ 'summary' => '通过实例的连接地址获取实例的基本信息', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '163711', 'abilityTreeNodes' => [ 'FEATUREdrdsBRC5LQ', ], ], 'parameters' => [ [ 'name' => 'Endpoint', 'in' => 'query', 'schema' => [ 'description' => '实例的连接地址。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hz*******.polarx.rds.aliyuncs.com', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '14036EBE-CF2E-44DB-ACE9-AC6157D3A6FC', ], 'DBInstance' => [ 'description' => '实例信息', 'type' => 'object', 'properties' => [ 'Type' => [ 'description' => '实例类型:'."\n" ."\n" .'- **ReadWrite**: 主实例;'."\n" .'- **ReadOnly**: 只读实例。', 'type' => 'string', 'example' => 'ReadWrite', ], 'Status' => [ 'description' => '实例状态,详情请参见[实例状态表](~~339826~~)。', 'type' => 'string', 'example' => 'Running', ], 'RightsSeparationStatus' => [ 'description' => '三权分立状态:'."\n" ."\n" .'- **disabled**:未开启;'."\n" .'- **enabled**:开启;'."\n" .'- **processing**: 处理中;'."\n" .'- **unknown**:未知,可能是实例无法连接导致。', 'type' => 'string', 'example' => 'disabled', ], 'DBNodeCount' => [ 'description' => '实例节点数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '2', ], 'Expired' => [ 'description' => '是否过期:'."\n" ."\n" .'- **true**:过期;'."\n" .'- **false**:正常。', 'type' => 'string', 'example' => 'false', ], 'CreateTime' => [ 'description' => '创建时间。', 'type' => 'string', 'example' => '2021-08-31T08:56:25.000+0000', ], 'PayType' => [ 'description' => '实例付费方式,取值:'."\n" ."\n" .'- **Postpaid**:按量付费;'."\n" .'- **Prepaid**:包年包月。', 'type' => 'string', 'example' => 'Postpaid', ], 'Port' => [ 'description' => '实例连接端口', 'type' => 'string', 'example' => '3306', ], 'LockMode' => [ 'description' => '实例锁定模式:'."\n" ."\n" .'- **Unlock**:正常;'."\n" .'- **ManualLock**:手动触发锁定;'."\n" .'- **LockByExpiration**:实例过期自动锁定;'."\n" .'- **LockByRestoration**:实例回滚前的自动锁定;'."\n" .'- **LockByDiskQuota**:实例空间满自动锁定;'."\n" .'- **LockReadInstanceByDiskQuota**:只读实例空间满自动锁定。', 'type' => 'string', 'example' => 'Unlock', ], 'Description' => [ 'description' => '实例描述。', 'type' => 'string', 'example' => 'test instance', ], 'ConnectionString' => [ 'description' => '实例连接地址', 'type' => 'string', 'example' => 'pxc-sprpx766vo****.polarx.singapore.rds.aliyuncs.com', ], 'StorageUsed' => [ 'description' => '已经使用的存储,单位为B。', 'type' => 'integer', 'format' => 'int64', 'example' => '17042505728', ], 'ExpireDate' => [ 'description' => '到期时间。格式为yyyy-MM-ddTHH:mm:ss.sss+0000(UTC时间)。', 'type' => 'string', 'example' => '2022-08-31T16:00:00.000+0000', ], 'CommodityCode' => [ 'description' => '实例商品种类,固定取值为drds_polarxpost_public_cn。', 'type' => 'string', 'example' => 'drds_polarxpost_public_cn', ], 'MaintainStartTime' => [ 'description' => '实例可维护开始时间,此处为UTC时间,加8小时才是控制台上显示的可维护时间段。', 'type' => 'string', 'example' => '06:00', ], 'DBInstanceType' => [ 'description' => '实例类型:'."\n" ."\n" .'- **ReadWrite**: 主实例;'."\n" .'- **ReadOnly**: 只读实例。', 'type' => 'string', 'example' => 'ReadWrite', ], 'DBNodeClass' => [ 'description' => '实例节点规格。', 'type' => 'string', 'example' => 'polarx.x4.large.2e', ], 'LatestMinorVersion' => [ 'description' => '当前实例支持的最新内核版本。', 'type' => 'string', 'example' => 'polarx-kernel_5.4.11-16301083_xcluster-20210805', ], 'MaintainEndTime' => [ 'description' => '实例可维护结束时间,此处为UTC时间,加8小时为控制台上显示的可维护时间段。', 'type' => 'string', 'example' => '06:00', ], 'DBType' => [ 'description' => '数据库类型,固定取值为polarx。', 'type' => 'string', 'example' => 'polarx', ], 'RightsSeparationEnabled' => [ 'description' => '三权分立状态:'."\n" ."\n" .'- **false**:未开启'."\n" .'- **true**:开启', 'type' => 'boolean', 'example' => 'false', ], 'VPCId' => [ 'description' => 'VPC ID。', 'type' => 'string', 'example' => 'vpc-xxxxx', ], 'MinorVersion' => [ 'description' => '当前内核版本。', 'type' => 'string', 'example' => 'polarx-kernel_5.4.11-16301083_xcluster-20210805', ], 'RegionId' => [ 'description' => '实例所在地域。', 'type' => 'string', 'example' => 'cn-hangzhou', ], 'Network' => [ 'description' => '实例的网络类型,仅支持取值VPC,表示专有网络。', 'type' => 'string', 'example' => 'VPC', ], 'DBVersion' => [ 'description' => '数据库版本。', 'type' => 'string', 'example' => '5.5', ], 'VSwitchId' => [ 'description' => '交换机ID。', 'type' => 'string', 'example' => 'vsw-********', ], 'ZoneId' => [ 'description' => '实例所在可用区。', 'type' => 'string', 'example' => 'cn-hangzhou-a', ], 'Engine' => [ 'description' => '数据库类型,固定取值为MySQL。', 'type' => 'string', 'example' => 'MySQL', ], 'KindCode' => [ 'description' => '实例引擎版本,内部参数。', 'type' => 'integer', 'format' => 'int32', 'example' => '18', ], 'Id' => [ 'description' => '主实例的ID,如果没有返回此参数则表示该实例是主实例。', 'type' => 'string', 'example' => 'pxc-zkralxpc5d****', ], 'DBNodes' => [ 'description' => '数据库节点信息。', 'type' => 'array', 'items' => [ 'description' => '数据库节点信息。', 'type' => 'object', 'properties' => [ 'ComputeNodeId' => [ 'description' => '计算节点名称。', 'type' => 'string', 'example' => 'pxc-i-********', ], 'NodeClass' => [ 'description' => '节点规格。', 'type' => 'string', 'example' => 'polarx.x4.large.2e', ], 'DataNodeId' => [ 'description' => '存储节点名称。', 'type' => 'string', 'example' => 'pxc-xdb-xxxxxx', ], 'ZoneId' => [ 'description' => '节点所在可用区名称。', 'type' => 'string', 'example' => 'cn-hangzhou-a', ], 'Id' => [ 'description' => '逻辑节点ID。', 'type' => 'string', 'example' => 'pxi-*********', ], 'RegionId' => [ 'description' => '节点所在地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou', ], ], ], ], 'ConnAddrs' => [ 'description' => '连接地址信息。', 'type' => 'array', 'items' => [ 'description' => '连接地址信息。', 'type' => 'object', 'properties' => [ 'Type' => [ 'description' => '连接的种类,**VPC**为内网连接,**PUBLIC**为公网连接。', 'type' => 'string', 'example' => 'VPC', ], 'VSwitchId' => [ 'description' => '交换机ID。', 'type' => 'string', 'example' => 'vsw-*********', ], 'Port' => [ 'description' => '连接端口号。', 'type' => 'integer', 'format' => 'int64', 'example' => '3306', ], 'VPCId' => [ 'description' => 'VPC ID。', 'type' => 'string', 'example' => 'vpc-xxxxxx', ], 'ConnectionString' => [ 'description' => '连接地址。', 'type' => 'string', 'example' => 'polardbx-xxx.aliyuncs.com', ], 'VpcInstanceId' => [ 'description' => 'vpc 内部CloudInstanceId,可以忽略', 'type' => 'string', 'example' => 'pxc-zkralxpc5d****', ], ], ], ], 'ReadDBInstances' => [ 'description' => '只读实例名称。', 'type' => 'array', 'items' => [ 'description' => '只读实例名称。', 'type' => 'string', 'example' => 'pxr-*********', ], ], 'ResourceGroupId' => [ 'title' => '资源组ID', 'description' => '资源组ID', 'type' => 'string', 'example' => 'rg-xxxx', ], 'TagSet' => [ 'title' => '标签集合', 'description' => '标签集合', 'type' => 'array', 'items' => [ 'description' => '标签集合。', 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '标签名称', 'description' => '标签名称', 'type' => 'string', 'example' => 'key2', ], 'Value' => [ 'title' => '标签值', 'description' => '标签值', 'type' => 'string', 'example' => 'value2', ], ], ], ], 'CnNodeCount' => [ 'description' => 'CN节点数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '2', ], 'DnNodeCount' => [ 'description' => 'DN节点数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '2', ], 'CnNodeClassCode' => [ 'description' => 'CN节点规格:'."\n" .'- **polarx.x4.medium.2e**:2核8G'."\n" .'- **polarx.x4.large.2e**:4核16G'."\n" .'- **polarx.x8.large.2e**:4核32G'."\n" .'- **polarx.x4.xlarge.2e**:8核32G'."\n" .'- **polarx.x8.xlarge.2e**:8核64G'."\n" .'- **polarx.x4.2xlarge.2e**:16核64G'."\n" .'- **polarx.x8.2xlarge.2e**:16核128G'."\n" .'- **polarx.x4.4xlarge.2e**:32核128G'."\n" .'- **polarx.x8.4xlarge.2e**:32核256G'."\n" .'- **polarx.st.8xlarge.2e**:60核470G'."\n" .'- **polarx.st.12xlarge.2e**:90核720G', 'type' => 'string', 'example' => 'polarx.x4.xlarge.2e', ], 'DnNodeClassCode' => [ 'description' => 'DN节点规格:'."\n" .'- **mysql.n2.medium.25**:2核4G'."\n" .'- **mysql.n4.medium.25**:2核8G'."\n" .'- **mysql.x8.medium.25**:2核16G'."\n" .'- **mysql.n2.large.25**:4核8G'."\n" .'- **mysql.n4.large.25**:4核16G'."\n" .'- **mysql.x8.large.25**:4核32G'."\n" .'- **mysql.n2.xlarge.25**:8核16G'."\n" .'- **mysql.n4.xlarge.25**:8核32G'."\n" .'- **mysql.x8.xlarge.25**:8核64G'."\n" .'- **mysql.n4.2xlarge.25**:16核64G'."\n" .'- **mysql.x8.2xlarge.25**:16核128G'."\n" .'- **mysql.x4.4xlarge.25**:32核128G'."\n" .'- **mysql.x8.4xlarge.25**:32核256G'."\n" .'- **mysql.st.8xlarge.25**:60核470G'."\n" .'- **mysql.st.12xlarge.25**:90核720G', 'type' => 'string', 'example' => 'mysql.x8.large.25', ], 'Series' => [ 'description' => '实例系列,取值如下:'."\n" ."\n" .'- **enterprise**:企业版'."\n" .'- **standard**:标准版', 'type' => 'string', 'example' => 'enterprise', ], 'LTSVersions' => [ 'description' => 'LTS版本号。', 'type' => 'array', 'items' => [ 'description' => 'LTS版本号。', 'type' => 'string', 'example' => 'X.X.X.X', ], 'required' => true, ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"14036EBE-CF2E-44DB-ACE9-AC6157D3A6FC\\",\\n \\"DBInstance\\": {\\n \\"Type\\": \\"ReadWrite\\",\\n \\"Status\\": \\"Running\\",\\n \\"RightsSeparationStatus\\": \\"disabled\\",\\n \\"DBNodeCount\\": 2,\\n \\"Expired\\": \\"false\\",\\n \\"CreateTime\\": \\"2021-08-31T08:56:25.000+0000\\",\\n \\"PayType\\": \\"Postpaid\\",\\n \\"Port\\": \\"3306\\",\\n \\"LockMode\\": \\"Unlock\\",\\n \\"Description\\": \\"test instance\\",\\n \\"ConnectionString\\": \\"pxc-sprpx766vo****.polarx.singapore.rds.aliyuncs.com\\",\\n \\"StorageUsed\\": 17042505728,\\n \\"ExpireDate\\": \\"2022-08-31T16:00:00.000+0000\\",\\n \\"CommodityCode\\": \\"drds_polarxpost_public_cn\\",\\n \\"MaintainStartTime\\": \\"06:00\\",\\n \\"DBInstanceType\\": \\"ReadWrite\\",\\n \\"DBNodeClass\\": \\"polarx.x4.large.2e\\",\\n \\"LatestMinorVersion\\": \\"polarx-kernel_5.4.11-16301083_xcluster-20210805\\",\\n \\"MaintainEndTime\\": \\"06:00\\",\\n \\"DBType\\": \\"polarx\\",\\n \\"RightsSeparationEnabled\\": false,\\n \\"VPCId\\": \\"vpc-xxxxx\\",\\n \\"MinorVersion\\": \\"polarx-kernel_5.4.11-16301083_xcluster-20210805\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"Network\\": \\"VPC\\",\\n \\"DBVersion\\": \\"5.5\\",\\n \\"VSwitchId\\": \\"vsw-********\\",\\n \\"ZoneId\\": \\"cn-hangzhou-a\\",\\n \\"Engine\\": \\"MySQL\\",\\n \\"KindCode\\": 18,\\n \\"Id\\": \\"pxc-zkralxpc5d****\\",\\n \\"DBNodes\\": [\\n {\\n \\"ComputeNodeId\\": \\"pxc-i-********\\",\\n \\"NodeClass\\": \\"polarx.x4.large.2e\\",\\n \\"DataNodeId\\": \\"pxc-xdb-xxxxxx\\",\\n \\"ZoneId\\": \\"cn-hangzhou-a\\",\\n \\"Id\\": \\"pxi-*********\\",\\n \\"RegionId\\": \\"cn-hangzhou\\"\\n }\\n ],\\n \\"ConnAddrs\\": [\\n {\\n \\"Type\\": \\"VPC\\",\\n \\"VSwitchId\\": \\"vsw-*********\\",\\n \\"Port\\": 3306,\\n \\"VPCId\\": \\"vpc-xxxxxx\\",\\n \\"ConnectionString\\": \\"polardbx-xxx.aliyuncs.com\\",\\n \\"VpcInstanceId\\": \\"pxc-zkralxpc5d****\\"\\n }\\n ],\\n \\"ReadDBInstances\\": [\\n \\"pxr-*********\\"\\n ],\\n \\"ResourceGroupId\\": \\"rg-xxxx\\",\\n \\"TagSet\\": [\\n {\\n \\"Key\\": \\"key2\\",\\n \\"Value\\": \\"value2\\"\\n }\\n ],\\n \\"CnNodeCount\\": 2,\\n \\"DnNodeCount\\": 2,\\n \\"CnNodeClassCode\\": \\"polarx.x4.xlarge.2e\\",\\n \\"DnNodeClassCode\\": \\"mysql.x8.large.25\\",\\n \\"Series\\": \\"enterprise\\",\\n \\"LTSVersions\\": [\\n \\"X.X.X.X\\"\\n ]\\n }\\n}","type":"json"}]', 'title' => '通过连接地址获取实例信息', ], 'ModifyDBInstanceConfig' => [ 'summary' => '调用ModifyDBInstanceConfig接口修改实例配置项。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86279', 'abilityTreeNodes' => [ 'FEATUREdrdsTQTDLY', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'ConfigName', 'in' => 'query', 'schema' => [ 'description' => '待修改的配置项,详情请参见[计算层变量](~~316576~~)。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'ENABLE_CONSISTENT_REPLICA_READ', ], ], [ 'name' => 'ConfigValue', 'in' => 'query', 'schema' => [ 'description' => '如果configName = ENABLE_CONSISTENT_REPLICA_READ, 取值”true”或“false”。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'true', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\"\\n}","errorExample":""},{"type":"xml","example":"\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n","errorExample":""}]', 'title' => '修改实例配置项', ], 'ModifyDBInstanceDescription' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'DBInstanceDescription', 'in' => 'query', 'schema' => [ 'description' => '实例备注描述。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '测试实例', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\"\\n}","errorExample":""},{"type":"xml","example":"\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n","errorExample":""}]', 'title' => '修改实例描述', 'summary' => '调用ModifyDBInstanceDescription接口修改实例备注描述。', ], 'ReleaseInstancePublicConnection' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86286', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'CurrentConnectionString', 'in' => 'query', 'schema' => [ 'description' => '实例连接串。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasdyuoo.polarx.rds.aliyuncs.com', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\"\\n}","errorExample":""},{"type":"xml","example":"\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n","errorExample":""}]', 'title' => '释放实例的外网连接地址', 'summary' => '调用ReleaseInstancePublicConnection接口释放实例公网连接。', ], 'RestartDBInstance' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\"\\n}","errorExample":""},{"type":"xml","example":"\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n","errorExample":""}]', 'title' => '重启实例', 'summary' => '调用RestartDBInstance接口重启实例。', ], 'UpgradeDBInstanceKernelVersion' => [ 'methods' => [ 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'SwitchMode', 'in' => 'query', 'schema' => [ 'title' => '切换模式: 0:立刻执行,1:运维时间执行', 'description' => '切换模式。取值:'."\n" ."\n" .'- 0:立即切换。'."\n" .'- 1:在可运维时间段内切换。', 'type' => 'string', 'required' => false, 'example' => '0', ], ], [ 'name' => 'MinorVersion', 'in' => 'query', 'schema' => [ 'description' => '内核版本。', 'type' => 'string', 'required' => false, 'example' => 'polarx-kernel_5.4.12-16349923_xcluster-20210926', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'DBInstanceName' => [ 'description' => '实例名称ID。', 'type' => 'string', 'example' => 'pxc-hzjasd****', ], 'TargetMinorVersion' => [ 'description' => '目标版本号。', 'type' => 'string', 'example' => 'polarx-kernel_5.4.7-16001481_xcluster-20200910', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], 'TaskId' => [ 'description' => '后端任务ID。', 'type' => 'string', 'example' => '422922413', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"DBInstanceName\\": \\"pxc-hzjasd****\\",\\n \\"TargetMinorVersion\\": \\"polarx-kernel_5.4.7-16001481_xcluster-20200910\\",\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\",\\n \\"TaskId\\": \\"422922413\\"\\n}","errorExample":""},{"type":"xml","example":"\\n pxc-hzjasd****\\n polarx-kernel_5.4.7-16001481_xcluster-20200910\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n 422922413\\n","errorExample":""}]', 'title' => '升级数据库实例内核版本', 'summary' => '调用UpgradeDBInstanceKernelVersion接口更新实例内核版本。', ], 'ModifyDBInstanceClass' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', 'abilityTreeCode' => '86278', 'abilityTreeNodes' => [ 'FEATUREdrds0SX279', 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'TargetDBInstanceClass', 'in' => 'query', 'schema' => [ 'description' => '变配目标规格:'."\n" ."\n" .'- **polarx.x4.medium.2e**:2核8G'."\n" .'- **polarx.x4.large.2e**:4核16G'."\n" .'- **polarx.x8.large.2e**:4核32G'."\n" .'- **polarx.x4.xlarge.2e**:8核32G'."\n" .'- **polarx.x8.xlarge.2e**:8核64G'."\n" .'- **polarx.x4.2xlarge.2e**:16核64G'."\n" .'- **polarx.x8.2xlarge.2e**:16核128G'."\n" .'- **polarx.x4.4xlarge.2e**:32核128G'."\n" .'- **polarx.x8.4xlarge.2e**:32核256G'."\n" .'- **polarx.st.8xlarge.2e**:60核470G'."\n" .'- **polarx.st.12xlarge.2e**:90核720G', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'polarx.x4.xlarge.2e', ], ], [ 'name' => 'ClientToken', 'in' => 'query', 'schema' => [ 'description' => '客户端token,保证唯一任意字符串。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], ], [ 'name' => 'CnClass', 'in' => 'query', 'schema' => [ 'description' => '计算节点规格。', 'type' => 'string', 'required' => false, 'example' => '4核32G', ], ], [ 'name' => 'DnClass', 'in' => 'query', 'schema' => [ 'description' => '存储节点规格。', 'type' => 'string', 'required' => false, 'example' => '4核32G', ], ], [ 'name' => 'SpecifiedDNScale', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'type' => 'boolean', 'required' => false, 'default' => 'false', ], ], [ 'name' => 'SpecifiedDNSpecMapJson', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'type' => 'string', 'required' => false, ], ], [ 'name' => 'SwitchTimeMode', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], [ 'name' => 'SwitchTime', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], [ 'name' => 'DnStorageSpace', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'OrderId' => [ 'description' => '交易订单ID,实例升配或降配,变更实例规格,会产生交易订单。', 'type' => 'string', 'example' => '20211103105558', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"OrderId\\": \\"20211103105558\\",\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 20211103105558\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n","errorExample":""}]', 'title' => '修改实例规格', 'summary' => '调用ModifyDBInstanceClass接口修改实例规格。', ], 'DescribeDBInstanceHA' => [ 'summary' => '查询实例的HA信息', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '132465', 'abilityTreeNodes' => [ 'FEATUREdrdsHIZOSR', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => true, 'docRequired' => true, ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => true, 'docRequired' => true, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'type' => 'string', ], 'RequestId' => [ 'type' => 'string', ], 'Success' => [ 'type' => 'boolean', ], 'Data' => [ 'type' => 'object', 'properties' => [ 'TopologyType' => [ 'type' => 'string', ], 'PrimaryRegionId' => [ 'type' => 'string', ], 'PrimaryAzoneId' => [ 'type' => 'string', ], 'SecondaryRegionId' => [ 'type' => 'string', ], 'SecondaryAzoneId' => [ 'type' => 'string', ], ], ], ], ], ], ], 'responseDemo' => '', ], 'UpdatePolarDBXInstanceNode' => [ 'summary' => '调用UpdatePolarDBXInstanceNode接口变更实例节点数,包括扩容和缩容。该请求会产生交易订单。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'paid', 'abilityTreeNodes' => [ 'FEATUREdrdsDBGOD6', 'FEATUREdrds0SX279', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasdyuoo', ], ], [ 'name' => 'DbInstanceNodeCount', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '实例目标节点数,取值范围:0-99。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'maximum' => '99', 'minimum' => '0', 'example' => '3', ], ], [ 'name' => 'ClientToken', 'in' => 'query', 'schema' => [ 'description' => '客户端token,任意随机字符串。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], ], [ 'name' => 'CNNodeCount', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '计算节点个数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '99', 'minimum' => '0', 'example' => '2', ], ], [ 'name' => 'DNNodeCount', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '存储节点个数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '99', 'minimum' => '0', 'example' => '2', ], ], [ 'name' => 'StoragePoolName', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], [ 'name' => 'DeleteDNIds', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], [ 'name' => 'AddDNSpec', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'OrderId' => [ 'description' => '变更实例节点数时产生的订单ID。', 'type' => 'string', 'example' => '20211103105558', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"OrderId\\": \\"20211103105558\\",\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 20211103105558\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n","errorExample":""}]', 'title' => '更新节点', ], 'ChangeResourceGroup' => [ 'summary' => '修改实例资源组。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '116109', 'abilityTreeNodes' => [ 'FEATUREdrdsJGJ3OD', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'title' => '地域', 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'ResourceType', 'in' => 'query', 'schema' => [ 'title' => '资源类型', 'description' => '资源类型,目前仅支持PolarDB-X 2.0实例一种类型的资源。', 'type' => 'string', 'required' => true, 'example' => 'polardbxinstance', ], ], [ 'name' => 'ResourceId', 'in' => 'query', 'schema' => [ 'title' => '资源ID', 'description' => '资源ID。', 'type' => 'string', 'required' => true, 'example' => 'pxc-szrwrbp693****', 'maxItems' => 51, ], ], [ 'name' => 'NewResourceGroupId', 'in' => 'query', 'schema' => [ 'title' => '新资源组ID', 'description' => '新资源组ID。', 'type' => 'string', 'required' => true, 'example' => 'rg-acfmwolx3j4****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3WE34', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3WE34\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 473469C7-AA6F-4DC5-B3DB-A3DC0DE3WE34\\n","errorExample":""}]', 'title' => '修改实例资源组', 'description' => '注意: '."\n" .'- **endpoint**和其他接口有区别,国内和新加坡需使用**polardbx.aliyuncs.com**, 其他地域使用**polardbx.{region id}.aliyunc.com**。'."\n" .'- 调试此API接口的时候,如果报服务不可用的错,请确认下**endpoint**是否正确,可通过切换**服务地址**到**迪拜**或者**印度**,将**endpoint**切换到**polardbx.aliyuncs.com**。', ], 'DescribeTransformStatus' => [ 'summary' => '该接口主要用于查询标准版实例向企业版实例升级(或转换)任务的当前状态。', 'methods' => [ 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '196927', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => false, 'example' => 'pxc-xxx', ], ], [ 'name' => 'QueryReport', 'in' => 'query', 'schema' => [ 'description' => '校验报告。', 'type' => 'boolean', 'required' => false, 'example' => 'true', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '173CA69A-3513-591D-8A09-C1EA37CBE2D9', ], 'Data' => [ 'description' => '监控数据。', 'type' => 'object', 'properties' => [ 'EnterpriseInsName' => [ 'description' => '企业版企业名称。', 'type' => 'string', 'example' => 'pxc-*****', ], 'StandardInsName' => [ 'description' => '标准版实例名称。', 'type' => 'string', 'example' => 'pxc-*****', ], 'Phase' => [ 'description' => '当前迁移/升级阶段。', 'type' => 'string', 'example' => 'none', ], 'CanSwitch' => [ 'description' => '是否可以进行迁移切换,返回值为:'."\n" .'- **true**:是。'."\n" .'- **false**:否。'."\n" ."\n" .'> 此参数供云原生数据库PolarDB产品的一键升级功能使用。', 'type' => 'boolean', ], 'CanUndoSwitch' => [ 'description' => '是否可以撤销切换操作。', 'type' => 'boolean', ], 'CanCancel' => [ 'description' => '是否可取消', 'type' => 'boolean', 'example' => 'true', ], 'CanFinish' => [ 'description' => '当前任务是否已完成。', 'type' => 'boolean', 'example' => 'true', ], 'ReportTime' => [ 'description' => '数据报表生成日期。', 'type' => 'integer', 'format' => 'int64', 'example' => '2025-09-02 16:52:47.0'."\n", ], 'ReportSummary' => [ 'description' => '报表摘要信息。', 'type' => 'object', ], ], ], ], ], ], ], 'errorCodes' => [ 400 => [ [ 'errorCode' => 'IncorrectDBInstance', 'errorMessage' => 'Current DB instance does not support this operation.', ], [ 'errorCode' => 'IncorrectDBInstanceState', 'errorMessage' => 'Current DB instance state does not support this operation.', ], [ 'errorCode' => 'InvalidParam', 'errorMessage' => 'Invalid Parameter.', ], [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist or is not supported.', ], [ 'errorCode' => 'Transform.UnSupportedDbVersion', 'errorMessage' => 'Only database engine version 5.7 is supported.', ], ], 403 => [ [ 'errorCode' => 'Transform.IncorrectEngineVersion', 'errorMessage' => 'The current engine version is not the latest. Please upgrade to the latest version.', ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"173CA69A-3513-591D-8A09-C1EA37CBE2D9\\",\\n \\"Data\\": {\\n \\"EnterpriseInsName\\": \\"pxc-*****\\",\\n \\"StandardInsName\\": \\"pxc-*****\\",\\n \\"Phase\\": \\"none\\",\\n \\"CanSwitch\\": true,\\n \\"CanUndoSwitch\\": true,\\n \\"CanCancel\\": true,\\n \\"CanFinish\\": true,\\n \\"ReportTime\\": 0,\\n \\"ReportSummary\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n }\\n}","type":"json"}]', 'title' => '查询实例升级状态', ], 'DescribePolarxDataNodes' => [ 'summary' => '该接口用于查询PolarDB-X实例中所有数据节点(Data Nodes)的详细信息,包括节点状态、存储使用情况、网络地址等,便于运维管理和监控。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '86255', 'abilityTreeNodes' => [ 'FEATUREdrds0SX279', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-shanghai', ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'description' => '页码。取值为大于0且不超过integer数据类型的最大值,默认值为**1**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'example' => '1', 'pattern' => '^\\d+$', 'default' => '1', ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '5', 'example' => '30', 'pattern' => '^\\d+$', 'default' => '30', 'enum' => [ '30', '50', '100', ], ], ], [ 'name' => 'NodeType', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'title' => '查询节点类型'."\n" .'- all: 表示同时查询 dn 与 gms 节点'."\n" .'- gms: 表示只查询 gms 节点'."\n" .'- dn: 表示只查询 dn 节点', 'description' => '查询节点类型'."\n" .'- all: 表示同时查询 dn 与 gms 节点'."\n" .'- gms: 表示只查询 gms 节点'."\n" .'- dn: 表示只查询 dn 节点', 'type' => 'string', 'required' => false, 'example' => 'dn', 'default' => 'all', 'enum' => [ 'all', 'dn', 'gms', ], ], ], [ 'name' => 'SearchKey', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'title' => '关键词', 'description' => '关键词', 'type' => 'string', 'required' => false, 'example' => 'pc-bp1c5w4fx****2274', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => 'BD99340C-4A45-548B-****-27584B0BCFFF', ], 'PageNumber' => [ 'description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1', ], 'PageSize' => [ 'description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '0', ], 'TotalNumber' => [ 'description' => '总节点数。', 'type' => 'integer', 'format' => 'int32', 'example' => '0', ], 'DBInstanceDataNodes' => [ 'description' => '节点信息列表。', 'type' => 'array', 'items' => [ 'description' => '节点信息列表。', 'type' => 'object', 'properties' => [ 'DBInstanceName' => [ 'description' => '实例id。', 'type' => 'string', 'example' => 'pxc-hzrp5m****04w4', ], 'DBInstanceId' => [ 'description' => '实例id。', 'type' => 'string', 'example' => 'pxc-hzrlcjc****sz9', ], 'DBInstanceDescription' => [ 'description' => '节点实例描述。', 'type' => 'string', 'example' => 'pxc-z****nfxsxy728 : PROD-OMS-Auto-生产库克隆实例', ], ], ], ], ], ], ], ], 'errorCodes' => [ 400 => [ [ 'errorCode' => 'InvalidPageSize.Malformed', 'errorMessage' => 'The specified parameter PageSize is not valid.', ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"BD99340C-4A45-548B-****-27584B0BCFFF\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 0,\\n \\"TotalNumber\\": 0,\\n \\"DBInstanceDataNodes\\": [\\n {\\n \\"DBInstanceName\\": \\"pxc-hzrp5m****04w4\\",\\n \\"DBInstanceId\\": \\"pxc-hzrlcjc****sz9\\",\\n \\"DBInstanceDescription\\": \\"pxc-z****nfxsxy728 : PROD-OMS-Auto-生产库克隆实例\\"\\n }\\n ]\\n}","type":"json"}]', 'title' => '查看数据节点信息', ], 'ModifyDBInstanceMaintainTime' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-htri0ori2r4k9p', ], ], [ 'name' => 'MaintainTime', 'in' => 'query', 'schema' => [ 'description' => '可运维时间,采用UTC时间,取值范围为00.00Z-23:59Z。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '21:00Z-00:00Z', ], ], [ 'name' => 'ClientToken', 'in' => 'query', 'schema' => [ 'description' => '唯一token。', 'type' => 'string', 'required' => false, 'example' => '73559800-3c8c-11ec-bd40-99cfcff3fe1e', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '唯一请求ID。', 'type' => 'string', 'example' => '73559800-3c8c-11ec-bd40-99cfcff3fe1e', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"73559800-3c8c-11ec-bd40-99cfcff3fe1e\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 73559800-3c8c-11ec-bd40-99cfcff3fe1e\\n","errorExample":""}]', 'title' => '修改实例可维护时间', 'summary' => '修改实例可维护时间。', 'description' => '****', ], 'ModifyDBInstanceVip' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '232184', 'abilityTreeNodes' => [ 'FEATUREdrds7CT80F', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。'."\n" ."\n", 'type' => 'string', 'required' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'VpcId', 'in' => 'query', 'schema' => [ 'description' => '访问端点所在的专有网络ID。', 'type' => 'string', 'required' => true, 'example' => 'vpc-********', ], ], [ 'name' => 'VSwitchId', 'in' => 'query', 'schema' => [ 'description' => '虚拟交换机ID。', 'type' => 'string', 'required' => true, 'example' => 'vsw-*********', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'MigrateDBInstanceResponse', 'description' => 'MigrateDBInstanceResponse', 'type' => 'object', 'properties' => [ 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Message' => [ 'description' => '请求返回消息。'."\n" .'> 请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => '*****', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Success\\": true,\\n \\"Message\\": \\"*****\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\"\\n}","type":"json"}]', 'title' => '修改实例虚拟IP', 'summary' => '该接口用于修改数据库实例绑定的虚拟IP(Virtual IP)地址或其网络属性,支持更换内网IP、调整子网、迁移可用区等操作', 'description' => '****', ], 'DescribeRdsVpcs' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '97702', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'example' => 'cn-zhangjiakou', ], ], [ 'name' => 'ZoneId', 'in' => 'query', 'schema' => [ 'description' => '可用区id。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing-h', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Vpcs' => [ 'description' => 'vpc信息。', 'type' => 'object', 'properties' => [ 'Vpc' => [ 'description' => 'vpc信息。', 'type' => 'array', 'items' => [ 'description' => 'vpc信息。', 'type' => 'object', 'properties' => [ 'Status' => [ 'description' => 'vpc状态', 'type' => 'string', 'example' => 'True', ], 'VpcName' => [ 'description' => 'vpc的名称。', 'type' => 'string', 'example' => 'cloud_auto_test', ], 'VpcId' => [ 'description' => 'vpc的id。', 'type' => 'string', 'example' => 'vpc-2zekldxxy28nobay7o1f3', ], 'IsDefault' => [ 'description' => '是否是默认vpc。取值范围如下:***true**:是默认vpc***false**:非默认vpc', 'type' => 'boolean', 'example' => 'False', ], 'CidrBlock' => [ 'description' => 'vpc的ipv4网段。', 'type' => 'string', 'example' => '47.121.246.0/24', ], 'RegionNo' => [ 'description' => 'vpc所在的地域。', 'type' => 'string', 'example' => 'cn-shanghai', ], 'GmtCreate' => [ 'description' => '创建vpc的时间点。', 'type' => 'string', 'example' => 'Mon May 12 10:13:14 CST 2025', ], 'AliUid' => [ 'description' => '阿里云账号id。', 'type' => 'string', 'example' => '314****36', ], 'VSwitchs' => [ 'description' => 'vpc的交换机信息。', 'type' => 'array', 'items' => [ 'description' => 'vpc的交换机信息。', 'type' => 'object', 'properties' => [ 'Status' => [ 'description' => '交换机状态', 'type' => 'string', 'example' => 'Available', ], 'VSwitchId' => [ 'description' => '交换机id。', 'type' => 'string', 'example' => 'vsw-8vbkwmpn****4nrd639ih', ], 'IsDefault' => [ 'description' => '是否是默认交换机。', 'type' => 'boolean', 'example' => 'false', ], 'CidrBlock' => [ 'description' => '交换机网段。', 'type' => 'string', 'example' => '10.0.0.0/24', ], 'GmtCreate' => [ 'description' => '创建时间,精确到毫秒的unix时间戳。', 'type' => 'string', 'example' => '1574156944000', ], 'GmtModified' => [ 'description' => '最后修改时间(时间戳)', 'type' => 'string', 'example' => '2025-09-03T19:19:13+08:00', ], 'IzNo' => [ 'description' => '可用区id。', 'type' => 'string', 'example' => 'cn-beijing-g', ], 'VSwitchName' => [ 'description' => '交换机名称。', 'type' => 'string', 'example' => 'cloud_auto_g', ], ], ], ], 'GmtModified' => [ 'description' => '最后修改vpc的时间。', 'type' => 'string', 'example' => '2024-09-29 17:47:56', ], 'Bid' => [ 'description' => '专有网络id。', 'type' => 'string', 'example' => '26842', ], ], ], ], ], ], 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '4C1A7CFB-9F73-5041-8C74-27626E58985A', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Vpcs\\": {\\n \\"Vpc\\": [\\n {\\n \\"Status\\": \\"True\\",\\n \\"VpcName\\": \\"cloud_auto_test\\",\\n \\"VpcId\\": \\"vpc-2zekldxxy28nobay7o1f3\\",\\n \\"IsDefault\\": true,\\n \\"CidrBlock\\": \\"47.121.246.0/24\\",\\n \\"RegionNo\\": \\"cn-shanghai\\",\\n \\"GmtCreate\\": \\"Mon May 12 10:13:14 CST 2025\\",\\n \\"AliUid\\": \\"314****36\\",\\n \\"VSwitchs\\": [\\n {\\n \\"Status\\": \\"Available\\",\\n \\"VSwitchId\\": \\"vsw-8vbkwmpn****4nrd639ih\\",\\n \\"IsDefault\\": false,\\n \\"CidrBlock\\": \\"10.0.0.0/24\\",\\n \\"GmtCreate\\": \\"1574156944000\\",\\n \\"GmtModified\\": \\"2025-09-03T19:19:13+08:00\\",\\n \\"IzNo\\": \\"cn-beijing-g\\",\\n \\"VSwitchName\\": \\"cloud_auto_g\\"\\n }\\n ],\\n \\"GmtModified\\": \\"2024-09-29 17:47:56\\",\\n \\"Bid\\": \\"26842\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"4C1A7CFB-9F73-5041-8C74-27626E58985A\\"\\n}","type":"json"}]', 'title' => '查询VPC列表', 'summary' => 'PolarDB-X 侧查询VPC列表的API。', 'description' => '该接口用于获取用户账号下可用于实例专有网络(VPC)列表,以便在创建或管理数据库实例时选择合适的网络环境。', ], 'DescribeRdsVswitches' => [ 'summary' => '该接口用于查询RDS实例可用的专有网络(VPC)交换机(vSwitch)列表。', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '232624', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'ZoneId', 'in' => 'query', 'schema' => [ 'description' => '可用区id。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou-a', ], ], [ 'name' => 'VpcId', 'in' => 'query', 'schema' => [ 'description' => '访问端点所在的专有网络ID。', 'type' => 'string', 'required' => false, 'example' => 'vpc-bp1ndou****twoedlmru0', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'VswitchList' => [ 'description' => 'Vswitch列表', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Id' => [ 'description' => '节点ID。', 'type' => 'integer', 'format' => 'int64', 'example' => 'babac91eff704edf9bdccfaa6ba4efce', ], 'VpcInstanceId' => [ 'description' => 'vpc id。', 'type' => 'string', 'example' => 'vpc-uf6lis7xmm****t9wrxb5', ], 'IzNo' => [ 'description' => '可用区id。', 'type' => 'string', 'example' => 'cn-hangzhou-j', ], 'CidrBlock' => [ 'description' => 'vpc的ip地址段。', 'type' => 'string', 'example' => '172.16.0.0/24', ], 'Description' => [ 'description' => '数据库描述。', 'type' => 'string', 'example' => 'describe', ], 'Name' => [ 'description' => '名称。', 'type' => 'string', 'example' => 'szt-backup', ], 'AvailabeIpCount' => [ 'description' => '可用ip数量。', 'type' => 'string', 'example' => '16378', ], 'IsDefault' => [ 'description' => '是否是默认vpc。取值范围如下:***true**:是默认vpc***false**:非默认vpc', 'type' => 'string', 'example' => 'true', ], 'InstanceId' => [ 'description' => '实例ID。', 'type' => 'string', 'example' => 'drdshbgae0han226', ], ], ], ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Data\\": {\\n \\"VswitchList\\": [\\n {\\n \\"Id\\": 0,\\n \\"VpcInstanceId\\": \\"vpc-uf6lis7xmm****t9wrxb5\\",\\n \\"IzNo\\": \\"cn-hangzhou-j\\",\\n \\"CidrBlock\\": \\"172.16.0.0/24\\",\\n \\"Description\\": \\"describe\\",\\n \\"Name\\": \\"szt-backup\\",\\n \\"AvailabeIpCount\\": \\"16378\\",\\n \\"IsDefault\\": \\"true\\",\\n \\"InstanceId\\": \\"drdshbgae0han226\\"\\n }\\n ]\\n }\\n}","type":"json"}]', 'title' => '查询Vswitch列表', 'description' => '该接口用于获取用户账号下可用于实例专有网络(VPC)列表,以便在创建或管理数据库实例时选择合适的网络环境。', ], 'DescribeShowStorageInfo' => [ 'summary' => '查询实例的存储空间使用详情,包括总容量、已用空间、剩余空间等信息。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'abilityTreeCode' => '207374', 'abilityTreeNodes' => [ 'FEATUREdrdsHFP8VD', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-**************', ], ], [ 'name' => 'ResourceGroupId', 'in' => 'query', 'schema' => [ 'title' => '资源组ID', 'description' => '资源组ID', 'type' => 'string', 'required' => false, 'example' => 'rg-xxxxx', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Data' => [ 'description' => '数据。', 'type' => 'object', 'properties' => [ 'StorageInfos' => [ 'description' => '存储信息列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Class' => [ 'description' => '实例的规格类型(即规格代码)。', 'type' => 'string', 'example' => 'polar.mysql.x4.large', ], 'DbCount' => [ 'description' => '数据库数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '3', ], 'Deletable' => [ 'description' => '是否可删除', 'type' => 'boolean', 'example' => 'True', ], 'GroupCount' => [ 'description' => '节点组的数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '12', ], 'InstKind' => [ 'description' => '实例的角色类型,常见值包括:'."\n" .'MASTER:主实例'."\n" .'READONLY:只读实例'."\n" .'STANDBY:备实例(高可用场景)', 'type' => 'string', 'example' => 'MASTER', ], 'IsHealthy' => [ 'description' => '实例或集群当前是否处于健康状态。', 'type' => 'boolean', 'example' => 'true', ], 'LeaderNode' => [ 'description' => '主节点(Leader)的标识。', 'type' => 'string', 'example' => '11.117.237.205:3029', ], 'Status' => [ 'description' => '实例状态。', 'type' => 'integer', 'format' => 'int64', 'example' => '0', ], 'StorageInstName' => [ 'description' => '实例名称。', 'type' => 'string', 'example' => 'pxc-xdb-m-pxcbjrylg49skcxb17394', ], ], ], ], ], ], 'Code' => [ 'description' => '请求返回码。>请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => '200', ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Data\\": {\\n \\"StorageInfos\\": [\\n {\\n \\"Class\\": \\"polar.mysql.x4.large\\",\\n \\"DbCount\\": 3,\\n \\"Deletable\\": true,\\n \\"GroupCount\\": 12,\\n \\"InstKind\\": \\"MASTER\\",\\n \\"IsHealthy\\": true,\\n \\"LeaderNode\\": \\"11.117.237.205:3029\\",\\n \\"Status\\": 0,\\n \\"StorageInstName\\": \\"pxc-xdb-m-pxcbjrylg49skcxb17394\\"\\n }\\n ]\\n },\\n \\"Code\\": \\"200\\"\\n}","type":"json"}]', 'title' => '查询存储空间信息', ], 'DescribeStoragePoolInfo' => [ 'summary' => '该接口用于查询存储池的详细信息,包括容量、使用情况、状态等。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属的地域ID。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-*********', ], ], [ 'name' => 'ResourceGroupId', 'in' => 'query', 'schema' => [ 'title' => '资源组ID', 'description' => '资源组ID', 'type' => 'string', 'required' => false, 'example' => 'rg-xxxxx', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Data' => [ 'description' => '实例详情列表。', 'type' => 'object', 'properties' => [ 'StoragePools' => [ 'description' => '存储池。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Class' => [ 'description' => '实例的规格类型(即规格代码)。', 'type' => 'string', 'example' => 'polar.mysql.x4.large', ], 'DnIdList' => [ 'description' => 'DN列表。', 'type' => 'array', 'items' => [ 'description' => 'DN列表。', 'type' => 'string', 'example' => '[]', ], 'example' => '[pxc-xdb-s-pxcbj****xxnwp0wac2c4\\",\\"pxc-xdb-s-pxcbjr3b8****p0wa1589\\"]', ], 'DnIdString' => [ 'description' => 'DN id', 'type' => 'string', 'example' => 'pxc-xdb-s-pxcshr****rh7fn2654fc', ], 'Extra' => [ 'description' => '保留字段。', 'type' => 'string', 'example' => '{\\"appId\\":\\"APP_ETLUP1E5FMI5ND5IFO8W\\"}', ], 'GmtCreated' => [ 'description' => '账号创建时间。', 'type' => 'string', 'example' => '2025-08-27 23:19:52.0', ], 'GmtModified' => [ 'description' => '修改时间,时间戳格式。', 'type' => 'string', 'example' => '2025-09-02 16:52:47.0', ], 'IdleDNIdList' => [ 'description' => '空闲DN列表。', 'type' => 'array', 'items' => [ 'description' => '空闲DN列表。', 'type' => 'string', 'example' => '[]', ], 'example' => 'none', ], 'Name' => [ 'description' => '名称。', 'type' => 'string', 'example' => 'test-cacheapi', ], 'UnDeletableDNId' => [ 'description' => '禁止删除的DN。', 'type' => 'string', 'example' => 'pxc-xdb-s-hzr*****6j4se284344', ], ], ], ], ], ], 'RequestId' => [ 'description' => 'Id of the request', 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Code' => [ 'description' => '接口返回Code', 'type' => 'string', 'example' => '200', ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Data\\": {\\n \\"StoragePools\\": [\\n {\\n \\"Class\\": \\"polar.mysql.x4.large\\",\\n \\"DnIdList\\": [\\n \\"[]\\"\\n ],\\n \\"DnIdString\\": \\"pxc-xdb-s-pxcshr****rh7fn2654fc\\",\\n \\"Extra\\": \\"{\\\\\\\\\\\\\\"appId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"APP_ETLUP1E5FMI5ND5IFO8W\\\\\\\\\\\\\\"}\\",\\n \\"GmtCreated\\": \\"2025-08-27 23:19:52.0\\",\\n \\"GmtModified\\": \\"2025-09-02 16:52:47.0\\",\\n \\"IdleDNIdList\\": [\\n \\"[]\\"\\n ],\\n \\"Name\\": \\"test-cacheapi\\",\\n \\"UnDeletableDNId\\": \\"pxc-xdb-s-hzr*****6j4se284344\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Code\\": \\"200\\"\\n}","type":"json"}]', 'title' => '查询存储池信息', ], 'CreateStoragePool' => [ 'summary' => '创建资源存储池', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '201295', 'abilityTreeNodes' => [ 'FEATUREdrdsUWIQBY', 'FEATUREdrdsVN1FAR', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-bjxxxxxxxx', ], ], [ 'name' => 'ResourceGroupId', 'in' => 'query', 'schema' => [ 'title' => '资源组ID', 'description' => '资源组ID', 'type' => 'string', 'required' => false, 'example' => 'rg-xxxxx', ], ], [ 'name' => 'StoragePoolName', 'in' => 'query', 'allowEmptyValue' => false, 'schema' => [ 'description' => '存储池名称', 'type' => 'string', 'required' => false, 'example' => 'test', ], ], [ 'name' => 'StoragePoolDNList', 'in' => 'query', 'schema' => [ 'description' => '存储池DN列表', 'type' => 'string', 'required' => false, 'example' => 'node6'."\n", ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', ], 'Code' => [ 'description' => '接口返回Code', 'type' => 'string', 'example' => '200', ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Code\\": \\"200\\"\\n}","type":"json"}]', 'title' => '创建存储池', ], 'CreateCustomEndpoint' => [ 'summary' => '该接口,用于为数据库实例创建自定义的连接地址(Endpoint)。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '236560', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例Id', 'type' => 'string', 'required' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'Name', 'in' => 'query', 'schema' => [ 'description' => '访问控制实例名称。名称长度为2~128个字符,以大小写字母或中文开头,可包含数字、下划线(_)和短划线(-)。', 'type' => 'string', 'required' => true, 'example' => 'ext-win-live-17', ], ], [ 'name' => 'VpcId', 'in' => 'query', 'schema' => [ 'description' => '访问端点所在的专有网络ID。', 'type' => 'string', 'required' => true, 'example' => 'vpc-bp1ndoug37dtwoedlmru0', ], ], [ 'name' => 'VSwitchId', 'in' => 'query', 'schema' => [ 'description' => '虚拟交换机ID。', 'type' => 'string', 'required' => true, 'example' => 'vsw-*********', ], ], [ 'name' => 'NodeIds', 'in' => 'query', 'schema' => [ 'description' => 'RemindUnit(对象类型)为NODE(任务节点)时,监控的任务节点ID。多个ID之间使用英文逗号(,)分隔,一个规则最多监控50个节点。', 'type' => 'string', 'required' => true, 'example' => 'r-bp1l5kfgw8****c3iv', ], ], [ 'name' => 'NodeAutoEnter', 'in' => 'query', 'schema' => [ 'description' => '节点在被添加或恢复后,是否自动加入集群并开始提供服务', 'type' => 'boolean', 'required' => true, 'example' => 'true', ], ], [ 'name' => 'NodeRole', 'in' => 'query', 'schema' => [ 'description' => '若希望查询云原生版读写分离架构实例中只读节点的指标,您在传入具体**NodeId**的同时,还需要在本参数传入**READONLY**。'."\n" .'> 其余情况请无需传入(或传入**MASTER**)。', 'type' => 'string', 'required' => false, 'example' => 'READONLY', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '2DFF784E-DC31-5BBC-9B25-9261CD9E0AA9', ], 'Data' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ 'CustomEndpointId' => [ 'description' => '终端ID', 'type' => 'string', 'example' => 'pxe-c4gkgqg****7sgyg', ], 'DBInstanceName' => [ 'description' => '实例Id', 'type' => 'string', 'example' => 'pxc-*********', ], ], ], ], ], ], ], 'errorCodes' => [ 400 => [ [ 'errorCode' => 'CustomEndpoint.ExceedLimit', 'errorMessage' => 'the count of custom endpoints can not exceed limiting value.', ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"2DFF784E-DC31-5BBC-9B25-9261CD9E0AA9\\",\\n \\"Data\\": {\\n \\"CustomEndpointId\\": \\"pxe-c4gkgqg****7sgyg\\",\\n \\"DBInstanceName\\": \\"pxc-*********\\"\\n }\\n}","type":"json"}]', 'title' => '创建自定义终端', 'description' => '更多关于实例账号的信息,请参见[账号管理](https://help.aliyun.com/document_detail/172163.html)。', ], 'DescribeCustomEndpointList' => [ 'summary' => '查询自用户定义域名列表', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '236590', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'title' => '实例名称', 'description' => '实例名称', 'type' => 'string', 'required' => true, 'example' => 'pxc-xxx', ], ], [ 'name' => 'CustomEndpointIds', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'title' => '自定义连接ID,多个ID使用英文逗号分隔', 'description' => '自定义域名ID', 'type' => 'string', 'required' => false, 'example' => 'pxe-b6e****no4pfap1s', ], ], [ 'name' => 'CheckDeleteCN', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'title' => '', 'description' => '查询CN是否被删除', 'type' => 'boolean', 'required' => false, 'example' => 'true', 'default' => 'false', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '6352AC16-76BF-5135-B1EA-ED49293526E6', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'CanDeleteCount' => [ 'description' => '是否是可删除节点。', 'type' => 'integer', 'format' => 'int32', 'example' => '0', ], 'Endpoints' => [ 'description' => 'Endpoint详细信息。', 'type' => 'array', 'items' => [ 'description' => 'Endpoint详细信息。', 'type' => 'object', 'properties' => [ 'CustomEndpointId' => [ 'description' => '用户端域名id。', 'type' => 'string', 'example' => 'pxe-b6e****o4pfap1s', ], 'Name' => [ 'description' => '名称。', 'type' => 'string', 'example' => 'Name', ], 'DBInstanceName' => [ 'description' => '实例ID。'."\n" ."\n", 'type' => 'string', 'example' => 'pxc-hz****zoxherr7', ], 'ConnectionString' => [ 'description' => '实例连接地址', 'type' => 'string', 'example' => 'pxc-shra****zq0j01.polarx.rds.aliyuncs.com', ], 'Port' => [ 'description' => '实例连接端口', 'type' => 'integer', 'format' => 'int32', 'example' => '3306', ], 'VpcId' => [ 'description' => '访问端点所在的专有网络ID。', 'type' => 'string', 'example' => 'vpc-uf61h****dj1zg5fqp5x7', ], 'VSwitchId' => [ 'description' => '虚拟交换机ID。', 'type' => 'string', 'example' => 'vsw-8vbkw****5yh4nrd639ih', ], 'NodeAutoEnter' => [ 'description' => '节点在被添加或恢复后,是否自动加入集群并开始提供服务', 'type' => 'string', 'example' => 'true', ], 'NodeRole' => [ 'description' => '若希望查询云原生版读写分离架构实例中只读节点的指标,您在传入具体**NodeId**的同时,还需要在本参数传入**READONLY**。'."\n" .'> 其余情况请无需传入(或传入**MASTER**)。', 'type' => 'string', 'example' => 'same_azone_as_last', ], 'CnNames' => [ 'description' => '[\\"pxc-i-vb1sqa7llp\\",\\"pxc-i-bemprx50ad\\"]', 'type' => 'array', 'items' => [ 'description' => 'string', 'type' => 'string', 'example' => 'string', ], ], 'Status' => [ 'description' => '状态', 'type' => 'string', 'example' => 'created', ], ], ], ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"6352AC16-76BF-5135-B1EA-ED49293526E6\\",\\n \\"Data\\": {\\n \\"CanDeleteCount\\": 0,\\n \\"Endpoints\\": [\\n {\\n \\"CustomEndpointId\\": \\"pxe-b6e****o4pfap1s\\",\\n \\"Name\\": \\"Name\\",\\n \\"DBInstanceName\\": \\"pxc-hz****zoxherr7\\",\\n \\"ConnectionString\\": \\"pxc-shra****zq0j01.polarx.rds.aliyuncs.com\\",\\n \\"Port\\": 3306,\\n \\"VpcId\\": \\"vpc-uf61h****dj1zg5fqp5x7\\",\\n \\"VSwitchId\\": \\"vsw-8vbkw****5yh4nrd639ih\\",\\n \\"NodeAutoEnter\\": \\"true\\",\\n \\"NodeRole\\": \\"same_azone_as_last\\",\\n \\"CnNames\\": [\\n \\"string\\"\\n ],\\n \\"Status\\": \\"created\\"\\n }\\n ]\\n }\\n}","type":"json"}]', 'title' => '查询自用户定义域名列表', 'description' => '该接口用于获取用户已配置的自定义终端节点(Endpoint)列表,便于管理和查看私有连接或VPC终端服务的设置。', ], 'ModifyCustomEndpointNet' => [ 'summary' => '该接口用于修改自定义网络端点的子网、安全组及公网访问等网络配置。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', 'riskType' => 'high', 'chargeType' => 'free', 'abilityTreeCode' => '236587', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'CustomEndpointId', 'in' => 'query', 'schema' => [ 'description' => '用户端域名id', 'type' => 'string', 'required' => true, 'example' => 'cep-002', ], ], [ 'name' => 'ConnPrefix', 'in' => 'query', 'schema' => [ 'description' => '链接前缀。', 'type' => 'string', 'required' => false, 'example' => 'pxc-****', ], ], [ 'name' => 'Port', 'in' => 'query', 'schema' => [ 'description' => '公网地址端口。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '3306', ], ], [ 'name' => 'VpcId', 'in' => 'query', 'schema' => [ 'description' => '访问端点所在的专有网络ID。', 'type' => 'string', 'required' => false, 'example' => 'vpc-bp1ndoug37dtwoedlmru0', ], ], [ 'name' => 'VSwitchId', 'in' => 'query', 'schema' => [ 'description' => '虚拟交换机ID。', 'type' => 'string', 'required' => false, 'example' => 'vsw-*********', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\"\\n}","type":"json"}]', 'title' => '修改自定义网络端点', 'description' => '删除指定数据库实例的自定义连接地址,关闭该域名的访问入口。', ], 'DeleteCustomEndpoint' => [ 'summary' => '删除用户端域名', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'delete', 'riskType' => 'high', 'chargeType' => 'free', 'abilityTreeCode' => '236568', 'abilityTreeNodes' => [ 'FEATUREdrds0SX279', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名。', 'type' => 'string', 'required' => false, 'example' => 'pxc-hzravgpt8q****', ], ], [ 'name' => 'CustomEndpointId', 'in' => 'query', 'schema' => [ 'description' => '用户端域名id', 'type' => 'string', 'required' => false, 'example' => 'pxe-8if3zrfsu****hgw', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '9B2F3840-****-475C-B269-2D5C3A31797C', ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9B2F3840-****-475C-B269-2D5C3A31797C\\"\\n}","type":"json"}]', 'title' => '删除用户端域名', 'description' => '删除指定数据库实例的自定义连接地址,关闭该域名的访问入口。', ], 'ModifyCustomEndpoint' => [ 'summary' => '该接口用于修改自定义集群地址(Custom Endpoint)的配置。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', 'riskType' => 'high', 'chargeType' => 'free', 'abilityTreeCode' => '236585', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-zhangjiakou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例Id', 'type' => 'string', 'required' => true, 'example' => 'mydatabase', ], ], [ 'name' => 'CustomEndpointId', 'in' => 'query', 'schema' => [ 'description' => '用户端域名id', 'type' => 'string', 'required' => true, 'example' => 'cep-002', ], ], [ 'name' => 'Name', 'in' => 'query', 'schema' => [ 'description' => '名称。', 'type' => 'string', 'required' => false, 'example' => 'secondary-endpoint', ], ], [ 'name' => 'NodeIds', 'in' => 'query', 'schema' => [ 'description' => 'node ids', 'type' => 'string', 'required' => false, 'example' => 'node3', ], ], [ 'name' => 'NodeAutoEnter', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '节点在被添加或恢复后,是否自动加入集群并开始提供服务', 'type' => 'boolean', 'required' => false, 'example' => 'true', 'default' => 'false', ], ], [ 'name' => 'NodeRole', 'in' => 'query', 'schema' => [ 'description' => '节点作用。', 'type' => 'string', 'required' => false, 'example' => 'master', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1A586DCB-39A6-4050-81CC-C7BD4CCDB49F', ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1A586DCB-39A6-4050-81CC-C7BD4CCDB49F\\"\\n}","type":"json"}]', 'title' => '修改自定义端地址', 'description' => '在 PolarDB-X 中,除了默认的主地址(Primary Endpoint)和只读地址(Read-only Endpoint)外,用户还可以创建自定义地址(Custom Endpoint),用于实现更灵活的读写分离、负载均衡或业务隔离策略。ModifyCustomEndpoint 接口允许你动态调整这些自定义地址的属性,而无需重启实例。', ], 'ModifyDBInstanceConnectionString' => [ 'summary' => '修改实例地址链接串。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '115860', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域Id', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例Id', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-unrf5ssig0ecg8', ], ], [ 'name' => 'NewPrefix', 'in' => 'query', 'schema' => [ 'description' => '新的地址前缀', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'test2', ], ], [ 'name' => 'ConnectionString', 'in' => 'query', 'schema' => [ 'description' => '地址原链接信息', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-unrf5ssig0ecg8.polarx.huhehaote.rds.aliyuncs.com', ], ], [ 'name' => 'NewPort', 'in' => 'query', 'schema' => [ 'description' => '新的地址端口', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '3300', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '接口返回信息,一般为错误信息', 'type' => 'string', 'example' => 'success', ], 'Data' => [ 'description' => '新的地址链接串信息', 'type' => 'object', 'properties' => [ 'ConnectionString' => [ 'description' => '地址链接串', 'type' => 'string', 'example' => 'test2.polarx.huhehaote.rds.aliyuncs.com', ], 'DBInstanceName' => [ 'description' => '实例Id', 'type' => 'string', 'example' => 'pxc-unrf5ssig0ecg8', ], 'DBInstanceNetType' => [ 'description' => '地址链接串的网络类型', 'type' => 'string', 'example' => '1', ], 'Port' => [ 'description' => '地址端口', 'type' => 'string', 'example' => '3300', ], ], ], 'Code' => [ 'description' => '接口返回Code', 'type' => 'integer', 'format' => 'int64', 'example' => '200', ], 'RequestId' => [ 'description' => '请求RequestId,唯一标识', 'type' => 'string', 'example' => 'c3cf535c-a585-11ea-8263-00163e04d3a7', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"Data\\": {\\n \\"ConnectionString\\": \\"test2.polarx.huhehaote.rds.aliyuncs.com\\",\\n \\"DBInstanceName\\": \\"pxc-unrf5ssig0ecg8\\",\\n \\"DBInstanceNetType\\": \\"1\\",\\n \\"Port\\": \\"3300\\"\\n },\\n \\"Code\\": 200,\\n \\"RequestId\\": \\"c3cf535c-a585-11ea-8263-00163e04d3a7\\"\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n \\n test2.polarx.huhehaote.rds.aliyuncs.com\\n pxc-unrf5ssig0ecg8\\n 1\\n 3300\\n \\n 200\\n c3cf535c-a585-11ea-8263-00163e04d3a7\\n","errorExample":""}]', 'title' => '修改实例地址链接串', ], 'AllocateInstancePublicConnection' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-**************', ], ], [ 'name' => 'ConnectionStringPrefix', 'in' => 'query', 'schema' => [ 'description' => '公网地址前缀。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-**************', ], ], [ 'name' => 'Port', 'in' => 'query', 'schema' => [ 'description' => '公网地址端口。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '3306', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 9B2F3840-5C98-475C-B269-2D5C3A31797C\\n","errorExample":""}]', 'title' => '申请外网连接地址', 'summary' => '调用AllocateInstancePublicConnection接口创建公网IP。', ], 'AllocateColdDataVolume' => [ 'summary' => '调用AllocateColdDataVolume接口', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '137133', 'abilityTreeNodes' => [ 'FEATUREdrdsONAWER', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzravgpt8q****', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'D6A4256F-7B83-5BD7-9AC0-72E1FAC05330', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6A4256F-7B83-5BD7-9AC0-72E1FAC05330\\"\\n}","errorExample":""},{"type":"xml","example":"\\n D6A4256F-7B83-5BD7-9AC0-72E1FAC05330\\n","errorExample":""}]', 'title' => 'AllocateColdDataVolume', ], 'ReleaseColdDataVolume' => [ 'summary' => '调用ReleaseColdDataVolume接口', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '137137', 'abilityTreeNodes' => [ 'FEATUREdrdsONAWER', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzravgpt8q****', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'EA330983-C895-57C0-AE82-5A63106EBB10', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EA330983-C895-57C0-AE82-5A63106EBB10\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EA330983-C895-57C0-AE82-5A63106EBB10\\n","errorExample":""}]', 'title' => 'ReleaseColdDataVolume', ], 'DescribeColdDataBasicInfo' => [ 'summary' => '冷存储基础信息', 'methods' => [ 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'abilityTreeCode' => '137149', 'abilityTreeNodes' => [ 'FEATUREdrdsONAWER', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => true, 'docRequired' => true, ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => true, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'requestId', 'type' => 'string', ], 'Data' => [ 'title' => '详情信息', 'type' => 'object', 'properties' => [ 'EnableStatus' => [ 'title' => '是否开启冷存储', 'type' => 'boolean', ], 'CloudProduct' => [ 'title' => '底层存储云产品', 'type' => 'string', ], 'VolumeName' => [ 'title' => '存储卷名', 'type' => 'string', ], 'BackupSetSpaceSize' => [ 'title' => '有效备份集数据大小', 'type' => 'number', 'format' => 'double', ], 'BackupSetCount' => [ 'title' => '备份集个数', 'type' => 'integer', 'format' => 'int32', ], 'CurrentSpaceSize' => [ 'title' => '冷存储数据大小', 'type' => 'number', 'format' => 'double', ], 'DataRedundancyType' => [ 'type' => 'string', ], 'WriteAccessNum' => [ 'type' => 'number', 'format' => 'double', ], 'ReadAccessNum' => [ 'type' => 'integer', 'format' => 'int64', ], 'RegionId' => [ 'type' => 'string', ], ], ], ], ], ], ], 'responseDemo' => '', ], 'DescribeSlowLogRecords' => [ 'summary' => '支持查询PolarDB-X计算节点和存储节点的慢SQL明细。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '246562', 'abilityTreeNodes' => [ 'FEATUREdrdsSFVKQ0', ], ], 'parameters' => [ [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '分页每页大小。默认值:100。'."\n" ."\n" .'限制:最大支持一次返回100条记录。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', 'default' => '100', ], ], [ 'name' => 'Page', 'in' => 'query', 'schema' => [ 'description' => '页码。默认值:1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', 'default' => '1', ], ], [ 'name' => 'StartTime', 'in' => 'query', 'schema' => [ 'description' => '查询开始时间,格式: YYYY-MM-ddTHH:mmZ(UTC时间)。', 'type' => 'string', 'required' => true, 'example' => '2024-10-09T02:26', ], ], [ 'name' => 'EndTime', 'in' => 'query', 'schema' => [ 'description' => '查询开始时间,格式: YYYY-MM-ddTHH:mmZ(UTC时间)。', 'type' => 'string', 'required' => true, 'example' => '2024-11-22T02:22Z', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'example' => 'pxc-bjxxxxxxxx', ], ], [ 'name' => 'DBNodeIds', 'in' => 'query', 'schema' => [ 'description' => '节点ID。支持传入多个节点ID,多个ID间用英文逗号(`,`)分隔。查询存储节点的时候,该项为必填项。', 'type' => 'string', 'required' => false, 'example' => 'pxc-i-mezcj4ejdz', ], ], [ 'name' => 'CharacterType', 'in' => 'query', 'schema' => [ 'description' => '节点类型。', 'type' => 'string', 'required' => true, 'enumValueTitles' => [ 'polarx_dn' => 'polarx_dn', 'polarx_cn' => 'polarx_cn', ], 'example' => 'polarx_cn', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBName', 'in' => 'query', 'schema' => [ 'description' => '数据库名。', 'type' => 'string', 'required' => false, 'example' => 'testdb', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'DBInstanceId' => [ 'description' => '实例ID。', 'type' => 'string', 'example' => 'pxc-********', ], 'PageNumber' => [ 'description' => '当前查询的页码。', 'type' => 'string', 'example' => '1', ], 'PageRecordCount' => [ 'description' => '分页每页大小。', 'type' => 'string', 'example' => '30', ], 'TotalCount' => [ 'description' => '总条目数。', 'type' => 'string', 'example' => '3', ], 'Items' => [ 'description' => '慢日志明细列表。', 'type' => 'array', 'items' => [ 'description' => '慢日志明细列表。', 'type' => 'object', 'properties' => [ 'SQLHash' => [ 'description' => '慢日志统计里的 SQL 语句唯一标识符', 'type' => 'string', 'example' => 'c8df07e5d45cd68da8b4771c2016e20b', ], 'SQLText' => [ 'description' => 'SQL语句。', 'type' => 'string', 'example' => 'select * from test ', ], 'QueryStartTime' => [ 'description' => '时间戳,格式:YYYY-MM-ddTHH:mm.ss.SSSZ(UTC时间)。'."\n" ."\n" .'- 在CN慢日志,该字段表示执行开始时间。'."\n" .'- 在DN慢日志,该字段表示执行完成时间。', 'type' => 'string', 'example' => '2024-11-22T02:22:22.444Z', ], 'QueryTime' => [ 'description' => 'SQL语句执行时长,单位:秒(s)。', 'type' => 'string', 'example' => '3.000', ], 'QueryTimeMS' => [ 'description' => 'SQL语句执行时长,单位:秒(ms)。', 'type' => 'string', 'example' => '3000.000', ], 'LockTimeMS' => [ 'description' => '锁定时长。单位:毫秒(ms)。仅DN有该字段。', 'type' => 'string', 'example' => '1', ], 'ParseRowCounts' => [ 'description' => '扫描行数。仅DN有该字段。', 'type' => 'string', 'example' => '10', ], 'ReturnRowCounts' => [ 'description' => '返回行数。仅DN有该字段。', 'type' => 'string', 'example' => '20', ], 'HostAddress' => [ 'description' => '连接数据库的客户端名称及地址。', 'type' => 'string', 'example' => '****[****] @ [1XX.XX.XX.XX]'."\n", ], 'DBName' => [ 'description' => '数据库名称。', 'type' => 'string', 'example' => 'dcdev', ], 'CNname' => [ 'description' => '计算节点名称。仅CN有该字段。', 'type' => 'string', 'example' => 'pxc-i-xxxx', ], 'Extension' => [ 'description' => '拓展字段。仅CN有该字段。', 'type' => 'string', 'example' => 'tddl:5.4.19-20240927', ], 'Fail' => [ 'description' => '是否失败。仅CN有该字段。', 'type' => 'string', 'enumValueTitles' => [ '0', 2 => '2', ], 'example' => '0', ], 'InsName' => [ 'description' => '实例名。仅DN有该字段。', 'type' => 'string', 'example' => 'pxc-xdb-s-xxxx', ], 'IsBind' => [ 'description' => '是否为Prepare模式。仅CN有该字段。', 'type' => 'string', 'enumValueTitles' => [ '0', '1', ], 'example' => '0', ], 'WT' => [ 'description' => '负载类型。仅CN有该字段。', 'type' => 'string', 'enumValueTitles' => [ 'TP' => 'TP', 'AP' => 'AP', ], 'example' => 'TP', ], 'Params' => [ 'description' => 'Prepare模式下的参数。仅CN有该字段。', 'type' => 'string', 'example' => '["1"]', ], 'Frows' => [ 'description' => '拉取行数。仅CN有该字段。', 'type' => 'string', 'example' => '1', ], 'Rows' => [ 'description' => '影响/返回行数。仅CN有该字段。', 'type' => 'string', 'example' => '1', ], 'SCNT' => [ 'description' => '物理SQL数。仅CN有该字段。', 'type' => 'string', 'example' => '1', ], 'SqlType' => [ 'description' => 'SQL类型。仅CN有该字段。', 'type' => 'string', 'example' => 'select', ], 'TooLong' => [ 'description' => '是否过长。仅CN有该字段。', 'type' => 'string', 'enumValueTitles' => [ '0', '1', ], 'example' => '0', ], 'TraceId' => [ 'description' => '跟踪ID。仅CN有该字段。', 'type' => 'string', 'example' => '17a5c5c840006000', ], 'TransactionPolicy' => [ 'description' => '事务策略。仅CN有该字段。', 'type' => 'string', 'example' => 'XA', ], 'TrxId' => [ 'description' => '事务ID。仅CN有该字段。', 'type' => 'string', 'example' => '17a5c5c840006000', ], 'TemplateId' => [ 'description' => '内核模板ID。仅CN有该字段。', 'type' => 'string', 'example' => 'af33ffee', ], ], ], ], ], ], ], ], 'errorCodes' => [ 400 => [ [ 'errorCode' => 'InvalidStartTime.Malformed', 'errorMessage' => 'The specified parameter StartTime is not valid.', ], [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist or is not supported.', ], ], 404 => [ [ 'errorCode' => 'InvalidDBInstanceId.NotFound', 'errorMessage' => 'The specified DBInstanceId does not exist.', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"DBInstanceId\\": \\"pxc-********\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"PageRecordCount\\": \\"30\\",\\n \\"TotalCount\\": \\"3\\",\\n \\"Items\\": [\\n {\\n \\"SQLHash\\": \\"c8df07e5d45cd68da8b4771c2016e20b\\",\\n \\"SQLText\\": \\"select * from test \\",\\n \\"QueryStartTime\\": \\"2024-11-22T02:22:22.444Z\\",\\n \\"QueryTime\\": \\"3.000\\",\\n \\"QueryTimeMS\\": \\"3000.000\\",\\n \\"LockTimeMS\\": \\"1\\",\\n \\"ParseRowCounts\\": \\"10\\",\\n \\"ReturnRowCounts\\": \\"20\\",\\n \\"HostAddress\\": \\"****[****] @ [1XX.XX.XX.XX]\\\\n\\",\\n \\"DBName\\": \\"dcdev\\",\\n \\"CNname\\": \\"pxc-i-xxxx\\",\\n \\"Extension\\": \\"tddl:5.4.19-20240927\\",\\n \\"Fail\\": \\"0\\",\\n \\"InsName\\": \\"pxc-xdb-s-xxxx\\",\\n \\"IsBind\\": \\"0\\",\\n \\"WT\\": \\"TP\\",\\n \\"Params\\": \\"[\\\\\\"1\\\\\\"]\\",\\n \\"Frows\\": \\"1\\",\\n \\"Rows\\": \\"1\\",\\n \\"SCNT\\": \\"1\\",\\n \\"SqlType\\": \\"select\\",\\n \\"TooLong\\": \\"0\\",\\n \\"TraceId\\": \\"17a5c5c840006000\\",\\n \\"TransactionPolicy\\": \\"XA\\",\\n \\"TrxId\\": \\"17a5c5c840006000\\",\\n \\"TemplateId\\": \\"af33ffee\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n C458B1E8-1683-3645-B154-6BA32080EEA\\n pxc-********\\n 1\\n 30\\n 3\\n \\n c8df07e5d45cd68da8b4771c2016e20b\\n select * from test \\n 2024-11-22T02:22:22.444Z\\n 3.000\\n 3000.000\\n 1\\n 10\\n 20\\n ****[****] @ [1XX.XX.XX.XX]\\n\\n dcdev\\n pxc-i-xxxx\\n tddl:5.4.19-20240927\\n 0\\n pxc-xdb-s-xxxx\\n 0\\n TP\\n [\\"1\\"]\\n 1\\n 1\\n 1\\n select\\n 0\\n 17a5c5c840006000\\n XA\\n 17a5c5c840006000\\n af33ffee\\n \\n","errorExample":""}]', 'title' => '查询慢日志明细', ], 'DescribeDBNodePerformance' => [ 'summary' => '调用DescribeDBNodePerformance接口查询实例性能数据。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '101459', 'abilityTreeNodes' => [ 'FEATUREdrdsD0NTUP', ], ], 'parameters' => [ [ 'name' => 'Key', 'in' => 'query', 'schema' => [ 'description' => '指标名称,多个用英文逗号分隔,最多6个。详细内容请参见[性能参数表](~~332726~~)章节。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'Cpu_Usage,Mem_Usage', ], ], [ 'name' => 'StartTime', 'in' => 'query', 'schema' => [ 'description' => '查询开始时间, 格式: YYYY-MM-ddTHH:mmZ(UTC时间)。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2012-06-08T15:00Z', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => 'PolarDB-X实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-*******', ], ], [ 'name' => 'DBNodeIds', 'in' => 'query', 'schema' => [ 'description' => '节点名称,多个用英文逗号分隔,CDC节点和计算节点一次最多支持10个节点,数据节点一次最多支持1个节点。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-i-******,pxc-i-*******', ], ], [ 'name' => 'CharacterType', 'in' => 'query', 'schema' => [ 'description' => '节点类型。目前包含polarx\\_cn、polarx\\_dn、polarx\\_cdc、polarx\\_gms、polarx\\_columnar。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'polarx_cn', ], ], [ 'name' => 'DBNodeRole', 'in' => 'query', 'schema' => [ 'description' => '节点类型,取值:'."\n" .'- master:主节点'."\n" .'- slave:备节点。 针对 DN 和 GMS节点。'."\n" .'- standby: 备节点。针对 CN 节点。', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'master', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'EndTime', 'in' => 'query', 'schema' => [ 'description' => '查询结束时间, 格式: YYYY-MM-ddTHH:mmZ(UTC时间)。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2012-06-18T15:00Z', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'EndTime' => [ 'description' => '查询结束时间, 格式: YYYY-MM-ddTHH:mm:ssZ(UTC时间)。', 'type' => 'string', 'example' => '2021-10-20T02:00Z', ], 'StartTime' => [ 'description' => '查询开始时间, 格式: YYYY-MM-ddTHH:mm:ssZ(UTC时间)。', 'type' => 'string', 'example' => '2021-10-20T00:00Z', ], 'DBInstanceName' => [ 'description' => '实例名称。', 'type' => 'string', 'example' => 'pxc-********', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'EFB5E10B-5268-170F-A378-9AF86CCEACC8', ], 'PerformanceKeys' => [ 'type' => 'object', 'itemNode' => true, 'properties' => [ 'PerformanceItem' => [ 'description' => '性能数据列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'MetricName' => [ 'description' => '具体的性能指标度量名称。', 'type' => 'string', 'example' => 'logic_tps', ], 'DBNodeId' => [ 'description' => '节点名称。', 'type' => 'string', 'example' => 'pxc-i-********', ], 'Measurement' => [ 'description' => '性能指标。', 'type' => 'string', 'example' => 'Logic_TPS', ], 'Points' => [ 'type' => 'object', 'itemNode' => true, 'properties' => [ 'PerformanceItemValue' => [ 'description' => '性能数据数组。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Value' => [ 'description' => '监控指标数据值。', 'type' => 'string', 'example' => '42.38', ], 'Timestamp' => [ 'description' => '监控指标的具体时间点,格式为时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '1600822800000', ], ], ], ], ], ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"EndTime\\": \\"2021-10-20T02:00Z\\",\\n \\"StartTime\\": \\"2021-10-20T00:00Z\\",\\n \\"DBInstanceName\\": \\"pxc-********\\",\\n \\"RequestId\\": \\"EFB5E10B-5268-170F-A378-9AF86CCEACC8\\",\\n \\"PerformanceKeys\\": {\\n \\"PerformanceItem\\": [\\n {\\n \\"MetricName\\": \\"logic_tps\\",\\n \\"DBNodeId\\": \\"pxc-i-********\\",\\n \\"Measurement\\": \\"Logic_TPS\\",\\n \\"Points\\": {\\n \\"PerformanceItemValue\\": [\\n {\\n \\"Value\\": \\"42.38\\",\\n \\"Timestamp\\": 1600822800000\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 2021-10-20T02:00Z\\n 2021-10-20T00:00Z\\n pxc-********\\n EFB5E10B-5268-170F-A378-9AF86CCEACC8\\n \\n logic_tps\\n pxc-i-********\\n Logic_TPS\\n \\n 42.38\\n 1600822800000\\n \\n \\n","errorExample":""}]', 'title' => '查询实例性能数据', 'description' => '注意: '."\n" .'- **endpoint**和其他接口有区别,国内和新加坡需使用**polardbx.aliyuncs.com**, 其他地域使用**polardbx.{region id}.aliyunc.com**。'."\n" .'- 调试此API接口的时候,如果报服务不可用的错,请确认下**endpoint**是否正确,可通过切换**服务地址**到**迪拜**或者**印度**,将**endpoint**切换到**polardbx.aliyuncs.com**。', ], 'DescribeSqlAuditInfo' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86262', 'abilityTreeNodes' => [ 'FEATUREdrdsB0CUNV', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域id>您可以调用[describeregions](~~196841~~)查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceId', 'in' => 'query', 'schema' => [ 'description' => '实例id。>您可以调用[describedbinstances](~~196830~~)接口查看目标地域下所有实例的详情,包括实例id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-****************', ], ], [ 'name' => 'AuditAccountName', 'in' => 'query', 'schema' => [ 'description' => '审计管理员账号名称。>若已开启三权分立模式,该参数必填。详情请参见[三权分立](~~213824~~)。', 'type' => 'string', 'required' => false, 'example' => 'test_daa', ], ], [ 'name' => 'AuditAccountPassword', 'in' => 'query', 'schema' => [ 'description' => '审计管理员账号的密码。>若已开启三权分立模式,该参数必填。更多关于三权分立模块的信息,请参见[三权分立](~~213824~~)。', 'type' => 'string', 'required' => false, 'example' => '******', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => 'DC3ABA3E-0F8A-4596-9104-F5155C******', ], 'Data' => [ 'description' => '返回结果集。', 'type' => 'object', 'properties' => [ 'SLSLogStore' => [ 'description' => 'sls的logstore名称。', 'type' => 'string', 'example' => 'polardbx-sqlaudit-log', ], 'SLSProject' => [ 'description' => 'slsproject的名称。', 'type' => 'string', 'example' => 'polardbx-sqlaudit-cn-hangzhou-1852045029120897', ], 'IsEnabled' => [ 'description' => 'sql审计功能是否开启。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], ], ], 'errorCodes' => [ 404 => [ [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist.', ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"DC3ABA3E-0F8A-4596-9104-F5155C******\\",\\n \\"Data\\": {\\n \\"SLSLogStore\\": \\"polardbx-sqlaudit-log\\",\\n \\"SLSProject\\": \\"polardbx-sqlaudit-cn-hangzhou-1852045029120897\\",\\n \\"IsEnabled\\": true\\n }\\n}","type":"json"}]', 'title' => '查看SQL审计信息', 'summary' => '该接口用于查看SQL审计信息。', 'description' => '> * PolarDB-X 2.0 SQL审计与分析功能本身免费使用,但日志服务会对存储空间、读取流量、请求数量、数据加工、数据投递等进行收费,更多关于SQL审计功能的详情,请参见[开启SQL审计与分析](~~184619~~)。', ], 'EnableSqlAudit' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86272', 'abilityTreeNodes' => [ 'FEATUREdrdsD0NTUP', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceId', 'in' => 'query', 'schema' => [ 'description' => '实例id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-****************', ], ], [ 'name' => 'ExpireAfterDays', 'in' => 'query', 'schema' => [ 'description' => '审计日志保留天数:'."\n" ."\n" .'- 0:不保留(即关闭日志自动过期)'."\n" ."\n" .'- 0 :日志保留 N 天后自动删除'."\n" ."\n" .'- >常见取值:30、45、90、180、365', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '365', 'minimum' => '1', 'example' => '45', 'default' => '45', ], ], [ 'name' => 'AuditAccountName', 'in' => 'query', 'schema' => [ 'description' => '审计管理员账号名称。>若已开启三权分立模式,该参数必填。更多关于三权分立模块的信息,请参见[三权分立](~~213824~~)。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'test_daa', ], ], [ 'name' => 'AuditAccountPassword', 'in' => 'query', 'schema' => [ 'description' => '审计管理员账号的密码。>若已开启三权分立模式,该参数必填。更多关于三权分立模块的信息,请参见[三权分立](~~213824~~)。', 'type' => 'string', 'required' => false, 'example' => 'Pw@11111', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => 'DC3ABA3E-0F8A-4596-9104-F5167C******', ], ], ], ], ], 'errorCodes' => [ 404 => [ [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist.', ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Success\\": true,\\n \\"RequestId\\": \\"DC3ABA3E-0F8A-4596-9104-F5167C******\\"\\n}","type":"json"}]', 'title' => '开启SQL审计', 'summary' => '开启SQL审计功能。', 'description' => '> * PolarDB-X 2.0 SQL审计与分析功能本身免费使用,但日志服务会对存储空间、读取流量、请求数量、数据加工、数据投递等进行收费,更多关于SQL审计功能的详情,请参见[开启SQL审计与分析](~~184619~~)。', ], 'DisableSqlAudit' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域id。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceId', 'in' => 'query', 'schema' => [ 'description' => '实例id。>您可以调用[describedbinstances](~~196830~~)接口查看目标地域下所有实例的详情,包括实例id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-****************', ], ], [ 'name' => 'AuditAccountName', 'in' => 'query', 'schema' => [ 'description' => '审计管理员账号名称。>若已开启三权分立模式,该参数必填。更多关于三权分立模块的信息,请参见[三权分立](~~213824~~)。', 'type' => 'string', 'required' => false, 'example' => 'test_daa', ], ], [ 'name' => 'AuditAccountPassword', 'in' => 'query', 'schema' => [ 'description' => '审计管理员账号的密码。>若已开启三权分立模式,该参数必填。更多关于三权分立模块的信息,请参见[三权分立](~~213824~~)。', 'type' => 'string', 'required' => false, 'example' => 'Pw@11111', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => 'DC3DAE3E-0F8A-4596-9104-F5167C******', ], ], ], ], ], 'errorCodes' => [ 404 => [ [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist.', ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"DC3DAE3E-0F8A-4596-9104-F5167C******\\"\\n}","type":"json"}]', 'title' => '关闭SQL审计', 'summary' => '关闭SQL审计功能。', 'description' => '> SQL审计与分析功能关闭后将不再向日志服务写入数据,但您仍可以查看历史数据,这部分历史数据会产生存储和索引费用。您可以通过删除所有数据来停用日志服务,日志停止服务后将不再计费。关于停用日志服务,详情请参见[停用日志服务](~~90650~~)。', ], 'CheckSqlAuditSlsStatus' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86221', 'abilityTreeNodes' => [ 'FEATUREdrdsB0CUNV', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Status' => [ 'description' => 'sql审计功能开启状态,取值范围如下:*enabled:已开启*disabled:未开启', 'type' => 'string', 'example' => 'enabled', ], 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '173CA69A-3513-591D-8A09-C1EA37CBE2D9', ], ], ], ], ], 'errorCodes' => [ 404 => [ [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist.', ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Status\\": \\"enabled\\",\\n \\"RequestId\\": \\"173CA69A-3513-591D-8A09-C1EA37CBE2D9\\"\\n}","type":"json"}]', 'title' => '校验审计状态', 'summary' => '该接口用于检查指定数据库实例的 SQL 审计日志是否已成功接入 SLS(阿里云日志服务,Log Service)。'."\n" .'调用后,系统返回当前实例的 SQL 审计功能与 SLS 的连接状态、项目(Project)和日志库(Logstore)配置信息、同步是否正常等。', 'description' => '> * PolarDB-X 2.0 SQL审计与分析功能本身免费使用,但日志服务会对存储空间、读取流量、请求数量、数据加工、数据投递等进行收费,更多关于SQL审计功能的详情,请参见[开启SQL审计与分析](~~184619~~)。', ], 'DescribeEvents' => [ 'summary' => '获取历史事件。', 'methods' => [ 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '103087', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'title' => '区域ID', 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'StartTime', 'in' => 'query', 'schema' => [ 'title' => '开始时间', 'description' => '开始时间。', 'type' => 'string', 'required' => false, 'example' => '2021-10-18T03:07:25Z', ], ], [ 'name' => 'EndTime', 'in' => 'query', 'schema' => [ 'title' => '结束时间', 'description' => '结束时间。', 'type' => 'string', 'required' => false, 'example' => '2021-10-18T03:07:25Z', ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'title' => '页面大小', 'description' => '页面大小。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '20', ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'title' => '页面下标', 'description' => '页面下标。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => '返回结果集。', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '4748127A-6D50-432C-B635-433467074C27', ], 'TotalRecordCount' => [ 'title' => '总页数', 'description' => '总页数。', 'type' => 'integer', 'format' => 'int64', 'example' => '20', ], 'EventItems' => [ 'title' => '事件体', 'description' => '事件体。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'EventId' => [ 'title' => '事件ID', 'description' => '事件ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '50421290', ], 'EventName' => [ 'title' => '事件名称', 'description' => '事件名称。', 'type' => 'string', 'example' => 'ModifySecurityIps', ], 'EventPayload' => [ 'title' => '补充信息', 'description' => '补充信息。', 'type' => 'string', 'example' => '{\\"Domain\\": \\"rds-cn-hangzhou.aliyuncs.com\\"}', ], 'EventReason' => [ 'title' => '原因', 'description' => '原因。', 'type' => 'string', 'example' => 'FROM_USER', ], 'EventRecordTime' => [ 'title' => '记录时间', 'description' => '记录时间。', 'type' => 'string', 'example' => '2021-10-15T06:39:49Z', ], 'EventTime' => [ 'title' => '事件时间', 'description' => '事件时间。', 'type' => 'string', 'example' => '2021-10-15T06:35:00Z', ], 'EventType' => [ 'title' => '事件类型', 'description' => '事件类型。', 'type' => 'string', 'example' => 'SecurityManagement', ], 'EventUserType' => [ 'title' => '事件用户类型', 'description' => '事件用户类型。', 'type' => 'string', 'example' => 'USRE', ], 'RegionId' => [ 'title' => '区域ID', 'description' => '区域ID。', 'type' => 'string', 'example' => 'cn-hangzhou', ], 'ResourceName' => [ 'title' => '资源名', 'description' => '资源名。', 'type' => 'string', 'example' => 'px-bp1v8udesc89g156g', ], 'ResourceType' => [ 'title' => '资源类型', 'description' => '资源类型。', 'type' => 'string', 'example' => 'instance', ], ], ], ], 'PageSize' => [ 'title' => '页面大小', 'description' => '页面大小。', 'type' => 'integer', 'format' => 'int64', 'example' => '20', ], 'PageNumber' => [ 'title' => '页面下标', 'description' => '页面下标。', 'type' => 'integer', 'format' => 'int64', 'example' => '1', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4748127A-6D50-432C-B635-433467074C27\\",\\n \\"TotalRecordCount\\": 20,\\n \\"EventItems\\": [\\n {\\n \\"EventId\\": 50421290,\\n \\"EventName\\": \\"ModifySecurityIps\\",\\n \\"EventPayload\\": \\"{\\\\\\\\\\\\\\"Domain\\\\\\\\\\\\\\": \\\\\\\\\\\\\\"rds-cn-hangzhou.aliyuncs.com\\\\\\\\\\\\\\"}\\",\\n \\"EventReason\\": \\"FROM_USER\\",\\n \\"EventRecordTime\\": \\"2021-10-15T06:39:49Z\\",\\n \\"EventTime\\": \\"2021-10-15T06:35:00Z\\",\\n \\"EventType\\": \\"SecurityManagement\\",\\n \\"EventUserType\\": \\"USRE\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"ResourceName\\": \\"px-bp1v8udesc89g156g\\",\\n \\"ResourceType\\": \\"instance\\"\\n }\\n ],\\n \\"PageSize\\": 20,\\n \\"PageNumber\\": 1\\n}","errorExample":""},{"type":"xml","example":"\\n 4748127A-6D50-432C-B635-433467074C27\\n 20\\n \\n 50421290\\n ModifySecurityIps\\n {\\\\\\"Domain\\\\\\": \\\\\\"rds-cn-hangzhou.aliyuncs.com\\\\\\"}\\n FROM_USER\\n 2021-10-15T06:39:49Z\\n 2021-10-15T06:35:00Z\\n SecurityManagement\\n USRE\\n cn-hangzhou\\n px-bp1v8udesc89g156g\\n instance\\n \\n 20\\n 1\\n","errorExample":""}]', 'title' => '获取历史事件', ], 'DescribeActiveOperationMaintainConf' => [ 'summary' => '调用DescribeActiveOperationMaintainConf接口展示运维时间配置。', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '103014', 'abilityTreeNodes' => [ 'FEATUREdrdsZVW4NQ', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'title' => '区域ID', 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => '返回结果集。', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'requestid', 'description' => '请求ID。', 'type' => 'string', 'example' => '1A586DCB-39A6-4050-81CC-C7BD4CCDB49F', ], 'Config' => [ 'title' => '配置信息', 'description' => '配置信息。', 'type' => 'object', 'properties' => [ 'CreatedTime' => [ 'title' => '创建时间', 'description' => '创建时间。', 'type' => 'string', 'example' => '2021-08-11T10:08:27Z', ], 'CycleTime' => [ 'title' => '循环时间', 'description' => '循环时间。', 'type' => 'string', 'example' => '1,2,3,4,5,6,7', ], 'CycleType' => [ 'title' => '循环类型', 'description' => '循环类型。', 'type' => 'string', 'example' => 'Week', ], 'MaintainEndTime' => [ 'title' => '运维结束时间', 'description' => '运维结束时间。', 'type' => 'string', 'example' => '04:00:00Z', ], 'MaintainStartTime' => [ 'title' => '运维开始时间', 'description' => '运维开始时间。', 'type' => 'string', 'example' => '04:00:00Z', ], 'ModifiedTime' => [ 'title' => '修改时间', 'description' => '修改时间。', 'type' => 'string', 'example' => '2021-08-11T10:08:27Z', ], 'Status' => [ 'title' => '状态', 'description' => '状态。', 'type' => 'integer', 'format' => 'int64', 'example' => '1', ], ], ], 'HasConfig' => [ 'title' => '用户是否配置:1:已经配置。 0.未配置', 'description' => '是否已配置:'."\n" ."\n" .'- 1:已经配置;'."\n" .'- 0:未配置。', 'type' => 'integer', 'format' => 'int64', 'example' => '1', ], ], ], ], ], 'errorCodes' => [ 400 => [ [ 'errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1A586DCB-39A6-4050-81CC-C7BD4CCDB49F\\",\\n \\"Config\\": {\\n \\"CreatedTime\\": \\"2021-08-11T10:08:27Z\\",\\n \\"CycleTime\\": \\"1,2,3,4,5,6,7\\",\\n \\"CycleType\\": \\"Week\\",\\n \\"MaintainEndTime\\": \\"04:00:00Z\\",\\n \\"MaintainStartTime\\": \\"04:00:00Z\\",\\n \\"ModifiedTime\\": \\"2021-08-11T10:08:27Z\\",\\n \\"Status\\": 1\\n },\\n \\"HasConfig\\": 1\\n}","errorExample":""},{"type":"xml","example":"\\n 1A586DCB-39A6-4050-81CC-C7BD4CCDB49F\\n \\n 2021-08-11T10:08:27Z\\n 1,2,3,4,5,6,7\\n Week\\n 04:00:00Z\\n 04:00:00Z\\n 2021-08-11T10:08:27Z\\n 1\\n \\n 1\\n","errorExample":""}]', 'title' => '展示运维时间配置', ], 'DescribeActiveOperationTasks' => [ 'summary' => '调用DescribeActiveOperationTasks接口获取运维事件。', 'methods' => [ 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '102988', 'abilityTreeNodes' => [ 'FEATUREdrdsZVW4NQ', ], ], 'parameters' => [ [ 'name' => 'Region', 'in' => 'query', 'schema' => [ 'description' => '地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'TaskType', 'in' => 'query', 'schema' => [ 'description' => '任务类型,all代表查询该用户下所有的任务,固定取值为all。', 'type' => 'string', 'required' => false, 'example' => 'all', ], ], [ 'name' => 'ProductId', 'in' => 'query', 'schema' => [ 'description' => '产品名, 默认值为polarx。', 'type' => 'string', 'required' => false, 'example' => 'polarx', ], ], [ 'name' => 'DbType', 'in' => 'query', 'schema' => [ 'description' => '数据库类型,固定值:polarx。', 'type' => 'string', 'required' => false, 'example' => 'polarx', ], ], [ 'name' => 'InsName', 'in' => 'query', 'schema' => [ 'description' => '实例名,默认为空字符串。', 'type' => 'string', 'required' => false, 'example' => 'pxc-xxxxx', ], ], [ 'name' => 'ChangeLevel', 'in' => 'query', 'schema' => [ 'description' => '变更级别,默认all:'."\n" ."\n" .'- **all**:选择全部异常修复和系统运维的级别'."\n" .'- **S0**:异常修复'."\n" .'- **S1**:系统运维', 'type' => 'string', 'required' => false, 'example' => 'all', ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '每页记录数, 默认每页25条。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '25', ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'description' => '页码,大于0,默认1。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1', ], ], [ 'name' => 'Status', 'in' => 'query', 'schema' => [ 'description' => '任务状态,取值:'."\n" ."\n" .'- **-1**:选择全部待执行和执行中的任务 '."\n" .'- **3**:待执行 '."\n" .'- **4**:执行中', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '-1', ], ], [ 'name' => 'AllowChange', 'in' => 'query', 'schema' => [ 'description' => '是否允许修改时间,取值:'."\n" ."\n" .'- **-1**:允许修改全部运维事件的时间'."\n" .'- **0**:不允许 '."\n" .'- **1**:允许', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '-1', ], ], [ 'name' => 'AllowCancel', 'in' => 'query', 'schema' => [ 'description' => '是否允许取消,取值:'."\n" .'- **-1**:允许取消全部运维事件'."\n" .'- **0**:不允许 '."\n" .'- **1**:允许', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '-1', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'description' => '返回结果集。', 'type' => 'object', 'properties' => [ 'PageSize' => [ 'description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '12', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'xxxx', ], 'PageNumber' => [ 'description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1', ], 'TotalRecordCount' => [ 'description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '23', ], 'Items' => [ 'description' => '参数列表。', 'type' => 'array', 'items' => [ 'description' => '参数列表。', 'type' => 'object', 'properties' => [ 'AllowCancel' => [ 'description' => '是否允许取消'."\n" ."\n" .'- **0**:否'."\n" .'- **1**:是', 'type' => 'string', 'example' => '0', ], 'AllowChange' => [ 'description' => '是否允许修改'."\n" ."\n" .'- **0**:否'."\n" .'- **1**:是', 'type' => 'string', 'example' => '0', ], 'ChangeLevel' => [ 'description' => '变动等级(可忽略)。', 'type' => 'string', 'example' => 'Risk', ], 'ChangeLevelEn' => [ 'description' => '变动等级英文。', 'type' => 'string', 'example' => 'Risk repairment', ], 'ChangeLevelZh' => [ 'description' => '变动等级中文。', 'type' => 'string', 'example' => '风险修复', ], 'CreatedTime' => [ 'description' => '创建时间。', 'type' => 'string', 'example' => '2021-06-15T16:00:00Z', ], 'CurrentAVZ' => [ 'description' => '当前AVZ。', 'type' => 'string', 'example' => 'cn-shanghai-et-a', ], 'DbType' => [ 'description' => '数据库类型。', 'type' => 'string', 'example' => 'polarx', ], 'DbVersion' => [ 'description' => '数据库版本。', 'type' => 'string', 'example' => '2.0', ], 'Deadline' => [ 'description' => '截止时间。', 'type' => 'string', 'example' => '2021-06-15T16:00:00Z', ], 'Id' => [ 'description' => '任务ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '1', ], 'Impact' => [ 'description' => '影响(不输出)。', 'type' => 'string', 'example' => '--', ], 'ImpactEn' => [ 'description' => '影响英文。', 'type' => 'string', 'example' => 'Transient instance disconnection', ], 'ImpactZh' => [ 'description' => '影响中文。', 'type' => 'string', 'example' => '中断', ], 'InsComment' => [ 'description' => '描述。', 'type' => 'string', 'example' => 'xxx', ], 'InsName' => [ 'description' => '实例名。', 'type' => 'string', 'example' => 'pxc-dd', ], 'ModifiedTime' => [ 'description' => '修改时间。', 'type' => 'string', 'example' => '2021-06-15T16:00:00Z', ], 'PrepareInterval' => [ 'description' => '准备间隔。', 'type' => 'string', 'example' => '03:00:00', ], 'Region' => [ 'description' => '区域。', 'type' => 'string', 'example' => 'cn-shanghai-et15-b01', ], 'ResultInfo' => [ 'description' => '结果信息(可忽略)。', 'type' => 'string', 'example' => '--', ], 'StartTime' => [ 'description' => '开始时间。', 'type' => 'string', 'example' => '2021-06-15T16:00:00Z', ], 'Status' => [ 'description' => '状态 :'."\n" ."\n" .'- **3**:待执行 '."\n" .'- **4**:执行中', 'type' => 'integer', 'format' => 'int64', 'example' => '3', ], 'SubInsNames' => [ 'description' => '子实例列表。', 'type' => 'array', 'items' => [ 'description' => '子实例列表项。', 'type' => 'string', 'example' => 'pxc-xx', ], ], 'SwitchTime' => [ 'description' => '切换时间。', 'type' => 'string', 'example' => '2021-06-15T16:00:00Z', ], 'TaskType' => [ 'description' => '任务类型。', 'type' => 'string', 'example' => 'rds_apsaradb_transfer', ], 'TaskTypeEn' => [ 'description' => '任务类型英文(可忽略)。', 'type' => 'string', 'example' => '--', ], 'TaskTypeZh' => [ 'description' => '任务类型中文(可忽略)。', 'type' => 'string', 'example' => '--', ], ], ], ], ], ], ], ], 'errorCodes' => [ 400 => [ [ 'errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"PageSize\\": 12,\\n \\"RequestId\\": \\"xxxx\\",\\n \\"PageNumber\\": 1,\\n \\"TotalRecordCount\\": 23,\\n \\"Items\\": [\\n {\\n \\"AllowCancel\\": \\"0\\",\\n \\"AllowChange\\": \\"0\\",\\n \\"ChangeLevel\\": \\"Risk\\",\\n \\"ChangeLevelEn\\": \\"Risk repairment\\",\\n \\"ChangeLevelZh\\": \\"风险修复\\",\\n \\"CreatedTime\\": \\"2021-06-15T16:00:00Z\\",\\n \\"CurrentAVZ\\": \\"cn-shanghai-et-a\\",\\n \\"DbType\\": \\"polarx\\",\\n \\"DbVersion\\": \\"2.0\\",\\n \\"Deadline\\": \\"2021-06-15T16:00:00Z\\",\\n \\"Id\\": 1,\\n \\"Impact\\": \\"--\\",\\n \\"ImpactEn\\": \\"Transient instance disconnection\\",\\n \\"ImpactZh\\": \\"中断\\",\\n \\"InsComment\\": \\"xxx\\",\\n \\"InsName\\": \\"pxc-dd\\",\\n \\"ModifiedTime\\": \\"2021-06-15T16:00:00Z\\",\\n \\"PrepareInterval\\": \\"03:00:00\\",\\n \\"Region\\": \\"cn-shanghai-et15-b01\\",\\n \\"ResultInfo\\": \\"--\\",\\n \\"StartTime\\": \\"2021-06-15T16:00:00Z\\",\\n \\"Status\\": 3,\\n \\"SubInsNames\\": [\\n \\"pxc-xx\\"\\n ],\\n \\"SwitchTime\\": \\"2021-06-15T16:00:00Z\\",\\n \\"TaskType\\": \\"rds_apsaradb_transfer\\",\\n \\"TaskTypeEn\\": \\"--\\",\\n \\"TaskTypeZh\\": \\"--\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 12\\n xxxx\\n 1\\n 23\\n \\n 0\\n 0\\n Risk\\n Risk repairment\\n 风险修复\\n 2021-06-15T16:00:00Z\\n cn-shanghai-et-a\\n polarx\\n 2.0\\n 2021-06-15T16:00:00Z\\n 1\\n --\\n Transient instance disconnection\\n 中断\\n xxx\\n pxc-dd\\n 2021-06-15T16:00:00Z\\n 03:00:00\\n cn-shanghai-et15-b01\\n --\\n 2021-06-15T16:00:00Z\\n 3\\n pxc-xx\\n 2021-06-15T16:00:00Z\\n rds_apsaradb_transfer\\n --\\n --\\n \\n","errorExample":""}]', 'title' => '获取运维事件', ], 'DescribeActiveOperationTaskCount' => [ 'summary' => '获取运维事件总数。', 'methods' => [ 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '103006', 'abilityTreeNodes' => [ 'FEATUREdrdsZVW4NQ', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'Product', 'in' => 'query', 'schema' => [ 'description' => '产品, 默认polarx。', 'type' => 'string', 'required' => false, 'example' => 'polarx', ], ], [ 'name' => 'Category', 'in' => 'query', 'schema' => [ 'description' => '保留参数,无需填写。', 'type' => 'string', 'required' => false, 'example' => 'Category', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => '返回结果集。', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'EC7E27FC-58F8-4722-89BB-D1B6D0971956', ], 'NeedPop' => [ 'description' => '是否需要弹窗:'."\n" ."\n" .'- 1:需要'."\n" .'- 0:不需要', 'type' => 'integer', 'format' => 'int64', 'example' => '1', ], 'TaskCount' => [ 'description' => '总数。', 'type' => 'integer', 'format' => 'int64', 'example' => '20', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC7E27FC-58F8-4722-89BB-D1B6D0971956\\",\\n \\"NeedPop\\": 1,\\n \\"TaskCount\\": 20\\n}","errorExample":""},{"type":"xml","example":"\\n EC7E27FC-58F8-4722-89BB-D1B6D0971956\\n 1\\n 20\\n","errorExample":""}]', 'title' => '获取运维事件总数', ], 'ModifyActiveOperationMaintainConf' => [ 'summary' => '调用ModifyActiveOperationMaintainConf接口修改运维事件时间配置。', 'methods' => [ 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '103016', 'abilityTreeNodes' => [ 'FEATUREdrdsZVW4NQ', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'CycleType', 'in' => 'query', 'schema' => [ 'description' => '循环模式:Week,周。'."\n", 'type' => 'string', 'required' => true, 'example' => 'Week', ], ], [ 'name' => 'CycleTime', 'in' => 'query', 'schema' => [ 'description' => '周选择 :1-7。', 'type' => 'string', 'required' => true, 'example' => '1,2,3,4,5,6,7', ], ], [ 'name' => 'MaintainStartTime', 'in' => 'query', 'schema' => [ 'description' => '开始时间。', 'type' => 'string', 'required' => true, 'example' => '02:00:00Z', ], ], [ 'name' => 'MaintainEndTime', 'in' => 'query', 'schema' => [ 'description' => '结束时间。', 'type' => 'string', 'required' => true, 'example' => '02:00:00Z', ], ], [ 'name' => 'Status', 'in' => 'query', 'schema' => [ 'description' => '是否开启:'."\n" ."\n" .'- **1**: 开启'."\n" .'- **0**: 关闭', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '1', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '4035409E-7297-4115-ABC9-C1C3942BC069', ], ], ], ], ], 'errorCodes' => [ 400 => [ [ 'errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4035409E-7297-4115-ABC9-C1C3942BC069\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 4035409E-7297-4115-ABC9-C1C3942BC069\\n","errorExample":""}]', 'title' => '修改运维事件时间配置', ], 'DescribeTasks' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', ], 'parameters' => [ [ 'name' => 'DBInstanceId', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'StartTime', 'in' => 'query', 'schema' => [ 'description' => '任务开始时间。', 'type' => 'string', 'required' => true, 'example' => '2021-11-01', ], ], [ 'name' => 'EndTime', 'in' => 'query', 'schema' => [ 'description' => '任务结束时间。', 'type' => 'string', 'required' => true, 'example' => '2021-11-04', ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '分页每页大小,取值范围为:5~1000。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '30', 'example' => '20', 'default' => '30', ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'description' => '分页页数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '2147483647', 'minimum' => '1', 'example' => '30', 'default' => '1', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'D6045D78-C119-5A17-9DEA-0F810394E008', ], 'PageNumber' => [ 'description' => '分页页数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1', ], 'PageRecordCount' => [ 'description' => '分页每页大小。', 'type' => 'integer', 'format' => 'int32', 'example' => '30', ], 'TotalRecordCount' => [ 'description' => '分页总共条数。', 'type' => 'integer', 'format' => 'int32', 'example' => '2', ], 'Items' => [ 'description' => '结果项列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Status' => [ 'description' => '任务状态:'."\n" ."\n" .'- **RUNNING**: 任务运行中;'."\n" .'- **FAILED**:任务失败中断。', 'type' => 'string', 'example' => 'RUNNING', ], 'FinishTime' => [ 'description' => '任务结束时间,格式为yyyy-MM-dd\'T\'HH:mm:ss\'Z\'。', 'type' => 'string', 'example' => '2021-10-20T20:00:00Z', ], 'Progress' => [ 'description' => '任务进度,单位%。', 'type' => 'string', 'example' => '80', ], 'BeginTime' => [ 'description' => '任务开始时间,格式为yyyy-MM-dd\'T\'HH:mm:ss\'Z\'。', 'type' => 'string', 'example' => '2021-10-20T19:40:00Z', ], 'TaskErrorCode' => [ 'description' => '任务失败的code。', 'type' => 'string', 'example' => 'TaskErrorCode', ], 'DBName' => [ 'description' => '任务相关的数据库名,一般为空。', 'type' => 'string', 'example' => 'DBName', ], 'ProgressInfo' => [ 'description' => '任务进度详细情况,一般为空。', 'type' => 'string', 'example' => 'ProgressInfo', ], 'ScaleOutToken' => [ 'description' => '如果是扩容任务,则会有一个扩容ID,后台唯一键。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], 'TaskId' => [ 'description' => '任务ID。', 'type' => 'string', 'example' => '20089398', ], 'TaskErrorMessage' => [ 'description' => '任务失败信息。', 'type' => 'string', 'example' => 'TaskErrorMessage', ], 'TaskAction' => [ 'description' => '任务Action,后端任务类型唯一键。', 'type' => 'string', 'example' => 'multi_scale_out', ], ], ], ], ], ], ], ], 'staticInfo' => [], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6045D78-C119-5A17-9DEA-0F810394E008\\",\\n \\"PageNumber\\": 1,\\n \\"PageRecordCount\\": 30,\\n \\"TotalRecordCount\\": 2,\\n \\"Items\\": [\\n {\\n \\"Status\\": \\"RUNNING\\",\\n \\"FinishTime\\": \\"2021-10-20T20:00:00Z\\",\\n \\"Progress\\": \\"80\\",\\n \\"BeginTime\\": \\"2021-10-20T19:40:00Z\\",\\n \\"TaskErrorCode\\": \\"TaskErrorCode\\",\\n \\"DBName\\": \\"DBName\\",\\n \\"ProgressInfo\\": \\"ProgressInfo\\",\\n \\"ScaleOutToken\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\",\\n \\"TaskId\\": \\"20089398\\",\\n \\"TaskErrorMessage\\": \\"TaskErrorMessage\\",\\n \\"TaskAction\\": \\"multi_scale_out\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n D6045D78-C119-5A17-9DEA-0F810394E008\\n 1\\n 30\\n 2\\n \\n RUNNING\\n 2021-10-20T20:00:00Z\\n 80\\n 2021-10-20T19:40:00Z\\n TaskErrorCode\\n DBName\\n ProgressInfo\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n 20089398\\n TaskErrorMessage\\n multi_scale_out\\n \\n","errorExample":""}]', 'title' => '获取实例任务列表', 'summary' => '获取实例任务列表。', ], 'DescribeScaleOutMigrateTaskList' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86260', 'abilityTreeNodes' => [ 'FEATUREdrds0SX279', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => true, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Progress' => [ 'description' => '迁移任务进度。', 'type' => 'integer', 'format' => 'int32', 'example' => '32', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Progress\\": 32,\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 32\\n C458B1E8-1683-3645-B154-6BA32080EEA\\n","errorExample":""}]', 'title' => '展示数据迁移任务进度', 'summary' => '展示ScaleOut迁移任务进度。', ], 'CreateTransformOperation' => [ 'summary' => '创建转换任务,用于改变实例的某种状态或配置。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', 'riskType' => 'high', 'chargeType' => 'free', 'abilityTreeCode' => '196930', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域id。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => false, 'example' => 'pxc-xxx', ], ], [ 'name' => 'Operation', 'in' => 'query', 'schema' => [ 'description' => '本次操作类型', 'type' => 'string', 'required' => false, 'example' => 'finish', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], ], ], ], ], 'errorCodes' => [ 400 => [ [ 'errorCode' => 'IncorrectDBInstance', 'errorMessage' => 'Current DB instance does not support this operation.', ], [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist or is not supported.', ], [ 'errorCode' => 'InvalidParam', 'errorMessage' => 'Invalid Parameter.', ], [ 'errorCode' => 'IncorrectDBInstanceState', 'errorMessage' => 'Current DB instance state does not support this operation.', ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\"\\n}","type":"json"}]', 'title' => '创建转换任务', ], 'DescribeRplInspectionTask' => [ 'summary' => '该接口用于查询实例的复制延迟巡检任务的详细信息。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '104354', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'FailPageNumber', 'in' => 'query', 'schema' => [ 'description' => '当前页数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'example' => '1', 'pattern' => '^\\d+$', 'default' => '1', ], ], [ 'name' => 'FailPageSize', 'in' => 'query', 'schema' => [ 'description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '5', 'example' => '10', 'pattern' => '^\\d+$', 'default' => '30', ], ], [ 'name' => 'SuccessPageNumber', 'in' => 'query', 'schema' => [ 'description' => '请求页数。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1', ], ], [ 'name' => 'SuccessPageSize', 'in' => 'query', 'schema' => [ 'description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '15', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '切换任务id。', 'type' => 'string', 'required' => false, 'example' => 'etx-szr2rr6i*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', ], 'Message' => [ 'description' => '任务错误信息。', 'type' => 'string', 'example' => '*****', ], 'Data' => [ 'description' => '任务详情。', 'type' => 'object', 'properties' => [ 'InspectionTaskList' => [ 'description' => '机器任务信息。', 'type' => 'array', 'items' => [ 'description' => '机器任务信息。', 'type' => 'object', 'properties' => [ 'CreateTime' => [ 'description' => '任务创建时间戳。', 'type' => 'integer', 'format' => 'int64', 'example' => '2025-09-25T02:36:20.000+0000', ], 'Description' => [ 'description' => '巡检任务描述。', 'type' => 'string', 'example' => 'For database: wms ,Found SIMPLE sequences in 1.0. PolarDB-X 2.0 does not support SIMPLE sequence any more, please use show sequence to check them.', ], 'Id' => [ 'description' => '任务id。', 'type' => 'integer', 'format' => 'int64', 'example' => '10142', ], 'SlinkTaskId' => [ 'description' => 'slinktaskid。', 'type' => 'string', 'example' => 'etx-hzrez23btmb6aq', ], 'Stage' => [ 'description' => '阶段名称。', 'type' => 'string', 'example' => 'CONNECTIVITY', ], 'Status' => [ 'description' => '任务状态。', 'type' => 'string', 'example' => 'SUCCEEDED', ], 'UpdateTime' => [ 'description' => '最近一次任务更新时间(时间戳格式)。', 'type' => 'integer', 'format' => 'int64', 'example' => '2025-09-23T03:25:21.000+0000', ], ], ], ], 'SlinkStage' => [ 'description' => 'slink状态。', 'type' => 'string', 'example' => 'PRE_CHECK', ], ], ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Message\\": \\"*****\\",\\n \\"Data\\": {\\n \\"InspectionTaskList\\": [\\n {\\n \\"CreateTime\\": 0,\\n \\"Description\\": \\"For database: wms ,Found SIMPLE sequences in 1.0. PolarDB-X 2.0 does not support SIMPLE sequence any more, please use show sequence to check them.\\",\\n \\"Id\\": 10142,\\n \\"SlinkTaskId\\": \\"etx-hzrez23btmb6aq\\",\\n \\"Stage\\": \\"CONNECTIVITY\\",\\n \\"Status\\": \\"SUCCEEDED\\",\\n \\"UpdateTime\\": 0\\n }\\n ],\\n \\"SlinkStage\\": \\"PRE_CHECK\\"\\n },\\n \\"Success\\": true\\n}","type":"json"}]', 'title' => '获取实例巡检任务', 'description' => '数据同步阶段,主动发起对复制链路的诊断任务,检查是否存在延迟、中断、数据不一致等异常问题。', ], 'SkipCurrentStep' => [ 'summary' => '该接口用于跳过当前步骤。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '200597', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'CurrentStep', 'in' => 'query', 'schema' => [ 'description' => '任务当前操作步数。', 'type' => 'string', 'required' => false, 'example' => 'PRE_CHECK', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '导入任务id。', 'type' => 'string', 'required' => false, 'example' => 'etx-szr2rr6i*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', ], 'Message' => [ 'description' => '返回消息。>请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => '*****', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'True', ], 'Data' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ 'SlinkTaskId' => [ 'description' => 'slink任务id。', 'type' => 'string', 'example' => 'etx-szr2rr6i*****', ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Message\\": \\"*****\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"SlinkTaskId\\": \\"etx-szr2rr6i*****\\"\\n }\\n}","type":"json"}]', 'title' => '跳过当前步骤', ], 'CreateRplInspectionTask' => [ 'summary' => '在数据迁移过程中,用于复制链路健康检查。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '104276', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '切换任务id。', 'type' => 'string', 'required' => true, 'example' => 'etx-szr2rr6i*****', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域id。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'SrcUserName', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '源实例(源数据库)的连接用户名', 'type' => 'string', 'required' => false, 'example' => 'bbt_ump', ], ], [ 'name' => 'SrcPassword', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '源rds实例的用户密码。>您可以调用[describedbinstances](~~196830~~)接口查看目标地域下所有实例的详情,包括用户密码。', 'type' => 'string', 'required' => false, 'example' => '******', ], ], [ 'name' => 'DstResId', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '目标任务id。', 'type' => 'string', 'required' => false, 'example' => 'pxc-zkrc1****l54rc', ], ], [ 'name' => 'DstDb', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '目标实例中迁移对象所属的rds实例id。>您可以调用[describedbinstances](~~196830~~)接口查看目标地域下所有rds实例的详情,包括实例id。', 'type' => 'string', 'required' => false, 'example' => 'transfer_test3', ], ], [ 'name' => 'DstUserName', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '目标实例的连接用户名', 'type' => 'string', 'required' => false, 'example' => 'bbt_item', ], ], [ 'name' => 'DstPassword', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '目标rds实例高权限账号的密码。>*长度为8~32个字符。*由大写字母、小写字母、数字、特殊字符中的任意三种组成。*特殊字符为!@#$&%^*()_+-=', 'type' => 'string', 'required' => false, 'example' => '******', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '任务错误信息。>仅当任务状态为**stop**时返回该参数。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '任务详情。', 'type' => 'object', 'properties' => [ 'SlinkTaskId' => [ 'description' => 'slink任务id。', 'type' => 'string', 'example' => 'etx-szr2rr6i*****', ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"SlinkTaskId\\": \\"etx-szr2rr6i*****\\"\\n }\\n}","type":"json"}]', 'title' => '复制链路健康检查', 'description' => '数据同步阶段,主动发起对复制链路的诊断任务,检查是否存在延迟、中断、数据不一致等异常问题', ], 'CancelActiveOperationTasks' => [ 'summary' => '调用CancelActiveOperationTasks接口取消运维事件任务。', 'methods' => [ 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '102580', 'abilityTreeNodes' => [ 'FEATUREdrdsZVW4NQ', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'Ids', 'in' => 'query', 'schema' => [ 'description' => '事件ID集合,以英文逗号隔开。', 'type' => 'string', 'required' => true, 'example' => '111', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'AE4F6C34-065F-45AA-B5DC-4B8D816F6305', ], 'Ids' => [ 'description' => '事件ID集合, 以英文逗号隔开。', 'type' => 'string', 'example' => '111,1223', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"AE4F6C34-065F-45AA-B5DC-4B8D816F6305\\",\\n \\"Ids\\": \\"111,1223\\"\\n}","errorExample":""},{"type":"xml","example":"\\n AE4F6C34-065F-45AA-B5DC-4B8D816F6305\\n 111,1223\\n","errorExample":""}]', 'title' => '取消运维事件任务', ], 'ModifyActiveOperationTasks' => [ 'summary' => '调用ModifyActiveOperationTasks接口修改运维事件执行时间。', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '103010', 'abilityTreeNodes' => [ 'FEATUREdrdsZVW4NQ', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域IID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'Ids', 'in' => 'query', 'schema' => [ 'description' => '运维事件ID。', 'type' => 'string', 'required' => true, 'example' => '1', ], ], [ 'name' => 'SwitchTime', 'in' => 'query', 'schema' => [ 'description' => '开始切换时间,格式为:YYYY-MM-DDThh:mm:ssZ。', 'type' => 'string', 'required' => false, 'example' => '2021-08-15T12:00:00Z', ], ], [ 'name' => 'ImmediateStart', 'in' => 'query', 'schema' => [ 'description' => '是否立即执行:'."\n" ."\n" .'- 1:立即执行'."\n" .'- 0:指定时间执行', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '8C9CC90A-9532-4752-B59F-580112C5A45B', ], 'Ids' => [ 'description' => '运维事件ID列表, 以英文逗号隔开。', 'type' => 'string', 'example' => '1', ], ], ], ], ], 'errorCodes' => [ 400 => [ [ 'errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"8C9CC90A-9532-4752-B59F-580112C5A45B\\",\\n \\"Ids\\": \\"1\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 8C9CC90A-9532-4752-B59F-580112C5A45B\\n 1\\n","errorExample":""}]', 'title' => '修改运维事件执行时间', ], 'UpdateDBInstanceSSL' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86293', 'abilityTreeNodes' => [ 'FEATUREdrdsUULYZA', ], ], 'parameters' => [ [ 'name' => 'EnableSSL', 'in' => 'query', 'schema' => [ 'description' => '是否开启SSL。', 'type' => 'boolean', 'required' => true, 'docRequired' => true, 'example' => 'true', ], ], [ 'name' => 'CertCommonName', 'in' => 'query', 'schema' => [ 'description' => '证书绑定域名。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'pxc-hzrqjarxdocd4t.polarx.rds.aliyuncs.com', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], 'Data' => [ 'description' => '请求返回数据。', 'type' => 'object', 'properties' => [ 'TaskId' => [ 'description' => '后端任务ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '2209883', ], ], ], ], ], ], ], 'errorCodes' => [ 404 => [ [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist.', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\",\\n \\"Data\\": {\\n \\"TaskId\\": 2209883\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n \\n 2209883\\n \\n","errorExample":""}]', 'title' => '更新实例SSL配置', 'summary' => '更新实例SSL配置。', ], 'ModifyParameter' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86282', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceId', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasdyuoo', ], ], [ 'name' => 'ParamLevel', 'in' => 'query', 'schema' => [ 'description' => '参数类型:'."\n" ."\n" .'- **compute**:计算层参数;'."\n" .'- **storage**:存储层参数。', 'type' => 'string', 'required' => false, 'example' => 'compute', ], ], [ 'name' => 'Parameters', 'in' => 'query', 'schema' => [ 'description' => '参数为符合JSON格式的字符串,MapKey表示参数名称,MapValue表示参数值。可修改的具体参数是动态增删的,请通过[DescribeParameterTemplates](~~196856~~)接口获取,一次可以传入多个参数。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '{"CONN_POOL_BLOCK_TIMEOUT":6000}', ], ], [ 'name' => 'ClientToken', 'in' => 'query', 'schema' => [ 'description' => '客户端请求Token,任意唯一字符串。', 'type' => 'string', 'required' => false, 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], ], [ 'name' => 'ParameterGroupId', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], ], ], ], ], 'errorCodes' => [ 404 => [ [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist.', ], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\"\\n}","errorExample":""},{"type":"xml","example":"\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n","errorExample":""}]', 'title' => '修改实例参数', 'summary' => '调用ModifyParameter接口修改实例参数,包括计算层和存储层。', ], 'DescribeParameterTemplates' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86254', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceId', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'ParamLevel', 'in' => 'query', 'schema' => [ 'description' => '参数级别,取值如下:'."\n" .'- **compute**:计算层;'."\n" .'- **storage**:存储层。', 'type' => 'string', 'required' => false, 'example' => 'compute', ], ], [ 'name' => 'EngineVersion', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'Engine' => [ 'description' => '引擎,默认polarx。', 'type' => 'string', 'example' => 'polarx', ], 'EngineVersion' => [ 'description' => '引擎版本,默认2.0。', 'type' => 'string', 'example' => '2.0', ], 'ParameterCount' => [ 'description' => '参数个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '218', ], 'Parameters' => [ 'description' => '参数列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'CheckingCode' => [ 'description' => '检测约制。', 'type' => 'string', 'example' => '[0|1]', ], 'ParameterName' => [ 'description' => '参数名。', 'type' => 'string', 'example' => 'loose_enable_gts', ], 'Dynamic' => [ 'description' => '是否动态:'."\n" ."\n" .'- **0**:否;'."\n" .'- **1**:是。', 'type' => 'integer', 'format' => 'int32', 'example' => '0', ], 'ParameterValue' => [ 'description' => '参数值。', 'type' => 'string', 'example' => '1', ], 'ParameterDescription' => [ 'description' => '参数描述。', 'type' => 'string', 'example' => 'polarx hatp addition param', ], 'Revisable' => [ 'description' => '是否可以修改'."\n" ."\n" .'- **0**:不能修改;'."\n" .'- **1**:修改。', 'type' => 'integer', 'format' => 'int32', 'example' => '0', ], ], ], ], ], ], ], ], ], ], 'errorCodes' => [ 404 => [ [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist.', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Data\\": {\\n \\"Engine\\": \\"polarx\\",\\n \\"EngineVersion\\": \\"2.0\\",\\n \\"ParameterCount\\": 218,\\n \\"Parameters\\": [\\n {\\n \\"CheckingCode\\": \\"[0|1]\\",\\n \\"ParameterName\\": \\"loose_enable_gts\\",\\n \\"Dynamic\\": 0,\\n \\"ParameterValue\\": \\"1\\",\\n \\"ParameterDescription\\": \\"polarx hatp addition param\\",\\n \\"Revisable\\": 0\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n C458B1E8-1683-3645-B154-6BA32080EEA\\n \\n polarx\\n 2.0\\n 218\\n \\n [0|1]\\n loose_enable_gts\\n 0\\n 1\\n polarx hatp addition param\\n 0\\n \\n \\n","errorExample":""}]', 'title' => '查看参数模版详情', 'summary' => '调用DescribeParameterTemplates接口获取实例参数模版列表。', ], 'DescribeParameters' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86253', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceId', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'ParamLevel', 'in' => 'query', 'schema' => [ 'description' => '参数级别,取值:'."\n" ."\n" .'- compute:计算层 ;'."\n" .'- storage:存储层。'."\n" ."\n", 'type' => 'string', 'required' => false, 'example' => 'compute', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。'."\n" ."\n", 'type' => 'string', 'example' => '6BA32080EEA', ], 'Data' => [ 'description' => '参数详情。', 'type' => 'object', 'properties' => [ 'EngineVersion' => [ 'description' => '引擎版本,默认2.0。'."\n" ."\n", 'type' => 'string', 'example' => '2.0', ], 'Engine' => [ 'description' => '引擎,默认polarx。'."\n" ."\n", 'type' => 'string', 'example' => 'polarx', ], 'ConfigParameters' => [ 'description' => '原始参数列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'ParameterDescription' => [ 'description' => '参数描述。', 'type' => 'string', 'example' => '存储节点私有协议开关(-1关闭,0开启)', ], 'ParameterName' => [ 'description' => '参数名称。', 'type' => 'string', 'example' => 'CONN_POOL_XPROTO_STORAGE_DB_PORT', ], 'ParameterValue' => [ 'description' => '参数值。', 'type' => 'string', 'example' => '-1', ], ], ], ], 'RunningParameters' => [ 'description' => '运行中的参数详情列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'ParameterDescription' => [ 'description' => '参数描述。', 'type' => 'string', 'example' => '存储节点私有协议开关(-1关闭,0开启)', ], 'ParameterName' => [ 'description' => '参数名称。', 'type' => 'string', 'example' => 'CONN_POOL_XPROTO_STORAGE_DB_PORT', ], 'ParameterValue' => [ 'description' => '参数取值。', 'type' => 'string', 'example' => '-1', ], ], ], ], 'DBInstanceId' => [ 'type' => 'string', ], ], ], ], ], ], ], 'errorCodes' => [ 404 => [ [ 'errorCode' => 'InvalidDBInstance.NotFound', 'errorMessage' => 'The specified DB instance does not exist.', ], ], ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"6BA32080EEA\\",\\n \\"Data\\": {\\n \\"EngineVersion\\": \\"2.0\\",\\n \\"Engine\\": \\"polarx\\",\\n \\"ConfigParameters\\": [\\n {\\n \\"ParameterDescription\\": \\"存储节点私有协议开关(-1关闭,0开启)\\",\\n \\"ParameterName\\": \\"CONN_POOL_XPROTO_STORAGE_DB_PORT\\",\\n \\"ParameterValue\\": \\"-1\\"\\n }\\n ],\\n \\"RunningParameters\\": [\\n {\\n \\"ParameterDescription\\": \\"存储节点私有协议开关(-1关闭,0开启)\\",\\n \\"ParameterName\\": \\"CONN_POOL_XPROTO_STORAGE_DB_PORT\\",\\n \\"ParameterValue\\": \\"-1\\"\\n }\\n ],\\n \\"DBInstanceId\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 6BA32080EEA\\n \\n 2.0\\n polarx\\n \\n 存储节点私有协议开关(-1关闭,0开启)\\n CONN_POOL_XPROTO_STORAGE_DB_PORT\\n -1\\n \\n \\n 存储节点私有协议开关(-1关闭,0开启)\\n CONN_POOL_XPROTO_STORAGE_DB_PORT\\n -1\\n \\n \\n","errorExample":""}]', 'title' => '获取参数列表', 'summary' => '调用DescribeParameters接口获取实例参数。', ], 'DescribeParameterGroups' => [ 'summary' => '该接口用于查询用户创建或系统支持的数据库参数组列表,包括各参数组的基本信息、关联引擎类型及修改时间等。', 'methods' => [ 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '230979', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'Data' => [ 'description' => '实例详情列表。', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。'."\n" ."\n", 'type' => 'string', 'example' => '1E5DCFFC-A00D-****-836E-73318F8CA577', ], 'ParameterGroups' => [ 'description' => '参数模板名称。', 'type' => 'array', 'items' => [ 'description' => '参数模板列表。', 'type' => 'object', 'properties' => [ 'ParameterGroupId' => [ 'description' => '参数模板ID。'."\n" .'> 您可以通过[DescribeParameterGroups](~~207178~~)接口查询目标地域下所有参数模板的详细信息,包括参数模板ID。', 'type' => 'string', 'example' => 'rpg-s1y1xy06****fqs7y', ], 'GmtCreated' => [ 'description' => '账号创建时间。', 'type' => 'string', 'example' => '2024-12-19T16:41:31+08:00', ], 'GmtModified' => [ 'description' => '修改时间,时间戳格式。', 'type' => 'string', 'example' => '1605079985000', ], 'DbType' => [ 'description' => '数据库类型。', 'type' => 'string', 'example' => 'polarx', ], 'DbVersion' => [ 'description' => '数据库版本。', 'type' => 'string', 'example' => '5.7', ], 'DnParamCount' => [ 'description' => 'DN参数数量', 'type' => 'integer', 'format' => 'int32', 'example' => '10', ], 'DnForceRestart' => [ 'description' => 'DN强制重启', 'type' => 'boolean', ], 'CnParamCount' => [ 'description' => 'CN参数数量', 'type' => 'integer', 'format' => 'int32', 'example' => '10', ], 'CnForceRestart' => [ 'description' => 'CN强制重启', 'type' => 'boolean', ], 'Series' => [ 'description' => '实例系列,取值如下:'."\n" ."\n" .'- **enterprise**:企业版'."\n" .'- **standard**:标准版', 'type' => 'string', 'example' => 'enterprise', ], 'ParameterGroupName' => [ 'description' => '参数模板名称。', 'type' => 'string', 'example' => 'dstest_api_new', ], 'ParameterGroupType' => [ 'description' => '参数模板类型', 'type' => 'string', 'example' => '0', ], ], ], ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"Data\\": {\\n \\"RequestId\\": \\"1E5DCFFC-A00D-****-836E-73318F8CA577\\",\\n \\"ParameterGroups\\": [\\n {\\n \\"ParameterGroupId\\": \\"rpg-s1y1xy06****fqs7y\\",\\n \\"GmtCreated\\": \\"2024-12-19T16:41:31+08:00\\",\\n \\"GmtModified\\": \\"1605079985000\\",\\n \\"DbType\\": \\"polarx\\",\\n \\"DbVersion\\": \\"5.7\\",\\n \\"DnParamCount\\": 10,\\n \\"DnForceRestart\\": true,\\n \\"CnParamCount\\": 10,\\n \\"CnForceRestart\\": true,\\n \\"Series\\": \\"enterprise\\",\\n \\"ParameterGroupName\\": \\"dstest_api_new\\",\\n \\"ParameterGroupType\\": \\"0\\"\\n }\\n ]\\n }\\n}","type":"json"}]', 'title' => '查询参数组信息', ], 'CreateBackup' => [ 'methods' => [ 'post', 'get', 'put', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86225', 'abilityTreeNodes' => [ 'FEATUREdrdsE1M93A', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-**************', ], ], [ 'name' => 'BackupType', 'in' => 'query', 'schema' => [ 'description' => '备份种类,目前只支持“0”,表示快速备份。', 'type' => 'string', 'required' => false, 'example' => '0', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '成功为空,失败为报错信息。', 'type' => 'string', 'example' => '*****', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ 'BackupSetId' => [ 'type' => 'string', ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"*****\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"BackupSetId\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n *****\\n 9B2F3840-5C98-475C-B269-2D5C3A31797C\\n true\\n \\n 627833\\n \\n","errorExample":""}]', 'title' => '创建备份', 'summary' => '调用CreateBackup接口创建备份。', ], 'DescribeBackupPolicy' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86236', 'abilityTreeNodes' => [ 'FEATUREdrdsE1M93A', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域的ID。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '请求ID。'."\n" ."\n", 'type' => 'string', 'example' => 'B87E2AB3-B7C9-4394-9160-7F639F732031', ], 'Success' => [ 'description' => ' 请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '返回体。', 'type' => 'object', 'properties' => [ 'LogLocalRetentionSpace' => [ 'type' => 'integer', 'format' => 'int32', ], 'DBInstanceName' => [ 'type' => 'string', ], 'BackupWay' => [ 'type' => 'string', ], 'BackupPeriod' => [ 'type' => 'string', ], 'ForceCleanOnHighSpaceUsage' => [ 'type' => 'integer', 'format' => 'int32', ], 'BackupType' => [ 'type' => 'string', ], 'LocalLogRetention' => [ 'type' => 'integer', 'format' => 'int32', ], 'RemoveLogRetention' => [ 'type' => 'integer', 'format' => 'int32', ], 'BackupPlanBegin' => [ 'type' => 'string', ], 'BackupSetRetention' => [ 'type' => 'integer', 'format' => 'int32', ], 'IsEnabled' => [ 'type' => 'integer', 'format' => 'int32', ], 'ColdDataBackupInterval' => [ 'type' => 'integer', 'format' => 'int32', ], 'ColdDataBackupRetention' => [ 'type' => 'integer', 'format' => 'int32', ], 'LocalLogRetentionNumber' => [ 'type' => 'integer', 'format' => 'int32', ], 'IsCrossRegionDataBackupEnabled' => [ 'type' => 'boolean', ], 'IsCrossRegionLogBackupEnabled' => [ 'type' => 'boolean', ], 'DestCrossRegion' => [ 'type' => 'string', ], 'CrossRegionDataBackupRetention' => [ 'type' => 'integer', 'format' => 'int32', ], 'CrossRegionLogBackupRetention' => [ 'type' => 'integer', 'format' => 'int32', ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"B87E2AB3-B7C9-4394-9160-7F639F732031\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"LogLocalRetentionSpace\\": 0,\\n \\"DBInstanceName\\": \\"\\",\\n \\"BackupWay\\": \\"\\",\\n \\"BackupPeriod\\": \\"\\",\\n \\"ForceCleanOnHighSpaceUsage\\": 0,\\n \\"BackupType\\": \\"\\",\\n \\"LocalLogRetention\\": 0,\\n \\"RemoveLogRetention\\": 0,\\n \\"BackupPlanBegin\\": \\"\\",\\n \\"BackupSetRetention\\": 0,\\n \\"IsEnabled\\": 0,\\n \\"ColdDataBackupInterval\\": 0,\\n \\"ColdDataBackupRetention\\": 0,\\n \\"LocalLogRetentionNumber\\": 0,\\n \\"IsCrossRegionDataBackupEnabled\\": true,\\n \\"IsCrossRegionLogBackupEnabled\\": true,\\n \\"DestCrossRegion\\": \\"\\",\\n \\"CrossRegionDataBackupRetention\\": 0,\\n \\"CrossRegionLogBackupRetention\\": 0\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n B87E2AB3-B7C9-4394-9160-7F639F732031\\n true\\n \\n 30\\n pxc-xxxxxx\\n P\\n 1001000\\n 1\\n 0\\n 30\\n 7\\n 03:00Z\\n 7\\n 1\\n 30\\n 30\\n 60\\n false\\n false\\n cn-shanghai\\n 30\\n 30\\n \\n","errorExample":""}]', 'title' => '查询实例备份设置', 'summary' => '调用DescribeBackupPolicy接口查询实例备份设置。', ], 'DescribeBackupSetList' => [ 'methods' => [ 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86237', 'abilityTreeNodes' => [ 'FEATUREdrdsE1M93A', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域的ID。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。'."\n" ."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-xxxxxx', ], ], [ 'name' => 'StartTime', 'in' => 'query', 'schema' => [ 'description' => '开始时间的时间戳, 单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1635707845000', ], ], [ 'name' => 'EndTime', 'in' => 'query', 'schema' => [ 'description' => '结束时间的时间戳, 单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1635707845000', ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '每页的数据大小。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'description' => '分页下标,从1开始。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', ], ], [ 'name' => 'DestCrossRegion', 'in' => 'query', 'schema' => [ 'description' => '备份集所在的地域,指定后可返回某个具体地域的备份集,一次仅支持指定一个地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '返回信息,成功为success,错误返回错误码。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '1A6D328C-84B8-40DC-BF49-6C73984D7494', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'EndTime' => [ 'description' => '备份结束时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '1635706960956', ], 'Status' => [ 'description' => '备份集状态:'."\n" ."\n" .'- **0**: 备份中;'."\n" .'- **1**:备份成功;'."\n" .'- **2**:备份失败。', 'type' => 'integer', 'format' => 'int32', 'example' => '1', ], 'BackupSetSize' => [ 'description' => '备份集大小, 单位为byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '88803195', ], 'BackupSetId' => [ 'description' => '备份集ID。', 'type' => 'string', 'example' => '111', ], 'BackupType' => [ 'description' => '备份类型:'."\n" ."\n" .'- **0**:快速备份;'."\n" .'- **1**:一致性备份。', 'type' => 'integer', 'format' => 'int32', 'example' => '1', ], 'BeginTime' => [ 'description' => '备份开始时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '1635706960956', ], 'BackupModel' => [ 'description' => '备份模式:'."\n" ."\n" .'- **0**:自动备份;'."\n" .'- **1**:手动备份。', 'type' => 'integer', 'format' => 'int32', 'example' => '0', ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"1A6D328C-84B8-40DC-BF49-6C73984D7494\\",\\n \\"Success\\": true,\\n \\"Data\\": [\\n {\\n \\"EndTime\\": 1635706960956,\\n \\"Status\\": 1,\\n \\"BackupSetSize\\": 88803195,\\n \\"BackupSetId\\": \\"111\\",\\n \\"BackupType\\": 1,\\n \\"BeginTime\\": 1635706960956,\\n \\"BackupModel\\": 0\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n 1A6D328C-84B8-40DC-BF49-6C73984D7494\\n true\\n \\n 1635706960956\\n 1\\n 88803195\\n 111\\n 1\\n 1635706960956\\n 0\\n \\n","errorExample":""}]', 'title' => '查看备份集列表', 'summary' => '调用DescribeBackupSetList接口查看备份集列表。', ], 'DescribeBinaryLogList' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86238', 'abilityTreeNodes' => [ 'FEATUREdrdsAS582G', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'description' => '分页获取当前binlog列表时,需填写当前页码,默认从第1页开始。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'example' => '1', 'pattern' => '^\\d+$', 'default' => '1', ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '每页获取binlog数量,默认填写30。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '5', 'example' => '30', 'pattern' => '^\\d+$', 'default' => '30', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '当前实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hz1fds', ], ], [ 'name' => 'StartTime', 'in' => 'query', 'schema' => [ 'description' => '查询binlog列表开始时间。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2021-09-09 10:27:46', ], ], [ 'name' => 'EndTime', 'in' => 'query', 'schema' => [ 'description' => '查询binlog列表结束时间。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2021-11-09 10:27:46', ], ], [ 'name' => 'InstanceName', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], ], 'responses' => [ 200 => [ 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '2DFF784E-DC31-5BBC-9B25-9261CD9E0AA9', ], 'PageNumber' => [ 'description' => '当前查询的页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1', ], 'PageSize' => [ 'description' => '当前页显示的binlog数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '30', ], 'TotalNumber' => [ 'description' => '查询到的binlog文件总数。', 'type' => 'integer', 'format' => 'int32', 'example' => '100', ], 'LogList' => [ 'description' => 'binlog文件列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'EndTime' => [ 'description' => '当前binlog结束时间。', 'type' => 'string', 'example' => '2021-11-09 10:27:46', ], 'ModifiedTime' => [ 'description' => '最后更新时间。', 'type' => 'string', 'example' => '2021-11-09 10:27:46', ], 'UploadHost' => [ 'description' => '备份host。', 'type' => 'string', 'example' => '10.110.88.9', ], 'UploadStatus' => [ 'description' => '备份状态:'."\n" ."\n" .'- 0:未备份; '."\n" .'- 1:备份中; '."\n" .'- 2:已备份。', 'type' => 'integer', 'format' => 'int32', 'example' => '2', ], 'DownloadLink' => [ 'description' => '文件下载链接,2天内有效。', 'type' => 'string', 'example' => 'http://polarx-cdc-binlog-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/polardbx_cdc/pxc-hzfd132143sfds1/binlog.000001?Expires=1636469502&OSSAccessKeyId=LT13fds12dsafddsf&Signature=fdpm%bdsfadsa%2F%bdsafdsaf%3D', ], 'BeginTime' => [ 'description' => '日志开始时间。', 'type' => 'string', 'example' => '2021-09-09 10:27:46', ], 'LogSize' => [ 'description' => '当前日志文件大小。', 'type' => 'integer', 'format' => 'int64', 'example' => '536870912', ], 'FileName' => [ 'description' => 'binlog文件名称。', 'type' => 'string', 'example' => 'binlog.000001', ], 'CreatedTime' => [ 'description' => '文件创建时间。', 'type' => 'string', 'example' => '2021-09-09 10:27:46', ], 'PurgeStatus' => [ 'description' => '清理状态:'."\n" ."\n" .'- 0:未删除; '."\n" .'- 1:已删除。', 'type' => 'integer', 'format' => 'int32', 'example' => '0', ], 'Id' => [ 'description' => '当前记录的唯一ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '100', ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2DFF784E-DC31-5BBC-9B25-9261CD9E0AA9\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"TotalNumber\\": 100,\\n \\"LogList\\": [\\n {\\n \\"EndTime\\": \\"2021-11-09 10:27:46\\",\\n \\"ModifiedTime\\": \\"2021-11-09 10:27:46\\",\\n \\"UploadHost\\": \\"10.110.88.9\\",\\n \\"UploadStatus\\": 2,\\n \\"DownloadLink\\": \\"http://polarx-cdc-binlog-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/polardbx_cdc/pxc-hzfd132143sfds1/binlog.000001?Expires=1636469502&OSSAccessKeyId=LT13fds12dsafddsf&Signature=fdpm%bdsfadsa%2F%bdsafdsaf%3D\\",\\n \\"BeginTime\\": \\"2021-09-09 10:27:46\\",\\n \\"LogSize\\": 536870912,\\n \\"FileName\\": \\"binlog.000001\\",\\n \\"CreatedTime\\": \\"2021-09-09 10:27:46\\",\\n \\"PurgeStatus\\": 0,\\n \\"Id\\": 100\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 2DFF784E-DC31-5BBC-9B25-9261CD9E0AA9\\n 1\\n 30\\n 100\\n \\n 2021-11-09 10:27:46\\n 2021-11-09 10:27:46\\n 10.110.88.9\\n 2\\n http://polarx-cdc-binlog-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/polardbx_cdc/pxc-hzfd132143sfds1/binlog.000001?Expires=1636469502&OSSAccessKeyId=LT13fds12dsafddsf&Signature=fdpm%bdsfadsa%2F%bdsafdsaf%3D\\n 2021-09-09 10:27:46\\n 536870912\\n binlog.000001\\n 2021-09-09 10:27:46\\n 0\\n 100\\n \\n","errorExample":""}]', 'title' => '查询Binlog日志', 'summary' => '调用DescribeBinaryLogList接口查询Binlog日志。', 'description' => '- binlog文件默认保存15天。'."\n" .'- 返回的日志列表中包含日志记录结束时间在查询开始时间之后,并且日志记录开始时间在查询结束时间之前的所有日志。'."\n" .'- 当DownloadLink不为NULL时,用户可以根据此URL下载备份文件,此URL自生成后2天内有效,请在过期时间之前下载。', ], 'UpdateBackupPolicy' => [ 'methods' => [ 'post', 'get', 'put', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86292', 'abilityTreeNodes' => [ 'FEATUREdrds8KEOBF', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasdyuoo', ], ], [ 'name' => 'BackupPeriod', 'in' => 'query', 'schema' => [ 'description' => '备份周期。至少需要指定2天,7位数数值,从左到右每一位数值代表周一到周日是否开启备份。取值0代表不备份,取值1代表备份:'."\n" ."\n" .'- 第一位数值:周一'."\n" .'- 第二位数值:周二'."\n" .'- 第三位数值:周三'."\n" .'- 第四位数值:周四'."\n" .'- 第五位数值:周五'."\n" .'- 第六位数值:周六'."\n" .'- 第七位数值:周日'."\n", 'type' => 'string', 'required' => false, 'example' => '1001000', ], ], [ 'name' => 'BackupPlanBegin', 'in' => 'query', 'schema' => [ 'description' => '每天备份开启时间,UTC时间。', 'type' => 'string', 'required' => false, 'example' => '03:00Z', ], ], [ 'name' => 'BackupSetRetention', 'in' => 'query', 'schema' => [ 'description' => '备份集保留时间,单位天。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', ], ], [ 'name' => 'BackupType', 'in' => 'query', 'schema' => [ 'description' => '备份种类,目前只支持“0”,表示快速备份。', 'type' => 'string', 'required' => false, 'example' => '0', ], ], [ 'name' => 'BackupWay', 'in' => 'query', 'schema' => [ 'description' => '备份手段,枚举值'."\n" ."\n" .'- **P**:物理备份'."\n" .'- **L**:逻辑备份', 'type' => 'string', 'required' => false, 'example' => 'P', ], ], [ 'name' => 'ForceCleanOnHighSpaceUsage', 'in' => 'query', 'schema' => [ 'description' => '当实例总空间使用率超过80%或剩余空间不足50 GB时,是否强制清理Binlog。从最早的开始清理,直到总空间使用率降到80%以下且剩余空间大于50 GB。取值如下:'."\n" ."\n" .'- **1**:是'."\n" .'- **0**:否', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', ], ], [ 'name' => 'IsEnabled', 'in' => 'query', 'schema' => [ 'description' => '是否开启备份,固定值1,表示开启。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', ], ], [ 'name' => 'LocalLogRetention', 'in' => 'query', 'schema' => [ 'description' => '日志备份本地保留小时数, 范围为0到7×24小时, 0表示不保留,默认7小时。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '7', ], ], [ 'name' => 'RemoveLogRetention', 'in' => 'query', 'schema' => [ 'description' => '日志备份远程保留天数( 7~730) 单位天, 默认7天。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '7', ], ], [ 'name' => 'LogLocalRetentionSpace', 'in' => 'query', 'schema' => [ 'description' => '本地日志最大空间使用率,参数大小为0~50,此为循环空间,默认为30。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', ], ], [ 'name' => 'ColdDataBackupInterval', 'in' => 'query', 'schema' => [ 'description' => '冷数据备份间隔天数,取值范围为1~59。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', ], ], [ 'name' => 'ColdDataBackupRetention', 'in' => 'query', 'schema' => [ 'description' => '冷数据备份保留天数,取值范围为30~730。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', ], ], [ 'name' => 'LocalLogRetentionNumber', 'in' => 'query', 'schema' => [ 'description' => '本地Binlog保留个数,默认为60,取值范围为6~100。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '60', ], ], [ 'name' => 'IsCrossRegionDataBackupEnabled', 'in' => 'query', 'schema' => [ 'description' => '是否开启跨地域数据备份,默认为false。', 'type' => 'boolean', 'required' => false, 'example' => 'false', ], ], [ 'name' => 'IsCrossRegionLogBackupEnabled', 'in' => 'query', 'schema' => [ 'description' => '是否开启跨地域日志备份,默认为false。', 'type' => 'boolean', 'required' => false, 'example' => 'false', ], ], [ 'name' => 'DestCrossRegion', 'in' => 'query', 'schema' => [ 'description' => '跨地域备份的目标地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-shanghai', ], ], [ 'name' => 'CrossRegionDataBackupRetention', 'in' => 'query', 'schema' => [ 'description' => '跨地域数据备份的保存时间,单位:天。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', ], ], [ 'name' => 'CrossRegionLogBackupRetention', 'in' => 'query', 'schema' => [ 'description' => '跨地域日志备份的保存时间,单位:天。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '30', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '返回的策略详情。', 'type' => 'object', 'properties' => [ 'LogLocalRetentionSpace' => [ 'type' => 'integer', 'format' => 'int32', ], 'DBInstanceName' => [ 'type' => 'string', ], 'BackupWay' => [ 'type' => 'string', ], 'BackupPeriod' => [ 'type' => 'string', ], 'ForceCleanOnHighSpaceUsage' => [ 'type' => 'integer', 'format' => 'int32', ], 'BackupType' => [ 'type' => 'string', ], 'LocalLogRetention' => [ 'type' => 'integer', 'format' => 'int32', ], 'RemoveLogRetention' => [ 'type' => 'integer', 'format' => 'int32', ], 'BackupPlanBegin' => [ 'type' => 'string', ], 'BackupSetRetention' => [ 'type' => 'integer', 'format' => 'int32', ], 'IsEnabled' => [ 'type' => 'integer', 'format' => 'int32', ], 'ColdDataBackupInterval' => [ 'type' => 'integer', 'format' => 'int32', ], 'ColdDataBackupRetention' => [ 'type' => 'integer', 'format' => 'int32', ], 'LocalLogRetentionNumber' => [ 'type' => 'integer', 'format' => 'int32', ], 'IsCrossRegionDataBackupEnabled' => [ 'type' => 'boolean', ], 'IsCrossRegionLogBackupEnabled' => [ 'type' => 'boolean', ], 'DestCrossRegion' => [ 'type' => 'string', ], 'CrossRegionDataBackupRetention' => [ 'type' => 'integer', 'format' => 'int32', ], 'CrossRegionLogBackupRetention' => [ 'type' => 'integer', 'format' => 'int32', ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"LogLocalRetentionSpace\\": 0,\\n \\"DBInstanceName\\": \\"\\",\\n \\"BackupWay\\": \\"\\",\\n \\"BackupPeriod\\": \\"\\",\\n \\"ForceCleanOnHighSpaceUsage\\": 0,\\n \\"BackupType\\": \\"\\",\\n \\"LocalLogRetention\\": 0,\\n \\"RemoveLogRetention\\": 0,\\n \\"BackupPlanBegin\\": \\"\\",\\n \\"BackupSetRetention\\": 0,\\n \\"IsEnabled\\": 0,\\n \\"ColdDataBackupInterval\\": 0,\\n \\"ColdDataBackupRetention\\": 0,\\n \\"LocalLogRetentionNumber\\": 0,\\n \\"IsCrossRegionDataBackupEnabled\\": true,\\n \\"IsCrossRegionLogBackupEnabled\\": true,\\n \\"DestCrossRegion\\": \\"\\",\\n \\"CrossRegionDataBackupRetention\\": 0,\\n \\"CrossRegionLogBackupRetention\\": 0\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n true\\n \\n 30\\n pxc-hzjasdyuoo\\n P\\n 1001000\\n 1\\n 0\\n 7\\n 7\\n 03:00Z\\n 30\\n 1\\n 30\\n 30\\n 60\\n false\\n false\\n cn-shanghai\\n 30\\n 30\\n \\n","errorExample":""}]', 'title' => '修改实例备份策略', 'summary' => '调用UpdateBackupPolicy接口修改实例备份策略。', ], 'DescribeOpenBackupSet' => [ 'summary' => '开放商业备份集的实例拓扑信息和下载链接,满足线下恢复云上实例的需要。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '245672', 'abilityTreeNodes' => [ 'FEATUREdrdsBRC5LQ', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'RestoreTime', 'in' => 'query', 'schema' => [ 'description' => '实例所需恢复的时间点,格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。', 'type' => 'string', 'required' => false, 'example' => '2024-10-14T00:00:00Z', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], 'Data' => [ 'description' => '一个包含实例拓扑信息和备份集下载链接的结构体。'."\n" .'> canBinlogRecoverToTimeUTC 字段表示该备份集所能恢复到的时间点,该时间点在输入参数RestoreTime附近。由于存在DN有最近的本地binlog还没上传的情况,不保证能恢复到所希望的时间点。', 'type' => 'any', 'example' => '{"gmsBackupSet": {"pubFullDownloadUrl": "https://xxxxx","dnName": "pxc-xdb-m-xxxxxx","hostInstanceId": 0001,"binlogs": [],"backupEndTime": "2024-10-21T10:11:56Z","backupLinkExpiredTime": "2024-10-23T06:13:54Z","dnBackupSetId": "00088","notCompletedBinlogs": [],"commitIndex": "15249275","innerFullDownloadUrl": "http://xxxxx","backupStartTime": "2024-10-21T10:09:20Z","backupSetSize": 526118912},"dnBackupSets": [],"insName": "pxc-xxxxx","backupSetId": "cb-xxxxx","canBinlogRecoverToTime": 1729567925000,"backupEndTime": "2024-10-21T10:12:16Z","canBinlogRecoverToTimeUTC": "2024-10-22T03:32:05Z","canBackupMinRecoverToTimeUTC": "2024-10-21T10:11:56Z","pitrInvalid": false,"backupStartTime": "2024-10-21T10:09:16Z","canBackupMinRecoverToTime": 1729505516000}', ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\",\\n \\"Data\\": \\"{\\\\\\"gmsBackupSet\\\\\\": {\\\\\\"pubFullDownloadUrl\\\\\\": \\\\\\"https://xxxxx\\\\\\",\\\\\\"dnName\\\\\\": \\\\\\"pxc-xdb-m-xxxxxx\\\\\\",\\\\\\"hostInstanceId\\\\\\": 0001,\\\\\\"binlogs\\\\\\": [],\\\\\\"backupEndTime\\\\\\": \\\\\\"2024-10-21T10:11:56Z\\\\\\",\\\\\\"backupLinkExpiredTime\\\\\\": \\\\\\"2024-10-23T06:13:54Z\\\\\\",\\\\\\"dnBackupSetId\\\\\\": \\\\\\"00088\\\\\\",\\\\\\"notCompletedBinlogs\\\\\\": [],\\\\\\"commitIndex\\\\\\": \\\\\\"15249275\\\\\\",\\\\\\"innerFullDownloadUrl\\\\\\": \\\\\\"http://xxxxx\\\\\\",\\\\\\"backupStartTime\\\\\\": \\\\\\"2024-10-21T10:09:20Z\\\\\\",\\\\\\"backupSetSize\\\\\\": 526118912},\\\\\\"dnBackupSets\\\\\\": [],\\\\\\"insName\\\\\\": \\\\\\"pxc-xxxxx\\\\\\",\\\\\\"backupSetId\\\\\\": \\\\\\"cb-xxxxx\\\\\\",\\\\\\"canBinlogRecoverToTime\\\\\\": 1729567925000,\\\\\\"backupEndTime\\\\\\": \\\\\\"2024-10-21T10:12:16Z\\\\\\",\\\\\\"canBinlogRecoverToTimeUTC\\\\\\": \\\\\\"2024-10-22T03:32:05Z\\\\\\",\\\\\\"canBackupMinRecoverToTimeUTC\\\\\\": \\\\\\"2024-10-21T10:11:56Z\\\\\\",\\\\\\"pitrInvalid\\\\\\": false,\\\\\\"backupStartTime\\\\\\": \\\\\\"2024-10-21T10:09:16Z\\\\\\",\\\\\\"canBackupMinRecoverToTime\\\\\\": 1729505516000}\\"\\n}","errorExample":""},{"type":"xml","example":"\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n {\\"gmsBackupSet\\": {\\"pubFullDownloadUrl\\": \\"https://xxxxx\\",\\"dnName\\": \\"pxc-xdb-m-xxxxxx\\",\\"hostInstanceId\\": 0001,\\"binlogs\\": [],\\"backupEndTime\\": \\"2024-10-21T10:11:56Z\\",\\"backupLinkExpiredTime\\": \\"2024-10-23T06:13:54Z\\",\\"dnBackupSetId\\": \\"00088\\",\\"notCompletedBinlogs\\": [],\\"commitIndex\\": \\"15249275\\",\\"innerFullDownloadUrl\\": \\"http://xxxxx\\",\\"backupStartTime\\": \\"2024-10-21T10:09:20Z\\",\\"backupSetSize\\": 526118912},\\"dnBackupSets\\": [],\\"insName\\": \\"pxc-xxxxx\\",\\"backupSetId\\": \\"cb-xxxxx\\",\\"canBinlogRecoverToTime\\": 1729567925000,\\"backupEndTime\\": \\"2024-10-21T10:12:16Z\\",\\"canBinlogRecoverToTimeUTC\\": \\"2024-10-22T03:32:05Z\\",\\"canBackupMinRecoverToTimeUTC\\": \\"2024-10-21T10:11:56Z\\",\\"pitrInvalid\\": false,\\"backupStartTime\\": \\"2024-10-21T10:09:16Z\\",\\"canBackupMinRecoverToTime\\": 1729505516000}\\n","errorExample":""}]', 'title' => '获取用于线下恢复的备份集信息', 'responseParamsDescription' => '>PolarDB-X开源版的备份集导入工具将使用Data字段中结构体,把备份集导入成开源版恢复所需要的结构。', ], 'DescribeBackupSet' => [ 'summary' => '调用DescribeBackupSet接口查看备份集详情。', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '135043', 'abilityTreeNodes' => [ 'FEATUREdrdsE1M93A', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'title' => 'polardb-x实例名', 'description' => 'PolarDB-X实例名称。', 'type' => 'string', 'required' => true, 'example' => 'pxc-htri0ori2r****', ], ], [ 'name' => 'BackupSetId', 'in' => 'query', 'schema' => [ 'title' => '备份集ID', 'description' => '备份集ID。', 'type' => 'string', 'required' => true, 'example' => '111', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'title' => '区域', 'description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DestCrossRegion', 'in' => 'query', 'schema' => [ 'description' => '跨地域备份的目标地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-shanghai', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '错误信息。', 'type' => 'string', 'example' => 'successs', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '1A6D328C-84B8-40DC-BF49-6C73984D7494', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '数据列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'EndTime' => [ 'title' => '备份结束时间', 'description' => '备份结束时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '1650251308000', ], 'Status' => [ 'title' => '状态', 'description' => '备份集状态:'."\n" ."\n" .'- **0**: 备份中;'."\n" .'- **1**:备份成功;'."\n" .'- **2**:备份失败。', 'type' => 'integer', 'format' => 'int32', 'example' => '1', ], 'BackupSetSize' => [ 'title' => '备份集大小', 'description' => '备份集大小, 单位为byte。'."\n" ."\n", 'type' => 'integer', 'format' => 'int64', 'example' => '88803195', ], 'BackupSetId' => [ 'title' => '备份集ID', 'description' => '备份集ID。'."\n" ."\n", 'type' => 'integer', 'format' => 'int64', 'example' => '111', ], 'BackupType' => [ 'title' => '备份类型', 'description' => '备份类型:'."\n" ."\n" .'- **0**:快速备份;'."\n" .'- **1**:一致性备份。', 'type' => 'integer', 'format' => 'int32', 'example' => '1', ], 'BeginTime' => [ 'title' => '备份开始时间', 'description' => '备份开始时间。'."\n" ."\n", 'type' => 'integer', 'format' => 'int64', 'example' => '1650250861754', ], 'BackupModel' => [ 'title' => '备份模式', 'description' => '备份模式:'."\n" ."\n" .'- **0**:自动备份;'."\n" .'- **1**:手动备份。', 'type' => 'integer', 'format' => 'int32', 'example' => '0', ], 'OSSList' => [ 'description' => '备份集OSS信息列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'BackupSetFile' => [ 'title' => 'OSS 文件名', 'description' => 'OSS文件名。', 'type' => 'string', 'example' => 'hins3084_data_20220418110623_qp.xb', ], 'LinkExpiredTime' => [ 'title' => '过期时间', 'description' => 'OSS文件链接过期时间。', 'type' => 'string', 'example' => '2022-04-20T08:01:37Z', ], 'IntranetDownloadLink' => [ 'title' => '内网OSS 下载地址', 'description' => '内网OSS下载地址。', 'type' => 'string', 'example' => 'http://pre-rdsbak-cn-beijing.oss-cn-beijing-internal.aliyuncs.com/custins2255/hins3084_data_20220418110623_qp.xb?', ], 'DownloadLink' => [ 'title' => '外网下载地址', 'description' => '外网下载地址。', 'type' => 'string', 'example' => 'https://pre-rdsbak-cn-xxx.oss-cn-beijing.aliyuncs.com/custins2255/hins3084_data_20220418110623_qp.xb?OSSAccessKeyId=LTAI****************&Expires=1650441697&dd=7KJzkUSbXf6dwy', ], ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"successs\\",\\n \\"RequestId\\": \\"1A6D328C-84B8-40DC-BF49-6C73984D7494\\",\\n \\"Success\\": true,\\n \\"Data\\": [\\n {\\n \\"EndTime\\": 1650251308000,\\n \\"Status\\": 1,\\n \\"BackupSetSize\\": 88803195,\\n \\"BackupSetId\\": 111,\\n \\"BackupType\\": 1,\\n \\"BeginTime\\": 1650250861754,\\n \\"BackupModel\\": 0,\\n \\"OSSList\\": [\\n {\\n \\"BackupSetFile\\": \\"hins3084_data_20220418110623_qp.xb\\",\\n \\"LinkExpiredTime\\": \\"2022-04-20T08:01:37Z\\",\\n \\"IntranetDownloadLink\\": \\"http://pre-rdsbak-cn-beijing.oss-cn-beijing-internal.aliyuncs.com/custins2255/hins3084_data_20220418110623_qp.xb?\\",\\n \\"DownloadLink\\": \\"https://pre-rdsbak-cn-xxx.oss-cn-beijing.aliyuncs.com/custins2255/hins3084_data_20220418110623_qp.xb?OSSAccessKeyId=LTAI****************&Expires=1650441697&dd=7KJzkUSbXf6dwy\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n successs\\n 1A6D328C-84B8-40DC-BF49-6C73984D7494\\n true\\n \\n 1650251308000\\n 1\\n 88803195\\n 111\\n 1\\n 1650250861754\\n 0\\n \\n hins3084_data_20220418110623_qp.xb\\n 2022-04-20T08:01:37Z\\n http://pre-rdsbak-cn-beijing.oss-cn-beijing-internal.aliyuncs.com/custins2255/hins3084_data_20220418110623_qp.xb?\\n https://pre-rdsbak-cn-xxx.oss-cn-beijing.aliyuncs.com/custins2255/hins3084_data_20220418110623_qp.xb?OSSAccessKeyId=LTAI****************&Expires=1650441697&dd=7KJzkUSbXf6dwy\\n \\n \\n","errorExample":""}]', 'title' => 'DescribeBackupSet', ], 'UpdateDBInstanceTDE' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86295', 'abilityTreeNodes' => [ 'FEATUREdrds9HBOA5', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'TDEStatus', 'in' => 'query', 'schema' => [ 'description' => '开启,固定取值1。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'docRequired' => true, 'example' => '1', ], ], [ 'name' => 'EncryptionKey', 'in' => 'query', 'schema' => [ 'description' => '自定义密钥ID时传入。也可以不传入使用后端自动生成。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'RkVBNURDMjAtNkQ4QS01OTc5LTk3QUEtRkM1NzU0Nk******', ], ], [ 'name' => 'RoleArn', 'in' => 'query', 'schema' => [ 'description' => '角色的全局资源描述符,用来指定具体角色。详情请参见RAM角色概览。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'acs:ram::1406926****:role/aliyunrdsinstanceencryptiondefaultrole', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], 'Data' => [ 'description' => '返回信息。', 'type' => 'object', 'properties' => [ 'TaskId' => [ 'description' => '后端任务ID。', 'type' => 'string', 'example' => '42292****', ], ], ], ], ], ], ], 'errorCodes' => [ 403 => [ [ 'errorCode' => 'IncorrectEngineVersion', 'errorMessage' => 'The current engine version does not support the operation.', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\",\\n \\"Data\\": {\\n \\"TaskId\\": \\"42292****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n \\n 42292****\\n \\n","errorExample":""}]', 'title' => '开启实例TDE', 'summary' => '调用UpdateDBInstanceTDE接口开启实例TDE。', ], 'ModifySecurityIps' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'GroupName', 'in' => 'query', 'schema' => [ 'description' => '实例的白名单分组名称。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'default', ], ], [ 'name' => 'SecurityIPList', 'in' => 'query', 'schema' => [ 'description' => '白名单分组里的IP列表,多个IP白名单间用英文逗号(,)分隔。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '127.0.0.1,192.168.0.0', ], ], [ 'name' => 'ModifyMode', 'in' => 'query', 'schema' => [ 'description' => '白名单修改模式,取值范围如下:'."\n" ."\n" .'- 0:覆盖修改白名单分组;'."\n" .'- 1:新增白名单分组;'."\n" .'- 2:删除白名单分组。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '1', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '请求返回信息,正确显示success,错误显示错误码。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n true\\n","errorExample":""}]', 'title' => '修改实例白名单', 'summary' => '调用ModifySecurityIps接口修改实例白名单。', ], 'DescribeUserEncryptionKeyList' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86265', 'abilityTreeNodes' => [ 'FEATUREdrds9HBOA5', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => false, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], 'Data' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ 'KeyIds' => [ 'description' => '密钥列表。', 'type' => 'array', 'items' => [ 'description' => '用户密钥。', 'type' => 'string', 'example' => 'RkVBNURDMjAtNkQ4QS01OTc5LTk3QUEtRkM1NzU0Nk******', ], ], ], ], ], ], ], ], 'errorCodes' => [ 403 => [ [ 'errorCode' => 'IncorrectEngineVersion', 'errorMessage' => 'The current engine version does not support the operation.', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\",\\n \\"Data\\": {\\n \\"KeyIds\\": [\\n \\"RkVBNURDMjAtNkQ4QS01OTc5LTk3QUEtRkM1NzU0Nk******\\"\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n \\n RkVBNURDMjAtNkQ4QS01OTc5LTk3QUEtRkM1NzU0Nk******\\n \\n","errorExample":""}]', 'title' => '获取用户TDE秘钥列表', 'summary' => '调用DescribeUserEncryptionKeyList接口获取用户TDE秘钥列表。', ], 'DescribeSecurityIps' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '接口额外返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '14036EBE-CF2E-44DB-ACE9-AC6157D3A6FC', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ 'DBInstanceName' => [ 'description' => '实例名称。', 'type' => 'string', 'example' => 'pxc-hzjasd****', ], 'GroupItems' => [ 'description' => '白名单分组列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'GroupName' => [ 'description' => '白名单分组名称。', 'type' => 'string', 'example' => 'defaultGroup', ], 'SecurityIPList' => [ 'description' => '分组白名单详情。', 'type' => 'string', 'example' => '127.0.0.1,172.168.0.0', ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"14036EBE-CF2E-44DB-ACE9-AC6157D3A6FC\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"DBInstanceName\\": \\"pxc-hzjasd****\\",\\n \\"GroupItems\\": [\\n {\\n \\"GroupName\\": \\"defaultGroup\\",\\n \\"SecurityIPList\\": \\"127.0.0.1,172.168.0.0\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n 14036EBE-CF2E-44DB-ACE9-AC6157D3A6FC\\n true\\n \\n pxc-hzjasd****\\n \\n defaultGroup\\n 127.0.0.1,172.168.0.0\\n \\n \\n","errorExample":""}]', 'title' => '查看实例白名单信息', 'summary' => '调用DescribeSecurityIps接口查看实例白名单。', ], 'CheckCloudResourceAuthorized' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86218', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域的ID。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'RoleArn', 'in' => 'query', 'schema' => [ 'description' => '指定已授权角色的全局资源描述符ARN(Alibaba Cloud Resource Name)信息,完成该角色的授权后即可使用相关密钥管理服务,格式:acs:ram::$accountID:role/$roleName 。'."\n" ."\n" .'- $accountID:云账号ID。您可以登录阿里云控制台,将鼠标悬停在右上角头像的位置,单击安全设置进行查看。'."\n" .'- $roleName:RAM角色名称,取值固定为:AliyunRdsInstanceEncryptionDefaultRole。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'acs:ram::123456789012****:role/AliyunRdsInstanceEncryptionDefaultRole', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。'."\n" ."\n", 'type' => 'string', 'example' => 'A501A191-BD70-5E50-98A9-C2A486A82****', ], 'Data' => [ 'description' => '返回体。', 'type' => 'object', 'properties' => [ 'AuthorizationState' => [ 'description' => '授权状态,包括如下返回值:'."\n" ."\n" .'- **0**:未授权;'."\n" .'- **1**:已授权;'."\n" .'- **2**:未开通密钥管理服务。', 'type' => 'string', 'example' => '0', ], 'RoleArn' => [ 'description' => '指定已授权角色的全局资源描述符ARN(Alibaba Cloud Resource Name)信息,完成该角色的授权后即可使用相关密钥管理服务,格式:acs:ram::$accountID:role/$roleName 。', 'type' => 'string', 'example' => 'acs:ram::123456789012****:role/AliyunRdsInstanceEncryptionDefaultRole', ], ], ], ], ], ], ], 'errorCodes' => [ 403 => [ [ 'errorCode' => 'IncorrectEngineVersion', 'errorMessage' => 'The current engine version does not support the operation.', ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A501A191-BD70-5E50-98A9-C2A486A82****\\",\\n \\"Data\\": {\\n \\"AuthorizationState\\": \\"0\\",\\n \\"RoleArn\\": \\"acs:ram::123456789012****:role/AliyunRdsInstanceEncryptionDefaultRole\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n A501A191-BD70-5E50-98A9-C2A486A82****\\n \\n 0\\n acs:ram::123456789012****:role/AliyunRdsInstanceEncryptionDefaultRole\\n \\n","errorExample":""}]', 'title' => 'KMS秘钥授权校验', 'summary' => '调用CheckCloudResourceAuthorized接口查询PolarDB-X实例是否已被授权使用KMS密钥服务。', ], 'EnableRightsSeparation' => [ 'summary' => '打开三权分立。', 'methods' => [ 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86271', 'abilityTreeNodes' => [ 'FEATUREdrdsUFZO07', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-htri0ori2r4k9p', ], ], [ 'name' => 'SecurityAccountName', 'in' => 'query', 'schema' => [ 'description' => '安全管理员账号。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'account_sec', ], ], [ 'name' => 'SecurityAccountPassword', 'in' => 'query', 'schema' => [ 'description' => '安全管理员密码。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '*****', ], ], [ 'name' => 'SecurityAccountDescription', 'in' => 'query', 'schema' => [ 'description' => '安全管理员账号描述。', 'type' => 'string', 'required' => false, 'example' => 'test123', ], ], [ 'name' => 'AuditAccountName', 'in' => 'query', 'schema' => [ 'description' => '审计员账号名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'account_audit', ], ], [ 'name' => 'AuditAccountPassword', 'in' => 'query', 'schema' => [ 'description' => '审计员账号密码。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '******', ], ], [ 'name' => 'AuditAccountDescription', 'in' => 'query', 'schema' => [ 'description' => '审计员账号描述。', 'type' => 'string', 'required' => false, 'example' => 'test123', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '唯一请求ID。', 'type' => 'string', 'example' => '73559800-3c8c-11ec-bd40-99cfcff3fe1e', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"73559800-3c8c-11ec-bd40-99cfcff3fe1e\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n 73559800-3c8c-11ec-bd40-99cfcff3fe1e\\n true\\n","errorExample":""}]', 'title' => 'EnableRightsSeparation', ], 'DisableRightsSeparation' => [ 'methods' => [ 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86266', 'abilityTreeNodes' => [ 'FEATUREdrdsUFZO07', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hanghzou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '数据库实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-sprcym7g7w****', ], ], [ 'name' => 'DbaAccountName', 'in' => 'query', 'schema' => [ 'description' => 'dba账号名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'account_1', ], ], [ 'name' => 'DbaAccountPassword', 'in' => 'query', 'schema' => [ 'description' => 'dba账号密码。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '唯一请求ID。', 'type' => 'string', 'example' => 'FE5D94E3-3C93-3594-95D9-AAED2A980915', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"FE5D94E3-3C93-3594-95D9-AAED2A980915\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n FE5D94E3-3C93-3594-95D9-AAED2A980915\\n true\\n","errorExample":""}]', 'title' => 'DisableRightsSeparation', 'summary' => '关闭三权分立。', ], 'ResetAccountPassword' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-htri0ori2r4k9p', ], ], [ 'name' => 'AccountName', 'in' => 'query', 'schema' => [ 'description' => '账号名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'account', ], ], [ 'name' => 'AccountPassword', 'in' => 'query', 'schema' => [ 'description' => '账号密码。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '*****', ], ], [ 'name' => 'SecurityAccountName', 'in' => 'query', 'schema' => [ 'description' => '安全管理员账号。', 'type' => 'string', 'required' => false, 'example' => 'account_sec', ], ], [ 'name' => 'SecurityAccountPassword', 'in' => 'query', 'schema' => [ 'description' => '安全管理员密码。', 'type' => 'string', 'required' => false, 'example' => '*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '唯一请求ID。', 'type' => 'string', 'example' => '73559800-3c8c-11ec-bd40-99cfcff3fe1e', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"73559800-3c8c-11ec-bd40-99cfcff3fe1e\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n 73559800-3c8c-11ec-bd40-99cfcff3fe1e\\n true\\n","errorExample":""}]', 'title' => 'ResetAccountPassword', 'summary' => '重置账号密码。', ], 'CreateAccount' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-**************', ], ], [ 'name' => 'AccountName', 'in' => 'query', 'schema' => [ 'description' => '待创建的账号名。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'testAccount', ], ], [ 'name' => 'AccountPassword', 'in' => 'query', 'schema' => [ 'description' => '待创建账号的账号密码。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'Test@1111', ], ], [ 'name' => 'DBName', 'in' => 'query', 'schema' => [ 'description' => '授权数据库名。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'testdb', ], ], [ 'name' => 'AccountPrivilege', 'in' => 'query', 'schema' => [ 'description' => '给新创建的账号授权某数据库的权限,包括:'."\n" ."\n" .'- ReadWrite'."\n" .'- ReadOnly'."\n" .'- DMLOnly'."\n" .'- DDLOnly', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'ReadWrite', ], ], [ 'name' => 'AccountDescription', 'in' => 'query', 'schema' => [ 'description' => '账号描述信息。', 'type' => 'string', 'required' => false, 'example' => 'test', ], ], [ 'name' => 'SecurityAccountName', 'in' => 'query', 'schema' => [ 'description' => '安全管理员账号名称。'."\n" ."\n" .'> 若已开启三权分立模式,该参数必填,未开启三权分立可以不填。', 'type' => 'string', 'required' => false, 'example' => 'securityAccount', ], ], [ 'name' => 'SecurityAccountPassword', 'in' => 'query', 'schema' => [ 'description' => '安全管理员账号密码。'."\n" ."\n" .'> 若已开启三权分立模式,该参数必填,未开启三权分立可以不填。', 'type' => 'string', 'required' => false, 'example' => 'securityPassword', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '成功为空,失败为报错信息。', 'type' => 'string', 'example' => '****', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"****\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n ****\\n 9B2F3840-5C98-475C-B269-2D5C3A31797C\\n true\\n","errorExample":""}]', 'title' => '创建普通账号', 'summary' => '调用CreateAccount接口创建账号。', ], 'CreateSuperAccount' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-************', ], ], [ 'name' => 'AccountName', 'in' => 'query', 'schema' => [ 'description' => '账号名。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'dba', ], ], [ 'name' => 'AccountPassword', 'in' => 'query', 'schema' => [ 'description' => '账号密码。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'testdbapassword', ], ], [ 'name' => 'AccountDescription', 'in' => 'query', 'schema' => [ 'description' => '账号描述。', 'type' => 'string', 'required' => false, 'example' => 'testdbadescription', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '成功为空,失败返回错误信息。', 'type' => 'string', 'example' => '*****', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"*****\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n *****\\n 9B2F3840-5C98-475C-B269-2D5C3A31797C\\n true\\n","errorExample":""}]', 'title' => '创建高权限账号', 'summary' => '调用CreateSuperAccount接口创建高权限账号,一个实例只能有一个高权限账号。', ], 'DeleteAccount' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86232', 'abilityTreeNodes' => [ 'FEATUREdrds0ML0VG', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-*********', ], ], [ 'name' => 'AccountName', 'in' => 'query', 'schema' => [ 'description' => '删除的账号名。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'testaccount', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'SecurityAccountName', 'in' => 'query', 'schema' => [ 'description' => '安全管理员账号名称。'."\n" ."\n" .'> 若已开启三权分立模式,该参数必填,未开启三权分立可以不填。', 'type' => 'string', 'required' => false, 'example' => 'securityAccount', ], ], [ 'name' => 'SecurityAccountPassword', 'in' => 'query', 'schema' => [ 'description' => '安全管理员账号密码。'."\n" ."\n" .'> 若已开启三权分立模式,该参数必填,未开启三权分立可以不填。', 'type' => 'string', 'required' => false, 'example' => 'securityPassword', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '成功为空,失败返回错误信息。', 'type' => 'string', 'example' => '****', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"****\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n ****\\n 9B2F3840-5C98-475C-B269-2D5C3A31797C\\n true\\n","errorExample":""}]', 'title' => '删除实例账号', 'summary' => '调用DeleteAccount接口删除账号。', ], 'DescribeAccountList' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'AccountName', 'in' => 'query', 'schema' => [ 'description' => '账号名称,需要查询某个账号时输入。', 'type' => 'string', 'required' => false, 'example' => 'testaccount', ], ], [ 'name' => 'AccountType', 'in' => 'query', 'schema' => [ 'description' => '账号类型,需要查询某类账号时输入,null返回所有账号。'."\n" ."\n" .'- 开启三权分立前:0代表普通账号,1代表高权限账号;'."\n" .'- 开启三权分立后,0代表普通账号,2代表系统管理员账号,3代表安全管理员账号,4代表审计管理员账号。', 'type' => 'string', 'required' => false, 'example' => '0', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'GmtCreated' => [ 'description' => '账号创建时间.', 'type' => 'string', 'example' => '2012-06-08T15:00Z', ], 'DBInstanceName' => [ 'description' => '实例名称。', 'type' => 'string', 'example' => 'pxc-*********', ], 'AccountDescription' => [ 'description' => '账号描述。', 'type' => 'string', 'example' => 'testaccount desc', ], 'DBName' => [ 'description' => '账号被授予权限的数据库。', 'type' => 'string', 'example' => 'testdb', ], 'AccountPrivilege' => [ 'description' => '账号被授予的权限。', 'type' => 'string', 'example' => 'ReadWrite', ], 'AccountType' => [ 'description' => '账号类型。'."\n" ."\n" .'- 开启三权分立前:0代表普通账号,1代表高权限账号;'."\n" .'- 开启三权分立后,0代表普通账号,2代表系统管理员账号,3代表安全管理员账号,4代表审计管理员账号。', 'type' => 'string', 'example' => '0', ], 'AccountName' => [ 'description' => '账号名称。', 'type' => 'string', 'example' => 'testAccount', ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"Success\\": true,\\n \\"Data\\": [\\n {\\n \\"GmtCreated\\": \\"2012-06-08T15:00Z\\",\\n \\"DBInstanceName\\": \\"pxc-*********\\",\\n \\"AccountDescription\\": \\"testaccount desc\\",\\n \\"DBName\\": \\"testdb\\",\\n \\"AccountPrivilege\\": \\"ReadWrite\\",\\n \\"AccountType\\": \\"0\\",\\n \\"AccountName\\": \\"testAccount\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n 9B2F3840-5C98-475C-B269-2D5C3A31797C\\n true\\n \\n 2012-06-08T15:00Z\\n pxc-*********\\n testaccount desc\\n testdb\\n ReadWrite\\n 0\\n testAccount\\n \\n","errorExample":""}]', 'title' => '查询实例账号信息', 'summary' => '调用DescribeAccountList接口获取账号列表。', ], 'ModifyAccountDescription' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86275', 'abilityTreeNodes' => [ 'FEATUREdrdsJGJ3OD', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'AccountName', 'in' => 'query', 'schema' => [ 'description' => '实例账号名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'account', ], ], [ 'name' => 'AccountDescription', 'in' => 'query', 'schema' => [ 'description' => '账号描述。', 'type' => 'string', 'required' => false, 'example' => '测试账号', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '接口额外返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'msg', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"msg\\",\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n msg\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n true\\n","errorExample":""}]', 'title' => '修改实例的账号描述信息', 'summary' => '调用ModifyAccountDescription接口修改账号备注描述。', ], 'ResetAccountPasswordRestrict' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86288', 'abilityTreeNodes' => [ 'FEATUREdrds0ML0VG', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域id。>您可以通过[describeregions](~~98041~~)接口查看可用地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例id。>您可以调用[describedbinstances](~~196830~~)接口查看目标地域下所有实例的详情,包括实例id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'AccountName', 'in' => 'query', 'schema' => [ 'description' => '需要重置密码的账号名称。>仅支持重置普通账号的密码。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'testaccount', ], ], [ 'name' => 'AccountPassword', 'in' => 'query', 'schema' => [ 'description' => '需要重置密码的账号信息,多个账号信息间用英文逗号(,)隔开。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '*****', ], ], [ 'name' => 'SecurityAccountName', 'in' => 'query', 'schema' => [ 'description' => '需要重置密码的账号名称。>*仅支持重置普通账号的密码。*您可以调用[describeaccountlist](~~196844~~)接口查看目标实例的账号信息,包括账号名称', 'type' => 'string', 'required' => false, 'example' => 'account_sec', ], ], [ 'name' => 'SecurityAccountPassword', 'in' => 'query', 'schema' => [ 'description' => '安全管理员账号的密码。>若已开启三权分立模式,该参数必填。更多关于三权分置模式的信息,请参见[三权分立](~~213824~~)。', 'type' => 'string', 'required' => false, 'example' => '*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '调用结果的附加信息。', 'type' => 'string', 'example' => '*****', ], 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '9B2F3840-5C98-****-B269-2D5C3A31797C', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"*****\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-****-B269-2D5C3A31797C\\",\\n \\"Success\\": true\\n}","type":"json"}]', 'title' => '重置账号密码', 'summary' => '重置账号密码。', 'description' => '****', ], 'ModifyAccountPrivilege' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-htri0ori2r4k9p', ], ], [ 'name' => 'AccountName', 'in' => 'query', 'schema' => [ 'description' => '账号名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'account_sec', ], ], [ 'name' => 'DbName', 'in' => 'query', 'schema' => [ 'description' => '数据库名称。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'sbtest', ], ], [ 'name' => 'AccountPrivilege', 'in' => 'query', 'schema' => [ 'description' => '账号权限,取值如下:'."\n" ."\n" .'- **ReadWrite**'."\n" .'- **ReadOnly**'."\n" .'- **DMLOnly**'."\n" .'- **DDLOnly**', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'ReadWrite', ], ], [ 'name' => 'SecurityAccountName', 'in' => 'query', 'schema' => [ 'description' => '安全管理员账号名称。', 'type' => 'string', 'required' => false, 'example' => 'account_audit', ], ], [ 'name' => 'SecurityAccountPassword', 'in' => 'query', 'schema' => [ 'description' => '安全管理员账号密码。', 'type' => 'string', 'required' => false, 'example' => '*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '唯一请求ID。', 'type' => 'string', 'example' => '73559800-3c8c-11ec-bd40-99cfcff3fe1e', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"73559800-3c8c-11ec-bd40-99cfcff3fe1e\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n 73559800-3c8c-11ec-bd40-99cfcff3fe1e\\n true\\n","errorExample":""}]', 'title' => 'ModifyAccountPrivilege', 'summary' => '修改普通账号的权限。', ], 'DescribeRegions' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '86259', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Code' => [ 'description' => ' 错误代码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200', ], 'Message' => [ 'description' => ' 错误信息。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'ErrorCode' => [ 'description' => '错误代码。', 'type' => 'integer', 'format' => 'int32', 'example' => '200', ], 'Regions' => [ 'type' => 'object', 'itemNode' => true, 'properties' => [ 'Region' => [ 'description' => '区域列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'SupportPolarx10' => [ 'description' => '支持polardb-x 1.0版本。', 'type' => 'boolean', 'example' => 'true', ], 'SupportPolarx20' => [ 'description' => '支持polardb-x 2.0版本。', 'type' => 'boolean', 'example' => 'true', ], 'RegionId' => [ 'description' => '实例ID。', 'type' => 'string', 'example' => 'ch-hangzhou', ], 'Zones' => [ 'type' => 'object', 'itemNode' => true, 'properties' => [ 'Zone' => [ 'description' => '可用区列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'ZoneId' => [ 'description' => '可用区。', 'type' => 'string', 'example' => 'cn-hangzhou-a', ], 'VpcEnabled' => [ 'description' => '是否支持vpc。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Success\\": true,\\n \\"ErrorCode\\": 200,\\n \\"Regions\\": {\\n \\"Region\\": [\\n {\\n \\"SupportPolarx10\\": true,\\n \\"SupportPolarx20\\": true,\\n \\"RegionId\\": \\"ch-hangzhou\\",\\n \\"Zones\\": {\\n \\"Zone\\": [\\n {\\n \\"ZoneId\\": \\"cn-hangzhou-a\\",\\n \\"VpcEnabled\\": true\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n success\\n C458B1E8-1683-3645-B154-6BA32080EEA\\n true\\n 200\\n \\n true\\n true\\n ch-hangzhou\\n \\n cn-hangzhou-a\\n true\\n \\n \\n","errorExample":""}]', 'title' => '查看可选的地域和可用区', 'summary' => '调用DescribeRegions接口获取地域列表。', ], 'MigrateDBInstance' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '172659', 'abilityTreeNodes' => [ 'FEATUREdrds7CT80F', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'SwitchMode', 'in' => 'query', 'schema' => [ 'description' => '切换模式。取值:'."\n" ."\n" .'- 0:立即切换。'."\n" .'- 1:在可运维时间段内切换。', 'type' => 'string', 'required' => false, 'example' => '0', 'default' => '0', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'pxc-xxx', ], ], [ 'name' => 'TopologyType', 'in' => 'query', 'schema' => [ 'description' => '拓扑类型:'."\n" ."\n" .'- **3azones**:三可用区;'."\n" .'- **1azone**:单可用区。', 'type' => 'string', 'required' => true, 'example' => '3azones', ], ], [ 'name' => 'PrimaryZoneId', 'in' => 'query', 'schema' => [ 'description' => '多可用区实例,主可用区的可用区ID。**如果需要创建多可用区实例,该参数必填。**', 'type' => 'string', 'required' => true, 'example' => 'cn-zhangjiakou-b', ], ], [ 'name' => 'SecondaryZoneId', 'in' => 'query', 'schema' => [ 'description' => '备可用区ID。'."\n" .'> 本参数和ZoneId属性不能相同。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing-l', ], ], [ 'name' => 'TertiaryZoneId', 'in' => 'query', 'schema' => [ 'description' => '第三可用区。', 'type' => 'string', 'required' => false, 'example' => 'cn-beijing-h', ], ], [ 'name' => 'VpcId', 'in' => 'query', 'schema' => [ 'description' => '访问端点所在的专有网络ID。', 'type' => 'string', 'required' => false, 'example' => 'vpc-****', ], ], [ 'name' => 'VswitchId', 'in' => 'query', 'schema' => [ 'description' => 'Vswitch ID, 创建 VPC 网络类型的 DRDS 时必须指定', 'type' => 'string', 'required' => false, 'example' => 'vsw-****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'MigrateDBInstanceResponse', 'description' => 'MigrateDBInstanceResponse', 'type' => 'object', 'properties' => [ 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Message' => [ 'description' => '成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => '*****', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Success\\": true,\\n \\"Message\\": \\"*****\\",\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\"\\n}","type":"json"}]', 'title' => '实例可用区迁移', 'summary' => '该接口用于将实例从一个可用区迁移到另一个可用区。', ], 'DescribeAvailableCrossRegions' => [ 'summary' => '该接口用于查询支持跨区域操作的可用区域列表,通常用于多区域部署或数据复制场景。', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '193733', 'abilityTreeNodes' => [ 'FEATUREdrdsBRC5LQ', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => false, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', ], 'Message' => [ 'description' => '接口额外返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => '*****', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '参数详情。', 'type' => 'array', 'items' => [ 'description' => '监控数据。', 'type' => 'object', 'properties' => [ 'Regions' => [ 'description' => '实例ID。', 'type' => 'array', 'items' => [ 'description' => '实例ID。', 'type' => 'string', 'example' => '[]', ], ], ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Message\\": \\"*****\\",\\n \\"Success\\": true,\\n \\"Data\\": [\\n {\\n \\"Regions\\": [\\n \\"[]\\"\\n ]\\n }\\n ]\\n}","type":"json"}]', 'title' => '查询夸可用区', ], 'DescribeEnabledCrossRegions' => [ 'summary' => '该接口用于查询当前已启用的跨可用区。', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '193730', 'abilityTreeNodes' => [ 'FEATUREdrdsBRC5LQ', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称', 'type' => 'string', 'required' => false, 'example' => 'pxc-bjxxxxxxxx', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3WE34', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Message' => [ 'description' => '错误信息。', 'type' => 'string', 'example' => '*****', ], 'Data' => [ 'description' => '参数详情。', 'type' => 'array', 'items' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'Regions' => [ 'description' => '是否支持vpc。', 'type' => 'array', 'items' => [ 'description' => '可用区。', 'type' => 'string', 'example' => '[{\'RegionEndpoint\': \'nlb.cn-north-2-gov-1.aliyuncs.com\', \'RegionId\': \'cn-north-2-gov-1\', \'LocalName\': \'China North 2 Ali Gov 1\'}]', ], ], ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3WE34\\",\\n \\"Success\\": true,\\n \\"Message\\": \\"*****\\",\\n \\"Data\\": [\\n {\\n \\"Regions\\": [\\n \\"[{\'RegionEndpoint\': \'nlb.cn-north-2-gov-1.aliyuncs.com\', \'RegionId\': \'cn-north-2-gov-1\', \'LocalName\': \'China North 2 Ali Gov 1\'}]\\"\\n ]\\n }\\n ]\\n}","type":"json"}]', 'title' => '查询已启用的跨可用区', ], 'AlignStoragePrimaryAzone' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '132459', 'abilityTreeNodes' => [ 'FEATUREdrds7CT80F', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => true, 'docRequired' => true, ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => true, 'docRequired' => true, ], ], [ 'name' => 'StorageInstanceName', 'in' => 'query', 'schema' => [ 'type' => 'string', ], ], [ 'name' => 'SwitchTime', 'in' => 'query', 'schema' => [ 'type' => 'string', ], ], [ 'name' => 'SwitchTimeMode', 'in' => 'query', 'schema' => [ 'type' => 'string', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'type' => 'string', ], 'RequestId' => [ 'type' => 'string', ], 'Success' => [ 'type' => 'boolean', ], ], ], ], ], ], 'SwitchDBInstanceHA' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '132469', 'abilityTreeNodes' => [ 'FEATUREdrds7CT80F', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => true, 'docRequired' => true, ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => true, 'docRequired' => true, ], ], [ 'name' => 'TargetPrimaryRegionId', 'in' => 'query', 'schema' => [ 'type' => 'string', ], ], [ 'name' => 'TargetPrimaryAzoneId', 'in' => 'query', 'schema' => [ 'type' => 'string', ], ], [ 'name' => 'SwitchTimeMode', 'in' => 'query', 'schema' => [ 'type' => 'string', ], ], [ 'name' => 'SwitchTime', 'in' => 'query', 'schema' => [ 'type' => 'string', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'type' => 'string', ], 'RequestId' => [ 'type' => 'string', ], 'Success' => [ 'type' => 'boolean', ], ], ], ], ], ], 'CreateDB' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-**************', ], ], [ 'name' => 'AccountName', 'in' => 'query', 'schema' => [ 'description' => '创建的数据库授权的指定账号名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'testaccount', ], ], [ 'name' => 'Charset', 'in' => 'query', 'schema' => [ 'description' => '字符集,支持如下字符集:'."\n" ."\n" .'- **utf8**'."\n" .'- **gbk**'."\n" .'- **latin1**'."\n" .'- **utf8mb4**', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'utf8mb4', ], ], [ 'name' => 'DbName', 'in' => 'query', 'schema' => [ 'description' => '创建的数据库名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'testdb', ], ], [ 'name' => 'AccountPrivilege', 'in' => 'query', 'schema' => [ 'description' => '给新创建的账号授权某数据库的权限,包括:'."\n" ."\n" .'- **ReadWrite**'."\n" .'- **ReadOnly**'."\n" .'- **DMLOnly**'."\n" .'- **DDLOnly**', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'ReadWrite', ], ], [ 'name' => 'DbDescription', 'in' => 'query', 'schema' => [ 'description' => '数据库描述信息。', 'type' => 'string', 'required' => false, 'example' => 'db for test', ], ], [ 'name' => 'SecurityAccountName', 'in' => 'query', 'schema' => [ 'description' => '安全管理员账号名称。'."\n" ."\n" .'> 若已开启三权分立模式,该参数必填,未开启三权分立可以不填。', 'type' => 'string', 'required' => false, 'example' => 'securityAccount', ], ], [ 'name' => 'SecurityAccountPassword', 'in' => 'query', 'schema' => [ 'description' => '安全管理员账号密码。'."\n" ."\n" .'> 若已开启三权分立模式,该参数必填,未开启三权分立可以不填。', 'type' => 'string', 'required' => false, 'example' => 'securityPassword', ], ], [ 'name' => 'Mode', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'title' => 'drds/auto 用来区分所建库为自动拆分模式,还是手动拆分模式', 'description' => '创建数据库时选择的模式,取值如下:'."\n" ."\n" .'- **auto**:该模式的数据库支持自动分区,即创建表时无需指定分区键;'."\n" .'- **drds**:该模式的数据库不支持自动分区,创建表时需使用专用的分库分表语法,指定分库分表键。', 'type' => 'string', 'required' => false, 'example' => 'auto', 'enum' => [ 'drds', 'auto', ], ], ], [ 'name' => 'StoragePoolName', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '成功为空,失败返回错误信息。', 'type' => 'string', 'example' => '*****', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"*****\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n *****\\n 9B2F3840-5C98-475C-B269-2D5C3A31797C\\n true\\n","errorExample":""}]', 'title' => '创建数据库', 'summary' => '调用CreateDB接口创建数据库。', ], 'DeleteDB' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'DbName', 'in' => 'query', 'schema' => [ 'description' => '待删除的数据库名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'testdb', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '成功为空,失败返回错误信息。', 'type' => 'string', 'example' => '*****', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"*****\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n *****\\n 9B2F3840-5C98-475C-B269-2D5C3A31797C\\n true\\n","errorExample":""}]', 'title' => '删除数据库', 'summary' => '调用DeleteDB接口删除数据库。', ], 'DescribeCharacterSet' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。'."\n" ."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-*********', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域的ID。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '返回信息,正确返回success,错误返回错误码。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '请求ID。'."\n" ."\n", 'type' => 'string', 'example' => '709C1E40-092D-4A3D-9958-6D7438******', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'Engine' => [ 'description' => '目标实例下数据库的存储类型,目前仅支持polarx。'."\n" ."\n", 'type' => 'string', 'example' => 'polarx', ], 'CharacterSet' => [ 'description' => '实例支持的字符编码集,取值范围如下:'."\n" ."\n" .'- utf8mb4'."\n" .'- gbk'."\n" .'- latin1'."\n" .'- utf8', 'type' => 'array', 'items' => [ 'description' => '字符集。', 'type' => 'string', 'example' => 'utf8', ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"709C1E40-092D-4A3D-9958-6D7438******\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"Engine\\": \\"polarx\\",\\n \\"CharacterSet\\": [\\n \\"utf8\\"\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n 709C1E40-092D-4A3D-9958-6D7438******\\n true\\n \\n polarx\\n utf8\\n \\n","errorExample":""}]', 'title' => '查询字符集', 'summary' => '调用DescribeCharacterSet接口查询目标实例下数据库所支持的字符集类型。', ], 'DescribeDbList' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属的地域ID。'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'DBName', 'in' => 'query', 'schema' => [ 'description' => '数据库名字。', 'type' => 'string', 'required' => false, 'example' => 'db_name', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'Success', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Success' => [ 'description' => '请求是否成功。'."\n", 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '数据库列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'DBName' => [ 'description' => '数据库名称。', 'type' => 'string', 'example' => 'test', ], 'DBDescription' => [ 'description' => '数据库描述。', 'type' => 'string', 'example' => 'test', ], 'DBInstanceName' => [ 'description' => '实例名称。', 'type' => 'string', 'example' => 'pxc-********', ], 'CharacterSetName' => [ 'description' => '字符集。', 'type' => 'string', 'example' => 'utf8mb4', ], 'Accounts' => [ 'description' => '账户列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'AccountPrivilege' => [ 'description' => '权限。', 'type' => 'string', 'example' => 'ReadWrite', ], 'AccountName' => [ 'description' => '账户名称。', 'type' => 'string', 'example' => 'root4test', ], ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Success\\": true,\\n \\"Data\\": [\\n {\\n \\"DBName\\": \\"test\\",\\n \\"DBDescription\\": \\"test\\",\\n \\"DBInstanceName\\": \\"pxc-********\\",\\n \\"CharacterSetName\\": \\"utf8mb4\\",\\n \\"Accounts\\": [\\n {\\n \\"AccountPrivilege\\": \\"ReadWrite\\",\\n \\"AccountName\\": \\"root4test\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n Success\\n C458B1E8-1683-3645-B154-6BA32080EEA\\n true\\n \\n test\\n test\\n pxc-********\\n utf8mb4\\n \\n ReadWrite\\n root4test\\n \\n \\n","errorExample":""}]', 'title' => '查询获取实例下的数据库信息', 'summary' => '调用DescribeDbList接口获取数据库列表。', ], 'DescribeDistributeTableList' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'abilityTreeCode' => '86248', 'abilityTreeNodes' => [ 'FEATUREdrdsTIBR6Q', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'DbName', 'in' => 'query', 'schema' => [ 'description' => '数据库名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'sbtest1', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'Success', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Success' => [ 'description' => '是否请求成功', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'Tables' => [ 'description' => '表列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'TableName' => [ 'description' => '表名。', 'type' => 'string', 'example' => 'sbtest1', ], 'TableType' => [ 'description' => '表类型。', 'type' => 'string', 'example' => 'multi', ], 'TbKey' => [ 'description' => '表key。', 'type' => 'string', 'example' => '“”', ], 'DbKey' => [ 'description' => '数据key。', 'type' => 'string', 'example' => 'id', ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"Tables\\": [\\n {\\n \\"TableName\\": \\"sbtest1\\",\\n \\"TableType\\": \\"multi\\",\\n \\"TbKey\\": \\"“”\\",\\n \\"DbKey\\": \\"id\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n Success\\n C458B1E8-1683-3645-B154-6BA32080EEA\\n true\\n \\n \\n sbtest1\\n multi\\n “”\\n id\\n \\n \\n","errorExample":""}]', 'title' => '获取数据库表列表', 'summary' => '调用DescribeDistributeTableList接口获取数据库表列表。', ], 'ModifyDatabaseDescription' => [ 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'systemTags' => [], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'DbName', 'in' => 'query', 'schema' => [ 'description' => '数据库名。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'testDB', ], ], [ 'name' => 'DbDescription', 'in' => 'query', 'schema' => [ 'description' => '数据库备注描述。', 'type' => 'string', 'required' => true, 'example' => '测试数据库', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '接口额外返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'success', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'staticInfo' => [], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n success\\n FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\n true\\n","errorExample":""}]', 'title' => '修改数据库描述', 'summary' => '调用ModifyDatabaseDescription接口修改数据库备注描述。', ], 'StartSwitchDatabase' => [ 'summary' => '该接口主要用于在数据库迁移或同步任务的数据库切换。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '201840', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所属地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => false, 'example' => 'pxc-xxx', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '导入任务id。', 'type' => 'string', 'required' => true, 'example' => 'etx-szr2rr6i*****', ], ], [ 'name' => 'IsModifyEndpoint', 'in' => 'query', 'schema' => [ 'description' => '是否修改源或目标实例的连接地址/端口。', 'type' => 'string', 'required' => false, 'example' => 'true', ], ], [ 'name' => 'SrcMainConnectString', 'in' => 'query', 'schema' => [ 'description' => '源实例的主节点连接地址(通常是实例的内网或外网地址)。', 'type' => 'string', 'required' => false, 'example' => 'rm-*********.mysql.rds.aliyuncs.com', ], ], [ 'name' => 'DstMainConnectString', 'in' => 'query', 'schema' => [ 'description' => '目标实例的主节点连接地址。', 'type' => 'string', 'required' => false, 'example' => 'pxc-*********.polarx.rds.aliyuncs.com', ], ], [ 'name' => 'SrcMainPort', 'in' => 'query', 'schema' => [ 'description' => '源实例主节点的端口号。', 'type' => 'string', 'required' => false, 'example' => '3308', ], ], [ 'name' => 'DstMainPort', 'in' => 'query', 'schema' => [ 'description' => '目标实例的端口号。', 'type' => 'string', 'required' => false, 'example' => '3313', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '请求返回消息', 'type' => 'string', 'example' => '*****', ], 'RequestId' => [ 'description' => 'Id of the request', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '监控数据。', 'type' => 'object', 'properties' => [ 'SlinkTaskId' => [ 'description' => 'slink任务id。', 'type' => 'string', 'example' => 'etx-szr2rr6i*****', ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"*****\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"SlinkTaskId\\": \\"etx-szr2rr6i*****\\"\\n }\\n}","type":"json"}]', 'title' => '开启数据库切换', ], 'DescribeComponentPropeties' => [ 'summary' => '该接口用于获取指定组件的属性信息,包括属性名称、类型等。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeNodes' => [ 'FEATUREdrds25BO3L', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'CommodityCode', 'in' => 'query', 'schema' => [ 'description' => '商品类型。', 'type' => 'string', 'required' => true, 'docRequired' => false, 'example' => 'learn_EasDedicatedPrepay_public_cn', ], ], [ 'name' => 'ComponentName', 'in' => 'query', 'schema' => [ 'title' => '资源组ID', 'description' => '资源组ID', 'type' => 'string', 'required' => true, 'example' => 'rg-xxxxx', ], ], [ 'name' => 'StorageType', 'in' => 'query', 'schema' => [ 'description' => '存储类型', 'type' => 'string', 'required' => false, 'example' => 'cloud_auto', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => 'Id of the request', 'type' => 'string', 'example' => 'A501A191-BD70-5E50-98A9-C2A486A82****', ], 'Properties' => [ 'description' => '异常事件的导出参数。', 'type' => 'array', 'items' => [ 'description' => '异常事件的导出参数。', 'type' => 'object', 'properties' => [ 'PropertyCode' => [ 'description' => '商品模块。', 'type' => 'string', 'example' => 'dn_node_spec', ], 'Name' => [ 'description' => '名称。', 'type' => 'string', 'example' => '4核32G', ], 'OrderIndex' => [ 'description' => '商品模块属性显示顺序。'."\n" ."\n" .'不同商品模块返回内容不同。', 'type' => 'string', 'example' => '1', ], 'Value' => [ 'description' => '标签值', 'type' => 'string', 'example' => '172.27.35.', ], ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"A501A191-BD70-5E50-98A9-C2A486A82****\\",\\n \\"Properties\\": [\\n {\\n \\"PropertyCode\\": \\"dn_node_spec\\",\\n \\"Name\\": \\"4核32G\\",\\n \\"OrderIndex\\": \\"1\\",\\n \\"Value\\": \\"172.27.35.\\"\\n }\\n ]\\n}","type":"json"}]', 'title' => '查询组件属性', ], 'ModifyEngineMigration' => [ 'summary' => '该接口用于修改数据库引擎迁移任务的配置或迁移参数,支持调整源库、目标库、迁移对象或迁移模式等设置。', 'methods' => [ 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '201956', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-shanghai', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => false, 'example' => 'pxc-htri0****r4k9p', ], ], [ 'name' => 'SourceDBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '源数据库实例名称。', 'type' => 'string', 'required' => false, 'example' => 'source456', ], ], [ 'name' => 'NewMasterDBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '迁移完成后的新主实例名称。', 'type' => 'string', 'required' => false, 'example' => 'newmaster789', ], ], [ 'name' => 'SwapConnectionString', 'in' => 'query', 'schema' => [ 'description' => '是否自动交换连接字符串:'."\n" ."\n" .'- true:应用无需修改配置,连接自动指向新实例;'."\n" ."\n" .'- false:需手动更新应用连接地址。', 'type' => 'string', 'required' => false, 'example' => 'true', ], ], [ 'name' => 'ConnectionStrings', 'in' => 'query', 'schema' => [ 'description' => '需要切换的具体连接地址。取值为需要两两交换的地址对应的JSON串。'."\n" .'>当SwapConnectionString取值为true时生效。', 'type' => 'string', 'required' => false, 'example' => '{\\"pc-bp1m9tt23o5kh834y.rwlb.rds.aliyuncs.com\\":\\"rm-bp1ycl5o6ojs957o0.mysql.rds.aliyuncs.com\\"}', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Code' => [ 'description' => '接口返回Code', 'type' => 'string', 'example' => '200', ], 'Message' => [ 'description' => '接口额外返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'Success', ], 'HttpStatusCode' => [ 'description' => '请求状态码', 'type' => 'string', 'example' => '200', ], 'SuccessResponse' => [ 'description' => '请求是否成功。'."\n" ."\n", 'type' => 'string', 'example' => 'true', ], 'Data' => [ 'description' => '返回结果。', 'type' => 'object', 'properties' => [ 'DBInstanceName' => [ 'description' => '实例Id', 'type' => 'string', 'example' => 'pxc-*********', ], 'TaskId' => [ 'description' => '任务ID。', 'type' => 'string', 'example' => '42292****', ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Success\\",\\n \\"HttpStatusCode\\": \\"200\\",\\n \\"SuccessResponse\\": \\"true\\",\\n \\"Data\\": {\\n \\"DBInstanceName\\": \\"pxc-*********\\",\\n \\"TaskId\\": \\"42292****\\"\\n }\\n}","type":"json"}]', 'title' => '修改引擎迁移', 'description' => '****', ], 'DescribeArchiveTableList' => [ 'summary' => '冷存储表列表', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', 'abilityTreeCode' => '137155', 'abilityTreeNodes' => [ 'FEATUREdrds9ED9RQ', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => true, 'docRequired' => true, ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => true, ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'type' => 'integer', 'format' => 'int64', 'required' => true, 'maximum' => '100', 'minimum' => '20', ], ], [ 'name' => 'PageIndex', 'in' => 'query', 'schema' => [ 'title' => '分页下表, 从1开始', 'type' => 'integer', 'format' => 'int64', 'required' => true, 'maximum' => '1000', 'minimum' => '1', ], ], [ 'name' => 'SchemaName', 'in' => 'query', 'schema' => [ 'type' => 'string', ], ], [ 'name' => 'TableName', 'in' => 'query', 'schema' => [ 'type' => 'string', ], ], [ 'name' => 'Status', 'in' => 'query', 'schema' => [ 'type' => 'string', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'requestId', 'type' => 'string', ], 'Data' => [ 'title' => '数据', 'type' => 'object', 'properties' => [ 'Total' => [ 'title' => '总数', 'type' => 'integer', 'format' => 'int64', ], 'PageIndex' => [ 'title' => '页面下标', 'type' => 'integer', 'format' => 'int64', ], 'PageSize' => [ 'title' => '页面大小', 'type' => 'integer', 'format' => 'int64', ], 'Tables' => [ 'type' => 'array', 'items' => [ 'title' => '冷存储表信息', 'type' => 'object', 'properties' => [ 'SchemaName' => [ 'title' => '库名', 'type' => 'string', ], 'TableName' => [ 'title' => '表名', 'type' => 'string', ], 'CreatedDate' => [ 'title' => '创建时间', 'type' => 'integer', 'format' => 'int64', ], 'SpaceSize' => [ 'title' => '占用空间大小', 'type' => 'number', 'format' => 'double', ], 'FileCount' => [ 'title' => '文件个数', 'type' => 'integer', 'format' => 'int32', ], 'LastSuccessArchiveTime' => [ 'type' => 'integer', 'format' => 'int64', ], 'ArchiveStatus' => [ 'type' => 'string', ], ], ], ], 'TobeArchivedConut' => [ 'type' => 'integer', 'format' => 'int32', ], 'RunningCount' => [ 'type' => 'integer', 'format' => 'int32', ], 'SuccessCount' => [ 'type' => 'integer', 'format' => 'int32', ], 'PausedCount' => [ 'type' => 'integer', 'format' => 'int32', ], ], ], ], ], ], ], 'responseDemo' => '', ], 'UpgradeCDCVersion' => [ 'summary' => '升级PolarDB-X CDC 节点版本', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '134914', 'abilityTreeNodes' => [ 'FEATUREdrdsV6IT1E', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'allowEmptyValue' => false, 'schema' => [ 'description' => '实例id。>您可以调用[describedbinstances](~~196830~~)接口查看目标地域下所有实例的详情,包括实例id。', 'type' => 'string', 'required' => false, 'example' => 'pxc-hzrp****3p72fi', ], ], [ 'name' => 'CdcMinorVersion', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '需要升级的目标版本号', 'type' => 'string', 'required' => false, 'example' => 'polarx-cdc-kernel-5.4.19-20240928_17274884', ], ], [ 'name' => 'CdcDbVersion', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '需要升级的目标数据库版本。>您可以调用[describedbclusterversion](~~196830~~)接口查看目标地域下所有数据库版本的升级说明。', 'type' => 'string', 'required' => false, 'example' => '2.343', 'default' => '2.343', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'InstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名', 'type' => 'string', 'required' => false, 'example' => 'pxc-shrvdc****wtf5uk-cdc', ], ], [ 'name' => 'SwitchMode', 'in' => 'query', 'schema' => [ 'description' => '切换模式。取值:'."\n" ."\n" .'- 0:立即切换。'."\n" .'- 1:在可运维时间段内切换。', 'type' => 'string', 'required' => false, 'example' => '0', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'CB4307F5-3D04-51E8-ABAD-49E0B3F962FC', ], 'Message' => [ 'description' => '请求返回消息', 'type' => 'string', 'example' => 'success', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'True', ], 'Data' => [ 'description' => '返回结果。', 'type' => 'object', 'properties' => [ 'MinorVersion' => [ 'description' => '目标版本号。', 'type' => 'string', 'example' => 'polardb-2.4.0_5.4.19-20250116_xcluster5.4.20-20241213', ], 'TaskList' => [ 'description' => '升级任务列表。', 'type' => 'array', 'items' => [ 'description' => '升级任务列表。', 'type' => 'object', 'properties' => [ 'DbInstanceName' => [ 'description' => '实例id。', 'type' => 'string', 'example' => 'rm-uf68f345****88zf8', ], 'TaskId' => [ 'description' => '目标任务id。', 'type' => 'integer', 'format' => 'int32', 'example' => '1861190497624654848', ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"CB4307F5-3D04-51E8-ABAD-49E0B3F962FC\\",\\n \\"Message\\": \\"success\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"MinorVersion\\": \\"polardb-2.4.0_5.4.19-20250116_xcluster5.4.20-20241213\\",\\n \\"TaskList\\": [\\n {\\n \\"DbInstanceName\\": \\"rm-uf68f345****88zf8\\",\\n \\"TaskId\\": 1861190497624654800\\n }\\n ]\\n }\\n}","type":"json"}]', 'title' => '升级 CDC 版本', ], 'DescribeCdcInfo' => [ 'summary' => '查询CDC信息。', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '162461', 'abilityTreeNodes' => [ 'FEATUREdrdsAS582G', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'allowEmptyValue' => false, 'schema' => [ 'description' => '实例所在地域', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-beijing', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'allowEmptyValue' => false, 'schema' => [ 'description' => '实例名', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-********', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'HttpStatusCode' => [ 'description' => '请求状态码', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '200', ], 'Success' => [ 'description' => '请求是否成功', 'type' => 'boolean', 'required' => true, 'example' => 'true', ], 'Data' => [ 'description' => '实例数据', 'type' => 'object', 'properties' => [ 'CdcNewVersion' => [ 'description' => 'cdc最新版本', 'type' => 'string', 'required' => true, 'example' => 'polarx-cdc-kernel-***', ], 'BinlogSize' => [ 'description' => 'binlog大小', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '524288000', ], 'ServerId' => [ 'description' => 'server id', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '3014767486', ], 'CheckSumSwitch' => [ 'description' => 'check sum开关', 'type' => 'string', 'example' => 'ON', ], 'VersionSupportMultiCdc' => [ 'description' => '是否支持cdc多流', 'type' => 'boolean', 'example' => 'true', ], 'BinlogPersistTime' => [ 'description' => 'binlog保存的天数', 'type' => 'integer', 'format' => 'int32', 'example' => '15', ], 'InstanceTopologyList' => [ 'description' => '实例列表', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'InstanceName' => [ 'description' => '实例名', 'type' => 'string', 'example' => 'pxc-***', ], 'Comment' => [ 'description' => '实例类型备注', 'type' => 'string', 'example' => '***', ], 'PhysicalNodes' => [ 'description' => '节点数组', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Disk' => [ 'description' => '磁盘大小,MB', 'type' => 'integer', 'format' => 'int32', 'example' => '204800', ], 'NodeClass' => [ 'description' => '实例规格', 'type' => 'string', 'example' => 'polarx.x4.large.2e.cdc', ], 'Version' => [ 'description' => '实例版本', 'type' => 'string', 'example' => 'polarx-cdc-kernel-***', ], 'AZone' => [ 'description' => '实例所在可用区', 'type' => 'string', 'example' => 'cn-hangzhou-h', ], 'Status' => [ 'description' => '实例状态', 'type' => 'string', 'example' => 'ACTIVATION', ], 'NodeId' => [ 'description' => '节点id', 'type' => 'string', 'example' => '***', ], 'NodeName' => [ 'description' => '节点的名称。', 'type' => 'string', 'example' => 'pxc-c-***', ], ], ], ], 'GroupName' => [ 'description' => '多流流组名称', 'type' => 'string', 'example' => 'test', ], 'HashLevel' => [ 'description' => '拆分级别', 'type' => 'string', 'example' => 'RECORD', ], 'StreamNum' => [ 'description' => '拆分数量', 'type' => 'integer', 'format' => 'int32', 'example' => '2', ], 'ClusterType' => [ 'description' => '集群类型', 'type' => 'string', 'example' => 'BINLOG_X', ], ], ], ], 'EnableCyclicReplication' => [ 'description' => '支持双向复制', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"CdcNewVersion\\": \\"polarx-cdc-kernel-***\\",\\n \\"BinlogSize\\": 524288000,\\n \\"ServerId\\": 3014767486,\\n \\"CheckSumSwitch\\": \\"ON\\",\\n \\"VersionSupportMultiCdc\\": true,\\n \\"BinlogPersistTime\\": 15,\\n \\"InstanceTopologyList\\": [\\n {\\n \\"InstanceName\\": \\"pxc-***\\",\\n \\"Comment\\": \\"***\\",\\n \\"PhysicalNodes\\": [\\n {\\n \\"Disk\\": 204800,\\n \\"NodeClass\\": \\"polarx.x4.large.2e.cdc\\",\\n \\"Version\\": \\"polarx-cdc-kernel-***\\",\\n \\"AZone\\": \\"cn-hangzhou-h\\",\\n \\"Status\\": \\"ACTIVATION\\",\\n \\"NodeId\\": \\"***\\",\\n \\"NodeName\\": \\"pxc-c-***\\"\\n }\\n ],\\n \\"GroupName\\": \\"test\\",\\n \\"HashLevel\\": \\"RECORD\\",\\n \\"StreamNum\\": 2,\\n \\"ClusterType\\": \\"BINLOG_X\\"\\n }\\n ],\\n \\"EnableCyclicReplication\\": true\\n }\\n}","type":"json"}]', 'title' => '查询CDC实例信息', ], 'DescribeCdcVersionList' => [ 'summary' => '获取CDC版本列表', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '167760', 'abilityTreeNodes' => [ 'FEATUREdrdsV6IT1E', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'allowEmptyValue' => false, 'schema' => [ 'description' => '实例所属地域的ID。'."\n", 'type' => 'string', 'required' => false, 'example' => 'cn-beijing', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'allowEmptyValue' => false, 'schema' => [ 'description' => '实例名称。', 'type' => 'string', 'required' => false, 'example' => 'pxc-bjrl7****k2vp7', ], ], ], 'responses' => [ 200 => [ 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '97632117-E477-5FE8-B424-F059CBBDD919', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'VersionList' => [ 'description' => '关联的旧版项目id,可忽略', 'type' => 'array', 'items' => [ 'description' => '关联的旧版项目id,可忽略', 'type' => 'string', 'example' => '[{\'Version\': \'2022-07-28\'}]', ], ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"97632117-E477-5FE8-B424-F059CBBDD919\\",\\n \\"Data\\": {\\n \\"VersionList\\": [\\n \\"[{\'Version\': \'2022-07-28\'}]\\"\\n ]\\n }\\n}","type":"json"}]', 'title' => 'CDC版本获取', 'description' => '- binlog文件默认保存15天。'."\n" .'- 返回的日志列表中包含日志记录结束时间在查询开始时间之后,并且日志记录开始时间在查询结束时间之前的所有日志。'."\n" .'- 当DownloadLink不为NULL时,用户可以根据此URL下载备份文件,此URL自生成后2天内有效,请在过期时间之前下载。', ], 'DescribeCdcClassList' => [ 'summary' => '查询实例规格列表', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '162466', 'abilityTreeNodes' => [ 'FEATUREdrdsAS582G', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'example' => 'pxc-hzjasd****', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'InstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名', 'type' => 'string', 'required' => false, 'example' => 'pxc-hzrh51fze****pon-cdc', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '6BA32080EEA', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'ClassCodeList' => [ 'description' => 'array', 'type' => 'array', 'items' => [ 'description' => 'object', 'type' => 'object', 'properties' => [ 'Mem' => [ 'description' => '租户总的内存大小,单位:GB。', 'type' => 'string', 'example' => '2048', ], 'ClassCode' => [ 'description' => '实例规格。', 'type' => 'string', 'example' => 'polarx.n2.small.2e.cdc', ], 'CpuCore' => [ 'description' => 'CPU核心数。', 'type' => 'string', 'example' => '2', ], ], ], ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"6BA32080EEA\\",\\n \\"Data\\": {\\n \\"ClassCodeList\\": [\\n {\\n \\"Mem\\": \\"2048\\",\\n \\"ClassCode\\": \\"polarx.n2.small.2e.cdc\\",\\n \\"CpuCore\\": \\"2\\"\\n }\\n ]\\n }\\n}","type":"json"}]', 'title' => '规格列表', 'description' => '- binlog文件默认保存15天。'."\n" .'- 返回的日志列表中包含日志记录结束时间在查询开始时间之后,并且日志记录开始时间在查询结束时间之前的所有日志。'."\n" .'- 当DownloadLink不为NULL时,用户可以根据此URL下载备份文件,此URL自生成后2天内有效,请在过期时间之前下载。', ], 'ModifyCdcClass' => [ 'summary' => '修改CDC配置', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '162467', 'abilityTreeNodes' => [ 'FEATUREdrdsDBGOD6', ], ], 'parameters' => [ [ 'name' => 'InstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzrh51fze****pon-cdc', ], ], [ 'name' => 'CdcClass', 'in' => 'query', 'schema' => [ 'description' => '实例规格', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'premium', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域Id', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-shanghai', ], ], [ 'name' => 'CDCNodeCount', 'in' => 'query', 'schema' => [ 'description' => 'CDC节点数', 'type' => 'string', 'required' => false, 'example' => '1', 'default' => ' ', ], ], [ 'name' => 'SwitchMode', 'in' => 'query', 'schema' => [ 'description' => '切换模式', 'type' => 'string', 'required' => false, 'example' => '0', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'TaskId' => [ 'description' => '任务ID。', 'type' => 'integer', 'format' => 'int32', 'example' => '2209883', ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Data\\": {\\n \\"TaskId\\": 2209883\\n }\\n}","type":"json"}]', 'title' => '修改CDC配置', 'description' => '****', ], 'AttachColumnarInstance' => [ 'methods' => [ 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-xxx', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'DBInstanceName' => [ 'description' => '创建的实例名称。', 'type' => 'string', 'example' => 'pxc-xxx', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'TaskId' => [ 'description' => '后端任务ID。', 'type' => 'string', 'example' => '422922413', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"DBInstanceName\\": \\"pxc-xxx\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"TaskId\\": \\"422922413\\"\\n}","type":"json"}]', 'title' => '挂载列存', 'summary' => '该接口用于将一个列存实例(Columnar Instance)挂载到指定的主数据库实例上。', ], 'UpgradeColumnarVersion' => [ 'summary' => '更新列存版本', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '198143', 'abilityTreeNodes' => [ 'FEATUREdrdsV6IT1E', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'allowEmptyValue' => false, 'schema' => [ 'description' => '实例名。', 'type' => 'string', 'required' => false, 'example' => 'pxc-xxx', ], ], [ 'name' => 'ColumnarVersion', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '列存版本', 'type' => 'string', 'required' => false, 'example' => 'polarx-col-kernel-5.4.20-20250819_17555906', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'InstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名', 'type' => 'string', 'required' => false, 'example' => 'pxc-hzrh51fze****pon-cdc', ], ], [ 'name' => 'SwitchMode', 'in' => 'query', 'schema' => [ 'description' => '切换模式', 'type' => 'string', 'required' => false, 'example' => '0', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'AE4F6C34-****-45AA-B5DC-4B8D816F6305', ], 'Message' => [ 'description' => '请求返回消息', 'type' => 'string', 'example' => 'success', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ 'MinorVersion' => [ 'description' => '目标版本号。', 'type' => 'string', 'example' => 'polardb-2.4.0_5.4.19-20250116_xcluster5.4.20-20241213', ], 'TaskList' => [ 'description' => '升级任务列表。', 'type' => 'array', 'items' => [ 'description' => '升级任务列表。', 'type' => 'object', 'properties' => [ 'DbInstanceName' => [ 'description' => '实例id。', 'type' => 'string', 'example' => 'rm-uf68f345****88zf8', ], 'TaskId' => [ 'description' => '目标任务id。', 'type' => 'integer', 'format' => 'int32', 'example' => '1861190497624654848', ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"AE4F6C34-****-45AA-B5DC-4B8D816F6305\\",\\n \\"Message\\": \\"success\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"MinorVersion\\": \\"polardb-2.4.0_5.4.19-20250116_xcluster5.4.20-20241213\\",\\n \\"TaskList\\": [\\n {\\n \\"DbInstanceName\\": \\"rm-uf68f345****88zf8\\",\\n \\"TaskId\\": 1861190497624654800\\n }\\n ]\\n }\\n}","type":"json"}]', 'title' => '更新列存版本', ], 'ModifyColumnarClass' => [ 'summary' => '修改列存规格', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '198145', 'abilityTreeNodes' => [ 'FEATUREdrdsDBGOD6', ], ], 'parameters' => [ [ 'name' => 'InstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzrh51fze****pon-cdc', ], ], [ 'name' => 'ColumnarClass', 'in' => 'query', 'schema' => [ 'description' => '列存规格', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'polarx.n8.large.col', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-shanghai', ], ], [ 'name' => 'ColumnarNodeCount', 'in' => 'query', 'schema' => [ 'description' => '列存节点数', 'type' => 'string', 'required' => false, 'example' => '**', 'default' => ' ', ], ], [ 'name' => 'SwitchMode', 'in' => 'query', 'schema' => [ 'description' => '切换模式', 'type' => 'string', 'required' => false, 'example' => '0', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '9B2F3840-****-475C-B269-2D5C3A31797C', ], 'Data' => [ 'description' => '返回的策略详情。', 'type' => 'object', 'properties' => [ 'TaskId' => [ 'description' => '任务ID。', 'type' => 'integer', 'format' => 'int32', 'example' => '******', ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9B2F3840-****-475C-B269-2D5C3A31797C\\",\\n \\"Data\\": {\\n \\"TaskId\\": 0\\n }\\n}","type":"json"}]', 'title' => '修改列存规格', 'description' => '****', ], 'DescribeColumnarVersionList' => [ 'summary' => '查询列存版本信息', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '198141', 'abilityTreeNodes' => [ 'FEATUREdrdsV6IT1E', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'allowEmptyValue' => false, 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'allowEmptyValue' => false, 'schema' => [ 'description' => '实例名称。'."\n" ."\n", 'type' => 'string', 'required' => false, 'example' => 'pxc-hzjasd****', ], ], ], 'responses' => [ 200 => [ 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '9B2F3840-****-475C-B269-2D5C3A31797C', ], 'Data' => [ 'description' => '参数详情。', 'type' => 'object', 'properties' => [ 'VersionList' => [ 'description' => '版本列表', 'type' => 'array', 'items' => [ 'description' => '字符串', 'type' => 'string', 'example' => 'string', ], 'enumValueTitles' => [ '[\\"polarx-col-kernel-5.4.20-20250819_17555906\\",\\"polarx-col-kernel-5.4.20-20250714_17524769\\",\\"polarx-col-kernel-5.4.20-20250618_17502340\\",\\"polarx-col-kernel-5.4.20-20250606_17491985_hotfix\\",\\"polarx-col-kernel-5.4.20-20250529_17484868\\",\\"polarx-col-kernel-5.4.20-20250328_17431324\\",\\"polarx-col-kernel-5.4.20-20250210_17391594\\",\\"polarx-col-kernel-5.4.20-20241224_17350237\\"]' => '[\\"polarx-col-kernel-5.4.20-20250819_17555906\\",\\"polarx-col-kernel-5.4.20-20250714_17524769\\",\\"polarx-col-kernel-5.4.20-20250618_17502340\\",\\"polarx-col-kernel-5.4.20-20250606_17491985_hotfix\\",\\"polarx-col-kernel-5.4.20-20250529_17484868\\",\\"polarx-col-kernel-5.4.20-20250328_17431324\\",\\"polarx-col-kernel-5.4.20-20250210_17391594\\",\\"polarx-col-kernel-5.4.20-20241224_17350237\\"]', ], ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9B2F3840-****-475C-B269-2D5C3A31797C\\",\\n \\"Data\\": {\\n \\"VersionList\\": [\\n \\"string\\"\\n ]\\n }\\n}","type":"json"}]', 'title' => '查询列存版本信息', 'description' => '- binlog文件默认保存15天。'."\n" .'- 返回的日志列表中包含日志记录结束时间在查询开始时间之后,并且日志记录开始时间在查询结束时间之前的所有日志。'."\n" .'- 当DownloadLink不为NULL时,用户可以根据此URL下载备份文件,此URL自生成后2天内有效,请在过期时间之前下载。', ], 'DescribeColumnarInfo' => [ 'summary' => '查询列存信息', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '197943', 'abilityTreeNodes' => [ 'FEATUREdrdsGUBPOK', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'allowEmptyValue' => false, 'schema' => [ 'description' => '实例所在地域ID。'."\n" .'> 您可以调用[DescribeRegions](~~196841~~)接口查看PolarDB-X支持的地域详情,包括地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'allowEmptyValue' => false, 'schema' => [ 'description' => '实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-hzjasd****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '14036EBE-****-44DB-ACE9-AC6157D3A6FC', ], 'HttpStatusCode' => [ 'description' => '请求状态码', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '200', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'required' => true, 'example' => 'true', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'ColumnarNewVersion' => [ 'description' => '列存新版本', 'type' => 'string', 'required' => true, 'example' => 'polarx-col-kernel-5.4.20-20250819_17555906', ], 'BinlogSize' => [ 'description' => 'binlog大小', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '524288000', ], 'ServerId' => [ 'description' => 'server id', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '53755321', ], 'CheckSumSwitch' => [ 'description' => 'check sum开关', 'type' => 'string', 'example' => 'ON', ], 'BinlogPersistTime' => [ 'description' => 'binlog保存的天数', 'type' => 'integer', 'format' => 'int32', 'example' => '30', ], 'ColumnarVersion' => [ 'description' => '列存版本', 'type' => 'string', 'example' => 'polarx-col-kernel-5.4.20-20250819_17555906', ], 'ClassCode' => [ 'description' => '实例规格', 'type' => 'string', 'example' => 'polarx.n8.medium.col', ], 'InstanceTopologyList' => [ 'description' => '实例列表', 'type' => 'array', 'items' => [ 'description' => '实例列表', 'type' => 'object', 'properties' => [ 'InstanceName' => [ 'description' => '实例名', 'type' => 'string', 'example' => 'pxc-***', ], 'Comment' => [ 'description' => '实例类型备注', 'type' => 'string', 'example' => '***', ], 'PhysicalNodes' => [ 'description' => '节点数组', 'type' => 'array', 'items' => [ 'description' => '节点数组', 'type' => 'object', 'properties' => [ 'Disk' => [ 'description' => '磁盘大小,MB', 'type' => 'integer', 'format' => 'int32', 'example' => '204800', ], 'NodeClass' => [ 'description' => '实例规格', 'type' => 'string', 'example' => 'polarx.n8.medium.col', ], 'Version' => [ 'description' => '实例版本', 'type' => 'string', 'example' => 'polarx-col-kernel-5.4.20-20250819_17555906', ], 'AZone' => [ 'description' => '实例所在可用区', 'type' => 'string', 'example' => 'cn-hangzhou-h', ], 'Status' => [ 'description' => '实例状态', 'type' => 'string', 'example' => 'ACTIVATION', ], 'NodeId' => [ 'description' => '节点id', 'type' => 'string', 'example' => '***', ], ], ], ], ], ], ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"14036EBE-****-44DB-ACE9-AC6157D3A6FC\\",\\n \\"HttpStatusCode\\": 200,\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"ColumnarNewVersion\\": \\"polarx-col-kernel-5.4.20-20250819_17555906\\",\\n \\"BinlogSize\\": 524288000,\\n \\"ServerId\\": 53755321,\\n \\"CheckSumSwitch\\": \\"ON\\",\\n \\"BinlogPersistTime\\": 30,\\n \\"ColumnarVersion\\": \\"polarx-col-kernel-5.4.20-20250819_17555906\\",\\n \\"ClassCode\\": \\"polarx.n8.medium.col\\",\\n \\"InstanceTopologyList\\": [\\n {\\n \\"InstanceName\\": \\"pxc-***\\",\\n \\"Comment\\": \\"***\\",\\n \\"PhysicalNodes\\": [\\n {\\n \\"Disk\\": 204800,\\n \\"NodeClass\\": \\"polarx.n8.medium.col\\",\\n \\"Version\\": \\"polarx-col-kernel-5.4.20-20250819_17555906\\",\\n \\"AZone\\": \\"cn-hangzhou-h\\",\\n \\"Status\\": \\"ACTIVATION\\",\\n \\"NodeId\\": \\"***\\"\\n }\\n ]\\n }\\n ]\\n }\\n}","type":"json"}]', 'title' => '查询列存信息', ], 'DescribeColumnarClassList' => [ 'summary' => '查询实例列存规格列表', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '198142', 'abilityTreeNodes' => [ 'FEATUREdrdsGUBPOK', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例ID。'."\n" ."\n", 'type' => 'string', 'required' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'InstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名', 'type' => 'string', 'required' => false, 'example' => 'pxc-shrvdc****wtf5uk-cdc', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '173CA69A-3513-591D-8A09-C1EA37CBE2D9', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'ClassCodeList' => [ 'description' => 'object', 'type' => 'array', 'items' => [ 'description' => 'object', 'type' => 'object', 'properties' => [ 'Mem' => [ 'description' => '内存大小,单位:GB。', 'type' => 'string', 'example' => '2048', ], 'ClassCode' => [ 'description' => '实例规格。', 'type' => 'string', 'example' => 'polarx.n8.large.col', ], 'CpuCore' => [ 'description' => 'CPU核数。', 'type' => 'string', 'example' => '2', ], ], ], ], ], ], ], ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"173CA69A-3513-591D-8A09-C1EA37CBE2D9\\",\\n \\"Data\\": {\\n \\"ClassCodeList\\": [\\n {\\n \\"Mem\\": \\"2048\\",\\n \\"ClassCode\\": \\"polarx.n8.large.col\\",\\n \\"CpuCore\\": \\"2\\"\\n }\\n ]\\n }\\n}","type":"json"}]', 'title' => '查询列存规格列表', ], 'DescribeEvaluateAndImportTask' => [ 'summary' => '查询 PolarDB-X 评估导入任务的列表。(单个)', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '111376', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '连接任务id。', 'type' => 'string', 'required' => false, 'example' => 'etx-szr2rr6i*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '73559800-****-11ec-bd40-99cfcff3fe1e', ], 'Message' => [ 'description' => '请求返回消息。>请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Success', ], 'Data' => [ 'description' => '返回结果。', 'type' => 'object', 'properties' => [ 'Bid' => [ 'description' => '导入任务的业务id。', 'type' => 'string', 'example' => '26842', ], 'Creator' => [ 'description' => '导入任务的创建人', 'type' => 'string', 'example' => '346650', ], 'Deleted' => [ 'description' => '导入任务是否成功。', 'type' => 'boolean', 'example' => 'false', ], 'GmtCreated' => [ 'description' => '任务创建时间戳。', 'type' => 'integer', 'format' => 'int64', 'example' => '2025-06-08T15:00Z', ], 'GmtModified' => [ 'description' => '修改时间,时间戳格式。', 'type' => 'integer', 'format' => 'int64', 'example' => '1605080537000', ], 'Id' => [ 'description' => '任务id。', 'type' => 'integer', 'format' => 'int64', 'example' => '76251', ], 'RegionId' => [ 'description' => '地域id。', 'type' => 'string', 'example' => 'cn-hangzhou', ], 'SlinkDstResId' => [ 'description' => '目标端实例ID。', 'type' => 'string', 'example' => 'pxc-hzrehc60jz5zye', ], 'SlinkDstUserName' => [ 'description' => '目标端数据连接用户名。', 'type' => 'string', 'example' => 'dts_dtdba', ], 'SlinkSrcResId' => [ 'description' => '源端实例ID。', 'type' => 'string', 'example' => 'drdshbga69378w4p', ], 'SlinkSrcUserName' => [ 'description' => '源端数据连接用户名。', 'type' => 'string', 'example' => 'dtdba', ], 'SlinkStage' => [ 'description' => '同步所处的“阶段”。', 'type' => 'string', 'example' => 'DATA_IMPORT_RUNNING', ], 'SlinkStatus' => [ 'description' => '同步的“运行状态”。', 'type' => 'string', 'example' => 'IMPORT_RUNNING', ], 'SlinkTaskId' => [ 'description' => 'slink任务id。', 'type' => 'string', 'example' => 'etx-szr2rr6i*****', ], 'SlinkType' => [ 'description' => '同步类型。', 'type' => 'string', 'example' => 'evaluate_import', ], 'SlinkSrcDb' => [ 'description' => 'slink源数据库名称。', 'type' => 'string', 'example' => 'fr_import', ], 'SlinkDstDb' => [ 'description' => 'slink目标数据库名称。', 'type' => 'string', 'example' => 'fr_import', ], 'SlinkTaskDesc' => [ 'description' => 'slinktask描述。', 'type' => 'string', 'example' => 'drdsprod_to_2.0', ], 'Context' => [ 'description' => '小结信息。', 'type' => 'string', 'example' => '"{\\"structureImportResult\\":{\\"status\\":\\"finish\\",\\"finishedNum\\":382,\\"totalNum\\":382,\\"percentage\\":100},\\"switchTips\\":\\"正向同步延迟较小时才允许开始正向切换\\",\\"autoTableSuggestionSwitch\\":false,\\"structureAlterationMap\\":{},\\"acceptFilterMap\\":{\\"fr_import\\":[\\"dy_dr_new\\"],\\"e3plus_drp_prod_new\\":[],\\"qbtong_prod\\":[],\\"e3plus_account_prod\\":[],\\"e3plus_drp_prod\\":[]},\\"structChunkMap\\":{},\\"count\\":1,\\"requestId\\":\\"9380D025-C9B1-51D6-A4B9-733C4879CC4A\\"}",', ], 'SlinkSrcResType' => [ 'description' => '源端资源类型。', 'type' => 'string', 'example' => 'POLARX1', ], ], ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"73559800-****-11ec-bd40-99cfcff3fe1e\\",\\n \\"Message\\": \\"Success\\",\\n \\"Data\\": {\\n \\"Bid\\": \\"26842\\",\\n \\"Creator\\": \\"346650\\",\\n \\"Deleted\\": false,\\n \\"GmtCreated\\": 0,\\n \\"GmtModified\\": 1605080537000,\\n \\"Id\\": 76251,\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"SlinkDstResId\\": \\"pxc-hzrehc60jz5zye\\",\\n \\"SlinkDstUserName\\": \\"dts_dtdba\\",\\n \\"SlinkSrcResId\\": \\"drdshbga69378w4p\\",\\n \\"SlinkSrcUserName\\": \\"dtdba\\",\\n \\"SlinkStage\\": \\"DATA_IMPORT_RUNNING\\",\\n \\"SlinkStatus\\": \\"IMPORT_RUNNING\\",\\n \\"SlinkTaskId\\": \\"etx-szr2rr6i*****\\",\\n \\"SlinkType\\": \\"evaluate_import\\",\\n \\"SlinkSrcDb\\": \\"fr_import\\",\\n \\"SlinkDstDb\\": \\"fr_import\\",\\n \\"SlinkTaskDesc\\": \\"drdsprod_to_2.0\\",\\n \\"Context\\": \\"\\\\\\"{\\\\\\\\\\\\\\"structureImportResult\\\\\\\\\\\\\\":{\\\\\\\\\\\\\\"status\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"finish\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"finishedNum\\\\\\\\\\\\\\":382,\\\\\\\\\\\\\\"totalNum\\\\\\\\\\\\\\":382,\\\\\\\\\\\\\\"percentage\\\\\\\\\\\\\\":100},\\\\\\\\\\\\\\"switchTips\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"正向同步延迟较小时才允许开始正向切换\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"autoTableSuggestionSwitch\\\\\\\\\\\\\\":false,\\\\\\\\\\\\\\"structureAlterationMap\\\\\\\\\\\\\\":{},\\\\\\\\\\\\\\"acceptFilterMap\\\\\\\\\\\\\\":{\\\\\\\\\\\\\\"fr_import\\\\\\\\\\\\\\":[\\\\\\\\\\\\\\"dy_dr_new\\\\\\\\\\\\\\"],\\\\\\\\\\\\\\"e3plus_drp_prod_new\\\\\\\\\\\\\\":[],\\\\\\\\\\\\\\"qbtong_prod\\\\\\\\\\\\\\":[],\\\\\\\\\\\\\\"e3plus_account_prod\\\\\\\\\\\\\\":[],\\\\\\\\\\\\\\"e3plus_drp_prod\\\\\\\\\\\\\\":[]},\\\\\\\\\\\\\\"structChunkMap\\\\\\\\\\\\\\":{},\\\\\\\\\\\\\\"count\\\\\\\\\\\\\\":1,\\\\\\\\\\\\\\"requestId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"9380D025-C9B1-51D6-A4B9-733C4879CC4A\\\\\\\\\\\\\\"}\\\\\\",\\",\\n \\"SlinkSrcResType\\": \\"POLARX1\\"\\n },\\n \\"Success\\": true\\n}","type":"json"}]', 'title' => '查询评估导入任务列表', ], 'DescribeEvaluateAndImportTasks' => [ 'summary' => '查询 PolarDB-X 评估导入任务的列表。(多个)', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '103609', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'description' => '页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'example' => '1', 'pattern' => '^\\d+$', 'default' => '1', ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '每页记录数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '5', 'example' => '0', 'pattern' => '^\\d+$', 'default' => '30', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '81519FDE-713B-****-B6F1-231479A4C9DB', ], 'PageSize' => [ 'description' => '每页记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0', ], 'Message' => [ 'description' => '返回消息。>请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'success', ], 'PageNumber' => [ 'description' => '页码。', 'type' => 'integer', 'format' => 'int64', 'example' => '1', ], 'TotalNumber' => [ 'description' => '总记录数。', 'type' => 'integer', 'format' => 'int64', 'example' => '0', ], 'Data' => [ 'description' => '恢复任务详情。', 'type' => 'array', 'items' => [ 'description' => '恢复任务详情。', 'type' => 'object', 'properties' => [ 'Bid' => [ 'description' => '导入任务的业务id。', 'type' => 'string', 'example' => '26842', ], 'Creator' => [ 'description' => '导入任务的创建人', 'type' => 'string', 'example' => '346650', ], 'Deleted' => [ 'description' => '是否已经删除', 'type' => 'boolean', 'example' => 'fase', ], 'GmtCreated' => [ 'description' => '任务创建时间戳,单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '2025-01-08T15:00Z', ], 'GmtModified' => [ 'description' => '修改时间,指元数据信息。', 'type' => 'integer', 'format' => 'int64', 'example' => '2025-04-02T02:10:59Z', ], 'Id' => [ 'description' => '任务id。', 'type' => 'integer', 'format' => 'int64', 'example' => 'ap-northeast-1', ], 'RegionId' => [ 'description' => '地域id。', 'type' => 'string', 'example' => 'cn-zhangjiakou', ], 'SlinkDstResId' => [ 'description' => '目标端实例ID。', 'type' => 'string', 'example' => 'pxc-hzrehc****5zye', ], 'SlinkDstUserName' => [ 'description' => '目标端数据连接用户名。', 'type' => 'string', 'example' => 'dts_temp_2_23', ], 'SlinkSrcResId' => [ 'description' => '源端实例ID。', 'type' => 'string', 'example' => 'drdshbga*****w4p', ], 'SlinkSrcUserName' => [ 'description' => '源端数据连接用户名。', 'type' => 'string', 'example' => 'dtdba', ], 'SlinkStage' => [ 'description' => '同步所处的“阶段”。', 'type' => 'string', 'example' => 'DATA_IMPORT_RUNNING', ], 'SlinkStatus' => [ 'description' => '同步的“运行状态”。', 'type' => 'string', 'example' => 'IMPORT_NOT_BEGIN', ], 'SlinkTaskId' => [ 'description' => 'slink任务id。', 'type' => 'string', 'example' => 'etx-szr2rr6i*****', ], 'SlinkType' => [ 'description' => '同步类型。', 'type' => 'string', 'example' => 'evaluate_import', ], 'SlinkSrcDb' => [ 'description' => 'slink源数据库名称。', 'type' => 'string', 'example' => 'stock', ], 'SlinkDstDb' => [ 'description' => 'slink目标数据库名称。', 'type' => 'string', 'example' => 'e3plus_*****_prod', ], 'SlinkTaskDesc' => [ 'description' => 'slinktask描述。', 'type' => 'string', 'example' => 'test', ], 'SlinkSrcResType' => [ 'description' => '源端资源类型。', 'type' => 'string', 'example' => 'RDS_MYSQL', ], ], ], ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'True', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"81519FDE-713B-****-B6F1-231479A4C9DB\\",\\n \\"PageSize\\": 0,\\n \\"Message\\": \\"success\\",\\n \\"PageNumber\\": 1,\\n \\"TotalNumber\\": 0,\\n \\"Data\\": [\\n {\\n \\"Bid\\": \\"26842\\",\\n \\"Creator\\": \\"346650\\",\\n \\"Deleted\\": true,\\n \\"GmtCreated\\": 0,\\n \\"GmtModified\\": 0,\\n \\"Id\\": 0,\\n \\"RegionId\\": \\"cn-zhangjiakou\\",\\n \\"SlinkDstResId\\": \\"pxc-hzrehc****5zye\\",\\n \\"SlinkDstUserName\\": \\"dts_temp_2_23\\",\\n \\"SlinkSrcResId\\": \\"drdshbga*****w4p\\",\\n \\"SlinkSrcUserName\\": \\"dtdba\\",\\n \\"SlinkStage\\": \\"DATA_IMPORT_RUNNING\\",\\n \\"SlinkStatus\\": \\"IMPORT_NOT_BEGIN\\",\\n \\"SlinkTaskId\\": \\"etx-szr2rr6i*****\\",\\n \\"SlinkType\\": \\"evaluate_import\\",\\n \\"SlinkSrcDb\\": \\"stock\\",\\n \\"SlinkDstDb\\": \\"e3plus_*****_prod\\",\\n \\"SlinkTaskDesc\\": \\"test\\",\\n \\"SlinkSrcResType\\": \\"RDS_MYSQL\\"\\n }\\n ],\\n \\"Success\\": true\\n}","type":"json"}]', 'title' => '查询评估导入任务列表', 'description' => 'CreateDataImportTask 接口用于创建数据导入任务,支持将存储在OSS、ECS或直接传入的SQL/CSV文件导入到目标数据库实例中。通过指定实例ID、数据库名、引擎类型、数据来源(如OSS路径)及导入类型,系统将异步或同步执行数据写入操作,适用于数据迁移、初始化和补录等场景,返回任务ID以便后续状态查询与管理。', ], 'DeleteEvaluateAndImportTask' => [ 'summary' => '删除评估导入任务', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '111383', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域id。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '切换任务id。', 'type' => 'string', 'required' => false, 'example' => 'etx-szr2rr6i*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '14036EBE-***-44DB-ACE9-AC6157D3A6FC', ], 'Message' => [ 'description' => '返回消息。>请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'msg', ], 'Data' => [ 'description' => '删除任务是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"14036EBE-***-44DB-ACE9-AC6157D3A6FC\\",\\n \\"Message\\": \\"msg\\",\\n \\"Data\\": true,\\n \\"Success\\": true\\n}","type":"json"}]', 'title' => '删除评估导入任务', 'description' => '该接口用于删除已创建的评估任务,并执行后续的数据导入操作。', ], 'CreateSQLEvaluateTask' => [ 'summary' => '用于创建 SQL 语句评估任务,通过该接口,用户提交 SQL 语句,系统将对其进行静态分析与风险评估,输出其在目标数据库实例上的执行风险、兼容性问题。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '103587', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域id。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-shanghai', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例id。>您可以调用[describedbinstances](~~196830~~)接口查看目标地域下所有实例的详情,包括实例id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-shr4idrgogti89', ], ], [ 'name' => 'SlinkTaskDesc', 'in' => 'query', 'schema' => [ 'description' => '目标sql的描述信息。', 'type' => 'string', 'required' => false, 'example' => 'test-drds->auto', ], ], [ 'name' => 'SrcResId', 'in' => 'query', 'schema' => [ 'description' => '源rds实例id。>您可以调用[describedropsystemeventmetalist](~~196836~~)接口查看目标地域下所有的源rds实例详情,包括实例id。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'pxc-shr****rgkh87z', ], ], [ 'name' => 'SrcDb', 'in' => 'query', 'schema' => [ 'description' => '源rds实例是否开启源rds,取值范围如下:***enable**:开启源rds***disabled**:关闭源rds', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'transfer_test3', ], ], [ 'name' => 'SrcUserName', 'in' => 'query', 'schema' => [ 'description' => '源端用户名', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'drds_test', ], ], [ 'name' => 'SrcPassword', 'in' => 'query', 'schema' => [ 'description' => '源端口号,取值范围为3200~3999。>当**dbendpointinstancetype**取值为**polardb-o**时,本参数才可用且必须传入。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '******', ], ], [ 'name' => 'DstResId', 'in' => 'query', 'schema' => [ 'description' => '目标sql的id。>您可以调用[describedbinstances](~~196830~~)接口查看目标sql的详情,包括id。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'pxc-zkrc1****l54rc', ], ], [ 'name' => 'DstDb', 'in' => 'query', 'schema' => [ 'description' => '执行目标sql的实例id。>您可以调用[describedbinstances](~~196830~~)接口查看目标sql的详情,包括实例id。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'transfer_for_st', ], ], [ 'name' => 'DstUserName', 'in' => 'query', 'schema' => [ 'description' => '目标端用户名', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'drds_test', ], ], [ 'name' => 'DstPassword', 'in' => 'query', 'schema' => [ 'description' => '目标sql的密码。>您可以调用[describedbinstances](~~196830~~)接口查看目标sql的详情,包括密码。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '******', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '执行目标sql的任务id。>您可以通过[describecloudcenterinstances](~~196830~~)接口查看polardb-x支持的目标sql的id。', 'type' => 'string', 'required' => false, 'example' => 'etx-szr2rr6i*****', ], ], [ 'name' => 'SrcResType', 'in' => 'query', 'schema' => [ 'title' => '源实例类型: RDS_MYSQL、POLARX1、POLARX2_STANDARD、POLARX2_ENTERPRISE、POLARDB_M', 'description' => '源实例类型: RDS_MYSQL、POLARX1、POLARX2_STANDARD、POLARX2_ENTERPRISE、POLARDB_M', 'type' => 'string', 'required' => false, 'example' => 'POLARX2', 'maxLength' => 20, 'minLength' => 1, 'default' => 'POLARX1', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '返回消息。>请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => '*****', ], 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '6352AC16-76BF-5135-B1EA-ED49293526E6', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'True', ], 'Data' => [ 'description' => '返回结果。', 'type' => 'object', 'properties' => [ 'SlinkTaskId' => [ 'description' => 'slink任务id。', 'type' => 'string', 'example' => 'etx-szr2rr6i*****', ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"*****\\",\\n \\"RequestId\\": \\"6352AC16-76BF-5135-B1EA-ED49293526E6\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"SlinkTaskId\\": \\"etx-szr2rr6i*****\\"\\n }\\n}","type":"json"}]', 'title' => 'SQL评估', ], 'CreateStructureImportTask' => [ 'summary' => '用于创建数据库结构导入任务,支持将包含 DDL语句的 SQL 脚本文件或文本内容导入到目标数据库实例中,自动执行建表、创建索引、视图、存储过程等结构化操作。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '154938', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例id。>您可以调用[describedbinstances](~~196830~~)接口查看目标地域下所有实例的详情,包括实例id。', 'type' => 'string', 'required' => false, 'example' => 'pxc-********', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '目标任务id。>您可以调用[describeslinktasks](~~196830~~)接口查看目标任务的执行状态,包括任务id。', 'type' => 'string', 'required' => true, 'example' => 'etx-szr2rr6i*****', ], ], [ 'name' => 'Config', 'in' => 'formData', 'schema' => [ 'description' => '配置信息。', 'type' => 'string', 'required' => false, 'example' => '[{\\"schemaName\\":\\"transfer_test\\",\\"tableList\\":[]}]', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '返回消息。>请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => '*****', ], 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '73559800-3c8c-****-bd40-99cfcff3fe1e', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '返回结果。', 'type' => 'object', 'properties' => [ 'SlinkTaskId' => [ 'description' => 'slink任务id。', 'type' => 'string', 'example' => 'etx-szr2rr6i*****', ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"*****\\",\\n \\"RequestId\\": \\"73559800-3c8c-****-bd40-99cfcff3fe1e\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"SlinkTaskId\\": \\"etx-szr2rr6i*****\\"\\n }\\n}","type":"json"}]', 'title' => '创建数据结构导入任务', ], 'DescribeDataImportTaskInfo' => [ 'summary' => '查询数据导入任务的执行详情。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '104724', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'FailPageNumber', 'in' => 'query', 'schema' => [ 'description' => '请求失败的页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'example' => '1', 'pattern' => '^\\d+$', 'default' => '1', ], ], [ 'name' => 'FailPageSize', 'in' => 'query', 'schema' => [ 'description' => '每页显示多少条“失败记录”。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '5', 'example' => '10', 'pattern' => '^\\d+$', 'default' => '30', ], ], [ 'name' => 'SuccessPageNumber', 'in' => 'query', 'schema' => [ 'description' => '请求成功的页码。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1', ], ], [ 'name' => 'SuccessPageSize', 'in' => 'query', 'schema' => [ 'description' => '每页显示多少条“成功记录”。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '15', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '任务id。', 'type' => 'string', 'required' => true, 'example' => 'etx-szr2rr6i*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '返回信息。当任务状态为success时,该参数才有值,否则返回值为空。', 'type' => 'string', 'example' => 'success', ], 'Data' => [ 'description' => '返回结果集。', 'type' => 'object', 'properties' => [ 'DataImportTaskDetailInfo' => [ 'description' => '任务详情。', 'type' => 'object', 'properties' => [ 'FsmId' => [ 'description' => '进度id。', 'type' => 'integer', 'format' => 'int64', 'example' => '1', ], 'FsmState' => [ 'description' => '数据迁移或同步任务中的一种状态标识。', 'type' => 'string', 'example' => 'RECON_FINISHED_CATCH_UP', ], 'FsmStatus' => [ 'description' => '数据迁移、导入、同步等系统中的状态。', 'type' => 'string', 'example' => 'IMPORT_NOT_BEGIN', ], 'ServiceDetailList' => [ 'description' => '数据导入任务详情。', 'type' => 'array', 'items' => [ 'description' => '数据导入任务详情。', 'type' => 'object', 'properties' => [ 'Id' => [ 'description' => '服务详情id。', 'type' => 'integer', 'format' => 'int64', 'example' => '1991609', ], 'Status' => [ 'description' => '任务执行状态。', 'type' => 'string', 'example' => 'FINISHED', ], 'TaskDetailList' => [ 'description' => '任务详情。', 'type' => 'array', 'items' => [ 'description' => '任务详情。', 'type' => 'object', 'properties' => [ 'Delay' => [ 'description' => '延迟时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '58329', ], 'LastError' => [ 'description' => '最近错误信息。', 'type' => 'string', 'example' => 'null', ], 'PhysicalDbName' => [ 'description' => '物理库名称。', 'type' => 'string', 'example' => 'drds_test', ], 'Progress' => [ 'description' => '数据导入进度。', 'type' => 'integer', 'format' => 'int64', 'example' => '0', ], 'Statistics' => [ 'description' => '字段记录的是数据迁移/导入任务执行过程中的性能与运行时指标', 'type' => 'string', 'example' => '{'."\n" .' "applyCount": 0,'."\n" .' "cpuUseRatio": 41,'."\n" .' "fsmId": 1,'."\n" .' "fullGcCount": '."\n" .'}', ], 'Status' => [ 'description' => '任务状态。', 'type' => 'string', 'example' => 'active', ], 'TaskId' => [ 'description' => '任务id。', 'type' => 'integer', 'format' => 'int64', 'example' => 'fc3b1568-ad96-****-adca-dfe018b38077', ], 'Type' => [ 'description' => '任务类型。', 'type' => 'string', 'example' => 'FULL_COPY', ], ], ], ], 'Type' => [ 'description' => 'FULL_COPY全量复制,INC_COPY增量复制', 'type' => 'string', 'example' => 'FULL_COPY', ], ], ], ], ], ], ], ], 'Code' => [ 'description' => '请求返回码。>请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'integer', 'format' => 'int64', 'example' => '200', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'string', 'example' => 'true', ], 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '9B2F3840-5C98-****-B269-2D5C3A31797C', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"success\\",\\n \\"Data\\": {\\n \\"DataImportTaskDetailInfo\\": {\\n \\"FsmId\\": 1,\\n \\"FsmState\\": \\"RECON_FINISHED_CATCH_UP\\",\\n \\"FsmStatus\\": \\"IMPORT_NOT_BEGIN\\",\\n \\"ServiceDetailList\\": [\\n {\\n \\"Id\\": 1991609,\\n \\"Status\\": \\"FINISHED\\",\\n \\"TaskDetailList\\": [\\n {\\n \\"Delay\\": 58329,\\n \\"LastError\\": \\"null\\",\\n \\"PhysicalDbName\\": \\"drds_test\\",\\n \\"Progress\\": 0,\\n \\"Statistics\\": \\"{\\\\n \\\\\\"applyCount\\\\\\": 0,\\\\n \\\\\\"cpuUseRatio\\\\\\": 41,\\\\n \\\\\\"fsmId\\\\\\": 1,\\\\n \\\\\\"fullGcCount\\\\\\": \\\\n}\\",\\n \\"Status\\": \\"active\\",\\n \\"TaskId\\": 0,\\n \\"Type\\": \\"FULL_COPY\\"\\n }\\n ],\\n \\"Type\\": \\"FULL_COPY\\"\\n }\\n ]\\n }\\n },\\n \\"Code\\": 200,\\n \\"Success\\": \\"true\\",\\n \\"RequestId\\": \\"9B2F3840-5C98-****-B269-2D5C3A31797C\\"\\n}","type":"json"}]', 'title' => '获取数据导入任务信息', ], 'CloseEngineMigration' => [ 'summary' => '此接口用于关闭指定实例的数据库引擎迁移流程。当用户启动从其他数据库(如自建 MySQL、RDS 等)向 PolarDB-X 的数据迁移任务后,若需中途终止或清理迁移状态,可通过此接口安全停止迁移过程。', 'methods' => [ 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '201206', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名。', 'type' => 'string', 'required' => true, 'example' => 'pxc-htri0****r4k9p', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'ContinueEnableBinlog', 'in' => 'query', 'schema' => [ 'description' => '是否继续打开Binlog,取值范围如下: '."\n" .'* **true**:继续打开Binlog'."\n" .'* **false**:关闭Binlog'."\n" ."\n" .'默认取值为**true**。 '."\n" ."\n" .'> 关闭Binlog将会重启您的PolarDB集群。'."\n", 'type' => 'string', 'required' => false, 'example' => 'true', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'C458B1E8-1683-3645-B154-6BA32080EEA', ], 'Code' => [ 'description' => '接口返回Code', 'type' => 'string', 'example' => '200', ], 'Message' => [ 'description' => '成功为空,失败返回错误信息。', 'type' => 'string', 'example' => '*****', ], 'HttpStatusCode' => [ 'description' => '请求状态码', 'type' => 'string', 'example' => '200', ], 'SuccessResponse' => [ 'description' => '请求是否成功。'."\n" ."\n", 'type' => 'string', 'enumValueTitles' => [], 'example' => 'true', ], 'Data' => [ 'description' => '新的地址链接串信息', 'type' => 'object', 'properties' => [ 'DBInstanceName' => [ 'description' => '实例Id', 'type' => 'string', 'example' => 'pxc-hzjasd****', ], 'TaskId' => [ 'description' => '后端任务ID。', 'type' => 'string', 'example' => '2209883', ], ], ], ], ], ], ], 'errorCodes' => [ 400 => [ [ 'errorCode' => 'IdempotentParameterMismatch', 'errorMessage' => 'The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.', ], ], ], 'staticInfo' => [ 'returnType' => 'synchronous', ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C458B1E8-1683-3645-B154-6BA32080EEA\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"*****\\",\\n \\"HttpStatusCode\\": \\"200\\",\\n \\"SuccessResponse\\": \\"true\\",\\n \\"Data\\": {\\n \\"DBInstanceName\\": \\"pxc-hzjasd****\\",\\n \\"TaskId\\": \\"2209883\\"\\n }\\n}","type":"json"}]', 'title' => '关闭引擎迁移', ], 'ConfirmNoConnection' => [ 'summary' => '回滚切换时确认无连接。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '201845', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例名称。'."\n", 'type' => 'string', 'required' => false, 'example' => 'pxc-hzravgpt8q****', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '短链任务的唯一标识 ID,用于定位需要回滚的任务', 'type' => 'string', 'required' => true, 'example' => 'etx-szr2rr6i*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '接口额外返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'Success', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '6BA32080EEA', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '返回数据。', 'type' => 'object', 'properties' => [ 'SlinkTaskId' => [ 'description' => '原始任务 ID,用于响应与请求匹配。', 'type' => 'string', 'example' => 'etx-szr2rr6i*****', ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"6BA32080EEA\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"SlinkTaskId\\": \\"etx-szr2rr6i*****\\"\\n }\\n}","type":"json"}]', 'title' => '回滚切换时确认无连接', 'description' => '该接口用于在回滚任务前,确认无任何活跃连接以保障操作安全。', ], 'RestartDataImportTask' => [ 'summary' => '重启数据导入任务。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '111381', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'description' => '页码,取值范围为大于0且不超过integer的最大值。默认值为**1**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'example' => '1', 'pattern' => '^\\d+$', 'default' => '1', ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '每页记录数,取值范围如下:***30*****50*****100**默认值为**30**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '5', 'example' => '0', 'pattern' => '^\\d+$', 'default' => '30', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '目标任务id。', 'type' => 'string', 'required' => false, 'example' => 'etx-szr2rr6i*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => 'FEA5DC20-6D8A-5979-97AA-FC57546ADC20', ], 'Message' => [ 'description' => '请求返回消息。>请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'Success', ], 'Data' => [ 'description' => '返回结果。', 'type' => 'boolean', 'example' => 'true', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"FEA5DC20-6D8A-5979-97AA-FC57546ADC20\\",\\n \\"Message\\": \\"Success\\",\\n \\"Data\\": true,\\n \\"Success\\": true\\n}","type":"json"}]', 'title' => '重启数据导入任务', ], 'StopDataImportTask' => [ 'summary' => '该接口用于停止数据导入。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '111377', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'PageNumber', 'in' => 'query', 'schema' => [ 'description' => '页码,取值为大于0且不超过integer数据类型的最大值,默认值为**1**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'example' => '1', 'pattern' => '^\\d+$', 'default' => '1', ], ], [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '每页记录数,取值范围如下:***30*****50*****100**默认值为**30**。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '5', 'example' => '30', 'pattern' => '^\\d+$', 'default' => '30', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '任务id。', 'type' => 'string', 'required' => false, 'example' => 'etx-szr2rr6i*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '14036EBE-***-44DB-ACE9-AC6157D3A6FC', ], 'Message' => [ 'description' => '请求返回消息。>请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => '*****', ], 'Data' => [ 'description' => '导入任务是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"14036EBE-***-44DB-ACE9-AC6157D3A6FC\\",\\n \\"Message\\": \\"*****\\",\\n \\"Data\\": true,\\n \\"Success\\": true\\n}","type":"json"}]', 'title' => '停止数据导入任务', ], 'CreateDataImportTask' => [ 'summary' => '用于创建一个数据导入任务,将外部数据文件(如 SQL 脚本、CSV 文件等)导入到目标数据库实例中。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '103607', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例id。>您可以调用[describedbinstances](~~196830~~)接口查看目标地域下所有实例的详情,包括实例id。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'SrcResId', 'in' => 'query', 'schema' => [ 'description' => '源rds实例id。>您可以调用[describedrivingaccess](~~196830~~)接口查看目标地域下所有源rds实例的详情,包括实例id。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'pxc-shrnv****kh87z', ], ], [ 'name' => 'SrcDb', 'in' => 'query', 'schema' => [ 'description' => '源数据库为rdsmysql时,迁移源的数据库信息。>源数据库必须与目标数据库保持一致。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'transfer_for_st', ], ], [ 'name' => 'SrcUserName', 'in' => 'query', 'schema' => [ 'description' => '源端用户名', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'drds_test', ], ], [ 'name' => 'SrcPassword', 'in' => 'query', 'schema' => [ 'description' => '源端执行导入任务的读写模式,取值范围如下:***rw**:读写***ro**:只读', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '******', ], ], [ 'name' => 'DstResId', 'in' => 'query', 'schema' => [ 'description' => '迁移任务id。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'pxc-shr8****k36vrn', ], ], [ 'name' => 'DstDb', 'in' => 'query', 'schema' => [ 'description' => '导入目标sql的执行环境,取值范围如下:***importing**:导入中。***success**:导入成功。***fail**:导入失败。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'transfer_test3', ], ], [ 'name' => 'DstUserName', 'in' => 'query', 'schema' => [ 'description' => '目标端用户名', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'bbt_cms_prod', ], ], [ 'name' => 'DstPassword', 'in' => 'query', 'schema' => [ 'description' => '目标rds实例高权限账号的密码。>*您可以调用[describedbinstances](~~196830~~)接口查看目标实例的高权限账号信息,包括密码。*仅当[unk]dstpassword=true[unk]时,该参数生效。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => '******', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '导入任务id。', 'type' => 'string', 'required' => true, 'example' => 'etx-szr2rr6i*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '请求返回消息', 'type' => 'string', 'example' => '*****', ], 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '173CA69A-3513-591D-8A09-C1EA37CBE2D9', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '返回结果。', 'type' => 'object', 'properties' => [ 'SlinkTaskId' => [ 'description' => '导入任务id。', 'type' => 'string', 'example' => 'etx-szr2rr6i*****', ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"*****\\",\\n \\"RequestId\\": \\"173CA69A-3513-591D-8A09-C1EA37CBE2D9\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"SlinkTaskId\\": \\"etx-szr2rr6i*****\\"\\n }\\n}","type":"json"}]', 'title' => '创建数据导入任务', 'description' => 'CreateDataImportTask 接口用于创建数据导入任务,支持将存储在OSS、ECS或直接传入的SQL/CSV文件导入到目标数据库实例中。通过指定实例ID、数据库名、引擎类型、数据来源(如OSS路径)及导入类型,系统将异步或同步执行数据写入操作,适用于数据迁移、初始化和补录等场景,返回任务ID以便后续状态查询与管理。', ], 'DescribeStructureImportTaskInfo' => [ 'summary' => '该接口用于查询数据库结构导入任务的详细信息。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '161642', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-shanghai', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '目标任务id。', 'type' => 'string', 'required' => true, 'example' => 'etx-szr2rr6i*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', ], 'Message' => [ 'description' => '返回消息。>请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'success', ], 'Data' => [ 'description' => '返回结果集。', 'type' => 'object', 'properties' => [ 'StructureImportResult' => [ 'description' => '结构导入任务的导入结果。', 'type' => 'object', 'properties' => [ 'Status' => [ 'description' => '导入状态。', 'type' => 'string', 'example' => 'finish', ], 'FinishedNum' => [ 'description' => '已完成的记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '118', ], 'TotalNum' => [ 'description' => '结果总数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1', ], 'ExceptionFullTableName' => [ 'description' => '异常的表名。', 'type' => 'string', 'example' => 'hash_realtime_new.wm_in_job_et', ], 'ExceptionDetail' => [ 'description' => '异常原因。', 'type' => 'string', 'example' => 'java.sql.SQLException: [1a7a5f22aa403000][10.239.190.4:3058][hash_realtime_new]ERR-CODE: [TDDL-5123][ERR_INSTANCE_READ_ONLY_OPTION_NOT_SUPPORT] server is running with the instance-read-only option so it cannot execute this statement', ], 'Percentage' => [ 'description' => '当前进度(百分比)。', 'type' => 'integer', 'format' => 'int32', 'example' => '100', ], ], ], 'SlinkStage' => [ 'description' => 'slink状态。', 'type' => 'string', 'example' => 'STRUCTURE_IMPORT', ], ], ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Message\\": \\"success\\",\\n \\"Data\\": {\\n \\"StructureImportResult\\": {\\n \\"Status\\": \\"finish\\",\\n \\"FinishedNum\\": 118,\\n \\"TotalNum\\": 1,\\n \\"ExceptionFullTableName\\": \\"hash_realtime_new.wm_in_job_et\\",\\n \\"ExceptionDetail\\": \\"java.sql.SQLException: [1a7a5f22aa403000][10.239.190.4:3058][hash_realtime_new]ERR-CODE: [TDDL-5123][ERR_INSTANCE_READ_ONLY_OPTION_NOT_SUPPORT] server is running with the instance-read-only option so it cannot execute this statement\\",\\n \\"Percentage\\": 100\\n },\\n \\"SlinkStage\\": \\"STRUCTURE_IMPORT\\"\\n },\\n \\"Success\\": true\\n}","type":"json"}]', 'title' => '查询数据导入任务信息', 'description' => 'CreateDataImportTask 接口用于创建数据导入任务,支持将存储在OSS、ECS或直接传入的SQL/CSV文件导入到目标数据库实例中。通过指定实例ID、数据库名、引擎类型、数据来源(如OSS路径)及导入类型,系统将异步或同步执行数据写入操作,适用于数据迁移、初始化和补录等场景,返回任务ID以便后续状态查询与管理。', ], 'RefreshImportMeta' => [ 'summary' => '该接口用于刷新导入任务的元数据信息。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '161097', 'abilityTreeNodes' => [ 'FEATUREdrdsQ69M1H', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域id。>您可以调用[describeregions](~~196841~~)接口查看polardb-x支持的地域详情,包括地域id。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '实例id。>您可以调用[describedbinstances](~~196830~~)接口查看目标地域下所有实例的详情,包括实例id。', 'type' => 'string', 'required' => false, 'example' => 'pxc-xxx', ], ], [ 'name' => 'SlinkTaskId', 'in' => 'query', 'schema' => [ 'description' => '任务id。', 'type' => 'string', 'required' => true, 'example' => 'etx-szr2rr6i*****', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '导入导出任务的结果详情。>若无特殊情况,该参数为空。', 'type' => 'string', 'example' => '*****', ], 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => 'AE4F6C34-065F-45AA-B5DC-4B8D816F6305', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '监控数据。', 'type' => 'object', 'properties' => [ 'SlinkTaskId' => [ 'description' => '导出任务id。', 'type' => 'string', 'example' => 'etx-szr2rr6i*****', ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Message\\": \\"*****\\",\\n \\"RequestId\\": \\"AE4F6C34-065F-45AA-B5DC-4B8D816F6305\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"SlinkTaskId\\": \\"etx-szr2rr6i*****\\"\\n }\\n}","type":"json"}]', 'title' => '刷新导入元数据', ], 'DeleteGdnInstance' => [ 'summary' => '删除GDN实例', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'delete', 'abilityTreeCode' => '218653', 'abilityTreeNodes' => [ 'FEATUREdrdsBRC5LQ', ], ], 'parameters' => [ [ 'name' => 'GdnInstanceName', 'in' => 'query', 'schema' => [ 'description' => 'GDN实例名', 'type' => 'string', 'required' => true, 'example' => 'gdn-yq****dorhkzttoi', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '14036EBE-CF2E-44DB-ACE9-AC6157D3A6FC', ], 'Message' => [ 'description' => '请求返回消息。'."\n" .'> 请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => '****', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'TaskId' => [ 'description' => '任务ID。', 'type' => 'integer', 'format' => 'int32', 'example' => '2209883', ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"14036EBE-CF2E-44DB-ACE9-AC6157D3A6FC\\",\\n \\"Message\\": \\"****\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"TaskId\\": 2209883\\n }\\n}","type":"json"}]', 'title' => '删除GDN实例', ], 'DescribeGdnInstances' => [ 'summary' => '获取GDN实例列表', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '218651', 'abilityTreeNodes' => [ 'FEATUREdrdsBRC5LQ', ], ], 'parameters' => [ [ 'name' => 'PageSize', 'in' => 'query', 'schema' => [ 'description' => '页面大小。', 'type' => 'string', 'required' => false, 'example' => '30', ], ], [ 'name' => 'PageNum', 'in' => 'query', 'schema' => [ 'description' => '页码,取值为大于0且不超过Integer数据类型的最大值,默认值为1。', 'type' => 'string', 'required' => false, 'example' => '50', ], ], [ 'name' => 'FilterType', 'in' => 'query', 'schema' => [ 'description' => '消息过滤类型。', 'type' => 'string', 'required' => false, 'enumValueTitles' => [], 'example' => 'gdn_id、'."\n" .'polarx_id', ], ], [ 'name' => 'FilterValue', 'in' => 'query', 'schema' => [ 'description' => '查询资源时的筛选值。'."\n" ."\n" .'与FilterKey配合使用。', 'type' => 'string', 'required' => false, 'example' => 'gdn-***、'."\n" .'pxc-***', ], ], [ 'name' => 'GDNId', 'in' => 'query', 'schema' => [ 'description' => 'GDN ID。', 'type' => 'string', 'required' => false, 'example' => 'gdn-***', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域ID。', 'type' => 'string', 'required' => false, 'example' => 'cn-hangzhou', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => '返回信息列表。', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '7B044BD1-6402-5DE9-9AED-63D15A994E37', ], 'Message' => [ 'description' => '请求返回消息。'."\n" .'> 请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'success', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'True', ], 'Data' => [ 'description' => '实例详情列表。', 'type' => 'object', 'properties' => [ 'PageNumber' => [ 'description' => '页面下标。', 'type' => 'string', 'example' => '1', ], 'PageSize' => [ 'description' => '页面大小。', 'type' => 'string', 'example' => '30', ], 'TotalNumber' => [ 'description' => '总数。', 'type' => 'string', 'example' => '130', ], 'GdnInstanceList' => [ 'description' => 'GDN实例列表', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'GdnInstanceName' => [ 'description' => 'GDN实例名', 'type' => 'string', 'example' => 'gdn-***', ], 'GmtCreated' => [ 'description' => '创建时间', 'type' => 'string', 'example' => '2025-01-02T13:11:10.000+0000', ], 'SwitchHistory' => [ 'description' => '切换日志', 'type' => 'string', 'example' => '""', ], 'Status' => [ 'description' => '状态。', 'type' => 'string', 'example' => 'Creating', ], 'MemberList' => [ 'description' => '成员列表。', 'type' => 'array', 'items' => [ 'description' => '结构体', 'type' => 'object', 'properties' => [ 'MemberName' => [ 'description' => '成员名(polarx实例名)。', 'type' => 'string', 'example' => 'pxc-***', ], 'Role' => [ 'description' => '成员角色。', 'type' => 'string', 'example' => 'primary、'."\n" .'standby', ], 'Status' => [ 'description' => '成员状态。', 'type' => 'string', 'example' => 'Creating', ], 'GmtCreated' => [ 'description' => '创建时间', 'type' => 'string', 'example' => '2025-01-02T13:11:10.000+0000', ], 'SecondsBehindMaster' => [ 'description' => '数据延迟', 'type' => 'string', 'example' => '1s', ], 'CommodityCode' => [ 'description' => '商品code', 'type' => 'string', 'example' => 'drds_polarxpre_public_cn', ], 'RegionId' => [ 'description' => '地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou', ], 'ClassCode' => [ 'description' => '实例规格。', 'type' => 'string', 'example' => 'polarx.x4.medium.2e', ], 'PayType' => [ 'description' => '实例付费方式,取值:'."\n" ."\n" .'- **Postpaid**:按量付费;'."\n" .'- **Prepaid**:包年包月。', 'type' => 'string', 'example' => 'Prepaid', ], 'ExpireTime' => [ 'description' => '过期时间。', 'type' => 'string', 'example' => '2025-01-02T13:11:10.000+0000', ], 'PrimaryZone' => [ 'description' => '主可用区。', 'type' => 'string', 'example' => 'cn-zhangjiakou-a', ], 'SecondaryZone' => [ 'description' => '次可用区。', 'type' => 'string', 'example' => 'cn-zhangjiakou-a', ], 'TertiaryZone' => [ 'description' => '第三可用区。', 'type' => 'string', 'example' => 'cn-zhangjiakou-a', ], 'ZoneId' => [ 'description' => '可用区ID。', 'type' => 'string', 'example' => 'cn-zhangjiakou-a', ], 'CnNodeClassCode' => [ 'description' => 'CN节点规格。'."\n" ."\n" .'- **polarx.x4.medium.2e**:2核8G'."\n" .'- **polarx.x4.large.2e**:4核16G'."\n" .'- **polarx.x8.large.2e**:4核32G'."\n" .'- **polarx.x4.xlarge.2e**:8核32G'."\n" .'- **polarx.x8.xlarge.2e**:8核64G'."\n" .'- **polarx.x4.2xlarge.2e**:16核64G'."\n" .'- **polarx.x8.2xlarge.2e**:16核128G'."\n" .'- **polarx.x4.4xlarge.2e**:32核128G'."\n" .'- **polarx.x8.4xlarge.2e**:32核256G'."\n" .'- **polarx.st.8xlarge.2e**:60核470G'."\n" .'- **polarx.st.12xlarge.2e**:90核720G', 'type' => 'string', 'example' => 'polarx.x4.medium.2e', ], 'DnNodeClassCode' => [ 'description' => 'DN节点规格。'."\n" .'- **mysql.n2.medium.25**:2核4G'."\n" .'- **mysql.n4.medium.25**:2核8G'."\n" .'- **mysql.x8.medium.25**:2核16G'."\n" .'- **mysql.n2.large.25**:4核8G'."\n" .'- **mysql.n4.large.25**:4核16G'."\n" .'- **mysql.x8.large.25**:4核32G'."\n" .'- **mysql.n2.xlarge.25**:8核16G'."\n" .'- **mysql.n4.xlarge.25**:8核32G'."\n" .'- **mysql.x8.xlarge.25**:8核64G'."\n" .'- **mysql.n4.2xlarge.25**:16核64G'."\n" .'- **mysql.x8.2xlarge.25**:16核128G'."\n" .'- **mysql.x4.4xlarge.25**:32核128G'."\n" .'- **mysql.x8.4xlarge.25**:32核256G'."\n" .'- **mysql.st.8xlarge.25**:60核470G'."\n" .'- **mysql.st.12xlarge.25**:90核720G', 'type' => 'string', 'example' => 'mysql.n4.medium.25', ], 'CnNodeCount' => [ 'description' => 'CN节点个数。', 'type' => 'string', 'example' => '2', ], 'DnNodeCount' => [ 'description' => 'DN节点个数。', 'type' => 'string', 'example' => '2', ], 'TaskStatus' => [ 'description' => '切换任务状态', 'type' => 'string', 'example' => 'prepared:参数初始化完毕'."\n" .'set_old_primary_readonly:原主实例已禁写'."\n" .'set_new_primary_read_write:已切换'."\n" .'timeout:任务超时'."\n" .'rollback:已回滚'."\n", ], 'DataSyncStatus' => [ 'type' => 'string', ], 'ReadWriteStatus' => [ 'type' => 'string', ], ], ], ], 'Description' => [ 'description' => '描述信息。', 'type' => 'string', 'example' => 'test', ], 'MysqlVersion' => [ 'description' => '实例支持的MySQL版本。', 'type' => 'string', 'example' => '5.7', ], 'GdnMode' => [ 'type' => 'string', ], 'RplSyncDdl' => [ 'type' => 'boolean', ], 'RplDmlStrategy' => [ 'type' => 'string', ], 'RplConflictStrategy' => [ 'type' => 'string', ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"7B044BD1-6402-5DE9-9AED-63D15A994E37\\",\\n \\"Message\\": \\"success\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"PageNumber\\": \\"1\\",\\n \\"PageSize\\": \\"30\\",\\n \\"TotalNumber\\": \\"130\\",\\n \\"GdnInstanceList\\": [\\n {\\n \\"GdnInstanceName\\": \\"gdn-***\\",\\n \\"GmtCreated\\": \\"2025-01-02T13:11:10.000+0000\\",\\n \\"SwitchHistory\\": \\"\\\\\\"\\\\\\"\\",\\n \\"Status\\": \\"Creating\\",\\n \\"MemberList\\": [\\n {\\n \\"MemberName\\": \\"pxc-***\\",\\n \\"Role\\": \\"primary、\\\\nstandby\\",\\n \\"Status\\": \\"Creating\\",\\n \\"GmtCreated\\": \\"2025-01-02T13:11:10.000+0000\\",\\n \\"SecondsBehindMaster\\": \\"1s\\",\\n \\"CommodityCode\\": \\"drds_polarxpre_public_cn\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"ClassCode\\": \\"polarx.x4.medium.2e\\",\\n \\"PayType\\": \\"Prepaid\\",\\n \\"ExpireTime\\": \\"2025-01-02T13:11:10.000+0000\\",\\n \\"PrimaryZone\\": \\"cn-zhangjiakou-a\\",\\n \\"SecondaryZone\\": \\"cn-zhangjiakou-a\\",\\n \\"TertiaryZone\\": \\"cn-zhangjiakou-a\\",\\n \\"ZoneId\\": \\"cn-zhangjiakou-a\\",\\n \\"CnNodeClassCode\\": \\"polarx.x4.medium.2e\\",\\n \\"DnNodeClassCode\\": \\"mysql.n4.medium.25\\",\\n \\"CnNodeCount\\": \\"2\\",\\n \\"DnNodeCount\\": \\"2\\",\\n \\"TaskStatus\\": \\"prepared:参数初始化完毕\\\\nset_old_primary_readonly:原主实例已禁写\\\\nset_new_primary_read_write:已切换\\\\ntimeout:任务超时\\\\nrollback:已回滚\\\\n\\",\\n \\"DataSyncStatus\\": \\"\\",\\n \\"ReadWriteStatus\\": \\"\\"\\n }\\n ],\\n \\"Description\\": \\"test\\",\\n \\"MysqlVersion\\": \\"5.7\\",\\n \\"GdnMode\\": \\"\\",\\n \\"RplSyncDdl\\": true,\\n \\"RplDmlStrategy\\": \\"\\",\\n \\"RplConflictStrategy\\": \\"\\"\\n }\\n ]\\n }\\n}","type":"json"}]', 'title' => '获取GDN实例列表信息', ], 'SwitchGdnMemberRole' => [ 'summary' => 'GDN主备切换。', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'update', 'abilityTreeCode' => '218654', 'abilityTreeNodes' => [ 'FEATUREdrdsBRC5LQ', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域IID。', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '主实例ID。', 'type' => 'string', 'required' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'SwitchMode', 'in' => 'query', 'schema' => [ 'description' => '切换模式。', 'type' => 'string', 'required' => true, 'example' => '常规切换:switch_over'."\n" .'强制切换:fail_over', ], ], [ 'name' => 'TaskTimeout', 'in' => 'query', 'schema' => [ 'description' => '切换任务超时时间(秒)', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '10', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'Message' => [ 'description' => '接口额外返回信息,成功返回success,错误返回对应错误码。', 'type' => 'string', 'example' => 'success', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '数据结构体。', 'type' => 'object', 'properties' => [ 'TaskId' => [ 'description' => '任务ID。', 'type' => 'integer', 'format' => 'int32', 'example' => '2209883', ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"Message\\": \\"success\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"TaskId\\": 2209883\\n }\\n}","type":"json"}]', 'title' => 'GDN主从切换', ], 'CreateGdnInstance' => [ 'summary' => '创建GDN实例', 'methods' => [ 'get', 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', 'abilityTreeCode' => '219398', 'abilityTreeNodes' => [ 'FEATUREdrdsBRC5LQ', ], ], 'parameters' => [ [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'description' => '主实例名', 'type' => 'string', 'required' => true, 'example' => 'pxc-********', ], ], [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'example' => 'cn-beijing', ], ], [ 'name' => 'Description', 'in' => 'query', 'schema' => [ 'description' => '描述信息。', 'type' => 'string', 'required' => false, 'example' => 'FASTJSON 2.0.x has been released, faster and more secure, recommend you upgrade.', ], ], [ 'name' => 'GdnMode', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], [ 'name' => 'RplSyncDdl', 'in' => 'query', 'schema' => [ 'type' => 'boolean', 'required' => false, ], ], [ 'name' => 'RplDmlStrategy', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], [ 'name' => 'RplConflictStrategy', 'in' => 'query', 'schema' => [ 'type' => 'string', 'required' => false, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '0DBA1657-7607-56D6-BB6D-641BF17CCFDB', ], 'Message' => [ 'description' => '请求返回消息。'."\n" .'> 请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => '****', ], 'Success' => [ 'description' => '请求是否成功。', 'type' => 'boolean', 'example' => 'True', ], 'Data' => [ 'description' => '实例详情列表。', 'type' => 'object', 'properties' => [ 'TaskId' => [ 'description' => '任务ID。', 'type' => 'integer', 'format' => 'int32', 'example' => '2209883', ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"0DBA1657-7607-56D6-BB6D-641BF17CCFDB\\",\\n \\"Message\\": \\"****\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"TaskId\\": 2209883\\n }\\n}","type":"json"}]', 'title' => '创建GDN实例', ], 'SubmitSqlFlashbackTask' => [ 'summary' => '调用SubmitSqlFlashbackTask接口创建SQL闪回任务。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '121601', 'abilityTreeNodes' => [ 'FEATUREdrds73QXOU', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。'."\n" ."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DbName', 'in' => 'query', 'schema' => [ 'description' => '数据库名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'test', ], ], [ 'name' => 'PolardbxInstanceId', 'in' => 'query', 'schema' => [ 'description' => 'PolarDB-X实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-*********', ], ], [ 'name' => 'StartTime', 'in' => 'query', 'schema' => [ 'description' => '执行闪回SQL的开始时间。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2019-09-10 20:23:23', ], ], [ 'name' => 'EndTime', 'in' => 'query', 'schema' => [ 'description' => '执行闪回SQL的结束时间。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2019-09-10 23:23:23', ], ], [ 'name' => 'RecallRestoreType', 'in' => 'query', 'schema' => [ 'description' => '恢复类型,取值范围如下:'."\n" ."\n" .'- **1**:镜像恢复;'."\n" .'- **0**:逆向恢复。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '0', ], ], [ 'name' => 'TraceId', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '闪回SQL的Trace ID。', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'ase*****', ], ], [ 'name' => 'TableName', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '执行闪回SQL操作的表的名称。', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'test', ], ], [ 'name' => 'SqlType', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => 'SQL的类型,取值范围为INSERT、UPDATE、DELETE,多种类型间用英文逗号(,)分隔。', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'INSERT,UPDATE', ], ], [ 'name' => 'SqlPk', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '闪回SQL的主键。', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => '1111', ], ], [ 'name' => 'RecallType', 'in' => 'query', 'allowEmptyValue' => true, 'schema' => [ 'description' => '精确匹配或者模糊匹配,取值范围如下:'."\n" ."\n" .'- **0**:精确匹配;'."\n" .'- **1**:模糊匹配。', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => '0', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'Message' => [ 'description' => '请求结果描述信息。', 'type' => 'string', 'example' => 'OK', ], 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '1AD222E9-E606-4A42-BF6D-8A4442913CEF', ], 'Success' => [ 'description' => '当前API是否请求成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '请求结果数据内容。', 'type' => 'object', 'properties' => [ 'TaskId' => [ 'description' => '任务ID。', 'type' => 'string', 'example' => '1111', ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"OK\\",\\n \\"RequestId\\": \\"1AD222E9-E606-4A42-BF6D-8A4442913CEF\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"TaskId\\": \\"1111\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n OK\\n 1AD222E9-E606-4A42-BF6D-8A4442913CEF\\n true\\n \\n 1111\\n \\n","errorExample":""}]', 'title' => '创建 SQL 闪回任务', ], 'PreCheckSqlFlashbackTask' => [ 'summary' => '该接口用于在执行 SQL 闪回恢复(Flashback) 前,对恢复任务进行前置检查与可行性评估。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '121682', 'abilityTreeNodes' => [ 'FEATUREdrds73QXOU', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '地域id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'PolardbxInstanceId', 'in' => 'query', 'schema' => [ 'description' => '集群id。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-*********', ], ], [ 'name' => 'DbName', 'in' => 'query', 'schema' => [ 'description' => '数据库名称。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'test', ], ], [ 'name' => 'StartTime', 'in' => 'query', 'schema' => [ 'description' => '闪回sql执行的开始时间。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2025-09-21 14:35:00', ], ], [ 'name' => 'EndTime', 'in' => 'query', 'schema' => [ 'description' => '闪回sql执行的结束时间。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '2025-09-21 14:41:00', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求id。', 'type' => 'string', 'example' => '14036EBE-***-44DB-ACE9-AC6157D3A6FC', ], 'Message' => [ 'description' => '请求返回消息。>请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。', 'type' => 'string', 'example' => 'successs', ], 'Success' => [ 'description' => '请求结果。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '返回结果集。', 'type' => 'object', 'properties' => [ 'CheckResult' => [ 'description' => '校验结果。', 'type' => 'object', 'properties' => [ 'CanUpgradeSupportBinlogRowQueryEvents' => [ 'description' => '能否更新成功。', 'type' => 'boolean', ], 'BinlogRowQueryEventEnabled' => [ 'description' => '是否已开启记录原始 SQL 查询事件,取值范围如下:***true**:开启***false**:关闭', 'type' => 'boolean', ], 'SupportBinlogRowQueryEvents' => [ 'description' => '是否支持日志记录,取值范围如下:***true**:支持***false**:不支持', 'type' => 'boolean', ], 'BinlogExists' => [ 'description' => '是否存在有效的 Binlog 日志文件(用于判断能否进行闪回、同步等操作)', 'type' => 'boolean', ], 'HasTable' => [ 'description' => '是否有下一页,true/false。', 'type' => 'boolean', ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"14036EBE-***-44DB-ACE9-AC6157D3A6FC\\",\\n \\"Message\\": \\"successs\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"CheckResult\\": {\\n \\"CanUpgradeSupportBinlogRowQueryEvents\\": true,\\n \\"BinlogRowQueryEventEnabled\\": true,\\n \\"SupportBinlogRowQueryEvents\\": true,\\n \\"BinlogExists\\": true,\\n \\"HasTable\\": true\\n }\\n }\\n}","type":"json"}]', 'title' => 'SQL闪回恢复检查', ], 'DescribeSqlFlashbackTaskList' => [ 'summary' => '调用DescribeSqlFlashbackTaskList接口查看SQL闪回任务的列表。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '121676', 'abilityTreeNodes' => [ 'FEATUREdrds73QXOU', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'description' => '实例所在地域。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'PolardbxInstanceId', 'in' => 'query', 'schema' => [ 'description' => 'PolarDB-X实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'pxc-**********', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '9B2F3840-5C98-475C-B269-2D5C3A31797C', ], 'Message' => [ 'description' => '请求结果描述信息。', 'type' => 'string', 'example' => 'OK', ], 'Success' => [ 'description' => '当前API是否请求成功。', 'type' => 'boolean', 'example' => 'true', ], 'Data' => [ 'description' => '请求结果数据内容。', 'type' => 'object', 'properties' => [ 'SqlFlashbackTasks' => [ 'description' => '闪回任务返回对象。', 'type' => 'array', 'items' => [ 'description' => '闪回任务返回对象。', 'type' => 'object', 'properties' => [ 'GmtModified' => [ 'description' => '闪回任务在数据库的最后更新时间(单位:ms)。', 'type' => 'string', 'example' => '1568611469000', ], 'SearchEndTime' => [ 'description' => '提交SQL闪回时输入的结束时间(单位:ms)。', 'type' => 'string', 'example' => '1568609597000', ], 'RecallStatus' => [ 'description' => '数据召回任务状态:'."\n" ."\n" .'- **1**:进行中;'."\n" .'- **2**:已完成。', 'type' => 'string', 'example' => '1', ], 'SqlPk' => [ 'description' => 'SQL涉及的主键值。', 'type' => 'string', 'example' => 'id', ], 'RecallRestoreType' => [ 'description' => 'SQL闪回恢复类型: '."\n" ."\n" .'- **1**:镜像恢复;'."\n" .'- **2**:逆向恢复。'."\n", 'type' => 'string', 'example' => '0', ], 'TableName' => [ 'description' => '数据所属的表。', 'type' => 'string', 'example' => 'test', ], 'GmtCreate' => [ 'description' => '闪回任务在数据库的创建时间(单位:ms)。', 'type' => 'string', 'example' => '1568611408000', ], 'InstId' => [ 'description' => 'PolarDB-X实例ID。', 'type' => 'string', 'example' => 'pxc-********', ], 'SearchStartTime' => [ 'description' => '提交SQL闪回时输入的开始时间(单位:ms)。', 'type' => 'string', 'example' => '1568609597000', ], 'RecallType' => [ 'description' => '回溯类型:'."\n" ."\n" .'- **0**:精确查找;'."\n" .'- **1**:模糊查找。'."\n" ."\n", 'type' => 'string', 'example' => '0', ], 'TraceId' => [ 'description' => 'SQL的trace_id。', 'type' => 'string', 'example' => '13ed05705f801000', ], 'DbName' => [ 'description' => '执行闪回任务的数据库名称。', 'type' => 'string', 'example' => 'test', ], 'SqlType' => [ 'description' => 'SQL的类型,取值范围为INSERT、UPDATE、DELETE,多种类型间用英文逗号(,)分隔。', 'type' => 'string', 'example' => 'INSERT,UPDATE', ], 'Id' => [ 'description' => '主键ID。', 'type' => 'string', 'example' => '111', ], 'ExpireTime' => [ 'description' => '下载地址过期时间(单位:ms)。', 'type' => 'string', 'example' => '1569216270000', ], 'SqlCounter' => [ 'description' => '恢复的数据行数。', 'type' => 'string', 'example' => '100', ], 'RecallProgress' => [ 'description' => '闪回任务执行进度(取值范围1~100)。', 'type' => 'string', 'example' => '10', ], 'DownloadUrl' => [ 'description' => '结果文件下载地址。', 'type' => 'string', 'example' => 'http://...', ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9B2F3840-5C98-475C-B269-2D5C3A31797C\\",\\n \\"Message\\": \\"OK\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"SqlFlashbackTasks\\": [\\n {\\n \\"GmtModified\\": \\"1568611469000\\",\\n \\"SearchEndTime\\": \\"1568609597000\\",\\n \\"RecallStatus\\": \\"1\\",\\n \\"SqlPk\\": \\"id\\",\\n \\"RecallRestoreType\\": \\"0\\",\\n \\"TableName\\": \\"test\\",\\n \\"GmtCreate\\": \\"1568611408000\\",\\n \\"InstId\\": \\"pxc-********\\",\\n \\"SearchStartTime\\": \\"1568609597000\\",\\n \\"RecallType\\": \\"0\\",\\n \\"TraceId\\": \\"13ed05705f801000\\",\\n \\"DbName\\": \\"test\\",\\n \\"SqlType\\": \\"INSERT,UPDATE\\",\\n \\"Id\\": \\"111\\",\\n \\"ExpireTime\\": \\"1569216270000\\",\\n \\"SqlCounter\\": \\"100\\",\\n \\"RecallProgress\\": \\"10\\",\\n \\"DownloadUrl\\": \\"http://...\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 9B2F3840-5C98-475C-B269-2D5C3A31797C\\n OK\\n true\\n \\n \\n 1568611469000\\n 1568609597000\\n 1\\n id\\n 0\\n test\\n 1568611408000\\n pxc-********\\n 1568609597000\\n 0\\n 13ed05705f801000\\n test\\n INSERT,UPDATE\\n 111\\n 1569216270000\\n 100\\n 10\\n http://...\\n \\n \\n","errorExample":""}]', 'title' => '查看SQL闪回任务的列表', ], 'DescribeTags' => [ 'summary' => '获取标签信息。', 'methods' => [ 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '117148', 'abilityTreeNodes' => [ 'FEATUREdrdsJGJ3OD', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'title' => '地域', 'description' => '地域', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'DBInstanceName', 'in' => 'query', 'schema' => [ 'title' => '实例名称', 'description' => '实例名称', 'type' => 'string', 'required' => false, 'example' => 'pxc-xxx', 'maxItems' => 51, ], ], [ 'name' => 'TagKey', 'in' => 'query', 'schema' => [ 'title' => '标签Key', 'description' => '标签Key', 'type' => 'string', 'required' => false, 'example' => 'test', ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'requestid', ], 'TagInfos' => [ 'title' => '标签信息列表', 'description' => '标签信息列表', 'type' => 'array', 'items' => [ 'description' => '标签信息', 'type' => 'object', 'properties' => [ 'TagKey' => [ 'title' => '标签Key', 'description' => '标签Key', 'type' => 'string', 'example' => 'testKey', ], 'TagValue' => [ 'title' => '标签Value', 'description' => '标签Value', 'type' => 'string', 'example' => 'testValue', ], 'DBInstanceIds' => [ 'title' => '标签关联数据库实例列表', 'description' => '标签关联数据库实例列表', 'type' => 'array', 'items' => [ 'description' => '实例名称', 'type' => 'string', 'example' => '数据库实例', ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"requestid\\",\\n \\"TagInfos\\": [\\n {\\n \\"TagKey\\": \\"testKey\\",\\n \\"TagValue\\": \\"testValue\\",\\n \\"DBInstanceIds\\": [\\n \\"数据库实例\\"\\n ]\\n }\\n ]\\n}","type":"json"}]', 'title' => '获取标签信息', ], 'ListTagResources' => [ 'summary' => '标签列表获取。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '115498', 'abilityTreeNodes' => [ 'FEATUREdrdsJGJ3OD', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'title' => '地域', 'description' => '地域', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'NextToken', 'in' => 'query', 'schema' => [ 'title' => '下一个查询开始Token', 'description' => '下一个查询开始Token', 'type' => 'string', 'required' => false, 'example' => 'xxdds', ], ], [ 'name' => 'ResourceType', 'in' => 'query', 'schema' => [ 'title' => '资源类型', 'description' => '资源类型,必须填写:PolarDBXInstance', 'type' => 'string', 'required' => true, 'example' => 'PolarDBXInstance', ], ], [ 'name' => 'ResourceId', 'in' => 'query', 'style' => 'repeatList', 'schema' => [ 'title' => '资源ID,最多 50个子项', 'description' => '资源ID,最多 50个子项', 'type' => 'array', 'items' => [ 'description' => '资源ID', 'type' => 'string', 'required' => false, 'example' => 'pxc-xxxx', ], 'required' => false, 'maxItems' => 51, ], ], [ 'name' => 'Tag', 'in' => 'query', 'style' => 'repeatList', 'schema' => [ 'title' => '标签列表,最多包含20个子项', 'description' => '标签列表,最多包含20个子项', 'type' => 'array', 'items' => [ 'description' => '标签', 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '标签键', 'description' => '标签键', 'type' => 'string', 'required' => false, 'example' => '1', ], 'Value' => [ 'title' => '标签值', 'description' => '标签值', 'type' => 'string', 'required' => false, 'example' => '2', ], ], 'required' => false, ], 'required' => false, 'maxItems' => 21, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'NextToken' => [ 'title' => '下一个查询开始Token,NextToken为空说明没有下一个', 'description' => '下一个查询开始Token,NextToken为空说明没有下一个', 'type' => 'string', 'example' => 'xxdd', ], 'RequestId' => [ 'description' => '请求Id', 'type' => 'string', 'example' => 'xxxx-xxxxxx', ], 'TagResources' => [ 'type' => 'object', 'itemNode' => true, 'properties' => [ 'TagResource' => [ 'title' => '资源列表', 'description' => '资源列表', 'type' => 'array', 'items' => [ 'description' => '标签信息', 'type' => 'object', 'properties' => [ 'ResourceType' => [ 'title' => '资源类型', 'description' => '资源类型', 'type' => 'string', 'example' => 'PolarDBXInstance', ], 'TagValue' => [ 'title' => '标签值', 'description' => '标签值', 'type' => 'string', 'example' => '1', ], 'ResourceId' => [ 'title' => '资源ID', 'description' => '资源ID', 'type' => 'string', 'example' => 'pxc-xxxx', ], 'TagKey' => [ 'title' => '标签键', 'description' => '标签键', 'type' => 'string', 'example' => '1', ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"NextToken\\": \\"xxdd\\",\\n \\"RequestId\\": \\"xxxx-xxxxxx\\",\\n \\"TagResources\\": {\\n \\"TagResource\\": [\\n {\\n \\"ResourceType\\": \\"PolarDBXInstance\\",\\n \\"TagValue\\": \\"1\\",\\n \\"ResourceId\\": \\"pxc-xxxx\\",\\n \\"TagKey\\": \\"1\\"\\n }\\n ]\\n }\\n}","type":"json"}]', 'title' => '标签列表获取', ], 'TagResources' => [ 'summary' => '调用TagResources接口为资源打标签。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '115494', 'abilityTreeNodes' => [ 'FEATUREdrdsJGJ3OD', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'title' => '地域', 'description' => '地域', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'ResourceType', 'in' => 'query', 'schema' => [ 'title' => '资源类型', 'description' => '资源类型,必须为:PolarDBXInstance', 'type' => 'string', 'required' => true, 'example' => 'PolarDBXInstance', ], ], [ 'name' => 'ResourceId', 'in' => 'query', 'style' => 'repeatList', 'schema' => [ 'title' => '资源ID,最多 50个子项', 'description' => '资源ID,最多 50个子项', 'type' => 'array', 'items' => [ 'description' => '实例ID', 'type' => 'string', 'required' => false, 'example' => 'pxc-xxxxx', ], 'required' => true, 'maxItems' => 51, ], ], [ 'name' => 'Tag', 'in' => 'query', 'style' => 'repeatList', 'schema' => [ 'title' => '标签列表,最多包含20个子项', 'description' => '标签列表,最多包含20个子项', 'type' => 'array', 'items' => [ 'description' => '标签', 'type' => 'object', 'properties' => [ 'Key' => [ 'title' => '标签键', 'description' => '标签键', 'type' => 'string', 'required' => false, 'example' => '12', ], 'Value' => [ 'title' => '标签值', 'description' => '标签值', 'type' => 'string', 'required' => false, 'example' => '22', ], ], 'required' => false, ], 'required' => true, 'maxItems' => 21, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => 'requestId', 'type' => 'string', 'example' => 'xxxx-xxxx', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxxx-xxxx\\"\\n}","type":"json"}]', 'title' => '为资源打标签', ], 'UntagResources' => [ 'summary' => '资源删除标签。', 'methods' => [ 'post', 'get', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'systemTags' => [ 'operationType' => 'none', 'abilityTreeCode' => '115497', 'abilityTreeNodes' => [ 'FEATUREdrdsJGJ3OD', ], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', 'schema' => [ 'title' => '地域', 'description' => '地域', 'type' => 'string', 'required' => true, 'example' => 'cn-hangzhou', ], ], [ 'name' => 'ResourceType', 'in' => 'query', 'schema' => [ 'title' => '资源类型', 'description' => '资源类型,必须为:PolarDBXInstance', 'type' => 'string', 'required' => true, 'example' => 'PolarDBXInstance', ], ], [ 'name' => 'All', 'in' => 'query', 'schema' => [ 'title' => '是否全部删除,只针对TagKey.N为空时有效。 取值范围: true false True False 默认是 false', 'description' => '是否全部删除,只针对TagKey.N为空时有效。 取值范围: true false True False 默认是 false', 'type' => 'boolean', 'required' => false, 'example' => '是否全部删除', ], ], [ 'name' => 'ResourceId', 'in' => 'query', 'style' => 'repeatList', 'schema' => [ 'title' => '资源ID,最多50个子项', 'description' => '资源ID,最多50个子项', 'type' => 'array', 'items' => [ 'description' => '实例ID', 'type' => 'string', 'required' => false, 'example' => 'pxc-xxxxx', ], 'required' => true, 'maxItems' => 51, ], ], [ 'name' => 'TagKey', 'in' => 'query', 'style' => 'repeatList', 'schema' => [ 'title' => '标签键,最多20个子项', 'description' => '标签键,最多20个子项', 'type' => 'array', 'items' => [ 'description' => '标签KEY', 'type' => 'string', 'required' => false, 'example' => '1', ], 'required' => false, 'maxItems' => 21, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => 'RequestId', 'type' => 'string', 'example' => 'xxxxxx', ], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"xxxxxx\\"\\n}","type":"json"}]', 'title' => '资源删除标签', ], ], 'endpoints' => [ [ 'regionId' => 'ap-northeast-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'ap-northeast-2-pop', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'ap-south-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'ap-southeast-2', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'ap-southeast-3', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'ap-southeast-5', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-beijing-finance-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-beijing-finance-pop', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-beijing-gov-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-beijing-nu16-b01', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-edge-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-fujian', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-haidian-cm12-c01', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-hangzhou-bj-b01', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-hangzhou-finance', 'endpoint' => 'polardbx.cn-hangzhou.aliyuncs.com', ], [ 'regionId' => 'cn-hangzhou-internal-prod-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-hangzhou-internal-test-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-hangzhou-internal-test-2', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-hangzhou-internal-test-3', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-hangzhou-test-306', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-hongkong-finance-pop', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-huhehaote-nebula-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-north-2-gov-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-qingdao-nebula', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-shanghai-et15-b01', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-shanghai-et2-b01', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-shanghai-finance-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-shanghai-inner', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-shanghai-internal-test-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-shenzhen-finance-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-shenzhen-inner', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-shenzhen-st4-d01', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-shenzhen-su18-b01', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-wuhan', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-wulanchabu', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-yushanfang', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-zhangbei', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-zhangbei-na61-b01', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-zhangjiakou-na62-a01', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-zhengzhou-nebula-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'eu-central-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'eu-west-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'eu-west-1-oxs', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'me-east-1', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'rus-west-1-pop', 'endpoint' => 'polardbx.aliyuncs.com', ], [ 'regionId' => 'cn-qingdao', 'endpoint' => 'polardbx.cn-qingdao.aliyuncs.com', ], [ 'regionId' => 'cn-beijing', 'endpoint' => 'polardbx.cn-beijing.aliyuncs.com', ], [ 'regionId' => 'cn-zhangjiakou', 'endpoint' => 'polardbx.cn-zhangjiakou.aliyuncs.com', ], [ 'regionId' => 'cn-huhehaote', 'endpoint' => 'polardbx.cn-huhehaote.aliyuncs.com', ], [ 'regionId' => 'cn-hangzhou', 'endpoint' => 'polardbx.cn-hangzhou.aliyuncs.com', ], [ 'regionId' => 'cn-shanghai', 'endpoint' => 'polardbx.cn-shanghai.aliyuncs.com', ], [ 'regionId' => 'cn-shenzhen', 'endpoint' => 'polardbx.cn-shenzhen.aliyuncs.com', ], [ 'regionId' => 'cn-hongkong', 'endpoint' => 'polardbx.cn-hongkong.aliyuncs.com', ], [ 'regionId' => 'ap-southeast-1', 'endpoint' => 'polardbx.ap-southeast-1.aliyuncs.com', ], [ 'regionId' => 'cn-chengdu', 'endpoint' => 'polardbx.cn-chengdu.aliyuncs.com', ], [ 'regionId' => 'us-east-1', 'endpoint' => 'polardbx.us-east-1.aliyuncs.com', ], [ 'regionId' => 'us-west-1', 'endpoint' => 'polardbx.us-west-1.aliyuncs.com', ], ], ];