'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 \\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 \\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',
],
],
];